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. Retained planning-advice, native-host and fixed synthetic evaluation evidence is described in the Knowledge qualification record; deterministic keyword matching establishes no semantic advantage.
Use Node.js 26.8.1 or later, ESM and an exact retained private tarball. Imports open no resources or transports and read no clock. There are no runtime npm dependencies. The application supplies an actual CommandJournal, one Product, a synchronous qualified native host and an explicit clock. TypeScript callers of knowledge or delivery-knowledge-shadow supply compatible Node declarations; knowledge-contract is neutral data and requires only ES2024 declarations.
import { Knowledge } from 'software-factory/knowledge';
import { adviseKnowledgePlan } from 'software-factory/delivery-knowledge-shadow';
export function openKnowledge(callerJournal, productId, qualifiedHost, clock) {
return new Knowledge({ journal: callerJournal, productId, host: qualifiedHost, clock });
}
export function inspectLessons(knowledge, query) {
return knowledge.retrieve(query);
}
export function compareOriginalDrafts(retainedRequest, knowledge, nativeGuidance) {
return adviseKnowledgePlan(retainedRequest, knowledge, nativeGuidance);
}
Native ownership and current permission
KnowledgeCurrentHost.withSnapshot receives the actual Journal object, Product and a one-second acquisition bound. Hold non-expiring native exclusion covering that Journal writer, Product registry, source heads, access/retention and relevant Guidance writers. Invoke the supplied callback exactly once synchronously; return its exact result and release in finally. The snapshot must identify the same actual Journal object. Every relevant owner mutation must use the same exclusion. A caller boolean, expiry lease, source digest or report ID is not authority.
Resolve every source through its current native owner: authenticate Product, exact store/record/revision/span, content and collection digest, retention permission and complete native leaves. Resolve independent reports through a separately commissioned reviewer store; verify their original bytes and report digest. The core binds exact inputs, draft, source snapshot, distinct drafter/reviewer and complete per-atom findings. Synthetic mechanism reports do not establish semantic acceptance. Do not retain private restricted source text in a durable lesson. Current-but-forbidden and historical-only sources cannot support new selected use.
Two physical caller arrangements and all relevant writer paths need qualification. The supplied consumer fixtures exercise local SQLite and directory exclusion over disposable synthetic source/reviewer stores. They qualify those arrangements only; an application must qualify its actual source adapters and mutation paths. Imports or passing mechanism tests alone are insufficient.
Immutable commands and history
The core offers capture, review, compact, inspectSupport, retrieve, recordUse, linkUseOutcome, read and sourceConsumers. Retain every exact request and stable knowledge- command ID before writing. After a missing acknowledgement, inspect and replay that identity with identical input; a renamed command does not recover the original. Reads reconstruct bounded native history and refuse corruption. No operation repairs history or evicts records to restore capacity.
Consolidation preserves complete source lineage, context, dependencies, caveats and relation endpoints with an independently reviewed loss manifest. Historical views keep original dispositions and return current source states, original command ID and recorded version. Permission still gates historical disclosure. Source expiry never turns historical evidence into fresh support. A permitted stale dependency may retain explicit abstention; restricted retention refuses.
Advice and honest limits
Planning advice accepts actual public Knowledge and ProductGuidance instances, an exact native Guidance pin/source, a predeclared decision profile and two to four immutable supplied PlanInput drafts. Rule mappings name exact Learning refs and rule atoms and existing process guardrails. A unique supported draft is advice only. Ties, missing support or incomparable alternatives require abstention. Drafts are not admitted Slices; execute any later work through the ordinary Delivery authority and validation stages.
The Guidance source joins the query dependencies at the final retained-use fence. Replaying original advice resolves the historical pin and original receipt and reports currentAdvice: false. It never recomputes the decision under a new Guidance revision or silently changes a frozen draft. Quoted source instructions remain data. Knowledge never invokes a model, network, process, provider, scheduler, grant or Delivery effect.
Commands, reports and results are bounded to 64 KiB, retained state to 512 KiB and 512 transitions. Other fixed bounds are exported as KNOWLEDGE_LIMITS. Overflow refuses; capacity is not restored by truncation. KnowledgeError.code is INVALID, LIMIT, FORBIDDEN, STALE, CONFLICT, CORRUPT, UNAVAILABLE or NOT_FOUND. Trusted synchronous collaborators are not a sandbox. The retained bounded native concert consumes original Knowledge advice and separately rechecks current support. The corrected historical 7cf union passed combined native execution and independent bounded local evidence acceptance. Broader platforms, live provider/source qualification and broader semantic usefulness remain open.
