@digitalpresence/cliclaw 0.1.2 → 0.2.1

package/dist/cron/ralph-wiggum.js

@@ -1,35 +1,95 @@
-import { query } from "@anthropic-ai/claude-agent-sdk";
-import { existsSync, mkdirSync, writeFileSync, readFileSync, realpathSync } from "fs";
-import { join, dirname } from "path";
-import { fileURLToPath } from "url";
+import { spawn } from "child_process";
+import { createInterface } from "readline";
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
+import { join } from "path";
 import { getProgressFilePath, ensureCronDirs, writeRunningMarker, clearRunningMarker } from "./progress.js";
 import { cronLog } from "./logger.js";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
 const CONTINUE_MARKER = "NEEDS_MORE_ITERATIONS";
+const CONTAINER_IMAGE = "cliclaw-agent";
+const CONTAINER_TIMEOUT_MS = 300_000; // 5 minutes per iteration
+function loadTaskContent(store, agentName, job) {
+    const taskFilePath = join(store.workspacePath(agentName), "cron-tasks", job.taskFile);
+    if (existsSync(taskFilePath)) {
+        return readFileSync(taskFilePath, "utf-8");
+    }
+    return `Task file not found: ${job.taskFile}`;
+}
+/**
+ * Run a single iteration inside a Docker container.
+ * Returns parsed NDJSON events.
+ */
+async function runContainerIteration(instancePath, prompt, sessionId) {
+    // Write session.json
+    writeFileSync(join(instancePath, "session.json"), JSON.stringify({ prompt, ...(sessionId ? { sessionId } : {}) }), "utf-8");
+    const args = [
+        "run", "--rm", "-i",
+        "-v", `${instancePath}:/instance`,
+        "--network=host",
+        "--cpus=2", "--memory=2g",
+    ];
+    // Pass API key
+    if (process.env.ANTHROPIC_API_KEY) {
+        args.push("-e", `ANTHROPIC_API_KEY=${process.env.ANTHROPIC_API_KEY}`);
+    }
+    args.push(CONTAINER_IMAGE);
+    return new Promise((resolve) => {
+        const child = spawn("docker", args, {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const timeout = setTimeout(() => {
+            child.kill("SIGTERM");
+        }, CONTAINER_TIMEOUT_MS);
+        const events = [];
+        const rl = createInterface({ input: child.stdout });
+        rl.on("line", (line) => {
+            if (!line.trim())
+                return;
+            try {
+                events.push(JSON.parse(line));
+            }
+            catch {
+                // skip malformed lines
+            }
+        });
+        let stderr = "";
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on("close", (code) => {
+            clearTimeout(timeout);
+            rl.close();
+            if (stderr.trim()) {
+                console.error(`[ralph-wiggum] container stderr: ${stderr.trim()}`);
+            }
+            resolve({ events, exitCode: code ?? 1 });
+        });
+    });
+}
 export async function executeRalphWiggumLoop(store, agentName, job, startedAt) {
     ensureCronDirs(agentName, job.id);
     writeRunningMarker(agentName, job.id, startedAt ?? new Date().toISOString());
-    const workspacePath = store.workspacePath(agentName);
+    // Use the cron instance path
+    const instancesDir = join(store.workspacePath(agentName), "..", "..", "instances");
+    const cronInstancePath = join(instancesDir, agentName, "_cron");
+    // Ensure cron instance exists with necessary files
+    if (!existsSync(cronInstancePath)) {
+        mkdirSync(join(cronInstancePath, "workspace"), { recursive: true });
+        mkdirSync(join(cronInstancePath, "memory"), { recursive: true });
+        // Copy template files
+        const agentDir = store.workspacePath(agentName);
+        for (const file of ["SOUL.md", "ROLE.md"]) {
+            const src = join(agentDir, file);
+            if (existsSync(src)) {
+                writeFileSync(join(cronInstancePath, file), readFileSync(src, "utf-8"));
+            }
+        }
+    }
     const progressFile = getProgressFilePath(agentName, job.id);
+    const taskContent = loadTaskContent(store, agentName, job);
+    let totalCostUsd = 0;
+    let sessionId;
+    const transcript = [];
     try {
-        // Ensure cliclaw CLI is in PATH
-        const cleanEnv = { ...process.env };
-        delete cleanEnv.CLAUDECODE;
-        const monorepoRoot = join(__dirname, "..", "..", "..");
-        const binScript = join(monorepoRoot, "packages", "cliclaw", "dist", "cli.js");
-        if (existsSync(binScript)) {
-            const resolvedBin = realpathSync(binScript);
-            const localBin = join(workspacePath, ".bin");
-            if (!existsSync(localBin))
-                mkdirSync(localBin, { recursive: true });
-            const wrapper = join(localBin, "cliclaw");
-            writeFileSync(wrapper, `#!/bin/sh\nexec node "${resolvedBin}" "$@"\n`, { mode: 0o755 });
-            cleanEnv.PATH = `${localBin}:${cleanEnv.PATH ?? ""}`;
-        }
-        let totalCostUsd = 0;
-        let sessionId;
-        const transcript = [];
         for (let iteration = 1; iteration <= job.maxIterations; iteration++) {
             cronLog("info", `Iteration ${iteration}/${job.maxIterations}`, agentName, job.id);
             // Clear the continue marker before each iteration
@@ -44,40 +104,30 @@ export async function executeRalphWiggumLoop(store, agentName, job, startedAt) {
                 prompt = [
                     `You are executing a scheduled task. Here are your instructions:`,
                     ``,
-                    `${job.task}`,
+                    taskContent,
                     ``,
-                    `Write your output/progress to: ${progressFile}`,
+                    `Write your output/progress to: /instance/workspace/progress.md`,
                     ``,
-                    `If you CANNOT finish the task in this iteration and need to be re-invoked, write "${CONTINUE_MARKER}" anywhere in ${progressFile}. Otherwise, just complete the task normally — no special signal is needed.`,
+                    `If you CANNOT finish the task in this iteration and need to be re-invoked, write "${CONTINUE_MARKER}" anywhere in the progress file. Otherwise, just complete the task normally — no special signal is needed.`,
                 ].join("\n");
             }
             else {
                 prompt = [
-                    `You are continuing a scheduled task. Read your progress file at: ${progressFile}`,
+                    `You are continuing a scheduled task. Read your progress file at: /instance/workspace/progress.md`,
                     `Continue from where you left off.`,
                     ``,
-                    `Original task: ${job.task}`,
+                    `Original task:`,
+                    taskContent,
                     ``,
-                    `If you CANNOT finish the task in this iteration and need to be re-invoked, write "${CONTINUE_MARKER}" anywhere in ${progressFile}. Otherwise, just complete the task normally — no special signal is needed.`,
+                    `If you CANNOT finish the task in this iteration and need to be re-invoked, write "${CONTINUE_MARKER}" anywhere in the progress file. Otherwise, just complete the task normally — no special signal is needed.`,
                 ].join("\n");
             }
-            const conversation = query({
-                prompt,
-                options: {
-                    cwd: workspacePath,
-                    env: cleanEnv,
-                    systemPrompt: { type: "preset", preset: "claude_code" },
-                    settingSources: ["project"],
-                    includePartialMessages: true,
-                    allowedTools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
-                    ...(sessionId ? { resume: sessionId } : {}),
-                },
-            });
+            const { events } = await runContainerIteration(cronInstancePath, prompt, sessionId);
+            // Process events into transcript
             let currentToolInput = "";
-            for await (const event of conversation) {
-                const msg = event;
-                if (msg.type === "stream_event" && msg.event) {
-                    const streamEvent = msg.event;
+            for (const event of events) {
+                if (event.type === "stream_event" && event.event) {
+                    const streamEvent = event.event;
                     if (streamEvent.type === "content_block_start" && streamEvent.content_block?.type === "tool_use") {
                         transcript.push({ type: "tool", name: streamEvent.content_block.name ?? "unknown", done: false });
                         currentToolInput = "";
@@ -109,25 +159,30 @@ export async function executeRalphWiggumLoop(store, agentName, job, startedAt) {
                         currentToolInput = "";
                     }
                 }
-                else if (msg.type === "tool_result") {
+                else if (event.type === "tool_result") {
                     const lastTool = [...transcript].reverse().find((b) => b.type === "tool" && !b.done);
                     if (lastTool && lastTool.type === "tool") {
                         lastTool.done = true;
                     }
                 }
-                else if (msg.type === "result") {
-                    if ("total_cost_usd" in msg) {
-                        totalCostUsd += msg.total_cost_usd ?? 0;
+                else if (event.type === "result") {
+                    if (event.total_cost_usd) {
+                        totalCostUsd += event.total_cost_usd;
                     }
-                    if (msg.session_id) {
-                        sessionId = msg.session_id;
+                    if (event.session_id) {
+                        sessionId = event.session_id;
                     }
                 }
             }
             // Check if the agent needs more iterations by reading the progress file
-            const needsMore = existsSync(progressFile) &&
+            // In container mode, progress is written to workspace/progress.md
+            const containerProgressFile = join(cronInstancePath, "workspace", "progress.md");
+            const needsMore = existsSync(containerProgressFile) &&
+                readFileSync(containerProgressFile, "utf-8").includes(CONTINUE_MARKER);
+            // Also check the original progress file location
+            const needsMoreOriginal = existsSync(progressFile) &&
                 readFileSync(progressFile, "utf-8").includes(CONTINUE_MARKER);
-            if (!needsMore) {
+            if (!needsMore && !needsMoreOriginal) {
                 cronLog("info", `Task completed at iteration ${iteration}`, agentName, job.id);
                 return { completed: true, iterations: iteration, totalCostUsd, transcript };
             }

package/dist/cron/ralph-wiggum.js.map

@@ -1 +1 @@
-{"version":3,"file":"ralph-wiggum.js","sourceRoot":"","sources":["../../src/cron/ralph-wiggum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAmB,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACtF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC5G,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAahD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAAiB,EACjB,SAAiB,EACjB,GAAkB,EAClB,SAAkB;IAElB,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAClC,kBAAkB,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAE7E,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAE5D,IAAI,CAAC;QACH,gCAAgC;QAChC,MAAM,QAAQ,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QACpC,OAAO,QAAQ,CAAC,UAAU,CAAC;QAE3B,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC9E,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;YAC7C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAC1C,aAAa,CAAC,OAAO,EAAE,yBAAyB,WAAW,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACxF,QAAQ,CAAC,IAAI,GAAG,GAAG,QAAQ,IAAI,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QACvD,CAAC;QAED,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,SAA6B,CAAC;QAClC,MAAM,UAAU,GAAsB,EAAE,CAAC;QAEzC,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,IAAI,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,EAAE,CAAC;YACpE,OAAO,CAAC,MAAM,EAAE,aAAa,SAAS,IAAI,GAAG,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAElF,kDAAkD;YAClD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBACpD,IAAI,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;oBACtC,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC3F,CAAC;YACH,CAAC;YAED,IAAI,MAAc,CAAC;YACnB,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;gBACpB,MAAM,GAAG;oBACP,iEAAiE;oBACjE,EAAE;oBACF,GAAG,GAAG,CAAC,IAAI,EAAE;oBACb,EAAE;oBACF,kCAAkC,YAAY,EAAE;oBAChD,EAAE;oBACF,qFAAqF,eAAe,iBAAiB,YAAY,6EAA6E;iBAC/M,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG;oBACP,oEAAoE,YAAY,EAAE;oBAClF,mCAAmC;oBACnC,EAAE;oBACF,kBAAkB,GAAG,CAAC,IAAI,EAAE;oBAC5B,EAAE;oBACF,qFAAqF,eAAe,iBAAiB,YAAY,6EAA6E;iBAC/M,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;YAED,MAAM,YAAY,GAAG,KAAK,CAAC;gBACzB,MAAM;gBACN,OAAO,EAAE;oBACP,GAAG,EAAE,aAAa;oBAClB,GAAG,EAAE,QAAQ;oBACb,YAAY,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,MAAM,EAAE,aAAsB,EAAE;oBACzE,cAAc,EAAE,CAAC,SAAS,CAAC;oBAC3B,sBAAsB,EAAE,IAAI;oBAC5B,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;oBAC/D,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC5C;aACF,CAAC,CAAC;YAEH,IAAI,gBAAgB,GAAG,EAAE,CAAC;YAE1B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;gBACvC,MAAM,GAAG,GAAG,KAAmB,CAAC;gBAEhC,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,IAAK,GAAW,CAAC,KAAK,EAAE,CAAC;oBACtD,MAAM,WAAW,GAAI,GAAW,CAAC,KAIhC,CAAC;oBAEF,IAAI,WAAW,CAAC,IAAI,KAAK,qBAAqB,IAAI,WAAW,CAAC,aAAa,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;wBACjG,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,aAAa,CAAC,IAAI,IAAI,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;wBAClG,gBAAgB,GAAG,EAAE,CAAC;oBACxB,CAAC;yBAAM,IAAI,WAAW,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;wBACtD,IAAI,WAAW,CAAC,KAAK,EAAE,IAAI,KAAK,YAAY,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;4BACvE,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;4BAC/C,IAAI,IAAI,EAAE,IAAI,KAAK,WAAW,EAAE,CAAC;gCAC/B,IAAI,CAAC,OAAO,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;4BACzC,CAAC;iCAAM,CAAC;gCACN,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;4BAC1E,CAAC;wBACH,CAAC;6BAAM,IAAI,WAAW,CAAC,KAAK,EAAE,IAAI,KAAK,kBAAkB,IAAI,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;4BAC5F,gBAAgB,IAAI,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC;wBACrD,CAAC;oBACH,CAAC;yBAAM,IAAI,WAAW,CAAC,IAAI,KAAK,oBAAoB,IAAI,gBAAgB,EAAE,CAAC;wBACzE,MAAM,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;wBACrF,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;4BACzC,IAAI,CAAC;gCACH,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;4BAChE,CAAC;4BAAC,MAAM,CAAC;gCACP,kBAAkB;4BACpB,CAAC;wBACH,CAAC;wBACD,gBAAgB,GAAG,EAAE,CAAC;oBACxB,CAAC;gBACH,CAAC;qBAAM,IAAK,GAAW,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBAC/C,MAAM,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;oBACrF,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;wBACzC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;oBACvB,CAAC;gBACH,CAAC;qBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACjC,IAAI,gBAAgB,IAAI,GAAG,EAAE,CAAC;wBAC5B,YAAY,IAAK,GAAG,CAAC,cAAyB,IAAI,CAAC,CAAC;oBACtD,CAAC;oBACD,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;wBACnB,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC;oBAC7B,CAAC;gBACH,CAAC;YACH,CAAC;YAED,wEAAwE;YACxE,MAAM,SAAS,GAAG,UAAU,CAAC,YAAY,CAAC;gBACxC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;YAEhE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,EAAE,+BAA+B,SAAS,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC/E,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;YAC9E,CAAC;YAED,OAAO,CAAC,MAAM,EAAE,iCAAiC,eAAe,0BAA0B,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACjH,CAAC;QAED,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,CAAC,aAAa,WAAW,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACpF,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IACvF,CAAC;YAAS,CAAC;QACT,kBAAkB,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}
+{"version":3,"file":"ralph-wiggum.js","sourceRoot":"","sources":["../../src/cron/ralph-wiggum.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitalpresence/cliclaw",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "type": "module",
   "bin": {
     "cliclaw": "./dist/cli.js"
@@ -13,7 +13,7 @@
     "mime-types": "^3.0.2",
     "node-cron": "^4.2.1",
     "open": "^10.1.0",
-    "@digitalpresence/cliclaw-auth": "0.1.1"
+    "@digitalpresence/cliclaw-auth": "0.2.0"
   },
   "devDependencies": {
     "@types/mime-types": "^3.0.1",

package/src/agent/crud.ts

@@ -16,8 +16,7 @@ export async function handleAgentCreate(
     name,
     displayName,
     role,
-    permissions: [],
-    memory: [],
+    integrations: [],
     cronJobs: [],
     createdAt: now,
     updatedAt: now,
@@ -32,8 +31,8 @@ export async function handleAgentList(store: AgentStore): Promise<void> {
     agents.map((a) => ({
       name: a.name,
       displayName: a.displayName,
-      permissions: a.permissions.length,
-      memory: a.memory.length,
+      integrations: a.integrations.length,
+      cronJobs: a.cronJobs.length,
     })),
   );
 }

package/src/agent/memory.ts

@@ -32,7 +32,7 @@ export async function handleAgentMemoryAdd(
   const importance = opts?.importance ? (parseInt(opts.importance, 10) as 1 | 2 | 3) : 2;
 
   const entry = memoryStore.add(fact, { tags, source, importance });
-  store.regenerateClaudeMd(name);
+  store.regenerateContextMd(name);
 
   outputJson({ status: "added", name, entry });
 }
@@ -52,14 +52,14 @@ export async function handleAgentMemoryRemove(
 
   if (tag) {
     const removed = memoryStore.removeByTag(tag);
-    store.regenerateClaudeMd(name);
+    store.regenerateContextMd(name);
     outputJson({ status: "removed", name, removedByTag: tag, count: removed });
   } else if (id) {
     const removed = memoryStore.remove(id);
     if (!removed) {
       outputError("memory_not_found", `Memory "${id}" not found`);
     }
-    store.regenerateClaudeMd(name);
+    store.regenerateContextMd(name);
     outputJson({ status: "removed", name, id });
   } else {
     outputError("invalid_args", "Provide an ID or --tag to remove");
@@ -89,7 +89,7 @@ export async function handleAgentMemoryClear(store: AgentStore, name: string): P
 
   const memoryStore = store.getMemoryStore(name);
   const cleared = memoryStore.clear();
-  store.regenerateClaudeMd(name);
+  store.regenerateContextMd(name);
 
   outputJson({ status: "cleared", name, cleared });
 }

package/src/agent/permissions.ts

@@ -5,50 +5,47 @@ export async function handleAgentGrant(
   store: AgentStore,
   name: string,
   integration: string,
-  account: string,
 ): Promise<void> {
   const agent = store.get(name);
   if (!agent) {
     outputError("agent_not_found", `Agent "${name}" not found`);
+    return;
   }
 
-  const exists = agent.permissions.some(
-    (p) => p.integration === integration && p.account === account,
-  );
-  if (exists) {
-    outputError("permission_exists", `Agent "${name}" already has ${integration}:${account}`);
+  if (agent.integrations.includes(integration)) {
+    outputError("integration_exists", `Agent "${name}" already has ${integration}`);
+    return;
   }
 
-  agent.permissions.push({ integration, account });
+  agent.integrations.push(integration);
   agent.updatedAt = new Date().toISOString();
   store.save(agent);
-  store.regenerateClaudeMd(name);
+  store.regenerateContextMd(name);
 
-  outputJson({ status: "granted", name, integration, account });
+  outputJson({ status: "granted", name, integration });
 }
 
 export async function handleAgentRevoke(
   store: AgentStore,
   name: string,
   integration: string,
-  account: string,
 ): Promise<void> {
   const agent = store.get(name);
   if (!agent) {
     outputError("agent_not_found", `Agent "${name}" not found`);
+    return;
   }
 
-  const idx = agent.permissions.findIndex(
-    (p) => p.integration === integration && p.account === account,
-  );
+  const idx = agent.integrations.indexOf(integration);
   if (idx === -1) {
-    outputError("permission_not_found", `Agent "${name}" does not have ${integration}:${account}`);
+    outputError("integration_not_found", `Agent "${name}" does not have ${integration}`);
+    return;
   }
 
-  agent.permissions.splice(idx, 1);
+  agent.integrations.splice(idx, 1);
   agent.updatedAt = new Date().toISOString();
   store.save(agent);
-  store.regenerateClaudeMd(name);
+  store.regenerateContextMd(name);
 
-  outputJson({ status: "revoked", name, integration, account });
+  outputJson({ status: "revoked", name, integration });
 }

package/src/cli.ts

@@ -10,6 +10,7 @@ import { registerCalendarCommands } from "./commands/calendar.js";
 import { registerFormsCommands } from "./commands/forms.js";
 import { registerAgentCommands } from "./commands/agent.js";
 import { registerCronCommands } from "./commands/cron.js";
+import { registerInitCommand } from "./commands/init.js";
 import { outputError } from "./lib/output.js";
 
 function getClientManager(): { clientManager: OAuthClientManager; port: number } {
@@ -35,6 +36,7 @@ registerCalendarCommands(program, getClientManager);
 registerFormsCommands(program, getClientManager);
 registerAgentCommands(program, () => new AgentStore(getAgentsDir()));
 registerCronCommands(program, () => new AgentStore(getAgentsDir()));
+registerInitCommand(program);
 
 program.parseAsync().catch((err) => {
   outputError("cli_error", err instanceof Error ? err.message : String(err));

package/src/commands/agent.ts

@@ -50,22 +50,20 @@ export function registerAgentCommands(program: Command, getAgentStore: AgentStor
 
   agent
     .command("grant")
-    .description("Grant a permission to an agent")
+    .description("Grant an integration to an agent")
     .argument("<name>", "Agent name")
     .requiredOption("--integration <integration>", "Integration name (gmail, gdrive)")
-    .requiredOption("--account <account>", "Account name")
     .action(async (name, opts) => {
-      await handleAgentGrant(getAgentStore(), name, opts.integration, opts.account);
+      await handleAgentGrant(getAgentStore(), name, opts.integration);
     });
 
   agent
     .command("revoke")
-    .description("Revoke a permission from an agent")
+    .description("Revoke an integration from an agent")
     .argument("<name>", "Agent name")
     .requiredOption("--integration <integration>", "Integration name (gmail, gdrive)")
-    .requiredOption("--account <account>", "Account name")
     .action(async (name, opts) => {
-      await handleAgentRevoke(getAgentStore(), name, opts.integration, opts.account);
+      await handleAgentRevoke(getAgentStore(), name, opts.integration);
     });
 
   const memory = agent

package/src/commands/cron.ts

@@ -22,17 +22,17 @@ export function registerCronCommands(program: Command, getAgentStore: AgentStore
     .description("Add a cron job to an agent")
     .argument("<agent>", "Agent name")
     .requiredOption("--schedule <schedule>", "Cron expression (e.g. \"0 9 * * *\")")
-    .requiredOption("--task <task>", "Natural language task instructions")
+    .requiredOption("--task <task>", "Task description (written to markdown file)")
+    .option("--task-file <taskFile>", "Custom task file name (default: {jobId}.md)")
     .option("--max-iterations <n>", "Maximum loop iterations", "10")
-    .option("--completion-promise <word>", "Completion word", "TASK_COMPLETE")
     .action(async (agent, opts) => {
       await handleCronAdd(
         getAgentStore(),
         agent,
         opts.schedule,
+        opts.taskFile || "",
         opts.task,
         parseInt(opts.maxIterations, 10),
-        opts.completionPromise,
       );
     });
 
@@ -91,7 +91,7 @@ export function registerCronCommands(program: Command, getAgentStore: AgentStore
       const job = config!.cronJobs.find((j) => j.id === jobId);
       if (!job) outputError("job_not_found", `Job "${jobId}" not found`);
 
-      cronLog("info", `Manual trigger: ${job!.task}`, agent, jobId);
+      cronLog("info", `Manual trigger: ${job!.taskFile}`, agent, jobId);
 
       const startedAt = new Date().toISOString();
       try {

package/src/commands/init.ts

@@ -0,0 +1,22 @@
+import { Command } from "commander";
+import { writeFileSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
+import { generateUniversalClaudeMd, getConfigDir } from "@digitalpresence/cliclaw-auth";
+import { outputJson } from "../lib/output.js";
+
+export function registerInitCommand(program: Command): void {
+  program
+    .command("init")
+    .description("Initialize/update the universal CLAUDE.md for all agents")
+    .action(async () => {
+      const configDir = getConfigDir();
+      if (!existsSync(configDir)) {
+        mkdirSync(configDir, { recursive: true });
+      }
+
+      const claudeMdPath = join(configDir, "CLAUDE.md");
+      writeFileSync(claudeMdPath, generateUniversalClaudeMd(), "utf-8");
+
+      outputJson({ status: "initialized", path: claudeMdPath });
+    });
+}

package/src/cron/daemon.ts

@@ -51,7 +51,7 @@ export async function startDaemon(store: AgentStore): Promise<void> {
       }
 
       running.add(key);
-      cronLog("info", `Executing: ${job.task}`, agentName, job.id);
+      cronLog("info", `Executing: ${job.taskFile}`, agentName, job.id);
       const startedAt = new Date().toISOString();
 
       try {
@@ -87,7 +87,7 @@ export async function startDaemon(store: AgentStore): Promise<void> {
     });
 
     schedules.set(key, task);
-    cronLog("info", `Scheduled: "${job.task}" at ${job.schedule}`, agentName, job.id);
+    cronLog("info", `Scheduled: "${job.taskFile}" at ${job.schedule}`, agentName, job.id);
   }
 
   function syncSchedules(): void {

package/src/cron/handlers.ts

@@ -1,4 +1,6 @@
 import { randomBytes } from "crypto";
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
 import type { AgentStore, CronJobConfig } from "@digitalpresence/cliclaw-auth";
 import { outputJson, outputError } from "../lib/output.js";
 
@@ -6,25 +8,34 @@ export async function handleCronAdd(
   store: AgentStore,
   agentName: string,
   schedule: string,
-  task: string,
+  taskFile: string,
+  taskContent: string,
   maxIterations: number,
-  completionPromise: string,
 ): Promise<void> {
   const agent = store.get(agentName);
   if (!agent) outputError("agent_not_found", `Agent "${agentName}" not found`);
 
+  const jobId = randomBytes(6).toString("hex");
+
+  // Write task markdown file
+  const cronTasksDir = join(store.workspacePath(agentName), "cron-tasks");
+  if (!existsSync(cronTasksDir)) {
+    mkdirSync(cronTasksDir, { recursive: true });
+  }
+  const taskFilePath = taskFile || `${jobId}.md`;
+  writeFileSync(join(cronTasksDir, taskFilePath), taskContent, "utf-8");
+
   const job: CronJobConfig = {
-    id: randomBytes(6).toString("hex"),
+    id: jobId,
     schedule,
-    task,
+    taskFile: taskFilePath,
     maxIterations,
-    completionPromise,
     enabled: true,
     createdAt: new Date().toISOString(),
   };
 
   store.addCronJob(agentName, job);
-  outputJson({ status: "added", jobId: job.id, schedule, task });
+  outputJson({ status: "added", jobId: job.id, schedule, taskFile: taskFilePath });
 }
 
 export async function handleCronRemove(