@x12i/memorix-service 0.0.0-bootstrap.0

package/dist/routes/data.js

@@ -0,0 +1,237 @@
+import { resolveScope } from "../request-scope.js";
+import { ServiceError } from "../errors.js";
+export async function registerDataRoutes(app, platform) {
+    app.get("/api/data/content", async (req) => {
+        const scope = resolveScope(req);
+        const q = req.query;
+        if (!q.objectType || !q.contentType) {
+            throw new ServiceError("VALIDATION", "objectType and contentType required", 400);
+        }
+        const ports = platform.portsFor(scope);
+        if (q.id) {
+            const record = await ports.reader.getContent(scope, {
+                objectType: q.objectType,
+                contentType: q.contentType,
+                recordId: q.id,
+            });
+            let unresolvedRelationships = [];
+            if (q.expandRelationships === "true") {
+                const rels = await ports.reader.getRelationships(scope, q.id, {
+                    include: true,
+                    expandContentTypes: ["snapshots"],
+                });
+                unresolvedRelationships = rels.items.filter((i) => i.targetStatus === "unresolved");
+            }
+            return {
+                scope,
+                addressing: {
+                    orgId: scope.orgId,
+                    objectType: q.objectType,
+                    contentType: q.contentType,
+                    id: q.id,
+                },
+                record,
+                currentRevision: record.revision,
+                unresolvedRelationships,
+            };
+        }
+        const listed = await ports.reader.listContent(scope, {
+            objectType: q.objectType,
+            contentType: q.contentType,
+            limit: Math.min(Number(q.limit ?? 50), 200),
+            cursor: q.cursor,
+        });
+        return {
+            scope,
+            addressing: {
+                orgId: scope.orgId,
+                objectType: q.objectType,
+                contentType: q.contentType,
+                id: null,
+            },
+            records: listed.items,
+            pageInfo: { nextCursor: listed.nextCursor ?? null },
+            unresolvedRelationships: [],
+            currentRevision: null,
+        };
+    });
+    app.get("/api/data/abstract", async (req) => {
+        const scope = resolveScope(req);
+        const q = req.query;
+        if (!q.abstractType) {
+            throw new ServiceError("VALIDATION", "abstractType required", 400);
+        }
+        const ports = platform.portsFor(scope);
+        if (q.id) {
+            const item = await ports.reader.getAbstract(scope, {
+                abstractType: q.abstractType,
+                recordId: q.id,
+            });
+            return { scope, abstractType: q.abstractType, item };
+        }
+        const listed = await ports.reader.listAbstract(scope, {
+            abstractType: q.abstractType,
+            limit: 50,
+        });
+        return {
+            scope,
+            abstractType: q.abstractType,
+            records: listed.items,
+            pageInfo: { nextCursor: listed.nextCursor ?? null },
+        };
+    });
+    app.post("/api/data/content", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!body.objectType || !body.contentType) {
+            throw new ServiceError("VALIDATION", "objectType, contentType required", 400);
+        }
+        if (!body.precondition) {
+            throw new ServiceError("VALIDATION", "precondition required: absent | exact-revision", 400);
+        }
+        const ports = platform.portsFor(scope);
+        const op = body.op ?? (body.precondition === "absent" ? "add" : "upsert");
+        try {
+            if (op === "remove") {
+                if (!body.record?.recordId || body.expectedRevision === undefined) {
+                    throw new ServiceError("VALIDATION", "record.recordId and expectedRevision required for remove", 400);
+                }
+                const result = await ports.writer.remove({
+                    scope,
+                    objectType: body.objectType,
+                    contentType: body.contentType,
+                    recordId: body.record.recordId,
+                    precondition: { kind: "revision", revision: Number(body.expectedRevision) },
+                });
+                return { scope, written: true, result, precondition: body.precondition };
+            }
+            if (!body.record) {
+                throw new ServiceError("VALIDATION", "record required", 400);
+            }
+            const record = {
+                ...body.record,
+                objectType: body.objectType,
+                contentType: body.contentType,
+            };
+            let result;
+            if (op === "add" || body.precondition === "absent") {
+                result = await ports.writer.add({
+                    scope,
+                    precondition: { kind: "absent" },
+                    record,
+                });
+            }
+            else if (op === "patch") {
+                result = await ports.writer.patch({
+                    scope,
+                    precondition: { kind: "revision", revision: Number(body.expectedRevision) },
+                    objectType: body.objectType,
+                    contentType: body.contentType,
+                    recordId: body.record.recordId,
+                    ops: body.patch ?? [],
+                });
+            }
+            else if (op === "replace") {
+                result = await ports.writer.replace({
+                    scope,
+                    precondition: { kind: "revision", revision: Number(body.expectedRevision) },
+                    record,
+                });
+            }
+            else {
+                result = await ports.writer.upsert({
+                    scope,
+                    precondition: body.expectedRevision !== undefined
+                        ? { kind: "revision", revision: Number(body.expectedRevision) }
+                        : { kind: "absent" },
+                    record,
+                });
+            }
+            return {
+                scope,
+                written: true,
+                result,
+                currentRevision: result.record.revision,
+                precondition: body.precondition,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (/stale|revision|WRITE_STALE/i.test(msg)) {
+                throw new ServiceError("REVISION_CONFLICT", msg, 409);
+            }
+            throw err;
+        }
+    });
+    app.post("/api/data/compose", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!body?.explicit) {
+            throw new ServiceError("VALIDATION", "composition requires explicit:true", 400);
+        }
+        if (!body.recordId) {
+            throw new ServiceError("VALIDATION", "recordId required", 400);
+        }
+        const ports = platform.portsFor(scope);
+        const composition = await ports.reader.composeSubject(scope, {
+            recordId: body.recordId,
+            contentTypes: body.contentTypes,
+        });
+        // Flatten sibling content instances for operator UI — every instance must match subject.
+        const instances = [];
+        for (const [contentType, list] of Object.entries(composition.contents ?? {})) {
+            for (const rec of list) {
+                const rid = String(rec.recordId ?? "");
+                if (rid !== body.recordId) {
+                    throw new ServiceError("COMPOSITION_INTEGRITY", `composeSubject returned foreign recordId ${rid} for subject ${body.recordId}`, 500);
+                }
+                instances.push({
+                    recordId: rid,
+                    objectType: composition.objectType,
+                    contentType,
+                    dataCategory: composition.dataCategory,
+                    revision: rec.revision ?? null,
+                    data: rec.data ?? null,
+                });
+            }
+        }
+        return {
+            scope,
+            recordId: body.recordId,
+            objectType: composition.objectType,
+            dataCategory: composition.dataCategory,
+            instances,
+            composition,
+            warnings: composition.warnings ?? [],
+        };
+    });
+    app.post("/api/data/abstract/patch", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!body.abstractType ||
+            !body.recordId ||
+            !body.changes ||
+            body.expectedRevision === undefined) {
+            throw new ServiceError("VALIDATION", "abstractType, recordId, changes, expectedRevision required", 400);
+        }
+        const ports = platform.portsFor(scope);
+        try {
+            const result = await ports.abstractWriter.patchAbstract({
+                scope,
+                abstractType: body.abstractType,
+                recordId: body.recordId,
+                changes: body.changes,
+                expectedRevision: body.expectedRevision,
+            });
+            return { scope, result };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (/stale|revision/i.test(msg)) {
+                throw new ServiceError("REVISION_CONFLICT", msg, 409);
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=data.js.map

package/dist/routes/data.js.map

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

package/dist/routes/intelligence.d.ts

@@ -0,0 +1,5 @@
+import type { FastifyInstance } from "fastify";
+import type { MemorixPlatform } from "../platform.js";
+/** Intelligence — proposals never auto-install/publish/mutate. */
+export declare function registerIntelligenceRoutes(app: FastifyInstance, platform: MemorixPlatform): Promise<void>;
+//# sourceMappingURL=intelligence.d.ts.map

package/dist/routes/intelligence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence.d.ts","sourceRoot":"","sources":["../../src/routes/intelligence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAO/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAItD,kEAAkE;AAClE,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CA2Gf"}

package/dist/routes/intelligence.js

@@ -0,0 +1,94 @@
+import { profileRecords, suggestPeopleUnion, compareProposalsToApprovedOps, } from "@x12i/memorix-intelligence";
+import { resolveScope } from "../request-scope.js";
+import { ServiceError } from "../errors.js";
+/** Intelligence — proposals never auto-install/publish/mutate. */
+export async function registerIntelligenceRoutes(app, platform) {
+    app.post("/api/intelligence/profile", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!body?.label || !Array.isArray(body.records)) {
+            throw new ServiceError("VALIDATION", "label and records[] required", 400);
+        }
+        const records = body.records.filter((r) => r !== null && typeof r === "object" && !Array.isArray(r));
+        const profile = profileRecords(records, {
+            scope: { orgId: scope.orgId, agentIds: scope.agentIds },
+            label: body.label,
+        });
+        if (platform.client) {
+            await platform.intelligenceArtifactsFor(scope.orgId).putProfile(body.label, profile);
+        }
+        return {
+            scope,
+            profile,
+            profileSummary: {
+                label: profile.label,
+                fingerprint: profile.fingerprint,
+                recordCount: profile.recordCount,
+                fieldCount: profile.fields.length,
+            },
+            autoInstall: false,
+        };
+    });
+    app.post("/api/intelligence/suggest/people", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!Array.isArray(body?.profiles) || body.profiles.length < 2) {
+            throw new ServiceError("VALIDATION", "profiles[] (>=2) required", 400);
+        }
+        const proposals = suggestPeopleUnion({
+            scope: { orgId: scope.orgId, agentIds: scope.agentIds },
+            profiles: body.profiles,
+        });
+        if (platform.client) {
+            const store = platform.intelligenceArtifactsFor(scope.orgId);
+            for (const p of proposals)
+                await store.putProposal(p);
+        }
+        return {
+            scope,
+            proposals: proposals.map((p) => ({
+                proposalId: p.proposalId,
+                metadataKind: p.metadataKind,
+                metadataId: p.metadataId,
+                outcome: p.outcome,
+                proposalFingerprint: p.proposalFingerprint,
+            })),
+            autoInstall: false,
+            note: "proposals are review artifacts until explicit metadata install",
+        };
+    });
+    app.get("/api/intelligence/proposals", async (req) => {
+        const scope = resolveScope(req);
+        const ids = platform.client
+            ? await platform.intelligenceArtifactsFor(scope.orgId).listProposalIds()
+            : [];
+        return { scope, proposalIds: ids, autoInstall: false };
+    });
+    app.post("/api/intelligence/compare", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!Array.isArray(body?.proposals)) {
+            throw new ServiceError("VALIDATION", "proposals[] required", 400);
+        }
+        const report = compareProposalsToApprovedOps(body.proposals, (body.approvedOps ?? {}));
+        return { scope, report, autoInstall: false };
+    });
+    app.post("/api/intelligence/export-draft", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!body?.confirm) {
+            throw new ServiceError("CONFIRMATION_REQUIRED", "confirm:true required to export as metadata draft", 400);
+        }
+        if (!body.proposalId) {
+            throw new ServiceError("VALIDATION", "proposalId required", 400);
+        }
+        return {
+            scope,
+            proposalId: body.proposalId,
+            exported: true,
+            installed: false,
+            note: "export yields a draft for metadata workflow — does not install",
+        };
+    });
+}
+//# sourceMappingURL=intelligence.js.map

package/dist/routes/intelligence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence.js","sourceRoot":"","sources":["../../src/routes/intelligence.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,6BAA6B,GAE9B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,GAAoB,EACpB,QAAyB;IAEzB,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAClD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,CAAC,IAGhB,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,YAAY,CAAC,YAAY,EAAE,8BAA8B,EAAE,GAAG,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CACjC,CAAC,CAAC,EAAgC,EAAE,CAClC,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAC3D,CAAC;QACF,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE;YACtC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;YACvD,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,QAAQ,CAAC,wBAAwB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACvF,CAAC;QACD,OAAO;YACL,KAAK;YACL,OAAO;YACP,cAAc,EAAE;gBACd,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;aAClC;YACD,WAAW,EAAE,KAAK;SACnB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,kCAAkC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACzD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,CAAC,IAA0C,CAAC;QAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,YAAY,CAAC,YAAY,EAAE,2BAA2B,EAAE,GAAG,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,SAAS,GAAG,kBAAkB,CAAC;YACnC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;YACvD,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,QAAQ,CAAC,wBAAwB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7D,KAAK,MAAM,CAAC,IAAI,SAAS;gBAAE,MAAM,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC;QACD,OAAO;YACL,KAAK;YACL,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC/B,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,YAAY,EAAE,CAAC,CAAC,YAAY;gBAC5B,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,mBAAmB,EAAE,CAAC,CAAC,mBAAmB;aAC3C,CAAC,CAAC;YACH,WAAW,EAAE,KAAK;YAClB,IAAI,EAAE,gEAAgE;SACvE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,6BAA6B,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACnD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM;YACzB,CAAC,CAAC,MAAM,QAAQ,CAAC,wBAAwB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,eAAe,EAAE;YACxE,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAClD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,CAAC,IAGhB,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,YAAY,CAAC,YAAY,EAAE,sBAAsB,EAAE,GAAG,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,MAAM,GAAG,6BAA6B,CAC1C,IAAI,CAAC,SAAkB,EACvB,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAU,CAClC,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,gCAAgC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACvD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAkD,CAAC;QACpE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,YAAY,CACpB,uBAAuB,EACvB,mDAAmD,EACnD,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,YAAY,CAAC,YAAY,EAAE,qBAAqB,EAAE,GAAG,CAAC,CAAC;QACnE,CAAC;QACD,OAAO;YACL,KAAK;YACL,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,KAAK;YAChB,IAAI,EAAE,gEAAgE;SACvE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/routes/memory.d.ts

@@ -0,0 +1,4 @@
+import type { FastifyInstance } from "fastify";
+import type { MemorixPlatform } from "../platform.js";
+export declare function registerMemoryRoutes(app: FastifyInstance, platform: MemorixPlatform): Promise<void>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/routes/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/routes/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAItD,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAyFf"}

package/dist/routes/memory.js

@@ -0,0 +1,80 @@
+import { resolveScope } from "../request-scope.js";
+import { ServiceError } from "../errors.js";
+export async function registerMemoryRoutes(app, platform) {
+    app.get("/api/memory/sources", async (req) => {
+        const scope = resolveScope(req);
+        const effective = platform.metadata.resolveEffective(scope.agentIds);
+        const sources = (effective.effective ?? [])
+            .filter((e) => e.kind === "sources")
+            .map((e) => {
+            const d = e.definition;
+            const { credential: _c, credentials: _cs, secret: _s, ...safe } = d;
+            return { id: e.id, ...safe };
+        });
+        return { scope, sources, note: "credentialRef only" };
+    });
+    app.post("/api/memory/pull", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (body.credential !== undefined) {
+            throw new ServiceError("SECRETS_FORBIDDEN", "resolved credentials must not cross the API; use credentialRef only", 400);
+        }
+        if (!body.sourceId)
+            throw new ServiceError("VALIDATION", "sourceId required", 400);
+        const ports = platform.portsFor(scope);
+        const result = await ports.memory.pull({
+            scope,
+            sourceId: body.sourceId,
+            mode: body.mode ?? "knowledge",
+            trigger: "on-demand",
+        });
+        return {
+            scope,
+            runId: result.pullId,
+            sourceId: body.sourceId,
+            mode: result.mode,
+            credentialRef: body.credentialRef ?? null,
+            status: result.status,
+            result: {
+                created: result.created,
+                updated: result.updated,
+                quarantined: result.quarantined,
+                pagesReceived: result.pagesReceived,
+                endingCursor: result.endingCursor,
+            },
+        };
+    });
+    app.get("/api/memory/runs", async (req) => {
+        const scope = resolveScope(req);
+        return { scope, runs: [], quarantine: [], checkpoints: [] };
+    });
+    app.get("/api/memory/raw", async (req) => {
+        const scope = resolveScope(req);
+        const q = req.query;
+        if (!q.objectType || !q.id) {
+            throw new ServiceError("VALIDATION", "objectType and id required", 400);
+        }
+        const ports = platform.portsFor(scope);
+        const record = await ports.reader.getContent(scope, {
+            objectType: q.objectType,
+            contentType: "raw",
+            recordId: q.id,
+        });
+        const root = record;
+        const associatedRootKeys = Object.keys(root).filter((k) => /^associated/i.test(k));
+        return {
+            scope,
+            objectType: q.objectType,
+            id: q.id,
+            recordId: record.recordId,
+            contentType: record.contentType,
+            dataCategory: record.dataCategory ?? null,
+            revision: record.revision,
+            currentRevision: record.revision,
+            data: record.data,
+            associatedRootKeys,
+            note: "exact raw .data landing; no secrets; associated* must not be copied to root",
+        };
+    });
+}
+//# sourceMappingURL=memory.js.map

package/dist/routes/memory.js.map

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

package/dist/routes/metadata.d.ts

@@ -0,0 +1,4 @@
+import type { FastifyInstance } from "fastify";
+import type { MemorixPlatform } from "../platform.js";
+export declare function registerMetadataRoutes(app: FastifyInstance, platform: MemorixPlatform): Promise<void>;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/routes/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/routes/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAKtD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CA2Hf"}

package/dist/routes/metadata.js

@@ -0,0 +1,104 @@
+import { validateMetadataPack } from "@x12i/memorix-metadata";
+import { resolveScope } from "../request-scope.js";
+import { ServiceError } from "../errors.js";
+import { listKnownPackIds, loadKnownMetadataPack } from "../known-packs.js";
+export async function registerMetadataRoutes(app, platform) {
+    app.get("/api/metadata/packs", async (req) => {
+        const scope = resolveScope(req);
+        return {
+            scope,
+            packs: listKnownPackIds(),
+            note: "known packs for explicit install only",
+        };
+    });
+    app.get("/api/metadata/raw", async (req) => {
+        const scope = resolveScope(req);
+        const agentId = scope.agentIds[0];
+        return { scope, agentId, raw: platform.metadata.getRaw(agentId) };
+    });
+    app.get("/api/metadata/effective", async (req) => {
+        const scope = resolveScope(req);
+        const resolved = platform.metadata.resolveEffective(scope.agentIds);
+        // Contract: `effective` is always the EffectiveDefinition[] array.
+        // Inheritance / resolve diagnostics live beside it (never nested as the array).
+        return {
+            scope,
+            ok: resolved.ok,
+            selectedAgentIds: resolved.selectedAgentIds ?? [],
+            collapsedAgentIds: resolved.collapsedAgentIds ?? [],
+            effective: Array.isArray(resolved.effective) ? resolved.effective : [],
+            provenance: {
+                conflicts: resolved.conflicts ?? [],
+                issues: resolved.issues ?? [],
+                referenceIssues: resolved.referenceIssues ?? [],
+            },
+            note: "agentIds select effective metadata only; effective is the resolved definition array",
+        };
+    });
+    app.get("/api/metadata/kinds/:kind", async (req) => {
+        const scope = resolveScope(req);
+        const { kind } = req.params;
+        const effective = platform.metadata.resolveEffective(scope.agentIds);
+        const items = (effective.effective ?? []).filter((e) => e.kind === kind);
+        return { scope, kind, items };
+    });
+    app.get("/api/metadata/abstracts", async (req) => {
+        const scope = resolveScope(req);
+        return { scope, result: platform.metadata.resolveAbstracts(scope.agentIds) };
+    });
+    app.post("/api/metadata/validate", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        const pack = body.pack ?? (body.packId ? loadKnownMetadataPack(body.packId) : undefined);
+        if (!pack)
+            throw new ServiceError("VALIDATION", "pack or packId required", 400);
+        return { scope, result: validateMetadataPack(pack), autoInstall: false };
+    });
+    app.post("/api/metadata/install", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!body?.confirm) {
+            throw new ServiceError("CONFIRMATION_REQUIRED", "explicit confirm:true required for metadata install", 400);
+        }
+        const pack = body.pack ?? (body.packId ? loadKnownMetadataPack(body.packId) : undefined);
+        if (!pack)
+            throw new ServiceError("VALIDATION", "pack or packId required", 400);
+        const validation = validateMetadataPack(pack);
+        if (!validation.ok) {
+            return { scope, result: validation, installed: false, published: false };
+        }
+        const result = platform.metadata.install(pack, { reinstall: body.reinstall });
+        return {
+            scope,
+            packId: body.packId ?? pack.agentId,
+            result,
+            installed: Boolean(result.ok),
+            published: false,
+            isolation: platform.isolation
+                ? {
+                    orgId: platform.isolation.orgId,
+                    metadataDb: platform.isolation.isolatedMetadataDb,
+                }
+                : null,
+            note: "intelligence proposals are never auto-installed",
+        };
+    });
+    app.post("/api/metadata/publish", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!body?.confirm) {
+            throw new ServiceError("CONFIRMATION_REQUIRED", "explicit confirm:true required for metadata publish", 400);
+        }
+        return { scope, published: true, note: "publish is explicit" };
+    });
+    app.get("/api/metadata/definition", async (req) => {
+        const scope = resolveScope(req);
+        const q = req.query;
+        if (!q.kind || !q.id) {
+            throw new ServiceError("VALIDATION", "kind and id required", 400);
+        }
+        const def = platform.metadata.getDefinition(scope.agentIds, q.kind, q.id);
+        return { scope, definition: def };
+    });
+}
+//# sourceMappingURL=metadata.js.map

package/dist/routes/metadata.js.map

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

package/dist/routes/operations.d.ts

@@ -0,0 +1,4 @@
+import type { FastifyInstance } from "fastify";
+import type { MemorixPlatform } from "../platform.js";
+export declare function registerOperationsRoutes(app: FastifyInstance, platform: MemorixPlatform): Promise<void>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/routes/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/routes/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAiEf"}