@tangle-network/agent-knowledge 6.2.0 → 7.0.0

package/dist/{inspect-LUMkas6A.js → inspect-CJQGYuKa.js}

@@ -1,4 +1,4 @@
-import { n as slugify, r as stableId, t as sha256 } from "./ids-DRqPZ42_.js";
+import { i as textSourceId, n as slugify, r as stableId, t as sha256 } from "./ids-Bevz_pXV.js";
 import { n as searchKnowledge } from "./search-CP0QtBJZ.js";
 import { createHash, randomUUID } from "node:crypto";
 import { lstat, mkdir, mkdtemp, open, readFile, readdir, realpath, rename, rm } from "node:fs/promises";
@@ -1241,10 +1241,20 @@ function claimId(text) {
 function claimEvidenceId(claim) {
 	return `e_${sha256(JSON.stringify([
 		claim.claimId,
+		claim.sourceId,
 		claim.sourceUri,
+		claim.sourceContentHash,
 		claim.contradictsClaimId ?? null
 	])).slice(0, 16)}`;
 }
+/** Canonical key for one exact registry-id + original-URI + hash source version. */
+function researchSourceVersionKey(source) {
+	return JSON.stringify([
+		source.sourceId,
+		source.uri,
+		source.contentHash
+	]);
+}
 /** Case-, whitespace-, and stylistic-punctuation-insensitive claim identity form. */
 function normalizeClaimText(text) {
 	return text.normalize("NFKC").toLowerCase().replace(/<=|≤/gu, " symbol_less_than_or_equal ").replace(/>=|≥/gu, " symbol_greater_than_or_equal ").replace(/!=|≠/gu, " symbol_not_equal ").replace(/==|=/gu, " symbol_equal ").replace(/±/gu, " symbol_plus_or_minus ").replace(/[≈~]/gu, " symbol_approximately ").replace(/<|←|⇐/gu, " symbol_less_or_left ").replace(/>|→|⇒/gu, " symbol_greater_or_right ").replace(/[+]/gu, " symbol_plus_or_positive ").replace(/[-−]/gu, " symbol_minus_or_negative ").replace(/[^\p{L}\p{N}\s]+/gu, " ").replace(/\s+/g, " ").trim();
@@ -1279,6 +1289,7 @@ function deepQuestionId(kind, text) {
 function assertTrackedClaimIntegrity(claim) {
 	if (claim.id !== claimId(claim.text)) throw new Error(`claim '${claim.id}' does not match its text-derived identity`);
 	if (claim.text !== claim.text.trim()) throw new Error(`claim '${claim.id}' text must not have surrounding whitespace`);
+	if (claim.supportingUris.length === 0) throw new Error(`claim '${claim.id}' must have registered supporting evidence`);
 	assertSortedUnique(`claim '${claim.id}' supportingUris`, claim.supportingUris);
 	assertSortedUnique(`claim '${claim.id}' supportingHosts`, claim.supportingHosts);
 	assertSortedUnique(`claim '${claim.id}' contradicts`, claim.contradicts);
@@ -1286,6 +1297,7 @@ function assertTrackedClaimIntegrity(claim) {
 	if (!sameStrings(claim.supportingHosts, expectedHosts)) throw new Error(`claim '${claim.id}' supportingHosts must equal the hosts derived from supportingUris`);
 	if (claim.contradicts.includes(claim.id)) throw new Error(`claim '${claim.id}' cannot contradict itself`);
 	if (claim.contradicts.length > 0 && !claim.contested) throw new Error(`claim '${claim.id}' with a contradiction must be contested`);
+	if (claim.contested && claim.contradicts.length === 0) throw new Error(`claim '${claim.id}' cannot be contested without a contradiction`);
 }
 /** Refuse a deep question whose stable identity or set fields are malformed. */
 function assertDeepQuestionIntegrity(question) {
@@ -1298,25 +1310,50 @@ function assertResearchClaimEvidenceIntegrity(evidence) {
 	if (evidence.claimId !== claimId(evidence.text)) throw new Error(`claim evidence '${evidence.id}' does not match its text-derived claim identity`);
 	if (evidence.id !== claimEvidenceId(evidence)) throw new Error(`claim evidence '${evidence.id}' does not match its content-derived identity`);
 	if (evidence.text !== evidence.text.trim()) throw new Error(`claim evidence '${evidence.id}' text must not have surrounding whitespace`);
+	if (!/^[a-f0-9]{64}$/.test(evidence.sourceContentHash)) throw new Error(`claim evidence '${evidence.id}' sourceContentHash must be a SHA-256 digest`);
+	const expectedSourceId = textSourceId(evidence.sourceUri, evidence.sourceContentHash);
+	if (evidence.sourceId !== expectedSourceId) throw new Error(`claim evidence '${evidence.id}' sourceId does not match URI-and-content identity`);
 	if (evidence.contradictsClaimId === evidence.claimId) throw new Error(`claim evidence '${evidence.id}' cannot contradict its own claim`);
 }
 /** Refuse a ledger that is not one canonical, internally consistent record. */
 function assertResearchClaimLedgerIntegrity(ledger) {
+	if (ledger.schemaVersion !== 2) throw new Error(`claim ledger '${ledger.id}' must use schema version 2`);
 	if (ledger.preparedRounds !== void 0 && ledger.preparedRounds <= ledger.rounds) throw new Error(`claim ledger '${ledger.id}' preparedRounds must be greater than completed rounds`);
 	assertSortedUnique(`claim ledger '${ledger.id}' claimEvidence`, ledger.claimEvidence.map((evidence) => evidence.id));
-	assertSortedUnique(`claim ledger '${ledger.id}' registeredSourceUris`, ledger.registeredSourceUris);
+	for (const source of ledger.registeredSources) {
+		if (source.sourceId.length === 0 || source.uri.length === 0 || !/^[a-f0-9]{64}$/.test(source.contentHash)) throw new Error(`claim ledger '${ledger.id}' contains an invalid registered source version`);
+		const expectedSourceId = textSourceId(source.uri, source.contentHash);
+		if (source.sourceId !== expectedSourceId) throw new Error(`registered source '${source.sourceId}' does not match URI-and-content identity '${expectedSourceId}'`);
+	}
+	assertSortedUnique(`claim ledger '${ledger.id}' registeredSources`, ledger.registeredSources.map((source) => source.sourceId));
 	assertSortedUnique(`claim ledger '${ledger.id}' claims`, ledger.claims.map((claim) => claim.id));
 	assertSortedUnique(`claim ledger '${ledger.id}' questions`, ledger.questions.map((question) => question.id));
 	for (const evidence of ledger.claimEvidence) assertResearchClaimEvidenceIntegrity(evidence);
-	const registeredSourceUris = new Set(ledger.registeredSourceUris);
+	const registeredSources = new Set(ledger.registeredSources.map(researchSourceVersionKey));
+	const registeredEvidence = ledger.claimEvidence.filter((evidence) => registeredSources.has(researchSourceVersionKey({
+		sourceId: evidence.sourceId,
+		uri: evidence.sourceUri,
+		contentHash: evidence.sourceContentHash
+	})));
+	const materializedClaims = new Map(ledger.claims.map((claim) => [claim.id, claim]));
 	for (const claim of ledger.claims) {
 		assertTrackedClaimIntegrity(claim);
-		for (const sourceUri of claim.supportingUris) if (!registeredSourceUris.has(sourceUri)) throw new Error(`claim '${claim.id}' counts source '${sourceUri}' before its registration is confirmed`);
+		for (const sourceUri of claim.supportingUris) if (!registeredEvidence.some((evidence) => evidence.claimId === claim.id && evidence.sourceUri === sourceUri)) throw new Error(`claim '${claim.id}' counts source '${sourceUri}' without exact registered evidence`);
+		for (const contradictedClaimId of claim.contradicts) {
+			const contradictedClaim = materializedClaims.get(contradictedClaimId);
+			if (!contradictedClaim) throw new Error(`claim '${claim.id}' contradicts unmaterialized claim '${contradictedClaimId}'`);
+			if (!contradictedClaim.contradicts.includes(claim.id)) throw new Error(`claim '${claim.id}' has an asymmetric contradiction with '${contradictedClaimId}'`);
+			if (!registeredEvidence.some((evidence) => evidence.claimId === claim.id && evidence.contradictsClaimId === contradictedClaimId || evidence.claimId === contradictedClaimId && evidence.contradictsClaimId === claim.id)) throw new Error(`claim '${claim.id}' contradicts '${contradictedClaimId}' without exact registered evidence`);
+		}
 	}
-	const claimsById = new Map(ledger.claims.map((claim) => [claim.id, claim]));
+	const claimsById = materializedClaims;
 	const claimIds = new Set(claimsById.keys());
 	for (const evidence of ledger.claimEvidence) {
-		if (!registeredSourceUris.has(evidence.sourceUri)) continue;
+		if (!registeredSources.has(researchSourceVersionKey({
+			sourceId: evidence.sourceId,
+			uri: evidence.sourceUri,
+			contentHash: evidence.sourceContentHash
+		}))) continue;
 		const claim = claimsById.get(evidence.claimId);
 		if (!claim?.supportingUris.includes(evidence.sourceUri)) throw new Error(`registered claim evidence '${evidence.id}' must be materialized in its claim`);
 		if (evidence.contradictsClaimId !== void 0 && claimsById.has(evidence.contradictsClaimId) && !claim.contradicts.includes(evidence.contradictsClaimId)) throw new Error(`registered claim evidence '${evidence.id}' must materialize its contradiction`);
@@ -1329,12 +1366,13 @@ function assertResearchClaimLedgerIntegrity(ledger) {
 /** A ledger with nothing in it yet. */
 function emptyClaimLedger(id, goal) {
 	return {
+		schemaVersion: 2,
 		id,
 		...goal === void 0 ? {} : { goal },
 		updatedAt: (/* @__PURE__ */ new Date(0)).toISOString(),
 		rounds: 0,
 		claimEvidence: [],
-		registeredSourceUris: [],
+		registeredSources: [],
 		claims: [],
 		questions: []
 	};
@@ -1347,10 +1385,10 @@ function emptyClaimLedger(id, goal) {
 * writer and an evidence-producing writer can arrive in either order.
 */
 function materializeRegisteredClaimEvidence(ledger) {
-	const registered = new Set(ledger.registeredSourceUris);
+	const registered = new Set(ledger.registeredSources.map(researchSourceVersionKey));
 	const claims = new Map(ledger.claims.map((claim) => [claim.id, claim]));
 	for (const evidence of ledger.claimEvidence) {
-		if (!registered.has(evidence.sourceUri)) continue;
+		if (!registered.has(sourceVersionKeyOfEvidence(evidence))) continue;
 		const host = claimSourceHost(evidence.sourceUri);
 		const observed = {
 			id: evidence.claimId,
@@ -1366,7 +1404,7 @@ function materializeRegisteredClaimEvidence(ledger) {
 	}
 	for (const evidence of ledger.claimEvidence) {
 		const otherId = evidence.contradictsClaimId;
-		if (!registered.has(evidence.sourceUri) || !otherId || !claims.has(otherId)) continue;
+		if (!registered.has(sourceVersionKeyOfEvidence(evidence)) || !otherId || !claims.has(otherId)) continue;
 		const claim = claims.get(evidence.claimId);
 		if (!claim) continue;
 		claims.set(claim.id, {
@@ -1380,6 +1418,13 @@ function materializeRegisteredClaimEvidence(ledger) {
 		claims: [...claims.values()].sort((left, right) => left.id.localeCompare(right.id))
 	});
 }
+function sourceVersionKeyOfEvidence(evidence) {
+	return researchSourceVersionKey({
+		sourceId: evidence.sourceId,
+		uri: evidence.sourceUri,
+		contentHash: evidence.sourceContentHash
+	});
+}
 /**
 * Raised when two ledgers that accumulated evidence for DIFFERENT goals are
 * combined. Merging them would pool two questions' evidence into one
@@ -1461,13 +1506,14 @@ function mergeClaimLedgers(base, incoming) {
 	const rounds = Math.max(base.rounds, incoming.rounds);
 	const preparedRounds = Math.max(base.preparedRounds ?? base.rounds, incoming.preparedRounds ?? incoming.rounds);
 	return materializeRegisteredClaimEvidence({
+		schemaVersion: 2,
 		id: base.id,
 		...goal === void 0 ? {} : { goal },
 		updatedAt: incoming.updatedAt.localeCompare(base.updatedAt) > 0 ? incoming.updatedAt : base.updatedAt,
 		rounds,
 		...preparedRounds > rounds ? { preparedRounds } : {},
 		claimEvidence: [...claimEvidence.values()].sort((left, right) => left.id.localeCompare(right.id)),
-		registeredSourceUris: union(base.registeredSourceUris, incoming.registeredSourceUris),
+		registeredSources: mergeSourceVersions(base.registeredSources, incoming.registeredSources),
 		claims: [...claims.values()].sort((a, b) => a.id.localeCompare(b.id)),
 		questions: [...questions.values()].sort((a, b) => a.id.localeCompare(b.id))
 	});
@@ -1475,7 +1521,7 @@ function mergeClaimLedgers(base, incoming) {
 function mergeClaimEvidence(base, incoming) {
 	assertResearchClaimEvidenceIntegrity(base);
 	assertResearchClaimEvidenceIntegrity(incoming);
-	if (base.id !== incoming.id || base.claimId !== incoming.claimId || base.sourceUri !== incoming.sourceUri || base.contradictsClaimId !== incoming.contradictsClaimId) throw new Error(`claim evidence '${base.id}' has conflicting immutable content`);
+	if (base.id !== incoming.id || base.claimId !== incoming.claimId || base.sourceId !== incoming.sourceId || base.sourceUri !== incoming.sourceUri || base.sourceContentHash !== incoming.sourceContentHash || base.contradictsClaimId !== incoming.contradictsClaimId) throw new Error(`claim evidence '${base.id}' has conflicting immutable content`);
 	const text = incoming.firstSeenRound < base.firstSeenRound ? incoming.text : incoming.firstSeenRound > base.firstSeenRound ? base.text : incoming.text < base.text ? incoming.text : base.text;
 	return {
 		...base,
@@ -1483,6 +1529,15 @@ function mergeClaimEvidence(base, incoming) {
 		firstSeenRound: Math.min(base.firstSeenRound, incoming.firstSeenRound)
 	};
 }
+function mergeSourceVersions(base, incoming) {
+	const versions = /* @__PURE__ */ new Map();
+	for (const source of [...base, ...incoming]) {
+		const existing = versions.get(source.sourceId);
+		if (existing && researchSourceVersionKey(existing) !== researchSourceVersionKey(source)) throw new Error(`registered source '${source.sourceId}' has conflicting immutable content`);
+		versions.set(source.sourceId, source);
+	}
+	return [...versions.values()].sort((left, right) => left.sourceId.localeCompare(right.sourceId));
+}
 /**
 * Make every contradiction edge symmetric and mark both ends contested.
 *
@@ -1494,16 +1549,16 @@ function mergeClaimEvidence(base, incoming) {
 * the same rule stated over a whole ledger, for writers that assemble one from
 * events rather than from a live loop.
 *
-* Idempotent and monotone like every other rule here: edges only appear and
-* `contested` only latches on, so applying it twice changes nothing. An edge
-* pointing at a claim this ledger does not hold is KEPT — the other side may
-* arrive from another writer later, and discarding evidence of disagreement
-* because the counterpart has not shown up yet is the failure this prevents.
+* One-sided observations stay in `claimEvidence` until both claims are backed
+* by registered source versions. The materialized claim projection contains
+* only closed pairs, so it cannot report a lone weak claim as settled merely
+* because its evidence named a claim that never arrived.
 */
 function linkClaimContradictions(ledger) {
+	const claimIds = new Set(ledger.claims.map((claim) => claim.id));
 	const inbound = /* @__PURE__ */ new Map();
 	for (const claim of ledger.claims) for (const other of claim.contradicts) {
-		if (other === claim.id) continue;
+		if (other === claim.id || !claimIds.has(other)) continue;
 		const edges = inbound.get(other);
 		if (edges) edges.push(claim.id);
 		else inbound.set(other, [claim.id]);
@@ -1511,11 +1566,11 @@ function linkClaimContradictions(ledger) {
 	return {
 		...ledger,
 		claims: ledger.claims.map((claim) => {
-			const contradicts = union(claim.contradicts.filter((other) => other !== claim.id), inbound.get(claim.id) ?? []);
+			const contradicts = union(claim.contradicts.filter((other) => other !== claim.id && claimIds.has(other)), inbound.get(claim.id) ?? []);
 			return {
 				...claim,
 				contradicts,
-				contested: claim.contested || contradicts.length > 0
+				contested: contradicts.length > 0
 			};
 		}).sort((a, b) => a.id.localeCompare(b.id))
 	};
@@ -1655,24 +1710,32 @@ const ResearchClaimRecordSchema = z.object({
 }).strict().superRefine((claim, context) => {
 	reportIntegrityError(context, () => assertTrackedClaimIntegrity(claim));
 });
+const ResearchSourceVersionSchema = z.object({
+	sourceId: z.string().min(1),
+	uri: z.string().min(1),
+	contentHash: z.string().regex(/^[a-f0-9]{64}$/)
+}).strict();
 const ResearchClaimEvidenceSchema = z.object({
 	id: z.string().min(1),
 	claimId: z.string().min(1),
 	text: z.string().min(1),
+	sourceId: z.string().min(1),
 	sourceUri: z.string().min(1),
+	sourceContentHash: z.string().regex(/^[a-f0-9]{64}$/),
 	contradictsClaimId: z.string().min(1).optional(),
 	firstSeenRound: z.number().int().nonnegative()
 }).strict().superRefine((evidence, context) => {
 	reportIntegrityError(context, () => assertResearchClaimEvidenceIntegrity(evidence));
 });
 const ResearchClaimLedgerSchema = z.object({
+	schemaVersion: z.literal(2),
 	id: z.string().min(1),
 	goal: z.string().trim().min(1).optional(),
 	updatedAt: z.iso.datetime(),
 	rounds: z.number().int().nonnegative(),
 	preparedRounds: z.number().int().nonnegative().optional(),
 	claimEvidence: z.array(ResearchClaimEvidenceSchema),
-	registeredSourceUris: z.array(z.string().min(1)),
+	registeredSources: z.array(ResearchSourceVersionSchema),
 	claims: z.array(ResearchClaimRecordSchema),
 	questions: z.array(DeepQuestionSchema)
 }).strict().superRefine((ledger, context) => {
@@ -1756,6 +1819,17 @@ function assertClaimLedgerId(id) {
 	if (!LEDGER_ID_PATTERN.test(id) || id === "." || id === "..") throw new Error(`claim ledger id must match ${LEDGER_ID_PATTERN} and cannot be a path segment: ${id}`);
 	return id;
 }
+/** A URI-only ledger cannot be upgraded without re-verifying its source bytes. */
+var ClaimLedgerMigrationRequiredError = class extends Error {
+	ledgerId;
+	foundSchemaVersion;
+	constructor(ledgerId, foundSchemaVersion) {
+		super(`claim ledger '${ledgerId}' uses source identity schema '${foundSchemaVersion}'; archive it and re-verify its sources into a new ledger before use`);
+		this.ledgerId = ledgerId;
+		this.foundSchemaVersion = foundSchemaVersion;
+		this.name = "ClaimLedgerMigrationRequiredError";
+	}
+};
 var MemoryKbStore = class {
 	sources = /* @__PURE__ */ new Map();
 	pages = /* @__PURE__ */ new Map();
@@ -1806,7 +1880,7 @@ var MemoryKbStore = class {
 		return out.slice(-(query.limit ?? out.length)).map(clone);
 	}
 	async putClaimLedger(ledger) {
-		const parsed = ResearchClaimLedgerSchema.parse(ledger);
+		const parsed = parseResearchClaimLedger(ledger);
 		this.claimLedgers.set(assertClaimLedgerId(parsed.id), clone(parsed));
 	}
 	async getClaimLedger(id) {
@@ -1902,13 +1976,16 @@ var FileSystemKbStore = class {
 		});
 	}
 	async putClaimLedger(ledger) {
-		const parsed = ResearchClaimLedgerSchema.parse(ledger);
+		const parsed = parseResearchClaimLedger(ledger);
 		const path = this.claimLedgerPath(parsed.id);
-		await withKnowledgeMutation(this.root, () => writeJsonDurableWithinRoot(this.root, path, parsed));
+		await withKnowledgeMutation(this.root, async () => {
+			await readJsonFile(this.root, path, researchClaimLedgerParser);
+			await writeJsonDurableWithinRoot(this.root, path, parsed);
+		});
 	}
 	async getClaimLedger(id) {
 		const path = this.claimLedgerPath(id);
-		return withKnowledgeRead(this.root, () => readJsonFile(this.root, path, ResearchClaimLedgerSchema));
+		return withKnowledgeRead(this.root, () => readJsonFile(this.root, path, researchClaimLedgerParser));
 	}
 	async listClaimLedgers() {
 		return withKnowledgeRead(this.root, async () => {
@@ -1922,7 +1999,7 @@ var FileSystemKbStore = class {
 			const ledgers = [];
 			for (const file of files) {
 				if (!file.path.endsWith(".json")) continue;
-				ledgers.push(ResearchClaimLedgerSchema.parse(JSON.parse(file.bytes.toString("utf8"))));
+				ledgers.push(parseResearchClaimLedger(JSON.parse(file.bytes.toString("utf8"))));
 			}
 			return ledgers.sort((a, b) => a.id.localeCompare(b.id));
 		});
@@ -1930,7 +2007,7 @@ var FileSystemKbStore = class {
 	async mergeClaimLedger(id, merge) {
 		const key = assertClaimLedgerId(id);
 		return withKnowledgeMutation(this.root, async () => {
-			const current = await readJsonFile(this.root, this.claimLedgerPath(key), ResearchClaimLedgerSchema);
+			const current = await readJsonFile(this.root, this.claimLedgerPath(key), researchClaimLedgerParser);
 			const next = assertMergedLedgerId(key, merge(current));
 			await this.putClaimLedger(next);
 			return next;
@@ -1983,6 +2060,42 @@ async function readJsonFile(root, relativePath, schema) {
 		throw error;
 	}
 }
+const researchClaimLedgerParser = { parse: parseResearchClaimLedger };
+const legacyResearchClaimLedgerSchema = z.object({
+	id: z.string().min(1),
+	goal: z.string().trim().min(1).optional(),
+	updatedAt: z.iso.datetime(),
+	rounds: z.number().int().nonnegative(),
+	preparedRounds: z.number().int().nonnegative().optional(),
+	claimEvidence: z.array(z.object({
+		id: z.string().min(1),
+		claimId: z.string().min(1),
+		text: z.string().min(1),
+		sourceUri: z.string().min(1),
+		contradictsClaimId: z.string().min(1).optional(),
+		firstSeenRound: z.number().int().nonnegative()
+	}).strict()),
+	registeredSourceUris: z.array(z.string().min(1)),
+	claims: z.array(z.object({
+		id: z.string().min(1),
+		text: z.string().min(1),
+		supportingHosts: z.array(z.string().min(1)),
+		supportingUris: z.array(z.string().min(1)),
+		contradicts: z.array(z.string().min(1)),
+		contested: z.boolean(),
+		firstSeenRound: z.number().int().nonnegative()
+	}).strict()),
+	questions: z.array(DeepQuestionSchema)
+}).strict();
+function parseResearchClaimLedger(value) {
+	const legacy = legacyResearchClaimLedgerSchema.safeParse(value);
+	if (legacy.success) throw new ClaimLedgerMigrationRequiredError(legacy.data.id, "unversioned");
+	if (isRecord(value) && value.schemaVersion !== 2 && "registeredSourceUris" in value) throw new ClaimLedgerMigrationRequiredError(typeof value.id === "string" ? value.id : "unknown", typeof value.schemaVersion === "number" ? value.schemaVersion : "unversioned");
+	return ResearchClaimLedgerSchema.parse(value);
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function clone(value) {
 	return value == null ? value : JSON.parse(JSON.stringify(value));
 }
@@ -1992,6 +2105,10 @@ const sourceRegistrySchema = z.object({
 	generatedAt: z.string().min(1),
 	sources: z.array(SourceRecordSchema.passthrough())
 }).strict();
+/** Copy and freeze an untrusted source proposal before any asynchronous work. */
+function snapshotSourceTextInput(input) {
+	return deepFreeze(structuredClone(input));
+}
 async function loadSourceRegistry(root) {
 	return withKnowledgeRead(root, () => loadSourceRegistryUnlocked(root));
 }
@@ -2070,7 +2187,7 @@ async function preparePathSource(root, sourcePath, mode, options) {
 	};
 }
 async function addSourceText(root, input, options = {}) {
-	const [record] = await commitSourceBatch(root, [await prepareTextSource(input, options)], options);
+	const [record] = await commitSourceBatch(root, [await prepareTextSource(snapshotSourceTextInput(input), options)], options);
 	return record;
 }
 async function prepareTextSource(input, options) {
@@ -2084,9 +2201,9 @@ async function prepareTextSource(input, options) {
 	};
 	const adapter = (options.adapters ?? [textSourceAdapter]).find((candidate) => candidate.canLoad(adapterInput));
 	const loaded = adapter ? await adapter.load(adapterInput) : {};
-	const id = stableId("src", `${contentHash}:${input.uri}`);
+	const id = textSourceId(input.uri, contentHash);
 	const targetRel = rawSourcePath(fileName, contentHash, ".txt");
-	const rawContent = text.endsWith("\n") ? text : `${text}\n`;
+	const rawContent = text;
 	return {
 		record: {
 			id,
@@ -2161,6 +2278,12 @@ function sameMutation(left, right) {
 	if (Buffer.isBuffer(left.content) && Buffer.isBuffer(right.content)) return left.content.equals(right.content);
 	return left.content === right.content;
 }
+function deepFreeze(value, seen = /* @__PURE__ */ new WeakSet()) {
+	if (typeof value !== "object" || value === null || seen.has(value)) return value;
+	seen.add(value);
+	for (const nested of Object.values(value)) deepFreeze(nested, seen);
+	return Object.freeze(value);
+}
 async function listSourceFiles(root) {
 	const entries = await readdir(root, { withFileTypes: true });
 	const out = [];
@@ -2177,7 +2300,7 @@ async function listSourceFiles(root) {
 	return out;
 }
 function rawSourcePath(fileName, contentHash, extension) {
-	return join("raw", "sources", `${slugify(fileName.replace(/\.[^.]+$/, ""))}-${contentHash.slice(0, 8)}${extension}`).replace(/\\/g, "/");
+	return join("raw", "sources", `${slugify(fileName.replace(/\.[^.]+$/, ""))}-${contentHash}${extension}`).replace(/\\/g, "/");
 }
 function ext(fileName) {
 	const idx = fileName.lastIndexOf(".");
@@ -2534,6 +2657,6 @@ function explainKnowledgeTarget(index, target) {
 	};
 }
 //#endregion
-export { SCAFFOLD_PAGE_BASENAMES as $, KnowledgePageSchema as A, withSafeDirectory as At, assertResearchClaimLedgerIntegrity as B, assertClaimLedgerId as C, listRegularFilesWithinRoot as Ct, KnowledgeGraphEdgeSchema as D, renameDurable as Dt, KnowledgeEventSchema as E, removeDurable as Et, SourceRecordSchema as F, mediaTypeFor$1 as Ft, deepQuestionId as G, claimEvidenceId as H, KNOWLEDGE_EVENT_TYPES as I, textSourceAdapter as It, materializeRegisteredClaimEvidence as J, emptyClaimLedger as K, ClaimLedgerGoalConflictError as L, ResearchClaimLedgerSchema as M, writeFileDurableWithinRoot as Mt, ResearchClaimRecordSchema as N, writeJsonDurable as Nt, KnowledgeGraphNodeSchema as O, syncDirectory as Ot, SourceAnchorSchema as P, writeJsonDurableWithinRoot as Pt, buildKnowledgeGraph as Q, assertDeepQuestionIntegrity as R, MemoryKbStore as S, isMissingFile as St, KnowledgeBaseCandidateSchema as T, readRegularFileWithinRoot as Tt, claimId as U, assertTrackedClaimIntegrity as V, claimSourceHost as W, mergeTrackedClaims as X, mergeClaimLedgers as Y, normalizeClaimText as Z, FileSystemKbStore as _, finishKnowledgeFileTransaction as _t, applyKnowledgeWriteBlocksFile as a, WIKILINK_REGEX as at, KB_INDEX_PATH as b, rollbackKnowledgeFileTransaction as bt, validateKnowledgeIndex as c, formatFrontmatter as ct, writeKnowledgeIndex as d, inspectPendingKnowledgeMutation as dt, initKnowledgeBase as et, addSourcePath as f, recoverPendingKnowledgeMutation as ft, writeSourceRegistry as g, assertKnowledgeMutationPath as gt, sourceRegistryPath as h, applyKnowledgeFileTransaction as ht, applyKnowledgeWriteBlocks as i, writeJson as it, ResearchClaimEvidenceSchema as j, writeFileDurable as jt, KnowledgeIndexSchema as k, withSafeDescendant as kt, lintKnowledgeIndex as l, parseFrontmatter as lt, loadSourceRegistry as m, withKnowledgeRead as mt, inspectKnowledgeIndex as n, layoutFor as nt, isSafeKnowledgePath as o, extractWikilinks as ot, addSourceText as p, withKnowledgeMutation as pt, linkClaimContradictions as q, stringMetadata as r, loadKnowledgePages as rt, parseKnowledgeWriteBlocks as s, normalizeLinkTarget as st, explainKnowledgeTarget as t, isScaffoldPath as tt, buildKnowledgeIndex as u, acquireDurableFileLock as ut, KB_CLAIM_LEDGER_DIR as v, knowledgeFileTransactionPlanHash as vt, DeepQuestionSchema as w, readRegularFileNoFollow as wt, KB_STORE_DIR as x, isKernelAnchoredPath as xt, KB_EVENTS_PATH as y, prepareKnowledgeFileTransaction as yt, assertResearchClaimEvidenceIntegrity as z };
+export { mergeTrackedClaims as $, KnowledgeGraphNodeSchema as A, removeDurable as At, ClaimLedgerGoalConflictError as B, textSourceAdapter as Bt, KB_STORE_DIR as C, prepareKnowledgeFileTransaction as Ct, KnowledgeBaseCandidateSchema as D, listRegularFilesWithinRoot as Dt, DeepQuestionSchema as E, isMissingFile as Et, ResearchClaimRecordSchema as F, writeFileDurable as Ft, claimEvidenceId as G, assertResearchClaimEvidenceIntegrity as H, ResearchSourceVersionSchema as I, writeFileDurableWithinRoot as It, deepQuestionId as J, claimId as K, SourceAnchorSchema as L, writeJsonDurable as Lt, KnowledgePageSchema as M, syncDirectory as Mt, ResearchClaimEvidenceSchema as N, withSafeDescendant as Nt, KnowledgeEventSchema as O, readRegularFileNoFollow as Ot, ResearchClaimLedgerSchema as P, withSafeDirectory as Pt, mergeClaimLedgers as Q, SourceRecordSchema as R, writeJsonDurableWithinRoot as Rt, KB_INDEX_PATH as S, knowledgeFileTransactionPlanHash as St, assertClaimLedgerId as T, isKernelAnchoredPath as Tt, assertResearchClaimLedgerIntegrity as U, assertDeepQuestionIntegrity as V, assertTrackedClaimIntegrity as W, linkClaimContradictions as X, emptyClaimLedger as Y, materializeRegisteredClaimEvidence as Z, writeSourceRegistry as _, withKnowledgeMutation as _t, applyKnowledgeWriteBlocksFile as a, isScaffoldPath as at, KB_CLAIM_LEDGER_DIR as b, assertKnowledgeMutationPath as bt, validateKnowledgeIndex as c, writeJson as ct, writeKnowledgeIndex as d, normalizeLinkTarget as dt, normalizeClaimText as et, addSourcePath as f, formatFrontmatter as ft, sourceRegistryPath as g, recoverPendingKnowledgeMutation as gt, snapshotSourceTextInput as h, inspectPendingKnowledgeMutation as ht, applyKnowledgeWriteBlocks as i, initKnowledgeBase as it, KnowledgeIndexSchema as j, renameDurable as jt, KnowledgeGraphEdgeSchema as k, readRegularFileWithinRoot as kt, lintKnowledgeIndex as l, WIKILINK_REGEX as lt, loadSourceRegistry as m, acquireDurableFileLock as mt, inspectKnowledgeIndex as n, buildKnowledgeGraph as nt, isSafeKnowledgePath as o, layoutFor as ot, addSourceText as p, parseFrontmatter as pt, claimSourceHost as q, stringMetadata as r, SCAFFOLD_PAGE_BASENAMES as rt, parseKnowledgeWriteBlocks as s, loadKnowledgePages as st, explainKnowledgeTarget as t, researchSourceVersionKey as tt, buildKnowledgeIndex as u, extractWikilinks as ut, ClaimLedgerMigrationRequiredError as v, withKnowledgeRead as vt, MemoryKbStore as w, rollbackKnowledgeFileTransaction as wt, KB_EVENTS_PATH as x, finishKnowledgeFileTransaction as xt, FileSystemKbStore as y, applyKnowledgeFileTransaction as yt, KNOWLEDGE_EVENT_TYPES as z, mediaTypeFor$1 as zt };
 
-//# sourceMappingURL=inspect-LUMkas6A.js.map
+//# sourceMappingURL=inspect-CJQGYuKa.js.map