@inharness-ai/claude4spec 1.0.0

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

@@ -0,0 +1,184 @@
+import { createMcpServer, mcpTool } from '@inharness/agent-adapters';
+import { z } from 'zod';
+import { DomainError } from '../services/tags.js';
+export function createDatabaseToolsServer(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 columnSchema = z.object({
+        name: z.string(),
+        type: z.string(),
+        nullable: z.boolean().optional(),
+        unique: z.boolean().optional(),
+        pk: z.boolean().optional(),
+        fk: z
+            .object({
+            table: z.string(),
+            column: z.string(),
+        })
+            .optional(),
+        default: z.string().optional(),
+        enumValues: z.array(z.string()).optional(),
+        description: z.string().optional(),
+    });
+    const indexSchema = z.object({
+        columns: z.array(z.string()),
+        unique: z.boolean().optional(),
+        name: z.string().optional(),
+    });
+    const createDatabaseTable = mcpTool('create_database_table', 'Create a new database table (relational model, dialect-agnostic). Generates slug from name. Use to define table structure with columns and indexes.', {
+        name: z.string().describe('Table name (snake_case, e.g. users, order_items)'),
+        description: z.string().optional(),
+        columns: z.array(columnSchema).optional(),
+        indexes: z.array(indexSchema).optional(),
+        slug: z.string().optional(),
+        tags: z.array(z.string()).optional(),
+    }, async (args) => {
+        try {
+            const { dbTable, warnings } = deps.databaseTableService.create({
+                name: String(args.name),
+                description: args.description,
+                columns: args.columns ?? [],
+                indexes: args.indexes ?? [],
+                slug: args.slug,
+                tags: args.tags,
+            }, 'agent');
+            deps.ws.broadcast({
+                kind: 'entity:changed',
+                entityType: 'database-table',
+                slug: dbTable.slug,
+            });
+            return ok({
+                id: dbTable.slug,
+                slug: dbTable.slug,
+                type: 'database-table',
+                ...(warnings.length ? { warnings } : {}),
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const getDatabaseTable = mcpTool('get_database_table', 'Get full details of a database table by slug. Returns columns, indexes, and tags. Use to inspect table structure.', { slug: z.string() }, async (args) => {
+        const dbTable = deps.databaseTableService.getBySlug(String(args.slug));
+        if (!dbTable)
+            return fail(new DomainError('NOT_FOUND', `database table '${args.slug}' not found`));
+        return ok(dbTable);
+    });
+    const updateDatabaseTable = mcpTool('update_database_table', 'Update database table fields (partial update). Only provided fields are changed. Renaming slug auto-propagates XML references in markdown and fk.table values in other tables.', {
+        slug: z.string(),
+        data: z
+            .object({
+            name: z.string().optional(),
+            description: z.string().nullable().optional(),
+            columns: z.array(columnSchema).optional(),
+            indexes: z.array(indexSchema).optional(),
+        })
+            .describe('Partial fields to update'),
+        newSlug: z.string().optional(),
+    }, async (args) => {
+        try {
+            const data = args.data;
+            const { dbTable, previousSlug, warnings } = deps.databaseTableService.update(String(args.slug), {
+                name: data.name,
+                description: data.description,
+                columns: data.columns,
+                indexes: data.indexes,
+                newSlug: args.newSlug,
+            }, 'agent');
+            if (dbTable.slug !== previousSlug) {
+                await deps.referencesService.propagateSlugChange('database-table', previousSlug, dbTable.slug);
+                const { changedTables } = deps.databaseTableService.propagateFkSlugChange(previousSlug, dbTable.slug, 'agent');
+                for (const s of changedTables) {
+                    deps.ws.broadcast({
+                        kind: 'entity:changed',
+                        entityType: 'database-table',
+                        slug: s,
+                    });
+                }
+            }
+            deps.ws.broadcast({
+                kind: 'entity:changed',
+                entityType: 'database-table',
+                slug: dbTable.slug,
+            });
+            return ok({
+                slug: dbTable.slug,
+                updated: true,
+                ...(warnings.length ? { warnings } : {}),
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const deleteDatabaseTable = mcpTool('delete_database_table', 'Delete a database table. Returns list of pages with broken references and tables with dangling FKs (user/agent decides follow-up). Use with caution.', { slug: z.string() }, async (args) => {
+        try {
+            const slug = String(args.slug);
+            const refs = await deps.referencesService.findReferences('database-table', slug);
+            const result = deps.databaseTableService.remove(slug, 'agent');
+            deps.ws.broadcast({
+                kind: 'entity:changed',
+                entityType: 'database-table',
+                slug,
+            });
+            return ok({
+                deleted: true,
+                brokenReferences: refs.map((r) => ({ pagePath: r.pagePath, count: 1 })),
+                danglingFks: result.danglingFks,
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const listDatabaseTables = mcpTool('list_database_tables', 'List database tables with optional filtering by tags or search text. Use to find tables 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.databaseTableService.list({
+                tags: args.tags,
+                tagFilter: args.tagFilter,
+                search: args.search,
+                limit: args.limit,
+                offset: args.offset,
+            });
+            return ok({
+                tables: list.map((t) => ({
+                    slug: t.slug,
+                    name: t.name,
+                    description: t.description,
+                    columnCount: t.columns.length,
+                    tags: t.tags,
+                })),
+                total: list.length,
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    return createMcpServer({
+        name: 'database-tools',
+        tools: [
+            createDatabaseTable,
+            getDatabaseTable,
+            updateDatabaseTable,
+            deleteDatabaseTable,
+            listDatabaseTables,
+        ],
+    });
+}
+//# sourceMappingURL=database-tools.js.map

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

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

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

@@ -0,0 +1,12 @@
+import { type McpServerInstance } from '@inharness/agent-adapters';
+import type { SectionsService } from '../services/sections.js';
+import type { DependenciesService } from '../services/dependencies.js';
+import type { ReferencesService } from '../services/references.js';
+import type { WsGateway } from '../ws/gateway.js';
+export interface DependencyToolsDeps {
+    sectionsService: SectionsService;
+    dependenciesService: DependenciesService;
+    referencesService: ReferencesService;
+    ws: WsGateway;
+}
+export declare function createDependencyToolsServer(deps: DependencyToolsDeps): McpServerInstance;

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

@@ -0,0 +1,205 @@
+import { createMcpServer, mcpTool } from '@inharness/agent-adapters';
+import { z } from 'zod';
+import { DomainError } from '../services/tags.js';
+const RELATION_ENUM = z.enum([
+    'depends_on',
+    'implements',
+    'extends',
+    'example_of',
+    'contradicts',
+    'see_also',
+]);
+export function createDependencyToolsServer(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 resolveAnchor = (args) => {
+        if (typeof args.anchor === 'string' && args.anchor)
+            return args.anchor;
+        if (typeof args.pagePath === 'string' && args.pagePath) {
+            const list = deps.sectionsService.listByPage(args.pagePath);
+            if (typeof args.heading === 'string' && args.heading) {
+                const needle = args.heading.trim().toLowerCase();
+                const match = list.find((s) => s.headingText.trim().toLowerCase() === needle ||
+                    s.headingPath.toLowerCase().endsWith(needle));
+                return match?.anchor ?? null;
+            }
+            if (list.length === 1)
+                return list[0].anchor;
+        }
+        return null;
+    };
+    const impactAnalysis = mcpTool('impact_analysis', 'Analyze which sections depend on a target section. Use before editing a section to see what will need review.', {
+        anchor: z.string().optional().describe('Target section anchor ID'),
+        pagePath: z.string().optional(),
+        heading: z.string().optional(),
+    }, async (args) => {
+        try {
+            const anchor = resolveAnchor(args);
+            if (!anchor)
+                return fail(new DomainError('NOT_FOUND', 'could not resolve target anchor'));
+            const result = deps.dependenciesService.impactAnalysis(anchor);
+            if (!result)
+                return fail(new DomainError('NOT_FOUND', `section '${anchor}' not found`));
+            return ok(result);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const propagateChange = mcpTool('propagate_change', 'List all dependencies whose target is the given anchor and mark them as stale — useful after rewriting a section.', { anchor: z.string() }, async (args) => {
+        try {
+            const result = deps.dependenciesService.impactAnalysis(String(args.anchor));
+            return ok(result ?? { targetAnchor: args.anchor, dependents: [] });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const listStaleDependencies = mcpTool('list_stale_dependencies', 'List dependencies with status stale or broken — those requiring review.', { pagePath: z.string().optional() }, async (args) => {
+        try {
+            const stale = deps.dependenciesService.list({
+                status: 'stale',
+                pagePath: args.pagePath,
+            });
+            const broken = deps.dependenciesService.list({
+                status: 'broken',
+                pagePath: args.pagePath,
+            });
+            return ok({ stale, broken, counts: { stale: stale.length, broken: broken.length } });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const dependencyGraph = mcpTool('dependency_graph', 'Return full dependency graph: nodes (sections, each flagged isolated when it has no edges) + edges (dependencies) + detected cycles.', { scope: z.string().optional().describe('Optional pagePath prefix to scope the graph') }, async (args) => {
+        try {
+            const graph = deps.dependenciesService.graph({
+                pagePathPrefix: typeof args.scope === 'string' ? args.scope : undefined,
+                includeIsolated: true,
+            });
+            return ok(graph);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const sectionIndex = mcpTool('section_index', 'Read-only index of sections (anchors + headings). Useful to pick targets for dependencies.', { pagePath: z.string().optional() }, async (args) => {
+        try {
+            const list = typeof args.pagePath === 'string' && args.pagePath
+                ? deps.sectionsService.listByPage(args.pagePath)
+                : deps.sectionsService.list();
+            return ok({
+                sections: list.map((s) => ({
+                    anchor: s.anchor,
+                    pagePath: s.pagePath,
+                    headingText: s.headingText,
+                    headingPath: s.headingPath,
+                    headingLevel: s.headingLevel,
+                })),
+                total: list.length,
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const createDependency = mcpTool('create_dependency', 'Create a typed dependency (section → section). Idempotent on (source, target, relation). Also inserts a <section_ref/> XML tag in the source section.', {
+        sourceAnchor: z.string(),
+        targetAnchor: z.string(),
+        relation: RELATION_ENUM,
+        description: z.string().optional(),
+    }, async (args) => {
+        try {
+            const dep = deps.dependenciesService.create({
+                sourceAnchor: String(args.sourceAnchor),
+                targetAnchor: String(args.targetAnchor),
+                relation: args.relation,
+                description: args.description,
+            });
+            await deps.referencesService.insertSectionRef(dep.sourceAnchor, dep.targetAnchor, dep.relation);
+            return ok({ created: true, id: dep.id, dependency: dep });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const removeDependency = mcpTool('remove_dependency', 'Remove a dependency edge and its <section_ref/> tag from the source markdown.', {
+        sourceAnchor: z.string(),
+        targetAnchor: z.string(),
+        relation: RELATION_ENUM,
+    }, async (args) => {
+        try {
+            const all = deps.dependenciesService.list();
+            const match = all.find((d) => d.sourceAnchor === args.sourceAnchor &&
+                d.targetAnchor === args.targetAnchor &&
+                d.relation === args.relation);
+            if (!match)
+                return fail(new DomainError('NOT_FOUND', 'dependency not found'));
+            deps.dependenciesService.remove(match.id);
+            await deps.referencesService.removeSectionRef(String(args.sourceAnchor), String(args.targetAnchor), args.relation);
+            return ok({ removed: true });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const verifyDependency = mcpTool('verify_dependency', 'Mark a dependency as active (verified) — aligns last_verified_hash with current target content_hash.', {
+        sourceAnchor: z.string(),
+        targetAnchor: z.string(),
+        relation: RELATION_ENUM,
+    }, async (args) => {
+        try {
+            const all = deps.dependenciesService.list();
+            const match = all.find((d) => d.sourceAnchor === args.sourceAnchor &&
+                d.targetAnchor === args.targetAnchor &&
+                d.relation === args.relation);
+            if (!match)
+                return fail(new DomainError('NOT_FOUND', 'dependency not found'));
+            const verified = deps.dependenciesService.verify(match.id);
+            return ok({ verified: true, dependency: verified });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const suggestDependencies = mcpTool('suggest_dependencies', 'Heuristic suggestions for which sections could be linked as dependencies (shared entities, keyword overlap).', {
+        anchor: z.string().optional(),
+        pagePath: z.string().optional(),
+        heading: z.string().optional(),
+    }, async (args) => {
+        try {
+            const anchor = resolveAnchor(args);
+            if (!anchor)
+                return fail(new DomainError('NOT_FOUND', 'could not resolve anchor'));
+            const suggestions = deps.dependenciesService.suggest(anchor);
+            return ok({ anchor, suggestions });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    return createMcpServer({
+        name: 'dependency-tools',
+        tools: [
+            impactAnalysis,
+            propagateChange,
+            listStaleDependencies,
+            dependencyGraph,
+            sectionIndex,
+            createDependency,
+            removeDependency,
+            verifyDependency,
+            suggestDependencies,
+        ],
+    });
+}
+//# sourceMappingURL=dependency-tools.js.map

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

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

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

@@ -0,0 +1,10 @@
+import { type McpServerInstance } from '@inharness/agent-adapters';
+import type { DtoService } from '../services/dto.js';
+import type { ReferencesService } from '../services/references.js';
+import type { WsGateway } from '../ws/gateway.js';
+export interface DtoToolsDeps {
+    dtoService: DtoService;
+    referencesService: ReferencesService;
+    ws: WsGateway;
+}
+export declare function createDtoToolsServer(deps: DtoToolsDeps): McpServerInstance;

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

@@ -0,0 +1,141 @@
+import { createMcpServer, mcpTool } from '@inharness/agent-adapters';
+import { z } from 'zod';
+import { DomainError } from '../services/tags.js';
+export function createDtoToolsServer(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 fieldSchema = z.object({
+        name: z.string(),
+        type: z.string(),
+        required: z.boolean(),
+        description: z.string().optional(),
+    });
+    const exampleSchema = z.object({
+        name: z.string().describe('Identifier unique within DTO (e.g. "minimal", "full", "edge-case")'),
+        summary: z.string().optional(),
+        value: z.unknown().describe('Payload as-is. Soft-validated against fields[] (warning only).'),
+    });
+    const createDto = mcpTool('create_dto', 'Create a new DTO (Data Transfer Object). Generates slug from name. Use to define structured data contracts.', {
+        name: z.string().describe('DTO name (PascalCase, e.g. UserResponse)'),
+        description: z.string().optional(),
+        fields: z.array(fieldSchema).optional(),
+        examples: z
+            .array(exampleSchema)
+            .optional()
+            .describe('Named payload exemplars. Soft-validated. name unique within DTO.'),
+        tags: z.array(z.string()).optional(),
+    }, async (args) => {
+        try {
+            const dto = deps.dtoService.create({
+                name: String(args.name),
+                description: args.description,
+                fields: args.fields ?? [],
+                examples: args.examples ?? [],
+                tags: args.tags,
+            }, 'agent');
+            deps.ws.broadcast({ kind: 'entity:changed', entityType: 'dto', slug: dto.slug });
+            return ok({ id: dto.slug, slug: dto.slug, type: 'dto' });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const getDto = mcpTool('get_dto', 'Get full details of a DTO by slug. Returns all fields, examples, tags, and related endpoints.', { slug: z.string() }, async (args) => {
+        const dto = deps.dtoService.getBySlug(String(args.slug));
+        if (!dto)
+            return fail(new DomainError('NOT_FOUND', `dto '${args.slug}' not found`));
+        return ok(dto);
+    });
+    const updateDto = mcpTool('update_dto', 'Update DTO fields (partial update). Only provided fields are changed. Use newSlug for explicit rename; otherwise slug auto-regenerates if name changes.', {
+        slug: z.string(),
+        data: z
+            .object({
+            name: z.string().optional(),
+            description: z.string().nullable().optional(),
+            fields: z.array(fieldSchema).optional(),
+            examples: z
+                .array(exampleSchema)
+                .optional()
+                .describe('Full replace of examples array (not diff). Omit to leave unchanged.'),
+        })
+            .describe('Partial fields to update'),
+        newSlug: z.string().optional(),
+    }, async (args) => {
+        try {
+            const data = args.data;
+            const { dto, previousSlug } = deps.dtoService.update(String(args.slug), {
+                name: data.name,
+                description: data.description,
+                fields: data.fields,
+                examples: data.examples,
+                newSlug: args.newSlug,
+            }, 'agent');
+            if (dto.slug !== previousSlug) {
+                await deps.referencesService.propagateSlugChange('dto', previousSlug, dto.slug);
+            }
+            deps.ws.broadcast({ kind: 'entity:changed', entityType: 'dto', slug: dto.slug });
+            return ok({ slug: dto.slug, updated: true });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const deleteDto = mcpTool('delete_dto', 'Delete a DTO. 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('dto', slug);
+            deps.dtoService.remove(slug, 'agent');
+            deps.ws.broadcast({ kind: 'entity:changed', entityType: 'dto', slug });
+            return ok({
+                deleted: true,
+                brokenReferences: refs.map((r) => ({ pagePath: r.pagePath, count: 1 })),
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const listDtos = mcpTool('list_dtos', 'List DTOs with optional filtering by tags or search text.', {
+        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.dtoService.list({
+                tags: args.tags,
+                tagFilter: args.tagFilter,
+                search: args.search,
+                limit: args.limit,
+                offset: args.offset,
+            });
+            return ok({
+                dtos: list.map((d) => ({
+                    slug: d.slug,
+                    name: d.name,
+                    description: d.description,
+                    tags: d.tags,
+                })),
+                total: list.length,
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    return createMcpServer({
+        name: 'dto-tools',
+        tools: [createDto, getDto, updateDto, deleteDto, listDtos],
+    });
+}
+//# sourceMappingURL=dto-tools.js.map

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

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

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

@@ -0,0 +1,10 @@
+import { type McpServerInstance } from '@inharness/agent-adapters';
+import type { EndpointService } from '../services/endpoint.js';
+import type { ReferencesService } from '../services/references.js';
+import type { WsGateway } from '../ws/gateway.js';
+export interface EndpointToolsDeps {
+    endpointService: EndpointService;
+    referencesService: ReferencesService;
+    ws: WsGateway;
+}
+export declare function createEndpointToolsServer(deps: EndpointToolsDeps): McpServerInstance;