@inharness-ai/claude4spec 1.0.0

package/dist/server/core/plugin-host/types.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Server-side plugin manifest. Extends the shared EntityModuleManifest with
+ * server-only slots (serializer, services, mcpServer, routes, systemPrompt).
+ *
+ * `serializer` and `systemPrompt` are required; backend slots
+ * (services, mcpServer, routes, migrations) are optional and filled per
+ * entity in their vertical slice plugin.ts.
+ */
+import type { Database } from 'better-sqlite3';
+import type { Application, Router } from 'express';
+import type { McpServerInstance } from '@inharness-ai/agent-adapters';
+import type { EntityModuleManifest, PluginActivationState, SystemPromptContribution } from '../../../shared/plugin-host/types.js';
+import type { EntityDiff, EntitySerializer, RestoreContext, RestoreResult, SerializeContext, SnapshotData } from '../../serialization/types.js';
+import type { TagsService } from '../../services/tags.js';
+import type { VersionService } from '../../services/versions.js';
+import type { ReferencesService } from '../../services/references.js';
+import type { WsGateway } from '../../ws/gateway.js';
+export type SqlMigration = {
+    /** Per-plugin sequential version. Starts at 1 (post-baseline). */
+    version: number;
+    /** Short identifier, e.g. "add_summary_column". */
+    name: string;
+    /** Idempotent SQL — must tolerate replay. */
+    up: string;
+};
+export interface RouteRegistration {
+    /** Mount prefix, e.g. "/api/endpoints". */
+    prefix: string;
+    /** Express subrouter — handler chain owned by the plugin. */
+    router: Router;
+}
+/**
+ * Mount-time context passed to each plugin's `backend.mount(ctx)`. Carries
+ * cross-cutting deps + helpers for registering routes / MCP servers / id
+ * resolvers without per-plugin special-casing in index.ts.
+ */
+export interface MountContext {
+    app: Application;
+    db: Database;
+    ws: WsGateway;
+    tagsService: TagsService;
+    versionService: VersionService;
+    referencesService: ReferencesService;
+    registerMcpServer(name: string, server: McpServerInstance): void;
+    setIdResolver(type: string, fn: (slug: string) => number | null): void;
+    /**
+     * M17: register the entity's L2 service with the host so cross-cutting
+     * consumers (release restore) can drive idempotent UPSERT through normal
+     * write-API. Stored untyped — callers cast on retrieval.
+     */
+    registerEntityService(type: string, service: unknown): void;
+}
+/**
+ * Per-plugin mount hook. Constructs the entity service from cross-cutting
+ * deps + db, mounts its Express subrouter under `/api${pathPrefix}`, registers
+ * the MCP server as `${type}-tools`, and wires the id resolver.
+ */
+export type PluginMountFn = (ctx: MountContext) => void;
+export interface BackendModule extends EntityModuleManifest {
+    /** L9 — JSON serialization for external consumers (CLI, MCP, ...). */
+    serializer: EntitySerializer<unknown>;
+    /** M05 — system prompt contribution composed by buildSystemPrompt. */
+    systemPrompt: SystemPromptContribution;
+    /**
+     * Resolve an entity row id from its slug. Used by section-indexer and
+     * reference-tools to translate page-level mentions into FK-eligible ids
+     * without knowing the entity table directly.
+     */
+    getIdBySlug?: (slug: string) => number | null;
+    /**
+     * L1–L4 backend slots. The `mount` hook is the single entry point used by
+     * `pluginHost.mountBackend(ctx)` — it owns service construction, route
+     * mounting, MCP registration, and id resolver wiring.
+     */
+    backend?: {
+        migrations?: SqlMigration[];
+        mount?: PluginMountFn;
+    };
+}
+export interface PluginHost {
+    /** Register a plugin manifest. Idempotent on `module.type`. */
+    registerBackendModule(module: BackendModule): void;
+    /**
+     * Apply config.entities whitelist; updates active/inactive/unknown sets.
+     * Pass undefined / null = all available are active (v1 backward compat).
+     */
+    consolidate(activeWhitelist: string[] | null | undefined): void;
+    /** All registered modules, regardless of activation. */
+    listAvailable(): BackendModule[];
+    /** Active modules only (filtered by `consolidate`). */
+    listEntities(): BackendModule[];
+    /** Lookup by type — returns null for inactive or unknown. */
+    getEntity(type: string): BackendModule | null;
+    /** Lookup including inactive — used for broken-chip categorisation. */
+    getAvailable(type: string): BackendModule | null;
+    isActive(type: string): boolean;
+    /** Activation snapshot — input for GET /api/_meta/entities. */
+    state(): PluginActivationState;
+    /**
+     * Mount every active backend module into the supplied Express app + the
+     * host-internal MCP registry. Iterates `listEntities()` and invokes each
+     * plugin's `backend.mount(ctx)`. Inactive plugins are skipped — no routes,
+     * no MCP server, no id resolver registered.
+     */
+    mountBackend(ctx: MountContext): void;
+    /** Register an MCP server instance under a unique name (e.g. "dto-tools"). */
+    registerMcpServer(name: string, server: McpServerInstance): void;
+    /** Lookup a previously-registered MCP server by name (e.g. "dto-tools"). */
+    getMcpServer(name: string): McpServerInstance | null;
+    /** All registered MCP server names — used by chat to wire the adapter. */
+    listMcpServers(): Array<{
+        name: string;
+        server: McpServerInstance;
+    }>;
+    /**
+     * Run each active plugin's `systemPrompt.countStat.sqlQuery` against the db
+     * and return the results indexed by `module.type`. Used by the chat handler
+     * to populate `SystemPromptInput.entityCounts`.
+     */
+    computeEntityCounts(db: Database): Record<string, number>;
+    /**
+     * Runtime id resolver registry. Populated by index.ts after services are
+     * instantiated; consumed by section-indexer and reference-tools to map
+     * `(type, slug) → entity_id` without per-type switches.
+     */
+    setIdResolver(type: string, fn: (slug: string) => number | null): void;
+    resolveEntityId(type: string, slug: string): number | null;
+    /** Convenience: true if `(type, slug)` resolves to a row id via setIdResolver. */
+    entityExists(type: string, slug: string): boolean;
+    /**
+     * M17 entity service registry. Plugins register their L2 service during
+     * mount; cross-cutting consumers (releaseService restore) retrieve them by
+     * type. Untyped surface — caller casts to the concrete service type.
+     */
+    registerEntityService(type: string, service: unknown): void;
+    getEntityService(type: string): unknown;
+    /** Plugin-owned snapshot. Throws SnapshotNotImplementedError if slot absent. */
+    snapshot(type: string, entity: unknown, ctx: SerializeContext): SnapshotData;
+    /** Plugin-owned restore (UPSERT through normal write-API). */
+    restore(type: string, data: SnapshotData, ctx: RestoreContext): RestoreResult;
+    /** Plugin-owned diff with default deep-diff fallback. */
+    diff(type: string, a: SnapshotData, b: SnapshotData, slug: string): EntityDiff;
+}

package/dist/server/core/plugin-host/types.js

@@ -0,0 +1,10 @@
+/**
+ * Server-side plugin manifest. Extends the shared EntityModuleManifest with
+ * server-only slots (serializer, services, mcpServer, routes, systemPrompt).
+ *
+ * `serializer` and `systemPrompt` are required; backend slots
+ * (services, mcpServer, routes, migrations) are optional and filled per
+ * entity in their vertical slice plugin.ts.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/core/plugin-host/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/server/core/plugin-host/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/server/db/fixups/backfill-plan-titles.d.ts

@@ -0,0 +1,2 @@
+import type Database from 'better-sqlite3';
+export declare function backfillPlanTitles(db: Database.Database): number;

package/dist/server/db/fixups/backfill-plan-titles.js

@@ -0,0 +1,22 @@
+const FIRST_H1_RE = /^#\s+(.+?)\s*$/m;
+export function backfillPlanTitles(db) {
+    const rows = db
+        .prepare(`SELECT id, content FROM plan WHERE title IS NULL`)
+        .all();
+    if (rows.length === 0)
+        return 0;
+    const update = db.prepare(`UPDATE plan SET title = ? WHERE id = ?`);
+    let updated = 0;
+    for (const row of rows) {
+        const m = row.content.match(FIRST_H1_RE);
+        if (!m)
+            continue;
+        const title = m[1].trim();
+        if (!title)
+            continue;
+        update.run(title, row.id);
+        updated++;
+    }
+    return updated;
+}
+//# sourceMappingURL=backfill-plan-titles.js.map

package/dist/server/db/fixups/backfill-plan-titles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill-plan-titles.js","sourceRoot":"","sources":["../../../../src/server/db/fixups/backfill-plan-titles.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAEtC,MAAM,UAAU,kBAAkB,CAAC,EAAqB;IACtD,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CAAC,kDAAkD,CAAC;SAC3D,GAAG,EAA4C,CAAC;IAEnD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEhC,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;IACpE,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACzC,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,6 @@
+import Database from 'better-sqlite3';
+export interface Db {
+    handle: Database.Database;
+    close: () => void;
+}
+export declare function openDb(cwd: string): Db;

package/dist/server/db/index.js

@@ -0,0 +1,26 @@
+import Database from 'better-sqlite3';
+import fs from 'node:fs';
+import path from 'node:path';
+import { runMigrations } from './migrate.js';
+import { backfillPlanTitles } from './fixups/backfill-plan-titles.js';
+export function openDb(cwd) {
+    const dir = path.join(cwd, '.claude4spec');
+    fs.mkdirSync(dir, { recursive: true });
+    const dbPath = path.join(dir, 'db.sqlite');
+    const handle = new Database(dbPath);
+    handle.pragma('journal_mode = WAL');
+    handle.pragma('foreign_keys = ON');
+    const applied = runMigrations(handle);
+    if (applied.length) {
+        console.log(`  migrations applied: ${applied.join(', ')}`);
+    }
+    const titlesBackfilled = backfillPlanTitles(handle);
+    if (titlesBackfilled > 0) {
+        console.log(`  plan titles backfilled: ${titlesBackfilled}`);
+    }
+    return {
+        handle,
+        close: () => handle.close(),
+    };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAOtE,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC3C,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACpC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAEnC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,yBAAyB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,6BAA6B,gBAAgB,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO;QACL,MAAM;QACN,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;KAC5B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,2 @@
+import Database from 'better-sqlite3';
+export declare function runMigrations(db: Database.Database): string[];

package/dist/server/db/migrate.js

@@ -0,0 +1,33 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const MIGRATIONS_DIR = path.join(__dirname, 'migrations');
+export function runMigrations(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS schema_migrations (
+      version TEXT PRIMARY KEY,
+      applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+  `);
+    const applied = new Set(db.prepare('SELECT version FROM schema_migrations').all().map((r) => r.version));
+    const files = fs
+        .readdirSync(MIGRATIONS_DIR)
+        .filter((f) => f.endsWith('.sql'))
+        .sort();
+    const newlyApplied = [];
+    for (const file of files) {
+        const version = file.replace(/\.sql$/, '');
+        if (applied.has(version))
+            continue;
+        const sql = fs.readFileSync(path.join(MIGRATIONS_DIR, file), 'utf-8');
+        const tx = db.transaction(() => {
+            db.exec(sql);
+            db.prepare('INSERT INTO schema_migrations (version) VALUES (?)').run(version);
+        });
+        tx();
+        newlyApplied.push(version);
+    }
+    return newlyApplied;
+}
+//# sourceMappingURL=migrate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/server/db/migrate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAE1D,MAAM,UAAU,aAAa,CAAC,EAAqB;IACjD,EAAE,CAAC,IAAI,CAAC;;;;;GAKP,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAyB,CAAC,OAAO,CAAC,CACzG,CAAC;IAEF,MAAM,KAAK,GAAG,EAAE;SACb,WAAW,CAAC,cAAc,CAAC;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;SACjC,IAAI,EAAE,CAAC;IAEV,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QACnC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACtE,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAC7B,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACb,EAAE,CAAC,OAAO,CAAC,oDAAoD,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;QACH,EAAE,EAAE,CAAC;QACL,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/server/db/migrations/000_init.sql

@@ -0,0 +1,7 @@
+-- Etap 1 base migration. Intentionally empty of entity tables —
+-- schema_migrations row gets created to prove the runner works.
+-- Entity tables (endpoint, dto, ...) land in later migrations.
+
+CREATE TABLE IF NOT EXISTS _init_marker (
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);

package/dist/server/db/migrations/001_endpoint.sql

@@ -0,0 +1,51 @@
+-- Etap 2: M03 endpoint + versioning + L6 tags core tables.
+-- dto + endpoint_dto tables land with Etap 3 (M04).
+
+CREATE TABLE endpoint (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  slug TEXT UNIQUE NOT NULL,
+  method TEXT NOT NULL,
+  path TEXT NOT NULL,
+  summary TEXT NOT NULL DEFAULT '',
+  description TEXT,
+  request_body TEXT,
+  response_body TEXT,
+  status_codes TEXT,
+  module TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE INDEX idx_endpoint_module ON endpoint(module);
+
+CREATE TABLE entity_version (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  entity_type TEXT NOT NULL,
+  entity_id INTEGER NOT NULL,
+  version INTEGER NOT NULL,
+  data TEXT NOT NULL,
+  changed_by TEXT NOT NULL,
+  change_summary TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  UNIQUE(entity_type, entity_id, version)
+);
+CREATE INDEX idx_ev_entity ON entity_version(entity_type, entity_id);
+
+CREATE TABLE tag (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  slug TEXT UNIQUE NOT NULL,
+  name TEXT NOT NULL,
+  color TEXT,
+  description TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE entity_tag (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  entity_type TEXT NOT NULL,
+  entity_id INTEGER NOT NULL,
+  tag_id INTEGER NOT NULL REFERENCES tag(id) ON DELETE CASCADE,
+  UNIQUE(entity_type, entity_id, tag_id)
+);
+CREATE INDEX idx_entity_tag_tag_id ON entity_tag(tag_id);
+CREATE INDEX idx_entity_tag_entity ON entity_tag(entity_type, entity_id);

package/dist/server/db/migrations/002_dto.sql

@@ -0,0 +1,23 @@
+-- Etap 3: M04 DTO table + endpoint_dto junction.
+
+CREATE TABLE dto (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  slug TEXT UNIQUE NOT NULL,
+  name TEXT NOT NULL,
+  description TEXT,
+  fields TEXT NOT NULL DEFAULT '[]',
+  module TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE INDEX idx_dto_module ON dto(module);
+
+CREATE TABLE endpoint_dto (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  endpoint_id INTEGER NOT NULL REFERENCES endpoint(id) ON DELETE CASCADE,
+  dto_id INTEGER NOT NULL REFERENCES dto(id) ON DELETE CASCADE,
+  relation TEXT NOT NULL,
+  UNIQUE(endpoint_id, dto_id, relation)
+);
+CREATE INDEX idx_endpoint_dto_endpoint ON endpoint_dto(endpoint_id);
+CREATE INDEX idx_endpoint_dto_dto ON endpoint_dto(dto_id);

package/dist/server/db/migrations/003_drop_endpoint_body.sql

@@ -0,0 +1,5 @@
+-- Etap 3 (iteracja 2): usuwamy freeform request_body/response_body z endpoint.
+-- Kontrakt danych zawsze przez endpoint_dto (request/response/error).
+
+ALTER TABLE endpoint DROP COLUMN request_body;
+ALTER TABLE endpoint DROP COLUMN response_body;

package/dist/server/db/migrations/004_drop_module_and_status.sql

@@ -0,0 +1,31 @@
+-- Etap 3 (iteracja 3): klasyfikacja encji wylacznie przez tagi, status HTTP przez endpoint_dto.
+-- Usuwamy kolumny `module` (endpoint, dto) oraz `status_codes` (endpoint).
+-- Dodajemy `status_code INTEGER NULL` do endpoint_dto + odbudowujemy UNIQUE index.
+
+DROP INDEX IF EXISTS idx_endpoint_module;
+DROP INDEX IF EXISTS idx_dto_module;
+DROP INDEX IF EXISTS idx_endpoint_dto_endpoint;
+DROP INDEX IF EXISTS idx_endpoint_dto_dto;
+
+ALTER TABLE endpoint DROP COLUMN module;
+ALTER TABLE endpoint DROP COLUMN status_codes;
+ALTER TABLE dto DROP COLUMN module;
+
+-- SQLite nie wspiera DROP CONSTRAINT; rebuild tabeli endpoint_dto z nowym UNIQUE.
+CREATE TABLE endpoint_dto_new (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  endpoint_id INTEGER NOT NULL REFERENCES endpoint(id) ON DELETE CASCADE,
+  dto_id INTEGER NOT NULL REFERENCES dto(id) ON DELETE CASCADE,
+  relation TEXT NOT NULL,
+  status_code INTEGER,
+  UNIQUE(endpoint_id, dto_id, relation, status_code)
+);
+
+INSERT INTO endpoint_dto_new (id, endpoint_id, dto_id, relation, status_code)
+  SELECT id, endpoint_id, dto_id, relation, NULL FROM endpoint_dto;
+
+DROP TABLE endpoint_dto;
+ALTER TABLE endpoint_dto_new RENAME TO endpoint_dto;
+
+CREATE INDEX idx_endpoint_dto_endpoint ON endpoint_dto(endpoint_id);
+CREATE INDEX idx_endpoint_dto_dto ON endpoint_dto(dto_id);

package/dist/server/db/migrations/005_chat.sql

@@ -0,0 +1,23 @@
+-- Etap 4: M05 chat & agent — thread persistence.
+-- Spec: .claude/skills/specyfikacja/db/db-m05-chat.md
+
+CREATE TABLE chat_thread (
+  id TEXT PRIMARY KEY NOT NULL,
+  title TEXT,
+  last_session_id TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE chat_message (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  thread_id TEXT NOT NULL REFERENCES chat_thread(id) ON DELETE CASCADE,
+  role TEXT NOT NULL,
+  content TEXT NOT NULL,
+  tool_name TEXT,
+  tool_id TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX idx_cm_thread ON chat_message(thread_id);
+CREATE INDEX idx_cm_tool ON chat_message(tool_id);

package/dist/server/db/migrations/006_database_table.sql

@@ -0,0 +1,10 @@
+CREATE TABLE database_table (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  slug TEXT UNIQUE NOT NULL,
+  name TEXT NOT NULL,
+  description TEXT,
+  columns TEXT NOT NULL DEFAULT '[]',
+  indexes TEXT NOT NULL DEFAULT '[]',
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);

package/dist/server/db/migrations/007_sections.sql

@@ -0,0 +1,30 @@
+CREATE TABLE section_index (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  anchor TEXT UNIQUE NOT NULL,
+  page_path TEXT NOT NULL,
+  heading_path TEXT NOT NULL,
+  heading_slug TEXT NOT NULL,
+  heading_level INTEGER NOT NULL,
+  heading_text TEXT NOT NULL,
+  content_hash TEXT NOT NULL,
+  line_start INTEGER NOT NULL,
+  line_end INTEGER NOT NULL,
+  paragraph_count INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX idx_si_page ON section_index(page_path);
+CREATE INDEX idx_si_hash ON section_index(content_hash);
+
+CREATE TABLE section_entity_link (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  anchor TEXT NOT NULL REFERENCES section_index(anchor) ON DELETE CASCADE,
+  entity_type TEXT NOT NULL,
+  entity_id INTEGER NOT NULL,
+  relation TEXT NOT NULL DEFAULT 'describes',
+  UNIQUE(anchor, entity_type, entity_id)
+);
+
+CREATE INDEX idx_sel_anchor ON section_entity_link(anchor);
+CREATE INDEX idx_sel_entity ON section_entity_link(entity_type, entity_id);

package/dist/server/db/migrations/008_subagent_task.sql

@@ -0,0 +1,20 @@
+-- M05 extension: subagent task persistence (reconstruction po reload).
+-- Spec: .claude/skills/specyfikacja/db/db-m05-chat.md
+
+ALTER TABLE chat_message ADD COLUMN subagent_task_id TEXT;
+
+CREATE INDEX idx_cm_subagent_task ON chat_message(subagent_task_id);
+
+CREATE TABLE chat_subagent_task (
+  thread_id TEXT NOT NULL REFERENCES chat_thread(id) ON DELETE CASCADE,
+  task_id TEXT NOT NULL,
+  tool_use_id TEXT,
+  description TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'running',
+  summary TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  PRIMARY KEY (thread_id, task_id)
+);
+
+CREATE INDEX idx_cst_thread ON chat_subagent_task(thread_id);

package/dist/server/db/migrations/009_chat_todo_snapshot.sql

@@ -0,0 +1,4 @@
+-- M05 extension: persistent snapshot of the main-agent TODO list per thread.
+-- Populated from the `todo_list_updated` runtime event (isSubagent=false only).
+
+ALTER TABLE chat_thread ADD COLUMN current_todo_items TEXT;

package/dist/server/db/migrations/010_chat_plan_mode.sql

@@ -0,0 +1,5 @@
+-- Etap: M05 chat — plan mode per thread + per-message snapshot.
+-- Spec: .claude/skills/specyfikacja/db/db-m05-chat.md
+
+ALTER TABLE chat_thread ADD COLUMN plan_mode INTEGER NOT NULL DEFAULT 0;
+ALTER TABLE chat_message ADD COLUMN plan_mode INTEGER NOT NULL DEFAULT 0;

package/dist/server/db/migrations/011_chat_initial_system_prompt.sql

@@ -0,0 +1,4 @@
+-- Etap: M05 chat — snapshot pierwszego system promptu na thread (debug/audyt).
+-- Spec: .claude/skills/specyfikacja/db/db-m05-chat.md (sekcja "System prompt snapshot")
+
+ALTER TABLE chat_thread ADD COLUMN initial_system_prompt TEXT;

package/dist/server/db/migrations/012_chat_message_status.sql

@@ -0,0 +1,5 @@
+-- Etap: M05 chat — lifecycle wiersza chat_message (streaming vs complete).
+-- Uzywane do wykrycia orphan tool_use po crashu serwera i auto-resume po F5.
+-- Spec: .claude/skills/specyfikacja/db/db-m05-chat.md (sekcja "Planowane: kolumna chat_message.status")
+
+ALTER TABLE chat_message ADD COLUMN status TEXT NOT NULL DEFAULT 'complete';

package/dist/server/db/migrations/013_chat_usage_snapshot.sql

@@ -0,0 +1,7 @@
+-- Etap: M05 chat — snapshot zuzycia tokenow (thread-level + per-turn).
+-- Thread-level: szybka hydracja <UsageBadge /> przy loadThread (bez tego badge pokazuje "—" do nastepnego result).
+-- Per-turn: historia wzrostu kontekstu per tura (debug/wykres).
+-- Spec: .claude/skills/specyfikacja/db/db-m05-chat.md (sekcja "Usage snapshot")
+
+ALTER TABLE chat_thread  ADD COLUMN last_usage_json TEXT;
+ALTER TABLE chat_message ADD COLUMN usage_json TEXT;

package/dist/server/db/migrations/014_plans.sql

@@ -0,0 +1,33 @@
+-- Etap: M10 Plans — plan wdrozenia jako artefakt chatu.
+-- Spec: .claude/skills/specyfikacja/db/db-m10-plans.md
+
+CREATE TABLE plan (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  thread_id TEXT NOT NULL UNIQUE REFERENCES chat_thread(id) ON DELETE CASCADE,
+  content TEXT NOT NULL DEFAULT '',
+  current_version INTEGER NOT NULL DEFAULT 0,
+  status TEXT NOT NULL DEFAULT 'draft',
+  accepted_at TEXT,
+  accepted_mode TEXT,
+  accepted_thread_id TEXT REFERENCES chat_thread(id) ON DELETE SET NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE UNIQUE INDEX idx_plan_thread ON plan(thread_id);
+CREATE INDEX idx_plan_status ON plan(status);
+
+CREATE TABLE plan_version (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  plan_id INTEGER NOT NULL REFERENCES plan(id) ON DELETE CASCADE,
+  version INTEGER NOT NULL,
+  content TEXT NOT NULL,
+  action TEXT NOT NULL,
+  action_params TEXT,
+  change_summary TEXT,
+  changed_by TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX idx_pv_plan ON plan_version(plan_id);
+CREATE UNIQUE INDEX uq_pv_plan_version ON plan_version(plan_id, version);

package/dist/server/db/migrations/015_dto_examples.sql

@@ -0,0 +1,4 @@
+-- M04 DTO: add examples column (named JSON payload exemplars per DTO).
+-- Spec: entities/dto.md `dtoexmp1` — soft-validated, name unique within DTO, default [].
+
+ALTER TABLE dto ADD COLUMN examples TEXT NOT NULL DEFAULT '[]';

package/dist/server/db/migrations/016_ui_view.sql

@@ -0,0 +1,10 @@
+CREATE TABLE ui_view (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  slug TEXT UNIQUE NOT NULL,
+  name TEXT NOT NULL,
+  url TEXT,
+  description TEXT,
+  params TEXT NOT NULL DEFAULT '[]',
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);

package/dist/server/db/migrations/017_entity_version_m17.sql

@@ -0,0 +1,23 @@
+-- M17 Spec Snapshots & Releases — Phase 3
+-- Extend entity_version with release_id (FK to spec_release added in 019),
+-- serializer_version (per-type semver), and op (create | update | delete).
+
+ALTER TABLE entity_version ADD COLUMN release_id INTEGER NULL;
+ALTER TABLE entity_version ADD COLUMN serializer_version TEXT NULL;
+ALTER TABLE entity_version ADD COLUMN op TEXT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_entity_version_release ON entity_version(release_id);
+
+-- Best-effort backfill of `op` for existing rows. Heuristic:
+--   data = 'null'                                                   -> delete
+--   first version per (entity_type, entity_id)                      -> create
+--   everything else                                                 -> update
+UPDATE entity_version SET op = 'delete' WHERE data = 'null' AND op IS NULL;
+
+UPDATE entity_version SET op = 'create' WHERE id IN (
+  SELECT MIN(id) FROM entity_version
+   WHERE op IS NULL OR op = ''
+   GROUP BY entity_type, entity_id
+) AND (op IS NULL OR op = '');
+
+UPDATE entity_version SET op = 'update' WHERE op IS NULL;

package/dist/server/db/migrations/018_page_version.sql

@@ -0,0 +1,20 @@
+-- M17 Spec Snapshots & Releases — Phase 4
+-- Append-only versioning for markdown pages (M02 stays out of L9 plugin host;
+-- decyzja 1 in M17 plan). Parallel to entity_version but for filesystem pages.
+
+CREATE TABLE page_version (
+  id                  INTEGER PRIMARY KEY AUTOINCREMENT,
+  path                TEXT NOT NULL,                                                -- "modules/m01-auth.md"
+  version             INTEGER NOT NULL,                                             -- 1, 2, 3, ... per path
+  data                TEXT NOT NULL,                                                -- JSON: PageSnapshotData
+  serializer_version  TEXT NOT NULL,
+  op                  TEXT NOT NULL CHECK (op IN ('create', 'update', 'delete')),
+  release_id          INTEGER NULL,                                                 -- FK semantics enforced in app layer
+  changed_by          TEXT NOT NULL CHECK (changed_by IN ('user', 'agent', 'filesystem')),
+  created_at          TEXT NOT NULL DEFAULT (datetime('now')),
+
+  UNIQUE(path, version)
+);
+
+CREATE INDEX idx_page_version_release ON page_version(release_id);
+CREATE INDEX idx_page_version_path    ON page_version(path);

package/dist/server/db/migrations/019_spec_release.sql

@@ -0,0 +1,13 @@
+-- M17 Spec Snapshots & Releases — Phase 5
+-- spec_release: meta record per named snapshot. entity_version and page_version
+-- already carry release_id (loose INTEGER NULL — FK enforced in app layer).
+
+CREATE TABLE spec_release (
+  id           INTEGER PRIMARY KEY AUTOINCREMENT,
+  name         TEXT NOT NULL UNIQUE,                                              -- "v1.0.0", "pre-launch"
+  description  TEXT NOT NULL CHECK (length(trim(description)) > 0),               -- decyzja 5
+  created_by   TEXT NOT NULL,                                                     -- "user" | "agent"
+  created_at   TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX idx_spec_release_created_at ON spec_release(created_at DESC);

package/dist/server/db/migrations/020_drop_plan_status.sql

@@ -0,0 +1,10 @@
+-- Etap: M10 — wycofanie statusu planu (spec change).
+-- Spec: .claude/skills/specyfikacja/db/db-m10-plans.md, modules/m10-plans.md
+-- Decyzja: plan_version jest jedynym audit trail; wiersz `plan` nie mutuje przy execute.
+
+DROP INDEX IF EXISTS idx_plan_status;
+
+ALTER TABLE plan DROP COLUMN status;
+ALTER TABLE plan DROP COLUMN accepted_at;
+ALTER TABLE plan DROP COLUMN accepted_mode;
+ALTER TABLE plan DROP COLUMN accepted_thread_id;