Factory docs, home
Page navigation

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: reviewed local candidate, 3 October 2026. Core, planning shadow and native Guidance corrections passed independent source review. The installed consumer passed six checks with SQLite and directory-lock host arrangements. The independently reviewed frozen synthetic evaluation passed all 264 reads: precision and recall 100%, thirteen supported decisions beyond the empty Knowledge control, zero forbidden disclosures or unsupported selections. The native algorithm is deterministic keyword matching. 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. Qualification record.

Source: core, neutral contract, grammar and bounds. Tests: current authority, history and loss. Evidence: original source draft, review correction. Human guide. Planning-shadow draft.

Intelligence: none — Reviewed lesson pins, source permissions and deterministic advice retain original evidence; no model grants authority or chooses a new owner.

Ownership and host qualification

Construct Knowledge with an actual caller CommandJournal, one Product ID, a synchronous clock and KnowledgeCurrentHost. Imports create no resource. The host is a commissioned collaborator, not a caller JSON claim. It fences the actual Journal handle, Product registry, current access/retention, native source heads and relevant Guidance writers for one synchronous operation. withSnapshot receives that Journal handle and Product; its snapshot must return the exact handle. The callback must run once, synchronously, and its exact result must be returned before releasing the non-expiring fence. Class methods are allowed. Accessors are refused without invocation; Proxy collaborators remain outside the trust boundary.

The host authenticates source resolutions and independent reports through the current owners. A supplied report ID or preserved boolean does not establish authenticity. Independent reports bind exact draft, input revisions, source snapshot, drafter, distinct reviewer, procedure, disposition and every input atom. The host must separately commission that reviewer. The installed qualification covers two physical host arrangements and exact native source/report ownership; mechanism-test fixtures alone do not meet those gates. Other hosts need their own qualification.

Public operations

  • capture({commandId, expectedVersion, draft}) appends one immutable Learning revision with sources, applicability context, dependencies, conflict refs and typed atoms. A revision requires its exact latest predecessor. Sources must be current and permit durable retention. Current state with historical-only permission cannot support fresh retrieval or use.
  • review({commandId, expectedVersion, learning, report}) resolves an authentic independent report. Accepted findings must preserve every exact atom; duplicate, omitted or foreign findings refuse. Disposition history remains separate from current source validity.
  • compact({commandId, expectedVersion, draft, report}) records a consolidation and complete loss manifest. Each input atom maps to retained output, an independently judged equivalent duplicate, or explicit omission. Caveats, counterexamples, rejection reasons, trade-offs, unknowns and relationship endpoints cannot be omitted. Source lineage, context, dependencies and mapped qualifies, contradicts and rejected-because edges remain explicit. The original revisions remain readable.
  • inspectSupport({sources}) resolves permitted native sources under the same fence and returns the exact stable source-snapshot digest for reviewer preparation. The digest covers Product, permission revision and deduplicated sorted native resolutions, excluding transient byte counts. Observation times remain separate.
  • retrieve({text, context, dependencies}) considers the latest revision of each Learning only; a newer candidate or rejected revision never revives an older acceptance. It filters current access, exact context/dependencies and support before matching fixed Unicode word terms. It includes both cross-Learning conflicts and internal contradiction edges before lexical rank or the eight-result cap. Relevant contradictory or unavailable contrary support forces an incomplete result and abstention. More eligible matches than the cap also returns incomplete. It performs no semantic/model search.
  • recordUse({commandId, expectedVersion, use}) recomputes retrieval at the final current fence, requires its exact digest and a choice/reason for every returned ref, and records selected/declined/abstained use. An incomplete read cannot support selection. No selection requires an explicit abstention reason. A stale query dependency with durable retention permission may record explicit abstention; forbidden or historical-only retention still refuses.
  • linkUseOutcome({commandId, expectedVersion, link}) appends one current owner-result ref and supported/contradicted/inconclusive relationship. It never rewrites the original choice or calls correlation benefit.
  • read({kind, ref|digest|id}) returns an explicit historical envelope, retained record and current source states. Revoked or forbidden derivative disclosure refuses even when source state says current. Stale history is never current support. The envelope also gives the original native command ID and recorded version, without changing the retained record or any historical pin.
  • sourceConsumers({source}) rebuilds bounded direct and authenticated native-leaf reverse references to Learning revisions, consolidations, uses and outcome links without rewriting them.

Writes use the knowledge:product:<id> aggregate and stable knowledge- command IDs. Exact receipt replay returns the original result without a new revision; changed payload conflicts. Current read permission still applies to replay. Events bind native command ID, exact operation request, result, appended immutable record and complete state digest. Reads reconstruct bounded history and reject broken predecessor, consolidation or event relationships. Nothing repairs stored history.

Fixed bounds and refusals

Commands, results and reports: 64 KiB; state: 512 KiB; depth 32; 8,192 JSON nodes; 512 transitions. Sixteen Learning IDs, four revisions each; each Learning 16 KiB, sixteen atoms/sources/context predicates/dependencies. Atom text 1 KiB, reasons 512 bytes, exact source ref 512 bytes. Entire retained Product lineage: 256 unique native leaves, including historical revisions, use-query dependencies and outcomes. Per operation: 256 resolutions and 1 MiB transient resolved bytes. Sixty-four reviews, sixteen consolidations, sixteen consolidation inputs, ancestry eight, 256 manifest rows, eight retrieval results, sixty-four uses and four outcomes per use. Query: 1 KiB and 32 unique terms. Acquisition: one second; total synchronous operation: two seconds measured monotonically. Overflow refuses; history is never evicted or truncated to regain capacity.

KnowledgeError.code: INVALID, LIMIT, FORBIDDEN, STALE, CONFLICT, CORRUPT, UNAVAILABLE, NOT_FOUND. A host failure after a write may leave the original command committed: inspect/replay that identity; never mint another identity as recovery. Trusted synchronous ports are not a sandbox and can block the process. Knowledge never grants Delivery authority, modifies a Slice, runs a process/model/network call, or extends source retention.

Optional planning advice

adviseKnowledgePlan(request, knowledge, guidance) accepts actual public Knowledge and ProductGuidance instances, an exact current Guidance pin and authenticated source ref, a frozen caller decision profile, and two to four immutable PlanInput drafts. The bounded local profile validates all fields and compares drafts only when every field except process guardrails is identical. Rules name exact accepted Learning refs and rule atoms and map to existing process guardrails. Exactly one draft preserving all retrieved rules can be advised; incomplete coverage, undeclared rules or ties retain explicit abstention. The helper never changes a draft or admits a Slice. Supplied drafts remain advice inputs, not a claim of Delivery validation. Process entries use the native supported script suffixes. Original Guidance revisions are read through the captured native private-state reader; caller method overrides cannot replace that owner.

Guidance joins the use query dependencies so the caller host must authenticate and fence its current owner during final use retention. A later call with the original identity reconstructs the original receipt and explicitly returns currentAdvice: false; it never reranks against new Knowledge or quietly upgrades the Guidance pin. Current historical disclosure permission still applies. adviceOnly: true never grants execution authority. Quoted instructions remain source data.

The mechanism cases cover original replay, native Guidance drift and permission revocation, conflict/tie/unmapped abstention and quoted text. Separate frozen corpus review, installed host proof and synthetic evaluation are recorded in the qualification draft. Bounded native Factory composition retains its independent snapshot review. 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. Live learning remains open.

Source: docs/agents/knowledge.md