syncpoint-ai 0.1.0

package/dist/cli/commands/guard.js

@@ -0,0 +1,150 @@
+import { Command } from "commander";
+import { guardCreateSession, guardRevokeSession, guardStatus, guardValidateToken, reconcileBackingStore, unlockAllGuards, recoverGuardState } from "../../server/application/index.js";
+import { resolveAgent } from "./connect.js";
+export function registerGuardCommands(program) {
+    const guard = new Command("guard")
+        .description("Guarded workspace controls for editor/proxy file-write enforcement");
+    guard
+        .command("status")
+        .description("Show guarded workspace status and active guard sessions")
+        .option("--json", "Output JSON", false)
+        .action((opts) => {
+        print(guardStatus(), opts.json === true);
+    });
+    guard
+        .command("session")
+        .description("Create a local guard capability token for editor/proxy adapters")
+        .requiredOption("--agent <nameOrId>", "Actor name or ID")
+        .requiredOption("--task <taskId>", "Task ID")
+        .option("--session <sessionId>", "Session ID")
+        .option("--mode <mode>", "observe|stage|strict|readonly", "strict")
+        .option("--mount <path>", "Guarded mount path inside the project root")
+        .option("--adapter <adapter>", "winfsp|fuse|macfuse|manual")
+        .option("--ttl <seconds>", "Token TTL in seconds", parseInt)
+        .option("--json", "Output JSON", false)
+        .action((opts) => {
+        const agent = resolveAgent(opts.agent);
+        const result = guardCreateSession({
+            actorId: agent?.id ?? opts.agent,
+            taskId: opts.task,
+            sessionId: opts.session,
+            mode: opts.mode,
+            mountPath: opts.mount,
+            adapter: opts.adapter,
+            ttlSeconds: opts.ttl,
+        });
+        print(result, opts.json === true);
+    });
+    guard
+        .command("mount")
+        .description("Create a guard session descriptor for a future WinFsp/FUSE mount")
+        .argument("<mountPath>", "Guarded mount path inside the project root")
+        .requiredOption("--agent <nameOrId>", "Actor name or ID")
+        .requiredOption("--task <taskId>", "Task ID")
+        .option("--session <sessionId>", "Session ID")
+        .option("--mode <mode>", "observe|stage|strict|readonly", "strict")
+        .option("--adapter <adapter>", "winfsp|fuse|macfuse|manual")
+        .option("--json", "Output JSON", false)
+        .action((mountPath, opts) => {
+        const agent = resolveAgent(opts.agent);
+        const result = guardCreateSession({
+            actorId: agent?.id ?? opts.agent,
+            taskId: opts.task,
+            sessionId: opts.session,
+            mode: opts.mode,
+            mountPath,
+            adapter: opts.adapter,
+        });
+        print({ ...result, proxyAvailable: false }, opts.json === true);
+    });
+    guard
+        .command("validate-token")
+        .description("Validate a local guard capability token")
+        .argument("<token>", "Guard token")
+        .option("--json", "Output JSON", false)
+        .action((token, opts) => {
+        print(guardValidateToken(token), opts.json === true);
+    });
+    guard
+        .command("revoke")
+        .description("Revoke a guard session")
+        .argument("<sessionId>", "Guard session ID")
+        .option("--json", "Output JSON", false)
+        .action((sessionId, opts) => {
+        print(guardRevokeSession(sessionId), opts.json === true);
+    });
+    guard
+        .command("unlock")
+        .description("Emergency: unlock all guarded files and restore original permissions")
+        .option("--all", "Unlock all guards across all project roots", false)
+        .option("--root <path>", "Project root to recover guard state from")
+        .option("--json", "Output JSON", false)
+        .action((opts) => {
+        try {
+            // First try to recover from persisted guard state (crash recovery)
+            if (opts.root) {
+                const recovery = recoverGuardState(opts.root);
+                if (recovery.recovered.length > 0) {
+                    if (opts.json) {
+                        console.log(JSON.stringify({ source: "crash_recovery", ...recovery }));
+                        return;
+                    }
+                    console.log(`Crash recovery: restored ${recovery.recovered.length} file(s)`);
+                    if (recovery.errors.length > 0)
+                        console.error(`Errors: ${recovery.errors.join(", ")}`);
+                    return;
+                }
+            }
+            // Then unlock all active guards
+            if (opts.all) {
+                const result = unlockAllGuards(opts.root);
+                if (opts.json) {
+                    console.log(JSON.stringify(result));
+                    return;
+                }
+                console.log(`Unlocked ${result.unlocked.length} file(s)`);
+                if (result.errors.length > 0)
+                    console.error(`Errors: ${result.errors.join(", ")}`);
+                return;
+            }
+            console.error("Specify --all to unlock all guards, or --root <path> for crash recovery.");
+            process.exitCode = 1;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`Error: ${msg}`);
+            process.exitCode = 1;
+        }
+    });
+    guard
+        .command("reconcile")
+        .description("Scan claimed files for unauthorized direct writes to the backing store and raise blockers")
+        .requiredOption("--task <taskId>", "Task ID")
+        .option("--session <sessionId>", "Session ID")
+        .option("--json", "Output JSON", false)
+        .action((opts) => {
+        const result = reconcileBackingStore({ taskId: opts.task, sessionId: opts.session });
+        if (opts.json) {
+            print(result, true);
+        }
+        else {
+            console.log(`Scanned: ${result.scannedFiles} claimed file(s)`);
+            console.log(`Bypasses detected: ${result.bypassesDetected}`);
+            if (result.gatesCreated.length > 0)
+                console.log(`Gates created: ${result.gatesCreated.join(", ")}`);
+            if (result.gatesReused.length > 0)
+                console.log(`Gates updated: ${result.gatesReused.join(", ")}`);
+            if (result.bypassesDetected === 0)
+                console.log("No unauthorized backing store modifications detected.");
+        }
+    });
+    program.addCommand(guard);
+}
+function print(value, json) {
+    if (json) {
+        console.log(JSON.stringify(value, null, 2));
+        return;
+    }
+    console.log(JSON.stringify(value, null, 2));
+}
+//# sourceMappingURL=guard.js.map

package/dist/cli/commands/guard.js.map

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

package/dist/cli/commands/loop.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI: syncpoint loop — composite agent workflow commands.
+ */
+import { Command } from "commander";
+export declare function registerLoopCommand(program: Command): void;
+//# sourceMappingURL=loop.d.ts.map

package/dist/cli/commands/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../_build/src/cli/commands/loop.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAkC5C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkM1D"}

package/dist/cli/commands/loop.js

@@ -0,0 +1,238 @@
+/**
+ * CLI: syncpoint loop — composite agent workflow commands.
+ */
+import { Command, Option } from "commander";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { loopBoot, loopResume, loopCheckpoint, loopHandoff, loopStatus, LoopError, } from "../../server/application/index.js";
+function fail(code, message, json) {
+    if (json)
+        console.log(JSON.stringify({ ok: false, error: message, exitCode: code }));
+    else
+        console.error(`Error: ${message}`);
+    process.exitCode = code;
+    throw new LoopError(code, message);
+}
+function catchLoop(err, json) {
+    if (process.exitCode)
+        return;
+    const code = err instanceof LoopError ? err.exitCode : 1;
+    const msg = err instanceof Error ? err.message : String(err);
+    fail(code, msg, json);
+}
+function writeFiles(files) {
+    for (const [fp, content] of Object.entries(files)) {
+        const dir = path.dirname(fp);
+        if (dir && !fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(fp, content, "utf-8");
+    }
+}
+export function registerLoopCommand(program) {
+    program
+        .command("loop")
+        .description("Agent workflow loop — composite commands for AI editors")
+        .addCommand(new Command("boot")
+        .description("Boot: assign task, enforce context policy, generate editor rules files")
+        .requiredOption("--agent <agentId>", "Agent ID")
+        .requiredOption("--task <taskId>", "Task ID")
+        .option("--provider <provider>", "Editor provider override")
+        .option("--json", "Machine-readable JSON output")
+        .action(async (opts) => {
+        const isJson = !!opts.json;
+        try {
+            const result = loopBoot({
+                agentId: opts.agent,
+                taskId: opts.task,
+                provider: opts.provider,
+            });
+            writeFiles(result.files);
+            if (isJson) {
+                const { files, ...rest } = result;
+                console.log(JSON.stringify(rest));
+            }
+            else {
+                console.log(`✓ loop boot: agent ${result.agentId} → task ${result.taskId}`);
+                console.log(`  Task status: ${result.taskStatus}`);
+                console.log(`  Context ready: ${result.contextReady}`);
+                for (const f of result.filesWritten)
+                    console.log(`  ✓ ${f}`);
+                if (result.warnings.length) {
+                    console.log("  Warnings:");
+                    for (const w of result.warnings)
+                        console.log(`    - ${w}`);
+                }
+            }
+        }
+        catch (err) {
+            catchLoop(err, isJson);
+        }
+    }))
+        .addCommand(new Command("resume")
+        .description("Resume: enforce context, regenerate editor rules, output resume prompt")
+        .requiredOption("--agent <agentId>", "Agent ID")
+        .requiredOption("--task <taskId>", "Task ID")
+        .option("--provider <provider>", "Editor provider override")
+        .option("--format <format>", "Prompt output format: system-prompt|cursorrules|agents-md|clipboard", "system-prompt")
+        .addOption(new Option("--context-mode <mode>", "Context mode").choices(["snapshot-first", "snapshot-only", "snapshot-locked"]))
+        .option("--session <sessionId>", "Session ID for protocol gate scoping")
+        .option("--json", "Machine-readable JSON output")
+        .action(async (opts) => {
+        const isJson = !!opts.json;
+        try {
+            const result = loopResume({
+                agentId: opts.agent,
+                taskId: opts.task,
+                provider: opts.provider,
+                format: opts.format,
+                contextMode: opts.contextMode,
+                sessionId: opts.session,
+            });
+            writeFiles(result.files);
+            if (isJson) {
+                const { files, ...rest } = result;
+                console.log(JSON.stringify(rest));
+            }
+            else {
+                console.log(`✓ loop resume: agent ${result.agentId} → task ${result.taskId}`);
+                for (const f of result.filesWritten)
+                    console.log(`  ✓ ${f}`);
+                console.log("\n" + result.prompt);
+            }
+        }
+        catch (err) {
+            catchLoop(err, isJson);
+        }
+    }))
+        .addCommand(new Command("checkpoint")
+        .description("Checkpoint: save progress + context snapshot + refresh editor rules")
+        .requiredOption("--agent <agentId>", "Agent ID")
+        .requiredOption("--task <taskId>", "Task ID")
+        .requiredOption("--summary <text>", "Checkpoint summary")
+        .option("--progress <text>", "Progress description", "")
+        .option("--next-steps <text>", "Next steps", "")
+        .option("--risks <text>", "Risks", "")
+        .option("--blockers <text>", "Blockers", "")
+        .option("--goal <text>", "Snapshot goal (inherits from latest if empty)")
+        .option("--phase <text>", "Current phase", "")
+        .option("--completed <text>", "Completed work", "")
+        .option("--remaining <text>", "Remaining work", "")
+        .option("--working-resources <text>", "Working resources", "")
+        .option("--resume-prompt <text>", "Custom resume prompt for snapshot")
+        .option("--need-sync", "Flag task as needing sync", false)
+        .option("--provider <provider>", "Editor provider override")
+        .option("--json", "Machine-readable JSON output")
+        .action(async (opts) => {
+        const isJson = !!opts.json;
+        try {
+            const result = loopCheckpoint({
+                agentId: opts.agent,
+                taskId: opts.task,
+                summary: opts.summary,
+                progress: opts.progress,
+                nextSteps: opts.nextSteps,
+                risks: opts.risks,
+                blockers: opts.blockers,
+                goal: opts.goal,
+                phase: opts.phase,
+                completed: opts.completed,
+                remaining: opts.remaining,
+                workingResources: opts.workingResources,
+                resumePrompt: opts.resumePrompt,
+                needSync: opts.needSync,
+                provider: opts.provider,
+            });
+            writeFiles(result.files);
+            if (isJson) {
+                const { files, ...rest } = result;
+                console.log(JSON.stringify(rest));
+            }
+            else {
+                console.log(`✓ loop checkpoint: ${opts.summary}`);
+                console.log(`  Checkpoint: ${result.checkpointId}`);
+                console.log(`  Snapshot:   ${result.snapshotId}`);
+                if (result.needSync)
+                    console.log("  ⚠ Task flagged for sync");
+                for (const f of result.filesWritten)
+                    console.log(`  ✓ ${f}`);
+            }
+        }
+        catch (err) {
+            catchLoop(err, isJson);
+        }
+    }))
+        .addCommand(new Command("handoff")
+        .description("Handoff: save snapshot, create handoff, generate rules for receiver")
+        .requiredOption("--task <taskId>", "Task ID")
+        .requiredOption("--from <fromAgentId>", "Sending agent ID")
+        .requiredOption("--to <toAgentId>", "Receiving agent ID")
+        .requiredOption("--context <text>", "Handoff context / summary")
+        .option("--auto-accept", "Automatically accept the handoff")
+        .option("--provider <provider>", "Receiver's editor provider override")
+        .option("--json", "Machine-readable JSON output")
+        .action(async (opts) => {
+        const isJson = !!opts.json;
+        try {
+            const result = loopHandoff({
+                taskId: opts.task,
+                fromAgentId: opts.from,
+                toAgentId: opts.to,
+                context: opts.context,
+                autoAccept: opts.autoAccept,
+                provider: opts.provider,
+            });
+            writeFiles(result.files);
+            if (isJson) {
+                const { files, ...rest } = result;
+                console.log(JSON.stringify(rest));
+            }
+            else {
+                console.log(`✓ loop handoff: ${result.from} → ${result.to}`);
+                console.log(`  Handoff: ${result.handoffId}${result.accepted ? " (auto-accepted)" : " (pending acceptance)"}`);
+                for (const f of result.filesWritten)
+                    console.log(`  ✓ ${f}`);
+            }
+        }
+        catch (err) {
+            catchLoop(err, isJson);
+        }
+    }))
+        .addCommand(new Command("status")
+        .description("Show agent's current task status and context readiness")
+        .requiredOption("--agent <agentId>", "Agent ID")
+        .option("--task <taskId>", "Task ID (defaults to agent's current task)")
+        .option("--json", "Machine-readable JSON output")
+        .action(async (opts) => {
+        const isJson = !!opts.json;
+        try {
+            const result = loopStatus({
+                agentId: opts.agent,
+                taskId: opts.task,
+            });
+            if (isJson) {
+                console.log(JSON.stringify(result));
+            }
+            else {
+                if (!result.hasTask) {
+                    console.log(`Agent ${result.agentName} (${result.agentId}) — no current task`);
+                    return;
+                }
+                console.log(`Agent:      ${result.agentName} (${result.agentId}) [${result.agentStatus}]`);
+                console.log(`Task:       ${result.taskTitle} (${result.taskId}) [${result.taskStatus}]`);
+                console.log(`Contract:   ${result.contractStatus ?? "none"}`);
+                console.log(`Checkpoints: ${result.checkpointCount}`);
+                console.log(`Snapshot:   ${result.hasSnapshot ? "yes" : "none"}`);
+                console.log(`Context:    ${result.contextReady ? "✓ ready" : "✗ not ready"}`);
+                if (result.warnings?.length) {
+                    console.log("Warnings:");
+                    for (const w of result.warnings)
+                        console.log(`  - ${w}`);
+                }
+            }
+        }
+        catch (err) {
+            catchLoop(err, isJson);
+        }
+    }));
+}
+//# sourceMappingURL=loop.js.map

package/dist/cli/commands/loop.js.map

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

package/dist/cli/commands/message.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI Message commands — send, list, read, reply, thread.
+ */
+import { Command } from "commander";
+export declare function registerMessageCommands(program: Command): void;
+//# sourceMappingURL=message.d.ts.map

package/dist/cli/commands/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../_build/src/cli/commands/message.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuH9D"}

package/dist/cli/commands/message.js

@@ -0,0 +1,131 @@
+/**
+ * CLI Message commands — send, list, read, reply, thread.
+ */
+import { Command } from "commander";
+import { msgSend, msgRead, msgReply, msgList, msgThread, } from "../../server/application/index.js";
+export function registerMessageCommands(program) {
+    const message = new Command("message")
+        .description("Inter-agent messaging: send, list, read, reply");
+    // syncpoint message send
+    message
+        .command("send")
+        .description("Send a message to another agent")
+        .requiredOption("--from <agentId>", "Sender agent ID")
+        .requiredOption("--to <agentId>", "Recipient agent ID")
+        .option("--kind <kind>", "Message kind: message, request, response", "message")
+        .option("--subject <subject>", "Subject line", "")
+        .option("--body <body>", "Message body", "")
+        .option("--expires <iso>", "Expiration timestamp (for requests)")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const kind = opts.kind;
+        const msg = msgSend({
+            fromAgent: opts.from,
+            toAgent: opts.to,
+            kind,
+            subject: opts.subject,
+            body: opts.body,
+            expiresAt: opts.expires ?? null,
+        });
+        if (opts.json) {
+            console.log(JSON.stringify(msg, null, 2));
+        }
+        else {
+            console.log(`Message sent: ${msg.id}`);
+            console.log(`  ${msg.fromAgent} → ${msg.toAgent} [${msg.kind}]`);
+            if (msg.subject)
+                console.log(`  Subject: ${msg.subject}`);
+            if (msg.requestStatus !== "none")
+                console.log(`  Request status: ${msg.requestStatus}`);
+        }
+    });
+    // syncpoint message list
+    message
+        .command("list")
+        .description("List messages with optional filters")
+        .option("--to <agentId>", "Filter by recipient")
+        .option("--from <agentId>", "Filter by sender")
+        .option("--unread", "Only show unread messages")
+        .option("--kind <kind>", "Filter by kind (message, request, response)")
+        .option("--limit <n>", "Max results", "50")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const messages = msgList({
+            toAgent: opts.to,
+            fromAgent: opts.from,
+            unreadOnly: opts.unread || undefined,
+            kind: opts.kind,
+            limit: parseInt(opts.limit, 10),
+        });
+        if (opts.json) {
+            console.log(JSON.stringify(messages, null, 2));
+        }
+        else if (messages.length === 0) {
+            console.log("No messages found.");
+        }
+        else {
+            for (const m of messages) {
+                const readFlag = m.readStatus === "unread" ? "●" : "○";
+                console.log(`${readFlag} ${m.id}  ${m.fromAgent}→${m.toAgent}  [${m.kind}]  ${m.subject || "(no subject)"}`);
+                if (m.requestStatus !== "none")
+                    console.log(`     request: ${m.requestStatus}`);
+            }
+            console.log(`\n${messages.length} message(s)`);
+        }
+    });
+    // syncpoint message read
+    message
+        .command("read <messageId>")
+        .description("Mark a message as read")
+        .requiredOption("--agent <agentId>", "Agent ID (must be the recipient)")
+        .option("--json", "Output as JSON")
+        .action(async (messageId, opts) => {
+        const msg = msgRead(messageId, opts.agent);
+        if (opts.json) {
+            console.log(JSON.stringify(msg, null, 2));
+        }
+        else {
+            console.log(`Marked as read: ${msg.id} by ${opts.agent}`);
+        }
+    });
+    // syncpoint message reply
+    message
+        .command("reply <messageId>")
+        .description("Reply to a message")
+        .requiredOption("--agent <agentId>", "Agent ID (must be the recipient)")
+        .requiredOption("--body <body>", "Reply body")
+        .option("--json", "Output as JSON")
+        .action(async (messageId, opts) => {
+        const response = msgReply(messageId, opts.agent, opts.body);
+        if (opts.json) {
+            console.log(JSON.stringify(response, null, 2));
+        }
+        else {
+            console.log(`Reply sent: ${response.id} (thread: ${response.threadRootId})`);
+        }
+    });
+    // syncpoint message thread
+    message
+        .command("thread <threadRootId>")
+        .description("View all messages in a thread")
+        .option("--json", "Output as JSON")
+        .action(async (threadRootId, opts) => {
+        const messages = msgThread(threadRootId);
+        if (opts.json) {
+            console.log(JSON.stringify(messages, null, 2));
+        }
+        else if (messages.length === 0) {
+            console.log("No messages in thread.");
+        }
+        else {
+            for (const m of messages) {
+                const indent = m.threadRootId === m.id ? "" : "  ↳ ";
+                console.log(`${indent}${m.fromAgent}→${m.toAgent} [${m.kind}] ${m.subject || ""}`);
+                if (m.body)
+                    console.log(`${indent}  ${m.body}`);
+            }
+        }
+    });
+    program.addCommand(message);
+}
+//# sourceMappingURL=message.js.map

package/dist/cli/commands/message.js.map

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

package/dist/cli/commands/patch.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI commands for operations (code patches) — create, submit, check, approve, reject, apply.
+ */
+import { Command } from "commander";
+export declare const patchCmd: Command;
+//# sourceMappingURL=patch.d.ts.map

package/dist/cli/commands/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../../_build/src/cli/commands/patch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,QAAQ,SAC8B,CAAC"}