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.

Supply an external seal

Use your existing caller Journal and Delivery paths, already bound owned Repository, ready frozen Slice and retained acceptance/recipe/environment/fixture records. Seal the proposal with Repository under that Slice. Keep the actual Repository identity alongside the Candidate digest.

import { verifyExternalCandidate } from 'software-factory/verification-workflow';

const result = await verifyExternalCandidate(paths, {
  productId,
  sliceRef,
  candidate: sealed.digest,
  repository: boundStore,
}, signal);

The API re-derives the native seal and refuses a different physical store, wrong Slice/base/scope/pins or changed internal/external provenance. External admission uses the existing check allowance and leaves production absent. It starts no model or provider call.

Retain original recovery coordinates

Repeat the original request after an uncertain controller loss. Recovery first looks for the original dispatch's exact durable proof witness. Genuine stored Evidence must re-derive that proof under a later native excluded owner and current read permission. The same proof, dispatch and epoch return without another collector invocation.

An orphan Verdict without its witness is inert. A new profiled check stays unresolved and charged rather than guessing or retrying. Follow the result's current validity separately from the original retained observation. Supply a new Slice revision when the original proof cannot support current work.

The retained private-tarball stage proof exercised two physically separate caller fixtures in test/fixtures/distribution/verification-workflow.mjs. Its controls cover wrong-store/provenance refusal, a failed proof on original replay, and native controller death after the Verdict but before its proof witness. The earlier stage evidence keeps its frozen snapshot; the corrected historical 7cf union passed combined native execution and independent bounded local evidence acceptance. An external stage is available through the repository operator contract. Exact authority and storage boundaries.

Original profile and retention preflight

Every new profiled Gate dispatch supplies full original proofPins. The gate compares them with its exact existing admission, frozen Slice and bound store in the reservation transaction. Its command payload retains only their digest. External checks must use this profile; it cannot be dropped on a later epoch. A profiled unresolved result cannot authorise any later epoch through either the workflow or the public gate. A known not-started result may continue within its original allowance while preserving the profile. Old unmarked histories retain their existing bounded rules.

The complete original witness is size-checked before Delivery spends either an internal or external check allowance. External Gate admission repeats this check before charging; every profiled Gate dispatch repeats it before reservation. A legally large acceptance that cannot fit the 64 KiB witness is refused before collection. The stored Slice is preserved; the witness bound is unchanged. Correction record.

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