Use the two private package entries with your own caller-owned Journal, original records, native Research APIs, clock and explicitly qualified semantic fence. Existing research-jobs v1 remains modelCalls:0 and model:"unavailable". No live model or feature-admission adapter is included. The first native window must already have been collected by its separately commissioned owner.
import {runResearchSemanticJob, inspectResearchSemanticJob} from 'software-factory/research-semantics';
import {RESEARCH_SEMANTICS_LIMITS} from 'software-factory/research-semantics-contract';
// request is an sf-research-semantic-job/1 value resolved from your original records.
// ports supplies your journal, qualified fence/context, clock and native owner readers.
export function analyseRetainedWindow(request, ports) {
return runResearchSemanticJob(request, ports);
}
export function inspectRetainedWindow(job, ports) {
return inspectResearchSemanticJob(job, ports);
}
export const maximumSelectedQuotes = RESEARCH_SEMANTICS_LIMITS.citations;
- Resolve an actual semantic commission and original allowance. Bind Product, window, objective, Guidance, values, operating policy and the actual source catalogue. The allowance has explicit call/byte limits and absolute deadline; retain the original identity across all aliases. Supply no default grant or threshold.
- Bind actual native
ResearchJobApireaders to exact producer/store identities with their authenticated contexts. Select at most four retained native collections and sixteen quotes, one quote per source/content capture. Supply each original v1 request and CollectionRef unchanged. Native admission, evidence membership and quote verification must remain available; no wrapper verdict substitutes for native verified bytes. - Implement and qualify the semantic fence against your actual records and Journal identity. It authenticates READ, resolves pins/body, serialises callbacks with current commission/policy writers and checks fresh authority for
mutateandcontact.settleis original historical closure under READ, never fresh contact permission. The callback runs synchronously and closes when the fence returns or throws; return its exact value unchanged. A contact callback may return a native Promise. do not invoke native readers from a Journal decide callback. Independent stores and collaborators are not one transaction. - Supply an optional triager with an explicit ID and policy pin. It returns
sf-research-triage-reply/1, a state (accepted,rejectedornoise) and a bounded statement. Supply an optional synthesiser returningsf-research-synthesis-reply/1findings/proposals over the given Signal IDs. A source observation must equal one of its verified quotes exactly; other conclusions are author inferences or open questions. Neither port may relabel source classes or invent quote support. - Run the original request with a fixed Budget and clock. Preserve Journal records after unknown commit and retry only the same command/job identity to reconcile ownership. Never repeat a collaborator after retained dispatch. Unknown and invalid replies use their whole reservation. Keep the immutable Product root receipt and durably pinned synthesis offer; a renamed root with no predecessor refuses. Cancellation only cooperatively asks a collaborator to stop.
- Reopen the same caller storage to replay a completed job under READ. Inspect it separately for current native support; historical checked times and findings remain historical. A compatible no-change alias reuses the original analysis owner with zero triage/synthesis calls. Changed collaborator or semantic inputs conflict; a changed ID alone is insufficient.
- If needed, supply an actual optional shadow-policy pin and every numeric threshold explicitly. Competitor-only support stays parked. Every result says
admission:"not-performed"; validation, planning and implementation require their own authority.
The public contract has no ambient Node declarations. Its structural Journal and cancellation ports accept the real caller implementations; runtime development uses your own compatible Node types. Importing either entry creates no storage, reads no clock and contacts no provider. The installed consumer uses native caller-owned storage, local source fixtures and substituted structured collaborators; it proves mechanism behaviour, not the semantic quality of live model output.
Bounds refuse whole input or output rather than trimming evidence. The profile is 64 KiB request/result, four collections, sixteen selected citations/Signals/findings and eight proposals. A shared original allowance has at most 17 calls,65536 reply bytes, seventeen durable slots and an immutable deadline. There is no publication, model selection, automatic renewal, broad credential scope, rolling Research scheduler or feature admission.
