@inharness-ai/claude4spec 1.0.0

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

@@ -0,0 +1,217 @@
+function label(entity) {
+    const method = entity.data.method ?? '';
+    const path = entity.data.path ?? '';
+    return `${method} ${path}`.trim();
+}
+function href(entity) {
+    return `/endpoints/${entity.slug}`;
+}
+function baseSingle(entity, ctx, includeDtos = true) {
+    const dtos = includeDtos ? ctx.reader.findEndpointDtos(entity.id) : undefined;
+    return {
+        type: 'endpoint',
+        slug: entity.slug,
+        method: entity.data.method,
+        path: entity.data.path,
+        summary: entity.data.summary ?? '',
+        description: entity.data.description ?? null,
+        tags: entity.tags,
+        ...(dtos !== undefined ? { dtos: formatDtos(dtos) } : {}),
+    };
+}
+function formatDtos(dtos) {
+    return dtos.map((d) => ({
+        dtoSlug: d.dtoSlug,
+        dtoName: d.dtoName,
+        relation: d.relation,
+        statusCode: d.statusCode,
+    }));
+}
+function buildSnapshot(entity, ctx) {
+    const dtos = ctx.reader.findEndpointDtos(entity.id);
+    return {
+        slug: entity.slug,
+        method: entity.data.method,
+        path: entity.data.path,
+        summary: (entity.data.summary ?? '') || null,
+        description: entity.data.description ?? null,
+        linked_dtos: dtos
+            .map((d) => ({
+            dto_slug: d.dtoSlug,
+            relation: d.relation,
+            status_code: d.statusCode,
+        }))
+            .sort((a, b) => `${a.relation}:${a.dto_slug}:${a.status_code ?? ''}`.localeCompare(`${b.relation}:${b.dto_slug}:${b.status_code ?? ''}`)),
+        tags: [...entity.tags].sort(),
+    };
+}
+/** Defensive coercion of pre-M17 legacy rows (Endpoint domain object) to the
+ *  EndpointSnapshot shape. Post-M17 rows already match the shape. */
+function coerceEndpoint(raw) {
+    const r = (raw ?? {});
+    // Legacy: { dtos: [{ dtoSlug, relation, statusCode }] } → linked_dtos
+    let linked_dtos = r.linked_dtos;
+    if (!linked_dtos && Array.isArray(r.dtos)) {
+        linked_dtos = r.dtos.map((d) => ({
+            dto_slug: String(d.dtoSlug ?? d.dto_slug ?? ''),
+            relation: String(d.relation ?? ''),
+            status_code: (d.statusCode ?? d.status_code ?? null),
+        }));
+    }
+    return {
+        slug: String(r.slug ?? ''),
+        method: String(r.method ?? ''),
+        path: String(r.path ?? ''),
+        summary: r.summary ?? null,
+        description: r.description ?? null,
+        linked_dtos: linked_dtos ?? [],
+        tags: Array.isArray(r.tags) ? r.tags : [],
+    };
+}
+function endpointDiff(a, b, slug) {
+    if (a == null && b == null)
+        return { type: 'endpoint', slug, op: 'noop' };
+    if (a == null)
+        return { type: 'endpoint', slug, op: 'created' };
+    if (b == null)
+        return { type: 'endpoint', slug, op: 'deleted' };
+    const sa = coerceEndpoint(a);
+    const sb = coerceEndpoint(b);
+    const changes = {};
+    const fieldChanges = [];
+    for (const field of ['method', 'path', 'summary', 'description']) {
+        if (sa[field] !== sb[field])
+            fieldChanges.push({ field, from: sa[field], to: sb[field] });
+    }
+    if (fieldChanges.length)
+        changes.field_changes = fieldChanges;
+    // Junction diff by (relation, dto_slug)
+    const keyOf = (l) => `${l.relation}|${l.dto_slug}`;
+    const aMap = new Map(sa.linked_dtos.map((l) => [keyOf(l), l]));
+    const bMap = new Map(sb.linked_dtos.map((l) => [keyOf(l), l]));
+    const dtoAdded = [];
+    const dtoRemoved = [];
+    const statusChanged = [];
+    for (const [k, link] of bMap) {
+        if (!aMap.has(k))
+            dtoAdded.push(link);
+    }
+    for (const [k, link] of aMap) {
+        const other = bMap.get(k);
+        if (!other) {
+            dtoRemoved.push(link);
+        }
+        else if (other.status_code !== link.status_code) {
+            statusChanged.push({
+                dto_slug: link.dto_slug,
+                relation: link.relation,
+                from: link.status_code,
+                to: other.status_code,
+            });
+        }
+    }
+    if (dtoAdded.length)
+        changes.dto_added = dtoAdded;
+    if (dtoRemoved.length)
+        changes.dto_removed = dtoRemoved;
+    if (statusChanged.length)
+        changes.status_code_changed = statusChanged;
+    // Tag diff (set semantics)
+    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: 'endpoint', slug, op: 'noop' };
+    return { type: 'endpoint', slug, op: 'modified', changes };
+}
+function endpointRestore(data, ctx) {
+    const snap = data;
+    const upsertResult = ctx.writer.upsertEndpoint(snap.slug, {
+        method: snap.method,
+        path: snap.path,
+        summary: snap.summary ?? '',
+        description: snap.description ?? undefined,
+    }, ctx.actor);
+    // Sync tags + junction (idempotent)
+    ctx.writer.syncTags('endpoint', snap.slug, snap.tags);
+    const junctionResult = ctx.writer.syncEndpointDtos(snap.slug, snap.linked_dtos.map((l) => ({
+        dtoSlug: l.dto_slug,
+        relation: l.relation,
+        statusCode: l.status_code,
+    })));
+    const warnings = junctionResult.warnings.length ? junctionResult.warnings : undefined;
+    return {
+        op: upsertResult.op,
+        entity: upsertResult.entity,
+        ...(warnings ? { warnings } : {}),
+    };
+}
+export const endpointSerializer = {
+    type: 'endpoint',
+    version: '1.0.0',
+    inlineMention: (entity) => ({
+        type: 'endpoint',
+        slug: entity.slug,
+        label: label(entity),
+        href: href(entity),
+    }),
+    singleElement: (entity, ctx) => baseSingle(entity, ctx, true),
+    elementListItem: (entity, ctx) => {
+        const base = baseSingle(entity, ctx, true);
+        const description = base.description ? base.description.split('\n')[0] : null;
+        return { ...base, description };
+    },
+    taggedListItem: (entity, ctx) => {
+        const base = baseSingle(entity, ctx, true);
+        const description = base.description ? base.description.split('\n')[0] : null;
+        return { ...base, description };
+    },
+    detail: (entity, ctx) => {
+        const base = baseSingle(entity, ctx, true);
+        const brokenRefs = [];
+        const dtos = ctx.reader.findEndpointDtos(entity.id);
+        const dtoObjects = dtos.map((link) => {
+            const dto = ctx.reader.getEntity('dto', link.dtoSlug);
+            if (!dto) {
+                brokenRefs.push(`dto:${link.dtoSlug}`);
+                return { ...link, dto: null };
+            }
+            if (ctx.depth >= ctx.maxDepth) {
+                return { ...link, dto: { slug: dto.slug, name: dto.data.name, _truncated: true } };
+            }
+            return {
+                ...link,
+                dto: {
+                    slug: dto.slug,
+                    name: dto.data.name,
+                    description: dto.data.description ?? null,
+                    fields: dto.data.fields,
+                    tags: dto.tags,
+                },
+            };
+        });
+        const references = ctx.reader.findSectionReferences('endpoint', entity.id);
+        return {
+            ...base,
+            dtos: dtoObjects,
+            _references: formatReferences(references),
+            ...(brokenRefs.length ? { _brokenRefs: brokenRefs } : {}),
+        };
+    },
+    // ─── M17 ───
+    snapshot: (entity, ctx) => buildSnapshot(entity, ctx),
+    restore: endpointRestore,
+    diff: endpointDiff,
+};
+function formatReferences(refs) {
+    return refs.map((r) => ({
+        anchor: r.anchor,
+        pagePath: r.pagePath,
+        headingText: r.headingText,
+        relation: r.relation,
+    }));
+}
+//# sourceMappingURL=serializer.js.map

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

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

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

@@ -0,0 +1,30 @@
+import type Database from 'better-sqlite3';
+import type { ChangedBy, Endpoint, EndpointCreateInput, EndpointDeleteResult, EndpointDtoRelation, EndpointListQuery, EndpointUpdateInput } from '../../../shared/entities.js';
+import type { TagsService } from '../../services/tags.js';
+import type { VersionService } from '../../services/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;
+    /**
+     * Idempotent UPSERT used by M17 restore. Routes to create or update based on
+     * existence of `slug`; preserves slug across update (no rename).
+     */
+    upsert(slug: string, input: EndpointCreateInput, actor: ChangedBy): {
+        entity: Endpoint;
+        op: 'created' | 'updated';
+    };
+    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/entities/endpoint/services.js

@@ -0,0 +1,260 @@
+import { endpointSlug } from '../../services/slug.js';
+import { DomainError } from '../../services/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.captureEntitySnapshot('endpoint', id, 'create', actor, 'Created', '1.0.0');
+            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.captureEntitySnapshot('endpoint', current.id, 'update', actor, summary, '1.0.0');
+            return updated;
+        });
+        return tx();
+    }
+    /**
+     * Idempotent UPSERT used by M17 restore. Routes to create or update based on
+     * existence of `slug`; preserves slug across update (no rename).
+     */
+    upsert(slug, input, actor) {
+        const existing = this.getBySlug(slug);
+        if (!existing) {
+            const entity = this.create(input, actor);
+            return { entity, op: 'created' };
+        }
+        const entity = this.update(slug, {
+            method: input.method,
+            path: input.path,
+            summary: input.summary,
+            description: input.description,
+            tags: input.tags,
+        }, actor);
+        return { entity, op: 'updated' };
+    }
+    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`);
+            // M17: capture snapshot BEFORE delete so the tombstone preserves
+            // last-known data (used by restore-from-tombstone in M17 Phase 6).
+            this.versions.captureEntitySnapshot('endpoint', row.id, 'delete', actor, 'Deleted', '1.0.0');
+            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=services.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"services.js","sourceRoot":"","sources":["../../../../src/server/entities/endpoint/services.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAIrD,MAAM,iBAAiB,GAAqC,IAAI,GAAG,CAAsB;IACvF,SAAS;IACT,UAAU;IACV,OAAO;CACR,CAAC,CAAC;AAaH,MAAM,eAAe,GAA4B,IAAI,GAAG,CAAa;IACnE,KAAK;IACL,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,OAAO,eAAe;IAEhB;IACA;IACA;IAHV,YACU,EAAqB,EACrB,IAAiB,EACjB,QAAwB;QAFxB,OAAE,GAAF,EAAE,CAAmB;QACrB,SAAI,GAAJ,IAAI,CAAa;QACjB,aAAQ,GAAR,QAAQ,CAAgB;IAC/B,CAAC;IAEJ,MAAM,CAAC,KAA0B,EAAE,KAAgB;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;QAEzE,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpF,IAAI,QAAQ;gBAAE,MAAM,IAAI,WAAW,CAAC,eAAe,EAAE,kBAAkB,IAAI,kBAAkB,CAAC,CAAC;YAE/F,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;iBACjB,OAAO,CACN;kCACwB,CACzB;iBACA,GAAG,CACF,IAAI,EACJ,MAAM,EACN,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,OAAO,IAAI,EAAE,EACnB,KAAK,CAAC,WAAW,IAAI,IAAI,CAC1B,CAAC;YACJ,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM;gBAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACzE,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACzF,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,IAAI,CAAC,QAA2B,EAAE;QAChC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAc,EAAE,CAAC;QAE7B,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YAC7D,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,SAAS,GAAkB,IAAI,CAAC;QACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACnD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvD,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;gBAC9B,SAAS,GAAG;;;;;gEAK4C,YAAY;;;;SAInE,CAAC;gBACF,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,SAAS,GAAG;;;;gEAI4C,YAAY;;SAEnE,CAAC;gBACF,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,IAAI,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAErC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAE9C,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CACN;WACG,QAAQ;;0BAEO,CACnB;aACA,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,CAAkB,CAAC;QAElD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,CAAC,IAAI,CAEhE,CAAC;QACd,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,GAAG,CAAC,IAAI,CAEjE,CAAC;QACd,OAAO,GAAG,EAAE,EAAE,IAAI,IAAI,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,KAA0B,EAAE,KAAgB;QAC/D,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAClC,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,CAAC,IAAI,CAEpE,CAAC;YACd,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,WAAW,CAAC,WAAW,EAAE,aAAa,IAAI,aAAa,CAAC,CAAC;YAEjF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,OAAO,CAAC,MAAqB,CAAC;YAChG,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YACxC,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC;YAE3C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACxF,IAAI,QAAQ;oBAAE,MAAM,IAAI,WAAW,CAAC,eAAe,EAAE,kBAAkB,QAAQ,kBAAkB,CAAC,CAAC;YACrG,CAAC;YAED,MAAM,OAAO,GAAgB;gBAC3B,GAAG,OAAO;gBACV,IAAI,EAAE,QAAQ;gBACd,MAAM;gBACN,IAAI;gBACJ,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO;gBACzC,WAAW,EAAE,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW;aACvF,CAAC;YAEF,IAAI,CAAC,EAAE;iBACJ,OAAO,CACN;;;wBAGc,CACf;iBACA,GAAG,CACF,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,EAAE,CACX,CAAC;YAEJ,IAAI,KAAK,CAAC,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAEzE,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,iBAAiB,IAAI,SAAS,QAAQ,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1F,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC/F,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,IAAY,EAAE,KAA0B,EAAE,KAAgB;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACzC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;QACnC,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;YAC/B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,EAAE,KAAK,CAAC,CAAC;QACV,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,KAAgB;QACnC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAClC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,CAAC,IAAI,CAEhE,CAAC;YACd,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,WAAW,CAAC,WAAW,EAAE,aAAa,IAAI,aAAa,CAAC,CAAC;YAE7E,iEAAiE;YACjE,mEAAmE;YACnE,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAC7F,IAAI,CAAC,EAAE;iBACJ,OAAO,CAAC,yEAAyE,CAAC;iBAClF,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACf,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAEjE,MAAM,gBAAgB,GAAsB,EAAE,CAAC;YAC/C,OAAO,EAAE,OAAO,EAAE,IAAa,EAAE,gBAAgB,EAAE,CAAC;QACtD,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAEO,eAAe,CAAC,EAAU;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC,GAAG,CAAC,EAAE,CAE5D,CAAC;QACd,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAEO,OAAO,CAAC,GAAgB;QAC9B,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,MAAM,EAAE,GAAG,CAAC,MAAoB;YAChC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC;YACrD,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,SAAS,EAAE,GAAG,CAAC,UAAU;SAC1B,CAAC;IACJ,CAAC;IAEO,aAAa,CAAC,UAAkB;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CACN;;;;uDAI+C,CAChD;aACA,GAAG,CAAC,UAAU,CAKb,CAAC;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtB,OAAO,EAAE,CAAC,CAAC,QAAQ;YACnB,OAAO,EAAE,CAAC,CAAC,QAAQ;YACnB,QAAQ,EAAE,CAAC,CAAC,QAA+B;YAC3C,UAAU,EAAE,CAAC,CAAC,WAAW;SAC1B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,OAAO,CACL,YAAoB,EACpB,OAAe,EACf,QAA6B,EAC7B,aAA4B,IAAI;QAEhC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,qBAAqB,QAAQ,GAAG,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,QAAQ,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YAClD,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,+CAA+C,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,GAAG,CAAC,YAAY,CAExE,CAAC;QACd,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,WAAW,CAAC,WAAW,EAAE,aAAa,YAAY,aAAa,CAAC,CAAC;QACpF,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,CAAC,OAAO,CAE/D,CAAC;QACd,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,WAAW,CAAC,WAAW,EAAE,QAAQ,OAAO,aAAa,CAAC,CAAC;QAC3E,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;+BACuB,CACxB;aACA,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,SAAS,CACP,YAAoB,EACpB,OAAe,EACf,QAA6B,EAC7B,aAA4B,IAAI;QAEhC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,GAAG,CAAC,YAAY,CAExE,CAAC;QACd,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,WAAW,CAAC,WAAW,EAAE,aAAa,YAAY,aAAa,CAAC,CAAC;QACpF,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,CAAC,OAAO,CAE/D,CAAC;QACd,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,WAAW,CAAC,WAAW,EAAE,QAAQ,OAAO,aAAa,CAAC,CAAC;QAC3E,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,EAAE;iBACJ,OAAO,CACN;2FACiF,CAClF;iBACA,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,EAAE;iBACJ,OAAO,CACN;uFAC6E,CAC9E;iBACA,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAEO,aAAa,CAAC,CAAS;QAC7B,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAgB,CAAC;QAC5C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,uBAAuB,CAAC,GAAG,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/server/entities/endpoint/system-prompt.d.ts

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

package/dist/server/entities/endpoint/system-prompt.js

@@ -0,0 +1,11 @@
+export const endpointSystemPrompt = {
+    roleNoun: 'Endpoints',
+    countStat: {
+        placeholder: 'endpointCount',
+        sqlQuery: 'SELECT COUNT(*) AS count FROM endpoint',
+        label: 'endpoints',
+    },
+    mcpToolsLine: 'endpoint-tools: create_endpoint, get_endpoint, update_endpoint, delete_endpoint, list_endpoints, link_dto, unlink_dto',
+    narrativeBlock: 'REST endpoints (method, path, summary, linked DTOs, tags)',
+};
+//# sourceMappingURL=system-prompt.js.map

package/dist/server/entities/endpoint/system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../../../src/server/entities/endpoint/system-prompt.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAA6B;IAC5D,QAAQ,EAAE,WAAW;IACrB,SAAS,EAAE;QACT,WAAW,EAAE,eAAe;QAC5B,QAAQ,EAAE,wCAAwC;QAClD,KAAK,EAAE,WAAW;KACnB;IACD,YAAY,EACV,uHAAuH;IACzH,cAAc,EAAE,2DAA2D;CAC5E,CAAC"}

package/dist/server/entities/ui-view/mcp-server.d.ts

@@ -0,0 +1,10 @@
+import { type McpServerInstance } from '@inharness-ai/agent-adapters';
+import type { UiViewService } from './services.js';
+import type { ReferencesService } from '../../services/references.js';
+import type { WsGateway } from '../../ws/gateway.js';
+export interface UiViewToolsDeps {
+    uiViewService: UiViewService;
+    referencesService: ReferencesService;
+    ws: WsGateway;
+}
+export declare function createUiViewToolsServer(deps: UiViewToolsDeps): McpServerInstance;