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.
Current joint scope: The joint qualification record pins the combined source, actual local execution and independent review; exact-final-head CI is recorded separately.
Status: In progress. Reviewed local candidate, 3 October 2026. Independent source and retained installed concert evidence passed for the bounded synthetic profile. 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. No live provider, release or customer outcome is qualified. Historical review.
Intelligence: none — Stateless composition invokes existing native stages with original requests; no model grants authority or settles unknown effects.
Entry and ownership
The public software-factory/factory-workflow entry exposes runFactoryWorkflow<C>(request, owners, signal?), parseFactoryWorkflowRequest, factoryContentDigest, FactoryWorkflowError, the versioned types and FACTORY_WORKFLOW_LIMITS. Its source is factory-workflow.ts, factory-workflow-contract.ts and factory-workflow-input.ts. 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.
This is a stateless composition over the existing native owners. It creates no concert journal, grant, scheduler, retry owner or allowance. FactoryWorkflowOwners<C> supplies:
- Existing
DeliveryPaths; genuine native Research APIs with exact producer/store identities and their authenticated contexts; qualified semantic ports. - Genuine
ProductGuidanceandKnowledgeinstances, with the caller's current records, identity registration, permissions and physical exclusion covering their writers. - An optional
ImplementationCollaboratorsvalue with original program/input snapshots, paths and signal; an optional original boundRepositoryIdentity. - Marketing job ports with the original caller's qualified fence, clock and drafter.
The Delivery journal must already contain its native Product registration; the wrapper creates no registration. Only implementation and repository handles are nullable in this owner type. No callback may stand in for a completed native stage, a proof or a current support check. Semantic and Marketing ports remain their existing explicitly commissioned collaborator seams; cancellation does not qualify them. Importing the candidate starts no workflow.
Prepared request
FactoryWorkflowRequest uses protocol:"sf-factory-workflow/1" and exactly productId, research, researchDigest, guidance, advice, selectedPlan, bind, grant, implementation, integration and marketing. research contains originals and semantic. Each original names producerId, storeId and the exact native OriginalRequest. Nullable stage inputs represent an unprepared suffix; they do not ask Factory to invent it.
The parser bounds and parses every supplied stage before native contact, including a present suffix. Knowable Product, Research original-binding, Guidance, plan, Slice and Action links must agree. A supplied grant includes its original bind request so its target scope can be parsed. New result-dependent links are checked before their dependent call. Supply a fuller prefix after preparing its next owner input, retaining completed original requests and IDs unchanged.
researchDigest is factoryContentDigest({...semanticResult, replayed:false}). The exact owner rationale must include it in supportingEvidence; a transient replay flag changes no content pin. Advice retains the resulting Guidance revision/digest and the selected native Research quote dependencies. selectedPlan must name an original advice alternative and the exact owner decision's changedDecision.afterChoice. The chosen alternative contains the native PlanInput; there is no separate top-level plan field. integration contains only the original action:{id,occurrence} and hexadecimal dispatchId.
Thirteen stage kinds
| Stage | Native operation and progression requirement |
|---|---|
research-collection | Qualify all declared native owners, then admit/collect each exact original. Require an eligible, attributed collection without cancellation or transport uncertainty. |
research | Run the original semantic job. Require completion without unknown/invalid attempts or parked/rejected shadow; inspect original support and directly verify selected native collections/citations. |
guidance | Apply the exact prospective v3 owner decision through genuine Guidance and its qualified fence; bind the actual semantic result digest. |
knowledge | Request advice over original reviewed lessons, sources, Guidance and alternatives. Require the exact owner-selected plan; separately retrieve and inspect current native support. Advice supplies no Delivery permission. |
bind | Bind the explicit Product request to its owned Repository through existing Delivery. |
grant | Record the explicitly supplied grant, paths, operations and fixed limits through existing Delivery. The wrapper supplies no default authority. |
plan | Freeze the selected alternative's exact native Slice and inputs. |
implementation | Run the original one-Attempt local job with the caller's pinned snapshots under the same Delivery paths. Require a valid retained Candidate and proposal. |
seal | Read genuine retained implementation proposal Evidence and seal through the exact bound Repository; the digest must equal the worker's Candidate. Return its exact native digest, manifest and snapshot digest; original file bytes stay in Repository. |
verification | Call verifyExternalCandidate for that native seal under the existing check owner/allowance; require Verified and current validity. |
integration | Use the original Action occurrence/dispatch and proof through D5; require integrated plus an actual dispatched sender receipt. |
assessment | Read and rederive the original proof through assessCandidate; require supported local measurements. |
marketing | Run the original Marketing job. Every supplied fact must match an observational measurement, unit, population and actual assessment content digest; require a complete valid pack that remains current. |
Research and Knowledge historical stage outputs remain separate from currentSupport. Completed semantic or advice replay does not establish present support. The candidate directly rechecks the original Research bindings and genuine Knowledge retrieval/support plus current Guidance before later effects. Stale, protected, withdrawn or changed support cannot be replaced with a newly convenient subset. Implementation Evidence describes the original request/source before a Candidate exists; Verification collects its own genuine Evidence after sealing. Existing stage APIs remain independently callable.
Stop, recovery and cancellation
Before Research or any other stage, read the native gate for unfinished D5 integration, including when marketing:null or another suffix is absent. Missing original recovery coordinates stop at integration with requires-input. A changed Action, occurrence or dispatch conflicts. The same native integrateCandidate reconciles the original Candidate/proof. Unknown remains stopped before earlier stage replay or any new contact. A confirmed original receipt permits only the native original replay contracts; it grants no new effect or changed pins.
FactoryWorkflowResult has protocol sf-factory-workflow-result/1, productId, outcome (complete or stopped), stoppedAt, reason, effect, recovery, stages and currentSupport. Reasons are requires-input, stage-refused, cancelled, uncertain or null. Effect is none, native-stages or unknown; none of these is a release receipt. Failures and native refusals stop progression. An exception after native stages may have committed returns uncertain/unknown rather than guessing or retrying. An invalid or unavailable pre-contact contract may throw FactoryWorkflowError; native parser errors can also propagate before contact. FactoryWorkflowError.code is INVALID, LIMIT, CONFLICT or UNAVAILABLE. Inspect original owners and retain identities when resolving uncertainty.
A native caller AbortSignal is checked between stages and combined with existing semantic, worker and Marketing signals. Worker and verification calls receive native cancellation. Research collection retains its own native cancellation interface; the wrapper's signal does not force an in-flight transport to stop. There is no universal elapsed-time guarantee for a supplied port that ignores cancellation. Only the relevant native owner can establish cleanup; elapsed time or a stopped wrapper cannot do so.
Fixed bounds and qualification
The wrapper permits one Product, thirteen named stage kinds and at most sixteen returned stage records: up to four collection records and twelve other stages. Its canonical request is at most 1 MiB and depth32. The whole JSON result has a 2 MiB bound, including 4 KiB reserved for wrapper fields; each canonical native observation also retains the tighter 1 MiB document limit; overflow stops uncertain without trimming retained native records or starting the next stage. There are at most four Research originals, sixteen configured source entries and sixteen selected citations; eight Knowledge alternatives and sixteen rules; sixteen Marketing facts and eight blocks.
These are additional caps. Native parsers, deadlines and allowances remain binding: Research and semantic requests are individually bounded to 64 KiB; Guidance v3 also has a 64 KiB request bound; the implementation manifest is 64 KiB with one Attempt, timeout at most 300,000 ms and at most 1 MiB process output; a verification proof witness is 64 KiB. A legal outer request can still fail a tighter native limit. Snapshot bytes remain separate original implementation collaborators. No budget or deadline resets on wrapper replay.
Acceptance must prove fresh prepared-prefix progression to completion and a separate exact completed-bundle replay with no additional source/collaborator contact, worker/collector launch or native allowance. Required controls include unknown Research, cancelled/refused worker, failed verifier, withdrawn integration authority, unsupported Marketing claims and original uncertain D5 recovery with an incomplete prefix. The author installed proof passed fresh progression, completed replay, native partial Collection uncertainty and incomplete-prefix D5 recovery; the additive native cancellation/refusal, failed verifier, final integration withdrawal, unsupported Marketing and live caller-mutation controls also passed in the frozen focused installed run. The author record retains exact source/artifact identity and failed runs. The original independent source and installed evidence review remains separately pinned. 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. See the reader guide and caller adoption procedure. Current joint execution of these bounded controls is recorded in the joint qualification record.
