@bhimudev/gnanai 0.4.0

package/dist/utils/task-lifecycle.d.ts

@@ -0,0 +1,60 @@
+import type { TaskPriority, TaskStatus, TaskSpec } from '../types/task.js';
+export declare const PRIORITY_ORDER: Record<TaskPriority, number>;
+export declare const ALLOWED_TRANSITIONS: Record<TaskStatus, TaskStatus[]>;
+/**
+ * Parse a task spec file, extracting YAML frontmatter and markdown body.
+ * Uses failsafe YAML schema to prevent date auto-conversion.
+ */
+export declare function parseTaskFile(filePath: string): Promise<TaskSpec>;
+/**
+ * Serialize a TaskSpec back to file content (YAML frontmatter + markdown body).
+ */
+export declare function serializeTaskFile(task: TaskSpec): string;
+/**
+ * Sort tasks by priority: critical > high > medium > low.
+ * Stable sort: tasks with same priority preserve original order.
+ * Does not mutate the original array.
+ */
+export declare function sortByPriority(tasks: TaskSpec[]): TaskSpec[];
+/**
+ * Validate whether a status transition is allowed by the state machine.
+ */
+export declare function validateTransition(from: TaskStatus, to: TaskStatus): boolean;
+/**
+ * Map a directory name to a TaskStatus. Returns null for unknown directories.
+ */
+export declare function getStatusForDirectory(dirName: string): TaskStatus | null;
+/**
+ * Map a TaskStatus to its corresponding directory name.
+ */
+export declare function getDirectoryForStatus(status: TaskStatus): string;
+/**
+ * Find a task file in a directory by its frontmatter id.
+ * Returns the filename (not full path) of the matching file.
+ * Throws if no file matches.
+ */
+export declare function findTaskFile(taskId: string, dir: string): Promise<string>;
+/**
+ * Move a task file from one directory to another, updating its status.
+ * Uses write-new-then-delete-old strategy to prevent data loss.
+ * Removes blocked_reason when moving FROM blocked status.
+ * Returns the updated TaskSpec.
+ */
+export declare function moveTask(fileName: string, fromDir: string, toDir: string): Promise<TaskSpec>;
+/**
+ * Move a task to the blocked/ directory with a reason.
+ * Derives blocked directory from path.dirname(fromDir).
+ */
+export declare function blockTask(fileName: string, fromDir: string, reason: string): Promise<TaskSpec>;
+/**
+ * List and parse all task files in a directory, sorted by priority.
+ * Reconciles status from directory name when frontmatter disagrees.
+ * Silently skips files that fail to parse.
+ */
+export declare function listTasks(dirPath: string): Promise<TaskSpec[]>;
+/**
+ * List all tasks from the inbox/ directory, sorted by priority.
+ * Convenience wrapper around listTasks.
+ */
+export declare function listInbox(tasksRoot: string): Promise<TaskSpec[]>;
+//# sourceMappingURL=task-lifecycle.d.ts.map

package/dist/utils/task-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-lifecycle.d.ts","sourceRoot":"","sources":["../../src/utils/task-lifecycle.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAmB,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAI5F,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAKvD,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,CAOhE,CAAC;AAyEF;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuBvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAmCxD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAO5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAI5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAExE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAEhE;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe/E;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,QAAQ,CAAC,CA8CnB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,QAAQ,CAAC,CAiBnB;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA2BpE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAEtE"}

package/dist/utils/task-lifecycle.js

@@ -0,0 +1,310 @@
+// Task lifecycle management utilities
+// Provides parsing, sorting, validation, file movement, and listing for .tasks/ spec files
+import fs from 'fs-extra';
+import path from 'path';
+import yaml from 'yaml';
+// ── Constants ────────────────────────────────────────────────────────
+export const PRIORITY_ORDER = {
+    critical: 0,
+    high: 1,
+    medium: 2,
+    low: 3,
+};
+export const ALLOWED_TRANSITIONS = {
+    inbox: ['claimed'],
+    claimed: ['active', 'blocked'],
+    active: ['review', 'blocked'],
+    review: ['done', 'active', 'blocked'],
+    blocked: ['inbox'],
+    done: [],
+};
+const DIR_TO_STATUS = {
+    inbox: 'inbox',
+    claimed: 'claimed',
+    active: 'active',
+    review: 'review',
+    done: 'done',
+    blocked: 'blocked',
+};
+const STATUS_TO_DIR = {
+    inbox: 'inbox',
+    claimed: 'claimed',
+    active: 'active',
+    review: 'review',
+    done: 'done',
+    blocked: 'blocked',
+};
+// ── Internal Helpers ─────────────────────────────────────────────────
+/** Split frontmatter from body - handles both LF and CRLF */
+function splitFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        throw new Error('No valid YAML frontmatter found');
+    return { yaml: match[1], body: match[2] };
+}
+/** Parse YAML array from failsafe schema string representation */
+function parseYamlArray(value) {
+    if (Array.isArray(value))
+        return value;
+    if (typeof value !== 'string')
+        return [];
+    const trimmed = value.trim();
+    if (trimmed === '[]' || trimmed === '')
+        return [];
+    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+        const inner = trimmed.slice(1, -1).trim();
+        if (inner === '')
+            return [];
+        return inner.split(',').map(s => s.trim()).filter(s => s.length > 0);
+    }
+    return [trimmed];
+}
+/** Convert failsafe null string to actual null */
+function parseNullable(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value === 'string' && value === 'null')
+        return null;
+    return String(value);
+}
+/** Post-process raw failsafe-parsed object into typed TaskFrontmatter */
+function postProcessFrontmatter(raw) {
+    return {
+        id: String(raw.id ?? ''),
+        title: String(raw.title ?? ''),
+        type: String(raw.type ?? 'task'),
+        priority: String(raw.priority ?? 'medium'),
+        status: String(raw.status ?? 'inbox'),
+        created: String(raw.created ?? ''),
+        epic: parseNullable(raw.epic),
+        depends_on: parseYamlArray(raw.depends_on),
+        blocks: parseYamlArray(raw.blocks),
+        assignee: parseNullable(raw.assignee),
+        branch: parseNullable(raw.branch),
+        ...(raw.due !== undefined ? { due: parseNullable(raw.due) } : {}),
+        ...(raw.blocked_reason !== undefined && raw.blocked_reason !== 'null'
+            ? { blocked_reason: String(raw.blocked_reason) }
+            : {}),
+    };
+}
+// ── Public API ──────────────────────────────────────────────────────
+/**
+ * Parse a task spec file, extracting YAML frontmatter and markdown body.
+ * Uses failsafe YAML schema to prevent date auto-conversion.
+ */
+export async function parseTaskFile(filePath) {
+    const content = await fs.readFile(filePath, 'utf-8');
+    const { yaml: yamlStr, body } = splitFrontmatter(content);
+    const raw = yaml.parse(yamlStr, { schema: 'failsafe' });
+    if (!raw || typeof raw !== 'object') {
+        throw new Error(`Failed to parse YAML frontmatter in ${filePath}`);
+    }
+    const frontmatter = postProcessFrontmatter(raw);
+    // Validate required fields
+    const required = ['id', 'title', 'status', 'priority'];
+    for (const field of required) {
+        if (!frontmatter[field]) {
+            throw new Error(`Missing required field '${field}' in ${filePath}`);
+        }
+    }
+    return {
+        frontmatter,
+        body: body.trimEnd(),
+        filePath: path.resolve(filePath),
+        fileName: path.basename(filePath),
+    };
+}
+/**
+ * Serialize a TaskSpec back to file content (YAML frontmatter + markdown body).
+ */
+export function serializeTaskFile(task) {
+    // Build the frontmatter object for serialization
+    const fm = {
+        id: task.frontmatter.id,
+        title: task.frontmatter.title,
+        type: task.frontmatter.type,
+        priority: task.frontmatter.priority,
+        status: task.frontmatter.status,
+        created: task.frontmatter.created,
+        epic: task.frontmatter.epic,
+        depends_on: task.frontmatter.depends_on,
+        blocks: task.frontmatter.blocks,
+        assignee: task.frontmatter.assignee,
+        branch: task.frontmatter.branch,
+    };
+    // Include optional fields
+    if (task.frontmatter.due !== undefined) {
+        fm.due = task.frontmatter.due;
+    }
+    if (task.frontmatter.blocked_reason !== undefined) {
+        fm.blocked_reason = task.frontmatter.blocked_reason;
+    }
+    // Use yaml.Document to set flow style on arrays for inline format
+    const doc = new yaml.Document(fm);
+    yaml.visit(doc, {
+        Seq(_key, node) {
+            node.flow = true;
+        },
+    });
+    const yamlStr = doc.toString().trimEnd();
+    const NL = String.fromCharCode(10);
+    const body = task.body ? NL + task.body : '';
+    return '---' + NL + yamlStr + NL + '---' + NL + body + NL;
+}
+/**
+ * Sort tasks by priority: critical > high > medium > low.
+ * Stable sort: tasks with same priority preserve original order.
+ * Does not mutate the original array.
+ */
+export function sortByPriority(tasks) {
+    const defaultOrder = Object.keys(PRIORITY_ORDER).length;
+    return [...tasks].sort((a, b) => {
+        const aOrder = PRIORITY_ORDER[a.frontmatter.priority] ?? defaultOrder;
+        const bOrder = PRIORITY_ORDER[b.frontmatter.priority] ?? defaultOrder;
+        return aOrder - bOrder;
+    });
+}
+/**
+ * Validate whether a status transition is allowed by the state machine.
+ */
+export function validateTransition(from, to) {
+    const allowed = ALLOWED_TRANSITIONS[from];
+    if (!allowed)
+        return false;
+    return allowed.includes(to);
+}
+/**
+ * Map a directory name to a TaskStatus. Returns null for unknown directories.
+ */
+export function getStatusForDirectory(dirName) {
+    return DIR_TO_STATUS[dirName] ?? null;
+}
+/**
+ * Map a TaskStatus to its corresponding directory name.
+ */
+export function getDirectoryForStatus(status) {
+    return STATUS_TO_DIR[status];
+}
+/**
+ * Find a task file in a directory by its frontmatter id.
+ * Returns the filename (not full path) of the matching file.
+ * Throws if no file matches.
+ */
+export async function findTaskFile(taskId, dir) {
+    const entries = await fs.readdir(dir);
+    for (const entry of entries) {
+        if (!entry.endsWith('.md'))
+            continue;
+        try {
+            const filePath = path.join(dir, entry);
+            const task = await parseTaskFile(filePath);
+            if (task.frontmatter.id === taskId) {
+                return entry;
+            }
+        }
+        catch {
+            // Skip unparseable files
+        }
+    }
+    throw new Error(`No task file with id '${taskId}' found in ${dir}`);
+}
+/**
+ * Move a task file from one directory to another, updating its status.
+ * Uses write-new-then-delete-old strategy to prevent data loss.
+ * Removes blocked_reason when moving FROM blocked status.
+ * Returns the updated TaskSpec.
+ */
+export async function moveTask(fileName, fromDir, toDir) {
+    const sourcePath = path.join(fromDir, fileName);
+    const task = await parseTaskFile(sourcePath);
+    // Determine target status from directory name
+    const toDirName = path.basename(toDir);
+    const targetStatus = getStatusForDirectory(toDirName);
+    if (!targetStatus) {
+        throw new Error(`Unknown target directory '${toDirName}'`);
+    }
+    // Validate the transition
+    const fromDirName = path.basename(fromDir);
+    const sourceStatus = getStatusForDirectory(fromDirName) ?? task.frontmatter.status;
+    if (!validateTransition(sourceStatus, targetStatus)) {
+        throw new Error(`Invalid transition: ${sourceStatus} -> ${targetStatus} for task ${task.frontmatter.id}`);
+    }
+    // Update frontmatter
+    task.frontmatter.status = targetStatus;
+    // Remove blocked_reason when leaving blocked status
+    if (sourceStatus === 'blocked') {
+        delete task.frontmatter.blocked_reason;
+    }
+    // Write to new location, then delete original
+    await fs.ensureDir(toDir);
+    const targetPath = path.join(toDir, fileName);
+    const content = serializeTaskFile(task);
+    await fs.writeFile(targetPath, content, 'utf-8');
+    // Verify write succeeded before deleting source
+    const exists = await fs.pathExists(targetPath);
+    if (!exists) {
+        throw new Error(`Failed to write task to ${targetPath}`);
+    }
+    // Delete original
+    await fs.remove(sourcePath);
+    // Update filePath to reflect new location
+    task.filePath = path.resolve(targetPath);
+    return task;
+}
+/**
+ * Move a task to the blocked/ directory with a reason.
+ * Derives blocked directory from path.dirname(fromDir).
+ */
+export async function blockTask(fileName, fromDir, reason) {
+    // Read and parse the source file first to add blocked_reason
+    const sourcePath = path.join(fromDir, fileName);
+    const task = await parseTaskFile(sourcePath);
+    // Add blocked_reason to frontmatter before moving
+    task.frontmatter.blocked_reason = reason;
+    // Write updated content back to source before moveTask reads it
+    const updatedContent = serializeTaskFile(task);
+    await fs.writeFile(sourcePath, updatedContent, 'utf-8');
+    // Derive blocked directory and move
+    const blockedDir = path.join(path.dirname(fromDir), 'blocked');
+    const result = await moveTask(fileName, fromDir, blockedDir);
+    return result;
+}
+/**
+ * List and parse all task files in a directory, sorted by priority.
+ * Reconciles status from directory name when frontmatter disagrees.
+ * Silently skips files that fail to parse.
+ */
+export async function listTasks(dirPath) {
+    const dirExists = await fs.pathExists(dirPath);
+    if (!dirExists)
+        return [];
+    const entries = await fs.readdir(dirPath);
+    const tasks = [];
+    const dirName = path.basename(dirPath);
+    const dirStatus = getStatusForDirectory(dirName);
+    for (const entry of entries) {
+        if (!entry.endsWith('.md'))
+            continue;
+        try {
+            const filePath = path.join(dirPath, entry);
+            const task = await parseTaskFile(filePath);
+            // Reconcile status from directory name (BLOCKER-2)
+            if (dirStatus !== null && task.frontmatter.status !== dirStatus) {
+                task.frontmatter.status = dirStatus;
+            }
+            tasks.push(task);
+        }
+        catch {
+            // Skip files that fail to parse (MAJOR-1)
+        }
+    }
+    return sortByPriority(tasks);
+}
+/**
+ * List all tasks from the inbox/ directory, sorted by priority.
+ * Convenience wrapper around listTasks.
+ */
+export async function listInbox(tasksRoot) {
+    return listTasks(path.join(tasksRoot, 'inbox'));
+}
+//# sourceMappingURL=task-lifecycle.js.map

package/dist/utils/task-lifecycle.js.map

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

package/dist/utils/update-agent-mcp.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Update agent templates with task manager integration instructions.
+ * Updates both installed copies (.claude/agents/) and template sources (templates/core-agents/).
+ * Returns the total number of files updated.
+ */
+export declare function updateAgentTemplatesWithMcp(): Promise<number>;
+//# sourceMappingURL=update-agent-mcp.d.ts.map

package/dist/utils/update-agent-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-agent-mcp.d.ts","sourceRoot":"","sources":["../../src/utils/update-agent-mcp.ts"],"names":[],"mappings":"AAyGA;;;;GAIG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,MAAM,CAAC,CAwBnE"}

package/dist/utils/update-agent-mcp.js

@@ -0,0 +1,115 @@
+import fs from 'fs-extra';
+import { logger } from './logger.js';
+/**
+ * Agent files to update with task manager integration instructions.
+ * Each entry specifies the file path, the section to add, and the heading
+ * to insert before.
+ */
+const AGENT_UPDATES = [
+    {
+        installedPath: '.claude/agents/maestro-agent.md',
+        templatePath: 'templates/core-agents/maestro-agent.md',
+        sectionHeading: '## Task Manager Integration',
+        insertBefore: '## Specialists',
+        content: [
+            '## Task Manager Integration',
+            '',
+            'If a task manager MCP is available (e.g., Monday.com, Linear, Jira), sync task status',
+            'at the end of each phase. Mark tasks as in-progress when starting implementation,',
+            'and done when finalization completes.',
+        ].join('\n'),
+    },
+    {
+        installedPath: '.claude/agents/maestro-headless-agent.md',
+        templatePath: 'templates/core-agents/maestro-headless-agent.md',
+        sectionHeading: '## Task Manager Integration',
+        insertBefore: '## Specialists',
+        content: [
+            '## Task Manager Integration',
+            '',
+            'If a task manager MCP is available (e.g., Monday.com, Linear, Jira), sync task status',
+            'at the end of each phase. Mark tasks as in-progress when starting implementation,',
+            'and done when finalization completes.',
+        ].join('\n'),
+    },
+    {
+        installedPath: '.claude/agents/finalization-agent.md',
+        templatePath: 'templates/core-agents/finalization-agent.md',
+        sectionHeading: '## Task Manager Sync',
+        insertBefore: '## Output Format',
+        content: [
+            '## Task Manager Sync',
+            '',
+            'If a task manager MCP is available, update the task status to reflect completion.',
+            'Move completed items to the appropriate done/completed state.',
+        ].join('\n'),
+    },
+    {
+        installedPath: '.claude/agents/task-orchestrator.md',
+        templatePath: 'templates/core-agents/task-orchestrator.md',
+        sectionHeading: '## External Task Manager',
+        insertBefore: '## Output Format',
+        content: [
+            '## External Task Manager',
+            '',
+            'If a task manager MCP is configured, use it to:',
+            '- Check for new tasks/assignments',
+            '- Update task status as work progresses',
+            '- Sync Archai task states with the external board',
+        ].join('\n'),
+    },
+];
+/**
+ * Add a section to a markdown file before a target heading.
+ * Returns true if the file was updated, false if skipped.
+ */
+async function addSectionToFile(filePath, sectionHeading, insertBefore, sectionContent) {
+    if (!await fs.pathExists(filePath)) {
+        logger.debug(`File not found, skipping: ${filePath}`);
+        return false;
+    }
+    let content = await fs.readFile(filePath, 'utf-8');
+    // Check if section already exists (idempotent)
+    if (content.includes(sectionHeading)) {
+        logger.debug(`Section already exists in: ${filePath}`);
+        return false;
+    }
+    // Find the target heading to insert before
+    const targetIndex = content.indexOf(insertBefore);
+    if (targetIndex === -1) {
+        // Fallback: append before the last line
+        logger.debug(`Target heading "${insertBefore}" not found in ${filePath}, appending at end`);
+        if (!content.endsWith('\n'))
+            content += '\n';
+        content += '\n---\n\n' + sectionContent + '\n';
+    }
+    else {
+        // Insert the section before the target heading
+        // Add a separator between sections
+        const insertion = sectionContent + '\n\n---\n\n';
+        content = content.slice(0, targetIndex) + insertion + content.slice(targetIndex);
+    }
+    await fs.writeFile(filePath, content);
+    logger.debug(`Updated agent: ${filePath}`);
+    return true;
+}
+/**
+ * Update agent templates with task manager integration instructions.
+ * Updates both installed copies (.claude/agents/) and template sources (templates/core-agents/).
+ * Returns the total number of files updated.
+ */
+export async function updateAgentTemplatesWithMcp() {
+    let updatedCount = 0;
+    for (const update of AGENT_UPDATES) {
+        // Update installed copy
+        const installedUpdated = await addSectionToFile(update.installedPath, update.sectionHeading, update.insertBefore, update.content);
+        if (installedUpdated)
+            updatedCount++;
+        // Update template source (so new installations get the section too)
+        const templateUpdated = await addSectionToFile(update.templatePath, update.sectionHeading, update.insertBefore, update.content);
+        if (templateUpdated)
+            updatedCount++;
+    }
+    return updatedCount;
+}
+//# sourceMappingURL=update-agent-mcp.js.map

package/dist/utils/update-agent-mcp.js.map

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

package/dist/utils/update-agent-templates.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Update installed agent files to reference the discovered default branch
+ * instead of hardcoded main/master/develop.
+ */
+export declare function updateAgentTemplates(defaultBranch: string): Promise<number>;
+//# sourceMappingURL=update-agent-templates.d.ts.map

package/dist/utils/update-agent-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-agent-templates.d.ts","sourceRoot":"","sources":["../../src/utils/update-agent-templates.ts"],"names":[],"mappings":"AAqCA;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBjF"}

package/dist/utils/update-agent-templates.js

@@ -0,0 +1,56 @@
+import fs from 'fs-extra';
+import { logger } from './logger.js';
+/**
+ * Installed agent files that contain the branch check pattern.
+ * These are the files that get updated with the discovered default branch.
+ * Template source files in templates/core-agents/ are NOT modified
+ * (they keep the generic pattern for new installations).
+ */
+const INSTALLED_AGENTS = [
+    {
+        path: '.claude/agents/iteration-controller.md',
+        pattern: /- If on `main`\/`master`\/`develop`/g,
+        buildReplacement: (branch) => `- If on \`${branch}\``,
+    },
+    {
+        path: '.claude/agents/task-orchestrator.md',
+        pattern: /- If on `main`\/`master`\/`develop`\/`release\/\*`/g,
+        buildReplacement: (branch) => `- If on \`${branch}\`/\`release/*\``,
+    },
+    {
+        // Legacy name - may exist in older installations
+        path: '.claude/agents/maestro-agent.md',
+        pattern: /- If on `main`\/`master`\/`develop`/g,
+        buildReplacement: (branch) => `- If on \`${branch}\``,
+    },
+    {
+        path: '.claude/agents/maestro-headless-agent.md',
+        pattern: /- If on `main`\/`master`\/`develop`/g,
+        buildReplacement: (branch) => `- If on \`${branch}\``,
+    },
+];
+/**
+ * Update installed agent files to reference the discovered default branch
+ * instead of hardcoded main/master/develop.
+ */
+export async function updateAgentTemplates(defaultBranch) {
+    let updatedCount = 0;
+    for (const target of INSTALLED_AGENTS) {
+        const replacement = target.buildReplacement(defaultBranch);
+        if (!await fs.pathExists(target.path)) {
+            logger.debug(`Agent file not found, skipping: ${target.path}`);
+            continue;
+        }
+        const content = await fs.readFile(target.path, 'utf-8');
+        const newContent = content.replace(target.pattern, replacement);
+        if (newContent === content) {
+            logger.debug(`No changes needed in: ${target.path}`);
+            continue;
+        }
+        await fs.writeFile(target.path, newContent);
+        updatedCount++;
+        logger.debug(`Updated agent: ${target.path}`);
+    }
+    return updatedCount;
+}
+//# sourceMappingURL=update-agent-templates.js.map

package/dist/utils/update-agent-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-agent-templates.js","sourceRoot":"","sources":["../../src/utils/update-agent-templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG;IACvB;QACE,IAAI,EAAE,wCAAwC;QAC9C,OAAO,EAAE,sCAAsC;QAC/C,gBAAgB,EAAE,CAAC,MAAc,EAAE,EAAE,CACnC,aAAa,MAAM,IAAI;KAC1B;IACD;QACE,IAAI,EAAE,qCAAqC;QAC3C,OAAO,EAAE,qDAAqD;QAC9D,gBAAgB,EAAE,CAAC,MAAc,EAAE,EAAE,CACnC,aAAa,MAAM,kBAAkB;KACxC;IACD;QACE,iDAAiD;QACjD,IAAI,EAAE,iCAAiC;QACvC,OAAO,EAAE,sCAAsC;QAC/C,gBAAgB,EAAE,CAAC,MAAc,EAAE,EAAE,CACnC,aAAa,MAAM,IAAI;KAC1B;IACD;QACE,IAAI,EAAE,0CAA0C;QAChD,OAAO,EAAE,sCAAsC;QAC/C,gBAAgB,EAAE,CAAC,MAAc,EAAE,EAAE,CACnC,aAAa,MAAM,IAAI;KAC1B;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,aAAqB;IAC9D,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,MAAM,WAAW,GAAG,MAAM,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;QAE3D,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,KAAK,CAAC,mCAAmC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/D,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAEhE,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;YAC3B,MAAM,CAAC,KAAK,CAAC,yBAAyB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACrD,SAAS;QACX,CAAC;QAED,MAAM,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC5C,YAAY,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/utils/update-config-ci.d.ts

@@ -0,0 +1,7 @@
+import type { CIDetectionResult } from "../types/index.js";
+/**
+ * Update archai.config.md with a CI/CD section.
+ * If the section already exists, replaces it. Otherwise inserts before ## Notes.
+ */
+export declare function updateConfigWithCI(result: CIDetectionResult): Promise<void>;
+//# sourceMappingURL=update-config-ci.d.ts.map

package/dist/utils/update-config-ci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-config-ci.d.ts","sourceRoot":"","sources":["../../src/utils/update-config-ci.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAc3D;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDjF"}