@inharness-ai/claude4spec 1.0.0

package/dist/server/services/endpoint.d.ts

@@ -0,0 +1,22 @@
+import type Database from 'better-sqlite3';
+import type { ChangedBy, Endpoint, EndpointCreateInput, EndpointDeleteResult, EndpointDtoRelation, EndpointListQuery, EndpointUpdateInput } from '../../shared/entities.js';
+import type { TagsService } from './tags.js';
+import type { VersionService } from './versions.js';
+export declare class EndpointService {
+    private db;
+    private tags;
+    private versions;
+    constructor(db: Database.Database, tags: TagsService, versions: VersionService);
+    create(input: EndpointCreateInput, actor: ChangedBy): Endpoint;
+    list(query?: EndpointListQuery): Endpoint[];
+    getBySlug(slug: string): Endpoint | null;
+    getIdBySlug(slug: string): number | null;
+    update(slug: string, input: EndpointUpdateInput, actor: ChangedBy): Endpoint;
+    remove(slug: string, actor: ChangedBy): EndpointDeleteResult;
+    private getByIdInternal;
+    private hydrate;
+    private getLinkedDtos;
+    linkDto(endpointSlug: string, dtoSlug: string, relation: EndpointDtoRelation, statusCode?: number | null): Endpoint;
+    unlinkDto(endpointSlug: string, dtoSlug: string, relation: EndpointDtoRelation, statusCode?: number | null): Endpoint;
+    private requireMethod;
+}

package/dist/server/services/endpoint.js

@@ -0,0 +1,239 @@
+import { endpointSlug } from './slug.js';
+import { DomainError } from './tags.js';
+const ALLOWED_RELATIONS = new Set([
+    'request',
+    'response',
+    'error',
+]);
+const ALLOWED_METHODS = new Set([
+    'GET',
+    'POST',
+    'PUT',
+    'PATCH',
+    'DELETE',
+]);
+export class EndpointService {
+    db;
+    tags;
+    versions;
+    constructor(db, tags, versions) {
+        this.db = db;
+        this.tags = tags;
+        this.versions = versions;
+    }
+    create(input, actor) {
+        const method = this.requireMethod(input.method);
+        if (!input.path)
+            throw new DomainError('VALIDATION', 'path is required');
+        const slug = endpointSlug(method, input.path);
+        if (!slug)
+            throw new DomainError('VALIDATION', 'slug resolves to empty');
+        const tx = this.db.transaction(() => {
+            const conflict = this.db.prepare(`SELECT 1 FROM endpoint WHERE slug = ?`).get(slug);
+            if (conflict)
+                throw new DomainError('SLUG_CONFLICT', `endpoint slug '${slug}' already exists`);
+            const info = this.db
+                .prepare(`INSERT INTO endpoint (slug, method, path, summary, description)
+           VALUES (?, ?, ?, ?, ?)`)
+                .run(slug, method, input.path, input.summary ?? '', input.description ?? null);
+            const id = Number(info.lastInsertRowid);
+            if (input.tags?.length)
+                this.tags.assignTags('endpoint', id, input.tags);
+            const created = this.getByIdInternal(id);
+            this.versions.createVersion('endpoint', id, created, actor, 'Created');
+            return created;
+        });
+        return tx();
+    }
+    list(query = {}) {
+        const where = [];
+        const params = [];
+        if (query.search) {
+            where.push(`(path LIKE ? OR summary LIKE ? OR slug LIKE ?)`);
+            const like = `%${query.search}%`;
+            params.push(like, like, like);
+        }
+        let tagFilter = null;
+        const tagSlugs = query.tags?.filter(Boolean) ?? [];
+        if (tagSlugs.length) {
+            const placeholders = tagSlugs.map(() => '?').join(',');
+            if (query.tagFilter === 'and') {
+                tagFilter = `
+          id IN (
+            SELECT et.entity_id
+              FROM entity_tag et
+              JOIN tag t ON t.id = et.tag_id
+             WHERE et.entity_type = 'endpoint' AND t.slug IN (${placeholders})
+          GROUP BY et.entity_id
+            HAVING COUNT(DISTINCT t.slug) = ?
+          )
+        `;
+                params.push(...tagSlugs, tagSlugs.length);
+            }
+            else {
+                tagFilter = `
+          id IN (
+            SELECT et.entity_id FROM entity_tag et
+              JOIN tag t ON t.id = et.tag_id
+             WHERE et.entity_type = 'endpoint' AND t.slug IN (${placeholders})
+          )
+        `;
+                params.push(...tagSlugs);
+            }
+        }
+        if (tagFilter)
+            where.push(tagFilter);
+        const whereSql = where.length ? `WHERE ${where.join(' AND ')}` : '';
+        const limit = Math.min(Math.max(query.limit ?? 200, 1), 500);
+        const offset = Math.max(query.offset ?? 0, 0);
+        const rows = this.db
+            .prepare(`SELECT * FROM endpoint
+         ${whereSql}
+         ORDER BY path, method
+         LIMIT ? OFFSET ?`)
+            .all(...params, limit, offset);
+        return rows.map((r) => this.hydrate(r));
+    }
+    getBySlug(slug) {
+        const row = this.db.prepare(`SELECT * FROM endpoint WHERE slug = ?`).get(slug);
+        return row ? this.hydrate(row) : null;
+    }
+    getIdBySlug(slug) {
+        const row = this.db.prepare(`SELECT id FROM endpoint WHERE slug = ?`).get(slug);
+        return row?.id ?? null;
+    }
+    update(slug, input, actor) {
+        const tx = this.db.transaction(() => {
+            const current = this.db.prepare(`SELECT * FROM endpoint WHERE slug = ?`).get(slug);
+            if (!current)
+                throw new DomainError('NOT_FOUND', `endpoint '${slug}' not found`);
+            const method = input.method ? this.requireMethod(input.method) : current.method;
+            const path = input.path ?? current.path;
+            const autoSlug = endpointSlug(method, path);
+            const nextSlug = input.newSlug ?? autoSlug;
+            if (nextSlug !== slug) {
+                const conflict = this.db.prepare(`SELECT 1 FROM endpoint WHERE slug = ?`).get(nextSlug);
+                if (conflict)
+                    throw new DomainError('SLUG_CONFLICT', `endpoint slug '${nextSlug}' already exists`);
+            }
+            const nextRow = {
+                ...current,
+                slug: nextSlug,
+                method,
+                path,
+                summary: input.summary ?? current.summary,
+                description: input.description !== undefined ? input.description : current.description,
+            };
+            this.db
+                .prepare(`UPDATE endpoint
+             SET slug = ?, method = ?, path = ?, summary = ?, description = ?,
+                 updated_at = datetime('now')
+           WHERE id = ?`)
+                .run(nextRow.slug, nextRow.method, nextRow.path, nextRow.summary, nextRow.description, current.id);
+            if (input.tags)
+                this.tags.assignTags('endpoint', current.id, input.tags);
+            const updated = this.getByIdInternal(current.id);
+            const summary = nextSlug !== slug ? `Renamed from '${slug}' to '${nextSlug}'` : 'Updated';
+            this.versions.createVersion('endpoint', current.id, updated, actor, summary);
+            return updated;
+        });
+        return tx();
+    }
+    remove(slug, actor) {
+        const tx = this.db.transaction(() => {
+            const row = this.db.prepare(`SELECT * FROM endpoint WHERE slug = ?`).get(slug);
+            if (!row)
+                throw new DomainError('NOT_FOUND', `endpoint '${slug}' not found`);
+            this.versions.createVersion('endpoint', row.id, null, actor, 'Deleted');
+            this.db
+                .prepare(`DELETE FROM entity_tag WHERE entity_type = 'endpoint' AND entity_id = ?`)
+                .run(row.id);
+            this.db.prepare(`DELETE FROM endpoint WHERE id = ?`).run(row.id);
+            const brokenReferences = [];
+            return { deleted: true, brokenReferences };
+        });
+        return tx();
+    }
+    getByIdInternal(id) {
+        const row = this.db.prepare(`SELECT * FROM endpoint WHERE id = ?`).get(id);
+        if (!row)
+            throw new Error(`endpoint id ${id} disappeared mid-tx`);
+        return this.hydrate(row);
+    }
+    hydrate(row) {
+        return {
+            slug: row.slug,
+            method: row.method,
+            path: row.path,
+            summary: row.summary,
+            description: row.description,
+            tags: this.tags.getEntityTagSlugs('endpoint', row.id),
+            dtos: this.getLinkedDtos(row.id),
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    getLinkedDtos(endpointId) {
+        const rows = this.db
+            .prepare(`SELECT d.slug AS dto_slug, d.name AS dto_name, ed.relation AS relation, ed.status_code AS status_code
+           FROM endpoint_dto ed
+           JOIN dto d ON d.id = ed.dto_id
+          WHERE ed.endpoint_id = ?
+          ORDER BY ed.relation, ed.status_code, d.name`)
+            .all(endpointId);
+        return rows.map((r) => ({
+            dtoSlug: r.dto_slug,
+            dtoName: r.dto_name,
+            relation: r.relation,
+            statusCode: r.status_code,
+        }));
+    }
+    linkDto(endpointSlug, dtoSlug, relation, statusCode = null) {
+        if (!ALLOWED_RELATIONS.has(relation)) {
+            throw new DomainError('VALIDATION', `invalid relation '${relation}'`);
+        }
+        if (relation === 'request' && statusCode !== null) {
+            throw new DomainError('VALIDATION', `request relation must not carry a status code`);
+        }
+        const ep = this.db.prepare(`SELECT id FROM endpoint WHERE slug = ?`).get(endpointSlug);
+        if (!ep)
+            throw new DomainError('NOT_FOUND', `endpoint '${endpointSlug}' not found`);
+        const dto = this.db.prepare(`SELECT id FROM dto WHERE slug = ?`).get(dtoSlug);
+        if (!dto)
+            throw new DomainError('NOT_FOUND', `dto '${dtoSlug}' not found`);
+        this.db
+            .prepare(`INSERT OR IGNORE INTO endpoint_dto (endpoint_id, dto_id, relation, status_code)
+           VALUES (?, ?, ?, ?)`)
+            .run(ep.id, dto.id, relation, statusCode);
+        return this.getByIdInternal(ep.id);
+    }
+    unlinkDto(endpointSlug, dtoSlug, relation, statusCode = null) {
+        const ep = this.db.prepare(`SELECT id FROM endpoint WHERE slug = ?`).get(endpointSlug);
+        if (!ep)
+            throw new DomainError('NOT_FOUND', `endpoint '${endpointSlug}' not found`);
+        const dto = this.db.prepare(`SELECT id FROM dto WHERE slug = ?`).get(dtoSlug);
+        if (!dto)
+            throw new DomainError('NOT_FOUND', `dto '${dtoSlug}' not found`);
+        if (statusCode === null) {
+            this.db
+                .prepare(`DELETE FROM endpoint_dto
+             WHERE endpoint_id = ? AND dto_id = ? AND relation = ? AND status_code IS NULL`)
+                .run(ep.id, dto.id, relation);
+        }
+        else {
+            this.db
+                .prepare(`DELETE FROM endpoint_dto
+             WHERE endpoint_id = ? AND dto_id = ? AND relation = ? AND status_code = ?`)
+                .run(ep.id, dto.id, relation, statusCode);
+        }
+        return this.getByIdInternal(ep.id);
+    }
+    requireMethod(m) {
+        const upper = m.toUpperCase();
+        if (!ALLOWED_METHODS.has(upper)) {
+            throw new DomainError('VALIDATION', `unsupported method '${m}'`);
+        }
+        return upper;
+    }
+}
+//# sourceMappingURL=endpoint.js.map

package/dist/server/services/endpoint.js.map

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

package/dist/server/services/entity-writer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Concrete EntityWriter implementation for M17 restore (Phase 6).
+ *
+ * Constructed per-restore-request by ReleaseService — looks up entity
+ * services + tag/junction services from the plugin host. Each write goes
+ * through the normal service API so the mutation is captured into
+ * `entity_version` with `release_id = NULL` (append-only — decyzja 7).
+ *
+ * Idempotent UPSERT semantics (decyzja 11): no `--force` flag, no
+ * destructive operations on history. The append-only safety net makes
+ * accidental overwrites cofalne by another restore.
+ */
+import type { ChangedBy, EndpointDtoRelation } from '../../shared/entities.js';
+import type { EntityWriter, UpsertResult } from '../serialization/writer.js';
+import type { PluginHost } from '../core/plugin-host/types.js';
+import type { RawEntityType } from '../domain/raw-entity-reader.js';
+import type { EndpointService } from '../entities/endpoint/services.js';
+import type { DtoService } from '../entities/dto/services.js';
+import type { DatabaseTableService } from '../entities/database-table/services.js';
+import type { UiViewService } from '../entities/ui-view/services.js';
+import type { AcService } from '../entities/ac/services.js';
+import type { TagsService } from './tags.js';
+export declare class HostEntityWriter implements EntityWriter {
+    private host;
+    private tags;
+    constructor(host: PluginHost, tags: TagsService);
+    upsertEndpoint(slug: string, input: Parameters<EndpointService['upsert']>[1], actor: ChangedBy): UpsertResult<ReturnType<EndpointService['upsert']>['entity']>;
+    upsertDto(slug: string, input: Parameters<DtoService['upsert']>[1], actor: ChangedBy): UpsertResult<ReturnType<DtoService['upsert']>['dto']>;
+    upsertDatabaseTable(slug: string, input: Parameters<DatabaseTableService['upsert']>[1], actor: ChangedBy): UpsertResult<ReturnType<DatabaseTableService['upsert']>['dbTable']>;
+    upsertUiView(slug: string, input: Parameters<UiViewService['upsert']>[1], actor: ChangedBy): UpsertResult<ReturnType<UiViewService['upsert']>['uiView']>;
+    upsertAc(slug: string, input: Parameters<AcService['upsert']>[1], actor: ChangedBy): UpsertResult<ReturnType<AcService['upsert']>['ac']>;
+    syncEndpointDtos(endpointSlug: string, target: Array<{
+        dtoSlug: string;
+        relation: EndpointDtoRelation;
+        statusCode: number | null;
+    }>): {
+        linked: number;
+        unlinked: number;
+        warnings: string[];
+    };
+    syncTags(type: RawEntityType, slug: string, tags: string[]): void;
+    delete(type: RawEntityType, slug: string, actor: ChangedBy): {
+        deleted: boolean;
+    };
+    private requireService;
+}

package/dist/server/services/entity-writer.js

@@ -0,0 +1,137 @@
+/**
+ * Concrete EntityWriter implementation for M17 restore (Phase 6).
+ *
+ * Constructed per-restore-request by ReleaseService — looks up entity
+ * services + tag/junction services from the plugin host. Each write goes
+ * through the normal service API so the mutation is captured into
+ * `entity_version` with `release_id = NULL` (append-only — decyzja 7).
+ *
+ * Idempotent UPSERT semantics (decyzja 11): no `--force` flag, no
+ * destructive operations on history. The append-only safety net makes
+ * accidental overwrites cofalne by another restore.
+ */
+import { DomainError } from './tags.js';
+export class HostEntityWriter {
+    host;
+    tags;
+    constructor(host, tags) {
+        this.host = host;
+        this.tags = tags;
+    }
+    upsertEndpoint(slug, input, actor) {
+        const service = this.requireService('endpoint');
+        const result = service.upsert(slug, input, actor);
+        return { entity: result.entity, op: result.op };
+    }
+    upsertDto(slug, input, actor) {
+        const service = this.requireService('dto');
+        const result = service.upsert(slug, input, actor);
+        return { entity: result.dto, op: result.op };
+    }
+    upsertDatabaseTable(slug, input, actor) {
+        const service = this.requireService('database-table');
+        const result = service.upsert(slug, input, actor);
+        return { entity: result.dbTable, op: result.op, warnings: result.warnings };
+    }
+    upsertUiView(slug, input, actor) {
+        const service = this.requireService('ui-view');
+        const result = service.upsert(slug, input, actor);
+        return { entity: result.uiView, op: result.op, warnings: result.warnings };
+    }
+    upsertAc(slug, input, actor) {
+        const service = this.requireService('ac');
+        const result = service.upsert(slug, input, actor);
+        return { entity: result.ac, op: result.op };
+    }
+    syncEndpointDtos(endpointSlug, target) {
+        const service = this.requireService('endpoint');
+        const ep = service.getBySlug(endpointSlug);
+        if (!ep)
+            return { linked: 0, unlinked: 0, warnings: [`endpoint '${endpointSlug}' not found`] };
+        const keyOf = (l) => `${l.relation}|${l.dtoSlug}|${l.statusCode ?? 'null'}`;
+        const currentSet = new Map(ep.dtos.map((l) => [keyOf(l), l]));
+        const targetSet = new Map(target.map((l) => [keyOf(l), l]));
+        let linked = 0;
+        let unlinked = 0;
+        const warnings = [];
+        // Unlink extras first to avoid conflicts on UNIQUE constraint
+        for (const [k, current] of currentSet) {
+            if (!targetSet.has(k)) {
+                try {
+                    service.unlinkDto(endpointSlug, current.dtoSlug, current.relation, current.statusCode);
+                    unlinked += 1;
+                }
+                catch (err) {
+                    warnings.push(`unlink '${k}' failed: ${err.message}`);
+                }
+            }
+        }
+        // Link missing
+        for (const [k, want] of targetSet) {
+            if (!currentSet.has(k)) {
+                try {
+                    service.linkDto(endpointSlug, want.dtoSlug, want.relation, want.statusCode);
+                    linked += 1;
+                }
+                catch (err) {
+                    warnings.push(`link '${k}' failed: ${err.message}`);
+                }
+            }
+        }
+        return { linked, unlinked, warnings };
+    }
+    syncTags(type, slug, tags) {
+        const id = this.host.resolveEntityId(type, slug);
+        if (id == null)
+            return;
+        this.tags.assignTags(type, id, tags);
+    }
+    delete(type, slug, actor) {
+        switch (type) {
+            case 'endpoint': {
+                const service = this.requireService('endpoint');
+                if (!service.getBySlug(slug))
+                    return { deleted: false };
+                service.remove(slug, actor);
+                return { deleted: true };
+            }
+            case 'dto': {
+                const service = this.requireService('dto');
+                if (!service.getBySlug(slug))
+                    return { deleted: false };
+                service.remove(slug, actor);
+                return { deleted: true };
+            }
+            case 'database-table': {
+                const service = this.requireService('database-table');
+                if (!service.getBySlug(slug))
+                    return { deleted: false };
+                service.remove(slug, actor);
+                return { deleted: true };
+            }
+            case 'ui-view': {
+                const service = this.requireService('ui-view');
+                if (!service.getBySlug(slug))
+                    return { deleted: false };
+                service.remove(slug, actor);
+                return { deleted: true };
+            }
+            case 'ac': {
+                const service = this.requireService('ac');
+                if (!service.getBySlug(slug))
+                    return { deleted: false };
+                service.remove(slug, actor);
+                return { deleted: true };
+            }
+            default:
+                return { deleted: false };
+        }
+    }
+    requireService(type) {
+        const service = this.host.getEntityService(type);
+        if (!service)
+            throw new DomainError('VALIDATION', `entity service for type '${type}' not registered`);
+        return service;
+    }
+}
+//# sourceMappingURL=entity-writer.js.map

package/dist/server/services/entity-writer.js.map

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

package/dist/server/services/page-serializer.d.ts

@@ -0,0 +1,109 @@
+/**
+ * PageSerializer — M02 stays out of L9 plugin host (M17 decyzja 1).
+ * Lives outside `EntitySerializer` registry; provides parallel
+ * snapshot/restore/diff for markdown pages.
+ *
+ * Snapshot shape — `PageSnapshotData` per `db-m17-snapshots.md` (`dbm17shp01`).
+ * Diff variant C (M17 decyzja 10): section-level operations + mandatory
+ * `line_diff` inside each `section_modified` + `frontmatter_diff` /
+ * `xml_refs_diff` side-channels.
+ */
+import type { PagesService } from './pages.js';
+export declare const PAGE_SERIALIZER_VERSION = "1.1.0";
+export interface PageXmlRef {
+    tagType: string;
+    attributes: Record<string, string>;
+    position: number;
+}
+export interface PageSnapshotData {
+    path: string;
+    content: string;
+    frontmatter: Record<string, unknown>;
+    anchors: string[];
+    xml_refs: PageXmlRef[];
+}
+export interface PageSection {
+    anchor: string;
+    heading: string;
+    level: number;
+    content: string;
+    position: number;
+}
+export interface FrontmatterDiff {
+    added: Record<string, unknown>;
+    removed: Record<string, unknown>;
+    changed: Array<{
+        key: string;
+        from: unknown;
+        to: unknown;
+    }>;
+}
+export interface XmlRefsDiff {
+    added: PageXmlRef[];
+    removed: PageXmlRef[];
+}
+/** Per-line diff inside a modified section (M17 decyzja 10 wariant C). */
+export interface LineDiffLine {
+    op: 'keep' | 'added' | 'removed';
+    content: string;
+}
+export interface LineDiff {
+    lines: LineDiffLine[];
+}
+export interface ModifiedSection {
+    anchor: string;
+    heading: string;
+    level: number;
+    /** Mandatory in variant C — line-level diff of section body. */
+    line_diff: LineDiff;
+}
+export interface PageDiff {
+    path: string;
+    op: 'created' | 'deleted' | 'modified' | 'noop';
+    added_sections: PageSection[];
+    removed_sections: PageSection[];
+    modified_sections: ModifiedSection[];
+    moved_sections: Array<{
+        anchor: string;
+        from_position: number;
+        to_position: number;
+    }>;
+    frontmatter_diff: FrontmatterDiff | null;
+    xml_refs_diff: XmlRefsDiff | null;
+}
+/**
+ * Compute line-level diff between two strings using Myers algorithm
+ * (via `diff` npm). Returns a flat list of keep/added/removed lines
+ * preserving order. Trailing newlines are normalized so identical
+ * content with/without final \n compares equal.
+ */
+export declare function computeLineDiff(a: string, b: string): LineDiff;
+/** Extract anchors in document order. */
+export declare function extractAnchorsInOrder(content: string): string[];
+export declare class PageSerializer {
+    private pages;
+    readonly version = "1.1.0";
+    constructor(pages: PagesService);
+    /**
+     * Read the file from disk and produce a deterministic, byte-faithful
+     * snapshot. Reads `content` byte-for-byte (preserves BOM, line endings).
+     */
+    snapshot(relPath: string): Promise<PageSnapshotData>;
+    /** Build snapshot from already-read content (used for delete tombstones). */
+    snapshotFromContent(relPath: string, content: string): PageSnapshotData;
+    /**
+     * Section-level diff (variant C in M17 decyzja 10). Sections keyed by
+     * 8-char anchor (`<!-- anchor: ... -->`). Reorder without content change
+     * → moved_section. Heading edited → counted as modified (heading is part
+     * of section content in our parser). Each `modified` section carries a
+     * mandatory `line_diff` computed via Myers diff over section bodies.
+     */
+    diff(a: PageSnapshotData | null, b: PageSnapshotData | null, relPath: string): PageDiff;
+}
+/**
+ * Split markdown content into sections keyed by 8-char anchor. A section spans
+ * from a heading (with anchor comment) to the next heading of equal or higher
+ * level. Content without an anchor is grouped under an implicit root section
+ * keyed by `__root__`.
+ */
+export declare function parseSections(content: string): PageSection[];