@cleocode/core 2026.6.8 → 2026.6.10

package/dist/store/schema/attachments.js

@@ -168,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.

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/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.8",
+  "version": "2026.6.10",
   "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.8",
-    "@cleocode/agents": "2026.6.8",
-    "@cleocode/caamp": "2026.6.8",
-    "@cleocode/git-shim": "2026.6.8",
-    "@cleocode/contracts": "2026.6.8",
-    "@cleocode/lafs": "2026.6.8",
-    "@cleocode/paths": "2026.6.8",
-    "@cleocode/nexus": "2026.6.8",
-    "@cleocode/worktree": "2026.6.8",
-    "@cleocode/skills": "2026.6.8"
+    "@cleocode/adapters": "2026.6.10",
+    "@cleocode/agents": "2026.6.10",
+    "@cleocode/contracts": "2026.6.10",
+    "@cleocode/git-shim": "2026.6.10",
+    "@cleocode/caamp": "2026.6.10",
+    "@cleocode/lafs": "2026.6.10",
+    "@cleocode/nexus": "2026.6.10",
+    "@cleocode/paths": "2026.6.10",
+    "@cleocode/skills": "2026.6.10",
+    "@cleocode/worktree": "2026.6.10"
   },
   "engines": {
     "node": ">=24.16.0"
@@ -472,7 +472,7 @@
   },
   "optionalDependencies": {
     "llmtxt": "^2026.5.15",
-    "@cleocode/studio": "^2026.6.8"
+    "@cleocode/studio": "^2026.6.10"
   },
   "scripts": {
     "build": "tsc",