codekin 0.6.4 → 0.7.0

package/server/dist/orchestrator-manager.d.ts

@@ -7,8 +7,18 @@
  */
 import type { SessionManager } from './session-manager.js';
 export declare const ORCHESTRATOR_DIR: string;
+/**
+ * Bump this whenever CLAUDE_MD_TEMPLATE changes. Already-seeded CLAUDE.md
+ * files carrying an older (or no) version stamp are refreshed on boot —
+ * without this, installs keep running on stale orchestrator instructions
+ * forever. CLAUDE.md is system-managed; user memory lives in PROFILE.md,
+ * REPOS.md and journal/, which are never overwritten.
+ */
+export declare const CLAUDE_MD_TEMPLATE_VERSION = 2;
 /** Ensure the orchestrator workspace directory exists with starter files. */
 export declare function ensureOrchestratorDir(): void;
+/** Parse the template version stamp from a seeded CLAUDE.md; 0 when absent. */
+export declare function readTemplateVersion(path: string): number;
 /** Get or create a stable session UUID that persists across restarts. */
 export declare function getOrCreateOrchestratorId(): string;
 /** Check if a session is the orchestrator session. */

package/server/dist/orchestrator-manager.js

@@ -29,7 +29,16 @@ Agent ${AGENT_DISPLAY_NAME} tracks repositories you work with in Codekin.
 ## Active Repos
 (none yet — ${AGENT_DISPLAY_NAME} will populate this as you work)
 `;
-const CLAUDE_MD_TEMPLATE = `# Agent ${AGENT_DISPLAY_NAME} — Codekin Orchestrator
+/**
+ * Bump this whenever CLAUDE_MD_TEMPLATE changes. Already-seeded CLAUDE.md
+ * files carrying an older (or no) version stamp are refreshed on boot —
+ * without this, installs keep running on stale orchestrator instructions
+ * forever. CLAUDE.md is system-managed; user memory lives in PROFILE.md,
+ * REPOS.md and journal/, which are never overwritten.
+ */
+export const CLAUDE_MD_TEMPLATE_VERSION = 2;
+const CLAUDE_MD_TEMPLATE = `<!-- codekin-template-version: ${CLAUDE_MD_TEMPLATE_VERSION} -->
+# Agent ${AGENT_DISPLAY_NAME} — Codekin Orchestrator
 
 You are ${AGENT_DISPLAY_NAME}, a calm and friendly ops manager inside Codekin.
 You help users keep their repositories healthy, their workflows running
@@ -129,6 +138,13 @@ Fields:
 - **useWorktree**: true (default) — runs in an isolated git worktree
 - **model**: Optional model override (e.g. "claude-sonnet-4-6")
 - **allowedTools**: Optional array of tool patterns to override defaults (advanced)
+- **timeoutMs**: Optional working-time budget in ms (default 1800000 = 30 min,
+  range 1 min – 4 h). Time spent blocked on an approval does not count.
+  Raise this for large tasks (big refactors, full test suites).
+
+The spawn response includes a \`worktree\` field ("active", "failed", or
+"none") and \`worktreePath\`. If worktree is "failed", the child works
+directly in the main repo directory — watch it more closely.
 
 ### What Child Sessions Can Do Automatically
 Child sessions have a broad set of pre-approved tools for standard dev work:
@@ -136,6 +152,9 @@ Child sessions have a broad set of pre-approved tools for standard dev work:
 - **Git & GitHub**: git (all subcommands), gh (PRs, issues, runs)
 - **Package managers**: npm, npx, yarn, pnpm, bun
 - **Build tools**: node, tsc, eslint, prettier, cargo, go, make, pip
+- **Python**: python3, pytest
+- **Text/data**: sed, rg, jq
+- **File management** (non-destructive): mkdir, cp, mv, touch
 - **Filesystem** (read-only): ls, cat, head, tail, sort, diff, tree, wc, which, file
 
 They do NOT have access to destructive commands (rm, sudo, docker,
@@ -158,6 +177,12 @@ curl -s "http://localhost:$CODEKIN_PORT/api/orchestrator/children" \\
 # Get specific child session
 curl -s "http://localhost:$CODEKIN_PORT/api/orchestrator/children/SESSION_ID" \\
   -H "Authorization: Bearer $CODEKIN_AUTH_TOKEN"
+
+# Read the tail of a child's transcript (what Claude actually output).
+# Useful when a child stops with "Completion not verified" or gets stuck.
+# ?limit caps the returned characters (default 5000, max 50000).
+curl -s "http://localhost:$CODEKIN_PORT/api/orchestrator/children/SESSION_ID/transcript?limit=10000" \\
+  -H "Authorization: Bearer $CODEKIN_AUTH_TOKEN"
 \`\`\`
 
 ## Scheduling Reminders & Recurring Tasks
@@ -171,16 +196,26 @@ You have access to CronCreate, CronDelete, and CronList tools for in-session sch
 Examples:
 - Every morning at 9am: \`cron: "3 9 * * *"\`, \`prompt: "Check for new reports"\`
 - One-shot reminder: \`cron: "0 14 22 3 *"\`, \`prompt: "Follow up on deploy"\`, \`recurring: false\`
-- Every 30 minutes: \`cron: "*/30 * * * *"\`, \`prompt: "Check child session status"\`
+
+You do NOT need a recurring cron to watch child sessions — the server
+pushes you a notification the moment a child blocks on an approval,
+finishes, fails, or times out. Use crons for reminders and scheduled
+work, not for polling.
 
 Important: The \`cron\` parameter must be a plain string like \`"0 9 * * *"\`, NOT an object.
 Jobs only live in this session — they are lost when the session restarts. Recurring jobs auto-expire after 7 days.
 
 ## Monitoring Sessions
-After spawning a session:
-- Keep an eye on its progress
-- If the session completes but didn't do the final step (create PR, push,
-  deploy), send it a follow-up instruction to finish
+You receive push notifications about your child sessions automatically:
+- **Blocked**: the child is waiting on a tool approval or question — the
+  notification includes the requestId and the exact curl to respond
+- **Stopped**: the child completed, failed, or timed out
+
+The server also verifies completion against ground truth (does the PR /
+pushed branch actually exist?) and nudges the child once if the final
+step is missing. When a "Stopped" notification carries a
+"Completion not verified" note, the final step still didn't land —
+inspect the worktree and finish it or respawn.
 - If the session gets stuck or fails, inform the user and suggest next steps
 - When done, summarize what was accomplished
 
@@ -188,31 +223,31 @@ After spawning a session:
 Sessions can get stuck waiting for tool approvals or user answers. You can
 discover and unblock them:
 
-\\\`\\\`\\\`bash
+\`\`\`bash
 # List all sessions with pending prompts
 curl -s "http://localhost:$CODEKIN_PORT/api/orchestrator/sessions/pending-prompts" \\
   -H "Authorization: Bearer $CODEKIN_AUTH_TOKEN"
-\\\`\\\`\\\`
+\`\`\`
 
-Returns sessions with their pending prompts, including the \\\`requestId\\\`,
-\\\`toolName\\\`, and \\\`promptType\\\` ("permission" or "question").
+Returns sessions with their pending prompts, including the \`requestId\`,
+\`toolName\`, and \`promptType\` ("permission" or "question").
 
 ### Giving Approvals to Stuck Sessions
 If a child session is blocked on a tool approval and you're confident it's
 safe, you can approve it directly:
 
-\\\`\\\`\\\`bash
+\`\`\`bash
 curl -s -X POST "http://localhost:$CODEKIN_PORT/api/orchestrator/sessions/SESSION_ID/respond" \\
   -H "Authorization: Bearer $CODEKIN_AUTH_TOKEN" \\
   -H "Content-Type: application/json" \\
   -d '{"requestId": "REQUEST_ID", "value": "allow"}'
-\\\`\\\`\\\`
+\`\`\`
 
-Values: \\\`"allow"\\\`, \\\`"deny"\\\`, \\\`"always_allow"\\\`, or free text for question prompts.
+Values: \`"allow"\`, \`"deny"\`, \`"always_allow"\`, or free text for question prompts.
 
 **Guidelines for giving approvals:**
 - Only approve tools you understand — if unsure, ask the user
-- Prefer \\\`"allow"\\\` over \\\`"always_allow"\\\` for child sessions
+- Prefer \`"allow"\` over \`"always_allow"\` for child sessions
 - Never approve destructive commands (rm -rf, git push --force, DROP TABLE)
   without user confirmation
 - For question prompts, provide a reasonable answer or ask the user
@@ -273,9 +308,9 @@ Users can manage trust directly in chat:
 4. Read skill-profile.json for guidance style adaptation
 5. Check for new audit reports that may have landed
 6. Check for decisions pending outcome assessment
-7. **Re-establish cron jobs** — cron jobs do not survive session restarts, so always re-create your standard recurring checks on startup:
+7. **Re-establish cron jobs** — cron jobs do not survive session restarts, so re-create your scheduled work on startup:
    - Report check: \`cron: "3 9 * * *"\`, \`prompt: "Check for new audit reports across all managed repos and triage any new findings"\`
-   - Child session monitor: \`cron: "*/30 * * * *"\`, \`prompt: "Check child session status and unblock any stuck sessions"\`
+   - Do NOT create a child-session polling cron — the server pushes blocked/terminal notifications to you in realtime.
 8. Greet the user with a brief, friendly status update
 
 ### Greeting Guidelines
@@ -294,16 +329,33 @@ export function ensureOrchestratorDir() {
     const journalDir = join(ORCHESTRATOR_DIR, 'journal');
     if (!existsSync(journalDir))
         mkdirSync(journalDir, { recursive: true });
-    // Seed files only if they don't exist (preserve user edits)
+    // Seed memory files only if they don't exist (preserve user edits)
     const seeds = [
         [join(ORCHESTRATOR_DIR, 'PROFILE.md'), PROFILE_TEMPLATE],
         [join(ORCHESTRATOR_DIR, 'REPOS.md'), REPOS_TEMPLATE],
-        [join(ORCHESTRATOR_DIR, 'CLAUDE.md'), CLAUDE_MD_TEMPLATE],
     ];
     for (const [path, content] of seeds) {
         if (!existsSync(path))
             writeFileSync(path, content, 'utf-8');
     }
+    // CLAUDE.md is system-managed: refresh it whenever the embedded template
+    // version is older than the current one (or missing entirely).
+    const claudeMdPath = join(ORCHESTRATOR_DIR, 'CLAUDE.md');
+    if (readTemplateVersion(claudeMdPath) < CLAUDE_MD_TEMPLATE_VERSION) {
+        writeFileSync(claudeMdPath, CLAUDE_MD_TEMPLATE, 'utf-8');
+    }
+}
+/** Parse the template version stamp from a seeded CLAUDE.md; 0 when absent. */
+export function readTemplateVersion(path) {
+    try {
+        if (!existsSync(path))
+            return 0;
+        const match = /<!-- codekin-template-version: (\d+) -->/.exec(readFileSync(path, 'utf-8'));
+        return match ? parseInt(match[1], 10) : 0;
+    }
+    catch {
+        return 0;
+    }
 }
 /** Get or create a stable session UUID that persists across restarts. */
 export function getOrCreateOrchestratorId() {

package/server/dist/orchestrator-manager.js.map

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

package/server/dist/orchestrator-monitor.d.ts

@@ -55,9 +55,15 @@ export declare class OrchestratorMonitor {
     private addNotification;
     /** Deliver a notification to the orchestrator chat session. */
     private deliverToOrchestrator;
-    /** Discover repo paths from REPOS_ROOT. */
+    /** Discover repo paths from REPOS_ROOT (see discoverRepoPathsUnder). */
     private discoverRepoPaths;
 }
+/**
+ * Discover git repositories under a root directory, recursing one level into
+ * non-repo directories so org-style layouts (root/org/repo) are picked up
+ * alongside flat ones (root/repo). Unreadable entries are skipped.
+ */
+export declare function discoverRepoPathsUnder(root: string): string[];
 /**
  * Suppress passive-repo alerts unless at least one workflow is enabled for the
  * repo — there's nothing to "de-schedule" otherwise, so the nag is noise.

package/server/dist/orchestrator-monitor.js

@@ -10,6 +10,7 @@ import { join } from 'path';
 import { scanRepoReports } from './orchestrator-reports.js';
 import { runAgingCycle, getPendingOutcomeAssessments } from './orchestrator-learning.js';
 import { getOrchestratorSessionId } from './orchestrator-manager.js';
+import { getOrchestratorOutbox } from './orchestrator-outbox.js';
 import { REPOS_ROOT, getAgentDisplayName } from './config.js';
 import { loadWorkflowConfig } from './workflow-config.js';
 // ---------------------------------------------------------------------------
@@ -117,6 +118,13 @@ export class OrchestratorMonitor {
     }
     /** Periodic poll — check for new reports and idle repos. */
     async poll() {
+        // Skip the entire poll if the rate-limit circuit breaker is open. This
+        // is the dominant source of background API calls; continuing to poke
+        // the orchestrator session during a cooldown just deepens the hole.
+        if (this.sessions.isRateLimited()) {
+            console.log('[orchestrator-monitor] rate-limit circuit breaker open — skipping poll');
+            return;
+        }
         const repoPaths = this.discoverRepoPaths();
         // Check for new reports
         this.checkNewReports(repoPaths);
@@ -207,41 +215,76 @@ export class OrchestratorMonitor {
     }
     /** Deliver a notification to the orchestrator chat session. */
     deliverToOrchestrator(notification) {
+        // Don't push more API work at the orchestrator while the rate-limit
+        // circuit breaker is open. The notification stays in the buffer and
+        // can still be inspected via the API; it just isn't replayed as a
+        // chat message until the cooldown expires.
+        if (this.sessions.isRateLimited())
+            return;
         const orchestratorId = getOrchestratorSessionId(this.sessions);
         if (!orchestratorId)
             return;
         const session = this.sessions.get(orchestratorId);
-        if (!session?.claudeProcess?.isAlive())
+        if (!session?.claudeProcess?.isAlive()) {
+            // Orchestrator not running — hand the notification to the persistent
+            // outbox so it is replayed (as a digest) when the session comes back,
+            // instead of rotting in the in-memory buffer forever.
+            getOrchestratorOutbox().enqueue({
+                label: notification.severity.toUpperCase(),
+                title: notification.title,
+                body: notification.body,
+            });
+            notification.delivered = true;
             return;
+        }
         // Send as a system message that the orchestrator will see and respond to
         const message = `[Agent ${getAgentDisplayName()} Notification — ${notification.severity.toUpperCase()}]\n${notification.title}\n${notification.body}`;
         this.sessions.sendInput(orchestratorId, message);
         notification.delivered = true;
     }
-    /** Discover repo paths from REPOS_ROOT. */
+    /** Discover repo paths from REPOS_ROOT (see discoverRepoPathsUnder). */
     discoverRepoPaths() {
-        if (!existsSync(REPOS_ROOT))
-            return [];
-        try {
-            return readdirSync(REPOS_ROOT)
-                .map(name => join(REPOS_ROOT, name))
-                .filter(p => {
-                try {
-                    return statSync(p).isDirectory() && existsSync(join(p, '.git'));
-                }
-                catch {
-                    return false;
-                }
-            });
-        }
-        catch {
-            return [];
-        }
+        return discoverRepoPathsUnder(REPOS_ROOT);
     }
 }
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
+/**
+ * Discover git repositories under a root directory, recursing one level into
+ * non-repo directories so org-style layouts (root/org/repo) are picked up
+ * alongside flat ones (root/repo). Unreadable entries are skipped.
+ */
+export function discoverRepoPathsUnder(root) {
+    if (!existsSync(root))
+        return [];
+    const repos = [];
+    const scan = (dir, depth) => {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const name of entries) {
+            const p = join(dir, name);
+            try {
+                if (!statSync(p).isDirectory())
+                    continue;
+                if (existsSync(join(p, '.git')))
+                    repos.push(p);
+                else if (depth < 2)
+                    scan(p, depth + 1);
+            }
+            catch {
+                // unreadable entry — skip
+            }
+        }
+    };
+    scan(root, 1);
+    return repos;
+}
 /**
  * Suppress passive-repo alerts unless at least one workflow is enabled for the
  * repo — there's nothing to "de-schedule" otherwise, so the nag is noise.

package/server/dist/orchestrator-monitor.js.map

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

package/server/dist/orchestrator-notify.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Shared helper for delivering notification messages to the orchestrator
+ * (parent) session via the Claude stdin channel.
+ *
+ * The rendered format is:
+ *   [Agent <name> Notification — LABEL]
+ *   <title>
+ *   <body>
+ *
+ * which is the established style used by the proactive monitor and surfaced
+ * inside the orchestrator chat.
+ *
+ * When the recipient session cannot be reached (missing or its Claude
+ * process is not running), the notification is queued in the persistent
+ * outbox and replayed as a digest once the orchestrator is back.
+ */
+import type { SessionManager } from './session-manager.js';
+export interface OrchestratorNotifyArgs {
+    /** Recipient session ID (the parent / orchestrator session). */
+    parentSessionId: string;
+    /** Bracket-suffix label (e.g. 'ACTION', 'ALERT', 'Child Session Stopped'). */
+    label: string;
+    /** First body line — short headline. */
+    title: string;
+    /** Remaining body — multi-line is fine. */
+    body: string;
+}
+/** Minimal outbox surface needed by this helper (injectable for tests). */
+export interface NotificationOutbox {
+    enqueue(args: {
+        label: string;
+        title: string;
+        body: string;
+    }): void;
+}
+/**
+ * Send a notification to the parent session via Claude stdin.
+ * Returns true when delivered immediately OR queued in the outbox for
+ * replay (the outbox owns delivery from that point on). Returns false only
+ * when queueing itself failed.
+ */
+export declare function sendOrchestratorNotification(sessions: SessionManager, args: OrchestratorNotifyArgs, outbox?: NotificationOutbox): boolean;

package/server/dist/orchestrator-notify.js

@@ -0,0 +1,42 @@
+/**
+ * Shared helper for delivering notification messages to the orchestrator
+ * (parent) session via the Claude stdin channel.
+ *
+ * The rendered format is:
+ *   [Agent <name> Notification — LABEL]
+ *   <title>
+ *   <body>
+ *
+ * which is the established style used by the proactive monitor and surfaced
+ * inside the orchestrator chat.
+ *
+ * When the recipient session cannot be reached (missing or its Claude
+ * process is not running), the notification is queued in the persistent
+ * outbox and replayed as a digest once the orchestrator is back.
+ */
+import { getAgentDisplayName } from './config.js';
+import { getOrchestratorOutbox } from './orchestrator-outbox.js';
+/**
+ * Send a notification to the parent session via Claude stdin.
+ * Returns true when delivered immediately OR queued in the outbox for
+ * replay (the outbox owns delivery from that point on). Returns false only
+ * when queueing itself failed.
+ */
+export function sendOrchestratorNotification(sessions, args, outbox = getOrchestratorOutbox()) {
+    const session = sessions.get(args.parentSessionId);
+    if (session?.claudeProcess?.isAlive()) {
+        const message = `[Agent ${getAgentDisplayName()} Notification — ${args.label}]\n${args.title}\n${args.body}`;
+        sessions.sendInput(args.parentSessionId, message);
+        return true;
+    }
+    // Parent unreachable — queue for replay when the orchestrator comes back.
+    try {
+        outbox.enqueue({ label: args.label, title: args.title, body: args.body });
+        return true;
+    }
+    catch (err) {
+        console.warn('[orchestrator-notify] failed to queue notification:', err);
+        return false;
+    }
+}
+//# sourceMappingURL=orchestrator-notify.js.map

package/server/dist/orchestrator-notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-notify.js","sourceRoot":"","sources":["../orchestrator-notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAkBhE;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAAwB,EACxB,IAA4B,EAC5B,SAA6B,qBAAqB,EAAE;IAEpD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IAClD,IAAI,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,UAAU,mBAAmB,EAAE,mBAAmB,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,EAAE,CAAA;QAC5G,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;QACjD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,0EAA0E;IAC1E,IAAI,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QACzE,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,qDAAqD,EAAE,GAAG,CAAC,CAAA;QACxE,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}

package/server/dist/orchestrator-outbox.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Persistent outbox for orchestrator notifications.
+ *
+ * When a notification cannot be delivered to the orchestrator session
+ * (Claude process not running), it is queued here and replayed as a single
+ * digest message once the orchestrator is back. The queue survives server
+ * restarts via a JSON file in the orchestrator workspace.
+ */
+import type { SessionManager } from './session-manager.js';
+export interface OutboxItem {
+    id: string;
+    label: string;
+    title: string;
+    body: string;
+    queuedAt: string;
+}
+export declare class OrchestratorOutbox {
+    private items;
+    private filePath;
+    private flushTimer;
+    constructor(filePath?: string);
+    /** Number of queued (undelivered) notifications. */
+    size(): number;
+    /** Queue a notification for later delivery. Oldest items are dropped at the cap. */
+    enqueue(args: {
+        label: string;
+        title: string;
+        body: string;
+    }): void;
+    /**
+     * Attempt to deliver all queued items to the orchestrator session as a
+     * single digest message. No-op when the queue is empty, the orchestrator
+     * session is missing / not running, or the rate-limit circuit breaker is
+     * open. Returns the number of items delivered.
+     */
+    flush(sessions: SessionManager): number;
+    /** Start a background timer that periodically attempts a flush. */
+    startFlusher(sessions: SessionManager, intervalMs?: number): void;
+    /** Stop the background flusher. */
+    stopFlusher(): void;
+    private buildDigest;
+    private load;
+    private persist;
+}
+/** Get the process-wide outbox instance. */
+export declare function getOrchestratorOutbox(): OrchestratorOutbox;
+/** Test-only: replace the singleton (pass null to reset). */
+export declare function setOrchestratorOutboxForTest(outbox: OrchestratorOutbox | null): void;