@inharness-ai/claude4spec 1.0.0

package/dist/server/mcp/brief-tools.js

@@ -0,0 +1,189 @@
+/**
+ * M21 brief-tools MCP server. Per-thread instance (analog `plan-tools` from
+ * M10) — `briefPath` is captured from `chat_thread.brief_path` at thread
+ * creation time. Mounted by `routes/chat.ts` ONLY for threads with
+ * `context_type='brief'`.
+ *
+ * Four tools, no `create_brief`/`list_briefs`/`brief_generate` (those are
+ * UI/user surface, not agent loop).
+ */
+import { createMcpServer, mcpTool } from '@inharness-ai/agent-adapters';
+import { z } from 'zod';
+import { ConflictError } from '../services/brief.js';
+import { DomainError } from '../services/tags.js';
+import { ANCHOR_PATTERN_SOURCE } from '../../shared/anchor-pattern.js';
+const AGENT_ACTIONS = z.enum(['replace', 'append', 'insert_after_section']);
+const ANCHOR_RE = new RegExp(ANCHOR_PATTERN_SOURCE);
+const HEADING_RE = /^(#{2,6})\s+(.+?)\s*$/;
+export function buildBriefToolsServer(ctx) {
+    const { briefService, pageVersions, briefPath } = ctx;
+    const ok = (payload) => ({
+        content: [{ type: 'text', text: JSON.stringify(payload) }],
+    });
+    const fail = (err) => {
+        let code = 'INTERNAL';
+        let message = err instanceof Error ? err.message : String(err);
+        if (err instanceof DomainError)
+            code = err.code;
+        else if (err instanceof ConflictError)
+            code = err.code;
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: message, code }) }],
+            isError: true,
+        };
+    };
+    const getBrief = mcpTool('get_brief', [
+        'Read the full current state of the brief attached to this thread.',
+        'Returns { frontmatter, body, content, hash }. Use `hash` as `expectedHash`',
+        'in the next `update_brief` call to detect concurrent edits.',
+        'Brief lives on disk under `briefsDir`; you do NOT have filesystem access',
+        '(no Read/Write/Edit) — this tool is the only way to read brief content.',
+    ].join(' '), {}, async () => {
+        try {
+            const brief = await briefService.getBrief(briefPath);
+            return ok(brief);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const updateBrief = mcpTool('update_brief', [
+        'Edit the brief markdown body. Three actions:',
+        '- replace: full rewrite (provide complete markdown in `content`).',
+        '- append: append fragment at end of body.',
+        '- insert_after_section: insert fragment after a section identified by `anchor`',
+        '  (preferred — 8-char nanoid in `<!-- anchor: ... -->`) or `heading` (text match).',
+        'You CANNOT modify frontmatter (type, from_release, to_release, generated_at,',
+        'generator_version, implemented). `implemented` is owned by the implementer-agent',
+        'in the target repo and toggled via filesystem edit, not via this MCP.',
+        'Any frontmatter mutation attempt → BRIEF_FRONTMATTER_IMMUTABLE.',
+        'Optional `expectedHash` (sha256 from get_brief) enables optimistic concurrency —',
+        'mismatch → BRIEF_CONFLICT (re-read brief before retrying).',
+        'Each mutation captures a row in page_version with changed_by="agent".',
+    ].join(' '), {
+        action: AGENT_ACTIONS,
+        content: z.string(),
+        anchor: z.string().optional(),
+        heading: z.string().optional(),
+        expectedHash: z.string().optional(),
+        changeSummary: z.string().optional(),
+    }, async (args) => {
+        try {
+            const action = args.action;
+            const current = await briefService.getBrief(briefPath);
+            const newBody = composeBody(current.body, action, String(args.content ?? ''), typeof args.anchor === 'string' ? args.anchor : undefined, typeof args.heading === 'string' ? args.heading : undefined);
+            // Reconstruct full content with original frontmatter (immutable for agent).
+            const matter = await import('gray-matter');
+            const newContent = matter.default.stringify(newBody, current.frontmatter);
+            const result = await briefService.updateContent({
+                path: briefPath,
+                content: newContent,
+                expectedHash: typeof args.expectedHash === 'string' ? args.expectedHash : current.hash,
+                changedBy: 'agent',
+                changeSummary: typeof args.changeSummary === 'string' ? args.changeSummary : undefined,
+            });
+            return ok({ newHash: result.newHash });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const listBriefVersions = mcpTool('list_brief_versions', 'List all versions of this thread\'s brief (metadata only). Use to inspect history before calling get_brief_version.', {}, async () => {
+        try {
+            return ok({ versions: pageVersions.listVersions(briefPath) });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const getBriefVersion = mcpTool('get_brief_version', 'Get a specific version snapshot of this brief (full content + metadata).', {
+        version: z.number().int().positive(),
+    }, async (args) => {
+        try {
+            const v = pageVersions.getVersion(briefPath, Number(args.version));
+            if (!v)
+                return fail(new DomainError('VERSION_NOT_FOUND', `version ${args.version} not found`));
+            return ok(v);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    return createMcpServer({
+        name: 'brief-tools',
+        tools: [getBrief, updateBrief, listBriefVersions, getBriefVersion],
+    });
+}
+function composeBody(prior, action, fragment, anchor, heading) {
+    switch (action) {
+        case 'replace':
+            return fragment;
+        case 'append': {
+            if (prior.trim().length === 0)
+                return fragment;
+            const sep = prior.endsWith('\n') ? '\n' : '\n\n';
+            return `${prior}${sep}${fragment}`;
+        }
+        case 'insert_after_section':
+            if (!anchor && !heading) {
+                throw new DomainError('MISSING_TARGET', 'insert_after_section requires anchor or heading');
+            }
+            return insertAfterSection(prior, fragment, anchor, heading);
+    }
+}
+function insertAfterSection(prior, fragment, anchor, heading) {
+    const lines = prior.split('\n');
+    let targetLine = -1;
+    let targetLevel = -1;
+    const matches = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const m = line.match(HEADING_RE);
+        if (!m)
+            continue;
+        const level = m[1].length;
+        const text = m[2].trim();
+        if (anchor) {
+            const prev = i > 0 ? lines[i - 1] : '';
+            const am = prev.match(ANCHOR_RE);
+            if (am && am[1] === anchor) {
+                targetLine = i;
+                targetLevel = level;
+                break;
+            }
+        }
+        else if (heading && text === heading.trim()) {
+            matches.push({ line: i, level });
+        }
+    }
+    if (targetLine === -1 && heading && !anchor) {
+        if (matches.length === 0) {
+            // Fallback: spec mówi "unknown anchor → fallback append-at-end + warning"
+            // dla brief, przyjmujemy ten sam fallback dla heading mismatch (deterministyczny).
+            return prior.endsWith('\n') ? `${prior}\n${fragment}` : `${prior}\n\n${fragment}`;
+        }
+        if (matches.length > 1) {
+            throw new DomainError('AMBIGUOUS_HEADING', `heading "${heading}" matches ${matches.length} sections`);
+        }
+        targetLine = matches[0].line;
+        targetLevel = matches[0].level;
+    }
+    if (targetLine === -1) {
+        // Anchor podany, ale nie znaleziono — fallback append-at-end (M21 spec).
+        return prior.endsWith('\n') ? `${prior}\n${fragment}` : `${prior}\n\n${fragment}`;
+    }
+    let endLine = lines.length;
+    for (let i = targetLine + 1; i < lines.length; i++) {
+        const m = lines[i].match(HEADING_RE);
+        if (m && m[1].length <= targetLevel) {
+            endLine = i;
+            break;
+        }
+    }
+    const before = lines.slice(0, endLine).join('\n');
+    const after = lines.slice(endLine).join('\n');
+    const sep = before.endsWith('\n\n') ? '' : before.endsWith('\n') ? '\n' : '\n\n';
+    const afterSep = after.length > 0 ? '\n\n' : '';
+    return `${before}${sep}${fragment}${afterSep}${after}`.replace(/\n{3,}/g, '\n\n');
+}
+//# sourceMappingURL=brief-tools.js.map

package/dist/server/mcp/brief-tools.js.map

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

package/dist/server/mcp/c4s-reader.d.ts

@@ -0,0 +1,12 @@
+import { type McpServerInstance } from '@inharness-ai/agent-adapters';
+import type Database from 'better-sqlite3';
+import { type RawEntityReader } from '../domain/raw-entity-reader.js';
+import { serializationEngine } from '../core/plugin-host/serialization-engine.js';
+export interface C4sReaderDeps {
+    reader: RawEntityReader | null;
+    registry: typeof serializationEngine;
+    db: Database.Database | null;
+    projectDir: string | null;
+    packageVersion: string;
+}
+export declare function createC4sReaderServer(deps: C4sReaderDeps): McpServerInstance;

package/dist/server/mcp/c4s-reader.js

@@ -0,0 +1,263 @@
+import { createMcpServer, mcpTool } from '@inharness-ai/agent-adapters';
+import { z } from 'zod';
+import { isRawEntityType, } from '../domain/raw-entity-reader.js';
+import { resolvePageContent } from '../serialization/resolve-page.js';
+import fs from 'node:fs';
+import path from 'node:path';
+const VIEW_KINDS = [
+    'inline_mention',
+    'single_element',
+    'element_list_item',
+    'tagged_list_item',
+    'detail',
+];
+const ENTITY_TYPE_VALUES = ['endpoint', 'dto', 'database-table', 'ui-view'];
+export function createC4sReaderServer(deps) {
+    const ok = (payload) => ({
+        content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+    });
+    const fail = (code, message, hint) => ({
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({ error: { code, message, ...(hint ? { hint } : {}) } }, null, 2),
+            },
+        ],
+        isError: true,
+    });
+    const requireProject = () => {
+        if (!deps.reader || !deps.db || !deps.projectDir) {
+            return {
+                ok: false,
+                response: fail('PROJECT_NOT_FOUND', 'no claude4spec project loaded', 'pass --project <path> when starting c4s-mcp'),
+            };
+        }
+        return { ok: true, reader: deps.reader, db: deps.db, projectDir: deps.projectDir };
+    };
+    const wrapDb = (fn) => {
+        try {
+            return { ok: true, value: fn() };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const code = /no such table|no such column/i.test(message) ? 'SCHEMA_OUT_OF_DATE' : 'INTERNAL';
+            const hint = code === 'SCHEMA_OUT_OF_DATE' ? 'run `npx claude4spec` to migrate' : undefined;
+            return { ok: false, response: fail(code, message, hint) };
+        }
+    };
+    const normalizeType = (raw) => {
+        const normalized = raw === 'database_table' ? 'database-table' : raw;
+        return isRawEntityType(normalized) ? normalized : null;
+    };
+    const getEntity = mcpTool('get_entity', 'Get a single entity (endpoint / dto / database-table / ui-view) by type+slug. Use this to resolve <single_element type="..." slug="..."/> and <inline_mention type="..." slug="..."/>. The view parameter selects the response shape: single_element (default), inline_mention, detail.', {
+        type: z.enum(ENTITY_TYPE_VALUES).describe('Entity type'),
+        slug: z.string().describe('Entity slug'),
+        view: z
+            .enum(VIEW_KINDS)
+            .optional()
+            .describe('Response shape; default: single_element'),
+    }, async (args) => {
+        const ctx = requireProject();
+        if (!ctx.ok)
+            return ctx.response;
+        const type = normalizeType(String(args.type));
+        if (!type)
+            return fail('INVALID_TYPE', `unknown entity type '${args.type}'`);
+        const view = args.view ?? 'single_element';
+        const slug = String(args.slug);
+        const lookup = wrapDb(() => ctx.reader.getEntity(type, slug));
+        if (!lookup.ok)
+            return lookup.response;
+        if (!lookup.value)
+            return fail('ENTITY_NOT_FOUND', `${type}/${slug} not found`);
+        const serialized = deps.registry.serializeEntity(type, view, lookup.value, ctx.reader);
+        return ok({ type, slug, view, ...envelope(serialized) });
+    });
+    const getEntities = mcpTool('get_entities', 'Get multiple entities of the same type by slug list. Use this to resolve <element_list type="..." slugs="a,b,c"/>. Default view: element_list_item. Returns { items, missing }.', {
+        type: z.enum(ENTITY_TYPE_VALUES).describe('Entity type'),
+        slugs: z.array(z.string()).describe('List of slugs to fetch in order'),
+        view: z
+            .enum(VIEW_KINDS)
+            .optional()
+            .describe('Response shape; default: element_list_item'),
+    }, async (args) => {
+        const ctx = requireProject();
+        if (!ctx.ok)
+            return ctx.response;
+        const type = normalizeType(String(args.type));
+        if (!type)
+            return fail('INVALID_TYPE', `unknown entity type '${args.type}'`);
+        const view = args.view ?? 'element_list_item';
+        const slugs = args.slugs.map(String);
+        const lookup = wrapDb(() => ctx.reader.getEntities(type, slugs));
+        if (!lookup.ok)
+            return lookup.response;
+        const items = lookup.value.items.map((entity) => ({
+            slug: entity.slug,
+            ...envelope(deps.registry.serializeEntity(type, view, entity, ctx.reader)),
+        }));
+        return ok({ type, view, items, missing: lookup.value.missing });
+    });
+    const findByTag = mcpTool('find_by_tag', 'Find entities by tags. Use this to resolve <tagged_list type="..." tags="a,b" filter="and"/> and <tagged_list_mixed tags="..."/>. When type is omitted, results are grouped by type ({ endpoints, dtos, "database-tables", "ui-views" }). Default view: tagged_list_item.', {
+        type: z
+            .enum(ENTITY_TYPE_VALUES)
+            .optional()
+            .describe('Restrict to one entity type; omit for grouped mixed result'),
+        tags: z.array(z.string()).describe('Tag slugs to match'),
+        filter: z.enum(['and', 'or']).optional().describe('Tag filter mode; default: or'),
+        view: z
+            .enum(VIEW_KINDS)
+            .optional()
+            .describe('Response shape; default: tagged_list_item'),
+    }, async (args) => {
+        const ctx = requireProject();
+        if (!ctx.ok)
+            return ctx.response;
+        const tags = args.tags.map(String);
+        const filter = (args.filter ?? 'or');
+        const view = args.view ?? 'tagged_list_item';
+        const typeArg = args.type ? normalizeType(String(args.type)) : null;
+        if (args.type && !typeArg)
+            return fail('INVALID_TYPE', `unknown entity type '${args.type}'`);
+        if (typeArg) {
+            const lookup = wrapDb(() => ctx.reader.findByTag({ type: typeArg, tags, filter }));
+            if (!lookup.ok)
+                return lookup.response;
+            const items = lookup.value.map((entity) => ({
+                slug: entity.slug,
+                ...envelope(deps.registry.serializeEntity(typeArg, view, entity, ctx.reader)),
+            }));
+            return ok({ type: typeArg, view, query: { tags, filter }, items });
+        }
+        const lookup = wrapDb(() => ctx.reader.findByTag({ tags, filter }));
+        if (!lookup.ok)
+            return lookup.response;
+        const groups = {
+            endpoints: [],
+            dtos: [],
+            'database-tables': [],
+            'ui-views': [],
+            acs: [],
+        };
+        const bucket = {
+            endpoint: 'endpoints',
+            dto: 'dtos',
+            'database-table': 'database-tables',
+            'ui-view': 'ui-views',
+            ac: 'acs',
+        };
+        for (const entity of lookup.value) {
+            const item = {
+                slug: entity.slug,
+                ...envelope(deps.registry.serializeEntity(entity.type, view, entity, ctx.reader)),
+            };
+            groups[bucket[entity.type]].push(item);
+        }
+        return ok({ view, query: { tags, filter }, ...groups });
+    });
+    const getSection = mcpTool('get_section', 'Get a documentation section by anchor.', {
+        anchor: z.string().describe('Section anchor (8-char id)'),
+        view: z.enum(VIEW_KINDS).optional().describe('Response shape; default: single_element'),
+    }, async (args) => {
+        const ctx = requireProject();
+        if (!ctx.ok)
+            return ctx.response;
+        const anchor = String(args.anchor);
+        const view = args.view ?? 'single_element';
+        const lookup = wrapDb(() => ctx.reader.getSection(anchor));
+        if (!lookup.ok)
+            return lookup.response;
+        if (!lookup.value)
+            return fail('SECTION_NOT_FOUND', `section '${anchor}' not found`);
+        const serialized = deps.registry.serializeSection(view, lookup.value, ctx.reader);
+        return ok({
+            anchor,
+            view,
+            ...envelope(serialized),
+        });
+    });
+    const resolvePage = mcpTool('resolve_page', 'Resolve all XML tags in a markdown file. Returns either { content } with tags expanded inline (format: inline) or { content, resolved: [...] } with the original markdown plus a sidecar of structured resolutions (format: json). Path is resolved relative to the project dir if relative; absolute paths are used as-is.', {
+        path: z.string().describe('File path; absolute or relative to the project dir'),
+        format: z.enum(['inline', 'json']).optional().describe('Output format; default: inline'),
+    }, async (args) => {
+        const ctx = requireProject();
+        if (!ctx.ok)
+            return ctx.response;
+        const rel = String(args.path);
+        const abs = path.isAbsolute(rel) ? rel : path.resolve(ctx.projectDir, rel);
+        if (!fs.existsSync(abs))
+            return fail('FILE_NOT_FOUND', `file not found: ${abs}`);
+        const md = fs.readFileSync(abs, 'utf8');
+        const result = wrapDb(() => resolvePageContent(md, { reader: ctx.reader, registry: deps.registry }));
+        if (!result.ok)
+            return result.response;
+        const format = args.format ?? 'inline';
+        if (format === 'json') {
+            const sidecar = result.value.resolved.map(({ inline: _inline, ...rest }) => rest);
+            return ok({ path: abs, content: md, resolved: sidecar });
+        }
+        return ok({ path: abs, content: result.value.inlineContent });
+    });
+    const catalog = mcpTool('catalog', 'Discover all entity types, their available views, JSON Schemas per view, and per-type version. Returns { types: { [type]: { version, views, schemas } }, claude4spec }. Use this to learn what get_entity/get_entities can return.', {}, async () => {
+        const ctx = requireProject();
+        if (!ctx.ok)
+            return ctx.response;
+        const result = wrapDb(() => deps.registry.catalog(ctx.reader, ctx.db));
+        if (!result.ok)
+            return result.response;
+        return ok({ ...result.value, claude4spec: deps.packageVersion });
+    });
+    const listTags = mcpTool('list_tags', 'List all tags in the project with per-type usage counts. Returns { tags: [{ slug, name, color, description, counts }] }.', {}, async () => {
+        const ctx = requireProject();
+        if (!ctx.ok)
+            return ctx.response;
+        const result = wrapDb(() => ctx.reader.listTags());
+        if (!result.ok)
+            return result.response;
+        return ok({ tags: result.value });
+    });
+    const listSlugs = mcpTool('list_slugs', 'List all entity slugs of a given type (fast autocomplete for agents). Returns { type, slugs }. The optional filterTag parameter restricts results to entities tagged with that tag slug.', {
+        type: z.enum(ENTITY_TYPE_VALUES).describe('Entity type'),
+        filterTag: z.string().optional().describe('Restrict to entities tagged with this tag slug'),
+    }, async (args) => {
+        const ctx = requireProject();
+        if (!ctx.ok)
+            return ctx.response;
+        const type = normalizeType(String(args.type));
+        if (!type)
+            return fail('INVALID_TYPE', `unknown entity type '${args.type}'`);
+        const filterTag = args.filterTag ? String(args.filterTag) : undefined;
+        if (filterTag) {
+            const lookup = wrapDb(() => ctx.reader.findByTag({ type, tags: [filterTag], filter: 'and' }));
+            if (!lookup.ok)
+                return lookup.response;
+            return ok({ type, filterTag, slugs: lookup.value.map((e) => e.slug) });
+        }
+        const lookup = wrapDb(() => ctx.reader.listSlugs(type));
+        if (!lookup.ok)
+            return lookup.response;
+        return ok({ type, slugs: lookup.value });
+    });
+    return createMcpServer({
+        name: 'c4s-reader',
+        version: deps.packageVersion,
+        tools: [getEntity, getEntities, findByTag, getSection, resolvePage, catalog, listTags, listSlugs],
+    });
+}
+function envelope(result) {
+    const data = result.data;
+    if (typeof data === 'object' && data !== null) {
+        return {
+            data,
+            ...(result.fallback ? { fallback: true } : {}),
+            ...(result.error ? { error: result.error } : {}),
+            ...(result.brokenRefs ? { brokenRefs: result.brokenRefs } : {}),
+        };
+    }
+    return {
+        data,
+        ...(result.fallback ? { fallback: true } : {}),
+        ...(result.error ? { error: result.error } : {}),
+    };
+}
+//# sourceMappingURL=c4s-reader.js.map

package/dist/server/mcp/c4s-reader.js.map

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

package/dist/server/mcp/database-tools.d.ts

@@ -0,0 +1,10 @@
+import { type McpServerInstance } from '@inharness/agent-adapters';
+import type { DatabaseTableService } from '../services/database-table.js';
+import type { ReferencesService } from '../services/references.js';
+import type { WsGateway } from '../ws/gateway.js';
+export interface DatabaseToolsDeps {
+    databaseTableService: DatabaseTableService;
+    referencesService: ReferencesService;
+    ws: WsGateway;
+}
+export declare function createDatabaseToolsServer(deps: DatabaseToolsDeps): McpServerInstance;