@inharness-ai/claude4spec 1.0.18 → 1.0.19

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

@@ -0,0 +1,141 @@
+import { createMcpServer, mcpTool } from '@inharness-ai/agent-adapters';
+import { z } from 'zod';
+import { validateDiagramSource } from './validate.js';
+import { DomainError } from '../../services/tags.js';
+const formatSchema = z.enum(['mermaid', 'd2']);
+export function createDiagramToolsServer(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 createDiagram = mcpTool('create_diagram', 'Create a new diagram entity. The DSL `source` is the source of truth (rendered live on pages). ' +
+        'A page references the diagram via a self-closing `<diagram slug="…" caption="…"/>` tag — `caption` is a ' +
+        'per-reference attribute, NOT stored here. Slug: explicit `slug` | slugify(`caption`) | diagram-<nanoid>. ' +
+        '`source` is validated with mermaid.parse() → warnings only, never blocks.', {
+        source: z.string().optional().describe('DSL body (mermaid). May be empty (placeholder).'),
+        format: formatSchema.optional().describe("Diagram language (default 'mermaid')."),
+        caption: z
+            .string()
+            .optional()
+            .describe('Transient — seeds the slug only (slugify(caption)); NOT persisted on the entity.'),
+        slug: z.string().optional().describe('Explicit slug; collisions get a -2/-3 suffix.'),
+        tags: z.array(z.string()).optional().describe('Tag slugs; non-existent tags are auto-created.'),
+    }, async (args) => {
+        try {
+            const input = {
+                source: args.source,
+                format: args.format,
+                caption: args.caption,
+                slug: args.slug,
+                tags: args.tags,
+            };
+            const diagram = deps.diagramService.create(input, 'agent');
+            const warnings = await validateDiagramSource(diagram.format, diagram.source);
+            deps.ws.broadcast({ kind: 'entity:changed', entityType: 'diagram', slug: diagram.slug });
+            return ok({
+                id: diagram.slug,
+                slug: diagram.slug,
+                type: 'diagram',
+                ...(warnings.length ? { warnings } : {}),
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const getDiagram = mcpTool('get_diagram', 'Get a diagram by slug (format, source, tags).', { slug: z.string() }, async (args) => {
+        const diagram = deps.diagramService.getBySlug(String(args.slug));
+        if (!diagram)
+            return fail(new DomainError('NOT_FOUND', `diagram '${args.slug}' not found`));
+        return ok(diagram);
+    });
+    const updateDiagram = mcpTool('update_diagram', 'Update a diagram (partial). Slug is stable; rename only via newSlug (auto-propagates page references). ' +
+        '`source` is validated with mermaid.parse() → warnings only, never blocks.', {
+        slug: z.string(),
+        data: z
+            .object({
+            source: z.string().optional(),
+            format: formatSchema.optional(),
+        })
+            .describe('Partial fields to update.'),
+        newSlug: z.string().optional().describe('Explicit slug rename.'),
+    }, async (args) => {
+        try {
+            const data = args.data;
+            const input = {
+                source: data.source,
+                format: data.format,
+                newSlug: args.newSlug,
+            };
+            const { diagram, previousSlug } = deps.diagramService.update(String(args.slug), input, 'agent');
+            if (diagram.slug !== previousSlug) {
+                await deps.referencesService.propagateSlugChange('diagram', previousSlug, diagram.slug);
+            }
+            const warnings = await validateDiagramSource(diagram.format, diagram.source);
+            deps.ws.broadcast({ kind: 'entity:changed', entityType: 'diagram', slug: diagram.slug });
+            return ok({ slug: diagram.slug, updated: true, ...(warnings.length ? { warnings } : {}) });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const deleteDiagram = mcpTool('delete_diagram', 'Delete a diagram. Returns pages with now-broken `<diagram/>` references.', { slug: z.string() }, async (args) => {
+        try {
+            const slug = String(args.slug);
+            const refs = await deps.referencesService.findReferences('diagram', slug);
+            deps.diagramService.remove(slug, 'agent', refs.map((r) => ({
+                pagePath: r.pagePath,
+                tagType: r.tagType,
+                line: r.line,
+                slug,
+                type: 'diagram',
+            })));
+            deps.ws.broadcast({ kind: 'entity:changed', entityType: 'diagram', slug });
+            return ok({
+                deleted: true,
+                brokenReferences: refs.map((r) => ({ pagePath: r.pagePath, count: 1 })),
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const listDiagrams = mcpTool('list_diagrams', 'List diagrams with optional tag/search filtering. Returns slug, format, tags and a total.', {
+        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 query = {
+                tags: args.tags,
+                tagFilter: args.tagFilter,
+                search: args.search,
+                limit: args.limit,
+                offset: args.offset,
+            };
+            const diagrams = deps.diagramService.list(query);
+            const total = deps.diagramService.count(query);
+            return ok({
+                diagrams: diagrams.map((d) => ({ slug: d.slug, format: d.format, tags: d.tags })),
+                total,
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    return createMcpServer({
+        name: 'diagram-tools',
+        tools: [createDiagram, getDiagram, updateDiagram, deleteDiagram, listDiagrams],
+    });
+}
+//# sourceMappingURL=mcp-server.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { BackendModule, PluginRegistry } from '../../core/plugin-host/types.js';
+export declare const diagramBackendModule: BackendModule;
+export declare function onRegister(registry: PluginRegistry): void;

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

@@ -0,0 +1,41 @@
+import { nanoid } from 'nanoid';
+import { slugify } from '../../services/slug.js';
+import { diagramSerializer } from './serializer.js';
+import { diagramSystemPrompt } from './system-prompt.js';
+import { diagramsRouter } from './routes.js';
+import { DiagramService } from './services.js';
+import { createDiagramToolsServer } from './mcp-server.js';
+export const diagramBackendModule = {
+    type: 'diagram',
+    table: 'diagram',
+    label: 'Diagram',
+    labelPlural: 'Diagrams',
+    // After design-system (60) — diagrams sit at the end of ELEMENTS.
+    displayOrder: 70,
+    pathPrefix: '/diagrams',
+    // Decyzja #1: explicit slug | slugify(caption) | diagram-<nanoid(8)>.
+    // The service does the authoritative generation (with collision suffixing);
+    // this manifest helper mirrors the fallback for generic callers.
+    slugFrom: (data) => {
+        const d = (data ?? {});
+        return d.slug?.trim() || (d.caption ? slugify(d.caption) : `diagram-${nanoid(8)}`);
+    },
+    serializer: diagramSerializer,
+    systemPrompt: diagramSystemPrompt,
+    backend: {
+        mount(ctx) {
+            const service = new DiagramService(ctx.db, ctx.tagsService, ctx.versionService, ctx.entityStore);
+            ctx.app.use(`${diagramBackendModule.pathPrefix}`, diagramsRouter(service, ctx.referencesService, ctx.ws));
+            ctx.registerMcpServer(`${diagramBackendModule.type}-tools`, () => createDiagramToolsServer({
+                diagramService: service,
+                referencesService: ctx.referencesService,
+                ws: ctx.ws,
+            }));
+            ctx.registerEntityService(diagramBackendModule.type, service);
+        },
+    },
+};
+export function onRegister(registry) {
+    registry.registerEntityModule(diagramBackendModule);
+}
+//# sourceMappingURL=plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../../src/server/entities/diagram/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,CAAC,MAAM,oBAAoB,GAAkB;IACjD,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,UAAU;IACvB,kEAAkE;IAClE,YAAY,EAAE,EAAE;IAChB,UAAU,EAAE,WAAW;IACvB,sEAAsE;IACtE,4EAA4E;IAC5E,iEAAiE;IACjE,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;QACjB,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAwC,CAAC;QAC9D,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,UAAU,EAAE,iBAA8C;IAC1D,YAAY,EAAE,mBAAmB;IACjC,OAAO,EAAE;QACP,KAAK,CAAC,GAAG;YACP,MAAM,OAAO,GAAG,IAAI,cAAc,CAChC,GAAG,CAAC,EAAE,EACN,GAAG,CAAC,WAAW,EACf,GAAG,CAAC,cAAc,EAClB,GAAG,CAAC,WAAW,CAChB,CAAC;YACF,GAAG,CAAC,GAAG,CAAC,GAAG,CACT,GAAG,oBAAoB,CAAC,UAAU,EAAE,EACpC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,iBAAiB,EAAE,GAAG,CAAC,EAAE,CAAC,CACvD,CAAC;YACF,GAAG,CAAC,iBAAiB,CACnB,GAAG,oBAAoB,CAAC,IAAI,QAAQ,EACpC,GAAG,EAAE,CACH,wBAAwB,CAAC;gBACvB,cAAc,EAAE,OAAO;gBACvB,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;gBACxC,EAAE,EAAE,GAAG,CAAC,EAAE;aACX,CAAC,CACL,CAAC;YACF,GAAG,CAAC,qBAAqB,CAAC,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAChE,CAAC;KACF;CACF,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,QAAwB;IACjD,QAAQ,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;AACtD,CAAC"}

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

@@ -0,0 +1,5 @@
+import { Router } from 'express';
+import type { DiagramService } from './services.js';
+import type { ReferencesService } from '../../services/references.js';
+import type { WsEmitter } from '../../ws/project-emitter.js';
+export declare function diagramsRouter(service: DiagramService, references: ReferencesService, ws: WsEmitter): Router;

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

@@ -0,0 +1,83 @@
+import { Router } from 'express';
+import { validateDiagramSource } from './validate.js';
+import { errorHandler } from '../../routes/errors.js';
+export function diagramsRouter(service, references, ws) {
+    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({ diagrams: service.list(query) });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.post('/', async (req, res, next) => {
+        try {
+            const body = req.body;
+            const diagram = service.create(body, 'user');
+            const warnings = await validateDiagramSource(diagram.format, diagram.source);
+            ws.broadcast({ kind: 'entity:changed', entityType: 'diagram', slug: diagram.slug });
+            res.status(201).json({ ...diagram, warnings });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.get('/:slug', (req, res, next) => {
+        try {
+            const diagram = service.getBySlug(req.params.slug);
+            if (!diagram)
+                return res.status(404).json({ error: { code: 'NOT_FOUND', message: 'diagram not found' } });
+            res.json(diagram);
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.patch('/:slug', async (req, res, next) => {
+        try {
+            const body = req.body;
+            const { diagram, previousSlug } = service.update(req.params.slug, body, 'user');
+            if (diagram.slug !== previousSlug) {
+                await references.propagateSlugChange('diagram', previousSlug, diagram.slug);
+            }
+            const warnings = await validateDiagramSource(diagram.format, diagram.source);
+            ws.broadcast({ kind: 'entity:changed', entityType: 'diagram', slug: diagram.slug });
+            res.json({ ...diagram, warnings });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.delete('/:slug', async (req, res, next) => {
+        try {
+            const slug = req.params.slug;
+            const broken = await references.findReferences('diagram', slug);
+            const result = service.remove(slug, 'user', broken.map((b) => ({
+                pagePath: b.pagePath,
+                tagType: b.tagType,
+                line: b.line,
+                slug,
+                type: 'diagram',
+            })));
+            ws.broadcast({ kind: 'entity:changed', entityType: 'diagram', slug });
+            res.json(result);
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.use(errorHandler);
+    return router;
+}
+//# sourceMappingURL=routes.js.map

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

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

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

@@ -0,0 +1,11 @@
+import type { RawEntity } from '../../domain/raw-entity-reader.js';
+import type { EntitySerializer } from '../../serialization/types.js';
+import type { DiagramFormat } from '../../../shared/entities.js';
+export interface DiagramSnapshot {
+    slug: string;
+    format: DiagramFormat;
+    /** Literal DSL body, kept verbatim (no trim). May be empty. */
+    source: string;
+    tags: string[];
+}
+export declare const diagramSerializer: EntitySerializer<RawEntity>;

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

@@ -0,0 +1,147 @@
+function readFormat(value) {
+    return value === 'd2' ? 'd2' : 'mermaid';
+}
+function readSource(value) {
+    // `source` is stored verbatim; coerce defensively (a JSON-shaped source could
+    // be hydrated into a non-string by the generic reader — mermaid DSL never is).
+    return typeof value === 'string' ? value : '';
+}
+// ─── view helpers ────────────────────────────────────────────────────────────
+function baseSingle(entity) {
+    return {
+        type: 'diagram',
+        slug: entity.slug,
+        format: readFormat(entity.data.format),
+        source: readSource(entity.data.source),
+        tags: entity.tags,
+    };
+}
+function trimItem(entity) {
+    const source = readSource(entity.data.source);
+    return {
+        type: 'diagram',
+        slug: entity.slug,
+        format: readFormat(entity.data.format),
+        sourceLines: source ? source.split('\n').length : 0,
+        tags: entity.tags,
+    };
+}
+// ─── snapshot / restore / diff ──────────────────────────────────────────────
+function buildSnapshot(entity) {
+    return {
+        slug: entity.slug,
+        format: readFormat(entity.data.format),
+        source: readSource(entity.data.source),
+        tags: [...entity.tags].sort(),
+    };
+}
+function coerce(raw) {
+    const r = (raw ?? {});
+    return {
+        slug: String(r.slug ?? ''),
+        format: readFormat(r.format),
+        source: readSource(r.source),
+        tags: Array.isArray(r.tags) ? r.tags : [],
+    };
+}
+function diagramRestore(data, ctx) {
+    const snap = coerce(data);
+    const result = ctx.writer.upsertDiagram(snap.slug, { slug: snap.slug, format: snap.format, source: snap.source }, ctx.actor);
+    ctx.writer.syncTags('diagram', snap.slug, snap.tags);
+    return {
+        op: result.op,
+        entity: result.entity,
+        ...(result.warnings && result.warnings.length ? { warnings: result.warnings } : {}),
+    };
+}
+function diagramDiff(a, b, slug) {
+    if (a == null && b == null)
+        return { type: 'diagram', slug, op: 'noop' };
+    if (a == null)
+        return { type: 'diagram', slug, op: 'created' };
+    if (b == null)
+        return { type: 'diagram', slug, op: 'deleted' };
+    const sa = coerce(a);
+    const sb = coerce(b);
+    const changes = {};
+    if (sa.format !== sb.format)
+        changes.format_changed = { from: sa.format, to: sb.format };
+    if (sa.source !== sb.source)
+        changes.source_changed = true;
+    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: 'diagram', slug, op: 'noop' };
+    return { type: 'diagram', slug, op: 'modified', changes };
+}
+// ─── schemas ─────────────────────────────────────────────────────────────────
+const SINGLE_ELEMENT_SCHEMA = {
+    type: 'object',
+    required: ['type', 'slug', 'format', 'source', 'tags'],
+    properties: {
+        type: { const: 'diagram' },
+        slug: { type: 'string' },
+        format: { type: 'string' },
+        source: { type: 'string' },
+        tags: { type: 'array', items: { type: 'string' } },
+    },
+};
+const LIST_ITEM_SCHEMA = {
+    type: 'object',
+    required: ['type', 'slug', 'format', 'sourceLines', 'tags'],
+    properties: {
+        type: { const: 'diagram' },
+        slug: { type: 'string' },
+        format: { type: 'string' },
+        sourceLines: { type: 'number' },
+        tags: { type: 'array', items: { type: 'string' } },
+    },
+};
+const INLINE_MENTION_SCHEMA = {
+    type: 'object',
+    required: ['type', 'slug', 'label', 'href'],
+    properties: {
+        type: { const: 'diagram' },
+        slug: { type: 'string' },
+        label: { type: 'string' },
+        href: { type: 'string' },
+    },
+};
+export const diagramSerializer = {
+    type: 'diagram',
+    version: '1.0.0',
+    inlineMention: (entity) => ({
+        type: 'diagram',
+        slug: entity.slug,
+        label: entity.slug,
+        href: `/diagrams/${entity.slug}`,
+    }),
+    singleElement: (entity) => baseSingle(entity),
+    elementListItem: (entity) => trimItem(entity),
+    taggedListItem: (entity) => trimItem(entity),
+    detail: (entity, ctx) => {
+        const base = baseSingle(entity);
+        const references = ctx.reader.findSectionReferences('diagram', entity.slug).map((r) => ({
+            anchor: r.anchor,
+            pagePath: r.pagePath,
+            headingText: r.headingText,
+            relation: r.relation,
+        }));
+        return { ...base, _references: references };
+    },
+    schema: (view) => {
+        if (view === 'single_element' || view === 'detail')
+            return SINGLE_ELEMENT_SCHEMA;
+        if (view === 'inline_mention')
+            return INLINE_MENTION_SCHEMA;
+        return LIST_ITEM_SCHEMA;
+    },
+    snapshot: (entity) => buildSnapshot(entity),
+    restore: diagramRestore,
+    diff: diagramDiff,
+};
+//# sourceMappingURL=serializer.js.map

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

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

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

@@ -0,0 +1,40 @@
+import type Database from 'better-sqlite3';
+import type { BrokenReference, ChangedBy, Diagram, DiagramCreateInput, DiagramDeleteResult, DiagramListQuery, DiagramUpdateInput } from '../../../shared/entities.js';
+import type { TagsService } from '../../services/tags.js';
+import type { VersionService } from '../../services/versions.js';
+import type { EntityStore } from '../../services/entity-store.js';
+/**
+ * M29 write options — mirror the other entity services. `capture: false`
+ * suppresses the entity_version capture (index-rebuild path); `writeFile: false`
+ * skips the JSON file persist (the file is what the rebuild reads).
+ */
+export interface MutateOpts {
+    capture?: boolean;
+    writeFile?: boolean;
+}
+export declare class DiagramService {
+    private db;
+    private tags;
+    private versions;
+    private store;
+    constructor(db: Database.Database, tags: TagsService, versions: VersionService, store: EntityStore);
+    /** Resolve a free slug, appending `-2`, `-3`, … on collision. */
+    private uniqueSlug;
+    private generateSlug;
+    create(input: DiagramCreateInput, actor: ChangedBy, opts?: MutateOpts): Diagram;
+    list(query?: DiagramListQuery): Diagram[];
+    count(query?: DiagramListQuery): number;
+    getBySlug(slug: string): Diagram | null;
+    update(slug: string, input: DiagramUpdateInput, actor: ChangedBy, opts?: MutateOpts): {
+        diagram: Diagram;
+        previousSlug: string;
+    };
+    /** Idempotent UPSERT for M17 restore. CREATE if missing, UPDATE otherwise; preserves slug. */
+    upsert(slug: string, input: DiagramCreateInput, actor: ChangedBy, opts?: MutateOpts): {
+        diagram: Diagram;
+        op: 'created' | 'updated';
+    };
+    remove(slug: string, actor: ChangedBy, brokenReferences?: BrokenReference[], opts?: MutateOpts): DiagramDeleteResult;
+    private getBySlugInternal;
+    private hydrate;
+}