@cleocode/core 2026.6.7 → 2026.6.9

package/dist/store/schema/attachments.d.ts

@@ -295,6 +295,22 @@ export declare const attachments: import("drizzle-orm/sqlite-core").SQLiteTableW
             identity: undefined;
             generated: undefined;
         }, {}>;
+        displayAlias: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "attachments";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
     };
     dialect: "sqlite";
 }>;
@@ -391,8 +407,141 @@ export declare const attachmentRefs: import("drizzle-orm/sqlite-core").SQLiteTab
     };
     dialect: "sqlite";
 }>;
+/**
+ * Allowed relations for a `docs_wikilinks` edge.
+ *
+ * A wikilink is a DERIVED, slug-addressed edge between two docs (or a doc and a
+ * task) reconstructed from the authoritative provenance columns on
+ * `attachments` — there is no hand-authored edge here. The relation enumerates
+ * which source column produced the edge:
+ *
+ *   - `supersedes`     — `attachments.supersedes` (newer → older)
+ *   - `superseded-by`  — `attachments.superseded_by` (older → newer)
+ *   - `related-task`   — `attachments.related_tasks` JSON membership (doc → T####)
+ *   - `topic`          — `attachments.topics` JSON co-membership (doc ↔ doc sharing a topic)
+ *
+ * Kept slug-primary so the edge table is Obsidian-grade (vault links are
+ * slug-addressed) and survives attachment-id churn across versions.
+ *
+ * @task T11826 (Epic T11781 / Saga T11778)
+ */
+export declare const DOCS_WIKILINK_RELATIONS: readonly ["supersedes", "superseded-by", "related-task", "topic"];
+/** Discriminated union of `docs_wikilinks.relation` values. */
+export type DocsWikilinkRelation = (typeof DOCS_WIKILINK_RELATIONS)[number];
+/**
+ * `docs_wikilinks` — DERIVED, slug-addressed edge table for the docs graph.
+ *
+ * Per the ratified Docs-SSoT model (saga T11778): `cleo.db` is the SOLE doc
+ * authority, and `docs_wikilinks` is a *minimal edge table derived from*
+ * `supersedes` + `relatedTasks` + `topics` on `attachments`. It is NOT an
+ * authoritative input surface — it is rebuilt idempotently from the provenance
+ * columns by {@link import('../../docs/wikilinks.js').rebuildDocsWikilinks}.
+ *
+ * The table makes the bidirectional backlink graph queryable in O(edges)
+ * without recomputing the BFS, which is what the Obsidian plugin (T11827)
+ * renders. `cleo docs graph` (T10164) continues to compute the provenance BFS
+ * but hydrates persisted backlinks from this table when present.
+ *
+ * Edges are slug-primary; `to_slug` carries a doc slug for `topic` /
+ * `supersedes` / `superseded-by` edges and a `T####` task id for `related-task`
+ * edges (`to_is_task = 1`). No markdown body `[[link]]` parsing is performed
+ * (AC4) — the edges derive purely from structured provenance columns.
+ *
+ * @task T11826 (Epic T11781 / Saga T11778)
+ */
+export declare const docsWikilinks: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "docs_wikilinks";
+    schema: undefined;
+    columns: {
+        fromSlug: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "docs_wikilinks";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        toSlug: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "docs_wikilinks";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        relation: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "docs_wikilinks";
+            dataType: "string enum";
+            data: "topic" | "supersedes" | "superseded-by" | "related-task";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["supersedes", "superseded-by", "related-task", "topic"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        toIsTask: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "docs_wikilinks";
+            dataType: "boolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        derivedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "docs_wikilinks";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+    };
+    dialect: "sqlite";
+}>;
 export type AttachmentRow = typeof attachments.$inferSelect;
 export type NewAttachmentRow = typeof attachments.$inferInsert;
 export type AttachmentRefRow = typeof attachmentRefs.$inferSelect;
 export type NewAttachmentRefRow = typeof attachmentRefs.$inferInsert;
+/** Row type for `docs_wikilinks` SELECT queries. */
+export type DocsWikilinkRow = typeof docsWikilinks.$inferSelect;
+/** Row type for `docs_wikilinks` INSERT operations. */
+export type NewDocsWikilinkRow = typeof docsWikilinks.$inferInsert;
 //# sourceMappingURL=attachments.d.ts.map

package/dist/store/schema/attachments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../../src/store/schema/attachments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,gFAOzB,CAAC;AAEX;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,6BAA6B,oFAOhC,CAAC;AAEX,0DAA0D;AAC1D,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+HvB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB1B,CAAC;AAIF,MAAM,MAAM,aAAa,GAAG,OAAO,WAAW,CAAC,YAAY,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,OAAO,WAAW,CAAC,YAAY,CAAC;AAC/D,MAAM,MAAM,gBAAgB,GAAG,OAAO,cAAc,CAAC,YAAY,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,OAAO,cAAc,CAAC,YAAY,CAAC"}
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../../src/store/schema/attachments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,gFAOzB,CAAC;AAEX;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,6BAA6B,oFAOhC,CAAC;AAEX,0DAA0D;AAC1D,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6JvB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB1B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,uBAAuB,mEAK1B,CAAC;AAEX,+DAA+D;AAC/D,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBzB,CAAC;AAIF,MAAM,MAAM,aAAa,GAAG,OAAO,WAAW,CAAC,YAAY,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,OAAO,WAAW,CAAC,YAAY,CAAC;AAC/D,MAAM,MAAM,gBAAgB,GAAG,OAAO,cAAc,CAAC,YAAY,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,OAAO,cAAc,CAAC,YAAY,CAAC;AACrE,oDAAoD;AACpD,MAAM,MAAM,eAAe,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC;AAChE,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC"}

package/dist/store/schema/attachments.js

@@ -4,6 +4,7 @@
  * @epic T760
  * @task T796
  */
+import { sql } from 'drizzle-orm';
 import { index, integer, primaryKey, sqliteTable, text, } from 'drizzle-orm/sqlite-core';
 /**
  * Allowed owner-entity types for `attachment_refs.owner_type`.
@@ -167,10 +168,40 @@ export const attachments = sqliteTable('attachments', {
      * @task T11181 (Epic T10518 / Saga T10516)
      */
     docVersion: integer('doc_version').notNull().default(1),
+    /**
+     * Optional explicit display-alias NUMBER for the doc, DECOUPLED from the
+     * slug string.
+     *
+     * Background (T11875 · ADR reconcile T11676): under the ratified
+     * slug-primary model the kebab `slug` is the canonical handle and the
+     * displayed number (e.g. ADR "051") is a DISPLAY ALIAS only. Previously
+     * that number was DERIVED by parsing the digits out of the slug
+     * (`adr-051-*` → 051), so three distinct ADRs that all slug as `adr-051-*`
+     * collided on the rendered number with no way to disambiguate.
+     *
+     * When non-null, this column is the authoritative display number and is
+     * PREFERRED over the slug-derived number by
+     * {@link import('../../docs/numbering.js').resolveDisplayNumber}. When null,
+     * rendering falls back to the slug-derived number unchanged — so docs that
+     * never had an alias assigned keep their historical behaviour.
+     *
+     * Uniqueness among `type='adr'` docs is enforced at the dispatch layer (not
+     * via a SQL UNIQUE constraint) by
+     * {@link import('../../docs/display-alias.js').setDisplayAlias}, mirroring
+     * the dispatch-validated discipline used for `lifecycle_status` /
+     * `relation` so future taxonomy changes never require a schema migration.
+     *
+     * @task T11875 (Epic T11781 / Saga T11778)
+     */
+    displayAlias: integer('display_alias'),
 }, (table) => [
     index('idx_attachments_sha256').on(table.sha256),
     index('idx_attachments_lifecycle_status').on(table.lifecycleStatus),
     index('idx_attachments_supersedes').on(table.supersedes),
+    // Speeds the per-type uniqueness scan in `setDisplayAlias` (T11875). Not a
+    // UNIQUE index — uniqueness is scoped to `type='adr'` and enforced at the
+    // dispatch layer so non-adr kinds may reuse numbers freely.
+    index('idx_attachments_display_alias').on(table.displayAlias),
 ]);
 /**
  * Ref-counted junction table linking attachments to owner entities.
@@ -196,4 +227,66 @@ export const attachmentRefs = sqliteTable('attachment_refs', {
     index('idx_attachment_refs_attachment_id').on(table.attachmentId),
     index('idx_attachment_refs_owner').on(table.ownerType, table.ownerId),
 ]);
+/**
+ * Allowed relations for a `docs_wikilinks` edge.
+ *
+ * A wikilink is a DERIVED, slug-addressed edge between two docs (or a doc and a
+ * task) reconstructed from the authoritative provenance columns on
+ * `attachments` — there is no hand-authored edge here. The relation enumerates
+ * which source column produced the edge:
+ *
+ *   - `supersedes`     — `attachments.supersedes` (newer → older)
+ *   - `superseded-by`  — `attachments.superseded_by` (older → newer)
+ *   - `related-task`   — `attachments.related_tasks` JSON membership (doc → T####)
+ *   - `topic`          — `attachments.topics` JSON co-membership (doc ↔ doc sharing a topic)
+ *
+ * Kept slug-primary so the edge table is Obsidian-grade (vault links are
+ * slug-addressed) and survives attachment-id churn across versions.
+ *
+ * @task T11826 (Epic T11781 / Saga T11778)
+ */
+export const DOCS_WIKILINK_RELATIONS = [
+    'supersedes',
+    'superseded-by',
+    'related-task',
+    'topic',
+];
+/**
+ * `docs_wikilinks` — DERIVED, slug-addressed edge table for the docs graph.
+ *
+ * Per the ratified Docs-SSoT model (saga T11778): `cleo.db` is the SOLE doc
+ * authority, and `docs_wikilinks` is a *minimal edge table derived from*
+ * `supersedes` + `relatedTasks` + `topics` on `attachments`. It is NOT an
+ * authoritative input surface — it is rebuilt idempotently from the provenance
+ * columns by {@link import('../../docs/wikilinks.js').rebuildDocsWikilinks}.
+ *
+ * The table makes the bidirectional backlink graph queryable in O(edges)
+ * without recomputing the BFS, which is what the Obsidian plugin (T11827)
+ * renders. `cleo docs graph` (T10164) continues to compute the provenance BFS
+ * but hydrates persisted backlinks from this table when present.
+ *
+ * Edges are slug-primary; `to_slug` carries a doc slug for `topic` /
+ * `supersedes` / `superseded-by` edges and a `T####` task id for `related-task`
+ * edges (`to_is_task = 1`). No markdown body `[[link]]` parsing is performed
+ * (AC4) — the edges derive purely from structured provenance columns.
+ *
+ * @task T11826 (Epic T11781 / Saga T11778)
+ */
+export const docsWikilinks = sqliteTable('docs_wikilinks', {
+    /** Source doc slug (→ `attachments.slug`). Always a doc. */
+    fromSlug: text('from_slug').notNull(),
+    /** Target slug — a doc slug, or a `T####` task id when `toIsTask = 1`. */
+    toSlug: text('to_slug').notNull(),
+    /** Which provenance column produced this edge — dispatch-validated, no SQL CHECK. */
+    relation: text('relation', { enum: DOCS_WIKILINK_RELATIONS }).notNull(),
+    /** 1 when `to_slug` is a task id (`related-task` edges); 0 for doc→doc edges. */
+    toIsTask: integer('to_is_task', { mode: 'boolean' }).notNull().default(false),
+    /** ISO-8601 UTC instant this edge was last (re)derived. */
+    derivedAt: text('derived_at').notNull().default(sql `(datetime('now'))`),
+}, (table) => [
+    primaryKey({ columns: [table.fromSlug, table.toSlug, table.relation] }),
+    index('idx_docs_wikilinks_from').on(table.fromSlug),
+    index('idx_docs_wikilinks_to').on(table.toSlug),
+    index('idx_docs_wikilinks_relation').on(table.relation),
+]);
 //# sourceMappingURL=attachments.js.map

package/dist/store/schema/attachments.js.map

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

package/migrations/drizzle-tasks/20260605000001_t11826-docs-wikilinks/migration.sql

@@ -0,0 +1,110 @@
+-- T11826 — `docs_wikilinks`: a DERIVED, slug-addressed edge table for the docs
+-- provenance graph (ratified Docs-SSoT model, saga T11778).
+--
+-- Background:
+--   `cleo.db` is the SOLE doc authority. `docs_wikilinks` is NOT an
+--   authoritative input surface — it is a minimal edge table DERIVED from the
+--   three provenance columns already on `attachments`:
+--     - `supersedes`     → newer→older edges (+ reverse `superseded-by`)
+--     - `related_tasks`  → doc→T#### edges (JSON array, exploded via json_each)
+--     - `topics`         → doc↔doc co-membership edges (shared topic slug)
+--   It makes the bidirectional backlink graph queryable in O(edges) for the
+--   Obsidian plugin (T11827) without recomputing the BFS. The derivation is
+--   rebuilt idempotently by `rebuildDocsWikilinks` (docs/wikilinks.ts); this
+--   migration creates the table and seeds the initial backfill.
+--
+-- Edges are slug-primary (vault links are slug-addressed and survive
+-- attachment-id churn across doc versions). `to_is_task = 1` marks a
+-- `related-task` edge whose `to_slug` is a `T####` id rather than a doc slug.
+-- No markdown body `[[link]]` parsing is performed (AC4) — edges derive purely
+-- from structured provenance columns.
+--
+-- Changes (idempotent — safe to re-run):
+--   1. CREATE TABLE docs_wikilinks(from_slug, to_slug, relation, to_is_task,
+--      derived_at) with a composite PK + supporting indices.
+--   2. Backfill `supersedes` + `superseded-by` doc→doc edges by joining
+--      `attachments` to itself on the supersedes/superseded_by FK and resolving
+--      both endpoints to their slugs.
+--   3. Backfill `related-task` doc→T#### edges by exploding `related_tasks`
+--      JSON arrays via json_each.
+--   4. Backfill `topic` doc↔doc edges: any two distinct slugged docs that share
+--      a topic slug (json_each over `topics`) get a symmetric pair of edges.
+--   INSERT OR IGNORE coalesces re-runs against the composite primary key.
+--
+-- DEPENDS ON: 20260524000000_t10158-docs-provenance-columns (adds supersedes /
+--             superseded_by / topics / related_tasks to `attachments`)
+-- SAFE FOR:   SQLite 3.35+ (CREATE TABLE IF NOT EXISTS + INSERT OR IGNORE)
+--
+-- @task T11826
+-- @epic T11781 (E3-OBSIDIAN-INTEGRATION)
+-- @saga T11778 (SG-DOCS-SSOT-VAULT)
+
+CREATE TABLE IF NOT EXISTS `docs_wikilinks` (
+  `from_slug` text NOT NULL,
+  `to_slug` text NOT NULL,
+  `relation` text NOT NULL,
+  `to_is_task` integer NOT NULL DEFAULT 0,
+  `derived_at` text NOT NULL DEFAULT (datetime('now')),
+  CONSTRAINT `docs_wikilinks_pk` PRIMARY KEY(`from_slug`, `to_slug`, `relation`)
+);
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_docs_wikilinks_from` ON `docs_wikilinks` (`from_slug`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_docs_wikilinks_to` ON `docs_wikilinks` (`to_slug`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_docs_wikilinks_relation` ON `docs_wikilinks` (`relation`);
+--> statement-breakpoint
+
+-- (2) supersedes: newer (a) → older (a.supersedes) doc→doc edge.
+INSERT OR IGNORE INTO `docs_wikilinks` (`from_slug`, `to_slug`, `relation`, `to_is_task`)
+SELECT a.`slug`, b.`slug`, 'supersedes', 0
+FROM `attachments` AS a
+JOIN `attachments` AS b ON b.`id` = a.`supersedes`
+WHERE a.`slug` IS NOT NULL
+  AND b.`slug` IS NOT NULL
+  AND a.`supersedes` IS NOT NULL;
+--> statement-breakpoint
+
+-- (2b) superseded-by: older (a) → newer (a.superseded_by) doc→doc reverse edge.
+INSERT OR IGNORE INTO `docs_wikilinks` (`from_slug`, `to_slug`, `relation`, `to_is_task`)
+SELECT a.`slug`, b.`slug`, 'superseded-by', 0
+FROM `attachments` AS a
+JOIN `attachments` AS b ON b.`id` = a.`superseded_by`
+WHERE a.`slug` IS NOT NULL
+  AND b.`slug` IS NOT NULL
+  AND a.`superseded_by` IS NOT NULL;
+--> statement-breakpoint
+
+-- (3) related-task: doc → T#### edge from the related_tasks JSON array.
+INSERT OR IGNORE INTO `docs_wikilinks` (`from_slug`, `to_slug`, `relation`, `to_is_task`)
+SELECT a.`slug`, je.`value`, 'related-task', 1
+FROM `attachments` AS a,
+     json_each(a.`related_tasks`) AS je
+WHERE a.`slug` IS NOT NULL
+  AND a.`related_tasks` IS NOT NULL
+  AND json_valid(a.`related_tasks`)
+  AND json_type(a.`related_tasks`) = 'array'
+  AND je.`value` IS NOT NULL;
+--> statement-breakpoint
+
+-- (4) topic: symmetric doc↔doc edge for any two distinct slugged docs sharing a
+-- topic slug. The self-join over json_each(topics) produces both directions
+-- because (a,b) and (b,a) are both yielded when a.slug <> b.slug.
+INSERT OR IGNORE INTO `docs_wikilinks` (`from_slug`, `to_slug`, `relation`, `to_is_task`)
+SELECT a.`slug`, b.`slug`, 'topic', 0
+FROM `attachments` AS a,
+     json_each(a.`topics`) AS ta,
+     `attachments` AS b,
+     json_each(b.`topics`) AS tb
+WHERE a.`slug` IS NOT NULL
+  AND b.`slug` IS NOT NULL
+  AND a.`slug` <> b.`slug`
+  AND a.`topics` IS NOT NULL
+  AND b.`topics` IS NOT NULL
+  AND json_valid(a.`topics`)
+  AND json_valid(b.`topics`)
+  AND json_type(a.`topics`) = 'array'
+  AND json_type(b.`topics`) = 'array'
+  AND ta.`value` = tb.`value`
+  AND ta.`value` IS NOT NULL;

package/migrations/drizzle-tasks/20260606000001_t11875-attachments-display-alias/migration.sql

@@ -0,0 +1,46 @@
+-- T11875 — give ADR display-aliases real storage DECOUPLED from the slug.
+--
+-- Background (ADR reconcile T11676 · ratified slug-primary model, saga T11778):
+--   Under the slug-primary model the kebab `slug` is the canonical handle and
+--   the displayed number (e.g. ADR "051") is a DISPLAY ALIAS only. Until now
+--   that number was DERIVED by parsing the digits out of the slug string
+--   (`adr-051-*` → 051), so three DISTINCT ADRs that all slug as `adr-051-*`
+--   (override-patterns ≠ programmatic-gate-integrity ≠ worktree-extension)
+--   rendered the same "051" with no way to disambiguate. The collision cannot
+--   be resolved by renumbering a slug (that would break the canonical handle).
+--
+--   This migration adds a real, nullable `display_alias` INTEGER column to
+--   `attachments` so a doc can carry an explicit display number independent of
+--   its slug. `numbering.ts::resolveDisplayNumber` PREFERS the stored alias
+--   when present and falls back to the slug-derived number when null — so docs
+--   that never get an alias keep their historical rendering byte-for-byte.
+--
+--   Uniqueness among `type='adr'` docs is enforced at the DISPATCH layer
+--   (`display-alias.ts::setDisplayAlias`), NOT via a SQL UNIQUE constraint:
+--   the constraint is scoped to one kind, and dispatch-validation matches the
+--   discipline already used for `lifecycle_status` / `docs_wikilinks.relation`
+--   so future taxonomy changes never require another schema migration.
+--
+-- Additive + forward-only: the new column is nullable, so SQLite ALTER TABLE
+-- ADD COLUMN does NOT rewrite the table and existing rows pass through with
+-- NULL (i.e. "no alias — derive from slug"). No data migration of legacy rows
+-- is required; the `cleo docs set-alias` verb populates aliases going forward.
+--
+-- Changes (idempotent — safe to re-run):
+--   1. ALTER TABLE attachments ADD COLUMN display_alias integer  (nullable).
+--   2. CREATE INDEX idx_attachments_display_alias — speeds the per-type
+--      uniqueness scan performed by setDisplayAlias.
+--
+-- DEPENDS ON: 20260416000000_t796-attachments (creates `attachments`)
+-- SAFE FOR:   SQLite 3.35+ (ALTER TABLE ADD COLUMN nullable is atomic)
+--
+-- @task T11875
+-- @epic T11781 (E3-OBSIDIAN-INTEGRATION)
+-- @saga T11778 (SG-DOCS-SSOT-VAULT)
+-- @closes (display-alias half of) T11676 ADR reconcile plan
+
+ALTER TABLE `attachments` ADD COLUMN `display_alias` integer;
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_attachments_display_alias`
+  ON `attachments` (`display_alias`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/core",
-  "version": "2026.6.7",
+  "version": "2026.6.9",
   "description": "CLEO core business logic kernel — tasks, sessions, memory, orchestration, lifecycle, with bundled SQLite store",
   "type": "module",
   "main": "./dist/index.js",
@@ -429,16 +429,16 @@
     "write-file-atomic": "^7.0.1",
     "yaml": "^2.8.3",
     "zod": "^4.3.6",
-    "@cleocode/adapters": "2026.6.7",
-    "@cleocode/caamp": "2026.6.7",
-    "@cleocode/agents": "2026.6.7",
-    "@cleocode/contracts": "2026.6.7",
-    "@cleocode/git-shim": "2026.6.7",
-    "@cleocode/lafs": "2026.6.7",
-    "@cleocode/nexus": "2026.6.7",
-    "@cleocode/paths": "2026.6.7",
-    "@cleocode/skills": "2026.6.7",
-    "@cleocode/worktree": "2026.6.7"
+    "@cleocode/adapters": "2026.6.9",
+    "@cleocode/agents": "2026.6.9",
+    "@cleocode/caamp": "2026.6.9",
+    "@cleocode/contracts": "2026.6.9",
+    "@cleocode/git-shim": "2026.6.9",
+    "@cleocode/lafs": "2026.6.9",
+    "@cleocode/paths": "2026.6.9",
+    "@cleocode/nexus": "2026.6.9",
+    "@cleocode/skills": "2026.6.9",
+    "@cleocode/worktree": "2026.6.9"
   },
   "engines": {
     "node": ">=24.16.0"
@@ -472,7 +472,7 @@
   },
   "optionalDependencies": {
     "llmtxt": "^2026.5.15",
-    "@cleocode/studio": "^2026.6.7"
+    "@cleocode/studio": "^2026.6.9"
   },
   "scripts": {
     "build": "tsc",