@vostride/agent-qa-knowledge-local 0.0.1 → 0.2.2

package/dist/reader.d.cts

@@ -0,0 +1,107 @@
+export { e as AUTHORING_BRIEF_DEFAULT_BUDGET, f as AUTHORING_DENSE_K, p as AuthoringReaderDependencies, s as CanaryPostureFacts, v as DiffSinceOptions, b0 as HydratedEntry, b1 as IndexRow, J as InspectRecordsOptions, O as KnowledgeMaintenanceScanError, P as KnowledgeMaintenanceScanIssue, S as KnowledgeRecordNotFoundError, W as LowerTrustShare, X as MARK_EVIDENCE_TOKEN_PREFIX, Y as MarkEvidenceEffect, Z as MarkEvidencePlan, _ as MarkEvidenceTarget, a1 as OpenServingKnowledgeReaderConfig, a2 as PlanMarkEvidenceInput, a4 as QUARANTINE_CLASS_DISPOSITIONS, b2 as QUARANTINE_FLOOR_ELIGIBILITY, a8 as QUARANTINE_LEDGER_FILENAME, ac as QuarantineDisposition, b3 as QuarantineFloorEligibility, ad as QuarantineLedgerRead, R as RefusedQuarantineLine, an as ShowRecordOptions, ao as StandingReceiptDigest, ar as canaryPostureFactsFor, au as createAuthoringReader, aw as diffSince, aA as foldQuarantineLedgerState, b4 as hydrateRows, aC as inspectRecords, aF as lowerTrustSharesFor, aG as markEvidenceEvent, aJ as openKnowledgeReader, aK as planMarkEvidence, aM as projectMarkEvidenceOutcome, aN as quarantineLedgerPath, b5 as readIndexRows, aR as readQuarantineLedger, aX as showRecord, aY as standingReceiptDigestsFor } from './mark-evidence-plan-BCkYN07i.cjs';
+import { CanaryOutcome, TrustPriorTable, KnowledgeBundleSummary, KnowledgeRecordShowResult, ResolvePromotionPosture, KnowledgeGatesListResult, KnowledgeCandidateInjectionResult } from '@vostride/agent-qa-schema';
+export { BuildRange, ReadOptions, SearchOptions } from '@vostride/agent-qa-schema';
+import '@vostride/agent-qa-agent';
+import '@vostride/agent-qa-runner';
+import 'node:sqlite';
+
+/**
+ * D-22: bind one canary observation to the served candidate and attributed step. The schema
+ * evidence-token recipe adds the exercised anchor and build ordinal; together those fields are
+ * the complete replay identity required by §7.5.1.
+ */
+declare function canaryOutcomeObservationId(outcome: Pick<CanaryOutcome, 'candidateId' | 'runId' | 'testId' | 'testIndex' | 'stepIndex'>): string;
+
+/**
+ * List every committed bundle under a knowledge root, newest lifecycle state first-class.
+ *
+ * Deliberately UNFILTERED by serving lifecycle: unlike `scanBundles`, a listing is a review
+ * surface, and a superseded or withdrawn record is exactly what a reviewer needs to see. The
+ * serving firewall (`isServable`) belongs on retrieval paths, not on a catalog.
+ *
+ * A bundle whose canonical files do not strictly parse is SKIPPED rather than thrown on, so
+ * one damaged bundle never hides every other bundle from the listing. A missing knowledge
+ * root is an ordinary empty result — `enumerateBundleDirs` already treats an unreadable
+ * directory as empty.
+ *
+ * Order is total and stable: product, then bundle directory name (which is the record id).
+ * `enumerateBundleDirs` already sorts on exactly those two keys.
+ */
+declare function listBundles(knowledgeRoot: string, priors?: TrustPriorTable): KnowledgeBundleSummary[];
+
+interface ShowRecordsOptions {
+    knowledgeRoot: string;
+    recordIds: readonly string[];
+}
+/**
+ * Resolve exact identities in first-request order with one maintenance enumeration.
+ * Missing records are data; incomplete scans retain KnowledgeMaintenanceScanError so
+ * callers can report scanIncomplete instead of presenting a partial set as clean misses.
+ * Like the single-record read, this bypasses serving filters and never opens an index.
+ */
+declare function showRecords(options: ShowRecordsOptions): readonly KnowledgeRecordShowResult[];
+
+/** The four observation words. A lifecycle event carrying the same id attributes nothing. */
+declare const ATTRIBUTING_EVENT_TYPES: readonly ["confirmed", "contradicted", "helpful", "harmful"];
+type CanaryAttributionOutcome = (typeof ATTRIBUTING_EVENT_TYPES)[number];
+/** One served canary line, addressed the way the run recorded it. */
+interface CanaryAttributionTuple {
+    candidateId: string;
+    testId: string;
+    testIndex: number;
+    stepIndex: number;
+}
+interface CanaryAttributionRow {
+    candidateId: string;
+    testIndex: number;
+    stepIndex: number;
+    observationId: string;
+    outcome?: CanaryAttributionOutcome;
+}
+/**
+ * The attribution answer, with the partiality of the walk that produced it.
+ *
+ * `skippedBundles > 0` means the answer is PARTIAL — some bundle in the store failed
+ * `loadMaintenanceBundle` (load or integrity) and was skipped. A caller that renders
+ * `not attributed` from an absent `outcome` must consult this first: on a partial walk the
+ * absence means "not found in the part of the store I could read", which is not the same claim
+ * (REVIEW WR-03; the T-407-11 hazard class is the integrity arm).
+ */
+interface CanaryAttributionsResult {
+    rows: CanaryAttributionRow[];
+    skippedBundles: number;
+}
+interface CanaryAttributionsForOptions {
+    knowledgeRoot: string;
+    runId: string;
+    tuples: readonly CanaryAttributionTuple[];
+}
+/**
+ * Answer, per served canary tuple, the observation id it would have been attributed under and the
+ * committed outcome carrying that id — when one survives.
+ *
+ * The answer carries `skippedBundles` beside the rows so the caller never has to infer the
+ * partiality of this walk from some other read (REVIEW WR-03).
+ *
+ * An empty tuple list answers no rows and no skips without touching the store: there is nothing to
+ * look up, and a walk that could fail on an unrelated bundle would turn "you asked about nothing"
+ * into an error.
+ */
+declare function canaryAttributionsFor(options: CanaryAttributionsForOptions): CanaryAttributionsResult;
+
+interface GateReceiptsForOptions {
+    knowledgeRoot: string;
+    candidateId: string;
+    /** Resolved per candidate by the same assembly used by the promotion doors. */
+    resolvePromotionPosture?: ResolvePromotionPosture;
+}
+declare function gateReceiptsFor(options: GateReceiptsForOptions): KnowledgeGatesListResult;
+
+interface CandidateInjectionForOptions {
+    knowledgeRoot: string;
+    candidateId: string;
+    priors?: TrustPriorTable;
+}
+declare function candidateInjectionFor(options: CandidateInjectionForOptions): KnowledgeCandidateInjectionResult;
+
+export { type CanaryAttributionOutcome, type CanaryAttributionRow, type CanaryAttributionTuple, type CanaryAttributionsForOptions, type CanaryAttributionsResult, type CandidateInjectionForOptions, type GateReceiptsForOptions, type ShowRecordsOptions, canaryAttributionsFor, canaryOutcomeObservationId, candidateInjectionFor, gateReceiptsFor, listBundles, showRecords };

package/dist/reader.d.ts

@@ -0,0 +1,107 @@
+export { e as AUTHORING_BRIEF_DEFAULT_BUDGET, f as AUTHORING_DENSE_K, p as AuthoringReaderDependencies, s as CanaryPostureFacts, v as DiffSinceOptions, b0 as HydratedEntry, b1 as IndexRow, J as InspectRecordsOptions, O as KnowledgeMaintenanceScanError, P as KnowledgeMaintenanceScanIssue, S as KnowledgeRecordNotFoundError, W as LowerTrustShare, X as MARK_EVIDENCE_TOKEN_PREFIX, Y as MarkEvidenceEffect, Z as MarkEvidencePlan, _ as MarkEvidenceTarget, a1 as OpenServingKnowledgeReaderConfig, a2 as PlanMarkEvidenceInput, a4 as QUARANTINE_CLASS_DISPOSITIONS, b2 as QUARANTINE_FLOOR_ELIGIBILITY, a8 as QUARANTINE_LEDGER_FILENAME, ac as QuarantineDisposition, b3 as QuarantineFloorEligibility, ad as QuarantineLedgerRead, R as RefusedQuarantineLine, an as ShowRecordOptions, ao as StandingReceiptDigest, ar as canaryPostureFactsFor, au as createAuthoringReader, aw as diffSince, aA as foldQuarantineLedgerState, b4 as hydrateRows, aC as inspectRecords, aF as lowerTrustSharesFor, aG as markEvidenceEvent, aJ as openKnowledgeReader, aK as planMarkEvidence, aM as projectMarkEvidenceOutcome, aN as quarantineLedgerPath, b5 as readIndexRows, aR as readQuarantineLedger, aX as showRecord, aY as standingReceiptDigestsFor } from './mark-evidence-plan-BCkYN07i.js';
+import { CanaryOutcome, TrustPriorTable, KnowledgeBundleSummary, KnowledgeRecordShowResult, ResolvePromotionPosture, KnowledgeGatesListResult, KnowledgeCandidateInjectionResult } from '@vostride/agent-qa-schema';
+export { BuildRange, ReadOptions, SearchOptions } from '@vostride/agent-qa-schema';
+import '@vostride/agent-qa-agent';
+import '@vostride/agent-qa-runner';
+import 'node:sqlite';
+
+/**
+ * D-22: bind one canary observation to the served candidate and attributed step. The schema
+ * evidence-token recipe adds the exercised anchor and build ordinal; together those fields are
+ * the complete replay identity required by §7.5.1.
+ */
+declare function canaryOutcomeObservationId(outcome: Pick<CanaryOutcome, 'candidateId' | 'runId' | 'testId' | 'testIndex' | 'stepIndex'>): string;
+
+/**
+ * List every committed bundle under a knowledge root, newest lifecycle state first-class.
+ *
+ * Deliberately UNFILTERED by serving lifecycle: unlike `scanBundles`, a listing is a review
+ * surface, and a superseded or withdrawn record is exactly what a reviewer needs to see. The
+ * serving firewall (`isServable`) belongs on retrieval paths, not on a catalog.
+ *
+ * A bundle whose canonical files do not strictly parse is SKIPPED rather than thrown on, so
+ * one damaged bundle never hides every other bundle from the listing. A missing knowledge
+ * root is an ordinary empty result — `enumerateBundleDirs` already treats an unreadable
+ * directory as empty.
+ *
+ * Order is total and stable: product, then bundle directory name (which is the record id).
+ * `enumerateBundleDirs` already sorts on exactly those two keys.
+ */
+declare function listBundles(knowledgeRoot: string, priors?: TrustPriorTable): KnowledgeBundleSummary[];
+
+interface ShowRecordsOptions {
+    knowledgeRoot: string;
+    recordIds: readonly string[];
+}
+/**
+ * Resolve exact identities in first-request order with one maintenance enumeration.
+ * Missing records are data; incomplete scans retain KnowledgeMaintenanceScanError so
+ * callers can report scanIncomplete instead of presenting a partial set as clean misses.
+ * Like the single-record read, this bypasses serving filters and never opens an index.
+ */
+declare function showRecords(options: ShowRecordsOptions): readonly KnowledgeRecordShowResult[];
+
+/** The four observation words. A lifecycle event carrying the same id attributes nothing. */
+declare const ATTRIBUTING_EVENT_TYPES: readonly ["confirmed", "contradicted", "helpful", "harmful"];
+type CanaryAttributionOutcome = (typeof ATTRIBUTING_EVENT_TYPES)[number];
+/** One served canary line, addressed the way the run recorded it. */
+interface CanaryAttributionTuple {
+    candidateId: string;
+    testId: string;
+    testIndex: number;
+    stepIndex: number;
+}
+interface CanaryAttributionRow {
+    candidateId: string;
+    testIndex: number;
+    stepIndex: number;
+    observationId: string;
+    outcome?: CanaryAttributionOutcome;
+}
+/**
+ * The attribution answer, with the partiality of the walk that produced it.
+ *
+ * `skippedBundles > 0` means the answer is PARTIAL — some bundle in the store failed
+ * `loadMaintenanceBundle` (load or integrity) and was skipped. A caller that renders
+ * `not attributed` from an absent `outcome` must consult this first: on a partial walk the
+ * absence means "not found in the part of the store I could read", which is not the same claim
+ * (REVIEW WR-03; the T-407-11 hazard class is the integrity arm).
+ */
+interface CanaryAttributionsResult {
+    rows: CanaryAttributionRow[];
+    skippedBundles: number;
+}
+interface CanaryAttributionsForOptions {
+    knowledgeRoot: string;
+    runId: string;
+    tuples: readonly CanaryAttributionTuple[];
+}
+/**
+ * Answer, per served canary tuple, the observation id it would have been attributed under and the
+ * committed outcome carrying that id — when one survives.
+ *
+ * The answer carries `skippedBundles` beside the rows so the caller never has to infer the
+ * partiality of this walk from some other read (REVIEW WR-03).
+ *
+ * An empty tuple list answers no rows and no skips without touching the store: there is nothing to
+ * look up, and a walk that could fail on an unrelated bundle would turn "you asked about nothing"
+ * into an error.
+ */
+declare function canaryAttributionsFor(options: CanaryAttributionsForOptions): CanaryAttributionsResult;
+
+interface GateReceiptsForOptions {
+    knowledgeRoot: string;
+    candidateId: string;
+    /** Resolved per candidate by the same assembly used by the promotion doors. */
+    resolvePromotionPosture?: ResolvePromotionPosture;
+}
+declare function gateReceiptsFor(options: GateReceiptsForOptions): KnowledgeGatesListResult;
+
+interface CandidateInjectionForOptions {
+    knowledgeRoot: string;
+    candidateId: string;
+    priors?: TrustPriorTable;
+}
+declare function candidateInjectionFor(options: CandidateInjectionForOptions): KnowledgeCandidateInjectionResult;
+
+export { type CanaryAttributionOutcome, type CanaryAttributionRow, type CanaryAttributionTuple, type CanaryAttributionsForOptions, type CanaryAttributionsResult, type CandidateInjectionForOptions, type GateReceiptsForOptions, type ShowRecordsOptions, canaryAttributionsFor, canaryOutcomeObservationId, candidateInjectionFor, gateReceiptsFor, listBundles, showRecords };