@tangle-network/agent-knowledge 22.0.13 → 22.0.18

package/dist/index.js

@@ -1,9 +1,9 @@
-import { $ as loadSourceRegistry, $n as writeFileDurableWithinRoot, $t as KNOWLEDGE_EVENT_TYPES, A as validateKnowledgePage, An as finishKnowledgeFileTransaction, At as isScaffoldPath, B as CHECKABLE_RUNG_THRESHOLD, Bn as canonicalRelativeWithinRoot, Bt as KnowledgeEventSchema, C as immutablePageDigest, Cn as runInKnowledgeMutationScope, Ct as resolveKnowledgeCitation, D as normalizeVisibilityArtifact, Dn as applyKnowledgeFileTransaction, Dt as SCAFFOLD_PAGE_BASENAMES, E as nonEmpty$1, En as withKnowledgeRead, Et as resolveRunScopedCitations, F as detectNearDuplicatePages, Fn as recordLockOwner, Ft as WIKILINK_REGEX, G as gradeClaims, Gn as readRegularFileWithinRoot, Gt as KnowledgePageSchema, H as UncheckableClaimError, Hn as isMissingFile, Ht as KnowledgeGraphNodeSchema, I as normalizePageText, In as takeOverDeadHolder, It as extractWikilinks, J as verifyGradeableEvidence, Jn as renameDurable, Jt as ResearchClaimLedgerSchema, K as gradeFor, Kn as relativeWithinRoot, Kt as KnowledgeRelationSchema, L as prepareKnowledgeValidation, Ln as DEFAULT_PAGES_DIRECTORY, Lt as normalizeLinkTarget, M as verifyKnowledgeVisibilitySnapshot, Mn as prepareKnowledgeFileTransaction, Mt as layoutFor, N as visibilityIdentity, Nn as rollbackKnowledgeFileTransaction, Nt as loadKnowledgePages, O as normalizeVisibilityRef, On as assertKnowledgeMutationPath, Ot as initKnowledgeBase, P as visibilityIndexOf, Pn as RUN_LEASE, Pt as writeJson, Q as addSourceText, Qn as writeFileDurable, Qt as SourceRecordSchema, R as validateKnowledgeIndex, Rn as normalizePagesDirectory, Rt as DeepQuestionSchema, S as encodeKnowledgeVisibilitySnapshot, Sn as recoverPendingKnowledgeMutation, St as parseKnowledgeCitationReference, T as knowledgeVisibilityArtifactRef, Tn as withKnowledgeMutationLabel, Tt as resolveRunScopedCitation, U as assertGradeableEvidence, Un as listRegularFilesWithinRoot, Ut as KnowledgeIndexSchema, V as DEADLINE_EXIT_CODE, Vn as isKernelAnchoredPath, Vt as KnowledgeGraphEdgeSchema, W as claimCheckKey, Wn as readRegularFileNoFollow, Wt as KnowledgePageInvalidationSchema, X as writeKnowledgeIndex, Xn as withSafeDescendant, Xt as ResearchSourceVersionSchema, Y as buildKnowledgeIndex, Yn as syncDirectory, Yt as ResearchClaimRecordSchema, Z as addSourcePath, Zn as withSafeDirectory, Zt as SourceAnchorSchema, _ as KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION, _n as parseFrontmatter, _t as assertKnowledgeCitationsResolved, a as applyKnowledgeWriteBlocksFile, an as claimEvidenceId, at as KB_CLAIM_LEDGER_DIR, b as decodeKnowledgeVisibilitySnapshot, bn as isKnowledgeMutationHeld, bt as auditKnowledgeCitations, c as KnowledgeDuplicateIntakeError, cn as deepQuestionId, ct as KB_STORE_DIR, d as createFileRunLineageAuthority, dn as materializeRegisteredClaimEvidence, dt as buildKnowledgeGraph, en as ClaimLedgerGoalConflictError, er as writeJsonDurable, et as snapshotSourceTextInput, f as createRunScopedStores, fn as mergeClaimLedgers, ft as knowledgePageRelations, g as KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM, gn as formatFrontmatter, gt as assertKnowledgeCitationAudit, h as originatedPages, hn as researchSourceVersionKey, ht as assertCurrentRunCitationsResolved, i as applyKnowledgeWriteBlocks, in as assertTrackedClaimIntegrity, it as FileSystemKbStore, j as validateOrigin, jn as knowledgeFileTransactionPlanHash, jt as knowledgePageFromMarkdown, k as snapshotImmutableVisibility, kn as commitKnowledgeFileMutations, kt as isKnowledgePagePath, l as assertKnowledgeWriteIntake, ln as emptyClaimLedger, lt as MemoryKbStore, m as loadKnowledgeToolChain, mn as normalizeClaimText, mt as KnowledgeCitationResolutionError, n as inspectKnowledgeIndex, nn as assertResearchClaimEvidenceIntegrity, nr as mediaTypeFor, nt as writeSourceRegistry, o as isSafeKnowledgePath, on as claimId, ot as KB_EVENTS_PATH, p as isKnowledgeToolChain, pn as mergeTrackedClaims, pt as KnowledgeCitationAuditError, q as verdictFor, qn as removeDurable, qt as ResearchClaimEvidenceSchema, r as stringMetadata, rn as assertResearchClaimLedgerIntegrity, rr as textSourceAdapter, rt as ClaimLedgerMigrationRequiredError, s as parseKnowledgeWriteBlocks, sn as claimSourceHost, st as KB_INDEX_PATH, t as explainKnowledgeTarget, tn as assertDeepQuestionIntegrity, tr as writeJsonDurableWithinRoot, tt as sourceRegistryPath, u as RUN_LINEAGE_BASENAME, un as linkClaimContradictions, ut as assertClaimLedgerId, v as assertSchemaVersion, vn as acquireDurableFileLock, vt as assertRunScopedCitationsResolved, w as knowledgePageDigest, wn as withKnowledgeMutation, wt as resolveKnowledgeCitations, x as digest, xn as measureKnowledgeMutation, xt as formatKnowledgeCitationReference, y as createKnowledgeVisibilitySnapshot, yn as inspectPendingKnowledgeMutation, yt as auditCurrentRunCitations, z as lintKnowledgeIndex, zn as canonicalPathsEqual, zt as KnowledgeBaseCandidateSchema } from "./inspect-rXk5_r3K.js";
-import { i as textSourceId, n as slugify, r as stableId, t as sha256 } from "./ids-Bevz_pXV.js";
-import { a as buildKnowledgeLexicalIndex, c as tokenizeText, d as lexicalPageTerms, i as searchKnowledgePages, l as DEFAULT_FIELD_BOOSTS, n as reciprocalRankFusion, o as scoreBm25, r as searchKnowledge, s as tokenizeQuery, t as KNOWLEDGE_SEARCH_RETRIEVER_ID, u as assembleLexicalIndex } from "./search-aZdP2685.js";
-import { n as memoryWriteResultToSourceRecord, t as memoryHitToSourceRecord } from "./source-record-CdWvzvO6.js";
-import { n as createNoopMemoryBenchmarkAdapter, t as createInMemoryBenchmarkAdapter } from "./benchmarks-jir3ZP-M.js";
-import { A as resetRetrievalHoldoutRegistry, C as forkAgentMemoryBranchSnapshot, D as applySessionStickyRetrievalHoldout, E as applyRetrievalHoldout, M as toOffPolicyTrajectory, O as deterministicRng, S as createAgentMemoryBranch, T as renderMemoryContext, _ as resolveMemoryCleanupTimeoutMs, a as HindsightOperationUnknownError, b as createGraphitiMemoryAdapter, c as AgentMemoryHitSchema, d as AgentMemoryWriteInputSchema, f as AgentMemoryLifecycleTimeoutError, g as memoryRecoveryDelayMs, h as createMemoryExecutionPool, i as mem0MemoryAdapterIdentity, j as retrievalHoldoutConfigHash, k as emitRetrievalHoldoutBypass, l as AgentMemoryKindSchema, m as DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, n as createNeo4jAgentMemoryAdapter, o as createHindsightMemoryAdapter, p as AgentMemoryLifecycleUnsafeError, r as createMem0MemoryAdapter, s as hindsightMemoryBankId, t as createPlayMemoryTools, u as AgentMemoryScopeSchema, v as runBoundedMemoryLifecycle, w as defaultGetMemoryContext, x as graphitiMemoryAdapterIdentity, y as sleepForMemoryRecovery } from "./memory-BH6oT1Qe.js";
+import { $ as loadSourceRegistry, $n as writeFileDurableWithinRoot, $t as KNOWLEDGE_EVENT_TYPES, A as validateKnowledgePage, An as finishKnowledgeFileTransaction, At as isScaffoldPath, B as CHECKABLE_RUNG_THRESHOLD, Bn as canonicalRelativeWithinRoot, Bt as KnowledgeEventSchema, C as immutablePageDigest, Cn as runInKnowledgeMutationScope, Ct as resolveKnowledgeCitation, D as normalizeVisibilityArtifact, Dn as applyKnowledgeFileTransaction, Dt as SCAFFOLD_PAGE_BASENAMES, E as nonEmpty$1, En as withKnowledgeRead, Et as resolveRunScopedCitations, F as detectNearDuplicatePages, Fn as recordLockOwner, Ft as WIKILINK_REGEX, G as gradeClaims, Gn as readRegularFileWithinRoot, Gt as KnowledgePageSchema, H as UncheckableClaimError, Hn as isMissingFile, Ht as KnowledgeGraphNodeSchema, I as normalizePageText, In as takeOverDeadHolder, It as extractWikilinks, J as verifyGradeableEvidence, Jn as renameDurable, Jt as ResearchClaimLedgerSchema, K as gradeFor, Kn as relativeWithinRoot, Kt as KnowledgeRelationSchema, L as prepareKnowledgeValidation, Ln as DEFAULT_PAGES_DIRECTORY, Lt as normalizeLinkTarget, M as verifyKnowledgeVisibilitySnapshot, Mn as prepareKnowledgeFileTransaction, Mt as layoutFor, N as visibilityIdentity, Nn as rollbackKnowledgeFileTransaction, Nt as loadKnowledgePages, O as normalizeVisibilityRef, On as assertKnowledgeMutationPath, Ot as initKnowledgeBase, P as visibilityIndexOf, Pn as RUN_LEASE, Pt as writeJson, Q as addSourceText, Qn as writeFileDurable, Qt as SourceRecordSchema, R as validateKnowledgeIndex, Rn as normalizePagesDirectory, Rt as DeepQuestionSchema, S as encodeKnowledgeVisibilitySnapshot, Sn as recoverPendingKnowledgeMutation, St as parseKnowledgeCitationReference, T as knowledgeVisibilityArtifactRef, Tn as withKnowledgeMutationLabel, Tt as resolveRunScopedCitation, U as assertGradeableEvidence, Un as listRegularFilesWithinRoot, Ut as KnowledgeIndexSchema, V as DEADLINE_EXIT_CODE, Vn as isKernelAnchoredPath, Vt as KnowledgeGraphEdgeSchema, W as claimCheckKey, Wn as readRegularFileNoFollow, Wt as KnowledgePageInvalidationSchema, X as writeKnowledgeIndex, Xn as withSafeDescendant, Xt as ResearchSourceVersionSchema, Y as buildKnowledgeIndex, Yn as syncDirectory, Yt as ResearchClaimRecordSchema, Z as addSourcePath, Zn as withSafeDirectory, Zt as SourceAnchorSchema, _ as KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION, _n as parseFrontmatter, _t as assertKnowledgeCitationsResolved, a as applyKnowledgeWriteBlocksFile, an as claimEvidenceId, at as KB_CLAIM_LEDGER_DIR, b as decodeKnowledgeVisibilitySnapshot, bn as isKnowledgeMutationHeld, bt as auditKnowledgeCitations, c as KnowledgeDuplicateIntakeError, cn as deepQuestionId, ct as KB_STORE_DIR, d as createFileRunLineageAuthority, dn as materializeRegisteredClaimEvidence, dt as buildKnowledgeGraph, en as ClaimLedgerGoalConflictError, er as writeJsonDurable, et as snapshotSourceTextInput, f as createRunScopedStores, fn as mergeClaimLedgers, ft as knowledgePageRelations, g as KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM, gn as formatFrontmatter, gt as assertKnowledgeCitationAudit, h as originatedPages, hn as researchSourceVersionKey, ht as assertCurrentRunCitationsResolved, i as applyKnowledgeWriteBlocks, in as assertTrackedClaimIntegrity, it as FileSystemKbStore, j as validateOrigin, jn as knowledgeFileTransactionPlanHash, jt as knowledgePageFromMarkdown, k as snapshotImmutableVisibility, kn as commitKnowledgeFileMutations, kt as isKnowledgePagePath, l as assertKnowledgeWriteIntake, ln as emptyClaimLedger, lt as MemoryKbStore, m as loadKnowledgeToolChain, mn as normalizeClaimText, mt as KnowledgeCitationResolutionError, n as inspectKnowledgeIndex, nn as assertResearchClaimEvidenceIntegrity, nr as mediaTypeFor, nt as writeSourceRegistry, o as isSafeKnowledgePath, on as claimId, ot as KB_EVENTS_PATH, p as isKnowledgeToolChain, pn as mergeTrackedClaims, pt as KnowledgeCitationAuditError, q as verdictFor, qn as removeDurable, qt as ResearchClaimEvidenceSchema, r as stringMetadata, rn as assertResearchClaimLedgerIntegrity, rr as textSourceAdapter, rt as ClaimLedgerMigrationRequiredError, s as parseKnowledgeWriteBlocks, sn as claimSourceHost, st as KB_INDEX_PATH, t as explainKnowledgeTarget, tn as assertDeepQuestionIntegrity, tr as writeJsonDurableWithinRoot, tt as sourceRegistryPath, u as RUN_LINEAGE_BASENAME, un as linkClaimContradictions, ut as assertClaimLedgerId, v as assertSchemaVersion, vn as acquireDurableFileLock, vt as assertRunScopedCitationsResolved, w as knowledgePageDigest, wn as withKnowledgeMutation, wt as resolveKnowledgeCitations, x as digest, xn as measureKnowledgeMutation, xt as formatKnowledgeCitationReference, y as createKnowledgeVisibilitySnapshot, yn as inspectPendingKnowledgeMutation, yt as auditCurrentRunCitations, z as lintKnowledgeIndex, zn as canonicalPathsEqual, zt as KnowledgeBaseCandidateSchema } from "./inspect-tl0P7I7w.js";
+import { i as textSourceId, n as slugify, r as stableId, t as sha256 } from "./ids-C-Z2Uv4c.js";
+import { a as buildKnowledgeLexicalIndex, c as tokenizeText, d as lexicalPageTerms, i as searchKnowledgePages, l as DEFAULT_FIELD_BOOSTS, n as reciprocalRankFusion, o as scoreBm25, r as searchKnowledge, s as tokenizeQuery, t as KNOWLEDGE_SEARCH_RETRIEVER_ID, u as assembleLexicalIndex } from "./search-BSGm7yxu.js";
+import { n as memoryWriteResultToSourceRecord, t as memoryHitToSourceRecord } from "./source-record-9ZPRR1P9.js";
+import { n as createNoopMemoryBenchmarkAdapter, t as createInMemoryBenchmarkAdapter } from "./benchmarks-BMDc-9V-.js";
+import { A as resetRetrievalHoldoutRegistry, C as forkAgentMemoryBranchSnapshot, D as applySessionStickyRetrievalHoldout, E as applyRetrievalHoldout, M as toOffPolicyTrajectory, O as deterministicRng, S as createAgentMemoryBranch, T as renderMemoryContext, _ as resolveMemoryCleanupTimeoutMs, a as HindsightOperationUnknownError, b as createGraphitiMemoryAdapter, c as AgentMemoryHitSchema, d as AgentMemoryWriteInputSchema, f as AgentMemoryLifecycleTimeoutError, g as memoryRecoveryDelayMs, h as createMemoryExecutionPool, i as mem0MemoryAdapterIdentity, j as retrievalHoldoutConfigHash, k as emitRetrievalHoldoutBypass, l as AgentMemoryKindSchema, m as DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, n as createNeo4jAgentMemoryAdapter, o as createHindsightMemoryAdapter, p as AgentMemoryLifecycleUnsafeError, r as createMem0MemoryAdapter, s as hindsightMemoryBankId, t as createPlayMemoryTools, u as AgentMemoryScopeSchema, v as runBoundedMemoryLifecycle, w as defaultGetMemoryContext, x as graphitiMemoryAdapterIdentity, y as sleepForMemoryRecovery } from "./memory-krApkeRS.js";
 import { agentImprovementActivationResultSchema, agentImprovementActivationSchema, canonicalCandidateDigest, omitTopLevelDigest, sha256Bytes, sha256DigestSchema } from "@tangle-network/agent-interface";
 import { acquisitionPlansForKnowledgeGaps, blockingKnowledgeEval, canonicalJson, contentHash, evaluateReleaseConfidence, objectiveEval, scoreKnowledgeReadiness, userQuestionsForKnowledgeGaps, validateRunRecord } from "@tangle-network/agent-eval";
 import { z } from "zod";
@@ -14,7 +14,7 @@ import { tmpdir } from "node:os";
 import { compareOptimizationMethods, surfaceHash } from "@tangle-network/agent-eval/campaign";
 import { isDeepStrictEqual } from "node:util";
 import { pathToFileURL } from "node:url";
-//#region src/knowledge-state-scope.ts
+// src/knowledge-state-scope.ts
 const knowledgeStateScopeSchema = z.object({
 	pagesDirectory: z.string().transform((value) => normalizePagesDirectory(value)).optional(),
 	researchState: z.boolean().optional()
@@ -31,8 +31,7 @@ const KNOWLEDGE_RESEARCH_STATE_PATHS = [
 	".agent-knowledge/events.json",
 	".agent-knowledge/event-log"
 ];
-//#endregion
-//#region src/kb-improvement/contracts.ts
+// src/kb-improvement/contracts.ts
 const digestSchema = z.string().regex(/^[a-f0-9]{64}$/);
 const immutableRefSchema = z.string().regex(/^(?:sha256:[a-f0-9]{64}|git:[a-f0-9]{40})$/);
 const runIdSchema = z.string().min(1).max(2048);
@@ -240,8 +239,7 @@ const EVALUATION_PHASES = [
 	"answer-quality",
 	"promotion"
 ];
-//#endregion
-//#region src/kb-improvement/state.ts
+// src/kb-improvement/state.ts
 function knowledgeImprovementRunId(root, goal) {
 	return stableId("kimpr", `${root}:${goal}`);
 }
@@ -383,8 +381,7 @@ function candidateEvidenceRelativePath(candidateId) {
 function assertExactCandidatePlatform() {
 	if (process.platform !== "linux") throw new Error("exact knowledge candidate workflows require Linux directory descriptors");
 }
-//#endregion
-//#region src/kb-improvement/activation.ts
+// src/kb-improvement/activation.ts
 /** Load the durable result for one exact activation without changing knowledge or run state. */
 async function loadKnowledgeImprovementActivationResult(options) {
 	assertExactCandidatePlatform();
@@ -496,15 +493,13 @@ function immutableJsonValue(value) {
 	for (const child of Object.values(value)) immutableJsonValue(child);
 	return Object.freeze(value);
 }
-//#endregion
-//#region src/immutable-ref.ts
+// src/immutable-ref.ts
 const SHA256_REF = /^sha256:[a-f0-9]{64}$/;
 const GIT_REF = /^git:[a-f0-9]{40}$/;
 function assertImmutableRef(value, label) {
 	if (typeof value !== "string" || !SHA256_REF.test(value) && !GIT_REF.test(value)) throw new Error(`${label} must be lowercase sha256:<64 hex> or git:<40 hex>`);
 }
-//#endregion
-//#region src/rag-answer-evidence.ts
+// src/rag-answer-evidence.ts
 function assertRagAnswerEvidence(result) {
 	if (!result || typeof result !== "object") throw new Error("answer-quality evidence must be an object");
 	if (typeof result.passed !== "boolean") throw new Error("answer-quality evidence requires a boolean passed verdict");
@@ -530,8 +525,7 @@ function exceedsCostCeiling$1(totalCostUsd, costCeiling) {
 	const tolerance = Number.EPSILON * Math.max(1, Math.abs(totalCostUsd), Math.abs(costCeiling)) * 8;
 	return totalCostUsd - costCeiling > tolerance;
 }
-//#endregion
-//#region src/optimization.ts
+// src/optimization.ts
 /**
 * Runs one complete agent-eval method over a serialized knowledge candidate.
 * The method receives train and selection data; agent-eval owns final scoring.
@@ -695,8 +689,7 @@ function assertPartitionContent(train, selection, final, fingerprint) {
 		});
 	}
 }
-//#endregion
-//#region src/rag-eval/knowledge-base.ts
+// src/rag-eval/knowledge-base.ts
 function scoreKnowledgeBaseIndex(index, options = {}) {
 	return scoreValidatedKnowledgeBaseIndex(index, options, validateKnowledgeIndex(index, options));
 }
@@ -792,8 +785,7 @@ function unitInterval(value, name) {
 	if (!Number.isFinite(value) || value < 0 || value > 1) throw new Error(`${name} must be a finite number in [0, 1]`);
 	return value;
 }
-//#endregion
-//#region src/claim-grounding.ts
+// src/claim-grounding.ts
 /**
 * Stopwords stripped before overlap scoring so the bar measures the claim's
 * SUBSTANTIVE words (the numbers, nouns, methods it asserts), not filler a
@@ -920,8 +912,7 @@ function groundClaimInText(claim, pageText, options = {}) {
 		missingWords
 	};
 }
-//#endregion
-//#region src/statistics.ts
+// src/statistics.ts
 /**
 * The mean of a set of measurements.
 *
@@ -942,8 +933,7 @@ function mean(values) {
 	if (finite.length === 0) return 0;
 	return finite.reduce((sum, value) => sum + value, 0) / finite.length;
 }
-//#endregion
-//#region src/rag-eval/answer.ts
+// src/rag-eval/answer.ts
 function requiredContextTargets(scenario) {
 	if (scenario.requiredContext?.length) return [...scenario.requiredContext];
 	return (scenario.expectedClaims ?? []).map((text) => ({ text }));
@@ -1137,8 +1127,7 @@ const stopwords = /* @__PURE__ */ new Set([
 	"why",
 	"how"
 ]);
-//#endregion
-//#region src/rag-eval/providers.ts
+// src/rag-eval/providers.ts
 const metricAliases = {
 	answer_correctness: "answer_correctness",
 	answer_relevance: "answer_relevance",
@@ -1215,8 +1204,7 @@ function toRagCheckerRecords(cases) {
 function normalizeMetricName(metric) {
 	return metric.trim().toLowerCase().replace(/[@/.-]+/g, "_").replace(/\s+/g, "_");
 }
-//#endregion
-//#region src/rag-eval/scoring.ts
+// src/rag-eval/scoring.ts
 const defaultThresholds = {
 	context_precision: .5,
 	context_recall: .8,
@@ -1410,8 +1398,7 @@ function weightedComposite(metrics, weights) {
 function below(metric, threshold) {
 	return threshold !== void 0 && metric < threshold;
 }
-//#endregion
-//#region src/rag-optimization.ts
+// src/rag-optimization.ts
 /** Optimizes retrieval and answer behavior together as one serialized RAG configuration. */
 async function runRagOptimization(options) {
 	const { baseline, method, trainScenarios, selectionScenarios, finalScenarios, run, judges, ...runOptions } = options;
@@ -1442,8 +1429,7 @@ async function runRagOptimization(options) {
 		finalScenarios: [...finalScenarios]
 	};
 }
-//#endregion
-//#region src/events.ts
+// src/events.ts
 function createKnowledgeEvent(input) {
 	const createdAt = (input.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
 	return {
@@ -1455,8 +1441,7 @@ function createKnowledgeEvent(input) {
 		...input.metadata === void 0 ? {} : { metadata: input.metadata }
 	};
 }
-//#endregion
-//#region src/eval-readiness.ts
+// src/eval-readiness.ts
 /**
 * Defaults applied by `defineReadinessSpec` when the caller omits the field.
 *
@@ -1620,8 +1605,7 @@ function unique(items) {
 function round(value) {
 	return Math.round(value * 1e3) / 1e3;
 }
-//#endregion
-//#region src/readiness-helpers.ts
+// src/readiness-helpers.ts
 /**
 * Build the readiness bundle for a loop run over the given index, or
 * `undefined` when no readiness specs are configured (no gate to report).
@@ -1650,8 +1634,7 @@ function assessKnowledgeIndex(options, index) {
 		kbQuality: scoreValidatedKnowledgeBaseIndex(index, qualityOptions, Boolean(qualityOptions.strict) === Boolean(options.strict) ? validation : prepared.validate(qualityOptions))
 	};
 }
-//#endregion
-//#region src/research-loop.ts
+// src/research-loop.ts
 /**
 * Adapter for running knowledge growth through `agent-eval`'s generic control
 * runtime. The caller still owns `decide`: that can be a proposer agent,
@@ -1793,8 +1776,7 @@ async function observeKnowledgeResearch(options) {
 		readiness: readinessFor(options, index)
 	};
 }
-//#endregion
-//#region src/retrieval-eval.ts
+// src/retrieval-eval.ts
 function retrievalConfigSurface(config) {
 	return canonicalJson(config);
 }
@@ -2018,8 +2000,7 @@ function seededShuffle(items, seed) {
 	}
 	return out;
 }
-//#endregion
-//#region src/retrieval-optimization.ts
+// src/retrieval-optimization.ts
 async function runRetrievalImprovementLoop(options) {
 	const dispatch = buildRetrievalEvalDispatch({
 		index: options.index,
@@ -2055,8 +2036,7 @@ function retrievalScenarioFingerprint(scenario) {
 		k: scenario.k ?? null
 	}));
 }
-//#endregion
-//#region src/rag-improvement-phases.ts
+// src/rag-improvement-phases.ts
 async function runRagKnowledgeImprovementPhases(options, previous) {
 	assertConfiguredRequiredPhases(options);
 	assertOptionalCostCeiling(options.answerQualityCostCeiling, "answerQualityCostCeiling");
@@ -2283,13 +2263,11 @@ function requiredPhaseMessage(phase) {
 function assertNotAborted(signal) {
 	if (signal?.aborted) throw new Error("RAG knowledge improvement loop aborted");
 }
-//#endregion
-//#region src/rag-improvement-loop.ts
+// src/rag-improvement-loop.ts
 async function runRagKnowledgeImprovementLoop(options) {
 	return runRagKnowledgeImprovementPhases(options);
 }
-//#endregion
-//#region src/kb-improvement/workspace.ts
+// src/kb-improvement/workspace.ts
 /** Freeze the exact knowledge bytes and measured evidence a later approval may promote. */
 function knowledgeImprovementCandidateRef(result) {
 	if (!result.candidate) throw new Error("knowledge improvement result has no candidate");
@@ -2577,8 +2555,7 @@ function knowledgeFileIdentity(path, bytes, mode) {
 		mode
 	};
 }
-//#endregion
-//#region src/kb-improvement/transition.ts
+// src/kb-improvement/transition.ts
 /** Promote one previously measured candidate without rerunning research or evaluation. */
 async function promoteKnowledgeCandidate(options) {
 	return transitionKnowledgeCandidate(options, "candidate");
@@ -2917,8 +2894,7 @@ async function hasCandidateTransitionEvent(runDir, candidateRef, target) {
 	}
 	return matched;
 }
-//#endregion
-//#region src/kb-improvement/evaluation.ts
+// src/kb-improvement/evaluation.ts
 function assertKnowledgeImprovementOptions(options) {
 	assertImmutableRef(options.implementationRef, "knowledge improvement implementationRef");
 	normalizeKnowledgeStateScope(options.stateScope);
@@ -3169,8 +3145,7 @@ function applyLifecycleFailures(metric, lifecycle, answerQualityCostCeiling) {
 function normalizeMetric(metric) {
 	return improvementMetricSchema.parse(metric);
 }
-//#endregion
-//#region src/kb-improvement/run.ts
+// src/kb-improvement/run.ts
 async function improveKnowledgeBase(options) {
 	assertExactCandidatePlatform();
 	options = {
@@ -3346,8 +3321,7 @@ async function improveKnowledgeBaseInRun(options, runId, runDir, now) {
 		await lease.release();
 	}
 }
-//#endregion
-//#region src/agent-candidate.ts
+// src/agent-candidate.ts
 /** Convert a measured knowledge candidate into the shared review and execution identity. */
 function toAgentCandidateKnowledgeRef(candidate) {
 	const parsed = KnowledgeImprovementCandidateRefSchema.parse(candidate);
@@ -3377,8 +3351,7 @@ function prefixedDigest(value) {
 function rawDigest(value) {
 	return sha256DigestSchema.parse(value).slice(7);
 }
-//#endregion
-//#region src/chunking.ts
+// src/chunking.ts
 const DEFAULT_OPTIONS = {
 	targetChars: 1e3,
 	maxChars: 1500,
@@ -3529,8 +3502,7 @@ function mergeTinyChunks(chunks, opts) {
 	}
 	return out;
 }
-//#endregion
-//#region src/discovery.ts
+// src/discovery.ts
 /**
 * Dispatch discovery tasks and recursively pursue worker-proposed follow-ups.
 *
@@ -3644,8 +3616,7 @@ function positiveInteger(value, name) {
 	if (!Number.isInteger(value) || value < 1) throw new Error(`Discovery loop ${name} must be a positive integer`);
 	return value;
 }
-//#endregion
-//#region src/filesystem-search-provider.ts
+// src/filesystem-search-provider.ts
 /**
 * File-first retrieval over an `agent-knowledge` KB.
 *
@@ -3711,8 +3682,7 @@ function hitFromSearchResult(result) {
 		snippet: result.snippet
 	};
 }
-//#endregion
-//#region src/hub-vector-search-provider.ts
+// src/hub-vector-search-provider.ts
 /** A hub exec or upstream-provider failure, carrying the hub's status/code. */
 var HubVectorSearchError = class extends Error {
 	status;
@@ -3945,8 +3915,7 @@ var HubVectorSearchProvider = class {
 function createHubVectorSearchProvider(options) {
 	return new HubVectorSearchProvider(options);
 }
-//#endregion
-//#region src/knowledge-brief.ts
+// src/knowledge-brief.ts
 /**
 * Retrieval briefing.
 *
@@ -4071,8 +4040,7 @@ function briefLine(hit) {
 	const snippet = hit.snippet.replace(/\s+/g, " ").trim();
 	return snippet === "" ? `- [${hit.citationId}] ${hit.page.title}` : `- [${hit.citationId}] ${hit.page.title} — ${snippet}`;
 }
-//#endregion
-//#region src/knowledge-use-receipts.ts
+// src/knowledge-use-receipts.ts
 /**
 * The visibility snapshot a receipt references could not be obtained, so the
 * result-to-visibility join cannot be proven. This is distinct from a snapshot
@@ -4518,8 +4486,7 @@ function isoTimestamp(value, label) {
 	if (!Number.isFinite(date.getTime())) throw new TypeError(`${label} must be a valid timestamp`);
 	return date.toISOString();
 }
-//#endregion
-//#region src/knowledge-tools.ts
+// src/knowledge-tools.ts
 /**
 * Provider-neutral knowledge tools.
 *
@@ -4759,8 +4726,7 @@ async function fileIdentity(path) {
 		throw error;
 	}
 }
-//#endregion
-//#region src/promotion.ts
+// src/promotion.ts
 /**
 * Run-scope to shared-scope promotion.
 *
@@ -4942,8 +4908,7 @@ function nonEmpty(value, label) {
 	if (typeof value !== "string" || value.trim().length === 0) throw new TypeError(`${label} must be a non-empty string`);
 	return value.trim();
 }
-//#endregion
-//#region src/propose-from-finding.ts
+// src/propose-from-finding.ts
 var KnowledgeProposalParseError = class extends Error {
 	findingId;
 	subject;
@@ -5181,8 +5146,7 @@ function renderWikiBody(finding, slug, heading) {
 function humanize(slug) {
 	return slug.split("-").filter(Boolean).map((w) => w[0]?.toUpperCase() + w.slice(1)).join(" ") || slug;
 }
-//#endregion
-//#region src/qmd-search-provider.ts
+// src/qmd-search-provider.ts
 const indexedDocument = z.object({
 	filepath: z.string(),
 	collectionName: z.string(),
@@ -5361,8 +5325,7 @@ function createQmdKnowledgeTools(options) {
 		}
 	}];
 }
-//#endregion
-//#region src/readiness-check.ts
+// src/readiness-check.ts
 async function evaluateKnowledgeBaseReadiness(options) {
 	const index = await buildKnowledgeIndex(options.root);
 	const { validation, readiness, kbQuality } = assessKnowledgeIndex(options, index);
@@ -5389,8 +5352,7 @@ async function evaluateKnowledgeBaseReadiness(options) {
 		}
 	};
 }
-//#endregion
-//#region src/release.ts
+// src/release.ts
 function knowledgeReleaseReport(input) {
 	const baselineRuns = input.baselineRuns ?? [];
 	const runRecords = [...input.candidateRuns, ...baselineRuns].map(validateRunRecord);
@@ -5425,7 +5387,6 @@ function knowledgeReleaseReport(input) {
 		baselineRuns
 	};
 }
-//#endregion
 export { AgentMemoryHitSchema, AgentMemoryKindSchema, AgentMemoryLifecycleTimeoutError, AgentMemoryLifecycleUnsafeError, AgentMemoryScopeSchema, AgentMemoryWriteInputSchema, CHECKABLE_RUNG_THRESHOLD, ClaimLedgerGoalConflictError, ClaimLedgerMigrationRequiredError, DEADLINE_EXIT_CODE, DEFAULT_KNOWLEDGE_BRIEF_LIMIT, DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, DEFAULT_PAGES_DIRECTORY, DeepQuestionSchema, FileSystemKbStore, FileSystemSearchProvider, HindsightOperationUnknownError, HubVectorSearchError, HubVectorSearchProvider, KB_CLAIM_LEDGER_DIR, KB_EVENTS_PATH, KB_INDEX_PATH, KB_STORE_DIR, KNOWLEDGE_EVENT_TYPES, KNOWLEDGE_PROMOTIONS_DIRECTORY, KNOWLEDGE_PROMOTION_DIGEST_ALGORITHM, KNOWLEDGE_PROMOTION_SCHEMA_VERSION, KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM, KNOWLEDGE_SEARCH_RETRIEVER_ID, KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION, KnowledgeBaseCandidateSchema, KnowledgeCitationAuditError, KnowledgeCitationResolutionError, KnowledgeDuplicateIntakeError, KnowledgeEventSchema, KnowledgeGraphEdgeSchema, KnowledgeGraphNodeSchema, KnowledgeImprovementCandidateRefSchema, KnowledgeImprovementEvidenceSchema, KnowledgeImprovementRunStateSchema, KnowledgeIndexSchema, KnowledgePageInvalidationSchema, KnowledgePageSchema, KnowledgePromotionError, KnowledgeProposalParseError, KnowledgeRelationSchema, KnowledgeVisibilityUnavailableError, MemoryKbStore, READINESS_SPEC_DEFAULTS, RUN_LINEAGE_BASENAME, ResearchClaimEvidenceSchema, ResearchClaimLedgerSchema, ResearchClaimRecordSchema, ResearchSourceVersionSchema, SCAFFOLD_PAGE_BASENAMES, SourceAnchorSchema, SourceRecordSchema, UncheckableClaimError, WIKILINK_REGEX, addSourcePath, addSourceText, applyKnowledgeWriteBlocks, applyKnowledgeWriteBlocksFile, applyRetrievalHoldout, applySessionStickyRetrievalHoldout, assertClaimLedgerId, assertCurrentRunCitationsResolved, assertDeepQuestionIntegrity, assertGradeableEvidence, assertKnowledgeCitationAudit, assertKnowledgeCitationsResolved, assertKnowledgeRetrievalMatchesVisibility, assertKnowledgeRetrievalMatchesVisibilityArtifact, assertKnowledgeWriteIntake, assertResearchClaimEvidenceIntegrity, assertResearchClaimLedgerIntegrity, assertRunScopedCitationsResolved, assertTrackedClaimIntegrity, auditCurrentRunCitations, auditKnowledgeCitations, buildEvalKnowledgeBundle, buildKnowledgeBrief, buildKnowledgeGraph, buildKnowledgeIndex, buildKnowledgeLexicalIndex, buildRetrievalEvalDispatch, canonicalPathsEqual, canonicalRelativeWithinRoot, chunkMarkdown, claimCheckKey, claimEvidenceId, claimId, claimSourceHost, createAgentMemoryBranch, createFileRunLineageAuthority, createFileSystemSearchProvider, createGraphitiMemoryAdapter, createHindsightMemoryAdapter, createHubVectorSearchProvider, createInMemoryBenchmarkAdapter, createKnowledgeControlLoopAdapter, createKnowledgeEvent, createKnowledgeRetrievalDisposition, createKnowledgeRetrievalReceipt, createKnowledgeTools, createKnowledgeUseReceipt, createKnowledgeVisibilitySnapshot, createLocalDiscoveryDispatcher, createMem0MemoryAdapter, createMemoryExecutionPool, createNeo4jAgentMemoryAdapter, createNoopMemoryBenchmarkAdapter, createPlayMemoryTools, createQmdKnowledgeTools, createQmdSearchProvider, createRunScopedStores, decodeKnowledgeVisibilitySnapshot, deepQuestionId, defaultGetMemoryContext, defineReadinessSpec, detectNearDuplicatePages, deterministicRng, diagnoseRagAnswerFailure, emitRetrievalHoldoutBypass, emptyClaimLedger, encodeKnowledgeVisibilitySnapshot, evaluateKnowledgeBaseReadiness, explainKnowledgeTarget, extractWikilinks, forkAgentMemoryBranchSnapshot, formatFrontmatter, formatKnowledgeCitationReference, fromAgentCandidateKnowledgeRef, gradeClaims, gradeFor, graphitiMemoryAdapterIdentity, groundClaimInText, hashKnowledgeBase, hindsightMemoryBankId, improveKnowledgeBase, initKnowledgeBase, inspectKnowledgeIndex, inspectPendingKnowledgeMutation, isKernelAnchoredPath, isKnowledgeMutationHeld, isKnowledgePagePath, isMissingFile, isSafeKnowledgePath, isScaffoldPath, jsonCandidateCodec, jsonObjectCandidateCodec, knowledgeImprovementCandidateRef, knowledgeImprovementRunDir, knowledgeImprovementRunId, knowledgePageDigest, knowledgePageFromMarkdown, knowledgePageRelations, knowledgeReleaseReport, knowledgeVisibilityArtifactRef, layoutFor, linkClaimContradictions, lintKnowledgeIndex, listRegularFilesWithinRoot, loadKnowledgeImprovementActivationResult, loadKnowledgeImprovementEvents, loadKnowledgeImprovementState, loadKnowledgePages, loadKnowledgePromotionRecord, loadSourceRegistry, materializeRegisteredClaimEvidence, mediaTypeFor, mem0MemoryAdapterIdentity, memoryHitToSourceRecord, memoryRecoveryDelayMs, memoryWriteResultToSourceRecord, mergeClaimLedgers, mergeTrackedClaims, normalizeClaimText, normalizeExternalRagScores, normalizeKnowledgeStateScope, normalizeLinkTarget, normalizePageText, normalizePagesDirectory, originatedPages, parseFrontmatter, parseKnowledgeCitationReference, parseKnowledgeWriteBlocks, partitionRetrievalScenarios, promoteKnowledgeCandidate, promoteRunScopedPages, proposeFromFinding, proposeFromFindings, ragAnswerQualityJudge, readRegularFileNoFollow, readRegularFileWithinRoot, reciprocalRankFusion, recoverPendingKnowledgeMutation, relativeWithinRoot, removeDurable, renameDurable, renderMemoryContext, researchSourceVersionKey, resetRetrievalHoldoutRegistry, resolveKnowledgeCitation, resolveKnowledgeCitations, resolveMemoryCleanupTimeoutMs, resolveRunScopedCitation, resolveRunScopedCitations, restoreKnowledgeCandidateBaseline, retrievalConfigFromSurface, retrievalConfigSurface, retrievalHoldoutConfigHash, retrievalRecallJudge, runBoundedMemoryLifecycle, runDiscoveryLoop, runInKnowledgeMutationScope, runKnowledgeResearchLoop, runRagKnowledgeImprovementLoop, runRagOptimization, runRetrievalImprovementLoop, runSerializedKnowledgeOptimization, scenarioContentFingerprint, scoreBm25, scoreKnowledgeBaseIndex, scoreRagAnswerArtifact, scoreRetrievalArtifact, searchKnowledge, searchKnowledgePages, sha256, sleepForMemoryRecovery, slugify, snapshotSourceTextInput, sourceRegistryPath, stableId, stripFrontmatter, syncDirectory, textSourceAdapter, textSourceId, toAgentCandidateKnowledgeRef, toDeepEvalTestCases, toOffPolicyTrajectory, toRagCheckerRecords, toRagasEvaluationRows, toTruLensRecords, tokenizeQuery, tokenizeText, validateKnowledgeIndex, verdictFor, verifyGradeableEvidence, verifyKnowledgeRetrievalDisposition, verifyKnowledgeRetrievalReceipt, verifyKnowledgeUseReceipt, verifyKnowledgeVisibilitySnapshot, withKnowledgeImprovementCandidate, withKnowledgeImprovementComparison, withKnowledgeMutation, withKnowledgeRead, withSafeDescendant, withSafeDirectory, writeFileDurable, writeFileDurableWithinRoot, writeJson, writeJsonDurable, writeJsonDurableWithinRoot, writeKnowledgeIndex, writeSourceRegistry };
 
 //# sourceMappingURL=index.js.map