@x12i/memorix-service 3.0.6 → 3.1.0

package/dist/app.js

@@ -18,10 +18,16 @@ import { registerOperationsRoutes } from "./routes/operations.js";
 import { registerWorkflowRoutes } from "./routes/workflow.js";
 import { registerIntelligenceRoutes } from "./routes/intelligence.js";
 import { registerDataJourneyRoutes } from "./routes/data-journey.js";
+import { registerSimulationRoutes } from "./routes/simulation.js";
+import { registerAssistRoutes } from "./routes/assist.js";
+import { registerAiServicesRoutes } from "./routes/ai-services.js";
+import { createSimulationController } from "./simulation.js";
 import { memorixLiveRing } from "./live.js";
+import { resolveConfiguredAiServiceOrigins } from "./ai-services/config.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 export async function createMemorixServiceApp(opts) {
     const platform = opts.platform ?? (await createMemorixPlatform(opts));
+    const simulation = createSimulationController();
     const app = Fastify({ logger: opts.logger ?? false });
     await app.register(cors, { origin: true });
     const core = await attachCoreFastify(app, {
@@ -36,11 +42,20 @@ export async function createMemorixServiceApp(opts) {
             docsPath: "/api/openapi.json",
             description: "Sole HTTP composition root",
         },
-        getHealth: async () => ({
-            ok: true,
-            service: "@x12i/memorix-service",
-            mode: platform.mode,
-        }),
+        getHealth: async () => {
+            const sim = simulation.getState();
+            return {
+                ok: true,
+                service: "@x12i/memorix-service",
+                mode: platform.mode,
+                simulation: {
+                    supported: sim.supported,
+                    active: sim.active,
+                    apsPackageSim: sim.apsPackageSim,
+                    blockedOn: sim.blockedOn,
+                },
+            };
+        },
     });
     app.setErrorHandler((err, req, reply) => {
         const correlationId = req.correlationId ?? randomUUID();
@@ -55,8 +70,22 @@ export async function createMemorixServiceApp(opts) {
     });
     app.get("/api/diagnostics/scope", async (req) => {
         const scope = resolveScope(req);
-        return { scope, platform: platform.diagnostics(scope) };
+        const base = platform.diagnostics(scope);
+        return {
+            scope,
+            platform: {
+                ...base,
+                aiServices: resolveConfiguredAiServiceOrigins().map((o) => ({
+                    aiServiceType: o.aiServiceType,
+                    env: o.env,
+                    url: o.url,
+                    configured: Boolean(o.url),
+                    defaultPort: o.defaultPort,
+                })),
+            },
+        };
     });
+    registerSimulationRoutes(app, simulation);
     await registerMetadataRoutes(app, platform);
     await registerDataRoutes(app, platform);
     await registerRelationshipRoutes(app, platform);
@@ -67,6 +96,8 @@ export async function createMemorixServiceApp(opts) {
     await registerWorkflowRoutes(app, platform);
     await registerIntelligenceRoutes(app, platform);
     await registerDataJourneyRoutes(app, platform);
+    await registerAssistRoutes(app, platform);
+    await registerAiServicesRoutes(app, platform);
     // Minute-resolution Memory pull schedule ticker (collector-only; not pipelines).
     platform.startMemoryScheduleTicker({ intervalMs: 60_000 });
     return { app, platform, port: core.port };

package/dist/app.js.map

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

package/dist/assist/ask.d.ts

@@ -0,0 +1,35 @@
+import type { MemorixPlatform } from "../platform.js";
+import type { AskIntent, AskResult, EntityRef } from "./types.js";
+type AssistRouting = {
+    explicitIntent: Record<string, string>;
+    autoByEntityKind: Record<string, string>;
+    fallback: string;
+};
+export declare function resolveAssistantsRoot(): string;
+/** Load routing.json from assistants root; fall back to built-in map. */
+export declare function loadAssistRouting(rootDir?: string): AssistRouting;
+/** True when FuncX / LLM Ask can run (OPENROUTER_API_KEY set). */
+export declare function isAskLlmEnabled(): boolean;
+export type AssistStatus = {
+    validateEnabled: true;
+    askEnabled: boolean;
+    /** Human-readable reason when Ask is disabled. */
+    askDisabledReason: string | null;
+};
+export declare function getAssistStatus(): AssistStatus;
+/** Test hook to reset cached router and routing. */
+export declare function resetAssistRouterForTests(): void;
+/**
+ * Precedence: platform-magit → explicit non-auto intent → auto-by-kind → fallback.
+ * Mirrors .assistants-functions/routing.json.
+ */
+export declare function assistantIdForIntent(entity: EntityRef, intent: AskIntent): string;
+export declare function resolveAskIntent(entity: EntityRef, intent: AskIntent): AskIntent;
+/**
+ * Render assistant prompt.rendrix.md with Ask payload as working memory.
+ * Falls back to JSON.stringify when template is missing or render fails.
+ */
+export declare function renderAskPrompt(assistantId: string, payload: unknown, rootDir?: string): Promise<string>;
+export declare function askEntity(platform: MemorixPlatform, entity: EntityRef, intentIn: AskIntent, prompt?: string): Promise<AskResult>;
+export {};
+//# sourceMappingURL=ask.d.ts.map

package/dist/assist/ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../../src/assist/ask.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,KAAK,EAEV,SAAS,EAET,SAAS,EAET,SAAS,EACV,MAAM,YAAY,CAAC;AAmCpB,KAAK,aAAa,GAAG;IACnB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAgBF,wBAAgB,qBAAqB,IAAI,MAAM,CAa9C;AAUD,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,OAAO,SAA0B,GAAG,aAAa,CA+BlF;AAED,kEAAkE;AAClE,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,eAAe,EAAE,IAAI,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAAC;AAEF,wBAAgB,eAAe,IAAI,YAAY,CAc9C;AAeD,oDAAoD;AACpD,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,GAChB,MAAM,CAgBR;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,GAChB,SAAS,CAGX;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,EAChB,OAAO,SAA0B,GAChC,OAAO,CAAC,MAAM,CAAC,CAejB;AA+GD,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,SAAS,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC,CA8EpB"}

package/dist/assist/ask.js

@@ -0,0 +1,346 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { gatherEntityFacts } from "./facts.js";
+import { validateEntity } from "./validate.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ALLOWED_ACTION_IDS = new Set([
+    "stage-proposal",
+    "validate-draft-pack",
+    "install-draft",
+    "navigate",
+]);
+/** Fallback when routing.json is missing — mirrors .assistants-functions/routing.json */
+const DEFAULT_EXPLICIT_INTENT = {
+    "platform-magit": "platform-magit-enable",
+    "match-abstracts": "entity-match-abstracts",
+    "propose-mappings": "entity-propose-mappings",
+    "propose-relationships": "entity-propose-relationships",
+};
+const DEFAULT_AUTO_BY_KIND = {
+    "object-type": "entity-match-abstracts",
+    abstract: "entity-match-abstracts",
+    mapping: "entity-propose-mappings",
+    relationship: "entity-propose-relationships",
+    connector: "entity-connector-assist",
+    "memory-source": "entity-memory-pull-assist",
+    agent: "entity-agent-assist",
+    service: "entity-service-assist",
+    pipeline: "entity-pipeline-assist",
+    run: "entity-run-assist",
+    "platform-magit": "platform-magit-enable",
+};
+const DEFAULT_FALLBACK = "entity-page-default";
+let routerPromise = null;
+let routingCache = null;
+export function resolveAssistantsRoot() {
+    const fromEnv = process.env.ASSISTANTS_ROOT?.trim();
+    if (fromEnv)
+        return resolve(fromEnv);
+    // memorix-service/src/assist → repo root .assistants-functions
+    const candidates = [
+        resolve(__dirname, "../../../.assistants-functions"),
+        resolve(process.cwd(), ".assistants-functions"),
+        resolve(process.cwd(), "../.assistants-functions"),
+    ];
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    return candidates[0];
+}
+function defaultRouting() {
+    return {
+        explicitIntent: { ...DEFAULT_EXPLICIT_INTENT },
+        autoByEntityKind: { ...DEFAULT_AUTO_BY_KIND },
+        fallback: DEFAULT_FALLBACK,
+    };
+}
+/** Load routing.json from assistants root; fall back to built-in map. */
+export function loadAssistRouting(rootDir = resolveAssistantsRoot()) {
+    if (routingCache)
+        return routingCache;
+    const path = join(rootDir, "routing.json");
+    if (!existsSync(path)) {
+        routingCache = defaultRouting();
+        return routingCache;
+    }
+    try {
+        const raw = JSON.parse(readFileSync(path, "utf8"));
+        routingCache = {
+            explicitIntent: {
+                ...DEFAULT_EXPLICIT_INTENT,
+                ...(raw.explicitIntent ?? {}),
+            },
+            autoByEntityKind: {
+                ...DEFAULT_AUTO_BY_KIND,
+                ...(raw.autoByEntityKind ?? {}),
+            },
+            fallback: typeof raw.fallback === "string" && raw.fallback.trim()
+                ? raw.fallback.trim()
+                : DEFAULT_FALLBACK,
+        };
+    }
+    catch {
+        routingCache = defaultRouting();
+    }
+    return routingCache;
+}
+/** True when FuncX / LLM Ask can run (OPENROUTER_API_KEY set). */
+export function isAskLlmEnabled() {
+    return Boolean(process.env.OPENROUTER_API_KEY?.trim());
+}
+export function getAssistStatus() {
+    if (isAskLlmEnabled()) {
+        return {
+            validateEnabled: true,
+            askEnabled: true,
+            askDisabledReason: null,
+        };
+    }
+    return {
+        validateEnabled: true,
+        askEnabled: false,
+        askDisabledReason: "Ask needs OPENROUTER_API_KEY on memorix-service. Validate still works.",
+    };
+}
+async function getRouter() {
+    if (!routerPromise) {
+        // Dynamic import so Validate / offline Ask do not load FuncX at module init
+        // (FuncX rejects MODE=test used by Vitest).
+        routerPromise = import("@x12i/assistant-functions").then(({ createAssistantRouter }) => createAssistantRouter({
+            rootDir: resolveAssistantsRoot(),
+        }));
+    }
+    return routerPromise;
+}
+/** Test hook to reset cached router and routing. */
+export function resetAssistRouterForTests() {
+    routerPromise = null;
+    routingCache = null;
+}
+/**
+ * Precedence: platform-magit → explicit non-auto intent → auto-by-kind → fallback.
+ * Mirrors .assistants-functions/routing.json.
+ */
+export function assistantIdForIntent(entity, intent) {
+    const routing = loadAssistRouting();
+    if (entity.kind === "platform-magit" || intent === "platform-magit") {
+        return (routing.explicitIntent["platform-magit"] ??
+            routing.autoByEntityKind["platform-magit"] ??
+            "platform-magit-enable");
+    }
+    if (intent !== "auto") {
+        const mapped = routing.explicitIntent[intent];
+        if (mapped)
+            return mapped;
+    }
+    const byKind = routing.autoByEntityKind[entity.kind];
+    if (byKind)
+        return byKind;
+    return routing.fallback || DEFAULT_FALLBACK;
+}
+export function resolveAskIntent(entity, intent) {
+    if (entity.kind === "platform-magit")
+        return "platform-magit";
+    return intent;
+}
+/**
+ * Render assistant prompt.rendrix.md with Ask payload as working memory.
+ * Falls back to JSON.stringify when template is missing or render fails.
+ */
+export async function renderAskPrompt(assistantId, payload, rootDir = resolveAssistantsRoot()) {
+    const templatePath = join(rootDir, assistantId, "prompt.rendrix.md");
+    if (!existsSync(templatePath)) {
+        return JSON.stringify(payload);
+    }
+    try {
+        const template = readFileSync(templatePath, "utf8");
+        const { render } = await import("@x12i/rendrix");
+        const output = render(template, payload);
+        return typeof output === "string" && output.trim()
+            ? output
+            : JSON.stringify(payload);
+    }
+    catch {
+        return JSON.stringify(payload);
+    }
+}
+function defaultActions(entity) {
+    if (entity.kind === "platform-magit") {
+        return [
+            {
+                id: "navigate",
+                label: "Open Magit get started",
+                requiresConfirm: false,
+                href: "/design/pack-versions/get-started",
+            },
+        ];
+    }
+    return [
+        {
+            id: "validate-draft-pack",
+            label: "Validate draft",
+            requiresConfirm: false,
+        },
+        {
+            id: "stage-proposal",
+            label: "Stage proposal",
+            requiresConfirm: true,
+        },
+        {
+            id: "install-draft",
+            label: "Install draft",
+            requiresConfirm: true,
+        },
+    ];
+}
+function sanitizeActions(raw, entity) {
+    if (!Array.isArray(raw) || raw.length === 0)
+        return defaultActions(entity);
+    const out = [];
+    for (const item of raw) {
+        if (!item || typeof item !== "object")
+            continue;
+        const o = item;
+        const id = String(o.id ?? "").trim();
+        if (!ALLOWED_ACTION_IDS.has(id))
+            continue;
+        out.push({
+            id: id,
+            label: String(o.label ?? id),
+            requiresConfirm: Boolean(o.requiresConfirm),
+            href: typeof o.href === "string" ? o.href : undefined,
+        });
+    }
+    return out.length ? out : defaultActions(entity);
+}
+function sanitizeProposal(raw, entity) {
+    if (entity.kind === "platform-magit")
+        return {};
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return {};
+    const p = raw;
+    const out = {};
+    for (const key of [
+        "abstractTypes",
+        "objectTypes",
+        "mappings",
+        "relationshipDefinitions",
+        "sources",
+        "services",
+        "pipelines",
+    ]) {
+        if (Array.isArray(p[key]))
+            out[key] = p[key];
+    }
+    return out;
+}
+function offlineAskResult(entity, intent, facts, reportSummary) {
+    return {
+        entity,
+        summary: `Ask unavailable (no OPENROUTER_API_KEY). Validate says: ${reportSummary}`,
+        intent,
+        proposal: {},
+        rationale: [
+            "Set OPENROUTER_API_KEY on memorix-service to enable Ask.",
+            "Use Validate for deterministic checks without an LLM.",
+        ],
+        actions: defaultActions(entity),
+        askUnavailable: true,
+        autoInstall: false,
+    };
+}
+function heuristicAskFromValidate(entity, intent, report) {
+    const gaps = report.checks.filter((c) => c.status !== "pass");
+    return {
+        entity,
+        summary: gaps.length === 0
+            ? "Entity looks healthy. Ask can still propose refinements when LLM is configured."
+            : `Found ${gaps.length} gap(s)/error(s). Primary work: match abstracts, then mappings, then relationships.`,
+        intent,
+        proposal: {},
+        rationale: gaps.map((g) => `${g.id}: ${g.message}`),
+        actions: defaultActions(entity),
+        askUnavailable: true,
+        autoInstall: false,
+    };
+}
+export async function askEntity(platform, entity, intentIn, prompt) {
+    const intent = resolveAskIntent(entity, intentIn);
+    const report = validateEntity(platform, entity);
+    const facts = gatherEntityFacts(platform, entity);
+    const reportSummary = `${report.status} (${report.checks.filter((c) => c.status !== "pass").length} non-pass)`;
+    if (!isAskLlmEnabled()) {
+        if (entity.kind === "platform-magit") {
+            return offlineAskResult(entity, intent, facts, reportSummary);
+        }
+        return heuristicAskFromValidate(entity, intent, report);
+    }
+    const assistantId = assistantIdForIntent(entity, intent);
+    const payload = {
+        entity,
+        intent,
+        prompt: prompt?.trim() || undefined,
+        validate: {
+            status: report.status,
+            checks: report.checks,
+        },
+        facts,
+    };
+    try {
+        const router = await getRouter();
+        const names = router.list();
+        if (!names.includes(assistantId)) {
+            return {
+                entity,
+                summary: `Assistant "${assistantId}" not found under ${resolveAssistantsRoot()}`,
+                intent,
+                proposal: {},
+                rationale: [`Available: ${names.join(", ") || "(none)"}`],
+                actions: defaultActions(entity),
+                askUnavailable: true,
+                autoInstall: false,
+            };
+        }
+        const renderedPrompt = await renderAskPrompt(assistantId, payload);
+        const run = await router.run(assistantId, renderedPrompt);
+        if (!run.ok) {
+            return {
+                entity,
+                summary: `Ask failed: ${run.error?.message ?? "unknown error"}`,
+                intent,
+                proposal: {},
+                rationale: [String(run.error?.message ?? "run failed")],
+                actions: defaultActions(entity),
+                askUnavailable: true,
+                autoInstall: false,
+            };
+        }
+        const data = (run.data ?? {});
+        return {
+            entity,
+            summary: String(data.summary ?? "Ask completed"),
+            intent: String(data.intent ?? intent),
+            proposal: sanitizeProposal(data.proposal, entity),
+            rationale: Array.isArray(data.rationale)
+                ? data.rationale.map((r) => String(r))
+                : [],
+            actions: sanitizeActions(data.actions, entity),
+            autoInstall: false,
+        };
+    }
+    catch (err) {
+        return {
+            entity,
+            summary: `Ask error: ${err instanceof Error ? err.message : String(err)}`,
+            intent,
+            proposal: {},
+            rationale: [err instanceof Error ? err.message : String(err)],
+            actions: defaultActions(entity),
+            askUnavailable: true,
+            autoInstall: false,
+        };
+    }
+}
+//# sourceMappingURL=ask.js.map

package/dist/assist/ask.js.map

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

package/dist/assist/facts.d.ts

@@ -0,0 +1,5 @@
+import type { MemorixPlatform } from "../platform.js";
+import type { EntityRef } from "./types.js";
+/** Bounded metadata slice for Validate + Ask. */
+export declare function gatherEntityFacts(platform: MemorixPlatform, entity: EntityRef): Record<string, unknown>;
+//# sourceMappingURL=facts.d.ts.map

package/dist/assist/facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts.d.ts","sourceRoot":"","sources":["../../src/assist/facts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA8C5C,iDAAiD;AACjD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,SAAS,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2NzB"}