@cleocode/core 2026.10.18 → 2026.10.19

package/dist/docs/conduit-history-backfill.js

@@ -0,0 +1,451 @@
+/**
+ * T13727 — backfill `conduit_attachment_versions` for docs whose history
+ * predates the conduit adoption.
+ *
+ * The section write path (`section-write-path.ts`) has projected every docs
+ * update through the conduit history family since the adoption release, but
+ * updates from BEFORE the adoption wrote no conduit rows — the T13360
+ * migration projected only then-current content. A doc at `docVersion` 3 can
+ * therefore hold a single conduit version row (the first post-adoption
+ * update, minted as local display ordinal 1), with versions 1..N−1 known
+ * only to the legacy surfaces. This module is the historical complement to
+ * that projection: it reconstructs the missing rows from the honest
+ * pre-adoption sources and inserts them through the canonical accessor.
+ *
+ * Honest-metadata contract (Council condition for migrated history):
+ *
+ *   - The version CHAIN comes from the docs-versioning audit log
+ *     (`.cleo/audit/docs-versioning.jsonl`): each changed revision records
+ *     the real timestamp (`ts`), the real author (`attachedBy`) and the real
+ *     content address (`sha256`). Version 1 anchors at the first revision's
+ *     `previousSha256`; its creation instant is read from the matching
+ *     `docs_attachments` row (historical rows keep their `created_at` after
+ *     an update re-homes the slug), and its author is unknown — recorded as
+ *     {@link CONDUIT_BACKFILL_AUTHOR}, never invented.
+ *   - `changeType` is the schema's honest `'migrated'` (via
+ *     {@link importMigratedConduitVersion}); `origin` is `'backfill-t13727'`
+ *     so repair-synthesized rows never pose as T13360 imports.
+ *   - `contentHash` addresses the REAL historical bytes. When the bytes are
+ *     unrecoverable (neither the blob store nor the legacy attachment tree
+ *     holds them), the position is recorded as a GAP and skipped — content
+ *     is never fabricated. The parent chain links across a gap to the
+ *     nearest present ancestor and the report counts the gap.
+ *   - Existing conduit rows are NEVER updated or renumbered (append-only).
+ *     Matching is by CONTENT HASH, never by ordinal or tail position
+ *     (review-2253): a chain position whose hash already has a row is done;
+ *     an existing row whose hash is not in the chain refuses the doc
+ *     (reported for manual review); complete means every recoverable
+ *     position is present, and unrecoverable positions stay reported as
+ *     gaps rather than being silently dropped.
+ *
+ * Idempotency: a doc whose chain positions all have rows (by content hash)
+ * is skipped; per-row natural uids (doc uid, content hash, createdAt) make a
+ * partial re-run a verified no-op via `ON CONFLICT DO NOTHING`.
+ *
+ * The parent link from the last backfilled row to the first EXISTING row is
+ * implicit (content alignment + display ordinals); existing rows'
+ * `parent_version_uid` is history and stays untouched.
+ *
+ * @module
+ * @task T13727
+ * @epic T13340
+ * @saga T13339
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { and, asc, eq, isNotNull } from 'drizzle-orm';
+import { resolveCleoDir } from '../paths.js';
+import { resolveLegacyByteSource } from '../store/blob-keep.js';
+import { importMigratedConduitVersion, listConduitAttachmentVersions, withConduitDocWriteTransaction, } from '../store/conduit-doc-history.js';
+import { naturalRowUid } from '../store/row-identity.js';
+import { conduitAttachments } from '../store/schema/cleo-project/conduit.js';
+import { getDb } from '../store/sqlite.js';
+import { docsAttachments } from '../store/tasks-schema.js';
+import { DOCS_VERSIONING_AUDIT_FILE } from './docs-update.js';
+/**
+ * Honest author label for backfilled rows whose real author is unrecoverable
+ * (the original creation predates the docs-versioning audit trail's author
+ * tracking on revisions, and `docs_attachments` records no author).
+ *
+ * @task T13727
+ */
+export const CONDUIT_BACKFILL_AUTHOR = 'cleo:backfill-t13727';
+/**
+ * Import provenance written to `conduit_attachment_versions.origin` — keeps
+ * repair-synthesized rows distinguishable from T13360 `'migrated'` imports
+ * and from native (`NULL`) rows.
+ *
+ * @task T13727
+ */
+export const CONDUIT_BACKFILL_ORIGIN = 'backfill-t13727';
+/** MIME used to probe the legacy attachment tree for historical doc bytes. */
+const DOC_PROBE_MIME = 'text/markdown';
+/**
+ * Measure a token count the way the docs write path does
+ * (`section-write-path.ts`) — whitespace-split, empty tokens dropped.
+ *
+ * @internal
+ */
+function countTokens(text) {
+    return text.split(/\s+/).filter((w) => w.length > 0).length;
+}
+/**
+ * True when `value` is a non-empty string (the audit parser's field guard).
+ * @internal
+ */
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+/**
+ * Read the docs-versioning audit log once, flattening every squash window's
+ * revisions into a per-slug chronological list. Malformed lines and entries
+ * are skipped — the file is an audit aid, and a corrupt line must not fail
+ * the repair planning pass.
+ *
+ * @internal
+ */
+function readAuditRevisionsBySlug(projectRoot) {
+    let raw;
+    try {
+        raw = readFileSync(join(projectRoot, DOCS_VERSIONING_AUDIT_FILE), 'utf-8');
+    }
+    catch {
+        return new Map();
+    }
+    const bySlug = new Map();
+    for (const line of raw.split('\n')) {
+        if (line.trim().length === 0)
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (entry.op !== 'docs.update' || !isNonEmptyString(entry.slug))
+            continue;
+        if (!Array.isArray(entry.revisions))
+            continue;
+        const list = bySlug.get(entry.slug) ?? [];
+        for (const revision of entry.revisions) {
+            if (revision !== null && typeof revision === 'object') {
+                list.push(revision);
+            }
+        }
+        bySlug.set(entry.slug, list);
+    }
+    return bySlug;
+}
+/**
+ * Read the bytes for `sha256` from the blob store or the legacy attachment
+ * tree, verifying the SHA-256 before returning. Read-only: unlike
+ * `blobReadBySha` this never heals/mirrors — planning and dry runs must stay
+ * side-effect free. A candidate whose hash does not verify is skipped (a
+ * corrupt file at the address is a gap, not content).
+ *
+ * @internal
+ */
+async function readVerifiedVersionBytes(cleoDir, sha256) {
+    const candidates = [
+        join(cleoDir, 'blobs', 'blobs', sha256),
+        resolveLegacyByteSource(cleoDir, sha256, DOC_PROBE_MIME),
+    ];
+    for (const candidate of candidates) {
+        if (candidate === null)
+            continue;
+        let bytes;
+        try {
+            bytes = await readFile(candidate);
+        }
+        catch {
+            continue;
+        }
+        if (createHash('sha256').update(bytes).digest('hex') === sha256)
+            return bytes;
+    }
+    return null;
+}
+/**
+ * Reconstruct one doc's pre-adoption version chain from the honest sources.
+ *
+ * Chain shape: position 1 anchors at the first audit revision's
+ * `previousSha256` (the content the slug pointed at before any recorded
+ * update); every CHANGED revision appends its `sha256` as the next state.
+ * Noop revisions (a lifecycle-only update writes `changed: false`) create no
+ * new content state and are skipped. A doc the audit log never saw yields a
+ * single-state chain from its current `docs_attachments` row.
+ *
+ * Returns null when the chain cannot be anchored honestly (the first
+ * revision carries no usable `previousSha256` but changed revisions exist) —
+ * the caller reports the doc as unrecoverable rather than mislabeling a
+ * later state as the root.
+ *
+ * @internal
+ */
+async function deriveChainStates(db, slug, revisions) {
+    const changed = revisions.filter((r) => r.changed === true && isNonEmptyString(r.ts) && isNonEmptyString(r.sha256));
+    if (revisions.length === 0) {
+        const row = await db
+            .select({ sha256: docsAttachments.sha256, createdAt: docsAttachments.createdAt })
+            .from(docsAttachments)
+            .where(eq(docsAttachments.slug, slug))
+            .get();
+        if (!row)
+            return [];
+        // Honest labeling (review-2253 LOW-2): the audit log records NOTHING for
+        // this doc, so the single state is the version that SURVIVED, not a
+        // recorded "original version" — chain length 1 by survival, and any
+        // earlier history is unrecoverable rather than absent-by-proof.
+        return [
+            {
+                position: 1,
+                sha256: row.sha256,
+                createdAt: row.createdAt,
+                authorAgentId: CONDUIT_BACKFILL_AUTHOR,
+                changeSummary: 'only surviving version — doc predates the docs-versioning audit log; ' +
+                    'earlier history is unrecoverable (backfilled by T13727)',
+            },
+        ];
+    }
+    const anchor = revisions[0]?.previousSha256;
+    if (!isNonEmptyString(anchor))
+        return null;
+    const firstTs = revisions[0]?.ts;
+    // The anchor row must be the ORIGINAL creation row (doc_version = 1), not
+    // just any row carrying the sha: content-address dedupe reuses one
+    // docs_attachments row across slugs, and a reused row's created_at belongs
+    // to another doc's timeline (review-2253 LOW-1).
+    const anchorRow = await db
+        .select({ createdAt: docsAttachments.createdAt })
+        .from(docsAttachments)
+        .where(and(eq(docsAttachments.sha256, anchor), eq(docsAttachments.docVersion, 1)))
+        .get();
+    if (!anchorRow && !isNonEmptyString(firstTs))
+        return null;
+    const states = [
+        {
+            position: 1,
+            sha256: anchor,
+            createdAt: anchorRow?.createdAt ?? firstTs,
+            authorAgentId: CONDUIT_BACKFILL_AUTHOR,
+            changeSummary: anchorRow
+                ? 'original version (pre-adoption history backfilled by T13727)'
+                : 'original version — timestamp is the first recorded update; the creation instant ' +
+                    'is unrecoverable (pre-adoption history backfilled by T13727)',
+        },
+    ];
+    for (const revision of changed) {
+        const message = isNonEmptyString(revision.message) ? `: ${revision.message}` : '';
+        states.push({
+            position: states.length + 1,
+            sha256: revision.sha256,
+            createdAt: revision.ts,
+            authorAgentId: isNonEmptyString(revision.attachedBy)
+                ? revision.attachedBy
+                : CONDUIT_BACKFILL_AUTHOR,
+            changeSummary: `pre-adoption history backfilled by T13727${message}`,
+        });
+    }
+    return states;
+}
+/**
+ * Plan the conduit-history backfill for every adopted doc.
+ *
+ * A doc is in scope when the docs registry (`docs_attachments`) knows its
+ * slug AND a `conduit_attachments` row exists for it — the doc was adopted
+ * (or migrated) but its pre-adoption updates wrote no conduit rows. Pure
+ * with respect to the database and the blob store: safe in dry-run planning.
+ *
+ * Matching model (review-2253): matching is by CONTENT HASH, never by
+ * ordinal or tail position — after a gapped apply the existing set mixes
+ * backfilled low positions with minted rows, so a positional tail check
+ * would false-conflict forever. The rules:
+ *
+ *   - a chain position whose content_hash already has a row is done;
+ *   - a position with no row and no verified bytes is a gap (counted);
+ *   - an existing row whose content_hash is not in the chain is a conflict
+ *     (the doc is refused and reported, never overwritten);
+ *   - complete means every recoverable position is present — a doc with
+ *     permanent gaps can be complete AND still report them.
+ *
+ * Existing rows keep their minted local display ordinals (rows are
+ * append-only); backfilled rows carry their chain position as
+ * `version_number`, so ordinals may repeat across the seam — the schema
+ * defines `version_number` as a local display ordinal that is never a key,
+ * and `docs versions` assigns read-time display ordinals instead.
+ *
+ * @param projectRoot - Absolute path to the CLEO project root.
+ * @returns One plan per in-scope doc (complete, backfill, gap or conflict).
+ * @task T13727
+ */
+export async function planConduitHistoryBackfill(projectRoot) {
+    const db = await getDb(projectRoot);
+    const registrySlugs = new Set((await db
+        .select({ slug: docsAttachments.slug })
+        .from(docsAttachments)
+        .where(isNotNull(docsAttachments.slug))
+        .all()).map((r) => r.slug));
+    const conduitDocs = await db
+        .select({ uid: conduitAttachments.uid, slug: conduitAttachments.slug })
+        .from(conduitAttachments)
+        .where(isNotNull(conduitAttachments.slug))
+        .orderBy(asc(conduitAttachments.slug))
+        .all();
+    const revisionsBySlug = readAuditRevisionsBySlug(projectRoot);
+    const cleoDir = resolveCleoDir(projectRoot);
+    const plans = [];
+    for (const doc of conduitDocs) {
+        if (doc.slug === null || doc.uid === null)
+            continue;
+        if (!registrySlugs.has(doc.slug))
+            continue;
+        const slug = doc.slug;
+        const registryRow = await db
+            .select({ docVersion: docsAttachments.docVersion })
+            .from(docsAttachments)
+            .where(eq(docsAttachments.slug, slug))
+            .get();
+        const existing = (await listConduitAttachmentVersions(projectRoot, doc.uid)).sort((a, b) => a.versionNumber - b.versionNumber);
+        const base = {
+            slug,
+            docUid: doc.uid,
+            existingVersions: existing.length,
+            auditGapVersions: 0,
+        };
+        const states = await deriveChainStates(db, slug, revisionsBySlug.get(slug) ?? []);
+        if (states === null) {
+            plans.push({
+                ...base,
+                expectedVersions: 0,
+                presentVersions: 0,
+                toBackfill: [],
+                gaps: [],
+                complete: false,
+                conflict: true,
+            });
+            continue;
+        }
+        const auditGapVersions = Math.max(0, (registryRow?.docVersion ?? states.length) - states.length);
+        // An existing row whose content_hash is not in the chain contradicts
+        // the honest sources — refuse the doc and report it, never overwrite.
+        const chainHashes = new Set(states.map((s) => s.sha256));
+        if (existing.some((row) => !chainHashes.has(row.contentHash))) {
+            plans.push({
+                ...base,
+                expectedVersions: states.length,
+                auditGapVersions,
+                presentVersions: 0,
+                toBackfill: [],
+                gaps: [],
+                complete: false,
+                conflict: true,
+            });
+            continue;
+        }
+        // Content-hash matching (review-2253): no ordinal or tail-position
+        // assumptions — a position is done when its hash already has a row.
+        const hashPresent = new Set(existing.map((r) => r.contentHash));
+        // Earliest-created row per hash is the DAG parent candidate when several
+        // rows share a content hash (a revert, a recorded conflict).
+        const uidByHash = new Map();
+        for (const row of [...existing].sort((a, b) => a.createdAt.localeCompare(b.createdAt) || (a.uid ?? '').localeCompare(b.uid ?? ''))) {
+            if (typeof row.uid === 'string' && row.uid.length > 0 && !uidByHash.has(row.contentHash)) {
+                uidByHash.set(row.contentHash, row.uid);
+            }
+        }
+        const toBackfill = [];
+        const gaps = [];
+        let presentVersions = 0;
+        // The DAG parent of the next backfilled row: the uid of the nearest
+        // lower chain position that has (or will have, via this plan) a row.
+        let lastRowUid = null;
+        for (const state of states) {
+            if (hashPresent.has(state.sha256)) {
+                presentVersions += 1;
+                const uid = uidByHash.get(state.sha256);
+                if (uid !== undefined)
+                    lastRowUid = uid;
+                continue;
+            }
+            const bytes = await readVerifiedVersionBytes(cleoDir, state.sha256);
+            if (bytes === null) {
+                gaps.push({ position: state.position, sha256: state.sha256 });
+                continue;
+            }
+            toBackfill.push({
+                ...state,
+                sizeBytes: bytes.length,
+                tokens: countTokens(bytes.toString('utf-8')),
+                parentVersionUid: lastRowUid,
+            });
+            // The uid this row WILL have — importMigratedConduitVersion derives the
+            // same natural uid, so the link is stable across a re-run.
+            lastRowUid = naturalRowUid('project', 'conduit_attachment_versions', [
+                doc.uid,
+                state.sha256,
+                state.createdAt,
+            ]);
+        }
+        plans.push({
+            ...base,
+            expectedVersions: states.length,
+            auditGapVersions,
+            presentVersions,
+            toBackfill,
+            gaps,
+            // Complete = every recoverable position is present; permanent gaps
+            // stay reported in `gaps` rather than being silently dropped.
+            complete: toBackfill.length === 0,
+            conflict: false,
+        });
+    }
+    return plans;
+}
+/**
+ * Execute one {@link ConduitDocBackfillPlan}: insert the synthesized history
+ * rows through the canonical accessor, one transaction per doc.
+ *
+ * Every statement inside the transaction resolves without a real I/O yield
+ * (bytes were read and measured during planning; {@link withConduitDocWriteTransaction}
+ * brackets the inserts), so a partial backfill cannot leave a forked chain.
+ * Per-row natural uids make a re-run a verified no-op; a doc whose count
+ * already equals the chain length was filtered by the planner
+ * (`complete: true`) and inserts nothing here.
+ *
+ * @param projectRoot - Absolute path to the CLEO project root.
+ * @param plan - One doc's plan from {@link planConduitHistoryBackfill}.
+ * @returns Inserted row count and unrecoverable gap count for the doc.
+ * @task T13727
+ */
+// @sync-invariant docs.versions.append-only history rows are synthesized from the real audit chain and inserted with natural uids; nothing is updated or deleted, and a conflicting doc is refused by the planner before any write
+export async function applyConduitHistoryBackfill(projectRoot, plan) {
+    if (plan.complete || plan.conflict) {
+        return { slug: plan.slug, docUid: plan.docUid, inserted: 0, gaps: plan.gaps.length };
+    }
+    let inserted = 0;
+    await withConduitDocWriteTransaction(projectRoot, async () => {
+        for (const version of plan.toBackfill) {
+            const { inserted: didInsert } = await importMigratedConduitVersion(projectRoot, {
+                attachmentUid: plan.docUid,
+                parentVersionUid: version.parentVersionUid,
+                authorAgentId: version.authorAgentId,
+                storageKey: `sha256:${version.sha256}`,
+                contentHash: version.sha256,
+                sizeBytes: version.sizeBytes,
+                tokens: version.tokens,
+                versionNumber: version.position,
+                createdAt: version.createdAt,
+                changeSummary: version.changeSummary,
+                slug: plan.slug,
+                origin: CONDUIT_BACKFILL_ORIGIN,
+            });
+            if (didInsert)
+                inserted += 1;
+        }
+    });
+    return { slug: plan.slug, docUid: plan.docUid, inserted, gaps: plan.gaps.length };
+}
+//# sourceMappingURL=conduit-history-backfill.js.map

package/dist/docs/conduit-history-backfill.js.map

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

package/dist/docs/docs-ops.d.ts

@@ -123,6 +123,25 @@ export interface DocsVersionEntry {
     readonly ownerVersion?: string;
     /** Sequential doc version counter (T11181). */
     readonly docVersion?: number;
+    /**
+     * Display ordinal 1..N over the doc's version history, assigned at READ
+     * time (T13727 display-ordinal ruling): rows are ordered by `created_at`
+     * ascending (uid tiebreak) and the oldest row gets 1, the newest N. This
+     * never repeats across the pre-/post-adoption seam the way stored
+     * ordinals can. Present only on conduit-history entries (T13727 routing);
+     * manifest-fallback entries carry no version sequence and omit the field.
+     */
+    readonly version?: number;
+    /**
+     * The row's stored `conduit_attachment_versions.version_number` — the
+     * honest local display ordinal, which MAY repeat across the
+     * pre-/post-adoption seam (backfilled head rows carry their chain
+     * position while post-adoption rows keep their minted ordinals; rows are
+     * append-only and never renumbered). Diagnostics only — user-facing
+     * ordering uses {@link DocsVersionEntry.version}. Present only on
+     * conduit-history entries.
+     */
+    readonly storedVersionNumber?: number;
 }
 /**
  * Result returned by {@link listDocVersions}.
@@ -402,6 +421,20 @@ export declare function rankDocs(opts: {
  * (sibling docs included; narrow with `name`). An
  * arg that is neither throws `E_NOT_FOUND`.
  *
+ * T13727 — precedence: when the arg resolves as a doc slug that has been
+ * adopted into the conduit family AND has at least one
+ * `conduit_attachment_versions` row, the listing comes from the conduit
+ * history ({@link listConduitAttachmentVersions}) keyed on the doc's
+ * immutable uid — the canonical per-doc history — instead of the LWW blob
+ * manifest. Entries carry the version's `content_hash`, a read-time
+ * display ordinal (`version`, 1..N chronological — see
+ * {@link DocsVersionEntry.version}) and the stored
+ * `version_number` (`storedVersionNumber`), ordered newest first. A doc
+ * with no conduit row, or none yet adopted, keeps the manifest listing as
+ * fallback so the command never regresses; manifest entries omit
+ * `version`/`storedVersionNumber` (no stored version sequence exists
+ * there).
+ *
  * @param opts - Required `ownerId` (owner id or doc slug), optional `name`
  *   filter and `projectRoot`.
  * @returns Version list with SHA-256 content addresses.

package/dist/docs/docs-ops.d.ts.map

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

package/dist/docs/docs-ops.js

@@ -576,6 +576,57 @@ export async function rankDocs(opts) {
     });
     return { ownerId: opts.ownerId, hits };
 }
+/**
+ * Try the T13727 conduit-history listing for a doc-slug arg.
+ *
+ * Returns null (caller falls back to the manifest path) when the arg does
+ * not resolve to a conduit doc, when the doc has no version rows yet, or
+ * when the project store cannot be read — the command must never regress
+ * because the store was unreachable.
+ *
+ * @internal
+ */
+async function listConduitDocVersions(root, slug, name) {
+    try {
+        const { findConduitAttachmentByUid, listConduitAttachmentVersions, resolveConduitDocUid } = await import('../store/conduit-doc-history.js');
+        const docUid = await resolveConduitDocUid(root, slug);
+        if (docUid === null)
+            return null;
+        const doc = await findConduitAttachmentByUid(root, docUid);
+        const rows = await listConduitAttachmentVersions(root, docUid);
+        if (rows.length === 0)
+            return null;
+        const entryName = doc?.slug ?? slug;
+        if (name !== undefined && name !== entryName) {
+            return { ownerId: slug, nameFilter: name, versions: [] };
+        }
+        // Display-ordinal ruling (T13727): assign 1..N in chronological order
+        // (created_at ascending, uid tiebreak) — rows stay append-only and are
+        // never renumbered, so the stored version_number can repeat across the
+        // pre-/post-adoption seam; the read-time ordinal cannot. Entries are
+        // returned newest first, so the list reads N..1.
+        const chronological = [...rows].sort((a, b) => {
+            const byTime = a.createdAt.localeCompare(b.createdAt);
+            return byTime !== 0 ? byTime : (a.uid ?? '').localeCompare(b.uid ?? '');
+        });
+        const versions = chronological
+            .map((row, index) => ({ row, display: index + 1 }))
+            .reverse()
+            .map(({ row, display }) => ({
+            attachmentId: row.contentHash,
+            name: entryName,
+            sha256: row.contentHash,
+            sizeBytes: row.originalSize,
+            docVersion: row.versionNumber,
+            version: display,
+            storedVersionNumber: row.versionNumber,
+        }));
+        return { ownerId: slug, nameFilter: name, versions };
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * List all SHA-256 content-address versions of attachments for an owner.
  *
@@ -591,6 +642,20 @@ export async function rankDocs(opts) {
  * (sibling docs included; narrow with `name`). An
  * arg that is neither throws `E_NOT_FOUND`.
  *
+ * T13727 — precedence: when the arg resolves as a doc slug that has been
+ * adopted into the conduit family AND has at least one
+ * `conduit_attachment_versions` row, the listing comes from the conduit
+ * history ({@link listConduitAttachmentVersions}) keyed on the doc's
+ * immutable uid — the canonical per-doc history — instead of the LWW blob
+ * manifest. Entries carry the version's `content_hash`, a read-time
+ * display ordinal (`version`, 1..N chronological — see
+ * {@link DocsVersionEntry.version}) and the stored
+ * `version_number` (`storedVersionNumber`), ordered newest first. A doc
+ * with no conduit row, or none yet adopted, keeps the manifest listing as
+ * fallback so the command never regresses; manifest entries omit
+ * `version`/`storedVersionNumber` (no stored version sequence exists
+ * there).
+ *
  * @param opts - Required `ownerId` (owner id or doc slug), optional `name`
  *   filter and `projectRoot`.
  * @returns Version list with SHA-256 content addresses.
@@ -603,6 +668,13 @@ export async function rankDocs(opts) {
  */
 export async function listDocVersions(opts) {
     const root = opts.projectRoot ?? getProjectRoot();
+    // T13727 — a doc slug with conduit history lists the canonical version
+    // rows; any failure to reach the store degrades to the manifest path.
+    if (!/^(T\d+$|ses_|O-)/.test(opts.ownerId)) {
+        const conduit = await listConduitDocVersions(root, opts.ownerId, opts.name);
+        if (conduit !== null)
+            return conduit;
+    }
     let allBlobs = await blobList(opts.ownerId, root).catch(() => []);
     let listedOwnerId = opts.ownerId;
     if (allBlobs.length === 0 && !/^(T\d+$|ses_|O-)/.test(opts.ownerId)) {