@e0ipso/ai-task-manager 1.36.0 → 1.37.0

package/dist/utils.js

@@ -1,153 +1,87 @@
 "use strict";
 /**
- * Helper Functions for File Operations
+ * Helper Functions for the CLI
  *
- * This file contains utility functions for file system operations,
- * path manipulation, and other common tasks used by the CLI
+ * Validation helpers for the `--harnesses` option.
  */
-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.parseAssistants = parseAssistants;
-exports.validateAssistants = validateAssistants;
-exports.getTemplateFormat = getTemplateFormat;
+exports.parseHarnesses = parseHarnesses;
+exports.validateHarnesses = validateHarnesses;
 exports.parseFrontmatter = parseFrontmatter;
 exports.escapeTomlString = escapeTomlString;
 exports.escapeTomlTripleQuotedString = escapeTomlTripleQuotedString;
-exports.convertMdToToml = convertMdToToml;
-exports.convertMdToGitHubPrompt = convertMdToGitHubPrompt;
-exports.readAndProcessTemplate = readAndProcessTemplate;
-exports.writeProcessedTemplate = writeProcessedTemplate;
-const fs = __importStar(require("fs-extra"));
-const path = __importStar(require("path"));
+exports.convertAgentMdToToml = convertAgentMdToToml;
+exports.getAgentFormat = getAgentFormat;
+const VALID_HARNESSES = [
+    'claude',
+    'codex',
+    'cursor',
+    'gemini',
+    'github',
+    'opencode',
+];
 /**
- * Parse comma-separated assistant values into an array
- * @param value - Comma-separated string of assistant names
- * @returns Array of assistant names
- * @throws Error if invalid assistant names are provided
+ * Parse comma-separated harness values into an array
+ * @param value - Comma-separated string of harness names
+ * @returns Array of harness names
+ * @throws Error if invalid harness names are provided
  */
-function parseAssistants(value) {
-    const validAssistants = [
-        'claude',
-        'codex',
-        'cursor',
-        'gemini',
-        'github',
-        'opencode',
-    ];
+function parseHarnesses(value) {
     if (!value.trim()) {
-        throw new Error('Assistants parameter cannot be empty');
+        throw new Error('Harnesses parameter cannot be empty');
     }
-    const assistants = value
+    const harnesses = value
         .split(',')
         .map(a => a.trim().toLowerCase())
         .filter(a => a.length > 0);
-    // Validate that all assistants are valid
-    const invalidAssistants = assistants.filter((assistant) => !validAssistants.includes(assistant));
-    if (invalidAssistants.length > 0) {
-        throw new Error(`Invalid assistant(s): ${invalidAssistants.join(', ')}. Valid options are: ${validAssistants.join(', ')}`);
+    const invalidHarnesses = harnesses.filter((harness) => !VALID_HARNESSES.includes(harness));
+    if (invalidHarnesses.length > 0) {
+        throw new Error(`Invalid harness(es): ${invalidHarnesses.join(', ')}. Valid options are: ${VALID_HARNESSES.join(', ')}`);
     }
-    // Remove duplicates and return
-    return Array.from(new Set(assistants));
+    return Array.from(new Set(harnesses));
 }
 /**
- * Validate that all assistants are supported
- * @param assistants - Array of assistants to validate
- * @throws Error if any assistant is invalid or array is empty
+ * Validate that all harnesses are supported
+ * @param harnesses - Array of harnesses to validate
+ * @throws Error if any harness is invalid or array is empty
  */
-function validateAssistants(assistants) {
-    const validAssistants = [
-        'claude',
-        'codex',
-        'cursor',
-        'gemini',
-        'github',
-        'opencode',
-    ];
-    if (assistants.length === 0) {
-        throw new Error('At least one assistant must be specified');
+function validateHarnesses(harnesses) {
+    if (harnesses.length === 0) {
+        throw new Error('At least one harness must be specified');
     }
-    for (const assistant of assistants) {
-        if (!validAssistants.includes(assistant)) {
-            throw new Error(`Invalid assistant: ${assistant}. Supported assistants: ${validAssistants.join(', ')}`);
+    for (const harness of harnesses) {
+        if (!VALID_HARNESSES.includes(harness)) {
+            throw new Error(`Invalid harness: ${harness}. Supported harnesses: ${VALID_HARNESSES.join(', ')}`);
         }
     }
 }
 /**
- * Get the template format for a specific assistant
- * @param assistant - The assistant type
- * @returns The template format to use ('md' for Claude/Open Code, 'toml' for Gemini)
- */
-function getTemplateFormat(assistant) {
-    switch (assistant) {
-        case 'claude':
-            return 'md';
-        case 'codex':
-            return 'md';
-        case 'cursor':
-            return 'md';
-        case 'gemini':
-            return 'toml';
-        case 'github':
-            return 'md'; // GitHub prompt files use Markdown
-        case 'opencode':
-            return 'md';
-        default:
-            // This should never happen due to type safety, but adding for completeness
-            throw new Error(`Unknown assistant type: ${assistant}`);
-    }
-}
-/**
- * Parse YAML frontmatter from markdown content
- * @param content - The markdown content with frontmatter
- * @returns Object containing frontmatter and body content
+ * Extract YAML frontmatter and body from a markdown string.
+ * Returns an empty frontmatter object when no fences are found.
  */
 function parseFrontmatter(content) {
     const frontmatterRegex = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n([\s\S]*))?$/;
     const match = content.match(frontmatterRegex);
     if (!match) {
-        return {
-            frontmatter: {},
-            body: content,
-        };
+        return { frontmatter: {}, body: content };
     }
-    const frontmatterContent = match[1] || '';
-    const bodyContent = match[2] || ''; // match[2] is now undefined when no body exists
-    // Simple YAML parser for our specific use case
     const frontmatter = {};
-    const lines = frontmatterContent.split('\n');
+    const lines = (match[1] || '').split('\n');
+    let currentKey = '';
+    let multilineValue = [];
+    const flushMultiline = () => {
+        if (currentKey && multilineValue.length > 0) {
+            frontmatter[currentKey] = multilineValue.join('\n');
+        }
+        currentKey = '';
+        multilineValue = [];
+    };
     for (const line of lines) {
+        if (currentKey && (line.startsWith('  ') || line.startsWith('\t'))) {
+            multilineValue.push(line.replace(/^ {2}/, '').replace(/^\t/, ''));
+            continue;
+        }
+        flushMultiline();
         const trimmed = line.trim();
         if (!trimmed || trimmed.startsWith('#'))
             continue;
@@ -156,18 +90,19 @@ function parseFrontmatter(content) {
             continue;
         const key = trimmed.substring(0, colonIndex).trim();
         const value = trimmed.substring(colonIndex + 1).trim();
-        // Remove quotes if present
-        frontmatter[key] = value.replace(/^["']|["']$/g, '');
+        if (value === '|' || value === '>') {
+            currentKey = key;
+            multilineValue = [];
+        }
+        else {
+            frontmatter[key] = value.replace(/^["']|["']$/g, '');
+        }
     }
-    return {
-        frontmatter,
-        body: bodyContent,
-    };
+    flushMultiline();
+    return { frontmatter, body: (match[2] || '').trimStart() };
 }
 /**
- * Escape a string for TOML format
- * @param str - The string to escape
- * @returns The escaped string suitable for TOML
+ * Escape a string for use inside a TOML basic (double-quoted) string.
  */
 function escapeTomlString(str) {
     return str
@@ -178,107 +113,46 @@ function escapeTomlString(str) {
         .replace(/\t/g, '\\t');
 }
 /**
- * Escape a string for TOML triple-quoted format
- * Triple-quoted strings in TOML do NOT interpret escape sequences,
- * so we preserve newlines and only escape triple-quote boundaries.
- * However, some TOML parsers (notably Gemini's) treat backslashes as escape
- * characters even in triple-quoted strings, so we must escape them.
- * @param str - The string to escape
- * @returns The escaped string suitable for TOML triple-quoted strings
+ * Escape a string for use inside a TOML multi-line basic (triple-quoted) string.
  */
 function escapeTomlTripleQuotedString(str) {
-    return (str
-        // Escape backslashes first to prevent them being treated as escape characters
-        // by non-compliant TOML parsers (notably Gemini's parser)
-        .replace(/\\/g, '\\\\')
-        // Escape triple-quote sequences that would break the string delimiters
-        .replace(/"""/g, '"\\"'));
+    return str.replace(/\\\\/g, '\\\\\\\\').replace(/"""/g, '"\\""');
 }
 /**
- * Convert markdown template content to TOML format for Gemini
- * @param mdContent - The markdown template content
- * @returns The converted TOML content
+ * Convert a canonical agent markdown template (with YAML frontmatter
+ * containing `name` and `description`) into Codex's TOML agent format.
  */
-function convertMdToToml(mdContent) {
+function convertAgentMdToToml(mdContent) {
     const { frontmatter, body } = parseFrontmatter(mdContent);
-    // Process the body content for Gemini format
-    const processedBody = body
-        // Transform $ARGUMENTS → {{args}} (not followed by alphanumeric that would make it an identifier)
-        .replace(/\$ARGUMENTS(?![0-9])/g, '{{args}}')
-        // Transform $1 → {{plan_id}} (exact match, not part of longer number)
-        .replace(/\$1(?![0-9])/g, '{{plan_id}}')
-        .replace(/\$2(?![0-9])/g, '{{param2}}')
-        .replace(/\$3(?![0-9])/g, '{{param3}}');
-    // Build TOML content
-    // prompt must be at the root, so it comes before [metadata] table
-    let tomlContent = `prompt = """${escapeTomlTripleQuotedString(processedBody)}"""\n\n`;
-    tomlContent += '[metadata]\n';
-    // Add frontmatter fields to metadata section
-    for (const [key, value] of Object.entries(frontmatter)) {
-        if (key === 'argument-hint') {
-            // Special handling for argument-hint - convert to {{}} format
-            const convertedHint = String(value)
-                .replace(/\[planId\]/g, '{{plan_id}}')
-                .replace(/\[taskId\]/g, '{{task_id}}')
-                .replace(/\[userPrompt\]/g, '{{args}}')
-                .replace(/\[testCommand\]/g, '{{test_command}}');
-            tomlContent += `argument-hint = "${escapeTomlString(convertedHint)}"\n`;
-        }
-        else {
-            tomlContent += `${key} = "${escapeTomlString(String(value))}"\n`;
-        }
-    }
-    return tomlContent;
+    const name = escapeTomlString(frontmatter.name || '');
+    const description = escapeTomlString((frontmatter.description || '').trim());
+    const instructions = escapeTomlTripleQuotedString(body.trim());
+    return [
+        `name = "${name}"`,
+        `description = "${description}"`,
+        `developer_instructions = """`,
+        instructions,
+        `"""`,
+        '',
+    ].join('\n');
 }
 /**
- * Convert markdown template content to GitHub Copilot prompt file format
- * @param mdContent - The markdown template content
- * @returns The converted prompt file content
+ * Return the agent file format, extension, and target directory for a harness.
  */
-function convertMdToGitHubPrompt(mdContent) {
-    const { frontmatter, body } = parseFrontmatter(mdContent);
-    // Build GitHub prompt frontmatter
-    let promptContent = '---\n';
-    promptContent += `description: ${frontmatter.description || 'Task management command'}\n`;
-    promptContent += '---\n\n';
-    // Add $ARGUMENTS placeholder
-    promptContent += '$ARGUMENTS\n\n';
-    // Add template body (no variable conversion needed - GitHub supports $ARGUMENTS natively)
-    promptContent += body;
-    return promptContent;
-}
-/**
- * Read a markdown template file and optionally convert to TOML or GitHub prompt format
- * @param templatePath - Path to the markdown template
- * @param targetFormat - Target format ('md' or 'toml')
- * @param assistant - Optional assistant type for format-specific processing
- * @returns The template content in the requested format
- */
-async function readAndProcessTemplate(templatePath, targetFormat, assistant) {
-    const mdContent = await fs.readFile(templatePath, 'utf-8');
-    if (targetFormat === 'md') {
-        // Check if GitHub assistant needs special processing
-        if (assistant === 'github') {
-            return convertMdToGitHubPrompt(mdContent);
-        }
-        return mdContent; // Claude and OpenCode use raw Markdown
-    }
-    else if (targetFormat === 'toml') {
-        return convertMdToToml(mdContent); // Gemini conversion
-    }
-    else {
-        throw new Error(`Unsupported template format: ${targetFormat}`);
+function getAgentFormat(harness) {
+    switch (harness) {
+        case 'codex':
+            return { format: 'toml', extension: '.toml', directory: '.codex/agents' };
+        case 'github':
+            return { format: 'md', extension: '.agent.md', directory: '.github/agents' };
+        case 'claude':
+            return { format: 'md', extension: '.md', directory: '.claude/agents' };
+        case 'gemini':
+            return { format: 'md', extension: '.md', directory: '.gemini/agents' };
+        case 'cursor':
+            return { format: 'md', extension: '.md', directory: '.cursor/agents' };
+        case 'opencode':
+            return { format: 'md', extension: '.md', directory: '.opencode/agents' };
     }
 }
-/**
- * Write processed template content to destination
- * @param content - The template content to write
- * @param destPath - Destination file path
- */
-async function writeProcessedTemplate(content, destPath) {
-    // Ensure destination directory exists
-    await fs.ensureDir(path.dirname(destPath));
-    // Write the content
-    await fs.writeFile(destPath, content, 'utf-8');
-}
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@e0ipso/ai-task-manager",
-  "version": "1.36.0",
+  "version": "1.37.0",
   "description": "Task management for AI coding assistants",
   "main": "dist/index.js",
   "bin": {
     "ai-task-manager": "dist/cli.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && npm run build:skills",
+    "build:skills": "tsc --noEmit -p tsconfig.skill-scripts.json && node scripts/build-skills.cjs",
     "dev": "tsc --watch",
     "start": "node dist/cli.js",
     "test": "jest",
@@ -77,6 +78,7 @@
     "@types/node": "^24.3.0",
     "@typescript-eslint/eslint-plugin": "^8.41.0",
     "@typescript-eslint/parser": "^8.41.0",
+    "esbuild": "^0.28.0",
     "eslint": "^9.34.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",

package/templates/ai-task-manager/config/TASK_MANAGER.md

@@ -1,7 +1,7 @@
 # Task Manager General Information
 
-This document contains important information that is common to all the /task:*
-commands for AI assistants.
+This document contains important information that is common to all the
+task-manager skills your AI assistant uses to plan, decompose, and execute work.
 
 ## Types of Documents
 
@@ -66,7 +66,7 @@ Plans follow a lifecycle that maintains workspace organization:
 
 1. **Active Plans**: When created, plans are placed in the `plans/` directory where they remain while being worked on.
 
-2. **Completed Plans**: Upon successful execution of a blueprint (via `/tasks:execute-blueprint`), the entire plan directory is automatically moved from `plans/` to `archive/`.
+2. **Completed Plans**: Upon successful execution of a blueprint (via the `task-execute-blueprint` skill), the entire plan directory is automatically moved from `plans/` to `archive/`.
 
 3. **Archive Directory**: The `archive/` directory serves as permanent storage for completed work. This separation keeps the active workspace clean while preserving completed plans for reference.
 

package/templates/ai-task-manager/config/hooks/PRE_PHASE.md

@@ -4,38 +4,18 @@
 
 ### Feature Branch Creation
 
-Create a feature branch for this plan execution (only runs from main/master with a clean working tree):
+Create a feature branch for this plan execution:
 
-```bash
-# Create feature branch (handles all edge cases automatically)
-node $root/config/scripts/create-feature-branch.cjs $1
-
-# Exit codes:
-#   0 = Success (branch created, already exists, or not on main/master)
-#   1 = Error (not git repo, uncommitted changes, or plan not found)
-```
-
-**Behavior**:
-- From `main`/`master` with clean tree: Creates `feature/{planId}--{plan-name}` branch
-- From `main`/`master` with uncommitted changes: Exits with error (exit 1)
-- From feature branch: Proceeds without creating a new branch
-- Branch already exists: Proceeds normally
+- From `main`/`master` with a clean working tree: create a branch named `feature/{planId}--{plan-name}` and switch to it.
+- From `main`/`master` with uncommitted changes: halt with an error — do not proceed.
+- Already on a feature branch: proceed without creating a new branch.
+- Branch already exists: switch to it and proceed normally.
 
 ## Phase Execution Workflow
 
 1. **Phase Initialization**
     - Identify current phase from the execution blueprint
     - List all tasks scheduled for parallel execution in this phase
-    - **Validate Task Dependencies**: For each task in the current phase, use the dependency checking script:
-        ```bash
-        # For each task in current phase
-        for TASK_ID in $PHASE_TASKS; do
-            if ! node .ai/task-manager/config/scripts/check-task-dependencies.cjs "$1" "$TASK_ID"; then
-                echo "ERROR: Task $TASK_ID has unresolved dependencies - cannot proceed with phase execution"
-                echo "Please resolve dependencies before continuing with blueprint execution"
-                exit 1
-            fi
-        done
-        ```
+    - **Validate Task Dependencies**: For each task in the current phase, verify that all declared dependencies (from the task's YAML frontmatter `dependencies` array) have status `completed`. If any dependency is unresolved, halt the phase and report the blocking dependencies before continuing.
     - Confirm no tasks are marked "needs-clarification"
     - If any phases are marked as completed, verify they are actually completed and continue from the next phase.

package/templates/ai-task-manager/config/hooks/PRE_TASK_ASSIGNMENT.md

@@ -9,12 +9,12 @@
     - Select the most appropriate sub-agent (if any are available). If no sub-agent is appropriate, use the general-purpose one.
     - Consider task-specific requirements from the task document
 
-[IMPORTANT] Analyze the set of tasks skills in order to engage any relevant assistant skills as necessary (either global
+[IMPORTANT] Analyze the set of tasks skills in order to engage any relevant harness skills as necessary (either global
 or project skills).
 
 
 ## Available Sub-Agents
-Analyze the sub-agents available in your current assistant's agents directory. If none are available or the available
+Analyze the sub-agents available in your current harness's agents directory. If none are available or the available
 ones do not match the task's requirements, then use a generic agent.
 
 ## Matching Criteria
@@ -26,25 +26,7 @@ Select agents based on:
 
 ## Skills Extraction and Agent Detection
 
-Read task skills and select appropriate task-specific agent:
-
-```bash
-# Extract skills from task frontmatter
-TASK_SKILLS=$(node "$root/config/scripts/extract-task-skills.cjs" "$TASK_FILE")
-
-echo "Task skills required: $TASK_SKILLS"
-
-# Check for available sub-agents across assistant directories
-AGENT_FOUND=false
-for assistant_dir in .claude .gemini .opencode; do
-    if [ -d "$assistant_dir/agents" ] && [ -n "$(ls $assistant_dir/agents 2>/dev/null)" ]; then
-        echo "Available sub-agents detected in $assistant_dir - will match to task requirements"
-        AGENT_FOUND=true
-        break
-    fi
-done
-
-if [ "$AGENT_FOUND" = false ]; then
-    echo "Using general-purpose agent for task execution"
-fi
-```
+1. Read the `skills` array from the task's YAML frontmatter directly.
+2. Check for available sub-agents in your harness's agents directory.
+3. If matching sub-agents are found, select the most appropriate one based on the task's required skills.
+4. If no sub-agents are available or none match, use a general-purpose agent for task execution.

package/templates/ai-task-manager/config/templates/PLAN_TEMPLATE.md

@@ -89,7 +89,7 @@ Avoid vague statements like "verify it works" or "ensure quality". Each step mus
 
 ## Documentation
 
-[Required documentation updates to existing documentation, either human-focused documentation, the project's README.md or assistant-focused documentation like AGENTS.md, .claude/skills/* for the site, etc.]
+[Required documentation updates to existing documentation, either human-focused documentation like README.md or AI-facing documentation like AGENTS.md and related configuration files.]
 
 ## Resource Requirements
 

package/templates/{assistant → harness}/agents/plan-creator.md

@@ -18,7 +18,7 @@ Create strategic blueprints that define WHAT to build and WHY, not HOW. Your pla
 ## Critical Workflow
 
 **1. Context Gathering**
-- Read CLAUDE.md, README.md, package.json
+- Read project instructions (AGENTS.md, README.md, or equivalent)
 - Search codebase for similar patterns
 - Ask specific, categorized clarification questions when gaps exist
 - STOP and wait for answers before planning
@@ -73,7 +73,7 @@ Eliminate these anti-patterns:
 1. Execute PRE_PLAN.md hook if exists
 2. Analyze user input and search codebase
 3. Ask clarification questions if needed (STOP until answered)
-4. Generate Plan ID: `node .ai/task-manager/config/scripts/get-next-plan-id.cjs`
+4. Generate Plan ID: scan `.ai/task-manager/plans/` and `.ai/task-manager/archive/` for existing plan directories, extract the highest numeric `id` from their YAML frontmatter, and add 1. If no plans exist, use ID 1.
 5. Create plan at `.ai/task-manager/plans/[ID]--[name]/plan-[ID]--[name].md`
 6. Execute POST_PLAN.md hook if exists
 7. Output: