@inharness-ai/claude4spec 1.0.0

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

@@ -0,0 +1,156 @@
+import { createMcpServer, mcpTool } from '@inharness/agent-adapters';
+import { z } from 'zod';
+import { DomainError } from '../services/tags.js';
+export function createEndpointToolsServer(deps) {
+    const ok = (payload) => ({
+        content: [{ type: 'text', text: JSON.stringify(payload) }],
+    });
+    const fail = (err) => {
+        const code = err instanceof DomainError ? err.code : 'INTERNAL';
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: message, code }) }],
+            isError: true,
+        };
+    };
+    const createEndpoint = mcpTool('create_endpoint', 'Create a new HTTP endpoint entity. Generates slug from method+path. Use to define structured API endpoints in the specification.', {
+        method: z.string().describe('HTTP method: GET, POST, PUT, PATCH, DELETE'),
+        path: z.string().describe('URL path, e.g. /api/users/:id'),
+        summary: z.string().optional(),
+        description: z.string().optional(),
+        tags: z.array(z.string()).optional(),
+    }, async (args) => {
+        try {
+            const ep = deps.endpointService.create({
+                method: String(args.method).toUpperCase(),
+                path: String(args.path),
+                summary: args.summary,
+                description: args.description,
+                tags: args.tags,
+            }, 'agent');
+            deps.ws.broadcast({ kind: 'entity:changed', entityType: 'endpoint', slug: ep.slug });
+            return ok({ id: ep.slug, slug: ep.slug, type: 'endpoint' });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const getEndpoint = mcpTool('get_endpoint', 'Get full details of an endpoint by slug. Returns all fields, tags, and related DTOs. Use to inspect endpoint details.', { slug: z.string() }, async (args) => {
+        const ep = deps.endpointService.getBySlug(String(args.slug));
+        if (!ep)
+            return fail(new DomainError('NOT_FOUND', `endpoint '${args.slug}' not found`));
+        return ok(ep);
+    });
+    const updateEndpoint = mcpTool('update_endpoint', 'Update endpoint fields (partial update). Only provided fields are changed. Use newSlug for explicit rename; otherwise slug auto-regenerates if method/path change.', {
+        slug: z.string(),
+        data: z
+            .object({
+            method: z.string().optional(),
+            path: z.string().optional(),
+            summary: z.string().optional(),
+            description: z.string().nullable().optional(),
+        })
+            .describe('Partial fields to update'),
+        newSlug: z.string().optional(),
+    }, async (args) => {
+        try {
+            const data = args.data;
+            const ep = deps.endpointService.update(String(args.slug), {
+                method: data.method ? String(data.method).toUpperCase() : undefined,
+                path: data.path,
+                summary: data.summary,
+                description: data.description,
+                newSlug: args.newSlug,
+            }, 'agent');
+            const slugChanged = ep.slug !== args.slug;
+            if (slugChanged) {
+                await deps.referencesService.propagateSlugChange('endpoint', String(args.slug), ep.slug);
+            }
+            deps.ws.broadcast({ kind: 'entity:changed', entityType: 'endpoint', slug: ep.slug });
+            return ok({ slug: ep.slug, updated: true });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const deleteEndpoint = mcpTool('delete_endpoint', 'Delete an endpoint. Returns list of pages with broken references. Use with caution.', { slug: z.string() }, async (args) => {
+        try {
+            const slug = String(args.slug);
+            const refs = await deps.referencesService.findReferences('endpoint', slug);
+            const result = deps.endpointService.remove(slug, 'agent');
+            deps.ws.broadcast({ kind: 'entity:changed', entityType: 'endpoint', slug });
+            return ok({
+                deleted: true,
+                brokenReferences: refs.map((r) => ({ pagePath: r.pagePath, count: 1 })),
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const listEndpoints = mcpTool('list_endpoints', 'List endpoints with optional filtering by tags or search text. Use to find endpoints or get an overview.', {
+        tags: z.array(z.string()).optional(),
+        tagFilter: z.enum(['and', 'or']).optional(),
+        search: z.string().optional(),
+        limit: z.number().optional(),
+        offset: z.number().optional(),
+    }, async (args) => {
+        try {
+            const list = deps.endpointService.list({
+                tags: args.tags,
+                tagFilter: args.tagFilter,
+                search: args.search,
+                limit: args.limit,
+                offset: args.offset,
+            });
+            return ok({
+                endpoints: list.map((e) => ({
+                    slug: e.slug,
+                    method: e.method,
+                    path: e.path,
+                    summary: e.summary,
+                    tags: e.tags,
+                })),
+                total: list.length,
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const linkDto = mcpTool('link_dto', 'Link a DTO to an endpoint as request body, response, or error response. Optional HTTP status code for response/error. Idempotent.', {
+        endpointSlug: z.string(),
+        dtoSlug: z.string(),
+        relation: z.enum(['request', 'response', 'error']),
+        statusCode: z.number().optional(),
+    }, async (args) => {
+        try {
+            deps.endpointService.linkDto(String(args.endpointSlug), String(args.dtoSlug), args.relation, args.statusCode ?? null);
+            deps.ws.broadcast({ kind: 'entity:changed', entityType: 'endpoint', slug: String(args.endpointSlug) });
+            return ok({ linked: true });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const unlinkDto = mcpTool('unlink_dto', 'Remove a DTO link from an endpoint. Omit statusCode to remove all links (endpoint, dto, relation).', {
+        endpointSlug: z.string(),
+        dtoSlug: z.string(),
+        relation: z.enum(['request', 'response', 'error']),
+        statusCode: z.number().optional(),
+    }, async (args) => {
+        try {
+            deps.endpointService.unlinkDto(String(args.endpointSlug), String(args.dtoSlug), args.relation, args.statusCode ?? null);
+            deps.ws.broadcast({ kind: 'entity:changed', entityType: 'endpoint', slug: String(args.endpointSlug) });
+            return ok({ unlinked: true });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    return createMcpServer({
+        name: 'endpoint-tools',
+        tools: [createEndpoint, getEndpoint, updateEndpoint, deleteEndpoint, listEndpoints, linkDto, unlinkDto],
+    });
+}
+//# sourceMappingURL=endpoint-tools.js.map

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

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

package/dist/server/mcp/ensure-mcp-json.d.ts

@@ -0,0 +1,6 @@
+export declare function renderMcpJson({ projectAbsPath }: {
+    projectAbsPath: string;
+}): string;
+export declare function ensureMcpJson({ projectAbsPath }: {
+    projectAbsPath: string;
+}): void;

package/dist/server/mcp/ensure-mcp-json.js

@@ -0,0 +1,30 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+export function renderMcpJson({ projectAbsPath }) {
+    return (JSON.stringify({
+        mcpServers: {
+            'c4s-spec-reader': {
+                command: 'npx',
+                args: ['-y', 'claude4spec', 'c4s-mcp', '--project', projectAbsPath],
+            },
+        },
+    }, null, 2) + '\n');
+}
+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');
+}
+export function ensureMcpJson({ projectAbsPath }) {
+    const mcpPath = path.join(projectAbsPath, '.claude4spec', 'mcp.json');
+    writeIfChanged(mcpPath, renderMcpJson({ projectAbsPath }));
+}
+//# sourceMappingURL=ensure-mcp-json.js.map

package/dist/server/mcp/ensure-mcp-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-mcp-json.js","sourceRoot":"","sources":["../../../src/server/mcp/ensure-mcp-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,aAAa,CAAC,EAAE,cAAc,EAA8B;IAC1E,OAAO,CACL,IAAI,CAAC,SAAS,CACZ;QACE,UAAU,EAAE;YACV,iBAAiB,EAAE;gBACjB,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,CAAC;aACpE;SACF;KACF,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CACT,CAAC;AACJ,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,MAAM,UAAU,aAAa,CAAC,EAAE,cAAc,EAA8B;IAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;IACtE,cAAc,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { McpServerInstance } from '@inharness/agent-adapters';
+import type { EndpointService } from '../entities/endpoint/services.js';
+import type { DtoService } from '../entities/dto/services.js';
+import type { DatabaseTableService } from '../entities/database-table/services.js';
+import type { UiViewService } from '../entities/ui-view/services.js';
+import type { TagsService } from '../services/tags.js';
+import type { ReferencesService } from '../services/references.js';
+import type { PagesService } from '../services/pages.js';
+import type { SectionsService } from '../services/sections.js';
+import type { WsGateway } from '../ws/gateway.js';
+export interface McpDeps {
+    endpointService: EndpointService;
+    dtoService: DtoService;
+    databaseTableService: DatabaseTableService;
+    uiViewService: UiViewService;
+    tagsService: TagsService;
+    referencesService: ReferencesService;
+    pagesService: PagesService;
+    sectionsService: SectionsService;
+    ws: WsGateway;
+}
+export interface McpServers {
+    endpointTools: McpServerInstance;
+    dtoTools: McpServerInstance;
+    databaseTableTools: McpServerInstance;
+    uiViewTools: McpServerInstance;
+    referenceTools: McpServerInstance;
+}
+export declare function createMcpServers(deps: McpDeps): McpServers;

package/dist/server/mcp/index.js

@@ -0,0 +1,40 @@
+import { createEndpointToolsServer } from '../entities/endpoint/mcp-server.js';
+import { createDtoToolsServer } from '../entities/dto/mcp-server.js';
+import { createDatabaseToolsServer } from '../entities/database-table/mcp-server.js';
+import { createUiViewToolsServer } from '../entities/ui-view/mcp-server.js';
+import { createReferenceToolsServer } from './reference-tools.js';
+export function createMcpServers(deps) {
+    return {
+        endpointTools: createEndpointToolsServer({
+            endpointService: deps.endpointService,
+            referencesService: deps.referencesService,
+            ws: deps.ws,
+        }),
+        dtoTools: createDtoToolsServer({
+            dtoService: deps.dtoService,
+            referencesService: deps.referencesService,
+            ws: deps.ws,
+        }),
+        databaseTableTools: createDatabaseToolsServer({
+            databaseTableService: deps.databaseTableService,
+            referencesService: deps.referencesService,
+            ws: deps.ws,
+        }),
+        uiViewTools: createUiViewToolsServer({
+            uiViewService: deps.uiViewService,
+            referencesService: deps.referencesService,
+            ws: deps.ws,
+        }),
+        referenceTools: createReferenceToolsServer({
+            tagsService: deps.tagsService,
+            referencesService: deps.referencesService,
+            endpointService: deps.endpointService,
+            dtoService: deps.dtoService,
+            databaseTableService: deps.databaseTableService,
+            uiViewService: deps.uiViewService,
+            pagesService: deps.pagesService,
+            ws: deps.ws,
+        }),
+    };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/mcp/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAsBlE,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO;QACL,aAAa,EAAE,yBAAyB,CAAC;YACvC,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,EAAE,EAAE,IAAI,CAAC,EAAE;SACZ,CAAC;QACF,QAAQ,EAAE,oBAAoB,CAAC;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,EAAE,EAAE,IAAI,CAAC,EAAE;SACZ,CAAC;QACF,kBAAkB,EAAE,yBAAyB,CAAC;YAC5C,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,EAAE,EAAE,IAAI,CAAC,EAAE;SACZ,CAAC;QACF,WAAW,EAAE,uBAAuB,CAAC;YACnC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,EAAE,EAAE,IAAI,CAAC,EAAE;SACZ,CAAC;QACF,cAAc,EAAE,0BAA0B,CAAC;YACzC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,EAAE,EAAE,IAAI,CAAC,EAAE;SACZ,CAAC;KACH,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,7 @@
+import { type McpServerInstance } from '@inharness-ai/agent-adapters';
+import type { PlanService } from '../services/plan.js';
+export interface PlanToolsContext {
+    threadId: string;
+    planService: PlanService;
+}
+export declare function buildPlanToolsServer(ctx: PlanToolsContext): McpServerInstance;

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

@@ -0,0 +1,105 @@
+import { createMcpServer, mcpTool } from '@inharness-ai/agent-adapters';
+import { z } from 'zod';
+import { DomainError } from '../services/tags.js';
+const AGENT_ACTIONS = z.enum(['replace', 'append', 'insert_after_section']);
+export function buildPlanToolsServer(ctx) {
+    const { threadId, planService } = ctx;
+    const ok = (payload) => ({
+        content: [{ type: 'text', text: JSON.stringify(payload) }],
+    });
+    const fail = (err) => {
+        const code = err instanceof DomainError ? err.code : 'INTERNAL';
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: message, code }) }],
+            isError: true,
+        };
+    };
+    const getPlan = mcpTool('get_plan', 'Get the current plan attached to this thread (latest content, version). Returns { plan: null } if the thread has no plan yet. Use to inspect plan state before updating — especially when a <system-reminder> notes the plan was edited in another thread.', {}, async () => {
+        try {
+            const plan = planService.getByThread(threadId);
+            if (plan)
+                planService.markPlanSeenByThread(threadId);
+            return ok({ plan });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const updatePlan = mcpTool('update_plan', [
+        'Create or update the deployment plan attached to this thread.',
+        'Hybrid write tool with three actions:',
+        '- replace: full rewrite of the plan (provide full markdown in `content`).',
+        '- append: append a fragment at the end of the plan (separator added automatically).',
+        '- insert_after_section: insert a fragment after a target section (body of that section ends before the next heading of equal/higher level). Requires `anchor` or `heading`.',
+        'Section anchors (nanoid-8 HTML comments) are auto-injected into new headings before persisting.',
+        'Each call creates an immutable snapshot in plan_version and bumps current_version GLOBALLY for the plan (model N:1 — versions are linear, last-write-wins; if another thread bumped the plan since you last saw it, the user message that triggered this turn will contain a <system-reminder> noting the new version — call get_plan first to refresh).',
+        'On first call in a thread without a plan, this upserts a new plan and attaches it to the thread.',
+        'Available in plan_mode=true (preferred) and plan_mode=false.',
+    ].join('\n'), {
+        action: AGENT_ACTIONS,
+        content: z.string(),
+        anchor: z.string().optional(),
+        heading: z.string().optional(),
+        changeSummary: z.string(),
+    }, async (args) => {
+        try {
+            const action = args.action;
+            const result = planService.update({
+                threadId,
+                action,
+                content: String(args.content ?? ''),
+                anchor: typeof args.anchor === 'string' ? args.anchor : undefined,
+                heading: typeof args.heading === 'string' ? args.heading : undefined,
+                changeSummary: String(args.changeSummary ?? ''),
+                changedBy: 'agent',
+            });
+            return ok({
+                planId: result.plan.id,
+                version: result.version,
+                currentVersion: result.plan.currentVersion,
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const listPlanVersions = mcpTool('list_plan_versions', "List all versions of this thread's plan (metadata only, no full content). Use for audit / timeline rendering or before calling get_plan_version.", {
+        limit: z.number().int().positive().optional(),
+        offset: z.number().int().nonnegative().optional(),
+    }, async (args) => {
+        try {
+            const plan = planService.getByThread(threadId);
+            if (!plan)
+                return ok({ versions: [], total: 0 });
+            const result = planService.listVersions(plan.id, {
+                limit: typeof args.limit === 'number' ? args.limit : undefined,
+                offset: typeof args.offset === 'number' ? args.offset : undefined,
+            });
+            return ok(result);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const getPlanVersion = mcpTool('get_plan_version', 'Get a specific version snapshot with full content. Use to inspect historical plan state or prepare a diff locally.', {
+        version: z.number().int().positive(),
+    }, async (args) => {
+        try {
+            const plan = planService.getByThread(threadId);
+            if (!plan) {
+                return fail(new DomainError('VERSION_NOT_FOUND', 'thread has no plan'));
+            }
+            const v = planService.getVersion(plan.id, Number(args.version));
+            return ok(v);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    return createMcpServer({
+        name: 'plan-tools',
+        tools: [getPlan, updatePlan, listPlanVersions, getPlanVersion],
+    });
+}
+//# sourceMappingURL=plan-tools.js.map

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

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

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

@@ -0,0 +1,17 @@
+import { type McpServerInstance } from '@inharness-ai/agent-adapters';
+import type { Database } from 'better-sqlite3';
+import type { TagsService } from '../services/tags.js';
+import type { ReferencesService } from '../services/references.js';
+import type { PagesService } from '../services/pages.js';
+import type { SectionsService } from '../services/sections.js';
+import type { WsGateway } from '../ws/gateway.js';
+export interface ReferenceToolsDeps {
+    tagsService: TagsService;
+    referencesService: ReferencesService;
+    pagesService: PagesService;
+    sectionsService: SectionsService;
+    ws: WsGateway;
+    db: Database;
+    cwd: string;
+}
+export declare function createReferenceToolsServer(deps: ReferenceToolsDeps): McpServerInstance;