Factory docs, home
Page navigation

Pre-release documentation. Proposed designs are labelled in the page; acceptance evidence is maintained in the build review. Local paths appear as placeholders. Current state: Build review.

Historical qualification: Historical source 7cf4b26e: Core 22/22 and Dashboard 26/26 focused checks passed. Scoped evidence is recorded in the historical local qualification record. Historical source 7cf4b26e passed the 3,286/3,286 full checks and all 36 installed families. Independent bounded local evidence acceptance passed; exact-final-head CI is recorded separately from this frozen local proof.

Status: Bounded local candidate. Installed stage and concert proof passed for their frozen snapshots (retained installed stage evidence; independent scope review). The corrected historical 7cf union passed its original combined native execution and independent bounded local evidence acceptance; exact-final-head CI is recorded separately from this frozen local proof. The correction record retains earlier evidence. No live provider, release or customer outcome is qualified.

The private package offers software-factory/implementation-workflow, implementation-workflow-contract, implementation-dispatch-gate and producer-workflow-contract. Imports are passive. Use Node 26.8.1, ESM and caller-owned private storage; demonstrated confined execution is macOS 27 arm64. TypeScript callers supply compatible Node declarations. No runtime npm dependency or credential is loaded.

Supply ready work

Bind a Product to its owned Repository, grant current read/produce authority and freeze a ready Slice with its create-once Slice record using the existing Product gate and delivery-records contracts. An existing application may use Delivery's stage calls as its source adapter. The Workflow requires no Factory CLI, planner or Verification job.

Retain an exact ImplementationJob: job/command/Run/hex32 dispatch identities; Product/Slice digest/store; original base commit/tree/source snapshot; Guidance or explicit absence; acceptance/recipe/environment/brief pins; worker manifest/closure; allowance; fixed one-Attempt Budget, native bounds and deadline. Supply immutable SnapshotFile byte arrays for its program and input, plus existing Journal/private root paths. implementationWorkerInput(baseFiles, frozenBrief) constructs the pinned worker input; implementationResourceClosure(worker) constructs the manifest closure.

import { runImplementationJob, inspectImplementationJob } from 'software-factory/implementation-workflow';
import { parseImplementationJob } from 'software-factory/implementation-workflow-contract';

const job = parseImplementationJob(callerRetainedJob);
const result = await runImplementationJob(job, { paths, program, input, signal });
const retained = await inspectImplementationJob(job, paths);

The application owns the variables above. Worker output is one strict Producer wire proposal: {edits:[{path,baseSha256,content}]}; baseSha256 is null or the original file's raw hex64 SHA-256. Existing Repository parsing and scope/base checks decide whether it can seal. Program output carries no authority.

Replay and cancellation

Keep every original identity/pin on uncertain replay. runImplementationJob reuses retained request/dispatch/Attempt/observation/proposal/Candidate linkage and never invokes that original worker again. Unknown effects remain reserved and block aliases; elapsed time is not cleanup evidence. Read-only inspection starts no process, acquires no owner and spends no allowance. Current validity and historical Candidate remain separate.

The caller AbortSignal and bounded current-state polling stop through the native executor. Only actual reap/pipes or irreversible protected-work exclusion supports cleanup. Fixed Budgets and production-run allowances never reset.

Existing producer adapters

createImplementationDispatchGate supplies the real existing Producer DispatchGate interface over the same Product reservation owner. Its separate versioned Producer job retains a stable pre-claim request template; the supplied actual ProducerRequest must name an already genuinely claimed original Attempt and native held Product owner. Exact commission/model/policy, capabilities, hard bounds and transport descriptor are pinned. The first minted dispatch is retained once. A new Producer call ID conflicts; unknown exposure stays reserved. An injected local job refuses provider dispatch.

This seam has retained synthetic source compatibility evidence. The separate non-invoking installed native dispatch-gate compatibility fixture passed within historical source f70b10f5 Implementation8/8; its original source pin does not qualify historical 7cf4b26e Implementation/full execution. This Workflow makes no live provider call and supplies no qualified commission or credential. Provider qualification and a complete live Producer job remain separate.

The retained installed stage fixture exercised two actual confined workers in separate caller directories, original job and program/input snapshots, fresh-controller replay and independent Candidate verification. Its controls cover changed snapshots, malformed proposals, restored stop and lost host acknowledgement without another worker launch. This evidence belongs to its recorded snapshot. Historical source f70b10f5 Implementation8/8 keeps its original worker and non-invoking gate evidence. Historical source 7cf4b26e passed the 3,286/3,286 full checks and all 36 installed families. Independent bounded local evidence acceptance passed; exact-final-head CI is recorded separately from this frozen local proof. Exact contract and current scope.

Source: docs/how-to/adopt-implementation-workflow.md