@cleocode/core 2026.6.6 → 2026.6.8

package/dist/docs/index.d.ts

@@ -52,6 +52,10 @@ export type { ListProjectDocsOpts, ResolvedDoc } from './docs-read-model.js';
 export { createDocsReadModel, DocsReadModel } from './docs-read-model.js';
 export type { ProvisionResult, PublishPrError, PublishPrOptions, PublishPrResult, PublishPrRunners, PublishPrSuccess, } from './publish-pr.js';
 export { branchForSlug, buildPublishFrontmatter, defaultPublishPrBody, defaultRun, execMsg, KNOWN_DOC_TYPES, knownDocTypesForProject, parseGhPrUrl, pickRunner, provisionPublishPrWorktree, publishDirForType, publishDocsAsPr, publishPrError, stripExistingFrontmatter, teardownPublishPrWorktree, tempWorktreeDirForSlug, validatePublishSlug, } from './publish-pr.js';
+export type { ReadDocOptions } from './read-doc.js';
+export { DocNotFoundError, readDoc } from './read-doc.js';
 export type { VersionAuditResult } from './version-ssot.js';
 export { auditVersionFields, compareCleoVersions, getCanonicalCleoVersion, resolveVersion, VERSION_SSOT_MIGRATION_SQL, versionInRange, } from './version-ssot.js';
+export type { RebuildDocsWikilinksOptions, RebuildDocsWikilinksResult, WikilinkEdge, } from './wikilinks.js';
+export { deriveWikilinkEdges, getDocsWikilinks, rebuildDocsWikilinks } from './wikilinks.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/docs/index.d.ts.map

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

package/dist/docs/index.js

@@ -38,5 +38,7 @@ export { countAuditEntriesForSlug, DOCS_AUDIT_FILE, readAuditLog, verifyAuditTra
 export { checkBlobFilesystem, checkDocsConsistency, } from './docs-inconsistency-detector.js';
 export { createDocsReadModel, DocsReadModel } from './docs-read-model.js';
 export { branchForSlug, buildPublishFrontmatter, defaultPublishPrBody, defaultRun, execMsg, KNOWN_DOC_TYPES, knownDocTypesForProject, parseGhPrUrl, pickRunner, provisionPublishPrWorktree, publishDirForType, publishDocsAsPr, publishPrError, stripExistingFrontmatter, teardownPublishPrWorktree, tempWorktreeDirForSlug, validatePublishSlug, } from './publish-pr.js';
+export { DocNotFoundError, readDoc } from './read-doc.js';
 export { auditVersionFields, compareCleoVersions, getCanonicalCleoVersion, resolveVersion, VERSION_SSOT_MIGRATION_SQL, versionInRange, } from './version-ssot.js';
+export { deriveWikilinkEdges, getDocsWikilinks, rebuildDocsWikilinks } from './wikilinks.js';
 //# sourceMappingURL=index.js.map

package/dist/docs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAsB1D,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,8BAA8B,EAC9B,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtD,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,+EAA+E;AAE/E,8EAA8E;AAC9E,OAAO,EACL,2BAA2B,EAC3B,iCAAiC,EACjC,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,uCAAuC,CAAC;AAQ/C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,iCAAiC,CAAC;AAMzC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,OAAO,EACP,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,+EAA+E;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AASjC,gFAAgF;AAChF,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAQzB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAS1E,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,UAAU,EACV,OAAO,EACP,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,0BAA0B,EAC1B,cAAc,GACf,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAsB1D,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,8BAA8B,EAC9B,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtD,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,+EAA+E;AAE/E,8EAA8E;AAC9E,OAAO,EACL,2BAA2B,EAC3B,iCAAiC,EACjC,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,uCAAuC,CAAC;AAQ/C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,iCAAiC,CAAC;AAMzC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,OAAO,EACP,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,+EAA+E;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AASjC,gFAAgF;AAChF,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAQzB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAS1E,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,UAAU,EACV,OAAO,EACP,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,0BAA0B,EAC1B,cAAc,GACf,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/docs/read-doc.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `docs.read` core-SDK implementation — render a single CLEO doc (body + full
+ * provenance frontmatter) directly from `cleo.db`, the SOLE doc authority
+ * (saga T11778).
+ *
+ * This is the live read API the Obsidian plugin (T11827) and `cleo docs view`
+ * call. It is NOT a static export: every call reads the current DB state. The
+ * body is surfaced as UTF-8 text when decodable, else base64 (T11825 AC2), so
+ * binary blobs (images/PDFs) render without a second round-trip.
+ *
+ * Frontmatter is read straight from the `attachments` provenance columns
+ * (`slug`, `doc_version`, `owner_version`, `supersedes`, `superseded_by`,
+ * `topics`, `related_tasks`) — the same columns `docs_wikilinks` derives from —
+ * so the response is self-describing for an external consumer.
+ *
+ * @task T11825 (Epic T11781 / Saga T11778)
+ * @adr ADR-078 — Docs SSoT as provenance graph
+ * @see DocReadResponse — packages/contracts/src/docs/read.ts
+ * @see createDocsReadModel — body fetch + base64 plumbing reuse
+ */
+import type { DocReadResponse } from '@cleocode/contracts';
+/**
+ * Options for {@link readDoc}.
+ *
+ * @task T11825
+ */
+export interface ReadDocOptions {
+    /** Project root for DB resolution. Defaults to {@link getProjectRoot}(). */
+    readonly projectRoot?: string;
+}
+/**
+ * Error raised when {@link readDoc}'s slug cannot be resolved to a doc.
+ *
+ * @task T11825
+ */
+export declare class DocNotFoundError extends Error {
+    constructor(slug: string);
+}
+/**
+ * Read a single doc by slug, returning its body + full provenance frontmatter.
+ *
+ * Resolves the supersedes / superseded-by FK targets to their slugs (the
+ * external-consumer-friendly addressing) and decodes the body to UTF-8 when
+ * possible, falling back to base64 for binary content.
+ *
+ * @example
+ * ```ts
+ * const doc = await readDoc('adr-078-docs-provenance');
+ * console.log(doc.frontmatter.docVersion, doc.frontmatter.topics);
+ * if (doc.body.encoding === 'utf-8') console.log(doc.body.text);
+ * ```
+ *
+ * @param slug - The exact doc slug (case-sensitive).
+ * @param opts - Optional project-root override.
+ * @returns The typed {@link DocReadResponse}.
+ * @throws {DocNotFoundError} when no attachment carries the slug.
+ * @task T11825
+ */
+export declare function readDoc(slug: string, opts?: ReadDocOptions): Promise<DocReadResponse>;
+//# sourceMappingURL=read-doc.d.ts.map

package/dist/docs/read-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-doc.d.ts","sourceRoot":"","sources":["../../src/docs/read-doc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAA2B,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAOpF;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,IAAI,EAAE,MAAM;CAIzB;AAmBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwD/F"}

package/dist/docs/read-doc.js

@@ -0,0 +1,188 @@
+/**
+ * `docs.read` core-SDK implementation — render a single CLEO doc (body + full
+ * provenance frontmatter) directly from `cleo.db`, the SOLE doc authority
+ * (saga T11778).
+ *
+ * This is the live read API the Obsidian plugin (T11827) and `cleo docs view`
+ * call. It is NOT a static export: every call reads the current DB state. The
+ * body is surfaced as UTF-8 text when decodable, else base64 (T11825 AC2), so
+ * binary blobs (images/PDFs) render without a second round-trip.
+ *
+ * Frontmatter is read straight from the `attachments` provenance columns
+ * (`slug`, `doc_version`, `owner_version`, `supersedes`, `superseded_by`,
+ * `topics`, `related_tasks`) — the same columns `docs_wikilinks` derives from —
+ * so the response is self-describing for an external consumer.
+ *
+ * @task T11825 (Epic T11781 / Saga T11778)
+ * @adr ADR-078 — Docs SSoT as provenance graph
+ * @see DocReadResponse — packages/contracts/src/docs/read.ts
+ * @see createDocsReadModel — body fetch + base64 plumbing reuse
+ */
+import { Buffer } from 'node:buffer';
+import { eq } from 'drizzle-orm';
+import { getProjectRoot } from '../paths.js';
+import { createAttachmentStore } from '../store/attachment-store.js';
+import { getDb } from '../store/sqlite.js';
+import { attachments } from '../store/tasks-schema.js';
+/**
+ * Error raised when {@link readDoc}'s slug cannot be resolved to a doc.
+ *
+ * @task T11825
+ */
+export class DocNotFoundError extends Error {
+    constructor(slug) {
+        super(`Doc not found: no attachment carries slug '${slug}'`);
+        this.name = 'DocNotFoundError';
+    }
+}
+/**
+ * Read a single doc by slug, returning its body + full provenance frontmatter.
+ *
+ * Resolves the supersedes / superseded-by FK targets to their slugs (the
+ * external-consumer-friendly addressing) and decodes the body to UTF-8 when
+ * possible, falling back to base64 for binary content.
+ *
+ * @example
+ * ```ts
+ * const doc = await readDoc('adr-078-docs-provenance');
+ * console.log(doc.frontmatter.docVersion, doc.frontmatter.topics);
+ * if (doc.body.encoding === 'utf-8') console.log(doc.body.text);
+ * ```
+ *
+ * @param slug - The exact doc slug (case-sensitive).
+ * @param opts - Optional project-root override.
+ * @returns The typed {@link DocReadResponse}.
+ * @throws {DocNotFoundError} when no attachment carries the slug.
+ * @task T11825
+ */
+export async function readDoc(slug, opts = {}) {
+    const projectRoot = opts.projectRoot ?? getProjectRoot();
+    const db = await getDb(projectRoot);
+    const row = await db
+        .select({
+        id: attachments.id,
+        sha256: attachments.sha256,
+        slug: attachments.slug,
+        type: attachments.type,
+        summary: attachments.summary,
+        lifecycleStatus: attachments.lifecycleStatus,
+        supersedes: attachments.supersedes,
+        supersededBy: attachments.supersededBy,
+        topics: attachments.topics,
+        relatedTasks: attachments.relatedTasks,
+        ownerVersion: attachments.ownerVersion,
+        docVersion: attachments.docVersion,
+        createdAt: attachments.createdAt,
+    })
+        .from(attachments)
+        .where(eq(attachments.slug, slug))
+        .get();
+    if (!row)
+        throw new DocNotFoundError(slug);
+    const frontmatterRow = row;
+    // Resolve supersession FK ids → slugs for external addressing.
+    const [supersedesSlug, supersededBySlug] = await Promise.all([
+        resolveSlugById(db, frontmatterRow.supersedes),
+        resolveSlugById(db, frontmatterRow.supersededBy),
+    ]);
+    // Fetch the RAW body bytes (not a decoded string) so binary blobs survive the
+    // base64 path with full fidelity — `TextDecoder` would lossily replace
+    // invalid sequences with U+FFFD.
+    const { bytes, mimeType } = await fetchRawBody(frontmatterRow.sha256, projectRoot);
+    const frontmatter = {
+        slug: frontmatterRow.slug ?? slug,
+        kind: frontmatterRow.type,
+        title: frontmatterRow.slug ?? slug,
+        summary: frontmatterRow.summary,
+        lifecycleStatus: frontmatterRow.lifecycleStatus,
+        docVersion: frontmatterRow.docVersion,
+        ownerVersion: frontmatterRow.ownerVersion,
+        supersedes: supersedesSlug,
+        supersededBy: supersededBySlug,
+        topics: parseStringArray(frontmatterRow.topics),
+        relatedTasks: parseStringArray(frontmatterRow.relatedTasks),
+        sha256: frontmatterRow.sha256,
+        createdAt: frontmatterRow.createdAt,
+    };
+    const body = encodeBody(bytes, mimeType);
+    return { frontmatter, body };
+}
+/**
+ * Read the raw body bytes for a doc by content hash via the content-addressed
+ * attachment store. Returns an empty buffer when the metadata row exists but
+ * the blob was purged from disk.
+ *
+ * @internal
+ */
+async function fetchRawBody(sha256, projectRoot) {
+    const store = createAttachmentStore();
+    try {
+        const result = await store.get(sha256, projectRoot);
+        if (result) {
+            const mime = result.metadata.attachment.mime;
+            return { bytes: result.bytes, mimeType: typeof mime === 'string' ? mime : null };
+        }
+    }
+    catch {
+        // Attachment store unavailable or blob purged — fall through to empty body.
+    }
+    return { bytes: Buffer.alloc(0), mimeType: null };
+}
+/**
+ * Resolve an attachment id to its slug, or null when the id is absent /
+ * unresolved / slug-less.
+ *
+ * @internal
+ */
+async function resolveSlugById(db, id) {
+    if (!id)
+        return null;
+    const row = await db
+        .select({ slug: attachments.slug })
+        .from(attachments)
+        .where(eq(attachments.id, id))
+        .get();
+    return row?.slug ?? null;
+}
+/**
+ * Encode a doc body from its raw bytes. UTF-8-decodable content (the common
+ * markdown case) is surfaced as `text`; binary content (images/PDFs/files) is
+ * surfaced as `base64` so an external consumer can render it (T11825 AC2).
+ *
+ * UTF-8 validity is detected by a lossless decode→re-encode round-trip: invalid
+ * sequences decode to U+FFFD and fail to re-encode to the original bytes.
+ *
+ * @internal
+ */
+function encodeBody(bytes, mimeType) {
+    const text = bytes.toString('utf-8');
+    const isUtf8 = Buffer.from(text, 'utf-8').equals(bytes);
+    if (isUtf8) {
+        return { encoding: 'utf-8', text, sizeBytes: bytes.length, mimeType };
+    }
+    return {
+        encoding: 'base64',
+        base64: bytes.toString('base64'),
+        sizeBytes: bytes.length,
+        mimeType,
+    };
+}
+/**
+ * Parse a JSON-array-of-strings column, tolerating null / malformed values.
+ *
+ * @internal
+ */
+function parseStringArray(raw) {
+    if (!raw)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter((v) => typeof v === 'string' && v.length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=read-doc.js.map

package/dist/docs/read-doc.js.map

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

package/dist/docs/wikilinks.d.ts

@@ -0,0 +1,119 @@
+/**
+ * `docs_wikilinks` — derive + query the slug-addressed docs edge table.
+ *
+ * Per the ratified Docs-SSoT model (saga T11778) `cleo.db` is the SOLE doc
+ * authority and `docs_wikilinks` is a **DERIVED, non-authoritative** edge table
+ * reconstructed from three provenance columns already on `attachments`:
+ *
+ *   - `supersedes` / `superseded_by` → doc→doc supersession edges
+ *   - `related_tasks`                → doc→T#### task edges (JSON array)
+ *   - `topics`                       → doc↔doc shared-topic edges (JSON array)
+ *
+ * No markdown body `[[link]]` parsing is performed (T11826 AC4) — the edges
+ * derive purely from structured columns. The derivation is **idempotent**: it
+ * truncates and rebuilds the whole table, so callers may re-run it after any
+ * `docs add` / `supersede` / `docs update` write to keep the graph fresh.
+ *
+ * This module is the runtime twin of the SQL backfill in
+ * `migrations/drizzle-tasks/20260605000001_t11826-docs-wikilinks/migration.sql`
+ * — the migration seeds the table on schema upgrade, this function rebuilds it
+ * on demand.
+ *
+ * @task T11826 (Epic T11781 / Saga T11778)
+ * @adr ADR-078 — Docs SSoT as provenance graph
+ * @see build-provenance-graph.ts — the on-the-fly BFS this table makes O(edges)
+ */
+import { type DocsWikilinkRelation } from '../store/schema/attachments.js';
+/**
+ * A single slug-addressed wikilink edge.
+ *
+ * @task T11826
+ */
+export interface WikilinkEdge {
+    /** Source doc slug (always a doc). */
+    readonly fromSlug: string;
+    /** Target slug — a doc slug, or a `T####` task id when {@link toIsTask}. */
+    readonly toSlug: string;
+    /** Which provenance column produced this edge. */
+    readonly relation: DocsWikilinkRelation;
+    /** True when {@link toSlug} is a task id (`related-task` edges). */
+    readonly toIsTask: boolean;
+}
+/**
+ * Options shared by {@link rebuildDocsWikilinks}.
+ *
+ * @task T11826
+ */
+export interface RebuildDocsWikilinksOptions {
+    /** Project root for DB resolution. Defaults to {@link getProjectRoot}(). */
+    readonly projectRoot?: string;
+}
+/**
+ * Outcome of a {@link rebuildDocsWikilinks} call.
+ *
+ * @task T11826
+ */
+export interface RebuildDocsWikilinksResult {
+    /** Number of edges in the table after the rebuild. */
+    readonly edgeCount: number;
+    /** Per-relation edge counts. */
+    readonly byRelation: Readonly<Record<DocsWikilinkRelation, number>>;
+}
+/** Narrow row shape read from `attachments` during derivation. */
+interface DerivationRow {
+    readonly slug: string;
+    readonly supersedesSlug: string | null;
+    readonly supersededBySlug: string | null;
+    readonly relatedTasks: string | null;
+    readonly topics: string | null;
+}
+/**
+ * Idempotently rebuild the `docs_wikilinks` edge table from the provenance
+ * columns on `attachments`.
+ *
+ * The whole table is truncated and re-derived inside a single transaction, so
+ * the function is safe to call after any doc write and always converges to the
+ * same edge set for a given `attachments` state.
+ *
+ * @example
+ * ```ts
+ * const { edgeCount, byRelation } = await rebuildDocsWikilinks();
+ * console.log(`derived ${edgeCount} edges (${byRelation['topic']} topic links)`);
+ * ```
+ *
+ * @param opts - Optional project-root override.
+ * @returns Edge totals after the rebuild.
+ * @task T11826
+ */
+export declare function rebuildDocsWikilinks(opts?: RebuildDocsWikilinksOptions): Promise<RebuildDocsWikilinksResult>;
+/**
+ * Pure derivation: turn slugged `attachments` rows into the full edge set.
+ *
+ * Exposed for unit testing the derivation rules without a database. The output
+ * is deduplicated on the (`fromSlug`, `toSlug`, `relation`) composite key.
+ *
+ * @param rows - Slugged attachment rows with their provenance columns.
+ * @returns The derived wikilink edges.
+ * @task T11826
+ */
+export declare function deriveWikilinkEdges(rows: readonly DerivationRow[]): WikilinkEdge[];
+/**
+ * Read all wikilink edges incident to a doc slug — **bidirectional** by default.
+ *
+ * Returns both outbound edges (`from_slug = slug`) and inbound backlinks
+ * (`to_slug = slug`). This is the query the Obsidian plugin (T11827) renders to
+ * show a doc's neighborhood, and what `cleo docs graph` hydrates for persisted
+ * backlinks.
+ *
+ * @param slug - The doc slug to fetch edges for.
+ * @param opts.direction - `'both'` (default), `'out'`, or `'in'`.
+ * @param opts.projectRoot - Project root override.
+ * @returns The incident edges.
+ * @task T11826
+ */
+export declare function getDocsWikilinks(slug: string, opts?: {
+    direction?: 'both' | 'out' | 'in';
+    projectRoot?: string;
+}): Promise<WikilinkEdge[]>;
+export {};
+//# sourceMappingURL=wikilinks.d.ts.map

package/dist/docs/wikilinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikilinks.d.ts","sourceRoot":"","sources":["../../src/docs/wikilinks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,EAAE,KAAK,oBAAoB,EAAiB,MAAM,gCAAgC,CAAC;AAI1F;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC;CACrE;AAED,kEAAkE;AAClE,UAAU,aAAa;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,GAAE,2BAAgC,GACrC,OAAO,CAAC,0BAA0B,CAAC,CAoErC;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,YAAY,EAAE,CAoDlF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACrE,OAAO,CAAC,YAAY,EAAE,CAAC,CAmBzB"}

package/dist/docs/wikilinks.js

@@ -0,0 +1,217 @@
+/**
+ * `docs_wikilinks` — derive + query the slug-addressed docs edge table.
+ *
+ * Per the ratified Docs-SSoT model (saga T11778) `cleo.db` is the SOLE doc
+ * authority and `docs_wikilinks` is a **DERIVED, non-authoritative** edge table
+ * reconstructed from three provenance columns already on `attachments`:
+ *
+ *   - `supersedes` / `superseded_by` → doc→doc supersession edges
+ *   - `related_tasks`                → doc→T#### task edges (JSON array)
+ *   - `topics`                       → doc↔doc shared-topic edges (JSON array)
+ *
+ * No markdown body `[[link]]` parsing is performed (T11826 AC4) — the edges
+ * derive purely from structured columns. The derivation is **idempotent**: it
+ * truncates and rebuilds the whole table, so callers may re-run it after any
+ * `docs add` / `supersede` / `docs update` write to keep the graph fresh.
+ *
+ * This module is the runtime twin of the SQL backfill in
+ * `migrations/drizzle-tasks/20260605000001_t11826-docs-wikilinks/migration.sql`
+ * — the migration seeds the table on schema upgrade, this function rebuilds it
+ * on demand.
+ *
+ * @task T11826 (Epic T11781 / Saga T11778)
+ * @adr ADR-078 — Docs SSoT as provenance graph
+ * @see build-provenance-graph.ts — the on-the-fly BFS this table makes O(edges)
+ */
+import { eq, or } from 'drizzle-orm';
+import { getProjectRoot } from '../paths.js';
+import { docsWikilinks } from '../store/schema/attachments.js';
+import { getDb } from '../store/sqlite.js';
+import { attachments } from '../store/tasks-schema.js';
+/**
+ * Idempotently rebuild the `docs_wikilinks` edge table from the provenance
+ * columns on `attachments`.
+ *
+ * The whole table is truncated and re-derived inside a single transaction, so
+ * the function is safe to call after any doc write and always converges to the
+ * same edge set for a given `attachments` state.
+ *
+ * @example
+ * ```ts
+ * const { edgeCount, byRelation } = await rebuildDocsWikilinks();
+ * console.log(`derived ${edgeCount} edges (${byRelation['topic']} topic links)`);
+ * ```
+ *
+ * @param opts - Optional project-root override.
+ * @returns Edge totals after the rebuild.
+ * @task T11826
+ */
+export async function rebuildDocsWikilinks(opts = {}) {
+    const projectRoot = opts.projectRoot ?? getProjectRoot();
+    const db = await getDb(projectRoot);
+    // Read every attachment's id, slug and provenance columns in one pass, then
+    // resolve the supersession FK ids → slugs in JS via an id→slug map. (A
+    // correlated SQL subquery aliasing the same table is fragile across SQLite
+    // versions, so the resolution is done in memory.)
+    const allRows = await db
+        .select({
+        id: attachments.id,
+        slug: attachments.slug,
+        supersedes: attachments.supersedes,
+        supersededBy: attachments.supersededBy,
+        relatedTasks: attachments.relatedTasks,
+        topics: attachments.topics,
+    })
+        .from(attachments)
+        .all();
+    const slugById = new Map();
+    for (const r of allRows) {
+        if (r.slug)
+            slugById.set(r.id, r.slug);
+    }
+    const slugged = allRows
+        .filter((r) => typeof r.slug === 'string')
+        .map((r) => ({
+        slug: r.slug,
+        supersedesSlug: r.supersedes ? (slugById.get(r.supersedes) ?? null) : null,
+        supersededBySlug: r.supersededBy ? (slugById.get(r.supersededBy) ?? null) : null,
+        relatedTasks: r.relatedTasks,
+        topics: r.topics,
+    }));
+    const edges = deriveWikilinkEdges(slugged);
+    const nowIso = new Date().toISOString();
+    // The node:sqlite driver is synchronous — drizzle's transaction callback must
+    // be sync (an async body throws a DrizzleTypeError at build time).
+    db.transaction((tx) => {
+        tx.delete(docsWikilinks).run();
+        if (edges.length === 0)
+            return;
+        // Batch insert; INSERT OR IGNORE semantics via onConflictDoNothing keep the
+        // composite PK idempotent even if deriveWikilinkEdges emitted a duplicate.
+        tx.insert(docsWikilinks)
+            .values(edges.map((e) => ({
+            fromSlug: e.fromSlug,
+            toSlug: e.toSlug,
+            relation: e.relation,
+            toIsTask: e.toIsTask,
+            derivedAt: nowIso,
+        })))
+            .onConflictDoNothing()
+            .run();
+    });
+    const byRelation = {
+        supersedes: 0,
+        'superseded-by': 0,
+        'related-task': 0,
+        topic: 0,
+    };
+    for (const e of edges)
+        byRelation[e.relation] += 1;
+    return { edgeCount: edges.length, byRelation };
+}
+/**
+ * Pure derivation: turn slugged `attachments` rows into the full edge set.
+ *
+ * Exposed for unit testing the derivation rules without a database. The output
+ * is deduplicated on the (`fromSlug`, `toSlug`, `relation`) composite key.
+ *
+ * @param rows - Slugged attachment rows with their provenance columns.
+ * @returns The derived wikilink edges.
+ * @task T11826
+ */
+export function deriveWikilinkEdges(rows) {
+    const seen = new Set();
+    const out = [];
+    const push = (fromSlug, toSlug, relation, toIsTask) => {
+        const key = `${fromSlug}|${toSlug}|${relation}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        out.push({ fromSlug, toSlug, relation, toIsTask });
+    };
+    // Topic membership index: topic slug → set of doc slugs carrying it.
+    const topicMembers = new Map();
+    for (const row of rows) {
+        // supersedes / superseded-by — doc→doc.
+        if (row.supersedesSlug)
+            push(row.slug, row.supersedesSlug, 'supersedes', false);
+        if (row.supersededBySlug)
+            push(row.slug, row.supersededBySlug, 'superseded-by', false);
+        // related-task — doc→T####.
+        for (const taskId of parseStringArray(row.relatedTasks)) {
+            if (/^T\d+$/.test(taskId))
+                push(row.slug, taskId, 'related-task', true);
+        }
+        // Accumulate topic membership for the symmetric pass below.
+        for (const topic of parseStringArray(row.topics)) {
+            let members = topicMembers.get(topic);
+            if (!members) {
+                members = new Set();
+                topicMembers.set(topic, members);
+            }
+            members.add(row.slug);
+        }
+    }
+    // topic — symmetric doc↔doc edges for co-members of any topic.
+    for (const members of topicMembers.values()) {
+        const slugs = [...members];
+        for (let i = 0; i < slugs.length; i++) {
+            for (let j = 0; j < slugs.length; j++) {
+                if (i === j)
+                    continue;
+                push(slugs[i], slugs[j], 'topic', false);
+            }
+        }
+    }
+    return out;
+}
+/**
+ * Read all wikilink edges incident to a doc slug — **bidirectional** by default.
+ *
+ * Returns both outbound edges (`from_slug = slug`) and inbound backlinks
+ * (`to_slug = slug`). This is the query the Obsidian plugin (T11827) renders to
+ * show a doc's neighborhood, and what `cleo docs graph` hydrates for persisted
+ * backlinks.
+ *
+ * @param slug - The doc slug to fetch edges for.
+ * @param opts.direction - `'both'` (default), `'out'`, or `'in'`.
+ * @param opts.projectRoot - Project root override.
+ * @returns The incident edges.
+ * @task T11826
+ */
+export async function getDocsWikilinks(slug, opts = {}) {
+    const direction = opts.direction ?? 'both';
+    const projectRoot = opts.projectRoot ?? getProjectRoot();
+    const db = await getDb(projectRoot);
+    const predicate = direction === 'out'
+        ? eq(docsWikilinks.fromSlug, slug)
+        : direction === 'in'
+            ? eq(docsWikilinks.toSlug, slug)
+            : or(eq(docsWikilinks.fromSlug, slug), eq(docsWikilinks.toSlug, slug));
+    const rows = await db.select().from(docsWikilinks).where(predicate).all();
+    return rows.map((r) => ({
+        fromSlug: r.fromSlug,
+        toSlug: r.toSlug,
+        relation: r.relation,
+        toIsTask: r.toIsTask,
+    }));
+}
+/**
+ * Parse a JSON-array-of-strings column, tolerating null / malformed values.
+ *
+ * @internal
+ */
+function parseStringArray(raw) {
+    if (!raw)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter((v) => typeof v === 'string' && v.length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=wikilinks.js.map