autodev-cli 1.4.0 → 1.4.3

package/out/prompt.d.ts

@@ -0,0 +1,12 @@
+import { Task } from './todo';
+/**
+ * Build the prompt string for a task, and write the split files:
+ *   .autodev/AGENT_PROFILE.md                  — profile instructions (rebuilt fresh)
+ *   .autodev/messages/MESSAGE_<timestamp>.md    — task trigger message
+ *
+ * The agent profile is loaded automatically by the agent via AGENTS.md → @.autodev/AGENT_PROFILE.md.
+ */
+export declare function buildPrompt(task: Task, root: string, todoDir: string, includeProfile?: boolean): {
+    prompt: string;
+    messageFile: string;
+};

package/out/prompt.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPrompt = buildPrompt;
+const messageBuilder_1 = require("./messageBuilder");
+// ---------------------------------------------------------------------------
+// PromptBuilder — delegates to messageBuilder which writes split files
+// ---------------------------------------------------------------------------
+/**
+ * Build the prompt string for a task, and write the split files:
+ *   .autodev/AGENT_PROFILE.md                  — profile instructions (rebuilt fresh)
+ *   .autodev/messages/MESSAGE_<timestamp>.md    — task trigger message
+ *
+ * The agent profile is loaded automatically by the agent via AGENTS.md → @.autodev/AGENT_PROFILE.md.
+ */
+function buildPrompt(task, root, todoDir, includeProfile = true) {
+    return (0, messageBuilder_1.buildMessage)(task, root, todoDir, includeProfile);
+}
+//# sourceMappingURL=prompt.js.map

package/out/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":";;AAcA,kCAOC;AApBD,qDAAgD;AAEhD,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAE9E;;;;;;GAMG;AACH,SAAgB,WAAW,CACzB,IAAU,EACV,IAAY,EACZ,OAAe,EACf,cAAc,GAAG,IAAI;IAErB,OAAO,IAAA,6BAAY,EAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;AAC3D,CAAC"}

package/out/protocolSections.d.ts

@@ -0,0 +1,26 @@
+interface SettingsLike {
+    mcpServers?: Record<string, {
+        enabled?: boolean;
+    } | undefined>;
+}
+/**
+ * Strip any existing protocol markers from `body`, then append fresh blocks
+ * from `media/mcp/<name>.md` for each MCP currently enabled in `settings`.
+ */
+export declare function applyProtocolSections(body: string, settings: SettingsLike | undefined): string;
+/**
+ * Copy ALL skills from media/skills/ to root/.claude/skills/.
+ * This ensures all general skills (not just MCP-related ones) are available to Claude.
+ * Does nothing if root is falsy.
+ */
+export declare function applyAllSkills(root: string): void;
+/**
+ * For every MCP that has a corresponding `media/skills/<name>/SKILL.md`:
+ *   - If the MCP is enabled, copy the skill file to `<root>/.claude/skills/<name>/SKILL.md`.
+ *   - If the MCP is disabled (or absent), delete `<root>/.claude/skills/<name>/SKILL.md`
+ *     if it was previously deployed by autodev.
+ *
+ * Does nothing if `root` is falsy.
+ */
+export declare function applyMcpSkills(root: string, settings: SettingsLike | undefined): void;
+export {};

package/out/protocolSections.js

@@ -0,0 +1,209 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyProtocolSections = applyProtocolSections;
+exports.applyAllSkills = applyAllSkills;
+exports.applyMcpSkills = applyMcpSkills;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ---------------------------------------------------------------------------
+// Protocol sections — for each MCP server enabled in settings, look up
+// `media/mcp/<server-name>.md` and inject its contents into the agent profile,
+// wrapped in BEGIN/END markers. Toggling an MCP off cleanly removes its block
+// on the next regeneration.
+//
+// Additionally, if `media/skills/<server-name>/SKILL.md` exists for an
+// enabled MCP, it is deployed to `.claude/skills/<server-name>/SKILL.md` in
+// the workspace so Claude Code loads it automatically. Skills for disabled
+// MCPs are removed.
+//
+// To add a new protocol: drop a markdown file in `media/mcp/` named exactly
+// after the MCP server (e.g. `media/mcp/zerolib-email.md`). No code changes
+// required. Optionally add `media/skills/<name>/SKILL.md` for Claude skills.
+// ---------------------------------------------------------------------------
+const BEGIN_MARKER = '<!-- AUTODEV:mcp-protocol:';
+const END_MARKER = ':end -->';
+function _isEnabled(s, name) {
+    const entry = s?.mcpServers?.[name];
+    if (!entry)
+        return false;
+    return entry.enabled !== false;
+}
+function _mcpDir() {
+    return path.join(__dirname, '..', 'media', 'mcp');
+}
+function _skillsMediaDir() {
+    return path.join(__dirname, '..', 'media', 'skills');
+}
+/** Strip every existing `<!-- AUTODEV:mcp-protocol:*:begin -->...end -->` block. */
+function _stripAllProtocolBlocks(body) {
+    // Greedy-safe non-greedy match across newlines
+    const re = /\n*<!-- AUTODEV:mcp-protocol:[^:]+:begin -->[\s\S]*?<!-- AUTODEV:mcp-protocol:[^:]+:end -->\n*/g;
+    return body.replace(re, '\n').replace(/\n{3,}/g, '\n\n');
+}
+/**
+ * Strip any existing protocol markers from `body`, then append fresh blocks
+ * from `media/mcp/<name>.md` for each MCP currently enabled in `settings`.
+ */
+function applyProtocolSections(body, settings) {
+    let out = _stripAllProtocolBlocks(body).trimEnd();
+    const dir = _mcpDir();
+    if (!fs.existsSync(dir))
+        return out + '\n';
+    const enabledNames = Object.keys(settings?.mcpServers ?? {})
+        .filter(name => _isEnabled(settings, name))
+        .sort();
+    const additions = [];
+    for (const name of enabledNames) {
+        const file = path.join(dir, `${name}.md`);
+        if (!fs.existsSync(file))
+            continue;
+        let content;
+        try {
+            content = fs.readFileSync(file, 'utf8').trim();
+        }
+        catch {
+            continue;
+        }
+        if (!content)
+            continue;
+        additions.push(`${BEGIN_MARKER}${name}:begin -->\n\n${content}\n\n${BEGIN_MARKER}${name}${END_MARKER}`);
+    }
+    if (additions.length === 0)
+        return out + '\n';
+    return out + '\n\n' + additions.join('\n\n') + '\n';
+}
+// ---------------------------------------------------------------------------
+// Skill deployment — copy media/skills/<name>/SKILL.md to
+// <root>/.claude/skills/<name>/SKILL.md when the MCP is enabled, and remove
+// it when the MCP is disabled or no longer present.
+// ---------------------------------------------------------------------------
+/**
+ * Copy ALL skills from media/skills/ to root/.claude/skills/.
+ * This ensures all general skills (not just MCP-related ones) are available to Claude.
+ * Does nothing if root is falsy.
+ */
+function applyAllSkills(root) {
+    if (!root) {
+        return;
+    }
+    const skillsMedia = _skillsMediaDir();
+    if (!fs.existsSync(skillsMedia)) {
+        return;
+    }
+    const skillNames = fs.readdirSync(skillsMedia).filter(n => {
+        try {
+            return fs.statSync(path.join(skillsMedia, n)).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+    for (const name of skillNames) {
+        const srcSkill = path.join(skillsMedia, name, 'SKILL.md');
+        if (!fs.existsSync(srcSkill)) {
+            continue;
+        }
+        const destDir = path.join(root, '.claude', 'skills', name);
+        const destSkill = path.join(destDir, 'SKILL.md');
+        // Always deploy the skill file
+        if (!fs.existsSync(destDir)) {
+            fs.mkdirSync(destDir, { recursive: true });
+        }
+        try {
+            const src = fs.readFileSync(srcSkill, 'utf8');
+            fs.writeFileSync(destSkill, src, 'utf8');
+        }
+        catch { /* ignore write errors */ }
+    }
+}
+/**
+ * For every MCP that has a corresponding `media/skills/<name>/SKILL.md`:
+ *   - If the MCP is enabled, copy the skill file to `<root>/.claude/skills/<name>/SKILL.md`.
+ *   - If the MCP is disabled (or absent), delete `<root>/.claude/skills/<name>/SKILL.md`
+ *     if it was previously deployed by autodev.
+ *
+ * Does nothing if `root` is falsy.
+ */
+function applyMcpSkills(root, settings) {
+    if (!root) {
+        return;
+    }
+    const skillsMedia = _skillsMediaDir();
+    if (!fs.existsSync(skillsMedia)) {
+        return;
+    }
+    const mcpNames = fs.readdirSync(skillsMedia).filter(n => {
+        try {
+            return fs.statSync(path.join(skillsMedia, n)).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+    for (const name of mcpNames) {
+        const srcSkill = path.join(skillsMedia, name, 'SKILL.md');
+        if (!fs.existsSync(srcSkill)) {
+            continue;
+        }
+        const destDir = path.join(root, '.claude', 'skills', name);
+        const destSkill = path.join(destDir, 'SKILL.md');
+        if (_isEnabled(settings, name)) {
+            // Deploy the skill file
+            if (!fs.existsSync(destDir)) {
+                fs.mkdirSync(destDir, { recursive: true });
+            }
+            try {
+                const src = fs.readFileSync(srcSkill, 'utf8');
+                fs.writeFileSync(destSkill, src, 'utf8');
+            }
+            catch { /* ignore write errors */ }
+        }
+        else {
+            // Remove the previously deployed skill file
+            try {
+                if (fs.existsSync(destSkill)) {
+                    fs.unlinkSync(destSkill);
+                }
+                // Remove the skill directory if it is now empty
+                if (fs.existsSync(destDir) && fs.readdirSync(destDir).length === 0) {
+                    fs.rmdirSync(destDir);
+                }
+            }
+            catch { /* ignore */ }
+        }
+    }
+}
+//# sourceMappingURL=protocolSections.js.map

package/out/protocolSections.js.map

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

package/out/providers/claudeCliProvider.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Encode a workspace path the way Claude Code names its `~/.claude/projects/`
+ * folders: every `:`, `\`, `/` becomes `-`, and runs of dashes are collapsed.
+ * Note: Claude **keeps the leading dash** that comes from a leading slash on
+ * POSIX paths (e.g. `/home/x/foo` → `-home-x-foo`), so we don't strip `^-`.
+ * Trailing dashes are dropped.
+ */
+export declare function claudeProjectFolder(workspacePath: string): string;
+/**
+ * Compute the `~/.claude/projects/<encoded>` directory for a workspace,
+ * regardless of whether it already exists. Used when restoring an agent
+ * backup into a new folder: the destination's session traces must land in
+ * the project dir that Claude will look up for that folder.
+ */
+export declare function getClaudeProjectDir(workspacePath: string): string;
+export declare function listClaudeSessionFiles(workspacePath: string): Array<{
+    name: string;
+    mtime: number;
+    full: string;
+}>;
+export declare function listClaudeSessions(workspacePath: string): Array<{
+    id: string;
+    mtime: number;
+}>;
+export declare function findLatestClaudeSession(workspacePath: string): string | undefined;
+/**
+ * Set the display NAME shown for a Claude session in the `claude --resume`
+ * picker. This Claude version has no dedicated title field — the picker label is
+ * the `display` value in ~/.claude/history.jsonl keyed by sessionId. We APPEND a
+ * fresh entry (never rewrite existing lines, so history can't be corrupted); the
+ * picker surfaces the latest display for the session.
+ */
+/** Read the display NAME shown for a claude session in the --resume picker
+ *  (latest `display` for this sessionId in ~/.claude/history.jsonl). */
+export declare function getClaudeSessionDisplay(sessionId: string): string | undefined;
+export declare function setClaudeSessionName(sessionId: string, name: string, cwd: string): void;
+export declare function getClaudeSessionCursor(workspacePath: string): number;
+export interface ClaudeSessionState {
+    /** True if a definitive turn-end was detected. */
+    hasEndTurn: boolean;
+    /** Human-readable label for the tool currently running, if any. */
+    activeToolStatus?: string;
+    /** True if a bash_progress or mcp_progress record was seen. */
+    hasProgress: boolean;
+    /** Set when a rate_limit error is found — contains the raw message text. */
+    rateLimitMessage?: string;
+}
+export declare function parseClaudeStateSince(workspacePath: string, fromByte: number): ClaudeSessionState;
+/** @deprecated Use parseClaudeStateSince instead. */
+export declare function hasClaudeEndTurnSince(workspacePath: string, fromByte: number): boolean;
+export declare function readClaudeOutputSince(workspacePath: string, fromByte: number): string;
+/** Build the shell command string for the claude-cli provider. */
+export declare function buildClaudeCliCommand(agentProfileFile: string, messageFile: string, sessionId?: string, includeProfile?: boolean, model?: string): string;
+/**
+ * Run a tiny probe prompt via Node exec to obtain a claude-cli session ID
+ * before the main prompt runs. Extracts "session_id" from --output-format json output.
+ */
+export declare function probeClaudeSession(cwd: string, log: (msg: string) => void): Promise<string | undefined>;
+/**
+ * Run `/compact` on an existing Claude session to summarise conversation
+ * history and free up context window space. Used after Claude returns
+ * `prompt is too long: N tokens > MAX maximum` (HTTP 400). Resolves on exit
+ * (success or failure — caller decides what to do).
+ */
+export declare function runClaudeCompact(sessionId: string, cwd: string, log: (msg: string) => void): Promise<void>;
+/**
+ * Run `/clear` on an existing Claude session to wipe the conversation history
+ * and start fresh. Used when autocompact is thrashing (context refills to
+ * limit immediately after compact). Resolves on exit.
+ */
+export declare function runClaudeClear(sessionId: string, cwd: string, log: (msg: string) => void): Promise<void>;