@cleocode/core 2026.10.27 → 2026.11.1-canary.10

package/dist/docs/section-write-path.d.ts

@@ -176,6 +176,41 @@ export interface SectionLeaseNotice {
  * @returns The merge outcome.
  */
 export declare function projectDocUpdateThroughSections(projectRoot: string, input: ProjectDocUpdateInput): Promise<ProjectDocUpdateResult>;
+/** Input for {@link projectDocCreate}. */
+export interface ProjectDocCreateInput {
+    /** The new doc's slug (its `docs_attachments` row is already written). */
+    readonly slug: string;
+    /** Author of the first version. */
+    readonly authorAgentId: string;
+    /** The stored bytes. */
+    readonly bytes: Buffer;
+    /** The bytes as text, or `null` for a binary body. */
+    readonly text: string | null;
+    /** Optional change summary for the first version. */
+    readonly changeSummary?: string;
+}
+/**
+ * Record a new doc's identity, first version and head (T14329), so a doc is
+ * addressable by its immutable uid and its fetch carries `headVersionUid` from
+ * the moment it is added, not only after a first update.
+ *
+ * A text body goes through {@link projectDocUpdateThroughSections} as a root
+ * version (the same projection every update uses, so section state exists for
+ * the next edit). A binary body has no sections: the identity, a root version
+ * addressing its bytes, and the head are written directly, in one
+ * transaction. The identity is adopted from the doc's registry row
+ * (`ensureConduitDoc`), so two devices converge on one uid (T13586).
+ * Idempotent: a doc that already has a head is returned as it is.
+ *
+ * @param projectRoot - Absolute path to the CLEO project root.
+ * @param input - The doc's slug, author, bytes and text.
+ * @returns The doc uid and its head version uid.
+ * @task T14329
+ */
+export declare function projectDocCreate(projectRoot: string, input: ProjectDocCreateInput): Promise<{
+    docUid: string;
+    headVersionUid: string;
+}>;
 /** Outcome of {@link previewDocUpdateThroughSections}. */
 export interface DocUpdatePreview {
     /** The merged text the projection would land. */
@@ -214,4 +249,3 @@ export declare function previewDocUpdateThroughSections(projectRoot: string, inp
  * @returns The section ids released.
  */
 export declare function releaseSectionLeases(projectRoot: string, slug: string, sessionId: string): Promise<string[]>;
-//# sourceMappingURL=section-write-path.d.ts.map

package/dist/docs/section-write-path.js

@@ -47,9 +47,10 @@
  * @saga T13339
  */
 import { createHash, randomUUID } from 'node:crypto';
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
-import { getCleoDirAbsolute } from '../paths.js';
+import { getCleoDirAbsolute, resolveCleoDir } from '../paths.js';
+import { readVerifiedBlobBytes, writeBlobStoreBytesSync } from '../store/blob-keep.js';
 import { appendConduitAttachmentVersion, ensureConduitDoc, getConduitAttachmentVersion, getConduitDocHead, readSectionCrdtState, rebaseSectionCrdtStates, rebuildConduitAttachmentContributors, resolveConduitDocUid, upsertConduitDocHead, withConduitDocWriteTransaction, writeSectionCrdtState, } from '../store/conduit-doc-history.js';
 import { resolveBoundSession } from '../store/session-store.js';
 import { compareHlc, encodeHlc, genesisHlc, parseHlc, tick } from '../store/sync/hlc.js';
@@ -135,15 +136,11 @@ function versionBlobPath(projectRoot, storageKey) {
  */
 async function readHeadSectionTexts(projectRoot, head) {
     const version = await getConduitAttachmentVersion(projectRoot, head.headVersionUid);
-    if (!version?.storageKey)
+    if (!version)
         return null;
-    try {
-        const text = readFileSync(versionBlobPath(projectRoot, version.storageKey), 'utf-8');
-        return splitDocIntoSections(text);
-    }
-    catch {
-        return null;
-    }
+    // T14329: by content hash (blob store, then the legacy tree), whatever the key layout.
+    const bytes = readVerifiedBlobBytes(resolveCleoDir(projectRoot), version.contentHash);
+    return bytes === null ? null : splitDocIntoSections(bytes.toString('utf-8'));
 }
 /**
  * Write the merged text's content-addressed blob so the version row's
@@ -153,9 +150,12 @@ async function readHeadSectionTexts(projectRoot, head) {
  *
  * @param projectRoot - Absolute path to the CLEO project root.
  * @param storageKey - The version's `storage_key`.
+ * @param contentHash - SHA-256 of `text` (its blob-store address).
  * @param text - The merged text the key addresses.
  */
-function writeMergedBlob(projectRoot, storageKey, text) {
+function writeMergedBlob(projectRoot, storageKey, contentHash, text) {
+    // T14329: the blob store is where readers resolve a version (by its hash).
+    writeBlobStoreBytesSync(resolveCleoDir(projectRoot), contentHash, Buffer.from(text, 'utf-8'));
     const path = versionBlobPath(projectRoot, storageKey);
     if (existsSync(path))
         return;
@@ -187,6 +187,69 @@ function writeMergedBlob(projectRoot, storageKey, text) {
 export async function projectDocUpdateThroughSections(projectRoot, input) {
     return projectDocUpdate(projectRoot, input, false);
 }
+/**
+ * Record a new doc's identity, first version and head (T14329), so a doc is
+ * addressable by its immutable uid and its fetch carries `headVersionUid` from
+ * the moment it is added, not only after a first update.
+ *
+ * A text body goes through {@link projectDocUpdateThroughSections} as a root
+ * version (the same projection every update uses, so section state exists for
+ * the next edit). A binary body has no sections: the identity, a root version
+ * addressing its bytes, and the head are written directly, in one
+ * transaction. The identity is adopted from the doc's registry row
+ * (`ensureConduitDoc`), so two devices converge on one uid (T13586).
+ * Idempotent: a doc that already has a head is returned as it is.
+ *
+ * @param projectRoot - Absolute path to the CLEO project root.
+ * @param input - The doc's slug, author, bytes and text.
+ * @returns The doc uid and its head version uid.
+ * @task T14329
+ */
+export async function projectDocCreate(projectRoot, input) {
+    const known = await resolveConduitDocUid(projectRoot, input.slug);
+    const knownHead = known !== null ? await getConduitDocHead(projectRoot, known) : null;
+    if (known !== null && knownHead !== null) {
+        return { docUid: known, headVersionUid: knownHead.headVersionUid };
+    }
+    const changeSummary = input.changeSummary ?? `created '${input.slug}' (docs add)`;
+    if (input.text !== null) {
+        const projected = await projectDocUpdateThroughSections(projectRoot, {
+            slug: input.slug,
+            authorAgentId: input.authorAgentId,
+            content: input.text,
+            parentVersionUid: null,
+            changeSummary,
+        });
+        return { docUid: projected.docUid, headVersionUid: projected.head.head.headVersionUid };
+    }
+    return withConduitDocWriteTransaction(projectRoot, async () => {
+        const { uid } = await ensureConduitDoc(projectRoot, {
+            slug: input.slug,
+            authorAgentId: input.authorAgentId,
+            content: input.bytes,
+        });
+        const contentHash = createHash('sha256').update(input.bytes).digest('hex');
+        writeBlobStoreBytesSync(resolveCleoDir(projectRoot), contentHash, input.bytes);
+        const version = await appendConduitAttachmentVersion(projectRoot, {
+            attachmentUid: uid,
+            parentVersionUid: null,
+            authorAgentId: input.authorAgentId,
+            storageKey: `sha256:${contentHash}`,
+            contentHash,
+            originalSize: input.bytes.length,
+            compressedSize: input.bytes.length,
+            tokens: 0,
+            changeType: 'create',
+            changeSummary,
+        });
+        const head = await upsertConduitDocHead(projectRoot, {
+            attachmentUid: uid,
+            headVersionUid: version.uid ?? '',
+            headHlc: mintHeadHlc(null),
+        });
+        return { docUid: uid, headVersionUid: head.head.headVersionUid };
+    });
+}
 /** Carries a preview's result out of its transaction, forcing the rollback. */
 class PreviewRollback extends Error {
     result;
@@ -338,7 +401,7 @@ async function projectDocUpdate(projectRoot, input, preview) {
             // Write the blob BEFORE the insert so a committed row never references
             // missing bytes; a rollback only leaves a harmless content-addressed
             // orphan (reused by a later identical projection).
-            writeMergedBlob(projectRoot, storageKey, mergedText);
+            writeMergedBlob(projectRoot, storageKey, contentHash, mergedText);
             const parentVersionUid = input.parentVersionUid !== undefined
                 ? input.parentVersionUid
                 : (previousHead?.headVersionUid ?? null);
@@ -379,7 +442,7 @@ async function projectDocUpdate(projectRoot, input, preview) {
             if (conflictedSections.length > 0) {
                 const incomingHash = createHash('sha256').update(input.content, 'utf-8').digest('hex');
                 const incomingKey = `${incomingHash.slice(0, 2)}/${incomingHash.slice(2)}.md`;
-                writeMergedBlob(projectRoot, incomingKey, input.content);
+                writeMergedBlob(projectRoot, incomingKey, incomingHash, input.content);
                 const incoming = await appendConduitAttachmentVersion(projectRoot, {
                     attachmentUid: docUid,
                     parentVersionUid,

package/dist/docs/section-write-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"section-write-path.js","sourceRoot":"","sources":["../../src/docs/section-write-path.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"section-write-path.js","sourceRoot":"","sources":["../../src/docs/section-write-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EACL,8BAA8B,EAG9B,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,oCAAoC,EACpC,oBAAoB,EAEpB,oBAAoB,EACpB,8BAA8B,EAC9B,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAY,QAAQ,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACnG,OAAO,EACL,iBAAiB,EAEjB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAyG5C;;;;;;GAMG;AACH,IAAI,aAAa,GAAkB,IAAI,CAAC;AACxC,IAAI,UAAU,GAAe,IAAI,CAAC;AAElC,mEAAmE;AACnE,SAAS,kBAAkB;IACzB,aAAa,KAAK,UAAU,EAAE,CAAC;IAC/B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,WAAW,CAAC,OAAsB,EAAE,SAAiB,IAAI,CAAC,GAAG,EAAE;IACtE,IAAI,IAAI,GAAG,UAAU,IAAI,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC1D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC/B,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;gBAAE,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,CAAC;QACpF,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;YACrE,qEAAqE;QACvE,CAAC;IACH,CAAC;IACD,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,SAAS,CAAC,UAAU,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;AAC9D,CAAC;AAED;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,WAAmB,EAAE,UAAkB;IAC9D,OAAO,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,KAAK,UAAU,oBAAoB,CACjC,WAAmB,EACnB,IAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IACpF,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,uFAAuF;IACvF,MAAM,KAAK,GAAG,qBAAqB,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACtF,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,eAAe,CACtB,WAAmB,EACnB,UAAkB,EAClB,WAAmB,EACnB,IAAY;IAEZ,2EAA2E;IAC3E,uBAAuB,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9F,MAAM,IAAI,GAAG,eAAe,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACtD,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO;IAC7B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,WAAmB,EACnB,KAA4B;IAE5B,OAAO,gBAAgB,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AACrD,CAAC;AAgBD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,KAA4B;IAE5B,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtF,IAAI,KAAK,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACzC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,CAAC,cAAc,EAAE,CAAC;IACrE,CAAC;IACD,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,IAAI,YAAY,KAAK,CAAC,IAAI,cAAc,CAAC;IAClF,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,MAAM,+BAA+B,CAAC,WAAW,EAAE;YACnE,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,OAAO,EAAE,KAAK,CAAC,IAAI;YACnB,gBAAgB,EAAE,IAAI;YACtB,aAAa;SACd,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;IAC1F,CAAC;IACD,OAAO,8BAA8B,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE;YAClD,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,OAAO,EAAE,KAAK,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3E,uBAAuB,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/E,MAAM,OAAO,GAAG,MAAM,8BAA8B,CAAC,WAAW,EAAE;YAChE,aAAa,EAAE,GAAG;YAClB,gBAAgB,EAAE,IAAI;YACtB,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,UAAU,EAAE,UAAU,WAAW,EAAE;YACnC,WAAW;YACX,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;YAChC,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;YAClC,MAAM,EAAE,CAAC;YACT,UAAU,EAAE,QAAQ;YACpB,aAAa;SACd,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE;YACnD,aAAa,EAAE,GAAG;YAClB,cAAc,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE;YACjC,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC;AAeD,+EAA+E;AAC/E,MAAM,eAAgB,SAAQ,KAAK;IACZ;IAArB,YAAqB,MAA8B;QACjD,KAAK,CAAC,+CAA+C,CAAC,CAAC;QADpC,WAAM,GAAN,MAAM,CAAwB;IAEnD,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,WAAmB,EACnB,KAA4B;IAE5B,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAChE,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ;QAClC,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,gBAAgB,CAC7B,WAAmB,EACnB,KAA4B,EAC5B,OAAgB;IAEhB,MAAM,WAAW,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACxE,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE1D,wEAAwE;IACxE,0EAA0E;IAC1E,+DAA+D;IAC/D,MAAM,cAAc,GAClB,KAAK,CAAC,SAAS,IAAI,CAAC,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC;IAClF,MAAM,YAAY,GAAyB,EAAE,CAAC;IAC9C,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,IAAI,cAAc,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,IAAI,mBAAmB,CAAC,WAAW,EAAE;YACxD,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,KAAK,CAAC,aAAa;SAC5B,CAAC,CAAC;QACH,MAAM,eAAe,GAAG,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC;QAClD,MAAM,aAAa,GAAG,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;YACpD,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,MAAM,GACV,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,oBAAoB,CAAC,WAAW,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7F,qEAAqE;YACrE,oEAAoE;YACpE,MAAM,OAAO,GAAG,MAAM,KAAK,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;YAC9E,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CACzC,KAAK,CAAC,IAAI,EACV,EAAE,EACF,yBAAyB,EACzB,KAAK,CAAC,aAAa,IAAI,cAAc,CACtC,CAAC;YACF,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACzB,SAAS;YACX,CAAC;YACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,KAAK,cAAc,EAAE,CAAC;gBACnD,wDAAwD;gBACxD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,yBAAyB,CAAC,CAAC;gBACpF,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;oBAChB,8DAA8D;oBAC9D,6DAA6D;oBAC7D,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CACtC,KAAK,CAAC,IAAI,EACV,EAAE,EACF,yBAAyB,EACzB,KAAK,CAAC,aAAa,IAAI,cAAc,CACtC,CAAC;oBACF,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;wBACb,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBACzB,SAAS;oBACX,CAAC;oBACD,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAClD,CAAC;gBACD,SAAS;YACX,CAAC;YACD,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,8BAA8B,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YAClE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,GAC5B,WAAW,KAAK,IAAI;gBAClB,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE;gBACtC,CAAC,CAAC,MAAM,gBAAgB,CAAC,WAAW,EAAE;oBAClC,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,aAAa,EAAE,KAAK,CAAC,aAAa;oBAClC,OAAO,EAAE,aAAa;iBACvB,CAAC,CAAC;YAET,gEAAgE;YAChE,qEAAqE;YACrE,sEAAsE;YACtE,kEAAkE;YAClE,oEAAoE;YACpE,qDAAqD;YACrD,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAClE,MAAM,YAAY,GAChB,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,oBAAoB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACvF,MAAM,iBAAiB,GACrB,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI;gBAC7D,CAAC,CAAC,KAAK,CAAC,YAAY;gBACpB,CAAC,CAAC,YAAY,CAAC;YACnB,mEAAmE;YACnE,mEAAmE;YACnE,sEAAsE;YACtE,8CAA8C;YAC9C,MAAM,IAAI,GAAG,gBAAgB,CAC3B,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CACpC,CAAC;YAEF,oEAAoE;YACpE,uEAAuE;YACvE,MAAM,cAAc,GAAa,EAAE,CAAC;YACpC,MAAM,gBAAgB,GAAa,EAAE,CAAC;YACtC,MAAM,kBAAkB,GAAa,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;YACzD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBACzB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC/B,SAAS;gBACX,CAAC;gBACD,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;gBACpB,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBACnE,sEAAsE;gBACtE,kEAAkE;gBAClE,kEAAkE;gBAClE,sEAAsE;gBACtE,8BAA8B;gBAC9B,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,oBAAoB,CAC5D,MAAM,EAAE,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EACrF,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,aAAa,CACnB,CAAC;gBACF,IAAI,OAAO,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBAC/B,MAAM,qBAAqB,CAAC,WAAW,EAAE;wBACvC,aAAa,EAAE,MAAM;wBACrB,SAAS,EAAE,EAAE;wBACb,QAAQ;wBACR,cAAc,EAAE,MAAM,EAAE,cAAc,IAAI,IAAI;qBAC/C,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,OAAO;oBAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACvC,IAAI,UAAU;oBAAE,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC5C,cAAc,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;YAClD,CAAC;YACD,MAAM,UAAU,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;YAEhD,qEAAqE;YACrE,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnF,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACpD,MAAM,UAAU,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;YAC3E,uEAAuE;YACvE,qEAAqE;YACrE,mDAAmD;YACnD,eAAe,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;YAClE,MAAM,gBAAgB,GACpB,KAAK,CAAC,gBAAgB,KAAK,SAAS;gBAClC,CAAC,CAAC,KAAK,CAAC,gBAAgB;gBACxB,CAAC,CAAC,CAAC,YAAY,EAAE,cAAc,IAAI,IAAI,CAAC,CAAC;YAC7C,MAAM,OAAO,GAAG,MAAM,8BAA8B,CAAC,WAAW,EAAE;gBAChE,aAAa,EAAE,MAAM;gBACrB,gBAAgB;gBAChB,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,UAAU;gBACV,WAAW;gBACX,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,IAAI;gBACpB,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC;gBAC/B,UAAU,EAAE,OAAO;gBACnB,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpF,gBAAgB;gBAChB,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC;aACxC,CAAC,CAAC;YAEH,mEAAmE;YACnE,oEAAoE;YACpE,yBAAyB;YACzB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,IAAI,WAAW,CAAC,YAAY,EAAE,OAAO,IAAI,IAAI,CAAC,CAAC;YACxE,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE;gBACnD,aAAa,EAAE,MAAM;gBACrB,cAAc,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE;gBACjC,OAAO;aACR,CAAC,CAAC;YAEH,wEAAwE;YACxE,0EAA0E;YAC1E,sEAAsE;YACtE,yEAAyE;YACzE,uEAAuE;YACvE,mEAAmE;YACnE,wEAAwE;YACxE,mEAAmE;YACnE,qEAAqE;YACrE,uEAAuE;YACvE,MAAM,SAAS,GAAsB,EAAE,CAAC;YACxC,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvF,MAAM,WAAW,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;gBAC9E,eAAe,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBACvE,MAAM,QAAQ,GAAG,MAAM,8BAA8B,CAAC,WAAW,EAAE;oBACjE,aAAa,EAAE,MAAM;oBACrB,gBAAgB;oBAChB,aAAa,EAAE,KAAK,CAAC,aAAa;oBAClC,UAAU,EAAE,WAAW;oBACvB,WAAW,EAAE,YAAY;oBACzB,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;oBACvD,cAAc,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;oBACzD,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC;oBAClC,UAAU,EAAE,OAAO;oBACnB,aAAa,EAAE,iCAAiC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,kCAAkC;oBAC/G,gBAAgB,EAAE,kBAAkB;oBACpC,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC;iBACxC,CAAC,CAAC;gBACH,IAAI,YAAY,KAAK,IAAI,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;oBAC1C,MAAM,oBAAoB,CAAC,WAAW,EAAE;wBACtC,aAAa,EAAE,MAAM;wBACrB,cAAc,EAAE,QAAQ,CAAC,GAAG;wBAC5B,OAAO,EAAE,YAAY,CAAC,OAAO;qBAC9B,CAAC,CAAC;oBACH,KAAK,MAAM,SAAS,IAAI,kBAAkB,EAAE,CAAC;wBAC3C,SAAS,CAAC,IAAI,CAAC;4BACb,SAAS;4BACT,kBAAkB,EAAE,QAAQ,CAAC,GAAG;4BAChC,oBAAoB,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE;yBACxC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAED,iEAAiE;YACjE,0DAA0D;YAC1D,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBAChB,MAAM,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YAClE,CAAC;YACD,MAAM,oCAAoC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAEhE,MAAM,MAAM,GAA2B;gBACrC,MAAM;gBACN,OAAO;gBACP,UAAU;gBACV,gBAAgB;gBAChB,OAAO;gBACP,IAAI;gBACJ,sBAAsB,EAAE,YAAY,EAAE,cAAc,IAAI,IAAI;gBAC5D,SAAS;gBACT,YAAY;aACb,CAAC;YACF,0GAA0G;YAC1G,IAAI,OAAO;gBAAE,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;YAC/C,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,eAAe;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC;QACtD,uEAAuE;QACvE,yEAAyE;QACzE,iCAAiC;QACjC,IAAI,cAAc,KAAK,IAAI,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1D,MAAM,YAAY,GAAG,IAAI,mBAAmB,CAAC,WAAW,EAAE;gBACxD,SAAS,EAAE,cAAc;gBACzB,MAAM,EAAE,KAAK,CAAC,aAAa;aAC5B,CAAC,CAAC;YACH,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;gBACtC,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,iEAAiE;AACjE,SAAS,QAAQ,CAAC,cAAsB,EAAE,QAA8B;IACtE,OAAO;QACL,SAAS,EAAE,cAAc;QACzB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS;KAC9B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAmB,EACnB,IAAY,EACZ,SAAiB;IAEjB,MAAM,YAAY,GAAG,IAAI,mBAAmB,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,iBAAiB,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC;QAC/D,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,SAAS;QAC5C,IAAI,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5D,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/docs/similarity-check.d.ts

@@ -32,6 +32,8 @@
  * @task T10361 — T-E3.3 (closes absorbed T10167)
  * @adr ADR-083
  */
+import { similarityScore } from './slug-similarity.js';
+export { similarityScore };
 /**
  * Default similarity threshold. Score above this (but below `1.0`) triggers
  * the "did you mean" hint. Calibrated to catch `cant-spec` vs `cantspec`,
@@ -143,4 +145,3 @@ export interface SimilarityConfig {
  * @task T10361
  */
 export declare function parseSimilarityConfig(raw: unknown, source: string): SimilarityConfig;
-//# sourceMappingURL=similarity-check.d.ts.map

package/dist/docs/similarity-check.js

@@ -33,6 +33,9 @@
  * @adr ADR-083
  */
 import { createAttachmentStore } from '../store/attachment-store.js';
+import { similarityScore } from './slug-similarity.js';
+// T14109: the scorer lives in slug-similarity.ts, a leaf with no refusals.
+export { similarityScore };
 /**
  * Default similarity threshold. Score above this (but below `1.0`) triggers
  * the "did you mean" hint. Calibrated to catch `cant-spec` vs `cantspec`,
@@ -50,55 +53,6 @@ export const DEFAULT_SIMILARITY_THRESHOLD = 0.85;
  * @task T10361
  */
 export const DEFAULT_SIMILARITY_MODE = 'warn';
-/**
- * Calculate the Levenshtein distance between two strings.
- *
- * Distance = minimum number of single-character edits (insert, delete,
- * substitute) needed to change `a` into `b`. Implementation duplicated
- * from `packages/cleo/src/cli/lib/did-you-mean.ts` so the core package
- * does not take a CLI dependency.
- *
- * @internal
- * @task T10361
- */
-function levenshteinDistance(a, b) {
-    const aLen = a.length;
-    const bLen = b.length;
-    if (aLen === 0)
-        return bLen;
-    if (bLen === 0)
-        return aLen;
-    // Allocate the 2-D DP matrix lazily.
-    const matrix = Array.from({ length: aLen + 1 }, (_, i) => [i]);
-    for (let j = 1; j <= bLen; j++) {
-        matrix[0][j] = j;
-    }
-    for (let i = 1; i <= aLen; i++) {
-        for (let j = 1; j <= bLen; j++) {
-            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-            matrix[i][j] = Math.min(matrix[i - 1][j] + 1, // deletion
-            matrix[i][j - 1] + 1, // insertion
-            matrix[i - 1][j - 1] + cost);
-        }
-    }
-    return matrix[aLen][bLen];
-}
-/**
- * Normalise Levenshtein distance to a `[0, 1]` similarity score.
- *
- * Formula: `1 - distance / max(len(a), len(b))`. Identical strings return
- * `1.0`; strings sharing no characters of equal length return `0.0`.
- *
- * @internal
- * @task T10361
- */
-function similarityScore(a, b) {
-    const longest = Math.max(a.length, b.length);
-    if (longest === 0)
-        return 1; // both empty
-    const distance = levenshteinDistance(a, b);
-    return 1 - distance / longest;
-}
 /**
  * Check whether the proposed slug is near-duplicate of any existing slug
  * for the same DocKind in the current project.
@@ -170,6 +124,7 @@ export function parseSimilarityConfig(raw, source) {
         return { warnThreshold: DEFAULT_SIMILARITY_THRESHOLD, mode: DEFAULT_SIMILARITY_MODE };
     }
     if (typeof raw !== 'object' || Array.isArray(raw)) {
+        // @sync-invariant none:input-shape a malformed similarity config is refused before anything is written
         throw new Error(`${source}: 'similarity' must be an object`);
     }
     const obj = raw;
@@ -177,6 +132,7 @@ export function parseSimilarityConfig(raw, source) {
     if (obj['warnThreshold'] !== undefined) {
         const t = obj['warnThreshold'];
         if (typeof t !== 'number' || Number.isNaN(t) || t < 0 || t > 1) {
+            // @sync-invariant none:input-shape a malformed similarity threshold is refused before anything is written
             throw new Error(`${source}: 'similarity.warnThreshold' must be a number in [0, 1] (got ${String(t)})`);
         }
         warnThreshold = t;
@@ -185,6 +141,7 @@ export function parseSimilarityConfig(raw, source) {
     if (obj['mode'] !== undefined) {
         const m = obj['mode'];
         if (m !== 'warn' && m !== 'block') {
+            // @sync-invariant none:input-shape a malformed similarity mode is refused before anything is written
             throw new Error(`${source}: 'similarity.mode' must be 'warn' or 'block' (got ${String(m)})`);
         }
         mode = m;

package/dist/docs/similarity-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"similarity-check.js","sourceRoot":"","sources":["../../src/docs/similarity-check.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"similarity-check.js","sourceRoot":"","sources":["../../src/docs/similarity-check.ts"],"names":[],"mappings":"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"}

package/dist/docs/slug-allocator.d.ts

@@ -260,4 +260,3 @@ export type ReserveSlugForDispatchResult = SlugReserveResult;
  * @task T10386
  */
 export declare function reserveSlugForDispatch(projectRoot: string, params: ReserveSlugForDispatchParams): Promise<ReserveSlugForDispatchResult>;
-//# sourceMappingURL=slug-allocator.d.ts.map

package/dist/docs/slug-allocator.js

@@ -304,7 +304,9 @@ export async function reserveSlug(kind, slug, opts) {
             .from(attachments)
             .where(eq(attachments.slug, normalizedSlug))
             .get();
-        if (conflict) {
+        // T14288: a doc identity's live slug or an old alias is taken too.
+        const { isConduitDocSlug } = await import('../store/conduit-doc-history.js');
+        if (conflict || (await isConduitDocSlug(db, normalizedSlug))) {
             const suggestions = await deriveSlugSuggestionsForAllocator(db, normalizedSlug);
             return { ok: false, code: 'E_SLUG_RESERVED', suggestions };
         }

package/dist/docs/slug-allocator.js.map

@@ -1 +1 @@
-{"version":3,"file":"slug-allocator.js","sourceRoot":"","sources":["../../src/docs/slug-allocator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"slug-allocator.js","sourceRoot":"","sources":["../../src/docs/slug-allocator.ts"],"names":[],"mappings":"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"}

package/dist/docs/slug-normalize.d.ts

@@ -63,4 +63,3 @@
  * ```
  */
 export declare function normalizeSlug(input: string): string;
-//# sourceMappingURL=slug-normalize.d.ts.map

package/dist/docs/slug-rename.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Rename a doc's slug and keep the old slug resolvable (T14118).
+ *
+ * The slug is an alias, not an identity (spec `cleodocs-rearch-design` §3,
+ * D11165): the immutable id is the conduit doc uid. A rename therefore
+ *
+ * 1. adopts the doc into the conduit family if it is not there yet
+ *    ({@link ensureConduitDoc}), so it has a uid to alias;
+ * 2. moves the live slug on the registry row (`docs_attachments`) and on the
+ *    conduit identity row (`conduit_attachments`);
+ * 3. records `old slug → uid` in `conduit_doc_slug_aliases` (append-only), so
+ *    `cleo docs fetch <old>` and every reader that resolves through
+ *    {@link resolveDocSlug} still find the doc;
+ * 4. re-points the body-derived `links-to` edges (the column-derived edges are
+ *    rebuilt by the caller).
+ *
+ * Renaming back (rollback) is the same operation in reverse; the earlier
+ * alias row stays as history and is shadowed by the live slug.
+ *
+ * @task T14118
+ * @epic T14106
+ */
+import { type ConduitDocMeta } from '../store/conduit-doc-history.js';
+import { attachments } from '../store/tasks-schema.js';
+/** Input to {@link renameDocSlug}. */
+export interface RenameDocSlugInput {
+    /** The doc's current slug. */
+    readonly oldSlug: string;
+    /** The slug it should carry. */
+    readonly newSlug: string;
+    /** Why (kept on the alias row), e.g. `modernize`, `adr-renumber`. */
+    readonly reason: string;
+    /** Agent recorded when the doc is adopted into the conduit family. */
+    readonly authorAgentId: string;
+}
+/** Result of {@link renameDocSlug}. */
+export interface RenameDocSlugResult {
+    /** The doc's immutable conduit uid. */
+    readonly docUid: string;
+    /** Whether this rename adopted the doc into the conduit family. */
+    readonly adopted: boolean;
+}
+/**
+ * Rename a doc's slug, keeping the old one as an alias.
+ *
+ * @param projectRoot - Absolute project root.
+ * @param input - Old and new slug, reason and author.
+ * @returns The doc uid and whether it was adopted.
+ * @throws CleoError `E_NOT_FOUND` when `oldSlug` names no doc; `E_VALIDATION`
+ *   when `newSlug` is already a live slug.
+ */
+export declare function renameDocSlug(projectRoot: string, input: RenameDocSlugInput): Promise<RenameDocSlugResult>;
+/**
+ * Resolve a slug that may be an old alias to the doc's live slug.
+ *
+ * @param projectRoot - Absolute project root.
+ * @param slug - A live slug or an alias.
+ * @returns The live slug, or null when neither resolves.
+ */
+export declare function resolveDocSlug(projectRoot: string, slug: string): Promise<string | null>;
+/** A doc resolved from a slug (T14288): its identity, live slug, head and metadata row. */
+export interface DocRef {
+    /**
+     * `uid` when the slug resolved through the doc's immutable conduit identity
+     * (live slug or alias) to its head version; `legacy` when the doc has no
+     * identity or head yet and resolved through the registry row's slug. The
+     * legacy path is deleted once every store has run `cleo docs migrate`
+     * (`cleo upgrade` runs it; T14288 PR 3).
+     */
+    readonly identity: 'uid' | 'legacy';
+    /** The doc's live slug (the conduit row's, on the uid path). */
+    readonly slug: string;
+    /** The immutable doc uid, or null on the legacy path. */
+    readonly docUid: string | null;
+    /** The head version uid, or null on the legacy path. */
+    readonly headVersionUid: string | null;
+    /**
+     * SHA-256 of the bytes the doc resolves to: on the uid path the head
+     * version's content hash, or the live row's when its write never landed as
+     * a version.
+     */
+    readonly sha256: string;
+    /**
+     * The registry row carrying the doc's metadata: the head content's row, or
+     * (a head moved by sync, or a recorded section conflict, whose content has
+     * no row) the live slug's row. Bytes always come from {@link sha256}.
+     */
+    readonly row: typeof attachments.$inferSelect;
+    /**
+     * The doc's own registry row (T14288 PR 3b-2): the one carrying its live
+     * slug, with its owners, creation time and version counter. It differs from
+     * {@link row} when the doc's head is content another doc also holds (the
+     * shared content row stays that doc's); otherwise it is the same row.
+     */
+    readonly ownRow: typeof attachments.$inferSelect;
+    /**
+     * The doc's metadata (T14288 PR 3b): from its identity row on the uid path,
+     * from the registry row on the legacy path (supersession pointers are then
+     * doc uids when the other doc has one). An identity row created before the
+     * metadata columns existed, with nothing mirrored yet, also reads the
+     * registry row; `cleo upgrade` mirrors every such row.
+     */
+    readonly meta: ConduitDocMeta;
+}
+/**
+ * Resolve a slug, live or an old alias, to its doc (T14288): slug → conduit
+ * uid (live slug, then `conduit_doc_slug_aliases`) → head version → content
+ * hash → the registry row of that content. One exception on the uid path:
+ * a live slug row whose content no version of the doc records is a write
+ * whose section projection did not land (`docs update` writes the row and
+ * leaves the head when the merge preview or the projection commit fails,
+ * T13842), so that row is served; a head moved by sync still wins, since the
+ * local row then holds the old head's content, which is a recorded version.
+ * A doc with no conduit identity or no head resolves through its registry row's slug, marked
+ * `identity: 'legacy'`, with a `W_DOC_NOT_MIGRATED` warning naming
+ * `cleo docs migrate`.
+ *
+ * @param projectRoot - Absolute project root.
+ * @param slug - A live slug or an alias.
+ * @param opts - `quiet` skips the legacy warning (lookups that probe many slugs).
+ * @returns The resolved doc, or null when nothing resolves.
+ * @task T14288
+ */
+export declare function resolveDocRef(projectRoot: string, slug: string, opts?: {
+    readonly quiet?: boolean;
+}): Promise<DocRef | null>;
+/**
+ * Every doc in the project, resolved as {@link resolveDocRef} resolves one
+ * (T14288 PR 3b): each doc identity with a head (its head content's registry
+ * row, its identity metadata) and each legacy registry row whose slug has no
+ * identity yet. Four set reads, no per-doc query, so listing and indexing
+ * surfaces can use it on every call. No warning is pushed.
+ *
+ * @param projectRoot - Absolute project root.
+ * @returns One {@link DocRef} per doc, uid docs first, each slug once.
+ * @task T14288
+ */
+export declare function listDocRefs(projectRoot: string): Promise<DocRef[]>;
+/**
+ * The live slugs of the docs a resolved doc supersedes and is superseded by
+ * (T14288 PR 3b): through the doc uids of its metadata, else (a doc the other
+ * side of which has no identity yet) through the registry row's pointer.
+ *
+ * @param projectRoot - Absolute project root.
+ * @param ref - A resolved doc.
+ * @returns The two slugs, null where there is none.
+ * @task T14288
+ */
+export declare function supersessionSlugs(projectRoot: string, ref: DocRef): Promise<{
+    supersedes: string | null;
+    supersededBy: string | null;
+}>;
+/**
+ * Whether a slug already names a doc (T14288 PR 3b): a registry row's slug, a
+ * doc identity's live slug, or an old slug kept as an alias. An alias counts:
+ * a new doc under it would shadow the renamed doc its old links reach.
+ *
+ * @param projectRoot - Absolute project root.
+ * @param slug - The candidate slug.
+ * @returns True when the slug is taken.
+ * @task T14288
+ */
+export declare function isDocSlugTaken(projectRoot: string, slug: string): Promise<boolean>;
+/**
+ * Every slug a doc has carried: its live slug first, then its aliases.
+ *
+ * @param projectRoot - Absolute project root.
+ * @param slug - The live slug or any alias.
+ * @returns The slugs, or `[slug]` when the doc has no conduit identity.
+ */
+export declare function listDocSlugs(projectRoot: string, slug: string): Promise<string[]>;
+/**
+ * Set a doc row's kind (`type`), or clear it with null. Read the previous
+ * kind first with {@link getDocKind} when it must be restored later.
+ *
+ * @param projectRoot - Absolute project root.
+ * @param attachmentId - The row id.
+ * @param kind - The new kind.
+ */
+export declare function setDocKind(projectRoot: string, attachmentId: string, kind: string | null): Promise<void>;
+/**
+ * Read a doc row's kind (`type`).
+ *
+ * @param projectRoot - Absolute project root.
+ * @param attachmentId - The row id.
+ * @returns The kind, or null when untyped or unknown.
+ */
+export declare function getDocKind(projectRoot: string, attachmentId: string): Promise<string | null>;