@inharness-ai/claude4spec 1.0.0

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

@@ -0,0 +1,141 @@
+import { createMcpServer, mcpTool } from '@inharness-ai/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=mcp-server.js.map

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

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

package/dist/server/entities/dto/plugin.d.ts

@@ -0,0 +1,2 @@
+import type { BackendModule } from '../../core/plugin-host/types.js';
+export declare const dtoBackendModule: BackendModule;

package/dist/server/entities/dto/plugin.js

@@ -0,0 +1,33 @@
+import { pluginHost } from '../../core/plugin-host/host.js';
+import { dtoSlug } from '../../services/slug.js';
+import { dtoSerializer } from './serializer.js';
+import { dtoSystemPrompt } from './system-prompt.js';
+import { dtosRouter } from './routes.js';
+import { DtoService } from './services.js';
+import { createDtoToolsServer } from './mcp-server.js';
+export const dtoBackendModule = {
+    type: 'dto',
+    table: 'dto',
+    label: 'DTO',
+    labelPlural: 'DTOs',
+    displayOrder: 20,
+    pathPrefix: '/dtos',
+    slugFrom: (data) => dtoSlug(data.name),
+    serializer: dtoSerializer,
+    systemPrompt: dtoSystemPrompt,
+    backend: {
+        mount(ctx) {
+            const service = new DtoService(ctx.db, ctx.tagsService, ctx.versionService);
+            ctx.app.use(`/api${dtoBackendModule.pathPrefix}`, dtosRouter(service, ctx.referencesService));
+            ctx.registerMcpServer(`${dtoBackendModule.type}-tools`, createDtoToolsServer({
+                dtoService: service,
+                referencesService: ctx.referencesService,
+                ws: ctx.ws,
+            }));
+            ctx.setIdResolver(dtoBackendModule.type, (slug) => service.getIdBySlug(slug));
+            ctx.registerEntityService(dtoBackendModule.type, service);
+        },
+    },
+};
+pluginHost.registerBackendModule(dtoBackendModule);
+//# sourceMappingURL=plugin.js.map

package/dist/server/entities/dto/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../../src/server/entities/dto/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,CAAC,MAAM,gBAAgB,GAAkB;IAC7C,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,KAAK;IACZ,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,EAAE;IAChB,UAAU,EAAE,OAAO;IACnB,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAE,IAAyB,CAAC,IAAI,CAAC;IAC5D,UAAU,EAAE,aAA0C;IACtD,YAAY,EAAE,eAAe;IAC7B,OAAO,EAAE;QACP,KAAK,CAAC,GAAG;YACP,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;YAC5E,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,gBAAgB,CAAC,UAAU,EAAE,EAAE,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;YAC9F,GAAG,CAAC,iBAAiB,CACnB,GAAG,gBAAgB,CAAC,IAAI,QAAQ,EAChC,oBAAoB,CAAC;gBACnB,UAAU,EAAE,OAAO;gBACnB,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;gBACxC,EAAE,EAAE,GAAG,CAAC,EAAE;aACX,CAAC,CACH,CAAC;YACF,GAAG,CAAC,aAAa,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9E,GAAG,CAAC,qBAAqB,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC;KACF;CACF,CAAC;AAEF,UAAU,CAAC,qBAAqB,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/server/entities/dto/routes.d.ts

@@ -0,0 +1,4 @@
+import { Router } from 'express';
+import type { DtoService } from './services.js';
+import type { ReferencesService } from '../../services/references.js';
+export declare function dtosRouter(dtos: DtoService, references: ReferencesService): Router;

package/dist/server/entities/dto/routes.js

@@ -0,0 +1,74 @@
+import { Router } from 'express';
+import { errorHandler } from '../../routes/errors.js';
+export function dtosRouter(dtos, references) {
+    const router = Router();
+    router.get('/', (req, res, next) => {
+        try {
+            const q = req.query;
+            const tags = typeof q.tags === 'string' ? q.tags.split(',').filter(Boolean) : undefined;
+            const filter = q.tagFilter === 'and' || q.tagFilter === 'or' ? q.tagFilter : undefined;
+            const query = {
+                tags,
+                tagFilter: filter,
+                search: typeof q.search === 'string' ? q.search : undefined,
+                limit: q.limit ? Number(q.limit) : undefined,
+                offset: q.offset ? Number(q.offset) : undefined,
+            };
+            res.json({ dtos: dtos.list(query) });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.post('/', (req, res, next) => {
+        try {
+            const body = req.body;
+            res.status(201).json(dtos.create(body, 'user'));
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.get('/:slug', (req, res, next) => {
+        try {
+            const dto = dtos.getBySlug(req.params.slug);
+            if (!dto)
+                return res.status(404).json({ error: { code: 'NOT_FOUND', message: 'dto not found' } });
+            res.json(dto);
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.patch('/:slug', async (req, res, next) => {
+        try {
+            const body = req.body;
+            const { dto, previousSlug } = dtos.update(req.params.slug, body, 'user');
+            if (dto.slug !== previousSlug) {
+                await references.propagateSlugChange('dto', previousSlug, dto.slug);
+            }
+            res.json(dto);
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.delete('/:slug', async (req, res, next) => {
+        try {
+            const broken = await references.findReferences('dto', req.params.slug);
+            res.json(dtos.remove(req.params.slug, 'user', broken.map((b) => ({
+                pagePath: b.pagePath,
+                tagType: b.tagType,
+                line: b.line,
+                slug: req.params.slug,
+                type: 'dto',
+            }))));
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.use(errorHandler);
+    return router;
+}
+//# sourceMappingURL=routes.js.map

package/dist/server/entities/dto/routes.js.map

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

package/dist/server/entities/dto/serializer.d.ts

@@ -0,0 +1,12 @@
+import type { RawEntity } from '../../domain/raw-entity-reader.js';
+import type { EntitySerializer } from '../../serialization/types.js';
+import type { DtoExample, DtoField } from '../../../shared/entities.js';
+export interface DtoSnapshot {
+    slug: string;
+    name: string;
+    description: string | null;
+    fields: DtoField[];
+    examples: DtoExample[];
+    tags: string[];
+}
+export declare const dtoSerializer: EntitySerializer<RawEntity>;

package/dist/server/entities/dto/serializer.js

@@ -0,0 +1,184 @@
+function baseSingle(entity) {
+    return {
+        type: 'dto',
+        slug: entity.slug,
+        name: entity.data.name,
+        description: entity.data.description ?? null,
+        fields: entity.data.fields ?? [],
+        examples: entity.data.examples ?? [],
+        tags: entity.tags,
+    };
+}
+function buildSnapshot(entity) {
+    return {
+        slug: entity.slug,
+        name: entity.data.name,
+        description: entity.data.description ?? null,
+        fields: (entity.data.fields ?? []).map((f) => ({
+            name: f.name,
+            type: f.type,
+            required: f.required,
+            ...(f.description !== undefined ? { description: f.description } : {}),
+        })),
+        examples: (entity.data.examples ?? []).map((e) => ({
+            name: e.name,
+            ...(e.summary !== undefined ? { summary: e.summary } : {}),
+            value: e.value,
+        })),
+        tags: [...entity.tags].sort(),
+    };
+}
+function coerceDto(raw) {
+    const r = (raw ?? {});
+    return {
+        slug: String(r.slug ?? ''),
+        name: String(r.name ?? ''),
+        description: r.description ?? null,
+        fields: Array.isArray(r.fields) ? r.fields : [],
+        examples: Array.isArray(r.examples) ? r.examples : [],
+        tags: Array.isArray(r.tags) ? r.tags : [],
+    };
+}
+function dtoDiff(a, b, slug) {
+    if (a == null && b == null)
+        return { type: 'dto', slug, op: 'noop' };
+    if (a == null)
+        return { type: 'dto', slug, op: 'created' };
+    if (b == null)
+        return { type: 'dto', slug, op: 'deleted' };
+    const sa = coerceDto(a);
+    const sb = coerceDto(b);
+    const changes = {};
+    // Meta
+    const metaChanges = [];
+    if (sa.name !== sb.name)
+        metaChanges.push({ field: 'name', from: sa.name, to: sb.name });
+    if (sa.description !== sb.description)
+        metaChanges.push({ field: 'description', from: sa.description, to: sb.description });
+    if (metaChanges.length)
+        changes.meta_changes = metaChanges;
+    // Fields by name
+    const aFields = new Map(sa.fields.map((f) => [f.name, f]));
+    const bFields = new Map(sb.fields.map((f) => [f.name, f]));
+    const fieldAdded = [];
+    const fieldRemoved = [];
+    const fieldModified = [];
+    for (const [name, f] of bFields) {
+        if (!aFields.has(name))
+            fieldAdded.push({ name, type: f.type, required: f.required });
+    }
+    for (const [name, f] of aFields) {
+        const other = bFields.get(name);
+        if (!other) {
+            fieldRemoved.push({ name, type: f.type, required: f.required });
+            continue;
+        }
+        const fc = { name };
+        if (f.type !== other.type)
+            fc.type_changed = { from: f.type, to: other.type };
+        if (f.required !== other.required)
+            fc.required_changed = { from: f.required, to: other.required };
+        if (f.description !== other.description)
+            fc.description_changed = { from: f.description ?? null, to: other.description ?? null };
+        if (Object.keys(fc).length > 1)
+            fieldModified.push(fc);
+    }
+    if (fieldAdded.length)
+        changes.field_added = fieldAdded;
+    if (fieldRemoved.length)
+        changes.field_removed = fieldRemoved;
+    if (fieldModified.length)
+        changes.field_modified = fieldModified;
+    // Examples by name
+    const aEx = new Map(sa.examples.map((e) => [e.name, e]));
+    const bEx = new Map(sb.examples.map((e) => [e.name, e]));
+    const exAdded = [];
+    const exRemoved = [];
+    const exModified = [];
+    for (const [name] of bEx)
+        if (!aEx.has(name))
+            exAdded.push({ name });
+    for (const [name, e] of aEx) {
+        const other = bEx.get(name);
+        if (!other) {
+            exRemoved.push({ name });
+            continue;
+        }
+        const summaryChanged = (e.summary ?? null) !== (other.summary ?? null);
+        const valueChanged = JSON.stringify(e.value) !== JSON.stringify(other.value);
+        if (summaryChanged || valueChanged) {
+            exModified.push({
+                name,
+                ...(summaryChanged ? { summary_changed: true } : {}),
+                ...(valueChanged ? { value_changed: true } : {}),
+            });
+        }
+    }
+    if (exAdded.length)
+        changes.example_added = exAdded;
+    if (exRemoved.length)
+        changes.example_removed = exRemoved;
+    if (exModified.length)
+        changes.example_modified = exModified;
+    // Tags (set)
+    const tagAdded = sb.tags.filter((t) => !sa.tags.includes(t));
+    const tagRemoved = sa.tags.filter((t) => !sb.tags.includes(t));
+    if (tagAdded.length)
+        changes.tag_added = tagAdded;
+    if (tagRemoved.length)
+        changes.tag_removed = tagRemoved;
+    if (Object.keys(changes).length === 0)
+        return { type: 'dto', slug, op: 'noop' };
+    return { type: 'dto', slug, op: 'modified', changes };
+}
+function dtoRestore(data, ctx) {
+    const snap = data;
+    const result = ctx.writer.upsertDto(snap.slug, {
+        name: snap.name,
+        description: snap.description ?? undefined,
+        fields: snap.fields,
+        examples: snap.examples,
+        slug: snap.slug,
+    }, ctx.actor);
+    ctx.writer.syncTags('dto', snap.slug, snap.tags);
+    return { op: result.op, entity: result.entity };
+}
+export const dtoSerializer = {
+    type: 'dto',
+    version: '1.1.0',
+    inlineMention: (entity) => ({
+        type: 'dto',
+        slug: entity.slug,
+        label: entity.data.name ?? entity.slug,
+        href: `/dtos/${entity.slug}`,
+    }),
+    singleElement: (entity) => baseSingle(entity),
+    elementListItem: (entity) => baseSingle(entity),
+    taggedListItem: (entity) => baseSingle(entity),
+    detail: (entity, ctx) => {
+        const base = baseSingle(entity);
+        const endpoints = ctx.reader.findDtoEndpoints(entity.id).map((e) => ({
+            endpointSlug: e.endpointSlug,
+            method: e.method,
+            path: e.path,
+            relation: e.relation,
+            statusCode: e.statusCode,
+        }));
+        const references = ctx.reader.findSectionReferences('dto', entity.id).map((r) => ({
+            anchor: r.anchor,
+            pagePath: r.pagePath,
+            headingText: r.headingText,
+            relation: r.relation,
+        }));
+        return {
+            ...base,
+            endpoints,
+            _references: references,
+        };
+    },
+    // ─── M17 ───
+    snapshot: (entity) => buildSnapshot(entity),
+    restore: dtoRestore,
+    diff: dtoDiff,
+};
+//# sourceMappingURL=serializer.js.map

package/dist/server/entities/dto/serializer.js.map

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

package/dist/server/entities/dto/services.d.ts

@@ -0,0 +1,30 @@
+import type Database from 'better-sqlite3';
+import type { BrokenReference, ChangedBy, Dto, DtoCreateInput, DtoDeleteResult, DtoListQuery, DtoUpdateInput } from '../../../shared/entities.js';
+import type { TagsService } from '../../services/tags.js';
+import type { VersionService } from '../../services/versions.js';
+export declare class DtoService {
+    private db;
+    private tags;
+    private versions;
+    constructor(db: Database.Database, tags: TagsService, versions: VersionService);
+    create(input: DtoCreateInput, actor: ChangedBy): Dto;
+    list(query?: DtoListQuery): Dto[];
+    getBySlug(slug: string): Dto | null;
+    getIdBySlug(slug: string): number | null;
+    update(slug: string, input: DtoUpdateInput, actor: ChangedBy): {
+        dto: Dto;
+        previousSlug: string;
+    };
+    /**
+     * Idempotent UPSERT for M17 restore. CREATE if slug missing, UPDATE
+     * otherwise; preserves slug.
+     */
+    upsert(slug: string, input: DtoCreateInput, actor: ChangedBy): {
+        dto: Dto;
+        op: 'created' | 'updated';
+    };
+    remove(slug: string, actor: ChangedBy, brokenReferences?: BrokenReference[]): DtoDeleteResult;
+    private getByIdInternal;
+    private hydrate;
+    private getLinkedEndpoints;
+}