@codemap-ai/core 0.2.0

package/dist/lib/agent-pack-installer.js

@@ -0,0 +1,371 @@
+import { constants } from "node:fs";
+import { access, copyFile, mkdir, readFile, readdir, rename, unlink, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { AGENT_PACK_SKILLS, getPluginRoot, getAgentPackRoot, readAgentPackFile, readAgentPackSkill, } from "./agent-pack.js";
+function parseTarget(value) {
+    if (value === "codex" ||
+        value === "claude" ||
+        value === "cursor" ||
+        value === "gemini" ||
+        value === "opencode" ||
+        value === "copilot" ||
+        value === "marketplace" ||
+        value === "all") {
+        return value;
+    }
+    return "all";
+}
+export function parseAgentPackInstallArgs(args) {
+    let target = "all";
+    let dryRun = false;
+    let force = false;
+    let pluginPath;
+    let cwd;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--dry-run") {
+            dryRun = true;
+            continue;
+        }
+        if (arg === "--force") {
+            force = true;
+            continue;
+        }
+        if (arg === "--target") {
+            target = parseTarget(args[index + 1]);
+            index += 1;
+            continue;
+        }
+        if (arg === "--plugin-path" || arg === "--path") {
+            pluginPath = args[index + 1];
+            index += 1;
+            continue;
+        }
+        if (arg === "--root" || arg === "--cwd") {
+            cwd = args[index + 1];
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--target=")) {
+            target = parseTarget(arg.slice("--target=".length));
+            continue;
+        }
+        if (arg.startsWith("--plugin-path=")) {
+            pluginPath = arg.slice("--plugin-path=".length);
+            continue;
+        }
+        if (arg.startsWith("--path=")) {
+            pluginPath = arg.slice("--path=".length);
+            continue;
+        }
+        if (arg.startsWith("--root=")) {
+            cwd = arg.slice("--root=".length);
+            continue;
+        }
+        if (arg.startsWith("--cwd=")) {
+            cwd = arg.slice("--cwd=".length);
+        }
+    }
+    return { target, dryRun, force, pluginPath, cwd };
+}
+function targetsFor(target) {
+    return target === "all"
+        ? ["codex", "claude", "cursor", "gemini", "opencode", "copilot"]
+        : [target];
+}
+async function exists(filePath) {
+    try {
+        await access(filePath, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function listSkillWrites(root, harness) {
+    return Promise.all(AGENT_PACK_SKILLS.map(async (skill) => ({
+        path: path.join(root, `.${harness}`, "skills", `codemap-${skill}`, "SKILL.md"),
+        content: await readAgentPackSkill(skill),
+    })));
+}
+async function planCodex(root) {
+    return [
+        {
+            path: path.join(root, "AGENTS.md"),
+            content: await readAgentPackFile("templates/AGENTS.md"),
+        },
+        {
+            path: path.join(root, ".codex", "codemap-agent-pack.md"),
+            content: await readAgentPackFile("README.md"),
+        },
+        ...(await listSkillWrites(root, "codex")),
+    ];
+}
+async function mergeClaudeSettings(root) {
+    const settingsPath = path.join(root, ".claude", "settings.json");
+    let settings = {};
+    try {
+        settings = JSON.parse(await readFile(settingsPath, "utf8"));
+    }
+    catch (error) {
+        if (!(error && typeof error === "object" && "code" in error && error.code === "ENOENT"))
+            throw error;
+    }
+    // Ensure hooks key exists (empty) for forward compatibility
+    if (!settings.hooks) {
+        settings.hooks = {};
+    }
+    return { path: settingsPath, content: JSON.stringify(settings, null, 2), overwrite: true };
+}
+async function planClaude(root) {
+    return [
+        {
+            path: path.join(root, "CLAUDE.md"),
+            content: await readAgentPackFile("templates/CLAUDE.md"),
+        },
+        {
+            path: path.join(root, ".claude", "rules", "codemap-mcp-first.md"),
+            content: await readAgentPackFile("rules/mcp-first.md"),
+        },
+        {
+            path: path.join(root, ".claude", "rules", "codemap-task-lifecycle.md"),
+            content: await readAgentPackFile("rules/task-lifecycle.md"),
+        },
+        await mergeClaudeSettings(root),
+        ...(await listSkillWrites(root, "claude")),
+    ];
+}
+async function planCursor(root) {
+    const mcpFirst = await readAgentPackFile("rules/mcp-first.md");
+    const lifecycle = await readAgentPackFile("rules/task-lifecycle.md");
+    const workflowSkills = await readAgentPackFile("rules/workflow-skills.md");
+    return [
+        {
+            path: path.join(root, ".cursor", "rules", "codemap.mdc"),
+            content: [
+                "---",
+                "description: CodeMap MCP-first workflow",
+                "alwaysApply: true",
+                "---",
+                "",
+                mcpFirst,
+                "",
+                lifecycle,
+                "",
+                workflowSkills,
+            ].join("\n"),
+        },
+    ];
+}
+async function planGemini(root) {
+    return [
+        {
+            path: path.join(root, "GEMINI.md"),
+            content: await readAgentPackFile("templates/GEMINI.md"),
+        },
+    ];
+}
+async function planOpenCode(root) {
+    return [
+        {
+            path: path.join(root, ".opencode", "AGENTS.md"),
+            content: await readAgentPackFile("templates/opencode-AGENTS.md"),
+        },
+        {
+            path: path.join(root, ".opencode", "INSTALL.md"),
+            content: await readAgentPackFile("templates/opencode-INSTALL.md"),
+        },
+    ];
+}
+async function planCopilot(root) {
+    return [
+        {
+            path: path.join(root, "COPILOT.md"),
+            content: await readAgentPackFile("templates/COPILOT.md"),
+        },
+    ];
+}
+function defaultMarketplace(pluginPath) {
+    return {
+        name: "codemap-agent-pack-marketplace",
+        interface: {
+            displayName: "CodeMap Agent Pack",
+        },
+        plugins: [
+            {
+                name: "codemap-agent-pack",
+                source: {
+                    source: "local",
+                    path: pluginPath ?? "./packages/mcp-server",
+                },
+                policy: {
+                    installation: "AVAILABLE",
+                    authentication: "ON_INSTALL",
+                },
+                category: "Coding",
+            },
+        ],
+    };
+}
+async function planMarketplace(root, pluginPath) {
+    const marketplacePath = path.join(root, ".agents", "plugins", "marketplace.json");
+    let marketplace = defaultMarketplace(pluginPath);
+    try {
+        const raw = await readFile(marketplacePath, "utf8");
+        const parsed = JSON.parse(raw);
+        const plugins = Array.isArray(parsed.plugins) ? parsed.plugins : [];
+        const nextEntry = defaultMarketplace(pluginPath).plugins[0];
+        const existingIndex = plugins.findIndex((plugin) => plugin.name === "codemap-agent-pack");
+        if (existingIndex >= 0) {
+            plugins[existingIndex] = nextEntry;
+        }
+        else {
+            plugins.push(nextEntry);
+        }
+        marketplace = {
+            name: parsed.name ?? marketplace.name,
+            interface: {
+                displayName: parsed.interface?.displayName ?? marketplace.interface.displayName,
+            },
+            plugins: plugins,
+        };
+    }
+    catch (error) {
+        if (!(error && typeof error === "object" && "code" in error && error.code === "ENOENT")) {
+            throw error;
+        }
+    }
+    return [
+        {
+            path: marketplacePath,
+            content: JSON.stringify(marketplace, null, 2),
+        },
+    ];
+}
+async function planWrites(root, target, pluginPath) {
+    if (target === "codex")
+        return planCodex(root);
+    if (target === "claude")
+        return planClaude(root);
+    if (target === "cursor")
+        return planCursor(root);
+    if (target === "gemini")
+        return planGemini(root);
+    if (target === "opencode")
+        return planOpenCode(root);
+    if (target === "copilot")
+        return planCopilot(root);
+    return planMarketplace(root, pluginPath);
+}
+async function applyWrite(write, options) {
+    const alreadyExists = await exists(write.path);
+    const action = alreadyExists
+        ? options.force || write.overwrite
+            ? "overwrite"
+            : "backup"
+        : "create";
+    if (options.dryRun) {
+        return { path: write.path, action: `would ${action}` };
+    }
+    await mkdir(path.dirname(write.path), { recursive: true });
+    if (alreadyExists && !options.force && !write.overwrite) {
+        const backupPath = `${write.path}.codemap-backup-${Date.now()}`;
+        await rename(write.path, backupPath);
+    }
+    if (write.sourcePath) {
+        await copyFile(write.sourcePath, write.path);
+    }
+    else {
+        await writeFile(write.path, `${write.content ?? ""}\n`, "utf8");
+    }
+    return { path: write.path, action };
+}
+export async function installAgentPack(options) {
+    const root = options.cwd ?? process.cwd();
+    const dryRun = options.dryRun ?? false;
+    const force = options.force ?? false;
+    const pluginPath = options.pluginPath;
+    const installed = [];
+    for (const target of targetsFor(options.target)) {
+        const writes = target === "marketplace"
+            ? await planMarketplace(root, pluginPath)
+            : await planWrites(root, target, pluginPath);
+        for (const write of writes) {
+            installed.push(await applyWrite(write, { dryRun, force }));
+        }
+    }
+    return {
+        target: options.target,
+        dryRun,
+        force,
+        root,
+        installed,
+        packRoot: getAgentPackRoot(),
+        pluginRoot: getPluginRoot(),
+    };
+}
+export async function ensureClaudeHooks(cwd) {
+    try {
+        const write = await mergeClaudeSettings(cwd);
+        await mkdir(path.dirname(write.path), { recursive: true });
+        await writeFile(write.path, `${write.content ?? ""}\n`, "utf8");
+    }
+    catch {
+        // silently ignore — hooks are best-effort on startup
+    }
+}
+export async function listAgentPackFiles() {
+    const root = getAgentPackRoot();
+    const entries = await readdir(root, { recursive: true });
+    return entries.map((entry) => path.join(root, entry.toString()));
+}
+const BACKUP_SUFFIX = ".codemap-backup-";
+async function findBackupFiles(dir) {
+    const results = [];
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === "node_modules" || entry.name === ".git")
+                continue;
+            results.push(...(await findBackupFiles(full)));
+        }
+        else if (entry.name.includes(BACKUP_SUFFIX)) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+export async function cleanAgentPackBackups(root, dryRun) {
+    const files = await findBackupFiles(root);
+    if (files.length === 0) {
+        console.log(`No .codemap-backup-* files found in ${root}`);
+        return { deleted: 0, files: [] };
+    }
+    if (dryRun) {
+        console.log(`Found ${files.length} backup file(s):`);
+        for (const f of files)
+            console.log(`  ${f}`);
+        console.log("\nRun without --dry-run to delete.");
+        return { deleted: 0, files };
+    }
+    let deleted = 0;
+    for (const f of files) {
+        try {
+            await unlink(f);
+            deleted++;
+        }
+        catch {
+            // skip files that can't be deleted
+        }
+    }
+    console.log(`Deleted ${deleted} backup file(s).`);
+    return { deleted, files };
+}
+//# sourceMappingURL=agent-pack-installer.js.map

package/dist/lib/agent-pack-installer.js.map

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

package/dist/lib/agent-pack.d.ts

@@ -0,0 +1,36 @@
+export declare const AGENT_PACK_INDEX_URI = "codemap://agent-pack/index";
+export declare const AGENT_PACK_INSTALL_URI = "codemap://agent-pack/install";
+export declare const AGENT_PACK_CODEX_URI = "codemap://agent-pack/codex";
+export declare const AGENT_PACK_CLAUDE_URI = "codemap://agent-pack/claude";
+export declare const AGENT_PACK_CURSOR_URI = "codemap://agent-pack/cursor";
+export declare const AGENT_PACK_GEMINI_URI = "codemap://agent-pack/gemini";
+export declare const AGENT_PACK_OPENCODE_URI = "codemap://agent-pack/opencode";
+export declare const AGENT_PACK_COPILOT_URI = "codemap://agent-pack/copilot";
+export declare const AGENT_PACK_TEMPLATE_BASE_URI = "codemap://agent-pack/templates";
+export declare const AGENT_PACK_SKILLS: readonly ["mcp-first-exploration", "feature-area-investigation", "symbol-level-debugging", "interpreting-codemap-output", "safe-edit-and-reimport", "token-efficient-code-review", "brainstorming", "writing-plans", "executing-plans", "test-driven-development", "verification-before-completion"];
+export type AgentPackSkillName = (typeof AGENT_PACK_SKILLS)[number];
+export declare const AGENT_PACK_TEMPLATES: readonly [{
+    readonly id: "design-spec";
+    readonly title: "Design spec template";
+    readonly path: "templates/design-spec.md";
+    readonly uri: "codemap://agent-pack/templates/design-spec";
+}, {
+    readonly id: "implementation-plan";
+    readonly title: "Implementation plan template";
+    readonly path: "templates/implementation-plan.md";
+    readonly uri: "codemap://agent-pack/templates/implementation-plan";
+}, {
+    readonly id: "verification-report";
+    readonly title: "Verification report template";
+    readonly path: "templates/verification-report.md";
+    readonly uri: "codemap://agent-pack/templates/verification-report";
+}];
+export type AgentPackTemplate = (typeof AGENT_PACK_TEMPLATES)[number];
+export declare function skillResourceUri(skillName: AgentPackSkillName): string;
+export declare function getAgentPackRoot(): string;
+export declare function getPluginRoot(): string;
+export declare function readAgentPackFile(relativePath: string): Promise<string>;
+export declare function readAgentPackSkill(skillName: AgentPackSkillName): Promise<string>;
+export declare function buildAgentPackIndexMarkdown(): string;
+export declare function buildHarnessMarkdown(harness: "codex" | "claude" | "cursor" | "gemini" | "opencode" | "copilot"): string;
+//# sourceMappingURL=agent-pack.d.ts.map

package/dist/lib/agent-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-pack.d.ts","sourceRoot":"","sources":["../../src/lib/agent-pack.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oBAAoB,+BAA+B,CAAC;AACjE,eAAO,MAAM,sBAAsB,iCAAiC,CAAC;AACrE,eAAO,MAAM,oBAAoB,+BAA+B,CAAC;AACjE,eAAO,MAAM,qBAAqB,gCAAgC,CAAC;AACnE,eAAO,MAAM,qBAAqB,gCAAgC,CAAC;AACnE,eAAO,MAAM,qBAAqB,gCAAgC,CAAC;AACnE,eAAO,MAAM,uBAAuB,kCAAkC,CAAC;AACvE,eAAO,MAAM,sBAAsB,iCAAiC,CAAC;AACrE,eAAO,MAAM,4BAA4B,mCAAmC,CAAC;AAE7E,eAAO,MAAM,iBAAiB,sSAYpB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAmBvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,kBAAkB,UAE7D;AAED,wBAAgB,gBAAgB,WAE/B;AAED,wBAAgB,aAAa,WAE5B;AAED,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,mBAE3D;AAED,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,kBAAkB,mBAErE;AAED,wBAAgB,2BAA2B,WA+B1C;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,UA4B3E"}

package/dist/lib/agent-pack.js

@@ -0,0 +1,119 @@
+import path from "node:path";
+import { readFile } from "node:fs/promises";
+import { getPackageRoot } from "./bundled-runtime.js";
+export const AGENT_PACK_INDEX_URI = "codemap://agent-pack/index";
+export const AGENT_PACK_INSTALL_URI = "codemap://agent-pack/install";
+export const AGENT_PACK_CODEX_URI = "codemap://agent-pack/codex";
+export const AGENT_PACK_CLAUDE_URI = "codemap://agent-pack/claude";
+export const AGENT_PACK_CURSOR_URI = "codemap://agent-pack/cursor";
+export const AGENT_PACK_GEMINI_URI = "codemap://agent-pack/gemini";
+export const AGENT_PACK_OPENCODE_URI = "codemap://agent-pack/opencode";
+export const AGENT_PACK_COPILOT_URI = "codemap://agent-pack/copilot";
+export const AGENT_PACK_TEMPLATE_BASE_URI = "codemap://agent-pack/templates";
+export const AGENT_PACK_SKILLS = [
+    "mcp-first-exploration",
+    "feature-area-investigation",
+    "symbol-level-debugging",
+    "interpreting-codemap-output",
+    "safe-edit-and-reimport",
+    "token-efficient-code-review",
+    "brainstorming",
+    "writing-plans",
+    "executing-plans",
+    "test-driven-development",
+    "verification-before-completion",
+];
+export const AGENT_PACK_TEMPLATES = [
+    {
+        id: "design-spec",
+        title: "Design spec template",
+        path: "templates/design-spec.md",
+        uri: `${AGENT_PACK_TEMPLATE_BASE_URI}/design-spec`,
+    },
+    {
+        id: "implementation-plan",
+        title: "Implementation plan template",
+        path: "templates/implementation-plan.md",
+        uri: `${AGENT_PACK_TEMPLATE_BASE_URI}/implementation-plan`,
+    },
+    {
+        id: "verification-report",
+        title: "Verification report template",
+        path: "templates/verification-report.md",
+        uri: `${AGENT_PACK_TEMPLATE_BASE_URI}/verification-report`,
+    },
+];
+export function skillResourceUri(skillName) {
+    return `codemap://skills/${skillName}`;
+}
+export function getAgentPackRoot() {
+    return path.join(getPackageRoot(import.meta.url), "agent-pack");
+}
+export function getPluginRoot() {
+    return getPackageRoot(import.meta.url);
+}
+export async function readAgentPackFile(relativePath) {
+    return readFile(path.join(getAgentPackRoot(), relativePath), "utf8");
+}
+export async function readAgentPackSkill(skillName) {
+    return readAgentPackFile(`skills/${skillName}/SKILL.md`);
+}
+export function buildAgentPackIndexMarkdown() {
+    return [
+        "# CodeMap Agent Pack",
+        "",
+        "CodeMap Agent Pack is the workflow layer for CodeMap MCP. It teaches agents to use CodeMap as a context engine before raw file reads.",
+        "",
+        "## Resources",
+        `- ${AGENT_PACK_INSTALL_URI}`,
+        `- ${AGENT_PACK_CODEX_URI}`,
+        `- ${AGENT_PACK_CLAUDE_URI}`,
+        `- ${AGENT_PACK_CURSOR_URI}`,
+        `- ${AGENT_PACK_GEMINI_URI}`,
+        `- ${AGENT_PACK_OPENCODE_URI}`,
+        `- ${AGENT_PACK_COPILOT_URI}`,
+        "",
+        "## Skills",
+        ...AGENT_PACK_SKILLS.map((skill) => `- ${skillResourceUri(skill)}`),
+        "",
+        "## Artifact Templates",
+        ...AGENT_PACK_TEMPLATES.map((template) => `- ${template.uri} — ${template.title}`),
+        "",
+        "## Local Install",
+        "",
+        "```bash",
+        "codemap init-agent-pack --target all",
+        "codemap doctor-agent-pack --target auto",
+        "```",
+        "",
+        "Use `codemap doctor-agent-pack` to verify local rules and skills after install.",
+        "Use `codemap agent-pack-path` to print the local plugin root path.",
+    ].join("\n");
+}
+export function buildHarnessMarkdown(harness) {
+    const title = harness === "codex"
+        ? "Codex"
+        : harness === "claude"
+            ? "Claude"
+            : harness === "cursor"
+                ? "Cursor"
+                : harness === "gemini"
+                    ? "Gemini"
+                    : harness === "opencode"
+                        ? "OpenCode"
+                        : "GitHub Copilot CLI";
+    return [
+        `# CodeMap Agent Pack for ${title}`,
+        "",
+        "Install local rules and skills with:",
+        "",
+        "```bash",
+        `codemap init-agent-pack --target ${harness}`,
+        `codemap doctor-agent-pack --target ${harness}`,
+        "```",
+        "",
+        "The doctor command verifies the installed rules and skills contain the required workflow gates.",
+        "The installed guidance tells the agent to use CodeMap MCP tools for broad work, choose exploration tools based on task clarity, and finish with verification plus index refresh/reimport decisions.",
+    ].join("\n");
+}
+//# sourceMappingURL=agent-pack.js.map

package/dist/lib/agent-pack.js.map

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

package/dist/lib/agent-workflow.d.ts

@@ -0,0 +1,37 @@
+import { type AgentPackSkillName } from "./agent-pack.js";
+export declare const MCP_FIRST_RULE_URI = "codemap://rules/mcp-first";
+export declare const TASK_LIFECYCLE_RULE_URI = "codemap://rules/task-lifecycle";
+export declare const SKILL_ROUTING_RULE_URI = "codemap://rules/skill-routing";
+export declare const WORKFLOW_GATES_RULE_URI = "codemap://rules/workflow-gates";
+export declare const VERIFICATION_BEFORE_COMPLETION_RULE_URI = "codemap://rules/verification-before-completion";
+export declare const TASK_TYPES: readonly ["feature", "bugfix", "debugging", "review", "refactor", "test", "research"];
+export type AgentTaskType = (typeof TASK_TYPES)[number];
+export declare const WORKFLOW_PHASES: readonly ["orient", "design", "plan", "implement", "verify", "finish"];
+export type AgentWorkflowPhase = (typeof WORKFLOW_PHASES)[number];
+export interface WorkflowRoute {
+    taskType: AgentTaskType;
+    description: string;
+    requiredSkills: AgentPackSkillName[];
+    firstTools: string[];
+    hardGates: string[];
+    requiredOutputs: string[];
+    completionChecks: string[];
+    phases: AgentWorkflowPhase[];
+}
+export declare const DEFAULT_VERIFICATION_CHECKLIST: string[];
+export declare const WORKFLOW_ROUTES: Record<AgentTaskType, WorkflowRoute>;
+export declare const ARTIFACT_TEMPLATES: {
+    id: "design-spec" | "implementation-plan" | "verification-report";
+    title: "Design spec template" | "Implementation plan template" | "Verification report template";
+    path: "templates/design-spec.md" | "templates/implementation-plan.md" | "templates/verification-report.md";
+    resourceUri: "codemap://agent-pack/templates/design-spec" | "codemap://agent-pack/templates/implementation-plan" | "codemap://agent-pack/templates/verification-report";
+}[];
+export declare const AGENT_WORKFLOW_SUMMARY: string[];
+export declare const AGENT_WORKFLOW_SEQUENCE: string[];
+export declare const SKILL_ROUTING_RULE_MARKDOWN: string;
+export declare const WORKFLOW_GATES_RULE_MARKDOWN = "# CodeMap Workflow Gates\n\nCodeMap Agent Pack uses Superpowers-style gates to keep agents from jumping into edits too early.\n\n## Gates\n\n1. **Orient** \u2014 The project-context resource is already loaded in your context \u2014 do NOT call `get_project` or `list_projects` unless the user explicitly asks for project or account info. If no local index exists yet, call `refresh_local_index` (no auth required). Then choose the narrowest CodeMap context tool: `explore_task` for broad unclear work, `search_codebase` for known names, `find_related_files` for related-file questions, or `get_file`/`get_file` for known paths.\n2. **Design** \u2014 for features or vague tasks, complete brainstorming and get design approval before editing production files.\n3. **Plan** \u2014 after design approval, write an implementation plan with exact files, steps, and verification commands.\n4. **Implement** \u2014 follow the plan or TDD loop; keep changes scoped.\n5. **Verify** \u2014 inspect diff, run relevant checks, refresh local index, and decide cloud reimport.\n6. **Finish** \u2014 summarize changed behavior, verification, skipped checks, and residual risk.\n\nLow-risk one-line fixes may use a lightweight design summary instead of a full spec, but they still require verification.\n";
+export declare const VERIFICATION_BEFORE_COMPLETION_RULE_MARKDOWN: string;
+export declare const MCP_FIRST_RULE_MARKDOWN = "# MCP-First Code Exploration\n\nWhen working in a CodeMap-indexed repository, prefer CodeMap MCP tools before raw file reads or grep.\n\n## Tool Selection\n\nChoose the tool based on the shape of the question:\n\n1. `explore_task` \u2014 use first for broad tasks such as \"fix bug X\", \"implement Y\", or \"investigate Z\". It returns likely files, entrypoints, symbols, risks, recommended reads, and suggested next tools.\n3. `find_related_files` \u2014 use when you already have an anchor file/symbol, or when the user asks \"which files should I read?\", \"what is related to X?\", or \"what is the scope around X?\".\n4. `search_codebase` \u2014 use for known keywords, filenames, exports, or symbols. Pass `semantic=true` for conceptual queries where you do not know the exact symbol name (e.g. \"authentication flow\", \"error handling logic\").\n5. `get_file` \u2014 fetch outlines for several candidate files in one call. Use after `explore_task`, `find_related_files`, or `search_codebase`.\n6. `get_file` \u2014 read exact content only after you know what you need. Prefer `include=[\"outline\"]` for map context and `include=[\"symbols\"]` with `symbol_names` for function/class bodies.\n7. `symbol` / `symbol` \u2014 use for symbol impact analysis. Use `symbol` when the symbol's file is known.\n8. `get_project_map` \u2014 inspect folder structure when module layout is unclear.\n9. `diff` \u2014 inspect uncommitted local changes (mode=working) or committed ref diffs (mode=ref).\n10. Raw Read / grep \u2014 fallback only when MCP cannot answer, such as unindexed files, dynamic string access, or complex regex searches.\n\n## Quick Decisions\n\n- \"Fix/investigate/implement\" with unclear files -> `explore_task` (semantic runs automatically).\n- \"Which files are related?\" -> `find_related_files` (semantic signal built in).\n- Known symbol or filename -> `search_codebase`.\n- Conceptual query, no exact name -> `search_codebase(semantic=true)`.\n- Several candidate files -> `get_file`.\n- Specific symbol body -> `get_file(include=[\"symbols\"], symbol_names=[...])`.\n- Who calls/imports this? -> `symbol` or `symbol`.\n- After edits -> `diff`, build/test, then `refresh_local_index` when the local MCP index should refresh.\n";
+export declare const TASK_LIFECYCLE_RULE_MARKDOWN = "# CodeMap Agent Task Lifecycle\n\n## 1. Orient\n\n- The project-context resource is already loaded in your context \u2014 skip `get_project` and `list_projects` unless the user explicitly asks for project or account info.\n- Use `explore_task`, `find_related_files`, or `search_codebase` according to the task shape.\n\n## 2. Read Deliberately\n\n- Use `get_file` to survey multiple outlines.\n- Use `get_file(include=[\"outline\"])` before full content for large/unknown files.\n- Use `get_file(include=[\"symbols\"], symbol_names=[...])` for exact function/class bodies.\n\n## 3. Edit Safely\n\n- Keep changes scoped to the task.\n- Follow local repo patterns.\n- Do not rewrite unrelated files or revert user changes.\n- For database changes, prefer schema-first workflows and generated migrations.\n\n## 4. Verify\n\n- Run the smallest sufficient build/test.\n- Build shared packages before dependents when applicable.\n- Use `diff` to confirm changed files.\n\n## 5. Refresh Index\n\n- Use `refresh_local_index` after local edits to refresh the MCP SQLite index without cloud access.\n- Use `reimport` only when the cloud index, web graph, or insights should refresh.\n\n## 6. Final Response\n\n- Summarize what changed.\n- Mention verification results.\n- Call out blockers, skipped tests, or unrelated dirty files.\n";
+export declare function buildAgentWorkflowMarkdown(): string;
+//# sourceMappingURL=agent-workflow.d.ts.map

package/dist/lib/agent-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-workflow.d.ts","sourceRoot":"","sources":["../../src/lib/agent-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,kBAAkB,EAExB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAC9D,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AACxE,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AACtE,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AACxE,eAAO,MAAM,uCAAuC,mDACF,CAAC;AAEnD,eAAO,MAAM,UAAU,uFAQb,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe,wEAOlB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,kBAAkB,EAAE,CAAC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,eAAO,MAAM,8BAA8B,UAM1C,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,aAAa,CAiHhE,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;GAK5B,CAAC;AAEJ,eAAO,MAAM,sBAAsB,UAWlC,CAAC;AAEF,eAAO,MAAM,uBAAuB,UASnC,CAAC;AAEF,eAAO,MAAM,2BAA2B,QAsBvC,CAAC;AAEF,eAAO,MAAM,4BAA4B,6wCAcxC,CAAC;AAEF,eAAO,MAAM,4CAA4C,QAWxD,CAAC;AAEF,eAAO,MAAM,uBAAuB,gtEA4BnC,CAAC;AAEF,eAAO,MAAM,4BAA4B,gzCAoCxC,CAAC;AAEF,wBAAgB,0BAA0B,WA6CzC"}