@inharness-ai/claude4spec 1.0.0

package/dist/server/db/migrations/021_plans_n1.sql

@@ -0,0 +1,36 @@
+-- Etap: M10 — przejscie z 1:1 (plan.thread_id UNIQUE) na N:1 (chat_thread.plan_id).
+-- Spec: .claude/skills/specyfikacja/db/db-m10-plans.md, db/db-m05-chat.md (sekcja planrefn1).
+--
+-- Strategia: table-recreate dla `plan` (drop kolumny thread_id + dodanie title) z deferred FK,
+-- bo `chat_thread.plan_id` (nowa kolumna) trzyma FK na `plan.id`.
+
+PRAGMA defer_foreign_keys = ON;
+
+-- 1) Nowe kolumny w chat_thread.
+ALTER TABLE chat_thread ADD COLUMN plan_id INTEGER REFERENCES plan(id) ON DELETE SET NULL;
+ALTER TABLE chat_thread ADD COLUMN last_seen_plan_version INTEGER;
+
+-- 2) Backfill ze starej kolumny plan.thread_id (1:1) na chat_thread.plan_id.
+UPDATE chat_thread
+   SET plan_id = (SELECT id FROM plan WHERE plan.thread_id = chat_thread.id),
+       last_seen_plan_version = (SELECT current_version FROM plan WHERE plan.thread_id = chat_thread.id);
+
+-- 3) Recreate `plan` bez thread_id, z opcjonalnym title.
+--    Kolumna title jest NULL po INSERT — fixup w kodzie wyciaga pierwszy `# Heading` z content.
+CREATE TABLE plan_new (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  title TEXT,
+  content TEXT NOT NULL DEFAULT '',
+  current_version INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+INSERT INTO plan_new (id, content, current_version, created_at, updated_at)
+  SELECT id, content, current_version, created_at, updated_at FROM plan;
+
+DROP TABLE plan;
+ALTER TABLE plan_new RENAME TO plan;
+
+-- 4) Indeks dla "Otworz ostatni watek tego planu" + threadCount per plan.
+CREATE INDEX idx_chat_thread_plan ON chat_thread(plan_id);

package/dist/server/db/migrations/022_brief_chat_columns.sql

@@ -0,0 +1,23 @@
+-- M21 Briefs: generic context discriminator + brief file pointer on chat_thread.
+-- Spec: db/db-m05-chat.md (sekcja m21chatcols), modules/m21-briefs.md, modules/m05-chat-agent.md (sekcja m05ctxreg).
+--
+-- context_type: 'chat' (default) | 'brief'. Determines system prompt skill,
+-- MCP tools whitelist (routes/chat.ts) i UI chrome (overlay vs brief-detail).
+-- Forward-compat: trzeci typ wymaga CHECK migration + registry entry.
+--
+-- brief_path: relative path to brief file under briefsDir (np. v0-3-to-v0-4.md).
+-- Brak FK bo brief zyje na FS (plik moze byc usuniety/przeniesiony przez usera).
+-- Invariant L2: context_type='brief' ⇒ brief_path IS NOT NULL ∧ plik istnieje
+-- przy tworzeniu watku (egzekwowane w warstwie aplikacji, nie w DB).
+
+ALTER TABLE chat_thread
+  ADD COLUMN context_type TEXT NOT NULL DEFAULT 'chat'
+  CHECK (context_type IN ('chat','brief'));
+
+ALTER TABLE chat_thread
+  ADD COLUMN brief_path TEXT;
+
+-- Indeks pod query "open threads for this brief" (GET /api/briefs/:path/threads)
+-- oraz threadCount na liscie /briefs. Partial index — pomija watki 'chat'.
+CREATE INDEX IF NOT EXISTS idx_chat_thread_brief_path
+  ON chat_thread(brief_path) WHERE brief_path IS NOT NULL;

package/dist/server/db/migrations/023_page_version_kind.sql

@@ -0,0 +1,26 @@
+-- Wykluczenie briefów z release snapshot. Wcześniej `page_version` nie miała
+-- dyskryminatora między stronami (pagesDir) a briefami (briefsDir) — `path`
+-- jest relatywny do swojego rootDir, więc filtr po prefixie nie działa.
+-- Spec: modules/m17-snapshots-releases.md (m17top001), modules/m21-briefs.md (m21db0001).
+
+ALTER TABLE page_version
+  ADD COLUMN kind TEXT NOT NULL DEFAULT 'page'
+  CHECK (kind IN ('page','brief'));
+
+-- Backfill po frontmatter.type w polu data (JSON snapshot).
+-- Tombstone'y op='delete' z pustym frontmatter zostają jako 'page' — akceptowalne
+-- (rzadkie, łatwe do ręcznej korekty jeśli wystąpią; brief 'delete' tombstone
+--  ma frontmatter z poprzedniej wersji bo synthesizeDeleteFromLastVersion
+--  klonuje ostatni snapshot).
+UPDATE page_version
+SET kind = 'brief'
+WHERE json_extract(data, '$.frontmatter.type') = 'brief';
+
+-- Odpięcie historycznych briefów od release'ów do których wpadły przed fixem.
+-- Nowy kontrakt: żaden release nie zawiera briefów (ani nowy, ani legacy).
+UPDATE page_version
+SET release_id = NULL
+WHERE kind = 'brief';
+
+CREATE INDEX IF NOT EXISTS idx_page_version_kind_release
+  ON page_version (kind, release_id);

package/dist/server/db/migrations/024_chat_context_size.sql

@@ -0,0 +1,10 @@
+-- Etap: agent-chat 0.1.1 — `contextSize` jako oddzielna metryka od `usage` (billing).
+-- `usage` (last_usage_json / usage_json) sumuje się przez tury — nie nadaje się na
+-- pasek "X / 200k" (przekraczał 100% w dłuższych rozmowach). `contextSize` to
+-- okno kontekstu po tej turze (last-turn, NIE sumować). Wire-event `result`
+-- z agent-adapters niesie je obok `usage`; tu trzymamy je per-tura i thread-level.
+--
+-- Backward-compat: stare wątki mają NULL — klient liczy fallback z usage.
+
+ALTER TABLE chat_thread  ADD COLUMN last_context_size INTEGER;
+ALTER TABLE chat_message ADD COLUMN context_size INTEGER;

package/dist/server/db/migrations/025_ac.sql

@@ -0,0 +1,19 @@
+-- v0.1.13 — Acceptance Criteria entity (M11)
+-- AC = first-class entity. Polymorphic entity_tag (001_endpoint.sql) i polymorphic
+-- entity_version (017_entity_version_m17.sql) automatycznie obsluguja
+-- entity_type='ac' bez dodatkowych zmian.
+
+CREATE TABLE IF NOT EXISTS ac (
+  id           INTEGER PRIMARY KEY AUTOINCREMENT,
+  slug         TEXT NOT NULL UNIQUE,
+  text         TEXT NOT NULL,
+  kind         TEXT NOT NULL DEFAULT 'requirement',
+  status       TEXT NOT NULL DEFAULT 'active',
+  verifies     TEXT NOT NULL DEFAULT '[]',
+  description  TEXT,
+  created_at   TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at   TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_ac_status ON ac(status);
+CREATE INDEX IF NOT EXISTS idx_ac_kind   ON ac(kind);

package/dist/server/db/migrations/026_ac_seed.sql

@@ -0,0 +1,75 @@
+-- v0.1.15 — 14 startowych Acceptance Criteria pokrywających M06 / M19 / M20.
+-- Każdy AC seedowany pod istniejące moduły: kind='requirement', status='active',
+-- plus tag mNN wiążący z modułem.
+-- Idempotent — INSERT OR IGNORE na (ac.slug UNIQUE) i (entity_tag UNIQUE).
+
+INSERT OR IGNORE INTO tag (slug, name) VALUES ('m06', 'm06');
+INSERT OR IGNORE INTO tag (slug, name) VALUES ('m19', 'm19');
+INSERT OR IGNORE INTO tag (slug, name) VALUES ('m20', 'm20');
+
+INSERT OR IGNORE INTO ac (slug, text, kind, status, verifies) VALUES
+  ('m06-anchor-length-contract',
+   'Anchory generowane przez section indexer mają dokładnie 8 znaków z alfabetu [a-z0-9]; walidacja/parsing akceptuje 6-12 znaków (manualne semantyczne anchory).',
+   'requirement', 'active', '[]'),
+  ('m06-section-indexer-auto-injection',
+   'Section indexer auto-injectuje anchor comments do nagłówków bez anchora; nie modyfikuje nagłówków, które już mają anchor.',
+   'requirement', 'active', '[]'),
+  ('m06-section-ref-chip-rendering',
+   '<section_ref anchor="X"/> renderuje się jako klikalny chip z heading text i page path; broken anchor (brak w section_index) renderuje broken chip.',
+   'requirement', 'active', '[]'),
+
+  ('m19-find-references-include-tag-matches',
+   'find_references(type, slug, { includeTagMatches: true }) zwraca dynamic refs ze stron z <tagged_list/> i <tagged_list_mixed/>, których atrybut tags przecina się z tagami encji; pole via[] obecne tylko dla dynamic rows.',
+   'requirement', 'active', '[]'),
+  ('m19-tagged-list-type-mismatch-skipped',
+   '<tagged_list type="X"/> z type różnym od typu szukanej encji jest pomijany w find_references({includeTagMatches:true}) — embed nie pokazałby tej encji.',
+   'requirement', 'active', '[]'),
+  ('m19-untagged-entity-no-op',
+   'Encja bez żadnego tagu w find_references({includeTagMatches:true}) → no-op (intersect zawsze pusty, brak dynamic rows w output).',
+   'requirement', 'active', '[]'),
+
+  ('m20-three-editor-contexts',
+   'EditorFactory wspiera trzy konteksty edytora: page (pełny markdown), description (markdown bez task lists), plan (markdown + XML chips); każdy z osobnym mention sources rejestrem.',
+   'requirement', 'active', '[]'),
+  ('m20-editor-factory-create',
+   'EditorFactory.create(contextId, initial) zwraca tiptap Editor zhydratowany dla danego kontekstu z initial content jako markdown string.',
+   'requirement', 'active', '[]'),
+  ('m20-markdown-it-xml-rules',
+   'markdown-it ma custom rules xml_inline, xml_block, xml_block_content rozpoznające 6 nazw XML reference tags (inline_mention, single_element, element_list, tagged_list, tagged_list_mixed, section_ref).',
+   'requirement', 'active', '[]'),
+  ('m20-xml-inline-dispatch-six-tags',
+   'xml_inline markdown-it rule dispatcher mapuje wszystkie 6 tag names na odpowiednie tiptap node types (5 z M19 + section_ref jako extension reference).',
+   'requirement', 'active', '[]'),
+  ('m20-gfm-task-lists',
+   'Edytor wspiera GFM task lists (- [x] checked / - [ ] unchecked) z renderowaniem checkboxów i toggle przy kliknięciu.',
+   'requirement', 'active', '[]'),
+  ('m20-five-generic-m19-nodes',
+   'Pięć generycznych tiptap nodów M19 (InlineMentionNode, SingleElementNode, ElementListNode, TaggedListNode, TaggedListMixedNode) deleguje render do clientPluginHost.getEntity(type).renderChip / renderCard.',
+   'requirement', 'active', '[]'),
+  ('m20-outline-gutter',
+   'Outline gutter pokazuje listę sekcji strony z anchor + heading text; klik w pozycji scrolluje edytor do anchor i podświetla wiersz.',
+   'requirement', 'active', '[]'),
+  ('m20-ws-query-keys',
+   'WebSocket events broadcastują invalidation keys mapujące na konkretne tanstack-query query keys; useChat / useEntityList nasłuchują i invalidują tylko zmienione zapytania.',
+   'requirement', 'active', '[]');
+
+-- Wiązanie AC z tagami modułów. SELECT-based pattern — działa bez względu na
+-- to, czy INSERT OR IGNORE wyżej wstawił nowy wiersz czy ominął istniejący.
+INSERT OR IGNORE INTO entity_tag (entity_type, entity_id, tag_id)
+SELECT 'ac', a.id, t.id FROM ac a, tag t
+WHERE (a.slug, t.slug) IN (
+  ('m06-anchor-length-contract', 'm06'),
+  ('m06-section-indexer-auto-injection', 'm06'),
+  ('m06-section-ref-chip-rendering', 'm06'),
+  ('m19-find-references-include-tag-matches', 'm19'),
+  ('m19-tagged-list-type-mismatch-skipped', 'm19'),
+  ('m19-untagged-entity-no-op', 'm19'),
+  ('m20-three-editor-contexts', 'm20'),
+  ('m20-editor-factory-create', 'm20'),
+  ('m20-markdown-it-xml-rules', 'm20'),
+  ('m20-xml-inline-dispatch-six-tags', 'm20'),
+  ('m20-gfm-task-lists', 'm20'),
+  ('m20-five-generic-m19-nodes', 'm20'),
+  ('m20-outline-gutter', 'm20'),
+  ('m20-ws-query-keys', 'm20')
+);

package/dist/server/db/migrations/027_page_version_change_summary.sql

@@ -0,0 +1,10 @@
+-- M21 Briefs (v0.1.21+) — kolumna `change_summary` na page_version.
+-- Brief pkt 11 "For implementers": każda mutacja musi się przelać przez
+-- page_version z `changeSummary` (dla PUT pochodzi z body, dla PATCH
+-- implemented toggle wystarczy 'set implemented=<bool>').
+--
+-- Wcześniej DTO `BriefContentUpdateRequest.changeSummary` był przyjmowany
+-- przez route, ale gubiony w service layer — brak miejsca w DB do zapisu.
+
+ALTER TABLE page_version
+  ADD COLUMN change_summary TEXT NULL;

package/dist/server/db/readonly.d.ts

@@ -0,0 +1,12 @@
+import Database from 'better-sqlite3';
+export declare class ReadonlyDbError extends Error {
+    code: 'PROJECT_NOT_FOUND' | 'SCHEMA_OUT_OF_DATE';
+    hint?: string | undefined;
+    constructor(code: 'PROJECT_NOT_FOUND' | 'SCHEMA_OUT_OF_DATE', message: string, hint?: string | undefined);
+}
+export interface OpenDbReadonlyResult {
+    handle: Database.Database;
+    dbPath: string;
+    close: () => void;
+}
+export declare function openDbReadonly(projectDir: string): OpenDbReadonlyResult;

package/dist/server/db/readonly.js

@@ -0,0 +1,32 @@
+import Database from 'better-sqlite3';
+import fs from 'node:fs';
+import path from 'node:path';
+export class ReadonlyDbError extends Error {
+    code;
+    hint;
+    constructor(code, message, hint) {
+        super(message);
+        this.code = code;
+        this.hint = hint;
+        this.name = 'ReadonlyDbError';
+    }
+}
+export function openDbReadonly(projectDir) {
+    const dbPath = path.join(projectDir, '.claude4spec', 'db.sqlite');
+    if (!fs.existsSync(dbPath)) {
+        throw new ReadonlyDbError('PROJECT_NOT_FOUND', `no claude4spec project found at ${projectDir}`, 'run `npx claude4spec` first or pass `--project <path>`');
+    }
+    let handle;
+    try {
+        handle = new Database(dbPath, { readonly: true, fileMustExist: true });
+    }
+    catch (err) {
+        throw new ReadonlyDbError('PROJECT_NOT_FOUND', `failed to open ${dbPath}: ${err.message}`);
+    }
+    return {
+        handle,
+        dbPath,
+        close: () => handle.close(),
+    };
+}
+//# sourceMappingURL=readonly.js.map

package/dist/server/db/readonly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readonly.js","sourceRoot":"","sources":["../../../src/server/db/readonly.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACrB;IAA0E;IAA7F,YAAmB,IAAgD,EAAE,OAAe,EAAS,IAAa;QACxG,KAAK,CAAC,OAAO,CAAC,CAAC;QADE,SAAI,GAAJ,IAAI,CAA4C;QAA0B,SAAI,GAAJ,IAAI,CAAS;QAExG,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAQD,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;IAClE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,eAAe,CACvB,mBAAmB,EACnB,mCAAmC,UAAU,EAAE,EAC/C,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,IAAI,MAAyB,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,eAAe,CACvB,mBAAmB,EACnB,kBAAkB,MAAM,KAAM,GAAa,CAAC,OAAO,EAAE,CACtD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM;QACN,MAAM;QACN,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;KAC5B,CAAC;AACJ,CAAC"}

package/dist/server/domain/raw-entity-reader.d.ts

@@ -0,0 +1,76 @@
+import type Database from 'better-sqlite3';
+export type RawEntityType = 'endpoint' | 'dto' | 'database-table' | 'ui-view' | 'ac';
+export interface RawEntity {
+    type: RawEntityType;
+    id: number;
+    slug: string;
+    data: Record<string, unknown>;
+    tags: string[];
+}
+export interface RawSection {
+    anchor: string;
+    pagePath: string;
+    headingPath: string;
+    headingSlug: string;
+    headingText: string;
+    headingLevel: number;
+    lineStart: number;
+    lineEnd: number;
+}
+/** Per-entity-type counts. Keys are plugin types; absent type = 0. */
+export type RawTagCounts = Record<string, number>;
+export interface RawTag {
+    slug: string;
+    name: string;
+    color: string | null;
+    description: string | null;
+    counts: RawTagCounts;
+}
+export interface FindByTagParams {
+    type?: RawEntityType;
+    tags: string[];
+    filter: 'and' | 'or';
+}
+export interface SectionEntityRef {
+    anchor: string;
+    pagePath: string;
+    headingText: string;
+    relation: string;
+}
+export declare function isRawEntityType(value: string): value is RawEntityType;
+export declare class RawEntityReader {
+    private db;
+    constructor(db: Database.Database);
+    getEntity(type: RawEntityType, slug: string): RawEntity | null;
+    getEntityById(type: RawEntityType, id: number): RawEntity | null;
+    getEntities(type: RawEntityType, slugs: string[]): {
+        items: RawEntity[];
+        missing: string[];
+    };
+    findByTag(params: FindByTagParams): RawEntity[];
+    private findByTagForType;
+    getSection(anchor: string): RawSection | null;
+    listTypes(): RawEntityType[];
+    listSlugs(type: RawEntityType): string[];
+    listTags(): RawTag[];
+    /** Returns sections that referenced the given entity (populated by section-indexer). */
+    findSectionReferences(type: RawEntityType, entityId: number): SectionEntityRef[];
+    /** Endpoint-DTO links (denormalised). */
+    findEndpointDtos(endpointId: number): Array<{
+        dtoSlug: string;
+        dtoName: string;
+        relation: string;
+        statusCode: number | null;
+    }>;
+    /** Reverse: endpoints linked to a DTO. */
+    findDtoEndpoints(dtoId: number): Array<{
+        endpointSlug: string;
+        method: string;
+        path: string;
+        relation: string;
+        statusCode: number | null;
+    }>;
+    private hydrate;
+    private hydrateSection;
+    private getEntityTagSlugs;
+}

package/dist/server/domain/raw-entity-reader.js

@@ -0,0 +1,240 @@
+const ENTITY_TABLES = {
+    endpoint: 'endpoint',
+    dto: 'dto',
+    'database-table': 'database_table',
+    'ui-view': 'ui_view',
+    ac: 'ac',
+};
+const ALL_ENTITY_TYPES = ['endpoint', 'dto', 'database-table', 'ui-view', 'ac'];
+export function isRawEntityType(value) {
+    return (value === 'endpoint' ||
+        value === 'dto' ||
+        value === 'database-table' ||
+        value === 'ui-view' ||
+        value === 'ac');
+}
+export class RawEntityReader {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    getEntity(type, slug) {
+        const table = ENTITY_TABLES[type];
+        const row = this.db.prepare(`SELECT * FROM ${table} WHERE slug = ?`).get(slug);
+        if (!row)
+            return null;
+        return this.hydrate(type, row);
+    }
+    getEntityById(type, id) {
+        const table = ENTITY_TABLES[type];
+        const row = this.db.prepare(`SELECT * FROM ${table} WHERE id = ?`).get(id);
+        if (!row)
+            return null;
+        return this.hydrate(type, row);
+    }
+    getEntities(type, slugs) {
+        const items = [];
+        const missing = [];
+        for (const slug of slugs) {
+            const entity = this.getEntity(type, slug);
+            if (entity)
+                items.push(entity);
+            else
+                missing.push(slug);
+        }
+        return { items, missing };
+    }
+    findByTag(params) {
+        const tagSlugs = params.tags.filter(Boolean);
+        if (!tagSlugs.length)
+            return [];
+        const types = params.type ? [params.type] : ALL_ENTITY_TYPES;
+        const out = [];
+        for (const type of types) {
+            out.push(...this.findByTagForType(type, tagSlugs, params.filter));
+        }
+        return out;
+    }
+    findByTagForType(type, tagSlugs, filter) {
+        const table = ENTITY_TABLES[type];
+        const placeholders = tagSlugs.map(() => '?').join(',');
+        let sql;
+        const params = [];
+        if (filter === 'and') {
+            sql = `
+        SELECT e.* FROM ${table} e
+         WHERE e.id IN (
+          SELECT et.entity_id
+            FROM entity_tag et
+            JOIN tag t ON t.id = et.tag_id
+           WHERE et.entity_type = ? AND t.slug IN (${placeholders})
+        GROUP BY et.entity_id
+          HAVING COUNT(DISTINCT t.slug) = ?
+         )
+         ORDER BY e.slug
+      `;
+            params.push(type, ...tagSlugs, tagSlugs.length);
+        }
+        else {
+            sql = `
+        SELECT e.* FROM ${table} e
+         WHERE e.id IN (
+          SELECT et.entity_id FROM entity_tag et
+            JOIN tag t ON t.id = et.tag_id
+           WHERE et.entity_type = ? AND t.slug IN (${placeholders})
+         )
+         ORDER BY e.slug
+      `;
+            params.push(type, ...tagSlugs);
+        }
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map((row) => this.hydrate(type, row));
+    }
+    getSection(anchor) {
+        const row = this.db
+            .prepare('SELECT * FROM section_index WHERE anchor = ?')
+            .get(anchor);
+        if (!row)
+            return null;
+        return this.hydrateSection(row);
+    }
+    listTypes() {
+        return [...ALL_ENTITY_TYPES];
+    }
+    listSlugs(type) {
+        const table = ENTITY_TABLES[type];
+        const rows = this.db
+            .prepare(`SELECT slug FROM ${table} ORDER BY slug`)
+            .all();
+        return rows.map((r) => r.slug);
+    }
+    listTags() {
+        const rows = this.db.prepare(`SELECT * FROM tag ORDER BY name`).all();
+        const countRows = this.db
+            .prepare(`SELECT t.slug AS slug, et.entity_type AS entity_type, COUNT(*) AS c
+           FROM entity_tag et
+           JOIN tag t ON t.id = et.tag_id
+         GROUP BY t.slug, et.entity_type`)
+            .all();
+        const countMap = new Map();
+        for (const row of countRows) {
+            const entry = countMap.get(row.slug) ?? {};
+            entry[row.entity_type] = row.c;
+            countMap.set(row.slug, entry);
+        }
+        return rows.map((r) => ({
+            slug: r.slug,
+            name: r.name,
+            color: r.color,
+            description: r.description,
+            counts: countMap.get(r.slug) ?? { endpoint: 0, dto: 0, 'database-table': 0, 'ui-view': 0, ac: 0 },
+        }));
+    }
+    /** Returns sections that referenced the given entity (populated by section-indexer). */
+    findSectionReferences(type, entityId) {
+        const rows = this.db
+            .prepare(`SELECT sel.anchor AS anchor, sel.relation AS relation,
+                si.page_path AS page_path, si.heading_text AS heading_text
+           FROM section_entity_link sel
+           JOIN section_index si ON si.anchor = sel.anchor
+          WHERE sel.entity_type = ? AND sel.entity_id = ?
+          ORDER BY si.page_path, si.line_start`)
+            .all(type, entityId);
+        return rows.map((r) => ({
+            anchor: r.anchor,
+            pagePath: r.page_path,
+            headingText: r.heading_text,
+            relation: r.relation,
+        }));
+    }
+    /** Endpoint-DTO links (denormalised). */
+    findEndpointDtos(endpointId) {
+        const rows = this.db
+            .prepare(`SELECT d.slug AS dto_slug, d.name AS dto_name,
+                ed.relation AS relation, ed.status_code AS status_code
+           FROM endpoint_dto ed
+           JOIN dto d ON d.id = ed.dto_id
+          WHERE ed.endpoint_id = ?
+          ORDER BY ed.relation, ed.status_code, d.name`)
+            .all(endpointId);
+        return rows.map((r) => ({
+            dtoSlug: r.dto_slug,
+            dtoName: r.dto_name,
+            relation: r.relation,
+            statusCode: r.status_code,
+        }));
+    }
+    /** Reverse: endpoints linked to a DTO. */
+    findDtoEndpoints(dtoId) {
+        const rows = this.db
+            .prepare(`SELECT e.slug AS slug, e.method AS method, e.path AS path,
+                ed.relation AS relation, ed.status_code AS status_code
+           FROM endpoint_dto ed
+           JOIN endpoint e ON e.id = ed.endpoint_id
+          WHERE ed.dto_id = ?
+          ORDER BY ed.relation, ed.status_code, e.path`)
+            .all(dtoId);
+        return rows.map((r) => ({
+            endpointSlug: r.slug,
+            method: r.method,
+            path: r.path,
+            relation: r.relation,
+            statusCode: r.status_code,
+        }));
+    }
+    hydrate(type, row) {
+        const id = row.id;
+        const slug = row.slug;
+        const tags = this.getEntityTagSlugs(type, id);
+        const data = {};
+        for (const [key, value] of Object.entries(row)) {
+            if (key === 'id' || key === 'created_at' || key === 'updated_at')
+                continue;
+            data[key] = value;
+        }
+        // Generic JSON column hydration: any string column whose value parses as
+        // a JSON array/object gets decoded. Replaces per-entity-type branches
+        // (dto.fields, dto.examples, database-table.columns/indexes, ui-view.params).
+        for (const [key, value] of Object.entries(data)) {
+            if (typeof value !== 'string')
+                continue;
+            const trimmed = value.trimStart();
+            if (!trimmed.startsWith('[') && !trimmed.startsWith('{'))
+                continue;
+            data[key] = safeJsonArray(value);
+        }
+        return { type, id, slug, data, tags };
+    }
+    hydrateSection(row) {
+        return {
+            anchor: row.anchor,
+            pagePath: row.page_path,
+            headingPath: row.heading_path,
+            headingSlug: row.heading_slug,
+            headingText: row.heading_text,
+            headingLevel: row.heading_level,
+            lineStart: row.line_start,
+            lineEnd: row.line_end,
+        };
+    }
+    getEntityTagSlugs(type, entityId) {
+        const rows = this.db
+            .prepare(`SELECT t.slug AS slug
+           FROM entity_tag et
+           JOIN tag t ON t.id = et.tag_id
+          WHERE et.entity_type = ? AND et.entity_id = ?
+          ORDER BY t.name`)
+            .all(type, entityId);
+        return rows.map((r) => r.slug);
+    }
+}
+function safeJsonArray(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=raw-entity-reader.js.map

package/dist/server/domain/raw-entity-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-entity-reader.js","sourceRoot":"","sources":["../../../src/server/domain/raw-entity-reader.ts"],"names":[],"mappings":"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"}

package/dist/server/entities/ac/mcp-server.d.ts

@@ -0,0 +1,10 @@
+import { type McpServerInstance } from '@inharness-ai/agent-adapters';
+import type { AcService } from './services.js';
+import type { ReferencesService } from '../../services/references.js';
+import type { WsGateway } from '../../ws/gateway.js';
+export interface AcToolsDeps {
+    acService: AcService;
+    referencesService: ReferencesService;
+    ws: WsGateway;
+}
+export declare function createAcToolsServer(deps: AcToolsDeps): McpServerInstance;