@inharness-ai/claude4spec 1.0.0

package/dist/server/entities/ui-view/services.js

@@ -0,0 +1,255 @@
+import { uiViewSlug } from '../../services/slug.js';
+import { DomainError } from '../../services/tags.js';
+const VALID_LOCATIONS = ['path', 'query', 'hash'];
+export class UiViewService {
+    db;
+    tags;
+    versions;
+    constructor(db, tags, versions) {
+        this.db = db;
+        this.tags = tags;
+        this.versions = versions;
+    }
+    create(input, actor) {
+        if (!input.name)
+            throw new DomainError('VALIDATION', 'name is required');
+        const slug = input.slug?.trim() || uiViewSlug(input.name);
+        if (!slug)
+            throw new DomainError('VALIDATION', 'slug resolves to empty');
+        const params = input.params ?? [];
+        const url = normaliseUrl(input.url);
+        const tx = this.db.transaction(() => {
+            const conflict = this.db.prepare(`SELECT 1 FROM ui_view WHERE slug = ?`).get(slug);
+            if (conflict)
+                throw new DomainError('SLUG_CONFLICT', `ui view slug '${slug}' already exists`);
+            const info = this.db
+                .prepare(`INSERT INTO ui_view (slug, name, url, description, params)
+           VALUES (?, ?, ?, ?, ?)`)
+                .run(slug, input.name, url, input.description ?? null, JSON.stringify(params));
+            const id = Number(info.lastInsertRowid);
+            if (input.tags?.length)
+                this.tags.assignTags('ui-view', id, input.tags);
+            const created = this.getByIdInternal(id);
+            this.versions.captureEntitySnapshot('ui-view', id, 'create', actor, 'Created', '1.0.0');
+            const warnings = computeWarnings(url, params);
+            return { uiView: created, warnings };
+        });
+        return tx();
+    }
+    list(query = {}) {
+        const where = [];
+        const params = [];
+        if (query.search) {
+            where.push(`(name LIKE ? OR description LIKE ? OR slug LIKE ? OR url LIKE ?)`);
+            const like = `%${query.search}%`;
+            params.push(like, like, like, like);
+        }
+        const tagSlugs = query.tags?.filter(Boolean) ?? [];
+        if (tagSlugs.length) {
+            const placeholders = tagSlugs.map(() => '?').join(',');
+            if (query.tagFilter === 'or') {
+                where.push(`
+          id IN (
+            SELECT et.entity_id FROM entity_tag et
+              JOIN tag t ON t.id = et.tag_id
+             WHERE et.entity_type = 'ui-view' AND t.slug IN (${placeholders})
+          )
+        `);
+                params.push(...tagSlugs);
+            }
+            else {
+                where.push(`
+          id IN (
+            SELECT et.entity_id
+              FROM entity_tag et
+              JOIN tag t ON t.id = et.tag_id
+             WHERE et.entity_type = 'ui-view' AND t.slug IN (${placeholders})
+          GROUP BY et.entity_id
+            HAVING COUNT(DISTINCT t.slug) = ?
+          )
+        `);
+                params.push(...tagSlugs, tagSlugs.length);
+            }
+        }
+        const whereSql = where.length ? `WHERE ${where.join(' AND ')}` : '';
+        const limit = Math.min(Math.max(query.limit ?? 200, 1), 500);
+        const offset = Math.max(query.offset ?? 0, 0);
+        const rows = this.db
+            .prepare(`SELECT * FROM ui_view ${whereSql}
+         ORDER BY name
+         LIMIT ? OFFSET ?`)
+            .all(...params, limit, offset);
+        return rows.map((r) => this.hydrate(r));
+    }
+    getBySlug(slug) {
+        const row = this.db.prepare(`SELECT * FROM ui_view WHERE slug = ?`).get(slug);
+        return row ? this.hydrate(row) : null;
+    }
+    getIdBySlug(slug) {
+        const row = this.db.prepare(`SELECT id FROM ui_view WHERE slug = ?`).get(slug);
+        return row?.id ?? null;
+    }
+    update(slug, input, actor) {
+        const tx = this.db.transaction(() => {
+            const current = this.db.prepare(`SELECT * FROM ui_view WHERE slug = ?`).get(slug);
+            if (!current)
+                throw new DomainError('NOT_FOUND', `ui view '${slug}' not found`);
+            const nextName = input.name ?? current.name;
+            const autoSlug = uiViewSlug(nextName);
+            const nextSlug = input.newSlug?.trim() || autoSlug;
+            if (nextSlug !== slug) {
+                const conflict = this.db.prepare(`SELECT 1 FROM ui_view WHERE slug = ?`).get(nextSlug);
+                if (conflict)
+                    throw new DomainError('SLUG_CONFLICT', `ui view slug '${nextSlug}' already exists`);
+            }
+            const nextParams = input.params !== undefined ? JSON.stringify(input.params) : current.params;
+            const nextUrl = input.url !== undefined ? normaliseUrl(input.url) : current.url;
+            this.db
+                .prepare(`UPDATE ui_view
+             SET slug = ?, name = ?, url = ?, description = ?, params = ?,
+                 updated_at = datetime('now')
+           WHERE id = ?`)
+                .run(nextSlug, nextName, nextUrl, input.description !== undefined ? input.description : current.description, nextParams, current.id);
+            if (input.tags)
+                this.tags.assignTags('ui-view', current.id, input.tags);
+            const updated = this.getByIdInternal(current.id);
+            const summary = nextSlug !== slug ? `Renamed from '${slug}' to '${nextSlug}'` : 'Updated';
+            this.versions.captureEntitySnapshot('ui-view', current.id, 'update', actor, summary, '1.0.0');
+            const warnings = computeWarnings(updated.url, updated.params);
+            return { uiView: updated, previousSlug: slug, warnings };
+        });
+        return tx();
+    }
+    /**
+     * Idempotent UPSERT for M17 restore. CREATE if slug missing, UPDATE
+     * otherwise; preserves slug.
+     */
+    upsert(slug, input, actor) {
+        const existing = this.getBySlug(slug);
+        if (!existing) {
+            const result = this.create({ ...input, slug }, actor);
+            return { uiView: result.uiView, op: 'created', warnings: result.warnings };
+        }
+        const result = this.update(slug, {
+            name: input.name,
+            url: input.url,
+            description: input.description,
+            params: input.params,
+            tags: input.tags,
+        }, actor);
+        return { uiView: result.uiView, op: 'updated', warnings: result.warnings };
+    }
+    remove(slug, actor, brokenReferences = []) {
+        const tx = this.db.transaction(() => {
+            const row = this.db.prepare(`SELECT * FROM ui_view WHERE slug = ?`).get(slug);
+            if (!row)
+                throw new DomainError('NOT_FOUND', `ui view '${slug}' not found`);
+            // M17: capture snapshot BEFORE delete.
+            this.versions.captureEntitySnapshot('ui-view', row.id, 'delete', actor, 'Deleted', '1.0.0');
+            this.db
+                .prepare(`DELETE FROM entity_tag WHERE entity_type = 'ui-view' AND entity_id = ?`)
+                .run(row.id);
+            this.db.prepare(`DELETE FROM ui_view WHERE id = ?`).run(row.id);
+            return { deleted: true, brokenReferences };
+        });
+        return tx();
+    }
+    getByIdInternal(id) {
+        const row = this.db.prepare(`SELECT * FROM ui_view WHERE id = ?`).get(id);
+        if (!row)
+            throw new Error(`ui_view id ${id} disappeared mid-tx`);
+        return this.hydrate(row);
+    }
+    hydrate(row) {
+        return {
+            slug: row.slug,
+            name: row.name,
+            url: row.url,
+            description: row.description,
+            params: parseParams(row.params),
+            tags: this.tags.getEntityTagSlugs('ui-view', row.id),
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+}
+function normaliseUrl(value) {
+    if (value === undefined || value === null)
+        return null;
+    const trimmed = value.trim();
+    return trimmed === '' ? null : trimmed;
+}
+function parseParams(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed
+            .filter((p) => p && typeof p === 'object' && typeof p.name === 'string')
+            .map((p) => {
+            const inValue = String(p.in ?? '');
+            const location = VALID_LOCATIONS.includes(inValue)
+                ? inValue
+                : 'query';
+            const out = {
+                name: String(p.name),
+                in: location,
+            };
+            if (typeof p.type === 'string')
+                out.type = p.type;
+            if (typeof p.required === 'boolean')
+                out.required = p.required;
+            if (typeof p.default === 'string')
+                out.default = p.default;
+            if (typeof p.description === 'string')
+                out.description = p.description;
+            return out;
+        });
+    }
+    catch {
+        return [];
+    }
+}
+const PATH_PARAM_RE = /:([a-zA-Z_][a-zA-Z0-9_]*)/g;
+export function computeWarnings(url, params) {
+    const warnings = [];
+    for (let i = 0; i < params.length; i++) {
+        const p = params[i];
+        if (!p.name) {
+            warnings.push(`params[${i}]: missing 'name'`);
+        }
+        if (!VALID_LOCATIONS.includes(p.in)) {
+            warnings.push(`params[${i}] '${p.name ?? '?'}': invalid 'in' value '${p.in}' (expected path|query|hash)`);
+        }
+    }
+    const seen = new Set();
+    for (const p of params) {
+        const key = `${p.in}::${p.name}`;
+        if (seen.has(key)) {
+            warnings.push(`Duplicate param (name='${p.name}', in='${p.in}')`);
+        }
+        seen.add(key);
+    }
+    const urlPathParams = new Set();
+    if (url) {
+        const matches = url.matchAll(PATH_PARAM_RE);
+        for (const m of matches)
+            urlPathParams.add(m[1]);
+    }
+    const declaredPathParams = new Set(params.filter((p) => p.in === 'path' && p.name).map((p) => p.name));
+    for (const name of urlPathParams) {
+        if (!declaredPathParams.has(name)) {
+            warnings.push(`path param ":${name}" in URL not declared in params[]`);
+        }
+    }
+    for (const name of declaredPathParams) {
+        if (url && !urlPathParams.has(name)) {
+            warnings.push(`path param '${name}' declared but not present in URL`);
+        }
+    }
+    if (url === null && declaredPathParams.size > 0) {
+        warnings.push(`path params declared but URL is null (modal/drawer should not have path params)`);
+    }
+    return warnings;
+}
+//# sourceMappingURL=services.js.map

package/dist/server/entities/ui-view/services.js.map

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

package/dist/server/entities/ui-view/system-prompt.d.ts

@@ -0,0 +1,7 @@
+import type { SystemPromptContribution } from '../../../shared/plugin-host/types.js';
+/**
+ * UI views are intentionally absent from the chat system prompt today (legacy
+ * behavior). Empty roleNoun signals opt-out — buildSystemPrompt skips this
+ * plugin's contribution.
+ */
+export declare const uiViewSystemPrompt: SystemPromptContribution;

package/dist/server/entities/ui-view/system-prompt.js

@@ -0,0 +1,15 @@
+/**
+ * UI views are intentionally absent from the chat system prompt today (legacy
+ * behavior). Empty roleNoun signals opt-out — buildSystemPrompt skips this
+ * plugin's contribution.
+ */
+export const uiViewSystemPrompt = {
+    roleNoun: '',
+    countStat: {
+        placeholder: 'uiViewCount',
+        sqlQuery: 'SELECT COUNT(*) AS count FROM ui_view',
+        label: 'ui-views',
+    },
+    mcpToolsLine: '',
+};
+//# sourceMappingURL=system-prompt.js.map

package/dist/server/entities/ui-view/system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../../../src/server/entities/ui-view/system-prompt.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B;IAC1D,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE;QACT,WAAW,EAAE,aAAa;QAC1B,QAAQ,EAAE,uCAAuC;QACjD,KAAK,EAAE,UAAU;KAClB;IACD,YAAY,EAAE,EAAE;CACjB,CAAC"}

package/dist/server/external-skills/brief-implementer-template.d.ts

@@ -0,0 +1,2 @@
+export declare const BRIEF_IMPLEMENTER_FRONTMATTER = "---\nname: c4s-brief-implementer\ndescription: Implement features described in claude4spec briefs (markdown files in .claude4spec/briefs/). Briefs are self-contained \u2014 they include all context needed for implementation (entity snapshots, section diffs, narrative). After implementation, if you discover drift between the brief and reality (missing details, incorrect assumptions, edge cases not covered), generate a patch file in .claude4spec/patches/ as feedback for the specification author. Use when implementing changes in a code repository that has a .claude4spec/briefs/ directory.\n---\n";
+export declare const BRIEF_IMPLEMENTER_BODY = "# c4s-brief-implementer\n\nThis skill describes how to implement a release brief in **your code repository**\n(not the spec repo). A brief is a self-contained markdown file under\n`.claude4spec/briefs/` that captures everything you need to ship the change:\nentity snapshots, section diffs, narrative, acceptance criteria.\n\n**This skill does NOT assume the `c4s` CLI is installed.** Briefs are designed\nto be self-contained \u2014 you do not need to read the main specification or query\nthe entity database. If the brief references something you cannot find in its\nbody, treat that as drift and file a patch (step 4 below).\n\n## Workflow\n\n### 1. Discover\n\n```sh\nls .claude4spec/briefs/        # list available briefs\ncat .claude4spec/briefs/<slug>.md\n```\n\nIf `.claude4spec/` is not in your current directory, walk up the directory tree\nuntil you find it (similar to how git finds `.git/`).\n\n### 2. Read the brief as self-contained input\n\nEvery brief has YAML frontmatter:\n\n```yaml\n---\ntype: brief\nfrom_release: v0.1.16\nto_release: v0.1.17\ngenerator_version: brief-author@0.1\nimplemented: false\n---\n```\n\nThe body contains everything you need \u2014 entity snapshots, section diffs, the\nnarrative of what changes, and acceptance criteria. **Do not read the main\nspecification.** If the brief omits something, that is drift (see step 4).\n\n### 3. Implement\n\nStandard code flow in your target repository: read existing code, plan, edit,\ntest. Stay focused on what the brief specifies.\n\n### 4. Feedback loop (patches)\n\nWhen you discover that the brief diverges from reality \u2014 a missing detail, an\nincorrect assumption, an edge case not covered, or anything else the\nspec-author should know \u2014 write a patch file:\n\n```sh\nmkdir -p .claude4spec/patches\n```\n\nCreate `.claude4spec/patches/<brief-slug>-<short-desc>.md` with this format:\n\n```markdown\n---\ntype: patch\nbrief: v0-1-16-to-v0-1-17.md      # path relative to briefs/\npatch_kind: drift                  # drift | missing | incorrect | clarification\ncreated_at: 2026-05-11T17:32:00Z\ncreated_by: claude-code            # or \"cursor\", \"aider\", ...\n---\n\n# Patch \u2014 short title\n\n## What I found\n\n\u2026description of the drift / missing detail / incorrect assumption\u2026\n\n## Suggestion\n\n\u2026what the spec-author should consider in a follow-up brief or entity edits\u2026\n```\n\nPatch-kind values:\n\n- `drift` \u2014 the brief described behavior X, but the codebase already does Y.\n- `missing` \u2014 the brief is silent on a detail you had to decide yourself.\n- `incorrect` \u2014 the brief is factually wrong about existing code.\n- `clarification` \u2014 the brief is ambiguous; you guessed but it should be made\n  explicit for next time.\n\nThe `.claude4spec/patches/` directory is created **lazily** \u2014 only when you\nfile your first patch. The claude4spec server does NOT create it.\n\n### 5. Mark brief as implemented\n\nWhen the implementation is genuinely finished \u2014 code committed, tests green,\nmerged to main / accepted by the user \u2014 flip the brief's frontmatter to\n`implemented: true`:\n\n```bash\n# Option A \u2014 Edit tool: change the line `implemented: false` \u2192 `implemented: true`.\n# Option B \u2014 yq (idempotent; adds the field to legacy briefs that never had it):\nyq -i '.implemented = true' .claude4spec/briefs/<brief-slug>.md\n```\n\n`implemented: true` is a **declaration**, not a computed fact derived from git.\nA revert on main does NOT roll the flag back. Set it ONLY when implementation\nis realistically done \u2014 never proactively or \"just in case\".\n\n### 6. Hand-off\n\nThe spec-author reads patches manually (`ls .claude4spec/patches/`, `cat`)\nand folds them into the next brief or entity edits. There is no UI listing in\nthis release \u2014 patches are raw markdown.\n\n## Notes\n\nThis file is **fully managed** by claude4spec \u2014 it is overwritten on every\nserver start when its rendered content changes. Do not edit it by hand.\n";

package/dist/server/external-skills/brief-implementer-template.js

@@ -0,0 +1,123 @@
+export const BRIEF_IMPLEMENTER_FRONTMATTER = `---
+name: c4s-brief-implementer
+description: Implement features described in claude4spec briefs (markdown files in .claude4spec/briefs/). Briefs are self-contained — they include all context needed for implementation (entity snapshots, section diffs, narrative). After implementation, if you discover drift between the brief and reality (missing details, incorrect assumptions, edge cases not covered), generate a patch file in .claude4spec/patches/ as feedback for the specification author. Use when implementing changes in a code repository that has a .claude4spec/briefs/ directory.
+---
+`;
+export const BRIEF_IMPLEMENTER_BODY = `# c4s-brief-implementer
+
+This skill describes how to implement a release brief in **your code repository**
+(not the spec repo). A brief is a self-contained markdown file under
+\`.claude4spec/briefs/\` that captures everything you need to ship the change:
+entity snapshots, section diffs, narrative, acceptance criteria.
+
+**This skill does NOT assume the \`c4s\` CLI is installed.** Briefs are designed
+to be self-contained — you do not need to read the main specification or query
+the entity database. If the brief references something you cannot find in its
+body, treat that as drift and file a patch (step 4 below).
+
+## Workflow
+
+### 1. Discover
+
+\`\`\`sh
+ls .claude4spec/briefs/        # list available briefs
+cat .claude4spec/briefs/<slug>.md
+\`\`\`
+
+If \`.claude4spec/\` is not in your current directory, walk up the directory tree
+until you find it (similar to how git finds \`.git/\`).
+
+### 2. Read the brief as self-contained input
+
+Every brief has YAML frontmatter:
+
+\`\`\`yaml
+---
+type: brief
+from_release: v0.1.16
+to_release: v0.1.17
+generator_version: brief-author@0.1
+implemented: false
+---
+\`\`\`
+
+The body contains everything you need — entity snapshots, section diffs, the
+narrative of what changes, and acceptance criteria. **Do not read the main
+specification.** If the brief omits something, that is drift (see step 4).
+
+### 3. Implement
+
+Standard code flow in your target repository: read existing code, plan, edit,
+test. Stay focused on what the brief specifies.
+
+### 4. Feedback loop (patches)
+
+When you discover that the brief diverges from reality — a missing detail, an
+incorrect assumption, an edge case not covered, or anything else the
+spec-author should know — write a patch file:
+
+\`\`\`sh
+mkdir -p .claude4spec/patches
+\`\`\`
+
+Create \`.claude4spec/patches/<brief-slug>-<short-desc>.md\` with this format:
+
+\`\`\`markdown
+---
+type: patch
+brief: v0-1-16-to-v0-1-17.md      # path relative to briefs/
+patch_kind: drift                  # drift | missing | incorrect | clarification
+created_at: 2026-05-11T17:32:00Z
+created_by: claude-code            # or "cursor", "aider", ...
+---
+
+# Patch — short title
+
+## What I found
+
+…description of the drift / missing detail / incorrect assumption…
+
+## Suggestion
+
+…what the spec-author should consider in a follow-up brief or entity edits…
+\`\`\`
+
+Patch-kind values:
+
+- \`drift\` — the brief described behavior X, but the codebase already does Y.
+- \`missing\` — the brief is silent on a detail you had to decide yourself.
+- \`incorrect\` — the brief is factually wrong about existing code.
+- \`clarification\` — the brief is ambiguous; you guessed but it should be made
+  explicit for next time.
+
+The \`.claude4spec/patches/\` directory is created **lazily** — only when you
+file your first patch. The claude4spec server does NOT create it.
+
+### 5. Mark brief as implemented
+
+When the implementation is genuinely finished — code committed, tests green,
+merged to main / accepted by the user — flip the brief's frontmatter to
+\`implemented: true\`:
+
+\`\`\`bash
+# Option A — Edit tool: change the line \`implemented: false\` → \`implemented: true\`.
+# Option B — yq (idempotent; adds the field to legacy briefs that never had it):
+yq -i '.implemented = true' .claude4spec/briefs/<brief-slug>.md
+\`\`\`
+
+\`implemented: true\` is a **declaration**, not a computed fact derived from git.
+A revert on main does NOT roll the flag back. Set it ONLY when implementation
+is realistically done — never proactively or "just in case".
+
+### 6. Hand-off
+
+The spec-author reads patches manually (\`ls .claude4spec/patches/\`, \`cat\`)
+and folds them into the next brief or entity edits. There is no UI listing in
+this release — patches are raw markdown.
+
+## Notes
+
+This file is **fully managed** by claude4spec — it is overwritten on every
+server start when its rendered content changes. Do not edit it by hand.
+`;
+//# sourceMappingURL=brief-implementer-template.js.map

package/dist/server/external-skills/brief-implementer-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief-implementer-template.js","sourceRoot":"","sources":["../../../src/server/external-skills/brief-implementer-template.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,6BAA6B,GAAG;;;;CAI5C,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoHrC,CAAC"}

package/dist/server/external-skills/external-skills-service.d.ts

@@ -0,0 +1,3 @@
+export declare function renderSpecReaderSkill(): string;
+export declare function renderBriefImplementerSkill(): string;
+export declare function ensureExternalSkills(cwd: string): void;

package/dist/server/external-skills/external-skills-service.js

@@ -0,0 +1,47 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { SPEC_READER_FRONTMATTER, SPEC_READER_BODY, } from './spec-reader-template.js';
+import { BRIEF_IMPLEMENTER_FRONTMATTER, BRIEF_IMPLEMENTER_BODY, } from './brief-implementer-template.js';
+export function renderSpecReaderSkill() {
+    return SPEC_READER_FRONTMATTER + '\n' + SPEC_READER_BODY;
+}
+export function renderBriefImplementerSkill() {
+    return BRIEF_IMPLEMENTER_FRONTMATTER + '\n' + BRIEF_IMPLEMENTER_BODY;
+}
+function sha256(buf) {
+    return createHash('sha256').update(buf).digest('hex');
+}
+function writeIfChanged(absPath, content) {
+    if (fs.existsSync(absPath)) {
+        const existing = fs.readFileSync(absPath);
+        if (sha256(existing) === sha256(content))
+            return;
+    }
+    fs.mkdirSync(path.dirname(absPath), { recursive: true });
+    fs.writeFileSync(absPath, content, 'utf8');
+}
+function migrateLegacyAgentMd(cwd) {
+    const agentMd = path.join(cwd, '.claude4spec', 'AGENT.md');
+    const newSkill = path.join(cwd, '.claude4spec', 'skills', 'c4s-spec-reader', 'SKILL.md');
+    if (!fs.existsSync(agentMd))
+        return;
+    if (fs.existsSync(newSkill))
+        return;
+    const original = fs.readFileSync(agentMd, 'utf8');
+    const header = '<!-- DEPRECATED: this file was AGENT.md. It has been replaced by skills in\n' +
+        '     .claude4spec/skills/c4s-spec-reader/SKILL.md (and c4s-brief-implementer).\n' +
+        '     Safe to delete after your team has upgraded. -->\n\n';
+    fs.writeFileSync(agentMd + '.deprecated', header + original, 'utf8');
+    fs.unlinkSync(agentMd);
+    console.log('Migrated .claude4spec/AGENT.md → external-skills format (M22).');
+}
+export function ensureExternalSkills(cwd) {
+    migrateLegacyAgentMd(cwd);
+    const skillsRoot = path.join(cwd, '.claude4spec', 'skills');
+    const specReaderPath = path.join(skillsRoot, 'c4s-spec-reader', 'SKILL.md');
+    const briefImplementerPath = path.join(skillsRoot, 'c4s-brief-implementer', 'SKILL.md');
+    writeIfChanged(specReaderPath, renderSpecReaderSkill());
+    writeIfChanged(briefImplementerPath, renderBriefImplementerSkill());
+}
+//# sourceMappingURL=external-skills-service.js.map

package/dist/server/external-skills/external-skills-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-skills-service.js","sourceRoot":"","sources":["../../../src/server/external-skills/external-skills-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,UAAU,qBAAqB;IACnC,OAAO,uBAAuB,GAAG,IAAI,GAAG,gBAAgB,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO,6BAA6B,GAAG,IAAI,GAAG,sBAAsB,CAAC;AACvE,CAAC;AAED,SAAS,MAAM,CAAC,GAAoB;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,OAAe;IACtD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC;YAAE,OAAO;IACnD,CAAC;IACD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAW;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CACxB,GAAG,EACH,cAAc,EACd,QAAQ,EACR,iBAAiB,EACjB,UAAU,CACX,CAAC;IACF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO;IACpC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO;IAEpC,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,MAAM,GACV,8EAA8E;QAC9E,kFAAkF;QAClF,2DAA2D,CAAC;IAC9D,EAAE,CAAC,aAAa,CAAC,OAAO,GAAG,aAAa,EAAE,MAAM,GAAG,QAAQ,EAAE,MAAM,CAAC,CAAC;IACrE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAE1B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;IAC5D,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,EAAE,UAAU,CAAC,CAAC;IAC5E,MAAM,oBAAoB,GAAG,IAAI,CAAC,IAAI,CACpC,UAAU,EACV,uBAAuB,EACvB,UAAU,CACX,CAAC;IAEF,cAAc,CAAC,cAAc,EAAE,qBAAqB,EAAE,CAAC,CAAC;IACxD,cAAc,CAAC,oBAAoB,EAAE,2BAA2B,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/server/external-skills/spec-reader-template.d.ts

@@ -0,0 +1,2 @@
+export declare const SPEC_READER_FRONTMATTER = "---\nname: c4s-spec-reader\ndescription: Read claude4spec specification entities (endpoints, DTOs, tables, AC, UI views) referenced from markdown pages through XML tags like <inline_mention/>, <single_element/>, <tagged_list/>. Use when working in a repository whose pages/ contain these tags or whose .claude4spec/ directory exists. Resolves entity slugs to full data via c4s CLI or c4s-reader MCP server.\n---\n";
+export declare const SPEC_READER_BODY = "# c4s-spec-reader\n\nThis repository contains a claude4spec specification. Pages (`*.md`) reference\nentities stored in `.claude4spec/db.sqlite` through XML tags. This skill teaches\nyou how to resolve them.\n\nAll commands below walk up from the agent's cwd to the nearest `.claude4spec/` \u2014\nno absolute paths are required.\n\n## Resolving a tag\n\nInstall `claude4spec` (Node 20+) and use the `c4s` CLI. Subcommand names match\nXML tag names 1:1.\n\n| XML tag | CLI equivalent |\n|---------|----------------|\n| `<inline_mention type=\"endpoint\" slug=\"X\"/>` | `c4s inline_mention --type endpoint --slug X` |\n| `<single_element type=\"dto\" slug=\"X\"/>` | `c4s single_element --type dto --slug X` |\n| `<element_list type=\"endpoint\" slugs=\"a,b,c\"/>` | `c4s element_list --type endpoint --slugs a,b,c` |\n| `<tagged_list type=\"dto\" tags=\"auth\" filter=\"and\"/>` | `c4s tagged_list --type dto --tags auth --filter and` |\n| `<tagged_list_mixed tags=\"public\"/>` | `c4s tagged_list_mixed --tags public` |\n\n## Expanding a whole page\n\n```sh\nc4s resolve some-page.md              # writes markdown with tags expanded inline\nc4s resolve some-page.md --format json   # writes { content, resolved: [...] }\n```\n\n## Discovery\n\n- `c4s catalog` \u2014 entity types, versions, and JSON Schema per view.\n- `c4s list-tags` \u2014 all tags with per-type counts.\n- `c4s list-slugs --type endpoint` \u2014 all slugs for a given type.\n\nAll output is JSON (pretty) by default. Use `--compact` for pipelines and\n`--format text` for terminal-friendly output. Errors go to stderr as JSON with\nan exit code > 0.\n\nThe database is opened **read-only** \u2014 `c4s` never mutates the project.\n";

package/dist/server/external-skills/spec-reader-template.js

@@ -0,0 +1,47 @@
+export const SPEC_READER_FRONTMATTER = `---
+name: c4s-spec-reader
+description: Read claude4spec specification entities (endpoints, DTOs, tables, AC, UI views) referenced from markdown pages through XML tags like <inline_mention/>, <single_element/>, <tagged_list/>. Use when working in a repository whose pages/ contain these tags or whose .claude4spec/ directory exists. Resolves entity slugs to full data via c4s CLI or c4s-reader MCP server.
+---
+`;
+export const SPEC_READER_BODY = `# c4s-spec-reader
+
+This repository contains a claude4spec specification. Pages (\`*.md\`) reference
+entities stored in \`.claude4spec/db.sqlite\` through XML tags. This skill teaches
+you how to resolve them.
+
+All commands below walk up from the agent's cwd to the nearest \`.claude4spec/\` —
+no absolute paths are required.
+
+## Resolving a tag
+
+Install \`claude4spec\` (Node 20+) and use the \`c4s\` CLI. Subcommand names match
+XML tag names 1:1.
+
+| XML tag | CLI equivalent |
+|---------|----------------|
+| \`<inline_mention type="endpoint" slug="X"/>\` | \`c4s inline_mention --type endpoint --slug X\` |
+| \`<single_element type="dto" slug="X"/>\` | \`c4s single_element --type dto --slug X\` |
+| \`<element_list type="endpoint" slugs="a,b,c"/>\` | \`c4s element_list --type endpoint --slugs a,b,c\` |
+| \`<tagged_list type="dto" tags="auth" filter="and"/>\` | \`c4s tagged_list --type dto --tags auth --filter and\` |
+| \`<tagged_list_mixed tags="public"/>\` | \`c4s tagged_list_mixed --tags public\` |
+
+## Expanding a whole page
+
+\`\`\`sh
+c4s resolve some-page.md              # writes markdown with tags expanded inline
+c4s resolve some-page.md --format json   # writes { content, resolved: [...] }
+\`\`\`
+
+## Discovery
+
+- \`c4s catalog\` — entity types, versions, and JSON Schema per view.
+- \`c4s list-tags\` — all tags with per-type counts.
+- \`c4s list-slugs --type endpoint\` — all slugs for a given type.
+
+All output is JSON (pretty) by default. Use \`--compact\` for pipelines and
+\`--format text\` for terminal-friendly output. Errors go to stderr as JSON with
+an exit code > 0.
+
+The database is opened **read-only** — \`c4s\` never mutates the project.
+`;
+//# sourceMappingURL=spec-reader-template.js.map

package/dist/server/external-skills/spec-reader-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-reader-template.js","sourceRoot":"","sources":["../../../src/server/external-skills/spec-reader-template.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;CAItC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC/B,CAAC"}

package/dist/server/fs/watcher.d.ts

@@ -0,0 +1,26 @@
+import type { WsGateway } from '../ws/gateway.js';
+type EventKind = 'add' | 'change' | 'unlink';
+export type PagesWatcherCallback = (relPath: string, kind: EventKind) => void;
+export declare class PagesWatcher {
+    private pagesRoot;
+    private gateway;
+    private watcher;
+    private suppressUntil;
+    private readonly SUPPRESS_WINDOW_MS;
+    private callbacks;
+    constructor(pagesRoot: string, gateway: WsGateway);
+    onChange(cb: PagesWatcherCallback): void;
+    start(): void;
+    /** Call before a programmatic write so the resulting chokidar event is suppressed. */
+    suppress(relPath: string): void;
+    /**
+     * Broadcast a server-origin change event for a programmatic write.
+     * Clients receive `page:changed { origin: 'server' }` and should silently reload
+     * without showing the "file changed externally" dialog.
+     * Does NOT fire the callback chain (callbacks are for external-origin indexing).
+     */
+    emitServerWrite(relPath: string): void;
+    private emit;
+    close(): Promise<void>;
+}
+export {};

package/dist/server/fs/watcher.js

@@ -0,0 +1,64 @@
+import chokidar from 'chokidar';
+import path from 'node:path';
+export class PagesWatcher {
+    pagesRoot;
+    gateway;
+    watcher = null;
+    suppressUntil = new Map();
+    SUPPRESS_WINDOW_MS = 350;
+    callbacks = [];
+    constructor(pagesRoot, gateway) {
+        this.pagesRoot = pagesRoot;
+        this.gateway = gateway;
+    }
+    onChange(cb) {
+        this.callbacks.push(cb);
+    }
+    start() {
+        this.watcher = chokidar.watch(this.pagesRoot, {
+            ignoreInitial: true,
+            ignored: (p) => /(^|\/|\\)\./.test(path.basename(p)),
+            awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 },
+        });
+        this.watcher.on('add', (p) => this.emit('add', p));
+        this.watcher.on('change', (p) => this.emit('change', p));
+        this.watcher.on('unlink', (p) => this.emit('unlink', p));
+    }
+    /** Call before a programmatic write so the resulting chokidar event is suppressed. */
+    suppress(relPath) {
+        this.suppressUntil.set(relPath, Date.now() + this.SUPPRESS_WINDOW_MS);
+    }
+    /**
+     * Broadcast a server-origin change event for a programmatic write.
+     * Clients receive `page:changed { origin: 'server' }` and should silently reload
+     * without showing the "file changed externally" dialog.
+     * Does NOT fire the callback chain (callbacks are for external-origin indexing).
+     */
+    emitServerWrite(relPath) {
+        this.gateway.broadcast({ kind: 'page:changed', event: 'change', path: relPath, origin: 'server' });
+    }
+    emit(kind, absPath) {
+        if (!absPath.endsWith('.md'))
+            return;
+        const relPath = path.relative(this.pagesRoot, absPath).replaceAll(path.sep, '/');
+        const suppressedUntil = this.suppressUntil.get(relPath);
+        if (suppressedUntil && Date.now() < suppressedUntil) {
+            this.suppressUntil.delete(relPath);
+            return;
+        }
+        this.gateway.broadcast({ kind: 'page:changed', event: kind, path: relPath, origin: 'external' });
+        for (const cb of this.callbacks) {
+            try {
+                cb(relPath, kind);
+            }
+            catch (err) {
+                console.error('[watcher] callback error:', err);
+            }
+        }
+    }
+    async close() {
+        await this.watcher?.close();
+        this.watcher = null;
+    }
+}
+//# sourceMappingURL=watcher.js.map