syncpoint-ai 0.1.0

package/dist/server/application/context-policy-service.js

@@ -0,0 +1,302 @@
+/**
+ * Context Policy Service — role-aware context preparation.
+ * CLI, MCP, and tRPC all share this layer.
+ */
+import { getContextPolicyForMode, CONTEXT_POLICIES, listContextIntents, listContextRoles, } from "../../context/index.js";
+import * as contextMemoryRepo from "../repositories/_exports/context-memory.js";
+import * as foundationRepo from "../repositories/_exports/foundation.js";
+import { pmList } from "./project-memory-service.js";
+import { formatArchitectPrompt as formatArchitectPromptImpl, formatExecutePrompt as formatExecutePromptImpl, formatHandoffReceivePrompt as formatHandoffReceivePromptImpl, formatMemoryReviewPrompt as formatMemoryReviewPromptImpl, formatOnboardPrompt as formatOnboardPromptImpl, formatReviewPrompt as formatReviewPromptImpl, } from "./context-policy-prompt-formatters.js";
+// ── Helpers ──────────────────────────────────────────
+function now() {
+    return new Date().toISOString();
+}
+function checkSection(section, present, required) {
+    if (required && !present) {
+        return { section, present: false, required: true, message: `Missing required: ${section}` };
+    }
+    if (!present) {
+        return { section, present: false, required: false, message: `Not available: ${section}` };
+    }
+    return { section, present: true, required, message: "OK" };
+}
+// ── Prompt Formatters ────────────────────────────────
+function formatExecutePrompt(ctx, policy) {
+    return formatExecutePromptImpl(ctx, policy);
+}
+function formatReviewPrompt(task, snapshot, checkpoint, contract, projectMems) {
+    return formatReviewPromptImpl(task, snapshot, checkpoint, contract, projectMems);
+}
+function formatArchitectPrompt(projectMems, tasks) {
+    return formatArchitectPromptImpl(projectMems, tasks);
+}
+function formatHandoffReceivePrompt(task, agent, handoff, senderSnapshot, receiverResume, projectMems) {
+    return formatHandoffReceivePromptImpl(task, agent, handoff, senderSnapshot, receiverResume, projectMems);
+}
+function formatOnboardPrompt(projectMems, tasks, agents) {
+    return formatOnboardPromptImpl(projectMems, tasks, agents);
+}
+function formatMemoryReviewPrompt(approved, drafts, deprecated) {
+    return formatMemoryReviewPromptImpl(approved, drafts, deprecated);
+}
+// ── Main Use Cases ───────────────────────────────────
+/**
+ * Prepare context for a given intent+role, enforcing the appropriate gate.
+ */
+export function prepareContext(input) {
+    const policy = getContextPolicyForMode(input.intent, input.relationshipMode);
+    const allSections = [...policy.requiredSections, ...policy.includeSections];
+    const checks = [];
+    const missingSections = [];
+    const warnings = [];
+    // ── Gather data ──
+    let resumeCtx = null;
+    let taskInfo = null;
+    let agentInfo = null;
+    let handoff = null;
+    let senderSnapshot = null;
+    // Task-scoped intents need task+agent
+    const needsTask = allSections.some(s => ["task", "latest-snapshot", "latest-checkpoint", "approved-contract", "handoff-context"].includes(s));
+    const needsAgent = allSections.includes("agent") || needsTask;
+    if (needsTask && input.taskId && input.agentId) {
+        try {
+            resumeCtx = contextMemoryRepo.getResumeContext(input.taskId, input.agentId);
+            taskInfo = resumeCtx.task;
+            agentInfo = resumeCtx.agent;
+            if (input.intent === "handoff-receive") {
+                handoff = contextMemoryRepo.getLatestHandoffForReceiver(input.taskId, input.agentId) ?? null;
+                if (handoff) {
+                    senderSnapshot = contextMemoryRepo.getLatestContextSnapshot(input.taskId, handoff.fromAgentId) ?? null;
+                }
+            }
+        }
+        catch {
+            warnings.push("Failed to load resume context — task or agent not found.");
+        }
+    }
+    else if (needsAgent && input.agentId) {
+        try {
+            const agent = foundationRepo.getAgent(input.agentId);
+            agentInfo = { id: agent.id, name: agent.name, role: agent.role };
+        }
+        catch {
+            warnings.push("Agent not found.");
+        }
+    }
+    // Project memories (approved)
+    const approvedMems = pmList({ status: "approved" }).map(m => ({
+        id: m.id, category: m.category, title: m.title, content: m.content,
+    }));
+    // Draft + deprecated memories (for memory-review)
+    const draftMems = allSections.includes("draft-memories")
+        ? pmList({ status: "draft" }) : [];
+    const deprecatedMems = allSections.includes("deprecated-memories")
+        ? pmList({ status: "deprecated" }) : [];
+    // Task list and agent list
+    const taskList = allSections.includes("task-list")
+        ? foundationRepo.listTasks().map(t => ({ id: t.id, title: t.title, status: t.status, ownerAgentId: t.ownerAgentId }))
+        : [];
+    const agentList = allSections.includes("agent-list")
+        ? foundationRepo.listAgents().map(a => ({ id: a.id, name: a.name, role: a.role, status: a.status }))
+        : [];
+    // ── Check required sections ──
+    for (const section of policy.requiredSections) {
+        let present = false;
+        switch (section) {
+            case "task":
+                present = taskInfo !== null;
+                break;
+            case "agent":
+                present = agentInfo !== null;
+                break;
+            case "latest-snapshot":
+                present = input.intent === "handoff-receive"
+                    ? !!(resumeCtx?.latestSnapshot || senderSnapshot || handoff?.contextSummary)
+                    : resumeCtx?.latestSnapshot !== null && resumeCtx?.latestSnapshot !== undefined;
+                break;
+            case "latest-checkpoint":
+                present = resumeCtx?.latestCheckpoint !== null && resumeCtx?.latestCheckpoint !== undefined;
+                break;
+            case "approved-contract":
+                present = resumeCtx?.approvedContract !== null && resumeCtx?.approvedContract !== undefined;
+                break;
+            case "handoff-context":
+                present = !!handoff?.contextSummary;
+                break;
+            case "approved-project-memory":
+                present = approvedMems.length > 0;
+                break;
+            case "pinned-memory":
+                present = (resumeCtx?.pinnedMemories?.length ?? 0) > 0;
+                break;
+            case "task-list":
+                present = taskList.length > 0;
+                break;
+            case "agent-list":
+                present = agentList.length > 0;
+                break;
+            case "draft-memories":
+                present = draftMems.length > 0;
+                break;
+            case "deprecated-memories":
+                present = deprecatedMems.length > 0;
+                break;
+            default:
+                present = false;
+        }
+        const check = checkSection(section, present, true);
+        checks.push(check);
+        if (!present) {
+            missingSections.push(section);
+            warnings.push(check.message);
+        }
+    }
+    // ── Check included (non-required) sections ──
+    for (const section of policy.includeSections) {
+        if (policy.requiredSections.includes(section))
+            continue;
+        let present = false;
+        switch (section) {
+            case "approved-contract":
+                present = resumeCtx?.approvedContract !== null && resumeCtx?.approvedContract !== undefined;
+                break;
+            case "approved-project-memory":
+                present = approvedMems.length > 0;
+                break;
+            case "pinned-memory":
+                present = (resumeCtx?.pinnedMemories?.length ?? 0) > 0;
+                break;
+            case "task-list":
+                present = taskList.length > 0;
+                break;
+            case "agent-list":
+                present = agentList.length > 0;
+                break;
+            case "handoff-context":
+                present = !!handoff?.contextSummary;
+                break;
+            case "draft-memories":
+                present = draftMems.length > 0;
+                break;
+            case "deprecated-memories":
+                present = deprecatedMems.length > 0;
+                break;
+            case "open-decisions":
+                present = approvedMems.some(m => m.category === "decision");
+                break;
+            case "risks":
+                present = approvedMems.some(m => m.category === "risk") ||
+                    (() => { const p = resumeCtx?.latestSnapshot?.payload; return Array.isArray(p?.risks) && p.risks.length > 0; })();
+                break;
+            default:
+                present = false;
+        }
+        checks.push(checkSection(section, present, false));
+    }
+    // ── Gate decision ──
+    const ready = policy.gateMode === "none"
+        ? true
+        : missingSections.length === 0;
+    const isResumeIntent = input.intent === "execute" || input.intent === "resume" || input.intent === "handoff-receive";
+    const shouldUseResumeQualityGate = input.intent === "execute" || input.intent === "resume";
+    const resumeReady = shouldUseResumeQualityGate ? (resumeCtx?.ready ?? true) : true;
+    const finalReady = policy.gateMode === "hard"
+        ? ready && resumeReady
+        : ready;
+    if (policy.gateMode === "hard" && shouldUseResumeQualityGate && resumeCtx && !resumeCtx.ready) {
+        warnings.push(...resumeCtx.warnings);
+    }
+    // ── Format prompt ──
+    let prompt = "";
+    switch (input.intent) {
+        case "execute":
+        case "resume":
+        case "handoff-receive":
+            // P3B: no raw project memories in agent-facing resume prompts
+            prompt = formatHandoffReceivePrompt(taskInfo, agentInfo, handoff, senderSnapshot, resumeCtx, []);
+            break;
+        case "review":
+            prompt = formatReviewPrompt(taskInfo, resumeCtx?.latestSnapshot ?? null, resumeCtx?.latestCheckpoint ?? null, resumeCtx?.approvedContract ?? null, approvedMems);
+            break;
+        case "architect-plan":
+            prompt = formatArchitectPrompt(approvedMems, taskList);
+            break;
+        case "project-onboard":
+            prompt = formatOnboardPrompt(approvedMems, taskList, agentList);
+            break;
+        case "memory-review":
+            prompt = formatMemoryReviewPrompt(approvedMems, draftMems, deprecatedMems);
+            break;
+    }
+    // ── Suggested actions ──
+    const suggestedNextActions = [];
+    if (missingSections.includes("latest-snapshot")) {
+        suggestedNextActions.push("Create a context snapshot: syncpoint_loop_checkpoint or `syncpoint loop checkpoint`");
+    }
+    if (missingSections.includes("latest-checkpoint")) {
+        suggestedNextActions.push("Create a checkpoint first: syncpoint_loop_checkpoint");
+    }
+    if (missingSections.includes("approved-project-memory")) {
+        suggestedNextActions.push("Add project memories: syncpoint_project_memory_add");
+    }
+    if (missingSections.includes("approved-contract")) {
+        suggestedNextActions.push("Create and approve a peer contract");
+    }
+    if (input.intent === "memory-review") {
+        suggestedNextActions.push("Approve draft memories: syncpoint_project_memory_approve");
+        suggestedNextActions.push("Export to file: syncpoint_project_memory_export");
+    }
+    return {
+        intent: input.intent,
+        role: input.role,
+        gateMode: policy.gateMode,
+        ready: finalReady,
+        missingSections,
+        checks,
+        warnings,
+        task: taskInfo,
+        agent: agentInfo,
+        // P3B: strip raw PM from structured return for agent-facing intents
+        resumeContext: isResumeIntent && resumeCtx
+            ? { ...resumeCtx, projectMemories: [], resumePrompt: "" }
+            : resumeCtx,
+        handoffContext: handoff ? {
+            id: handoff.id,
+            fromAgentId: handoff.fromAgentId,
+            toAgentId: handoff.toAgentId,
+            taskId: handoff.taskId,
+            contextSummary: handoff.contextSummary,
+            status: handoff.status,
+        } : null,
+        projectMemories: isResumeIntent ? [] : approvedMems,
+        draftMemories: draftMems.map(m => ({
+            id: m.id, category: m.category, title: m.title, content: m.content, status: m.status,
+        })),
+        taskList,
+        agentList,
+        prompt,
+        suggestedNextActions,
+        generatedAt: now(),
+    };
+}
+/**
+ * Enforce a prepared context — returns ready/warnings/missingSections.
+ */
+export function enforcePreparedContext(prepared) {
+    return {
+        ready: prepared.ready,
+        warnings: prepared.warnings,
+        missingSections: prepared.missingSections,
+    };
+}
+/**
+ * Get info about all available policies.
+ */
+export function getContextPolicyInfo() {
+    return {
+        intents: listContextIntents(),
+        roles: listContextRoles(),
+        policies: Object.values(CONTEXT_POLICIES),
+    };
+}
+//# sourceMappingURL=context-policy-service.js.map

package/dist/server/application/context-policy-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-policy-service.js","sourceRoot":"","sources":["../../../_build/src/server/application/context-policy-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,KAAK,iBAAiB,MAAM,4CAA4C,CAAC;AAChF,OAAO,KAAK,cAAc,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,EACL,qBAAqB,IAAI,yBAAyB,EAClD,mBAAmB,IAAI,uBAAuB,EAC9C,0BAA0B,IAAI,8BAA8B,EAC5D,wBAAwB,IAAI,4BAA4B,EACxD,mBAAmB,IAAI,uBAAuB,EAC9C,kBAAkB,IAAI,sBAAsB,GAC7C,MAAM,uCAAuC,CAAC;AAkB/C,wDAAwD;AAExD,SAAS,GAAG;IACV,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,YAAY,CACnB,OAAuB,EACvB,OAAgB,EAChB,QAAiB;IAEjB,IAAI,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,qBAAqB,OAAO,EAAE,EAAE,CAAC;IAC9F,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,OAAO,EAAE,EAAE,CAAC;IAC5F,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC7D,CAAC;AAED,wDAAwD;AAExD,SAAS,mBAAmB,CAC1B,GAAkB,EAClB,MAAqB;IAErB,OAAO,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,kBAAkB,CACzB,IAA0D,EAC1D,QAAyC,EACzC,UAA6C,EAC7C,QAA2C,EAC3C,WAAoF;IAEpF,OAAO,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,qBAAqB,CAC5B,WAAoF,EACpF,KAAwF;IAExF,OAAO,yBAAyB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,0BAA0B,CACjC,IAA0D,EAC1D,KAAwD,EACxD,OAAuB,EACvB,cAAsC,EACtC,cAAoC,EACpC,WAAoF;IAEpF,OAAO,8BAA8B,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;AAC3G,CAAC;AAED,SAAS,mBAAmB,CAC1B,WAAoF,EACpF,KAAwF,EACxF,MAAyE;IAEzE,OAAO,uBAAuB,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,wBAAwB,CAC/B,QAAyB,EACzB,MAAuB,EACvB,UAA2B;IAE3B,OAAO,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AACpE,CAAC;AAED,wDAAwD;AAExD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,CAAC,GAAG,MAAM,CAAC,gBAAgB,EAAE,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAyB,EAAE,CAAC;IACxC,MAAM,eAAe,GAAqB,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,oBAAoB;IACpB,IAAI,SAAS,GAAyB,IAAI,CAAC;IAC3C,IAAI,QAAQ,GAA4B,IAAI,CAAC;IAC7C,IAAI,SAAS,GAA6B,IAAI,CAAC;IAC/C,IAAI,OAAO,GAAmB,IAAI,CAAC;IACnC,IAAI,cAAc,GAA2B,IAAI,CAAC;IAElD,sCAAsC;IACtC,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACrC,CAAC,MAAM,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,iBAAiB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CACrG,CAAC;IACF,MAAM,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC;IAE9D,IAAI,SAAS,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,SAAS,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5E,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC;YAC1B,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC;YAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,iBAAiB,EAAE,CAAC;gBACvC,OAAO,GAAG,iBAAiB,CAAC,2BAA2B,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;gBAC7F,IAAI,OAAO,EAAE,CAAC;oBACZ,cAAc,GAAG,iBAAiB,CAAC,wBAAwB,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;gBACzG,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;SAAM,IAAI,UAAU,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACrD,SAAS,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5D,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO;KACnE,CAAC,CAAC,CAAC;IAEJ,kDAAkD;IAClD,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACtD,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrC,MAAM,cAAc,GAAG,WAAW,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QAChE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1C,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC;QAChD,CAAC,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;QACrH,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC;QAClD,CAAC,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACpG,CAAC,CAAC,EAAE,CAAC;IAEP,gCAAgC;IAChC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC9C,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,MAAM;gBACT,OAAO,GAAG,QAAQ,KAAK,IAAI,CAAC;gBAC5B,MAAM;YACR,KAAK,OAAO;gBACV,OAAO,GAAG,SAAS,KAAK,IAAI,CAAC;gBAC7B,MAAM;YACR,KAAK,iBAAiB;gBACpB,OAAO,GAAG,KAAK,CAAC,MAAM,KAAK,iBAAiB;oBAC1C,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,cAAc,IAAI,cAAc,IAAI,OAAO,EAAE,cAAc,CAAC;oBAC5E,CAAC,CAAC,SAAS,EAAE,cAAc,KAAK,IAAI,IAAI,SAAS,EAAE,cAAc,KAAK,SAAS,CAAC;gBAClF,MAAM;YACR,KAAK,mBAAmB;gBACtB,OAAO,GAAG,SAAS,EAAE,gBAAgB,KAAK,IAAI,IAAI,SAAS,EAAE,gBAAgB,KAAK,SAAS,CAAC;gBAC5F,MAAM;YACR,KAAK,mBAAmB;gBACtB,OAAO,GAAG,SAAS,EAAE,gBAAgB,KAAK,IAAI,IAAI,SAAS,EAAE,gBAAgB,KAAK,SAAS,CAAC;gBAC5F,MAAM;YACR,KAAK,iBAAiB;gBACpB,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC;gBACpC,MAAM;YACR,KAAK,yBAAyB;gBAC5B,OAAO,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;gBAClC,MAAM;YACR,KAAK,eAAe;gBAClB,OAAO,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBACvD,MAAM;YACR,KAAK,WAAW;gBACd,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,YAAY;gBACf,OAAO,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC/B,MAAM;YACR,KAAK,gBAAgB;gBACnB,OAAO,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC/B,MAAM;YACR,KAAK,qBAAqB;gBACxB,OAAO,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;gBACpC,MAAM;YACR;gBACE,OAAO,GAAG,KAAK,CAAC;QACpB,CAAC;QAED,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC7C,IAAI,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QACxD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,mBAAmB;gBACtB,OAAO,GAAG,SAAS,EAAE,gBAAgB,KAAK,IAAI,IAAI,SAAS,EAAE,gBAAgB,KAAK,SAAS,CAAC;gBAC5F,MAAM;YACR,KAAK,yBAAyB;gBAC5B,OAAO,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;gBAClC,MAAM;YACR,KAAK,eAAe;gBAClB,OAAO,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBACvD,MAAM;YACR,KAAK,WAAW;gBACd,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,YAAY;gBACf,OAAO,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC/B,MAAM;YACR,KAAK,iBAAiB;gBACpB,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC;gBACpC,MAAM;YACR,KAAK,gBAAgB;gBACnB,OAAO,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC/B,MAAM;YACR,KAAK,qBAAqB;gBACxB,OAAO,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;gBACpC,MAAM;YACR,KAAK,gBAAgB;gBACnB,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;gBAC5D,MAAM;YACR,KAAK,OAAO;gBACV,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC;oBACrD,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpH,MAAM;YACR;gBACE,OAAO,GAAG,KAAK,CAAC;QACpB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,sBAAsB;IACtB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,KAAK,MAAM;QACtC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,CAAC;IACjC,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,iBAAiB,CAAC;IACrH,MAAM,0BAA0B,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC;IAC3F,MAAM,WAAW,GAAG,0BAA0B,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnF,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,KAAK,MAAM;QAC3C,CAAC,CAAC,KAAK,IAAI,WAAW;QACtB,CAAC,CAAC,KAAK,CAAC;IAEV,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,IAAI,0BAA0B,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAC9F,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,sBAAsB;IACtB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,iBAAiB;YACpB,8DAA8D;YAC9D,MAAM,GAAG,0BAA0B,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YACjG,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,GAAG,kBAAkB,CACzB,QAAQ,EAAE,SAAS,EAAE,cAAc,IAAI,IAAI,EAAE,SAAS,EAAE,gBAAgB,IAAI,IAAI,EAChF,SAAS,EAAE,gBAAgB,IAAI,IAAI,EAAE,YAAY,CAClD,CAAC;YACF,MAAM;QACR,KAAK,gBAAgB;YACnB,MAAM,GAAG,qBAAqB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YACvD,MAAM;QACR,KAAK,iBAAiB;YACpB,MAAM,GAAG,mBAAmB,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;YAChE,MAAM;QACR,KAAK,eAAe;YAClB,MAAM,GAAG,wBAAwB,CAAC,YAAmB,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;YAClF,MAAM;IACV,CAAC;IAED,0BAA0B;IAC1B,MAAM,oBAAoB,GAAa,EAAE,CAAC;IAC1C,IAAI,eAAe,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAChD,oBAAoB,CAAC,IAAI,CAAC,qFAAqF,CAAC,CAAC;IACnH,CAAC;IACD,IAAI,eAAe,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAClD,oBAAoB,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,eAAe,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC;QACxD,oBAAoB,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,eAAe,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAClD,oBAAoB,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;QACrC,oBAAoB,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;QACtF,oBAAoB,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,UAAU;QACjB,eAAe;QACf,MAAM;QACN,QAAQ;QACR,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,SAAS;QAChB,oEAAoE;QACpE,aAAa,EAAE,cAAc,IAAI,SAAS;YACxC,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,eAAe,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;YACzD,CAAC,CAAC,SAAS;QACb,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;YACxB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC,CAAC,IAAI;QACR,eAAe,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY;QACnD,aAAa,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM;SACrF,CAAC,CAAC;QACH,QAAQ;QACR,SAAS;QACT,MAAM;QACN,oBAAoB;QACpB,WAAW,EAAE,GAAG,EAAE;KACnB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAyB;IAK9D,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,eAAe,EAAE,QAAQ,CAAC,eAAe;KAC1C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,OAAO,EAAE,kBAAkB,EAAE;QAC7B,KAAK,EAAE,gBAAgB,EAAE;QACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/server/application/escalation-routing-service.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Escalation Routing Service — wires agent manifests with gate escalation.
+ *
+ * API:
+ *   manifestUpsert(agentId, manifest)  — create or update manifest
+ *   manifestGet(agentId)               — get parsed manifest
+ *   manifestList()                     — list all manifests
+ *   manifestDelete(agentId)            — remove manifest
+ *   routeGateEscalation(gateId)       — find best agents for a gate escalation
+ */
+import { AgentAvailability } from "../../adapters/index.js";
+import type { AgentManifest, AgentCapability, EscalationPreference, EscalationCandidate } from "../../adapters/index.js";
+export declare function manifestUpsert(agentId: string, input: {
+    capabilities?: AgentCapability[];
+    escalationPreference?: Partial<EscalationPreference>;
+    availability?: AgentAvailability;
+    canHandleHumanEscalation?: boolean;
+    tags?: string[];
+}): AgentManifest;
+export declare function manifestGet(agentId: string): AgentManifest | null;
+export declare function manifestList(): AgentManifest[];
+export declare function manifestDelete(agentId: string): void;
+/**
+ * Given a gate that has escalated, find the best candidates to handle it.
+ */
+export declare function routeGateEscalation(gateId: string): EscalationCandidate[];
+//# sourceMappingURL=escalation-routing-service.d.ts.map

package/dist/server/application/escalation-routing-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-routing-service.d.ts","sourceRoot":"","sources":["../../../_build/src/server/application/escalation-routing-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAA8B,iBAAiB,EAAmB,MAAM,yBAAyB,CAAC;AAEzG,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,mBAAmB,EAA0B,MAAM,yBAAyB,CAAC;AAOjJ,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;IACrD,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,oBAAoB,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACrD,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,GAAG,aAAa,CAahB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAEjE;AAED,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAE9C;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEpD;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAsBzE"}

package/dist/server/application/escalation-routing-service.js

@@ -0,0 +1,75 @@
+/**
+ * Escalation Routing Service — wires agent manifests with gate escalation.
+ *
+ * API:
+ *   manifestUpsert(agentId, manifest)  — create or update manifest
+ *   manifestGet(agentId)               — get parsed manifest
+ *   manifestList()                     — list all manifests
+ *   manifestDelete(agentId)            — remove manifest
+ *   routeGateEscalation(gateId)       — find best agents for a gate escalation
+ */
+import { EscalationPreferenceSchema, routeEscalation } from "../../adapters/index.js";
+import { parseGatePolicy } from "../../kernel/index.js";
+import * as manifestRepo from "../repositories/agent-manifest-repository.js";
+import { getSyncGate, listActiveSyncGates } from "../repositories/sync-gate-repository.js";
+// ── Manifest CRUD ────────────────────────────────────
+export function manifestUpsert(agentId, input) {
+    manifestRepo.upsertAgentManifest({
+        agentId,
+        capabilities: input.capabilities,
+        escalationPreference: input.escalationPreference
+            ? EscalationPreferenceSchema.parse(input.escalationPreference)
+            : undefined,
+        availability: input.availability,
+        canHandleHumanEscalation: input.canHandleHumanEscalation,
+        tags: input.tags,
+    });
+    return manifestGet(agentId);
+}
+export function manifestGet(agentId) {
+    return manifestRepo.getAgentManifest(agentId) ?? null;
+}
+export function manifestList() {
+    return manifestRepo.listAgentManifests();
+}
+export function manifestDelete(agentId) {
+    manifestRepo.deleteAgentManifest(agentId);
+}
+// ── Escalation routing ──────────────────────────────
+/**
+ * Given a gate that has escalated, find the best candidates to handle it.
+ */
+export function routeGateEscalation(gateId) {
+    const gate = getSyncGate(gateId);
+    const policy = parseGatePolicy(gate);
+    const requiresHuman = gate.escalated && (policy.escalationAgentIds ?? []).length === 0;
+    const input = {
+        gateId: gate.id,
+        taskId: gate.taskId,
+        reason: gate.decisionSummary || gate.reason,
+        requiredAgentIds: gate.requiredAgentIds ?? [],
+        escalationAgentIds: policy.escalationAgentIds ?? [],
+        requiresHuman,
+    };
+    const manifests = manifestList();
+    // Count active escalations per agent (gates in ESCALATED state where the agent is an escalation target)
+    const activeEscalationCounts = countActiveEscalations();
+    return routeEscalation(input, manifests, activeEscalationCounts);
+}
+/**
+ * Count how many active escalated gates each agent is involved in as an escalation target.
+ */
+function countActiveEscalations() {
+    const counts = new Map();
+    const activeGates = listActiveSyncGates();
+    for (const gate of activeGates) {
+        if (gate.escalated) {
+            const policy = parseGatePolicy(gate);
+            for (const id of policy.escalationAgentIds ?? []) {
+                counts.set(id, (counts.get(id) ?? 0) + 1);
+            }
+        }
+    }
+    return counts;
+}
+//# sourceMappingURL=escalation-routing-service.js.map

package/dist/server/application/escalation-routing-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-routing-service.js","sourceRoot":"","sources":["../../../_build/src/server/application/escalation-routing-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,0BAA0B,EAAqB,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACzG,OAAO,EAAE,eAAe,EAAkB,MAAM,uBAAuB,CAAC;AAGxE,OAAO,KAAK,YAAY,MAAM,8CAA8C,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAE3F,wDAAwD;AAExD,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,KAM/C;IACC,YAAY,CAAC,mBAAmB,CAAC;QAC/B,OAAO;QACP,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;YAC9C,CAAC,CAAC,0BAA0B,CAAC,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC;YAC9D,CAAC,CAAC,SAAS;QACb,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;QACxD,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC,OAAO,CAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,YAAY,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,YAAY,CAAC,kBAAkB,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,YAAY,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,uDAAuD;AAEvD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAErC,MAAM,aAAa,GACjB,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IAEnE,MAAM,KAAK,GAA2B;QACpC,MAAM,EAAE,IAAI,CAAC,EAAE;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,MAAM;QAC3C,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,EAAE;QAC7C,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,EAAE;QACnD,aAAa;KACd,CAAC;IAEF,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IAEjC,wGAAwG;IACxG,MAAM,sBAAsB,GAAG,sBAAsB,EAAE,CAAC;IAExD,OAAO,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,sBAAsB,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB;IAC7B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,WAAW,GAAG,mBAAmB,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YACrC,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,kBAAkB,IAAI,EAAE,EAAE,CAAC;gBACjD,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server/application/file-audit-service.d.ts

@@ -0,0 +1,21 @@
+import { EventType } from "../../kernel/index.js";
+import type { FileAuditDecision, ResourceClaim } from "../../kernel/index.js";
+export interface AuditFileChangeInput {
+    actorId: string;
+    taskId: string;
+    sessionId?: string;
+    locator: string;
+    auditOnly?: boolean;
+}
+export interface AuditFileChangeResult {
+    decision: FileAuditDecision;
+    eventType: EventType;
+    gateId?: string;
+    reusedGate: boolean;
+}
+export declare function auditListActiveResourceClaims(input: {
+    taskId?: string;
+    sessionId?: string;
+}): ResourceClaim[];
+export declare function auditFileChange(input: AuditFileChangeInput): AuditFileChangeResult;
+//# sourceMappingURL=file-audit-service.d.ts.map

package/dist/server/application/file-audit-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-audit-service.d.ts","sourceRoot":"","sources":["../../../_build/src/server/application/file-audit-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAMV,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAwB,aAAa,EAAyB,MAAM,uBAAuB,CAAC;AAO3H,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,aAAa,EAAE,CAMlB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CA+ClF"}

package/dist/server/application/file-audit-service.js

@@ -0,0 +1,124 @@
+import { EventType, FileAuditDecisionKind, SyncGateReason, evaluateFileAuditChange, gateMatchesResource, normalizeResourcePath, } from "../../kernel/index.js";
+import * as protocolRepo from "../repositories/_exports/protocol.js";
+import { logEvent } from "../repositories/_shared.js";
+import { rcList } from "./resource-claim-service.js";
+import { sgCheckAgent, sgListActive, sgRequest } from "./sync-gate-service.js";
+import { getProjectRoot } from "./path-resolver.js";
+export function auditListActiveResourceClaims(input) {
+    return rcList({
+        sessionId: input.sessionId,
+        resourceType: "file",
+        status: "ACTIVE",
+    });
+}
+export function auditFileChange(input) {
+    // Normalize locator to match normalized claim locators
+    const root = getProjectRoot();
+    const normalizedLocator = normalizeResourcePath(input.locator, { projectRoot: root });
+    const changedResource = { type: "file", scope: "file", locator: normalizedLocator, metadata: "" };
+    const activeClaims = auditListActiveResourceClaims({
+        taskId: input.taskId,
+        sessionId: input.sessionId,
+    });
+    const blockingGates = sgCheckAgent(input.actorId, {
+        taskId: input.taskId,
+        sessionId: input.sessionId,
+    }).blockingGates.map(toAuditGateContext);
+    const decision = evaluateFileAuditChange({
+        actorId: input.actorId,
+        changedResource,
+        activeClaims,
+        blockingGates,
+    });
+    const gateResult = maybeCreateOrUpdateGate(input, changedResource, decision);
+    const eventType = eventTypeForDecision(decision.kind);
+    logEvent(eventType, "file_audit", input.locator, JSON.stringify({
+        actorId: input.actorId,
+        taskId: input.taskId,
+        sessionId: input.sessionId ?? "",
+        locator: input.locator,
+        decision: decision.kind,
+        ownClaimIds: decision.ownClaims.map(claim => claim.id),
+        conflictingClaimIds: decision.conflictingClaims.map(claim => claim.id),
+        relatedBlockingGateIds: decision.relatedBlockingGateIds,
+        gateId: gateResult.gateId ?? "",
+        reusedGate: gateResult.reusedGate,
+        auditOnly: input.auditOnly === true,
+    }));
+    return {
+        decision,
+        eventType,
+        gateId: gateResult.gateId,
+        reusedGate: gateResult.reusedGate,
+    };
+}
+function eventTypeForDecision(kind) {
+    if (kind === FileAuditDecisionKind.FILE_POLLUTION_DETECTED)
+        return EventType.FILE_POLLUTION_DETECTED;
+    if (kind === FileAuditDecisionKind.FILE_AUDIT_ALERT)
+        return EventType.FILE_AUDIT_ALERT;
+    return EventType.FILE_CHANGED;
+}
+function maybeCreateOrUpdateGate(input, changedResource, decision) {
+    if (input.auditOnly === true) {
+        return { reusedGate: false };
+    }
+    if (decision.kind === FileAuditDecisionKind.FILE_AUDIT_ALERT) {
+        const gateId = decision.relatedBlockingGateIds[0];
+        if (gateId) {
+            appendAuditNote(gateId, `File audit alert: ${input.locator} changed by ${input.actorId} while blocked.`);
+            return { gateId, reusedGate: true };
+        }
+    }
+    if (!decision.shouldCreateGate) {
+        return { reusedGate: false };
+    }
+    const existing = findExistingPollutionGate(input, changedResource);
+    if (existing) {
+        appendAuditNote(existing.id, `File pollution detected again: ${input.locator} changed by ${input.actorId}.`);
+        return { gateId: existing.id, reusedGate: true };
+    }
+    const conflictingActors = [...new Set(decision.conflictingClaims.map(claim => claim.actorId))];
+    const relatedClaimIds = [...new Set(decision.conflictingClaims.map(claim => claim.id))];
+    const relatedResources = [
+        changedResource,
+        ...decision.conflictingClaims.flatMap(claim => claim.resources),
+    ];
+    const result = sgRequest({
+        sessionId: input.sessionId,
+        taskId: input.taskId,
+        requestedByAgentId: input.actorId,
+        requiredAgentIds: [...new Set([input.actorId, ...conflictingActors])],
+        reason: SyncGateReason.RESOURCE_CONFLICT,
+        description: `File pollution detected: ${input.locator} changed by ${input.actorId}; claimed by ${conflictingActors.join(", ")}.`,
+        relatedFiles: [input.locator],
+        relatedResources,
+        relatedClaimIds,
+    });
+    return { gateId: result.gate.id, reusedGate: false };
+}
+function findExistingPollutionGate(input, changedResource) {
+    return sgListActive({
+        taskId: input.taskId,
+        sessionId: input.sessionId,
+    }).find(gate => gate.reason === SyncGateReason.RESOURCE_CONFLICT &&
+        gateMatchesResource(toAuditGateContext(gate), changedResource));
+}
+function appendAuditNote(gateId, note) {
+    const gate = protocolRepo.getSyncGate(gateId);
+    if (gate.description.includes(note))
+        return;
+    protocolRepo.updateSyncGateDescription(gateId, gate.description ? `${gate.description} ${note}` : note);
+}
+function toAuditGateContext(gate) {
+    const root = getProjectRoot();
+    return {
+        id: gate.id,
+        relatedFiles: gate.relatedFiles.map(f => normalizeResourcePath(f, { projectRoot: root })),
+        relatedResources: gate.relatedResources.map(r => ({
+            ...r,
+            locator: r.type === "file" ? normalizeResourcePath(r.locator, { projectRoot: root }) : r.locator,
+        })),
+    };
+}
+//# sourceMappingURL=file-audit-service.js.map

package/dist/server/application/file-audit-service.js.map

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

package/dist/server/application/file-io.d.ts

@@ -0,0 +1,28 @@
+/**
+ * File I/O utilities — path security, atomic writes, resource hashing.
+ * Extracted from write-permit-service.ts.
+ */
+import type { ResourceRef, WriteResourceHash } from "../../kernel/index.js";
+export declare function resolveRootDir(): string;
+export declare function canonicalRoot(root: string): string;
+export declare function resolveNativeLocator(root: string, locator: string): string;
+export declare function normalizeFileLocator(locator: string, root: string): string;
+export declare function isInsideOrSame(root: string, target: string): boolean;
+/**
+ * Resolve a resource locator to a filesystem path, with containment checks.
+ * Throws ForbiddenError if the resolved path escapes the guarded root.
+ */
+export declare function safeResolve(root: string, locator: string): string;
+export declare function realpathForContainmentCheck(target: string): string;
+/**
+ * Write file atomically: write to temp file, then rename into place.
+ * Uses .syncpoint-tmp-{pid}-{ts} naming to avoid collisions.
+ */
+export declare function atomicWriteFile(target: string, content: Buffer): void;
+export declare function readResourceHash(root: string, resource: ResourceRef): {
+    sha256?: string;
+    exists: boolean;
+};
+export declare function resolveBaseHashes(resources: ResourceRef[], root: string): WriteResourceHash[];
+export declare function sameResource(a: ResourceRef, b: ResourceRef): boolean;
+//# sourceMappingURL=file-io.d.ts.map

package/dist/server/application/file-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-io.d.ts","sourceRoot":"","sources":["../../../_build/src/server/application/file-io.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAK5E,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAI1E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1E;AAID,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGpE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAUjE;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUlE;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAIrE;AAID,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAQ1G;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAE7F;AAID,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAEpE"}