syncpoint-ai 0.1.0

package/dist/server/application/playbook-service.js

@@ -0,0 +1,148 @@
+/**
+ * Playbook Service — orchestration playbook use cases.
+ * Provides next-action computation, evidence capture, and active session lookup.
+ * CLI, MCP, and tRPC all share this layer.
+ */
+import { ChangeRequestStatus } from "../../governance/index.js";
+import { computeNextActions } from "../../adapters/index.js";
+import * as foundationRepo from "../repositories/_exports/foundation.js";
+import * as orchestrationRepo from "../repositories/_exports/orchestration.js";
+import { rwAddEvidence, rwEvaluateGate, rwListChangeRequests } from "./review-workflow-service.js";
+import { orchGetSessionStatus } from "./orchestration-service.js";
+import { rcList } from "./resource-claim-service.js";
+// ── Use Cases ────────────────────────────────────────
+/**
+ * Compute next actions for an agent within a session.
+ * Assembles a SessionSnapshot from current DB state and delegates to the pure engine.
+ */
+export function pbGetNextAction(input) {
+    const status = orchGetSessionStatus(input.sessionId);
+    foundationRepo.getAgent(input.agentId); // validate agent exists
+    const agentRoles = status.roles
+        .filter(r => r.agentId === input.agentId)
+        .map(r => r.role);
+    // Build gates and openChanges for reviews assigned to this agent
+    const gates = {};
+    const openChanges = {};
+    for (const r of status.reviews) {
+        if (r.reviewerAgentId === input.agentId) {
+            try {
+                gates[r.id] = rwEvaluateGate(r.id);
+            }
+            catch { /* ignore if gate computation fails */ }
+            try {
+                const changes = rwListChangeRequests(r.id);
+                openChanges[r.id] = changes.filter(c => c.status === ChangeRequestStatus.OPEN).length;
+            }
+            catch { /* ignore */ }
+        }
+        // Also track open changes for reviews on tasks this agent executes
+        const myAssignment = status.assignments.find(a => a.taskId === r.taskId && a.assigneeAgentId === input.agentId);
+        if (myAssignment) {
+            try {
+                const changes = rwListChangeRequests(r.id);
+                openChanges[r.id] = changes.filter(c => c.status === ChangeRequestStatus.OPEN).length;
+            }
+            catch { /* ignore */ }
+        }
+    }
+    const snap = {
+        sessionId: input.sessionId,
+        sessionStatus: status.session.status,
+        agentId: input.agentId,
+        agentRoles,
+        assignments: status.assignments.map(a => ({
+            id: a.id,
+            taskId: a.taskId,
+            assigneeAgentId: a.assigneeAgentId,
+            status: a.status,
+        })),
+        reviews: status.reviews.map(r => ({
+            id: r.id,
+            taskId: r.taskId,
+            reviewerAgentId: r.reviewerAgentId,
+            status: r.status,
+        })),
+        gates,
+        openChanges,
+        relationshipMode: status.session.relationshipMode,
+        activeClaimTaskIds: rcList({ actorId: input.agentId, status: "ACTIVE" })
+            .map(c => c.taskId)
+            .filter((v, i, a) => a.indexOf(v) === i),
+    };
+    const actions = computeNextActions(snap);
+    return {
+        sessionId: input.sessionId,
+        agentId: input.agentId,
+        sessionStatus: status.session.status,
+        actions,
+    };
+}
+/**
+ * Capture command output as review evidence.
+ * Auto-detects evidence kind from command name if not specified.
+ */
+export function pbCaptureEvidence(input) {
+    const kind = input.kind ?? detectEvidenceKind(input.command);
+    const title = input.command;
+    const metadataJson = input.exitCode !== undefined
+        ? JSON.stringify({ command: input.command, exitCode: input.exitCode })
+        : JSON.stringify({ command: input.command });
+    const evidence = rwAddEvidence({
+        reviewRequestId: input.reviewRequestId,
+        kind,
+        title,
+        content: input.output,
+        metadataJson,
+        createdBy: input.createdBy,
+    });
+    return { evidence, kind, title };
+}
+/**
+ * Find the active session for an agent and return a summary with next actions.
+ * Looks for the most recent non-COMPLETED, non-CANCELLED session the agent is part of.
+ */
+export function pbGetActiveSession(agentId) {
+    const agent = foundationRepo.getAgent(agentId);
+    const sessions = orchestrationRepo.listSessions();
+    // Find sessions this agent has a role in, sorted by most recent
+    for (const sess of sessions.reverse()) {
+        if (sess.status === "COMPLETED" || sess.status === "CANCELLED")
+            continue;
+        const roles = orchestrationRepo.listRoles(sess.id);
+        const agentRoles = roles.filter(r => r.agentId === agentId);
+        if (agentRoles.length === 0)
+            continue;
+        // Found active session
+        const result = pbGetNextAction({ sessionId: sess.id, agentId });
+        const assignments = orchestrationRepo.listTaskAssignments(sess.id);
+        const reviews = orchestrationRepo.listReviewRequests(sess.id);
+        return {
+            sessionId: sess.id,
+            sessionStatus: sess.status,
+            agentId,
+            agentName: agent.name,
+            roles: agentRoles.map(r => r.role),
+            assignmentCount: assignments.filter(a => a.assigneeAgentId === agentId).length,
+            reviewCount: reviews.filter(r => r.reviewerAgentId === agentId).length,
+            actions: result.actions,
+        };
+    }
+    return null;
+}
+// ── Helpers ──────────────────────────────────────────
+function detectEvidenceKind(command) {
+    const cmd = command.toLowerCase();
+    if (cmd.includes("test") || cmd.includes("vitest") || cmd.includes("jest"))
+        return "test";
+    if (cmd.includes("build") || cmd.includes("tsc") || cmd.includes("esbuild"))
+        return "build";
+    if (cmd.includes("typecheck") || cmd.includes("tsc --noEmit"))
+        return "typecheck";
+    if (cmd.includes("lint") || cmd.includes("eslint") || cmd.includes("biome"))
+        return "lint";
+    if (cmd.includes("diff") || cmd.includes("git diff"))
+        return "diff";
+    return "manual";
+}
+//# sourceMappingURL=playbook-service.js.map

package/dist/server/application/playbook-service.js.map

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

package/dist/server/application/project-memory-service.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Project Memory use cases.
+ * CLI, tRPC, and MCP all share this layer.
+ */
+import { InternalError, ResourceConflictError, ValidationError } from "../../kernel/index.js";
+import type { AppliesTo, ProjectMemory, ProjectMemoryCreate, ProjectMemoryValidatorConfig, MemoryDedupResult } from "../../context/index.js";
+export interface ProjectMemoryAddInput extends ProjectMemoryCreate {
+    /** If true, skip project-local check */
+    global?: boolean;
+}
+export interface ProjectMemoryExportResult {
+    path: string;
+    count: number;
+    content: string;
+}
+export declare class ProjectMemoryPathError extends ValidationError {
+    constructor(message?: string);
+}
+export declare class CallerIdentityError extends InternalError {
+    constructor();
+}
+export declare class DuplicateMemoryError extends ResourceConflictError {
+    constructor(existingId: string);
+    get existingId(): string;
+    get userMessage(): string;
+}
+export declare class InvalidProjectionError extends ValidationError {
+    constructor(kind: string, target: string);
+}
+/**
+ * P4: Blocking hard_constraint memories must specify a validatorType.
+ * Without a typed validator, the constraint runtime treats the memory as advisory
+ * only. Requiring validatorType at write time ensures intent is explicit.
+ */
+export declare class MissingValidatorError extends ValidationError {
+    constructor();
+}
+/**
+ * P4: Unknown validatorType — not registered by any plugin or core built-in.
+ */
+export declare class UnknownValidatorTypeError extends ValidationError {
+    constructor(given: string);
+}
+export declare function pmAdd(input: ProjectMemoryAddInput): ProjectMemory;
+/**
+ * Check for duplicate without creating — for callers that want to inspect before deciding.
+ */
+export declare function pmCheckDuplicate(category: string, title: string, content: string): MemoryDedupResult;
+export declare function pmGet(id: string): ProjectMemory;
+export declare function pmUpdate(id: string, fields: {
+    title?: string;
+    content?: string;
+    tags?: string[];
+    confidence?: string;
+    updatedBy: string;
+    kind?: string;
+    projectionTarget?: string | null;
+    appliesTo?: AppliesTo;
+    severity?: string;
+    validityStatus?: string;
+    validityStaleReason?: string;
+    validatorType?: string;
+    validatorConfig?: ProjectMemoryValidatorConfig | null;
+}): ProjectMemory;
+export declare function pmApprove(id: string, updatedBy: string): ProjectMemory;
+export declare function pmDeprecate(id: string, updatedBy: string): ProjectMemory;
+/**
+ * Supersede: mark newId as replacement for oldId.
+ * Old memory is deprecated with supersededBy link. New memory gets supersedes link.
+ */
+export declare function pmSupersede(newId: string, oldId: string, updatedBy: string): {
+    newMem: ProjectMemory;
+    oldMem: ProjectMemory;
+};
+/**
+ * Get the current memory version counter.
+ */
+export declare function pmGetVersion(): number;
+export declare function pmList(filters?: {
+    status?: string;
+    category?: string;
+    scope?: string;
+    taskId?: string;
+}): ProjectMemory[];
+export declare function pmSearch(query: string): ProjectMemory[];
+/**
+ * Export approved project memories to .syncpoint/project-memory.md.
+ * Returns the file path and content written.
+ */
+export declare function pmExport(outputPath?: string, callerBy?: string): ProjectMemoryExportResult;
+//# sourceMappingURL=project-memory-service.d.ts.map

package/dist/server/application/project-memory-service.d.ts.map

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

package/dist/server/application/project-memory-service.js

@@ -0,0 +1,296 @@
+/**
+ * Project Memory use cases.
+ * CLI, tRPC, and MCP all share this layer.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { isValidProjection, defaultKindFromCategory } from "../../context/index.js";
+import { isConstraintRuleKnown } from "../../governance/index.js";
+import { InternalError, ResourceConflictError, ValidationError, normalizeResourcePath } from "../../kernel/index.js";
+import * as contextMemoryRepo from "../repositories/_exports/context-memory.js";
+import { isProjectLocal, getSyncpointDir } from "../db.js";
+import { getProjectRoot } from "./path-resolver.js";
+// ── Path guard ────────────────────────────────────────
+export class ProjectMemoryPathError extends ValidationError {
+    constructor(message) {
+        super("project path", message ??
+            "No project-local .syncpoint/ found. Run `syncpoint init` first, " +
+                "or use --global to write to the fallback location.");
+        this.name = "ProjectMemoryPathError";
+    }
+}
+function ensureProjectLocal(global) {
+    if (global)
+        return;
+    if (!isProjectLocal())
+        throw new ProjectMemoryPathError();
+}
+// ── Caller identity guard ────────────────────────────
+export class CallerIdentityError extends InternalError {
+    constructor() {
+        super("Caller identity required. Provide callerBy (agentId or user identifier) " +
+            "for all project memory write operations.");
+        this.name = "CallerIdentityError";
+    }
+}
+function requireCallerIdentity(callerBy) {
+    if (!callerBy || callerBy.trim().length === 0) {
+        throw new CallerIdentityError();
+    }
+}
+// ── appliesTo normalization ──────────────────────────
+/**
+ * Normalize `appliesTo.files` patterns to absolute paths so they match
+ * normalized claim locators during constraint evaluation.
+ * Other scope fields (e.g. "modules") are left as-is.
+ */
+function normalizeAppliesToFiles(input) {
+    if (!input.appliesTo?.files?.length)
+        return input;
+    const root = getProjectRoot();
+    return {
+        ...input,
+        appliesTo: {
+            ...input.appliesTo,
+            files: input.appliesTo.files.map(f => normalizeResourcePath(f, { projectRoot: root })),
+        },
+    };
+}
+// ── Export path containment ──────────────────────────
+/**
+ * Validate that the resolved export path is within the .syncpoint/ directory
+ * or a direct child of the project root. Prevents path traversal attacks.
+ */
+function validateExportPath(resolvedPath) {
+    const normalized = path.resolve(resolvedPath);
+    const spDir = path.resolve(getSyncpointDir());
+    const projectRoot = path.dirname(spDir);
+    // Allow: anything inside .syncpoint/ (the standard location)
+    if (normalized.startsWith(spDir + path.sep) || normalized === spDir)
+        return;
+    // Allow: direct children of the project root (e.g. PROJECT_ROOT/project-memory.md)
+    const parent = path.dirname(normalized);
+    if (parent === projectRoot)
+        return;
+    throw new ProjectMemoryPathError(`Export path "${resolvedPath}" is outside the allowed directory. ` +
+        `Allowed: inside ${spDir} or directly under ${projectRoot}.`);
+}
+// ── Use cases ────────────────────────────────────────
+export class DuplicateMemoryError extends ResourceConflictError {
+    constructor(existingId) {
+        super("project-memory", existingId);
+        this.name = "DuplicateMemoryError";
+    }
+    get existingId() { return this.claimedBy; }
+    get userMessage() {
+        return `Duplicate project memory detected. Existing memory: ${this.claimedBy}. Use supersede to replace it, or update the existing memory.`;
+    }
+}
+export class InvalidProjectionError extends ValidationError {
+    constructor(kind, target) {
+        super("projection", `Memory kind "${kind}" cannot project to "${target}". hard_constraint and protocol_rule must target protocol_gate or constraint_runtime.`);
+        this.name = "InvalidProjectionError";
+    }
+}
+/**
+ * P4: Blocking hard_constraint memories must specify a validatorType.
+ * Without a typed validator, the constraint runtime treats the memory as advisory
+ * only. Requiring validatorType at write time ensures intent is explicit.
+ */
+export class MissingValidatorError extends ValidationError {
+    constructor() {
+        super("validatorType", "Blocking hard_constraint requires a validatorType. Without a typed validator, the constraint is advisory only.");
+        this.name = "MissingValidatorError";
+    }
+}
+/**
+ * P4: Unknown validatorType — not registered by any plugin or core built-in.
+ */
+export class UnknownValidatorTypeError extends ValidationError {
+    constructor(given) {
+        super("validatorType", `Unknown validatorType "${given}". No constraint rule evaluator is registered for this type.`);
+        this.name = "UnknownValidatorTypeError";
+    }
+}
+/**
+ * P4: Validate that blocking hard_constraints have a known validatorType.
+ * Uses isConstraintRuleKnown() from core, which checks core built-ins
+ * and plugin-registered evaluators — no hardcoded allowlist.
+ */
+function requireValidatorForBlockingConstraint(kind, severity, validatorType) {
+    if (kind === "hard_constraint" && severity === "blocking") {
+        if (!validatorType || validatorType.trim().length === 0) {
+            throw new MissingValidatorError();
+        }
+        if (!isConstraintRuleKnown(validatorType.trim())) {
+            throw new UnknownValidatorTypeError(validatorType);
+        }
+    }
+}
+export function pmAdd(input) {
+    requireCallerIdentity(input.createdBy);
+    ensureProjectLocal(input.global);
+    // Dedup check: reject if identical fingerprint exists in non-deprecated state
+    const dedup = contextMemoryRepo.checkMemoryDuplicate(input.category, input.title, input.content);
+    if (dedup.isDuplicate) {
+        throw new DuplicateMemoryError(dedup.existingId);
+    }
+    // V2 projection guard: hard_constraint / protocol_rule cannot target context_snapshot
+    const kind = input.kind ?? defaultKindFromCategory(input.category);
+    if (input.projectionTarget) {
+        if (!isValidProjection(kind, input.projectionTarget)) {
+            throw new InvalidProjectionError(kind, input.projectionTarget);
+        }
+    }
+    // P4: blocking hard_constraint requires validatorType
+    requireValidatorForBlockingConstraint(kind, input.severity, input.validatorType);
+    // Normalize appliesTo file patterns to absolute paths so they match
+    // normalized claim locators during constraint evaluation
+    const normalizedInput = normalizeAppliesToFiles(input);
+    return contextMemoryRepo.createProjectMemory(normalizedInput);
+}
+/**
+ * Check for duplicate without creating — for callers that want to inspect before deciding.
+ */
+export function pmCheckDuplicate(category, title, content) {
+    return contextMemoryRepo.checkMemoryDuplicate(category, title, content);
+}
+export function pmGet(id) {
+    return contextMemoryRepo.getProjectMemory(id);
+}
+export function pmUpdate(id, fields) {
+    requireCallerIdentity(fields.updatedBy);
+    // V2 projection guard on update — validate against FINAL merged state
+    const existing = contextMemoryRepo.getProjectMemory(id);
+    const finalKind = (fields.kind ?? existing.kind ?? defaultKindFromCategory(existing.category));
+    const finalTarget = (fields.projectionTarget !== undefined ? fields.projectionTarget : existing.projectionTarget);
+    if (finalTarget !== undefined && finalTarget !== null) {
+        if (!isValidProjection(finalKind, finalTarget)) {
+            throw new InvalidProjectionError(finalKind, finalTarget);
+        }
+    }
+    // P4: blocking hard_constraint requires validatorType (merged state)
+    const finalSeverity = (fields.severity ?? existing.severity);
+    const finalValidatorType = (fields.validatorType ?? existing.validatorType);
+    requireValidatorForBlockingConstraint(finalKind, finalSeverity, finalValidatorType);
+    // Normalize appliesTo file patterns if provided
+    const normalizedFields = fields.appliesTo?.files?.length
+        ? { ...fields, appliesTo: normalizeAppliesToFiles({ appliesTo: fields.appliesTo }).appliesTo }
+        : fields;
+    return contextMemoryRepo.updateProjectMemory(id, normalizedFields);
+}
+export function pmApprove(id, updatedBy) {
+    requireCallerIdentity(updatedBy);
+    return contextMemoryRepo.approveProjectMemory(id, updatedBy);
+}
+export function pmDeprecate(id, updatedBy) {
+    requireCallerIdentity(updatedBy);
+    return contextMemoryRepo.deprecateProjectMemory(id, updatedBy);
+}
+/**
+ * Supersede: mark newId as replacement for oldId.
+ * Old memory is deprecated with supersededBy link. New memory gets supersedes link.
+ */
+export function pmSupersede(newId, oldId, updatedBy) {
+    requireCallerIdentity(updatedBy);
+    return contextMemoryRepo.supersedeProjectMemory(newId, oldId, updatedBy);
+}
+/**
+ * Get the current memory version counter.
+ */
+export function pmGetVersion() {
+    return contextMemoryRepo.getMemoryVersion();
+}
+export function pmList(filters) {
+    return contextMemoryRepo.listProjectMemories(filters);
+}
+export function pmSearch(query) {
+    return contextMemoryRepo.searchProjectMemories(query);
+}
+// ── Export ────────────────────────────────────────────
+/**
+ * Resolve the project-memory.md output path.
+ * Priority: explicit arg > SYNCPOINT_MEMORY_PATH env > .syncpoint/project-memory.md
+ */
+function resolveMemoryPath(outputPath) {
+    if (outputPath)
+        return outputPath;
+    if (process.env.SYNCPOINT_MEMORY_PATH)
+        return process.env.SYNCPOINT_MEMORY_PATH;
+    return path.join(getSyncpointDir(), "project-memory.md");
+}
+/**
+ * Export approved project memories to .syncpoint/project-memory.md.
+ * Returns the file path and content written.
+ */
+export function pmExport(outputPath, callerBy) {
+    requireCallerIdentity(callerBy);
+    // P1: use canonical collection — deduplicates by fingerprint, excludes superseded
+    const canonical = contextMemoryRepo.collectProjectMemories();
+    const canonicalIds = new Set(canonical.map(m => m.id));
+    const approved = contextMemoryRepo.listProjectMemories({ status: "approved" })
+        .filter(m => canonicalIds.has(m.id));
+    const content = renderProjectMemoryMarkdown(approved);
+    const target = resolveMemoryPath(outputPath);
+    validateExportPath(target);
+    const dir = path.dirname(target);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(target, content, "utf-8");
+    return { path: target, count: approved.length, content };
+}
+function renderProjectMemoryMarkdown(memories) {
+    const lines = [];
+    lines.push("# Project Memory");
+    lines.push("");
+    lines.push("> Auto-generated by SyncPoint. Do not edit manually.");
+    lines.push(`> Generated: ${new Date().toISOString()}`);
+    lines.push(`> Entries: ${memories.length} approved`);
+    lines.push("");
+    // Group by category
+    const byCategory = new Map();
+    for (const m of memories) {
+        const list = byCategory.get(m.category) ?? [];
+        list.push(m);
+        byCategory.set(m.category, list);
+    }
+    const categoryOrder = [
+        "overview", "architecture", "decision", "convention",
+        "risk", "gotcha", "glossary", "file-map", "integration",
+    ];
+    for (const cat of categoryOrder) {
+        const items = byCategory.get(cat);
+        if (!items || items.length === 0)
+            continue;
+        lines.push(`## ${cat.charAt(0).toUpperCase() + cat.slice(1)}`);
+        lines.push("");
+        for (const m of items) {
+            lines.push(`### ${m.title}`);
+            if (m.tags.length > 0)
+                lines.push(`> Tags: ${m.tags.join(", ")}`);
+            if (m.confidence !== "medium")
+                lines.push(`> Confidence: ${m.confidence}`);
+            if (m.scope !== "project")
+                lines.push(`> Scope: ${m.scope}`);
+            // V2 metadata
+            if (m.kind && m.kind !== "fact")
+                lines.push(`> Kind: ${m.kind}`);
+            if (m.severity && m.severity !== "info")
+                lines.push(`> Severity: ${m.severity}`);
+            if (m.projectionTarget)
+                lines.push(`> Projection: ${m.projectionTarget}`);
+            if (m.validityStatus && m.validityStatus !== "fresh")
+                lines.push(`> Validity: ${m.validityStatus}`);
+            if (Object.keys(m.appliesTo).length > 0) {
+                if (m.appliesTo.files?.length)
+                    lines.push(`> Files: ${m.appliesTo.files.join(", ")}`);
+                if (m.appliesTo.modules?.length)
+                    lines.push(`> Modules: ${m.appliesTo.modules.join(", ")}`);
+            }
+            lines.push("");
+            lines.push(m.content);
+            lines.push("");
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=project-memory-service.js.map

package/dist/server/application/project-memory-service.js.map

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

package/dist/server/application/protocol-gate-service.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Protocol Gate & Snapshot Validation — P12 context assembly layer.
+ *
+ * Design principle:
+ *   snapshot-only means agent working-context only, not protocol-only.
+ *   Protocol rules are never absorbed into snapshot — they remain a hard external layer.
+ *
+ * Three layers:
+ *   1. Protocol Gate   — hard collaboration rules
+ *   2. Snapshot Reality — agent's current task working memory
+ *   3. Validation Notes — staleness, evidence coverage, missing proof
+ */
+import type { ContextSnapshot, Checkpoint } from "../../adapters/index.js";
+import type { ProtocolGateSummary, SnapshotValidation, RealityProjection } from "../../context/index.js";
+/**
+ * Assemble the full protocol gate summary for an agent + task context.
+ * This collects all active collaboration rules from every protocol source.
+ */
+export declare function assembleProtocolGate(agentId: string, taskId: string, sessionId?: string): ProtocolGateSummary;
+/**
+ * Inject projected protocolRules and constraintRules into the protocol gate.
+ * Also injects projection conflicts and validity degradation.
+ * Returns a new ProtocolGateSummary (does not mutate input).
+ */
+export declare function injectProjectionIntoGate(gate: ProtocolGateSummary, projection: RealityProjection): ProtocolGateSummary;
+/**
+ * Validate a snapshot against the current state.
+ * Returns a validation result with notes.
+ */
+export declare function validateSnapshot(snapshot: ContextSnapshot | null | undefined, checkpoint: Checkpoint | null | undefined, taskId: string, agentId: string): SnapshotValidation;
+/**
+ * Format the protocol gate as a prompt section.
+ * This is the "you must obey these rules" block.
+ */
+export declare function formatProtocolGatePrompt(gate: ProtocolGateSummary): string;
+/**
+ * Format snapshot validation as a prompt section.
+ */
+export declare function formatValidationNotes(validation: SnapshotValidation): string;
+/**
+ * Format the snapshot as the main working context prompt section.
+ */
+export declare function formatSnapshotReality(snapshot: ContextSnapshot | null): string;
+//# sourceMappingURL=protocol-gate-service.d.ts.map

package/dist/server/application/protocol-gate-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-gate-service.d.ts","sourceRoot":"","sources":["../../../_build/src/server/application/protocol-gate-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAgB,MAAM,yBAAyB,CAAC;AACzF,OAAO,KAAK,EAAgB,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAcvH;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,mBAAmB,CAsIrB;AAMD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,mBAAmB,EACzB,UAAU,EAAE,iBAAiB,GAC5B,mBAAmB,CAkDrB;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC5C,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACzC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,kBAAkB,CAmEpB;AAMD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CA2C1E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAU5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,CA6C9E"}