@inharness-ai/claude4spec 1.0.0

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

@@ -0,0 +1,154 @@
+import { createMcpServer, mcpTool } from '@inharness-ai/agent-adapters';
+import { z } from 'zod';
+import { DomainError } from '../../services/tags.js';
+export function createAcToolsServer(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 verifyRefSchema = z.object({
+        type: z.string().describe('Entity type (endpoint, dto, database-table, ui-view, ...)'),
+        slug: z.string(),
+    });
+    const createAc = mcpTool('create_ac', 'Create a new acceptance criterion. Slug is auto-generated from the first ~40 chars of `text` (prefixed with "ac-"). Use `verifies` to link the AC to specific entities; missing entities are reported as warnings but do not block save.', {
+        text: z.string().describe('Observable behavior the AC asserts. One sentence is best.'),
+        kind: z
+            .enum(['requirement', 'edge-case'])
+            .optional()
+            .describe('requirement (default) | edge-case'),
+        status: z.enum(['active', 'deprecated']).optional(),
+        verifies: z
+            .array(verifyRefSchema)
+            .optional()
+            .describe('Entities this AC verifies. Reported broken if entity does not exist; not blocking.'),
+        description: z.string().optional(),
+        slug: z.string().optional().describe('Optional explicit slug; otherwise auto-generated.'),
+        tags: z
+            .array(z.string())
+            .optional()
+            .describe('Tag slugs. Convention: m07 for module M07, entity-dto for DTO entity, etc.'),
+    }, async (args) => {
+        try {
+            const ac = deps.acService.create({
+                text: String(args.text),
+                kind: args.kind,
+                status: args.status,
+                verifies: args.verifies,
+                description: args.description,
+                slug: args.slug,
+                tags: args.tags,
+            }, 'agent');
+            const broken = ac.verifies.length ? deps.acService.classifyVerifies(ac.verifies) : [];
+            deps.ws.broadcast({ kind: 'entity:changed', entityType: 'ac', slug: ac.slug });
+            return ok({ id: ac.slug, slug: ac.slug, type: 'ac', brokenVerifies: broken });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const getAc = mcpTool('get_ac', 'Get full details of an AC by slug. Returns text, kind, status, verifies (with broken-flag), tags, and description.', { slug: z.string() }, async (args) => {
+        const ac = deps.acService.getBySlug(String(args.slug));
+        if (!ac)
+            return fail(new DomainError('NOT_FOUND', `ac '${args.slug}' not found`));
+        const broken = ac.verifies.length ? deps.acService.classifyVerifies(ac.verifies) : [];
+        return ok({ ...ac, brokenVerifies: broken });
+    });
+    const updateAc = mcpTool('update_ac', 'Update an AC (partial). Only provided fields change. Use newSlug for explicit rename — propagates references in pages. Prefer status="deprecated" over delete to preserve history.', {
+        slug: z.string(),
+        data: z
+            .object({
+            text: z.string().optional(),
+            kind: z.enum(['requirement', 'edge-case']).optional(),
+            status: z.enum(['active', 'deprecated']).optional(),
+            verifies: z.array(verifyRefSchema).optional(),
+            description: z.string().nullable().optional(),
+            tags: z.array(z.string()).optional(),
+        })
+            .describe('Partial fields to update'),
+        newSlug: z.string().optional(),
+    }, async (args) => {
+        try {
+            const data = args.data;
+            const { ac, previousSlug } = deps.acService.update(String(args.slug), {
+                text: data.text,
+                kind: data.kind,
+                status: data.status,
+                verifies: data.verifies,
+                description: data.description,
+                tags: data.tags,
+                newSlug: args.newSlug,
+            }, 'agent');
+            if (ac.slug !== previousSlug) {
+                await deps.referencesService.propagateSlugChange('ac', previousSlug, ac.slug);
+            }
+            const broken = ac.verifies.length ? deps.acService.classifyVerifies(ac.verifies) : [];
+            deps.ws.broadcast({ kind: 'entity:changed', entityType: 'ac', slug: ac.slug });
+            return ok({ slug: ac.slug, updated: true, brokenVerifies: broken });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const deleteAc = mcpTool('delete_ac', 'Hard-delete an AC. Returns list of pages with broken references. Prefer update_ac { status: "deprecated" } as soft delete to keep history.', { slug: z.string() }, async (args) => {
+        try {
+            const slug = String(args.slug);
+            const refs = await deps.referencesService.findReferences('ac', slug);
+            deps.acService.remove(slug, 'agent');
+            deps.ws.broadcast({ kind: 'entity:changed', entityType: 'ac', slug });
+            return ok({
+                deleted: true,
+                brokenReferences: refs.map((r) => ({ pagePath: r.pagePath, count: 1 })),
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const listAcs = mcpTool('list_acs', 'List acceptance criteria with optional filtering by status, kind, tags, or search text. Default status filter is "active" — pass status="all" to include deprecated.', {
+        status: z.enum(['active', 'deprecated', 'all']).optional(),
+        kind: z.enum(['requirement', 'edge-case']).optional(),
+        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.acService.list({
+                status: args.status,
+                kind: args.kind,
+                tags: args.tags,
+                tagFilter: args.tagFilter,
+                search: args.search,
+                limit: args.limit,
+                offset: args.offset,
+            });
+            return ok({
+                acs: list.map((a) => ({
+                    slug: a.slug,
+                    text: a.text,
+                    kind: a.kind,
+                    status: a.status,
+                    tags: a.tags,
+                    verifyCount: a.verifies.length,
+                })),
+                total: list.length,
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    return createMcpServer({
+        name: 'ac-tools',
+        tools: [createAc, getAc, updateAc, deleteAc, listAcs],
+    });
+}
+//# sourceMappingURL=mcp-server.js.map

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

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

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

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

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

@@ -0,0 +1,33 @@
+import { pluginHost } from '../../core/plugin-host/host.js';
+import { acSlug } from '../../services/slug.js';
+import { acSerializer } from './serializer.js';
+import { acSystemPrompt } from './system-prompt.js';
+import { acsRouter } from './routes.js';
+import { AcService } from './services.js';
+import { createAcToolsServer } from './mcp-server.js';
+export const acBackendModule = {
+    type: 'ac',
+    table: 'ac',
+    label: 'Acceptance Criterion',
+    labelPlural: 'Acceptance Criteria',
+    displayOrder: 50,
+    pathPrefix: '/acs',
+    slugFrom: (data) => acSlug(data.text ?? ''),
+    serializer: acSerializer,
+    systemPrompt: acSystemPrompt,
+    backend: {
+        mount(ctx) {
+            const service = new AcService(ctx.db, ctx.tagsService, ctx.versionService, pluginHost);
+            ctx.app.use(`/api${acBackendModule.pathPrefix}`, acsRouter(service, ctx.referencesService));
+            ctx.registerMcpServer(`${acBackendModule.type}-tools`, createAcToolsServer({
+                acService: service,
+                referencesService: ctx.referencesService,
+                ws: ctx.ws,
+            }));
+            ctx.setIdResolver(acBackendModule.type, (slug) => service.getIdBySlug(slug));
+            ctx.registerEntityService(acBackendModule.type, service);
+        },
+    },
+};
+pluginHost.registerBackendModule(acBackendModule);
+//# sourceMappingURL=plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../../src/server/entities/ac/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,qBAAqB;IAClC,YAAY,EAAE,EAAE;IAChB,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAE,IAA0B,CAAC,IAAI,IAAI,EAAE,CAAC;IAClE,UAAU,EAAE,YAAyC;IACrD,YAAY,EAAE,cAAc;IAC5B,OAAO,EAAE;QACP,KAAK,CAAC,GAAG;YACP,MAAM,OAAO,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;YACvF,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,eAAe,CAAC,UAAU,EAAE,EAAE,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;YAC5F,GAAG,CAAC,iBAAiB,CACnB,GAAG,eAAe,CAAC,IAAI,QAAQ,EAC/B,mBAAmB,CAAC;gBAClB,SAAS,EAAE,OAAO;gBAClB,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;gBACxC,EAAE,EAAE,GAAG,CAAC,EAAE;aACX,CAAC,CACH,CAAC;YACF,GAAG,CAAC,aAAa,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;YAC7E,GAAG,CAAC,qBAAqB,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3D,CAAC;KACF;CACF,CAAC;AAEF,UAAU,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC"}

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

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

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

@@ -0,0 +1,92 @@
+import { Router } from 'express';
+import { errorHandler } from '../../routes/errors.js';
+export function acsRouter(acs, 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 status = parseStatus(q.status);
+            const kind = parseKind(q.kind);
+            const query = {
+                ...(status !== undefined ? { status } : {}),
+                ...(kind !== undefined ? { kind } : {}),
+                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({ acs: acs.list(query) });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.post('/', (req, res, next) => {
+        try {
+            const body = req.body;
+            const ac = acs.create(body, 'user');
+            const broken = ac.verifies.length ? acs.classifyVerifies(ac.verifies) : [];
+            res.status(201).json({ ...ac, brokenVerifies: broken });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.get('/:slug', (req, res, next) => {
+        try {
+            const ac = acs.getBySlug(req.params.slug);
+            if (!ac)
+                return res.status(404).json({ error: { code: 'NOT_FOUND', message: 'ac not found' } });
+            const broken = ac.verifies.length ? acs.classifyVerifies(ac.verifies) : [];
+            res.json({ ...ac, brokenVerifies: broken });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.patch('/:slug', async (req, res, next) => {
+        try {
+            const body = req.body;
+            const { ac, previousSlug } = acs.update(req.params.slug, body, 'user');
+            if (ac.slug !== previousSlug) {
+                await references.propagateSlugChange('ac', previousSlug, ac.slug);
+            }
+            const broken = ac.verifies.length ? acs.classifyVerifies(ac.verifies) : [];
+            res.json({ ...ac, brokenVerifies: broken });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.delete('/:slug', async (req, res, next) => {
+        try {
+            const broken = await references.findReferences('ac', req.params.slug);
+            res.json(acs.remove(req.params.slug, 'user', broken.map((b) => ({
+                pagePath: b.pagePath,
+                tagType: b.tagType,
+                line: b.line,
+                slug: req.params.slug,
+                type: 'ac',
+            }))));
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.use(errorHandler);
+    return router;
+}
+function parseStatus(raw) {
+    if (raw === 'all' || raw === 'active' || raw === 'deprecated')
+        return raw;
+    return undefined;
+}
+function parseKind(raw) {
+    if (raw === 'requirement' || raw === 'edge-case')
+        return raw;
+    return undefined;
+}
+//# sourceMappingURL=routes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../../src/server/entities/ac/routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAStD,MAAM,UAAU,SAAS,CAAC,GAAc,EAAE,UAA6B;IACrE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACjC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;YACpB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACxF,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,KAAK,KAAK,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YACvF,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,KAAK,GAAgB;gBACzB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,IAAI;gBACJ,SAAS,EAAE,MAAM;gBACjB,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBAC3D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;aAChD,CAAC;YACF,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,GAAG,CAAC,IAAqB,CAAC;YACvC,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,CAAC,EAAE;gBAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;YAChG,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,GAAG,CAAC,IAAqB,CAAC;YACvC,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACvE,IAAI,EAAE,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC7B,MAAM,UAAU,CAAC,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;YACpE,CAAC;YACD,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC/C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtE,GAAG,CAAC,IAAI,CACN,GAAG,CAAC,MAAM,CACR,GAAG,CAAC,MAAM,CAAC,IAAI,EACf,MAAM,EACN,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI;gBACrB,IAAI,EAAE,IAAa;aACpB,CAAC,CAAC,CACJ,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,YAAY;QAAE,OAAO,GAAG,CAAC;IAC1E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,GAAY;IAC7B,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,WAAW;QAAE,OAAO,GAAG,CAAC;IAC7D,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { RawEntity } from '../../domain/raw-entity-reader.js';
+import type { EntitySerializer } from '../../serialization/types.js';
+import type { AcKind, AcStatus, AcVerifyRef } from '../../../shared/entities.js';
+export interface AcSnapshot {
+    slug: string;
+    text: string;
+    kind: AcKind;
+    status: AcStatus;
+    verifies: AcVerifyRef[];
+    description: string | null;
+    tags: string[];
+}
+export declare const acSerializer: EntitySerializer<RawEntity>;

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

@@ -0,0 +1,124 @@
+function baseSingle(entity) {
+    return {
+        type: 'ac',
+        slug: entity.slug,
+        text: entity.data.text ?? '',
+        kind: (entity.data.kind ?? 'requirement'),
+        status: (entity.data.status ?? 'active'),
+        verifies: (entity.data.verifies ?? []),
+        description: entity.data.description ?? null,
+        tags: entity.tags,
+    };
+}
+function buildSnapshot(entity) {
+    const verifies = (entity.data.verifies ?? [])
+        .filter((v) => v && typeof v.type === 'string' && typeof v.slug === 'string')
+        .map((v) => ({ type: v.type, slug: v.slug }))
+        .sort((a, b) => `${a.type}/${a.slug}`.localeCompare(`${b.type}/${b.slug}`));
+    return {
+        slug: entity.slug,
+        text: entity.data.text ?? '',
+        kind: (entity.data.kind ?? 'requirement'),
+        status: (entity.data.status ?? 'active'),
+        verifies,
+        description: entity.data.description ?? null,
+        tags: [...entity.tags].sort(),
+    };
+}
+function coerceAc(raw) {
+    const r = (raw ?? {});
+    const verifies = Array.isArray(r.verifies)
+        ? r.verifies.filter((v) => v && typeof v.type === 'string' && typeof v.slug === 'string')
+        : [];
+    return {
+        slug: String(r.slug ?? ''),
+        text: String(r.text ?? ''),
+        kind: (r.kind ?? 'requirement'),
+        status: (r.status ?? 'active'),
+        verifies,
+        description: r.description ?? null,
+        tags: Array.isArray(r.tags) ? r.tags : [],
+    };
+}
+function acDiff(a, b, slug) {
+    if (a == null && b == null)
+        return { type: 'ac', slug, op: 'noop' };
+    if (a == null)
+        return { type: 'ac', slug, op: 'created' };
+    if (b == null)
+        return { type: 'ac', slug, op: 'deleted' };
+    const sa = coerceAc(a);
+    const sb = coerceAc(b);
+    const changes = {};
+    if (sa.text !== sb.text)
+        changes.text_changed = { from: sa.text, to: sb.text };
+    if (sa.kind !== sb.kind)
+        changes.kind_changed = { from: sa.kind, to: sb.kind };
+    if (sa.status !== sb.status)
+        changes.status_changed = { from: sa.status, to: sb.status };
+    if (sa.description !== sb.description) {
+        changes.description_changed = { from: sa.description, to: sb.description };
+    }
+    const verifyKey = (v) => `${v.type}/${v.slug}`;
+    const aVerify = new Set(sa.verifies.map(verifyKey));
+    const bVerify = new Set(sb.verifies.map(verifyKey));
+    const verifyAdded = sb.verifies.filter((v) => !aVerify.has(verifyKey(v)));
+    const verifyRemoved = sa.verifies.filter((v) => !bVerify.has(verifyKey(v)));
+    if (verifyAdded.length)
+        changes.verify_added = verifyAdded;
+    if (verifyRemoved.length)
+        changes.verify_removed = verifyRemoved;
+    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: 'ac', slug, op: 'noop' };
+    return { type: 'ac', slug, op: 'modified', changes };
+}
+function acRestore(data, ctx) {
+    const snap = data;
+    const result = ctx.writer.upsertAc(snap.slug, {
+        text: snap.text,
+        kind: snap.kind,
+        status: snap.status,
+        verifies: snap.verifies,
+        description: snap.description,
+        slug: snap.slug,
+    }, ctx.actor);
+    ctx.writer.syncTags('ac', snap.slug, snap.tags);
+    return { op: result.op, entity: result.entity };
+}
+export const acSerializer = {
+    type: 'ac',
+    version: '1.0.0',
+    inlineMention: (entity) => ({
+        type: 'ac',
+        slug: entity.slug,
+        label: entity.data.text ?? entity.slug,
+        href: `/acs/${entity.slug}`,
+    }),
+    singleElement: (entity) => baseSingle(entity),
+    elementListItem: (entity) => baseSingle(entity),
+    taggedListItem: (entity) => baseSingle(entity),
+    detail: (entity, ctx) => {
+        const base = baseSingle(entity);
+        const references = ctx.reader.findSectionReferences('ac', entity.id).map((r) => ({
+            anchor: r.anchor,
+            pagePath: r.pagePath,
+            headingText: r.headingText,
+            relation: r.relation,
+        }));
+        return {
+            ...base,
+            _references: references,
+        };
+    },
+    // ─── M17 ───
+    snapshot: (entity) => buildSnapshot(entity),
+    restore: acRestore,
+    diff: acDiff,
+};
+//# sourceMappingURL=serializer.js.map

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

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

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

@@ -0,0 +1,35 @@
+import type Database from 'better-sqlite3';
+import type { Ac, AcBrokenVerify, AcCreateInput, AcDeleteResult, AcListQuery, AcUpdateInput, AcVerifyRef, BrokenReference, ChangedBy } from '../../../shared/entities.js';
+import type { TagsService } from '../../services/tags.js';
+import type { VersionService } from '../../services/versions.js';
+import type { PluginHost } from '../../core/plugin-host/types.js';
+export interface AcCreateResult {
+    ac: Ac;
+}
+export interface AcUpdateResult {
+    ac: Ac;
+    previousSlug: string;
+}
+export declare class AcService {
+    private db;
+    private tags;
+    private versions;
+    private host;
+    constructor(db: Database.Database, tags: TagsService, versions: VersionService, host: PluginHost);
+    create(input: AcCreateInput, actor: ChangedBy): Ac;
+    list(query?: AcListQuery): Ac[];
+    getBySlug(slug: string): Ac | null;
+    getIdBySlug(slug: string): number | null;
+    update(slug: string, input: AcUpdateInput, actor: ChangedBy): AcUpdateResult;
+    /** Idempotent UPSERT for M17 restore. */
+    upsert(slug: string, input: AcCreateInput, actor: ChangedBy): {
+        ac: Ac;
+        op: 'created' | 'updated';
+    };
+    remove(slug: string, actor: ChangedBy, brokenReferences?: BrokenReference[]): AcDeleteResult;
+    /** Resolve verifies refs against the host; non-blocking. */
+    classifyVerifies(verifies: AcVerifyRef[]): AcBrokenVerify[];
+    private allocateSlug;
+    private getByIdInternal;
+    private hydrate;
+}