@e0ipso/ai-task-manager 1.36.1 → 1.38.0

package/templates/ai-task-manager/config/scripts/check-task-dependencies.cjs

@@ -1,240 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Script: check-task-dependencies.cjs
- * Purpose: Check if a task has all of its dependencies resolved (completed)
- * Usage: node check-task-dependencies.cjs <plan-id> <task-id>
- * Returns: 0 if all dependencies are resolved, 1 if not
- */
-
-const fs = require('fs');
-const path = require('path');
-const {
-  resolvePlan,
-  parseFrontmatter
-} = require('./shared-utils.cjs');
-
-// Color functions for output
-const _printError = (message) => {
-  console.error(`ERROR: ${message}`);
-};
-
-const _printSuccess = (message) => {
-  console.log(`✓ ${message}`);
-};
-
-const _printWarning = (message) => {
-  console.log(`⚠ ${message}`);
-};
-
-const _printInfo = (message) => {
-  console.log(message);
-};
-
-// Function to find task file with padded/unpadded ID handling
-const _findTaskFile = (planDir, taskId) => {
-  const taskDir = path.join(planDir, 'tasks');
-
-  if (!fs.existsSync(taskDir)) {
-    return null;
-  }
-
-  const variations = [
-    taskId,
-    taskId.padStart(2, '0'),
-    taskId.replace(/^0+/, '') || '0'
-  ];
-
-  const uniqueVariations = [...new Set(variations)];
-
-  try {
-    const files = fs.readdirSync(taskDir);
-    const found = uniqueVariations.reduce((acc, v) => {
-      if (acc) return acc;
-      const match = files.find(f => f.startsWith(`${v}--`) && f.endsWith('.md'));
-      return match ? path.join(taskDir, match) : null;
-    }, null);
-    return found;
-  } catch (err) {
-    return null;
-  }
-};
-
-
-// Function to extract dependencies from frontmatter
-const _extractDependencies = (frontmatter) => {
-  const lines = frontmatter.split('\n');
-  const dependencies = [];
-  let inDependenciesSection = false;
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-
-    // Check for dependencies line
-    if (line.match(/^dependencies:/)) {
-      inDependenciesSection = true;
-
-      // Check if dependencies are on the same line (array syntax)
-      const arrayMatch = line.match(/\[(.*)\]/);
-      if (arrayMatch) {
-        const deps = arrayMatch[1]
-          .split(',')
-          .map(dep => dep.trim().replace(/['"]/g, ''))
-          .filter(dep => dep.length > 0);
-        dependencies.push(...deps);
-        inDependenciesSection = false;
-      }
-      continue;
-    }
-
-    // If we're in dependencies section and hit a non-indented line that's not a list item, exit
-    if (inDependenciesSection && line.match(/^[^ ]/) && !line.match(/^[ \t]*-/)) {
-      inDependenciesSection = false;
-    }
-
-    // Parse list format dependencies
-    if (inDependenciesSection && line.match(/^[ \t]*-/)) {
-      const dep = line.replace(/^[ \t]*-[ \t]*/, '').replace(/[ \t]*$/, '').replace(/['"]/g, '');
-      if (dep.length > 0) {
-        dependencies.push(dep);
-      }
-    }
-  }
-
-  return dependencies;
-};
-
-// Function to extract status from frontmatter
-const _extractStatus = (frontmatter) => {
-  const lines = frontmatter.split('\n');
-
-  for (const line of lines) {
-    if (line.match(/^status:/)) {
-      return line.replace(/^status:[ \t]*/, '').replace(/^["']/, '').replace(/["']$/, '').trim();
-    }
-  }
-
-  return null;
-};
-
-// Main function
-const _main = (startPath = process.cwd()) => {
-  // Check arguments
-  if (process.argv.length !== 4) {
-    _printError('Invalid number of arguments');
-    console.log('Usage: node check-task-dependencies.cjs <plan-id-or-path> <task-id>');
-    console.log('Example: node check-task-dependencies.cjs 16 03');
-    process.exit(1);
-  }
-
-  const inputId = process.argv[2];
-  const taskId = process.argv[3];
-
-  const resolved = resolvePlan(inputId, startPath);
-
-  if (!resolved) {
-    _printError(`Plan "${inputId}" not found or invalid`);
-    process.exit(1);
-  }
-
-  const {
-    planDir,
-    planId
-  } = resolved;
-  _printInfo(`Found plan directory: ${planDir}`);
-
-  // Find task file
-  const taskFile = _findTaskFile(planDir, taskId);
-
-  if (!taskFile || !fs.existsSync(taskFile)) {
-    _printError(`Task with ID ${taskId} not found in plan ${planId}`);
-    process.exit(1);
-  }
-
-  _printInfo(`Checking task: ${path.basename(taskFile)}`);
-  console.log('');
-
-  // Read and parse task file
-  const taskContent = fs.readFileSync(taskFile, 'utf8');
-  const frontmatter = parseFrontmatter(taskContent);
-  const dependencies = _extractDependencies(frontmatter);
-
-  // Check if there are any dependencies
-  if (dependencies.length === 0) {
-    _printSuccess('Task has no dependencies - ready to execute!');
-    process.exit(0);
-  }
-
-  // Display dependencies
-  _printInfo('Task dependencies found:');
-  dependencies.forEach(dep => {
-    console.log(`  - Task ${dep}`);
-  });
-  console.log('');
-
-  // Check each dependency
-  let allResolved = true;
-  let unresolvedDeps = [];
-  let resolvedCount = 0;
-  const totalDeps = dependencies.length;
-
-  _printInfo('Checking dependency status...');
-  console.log('');
-
-  for (const depId of dependencies) {
-    // Find dependency task file
-    const depFile = _findTaskFile(planDir, depId);
-
-    if (!depFile || !fs.existsSync(depFile)) {
-      _printError(`Dependency task ${depId} not found`);
-      allResolved = false;
-      unresolvedDeps.push(`${depId} (not found)`);
-      continue;
-    }
-
-    // Extract status from dependency task
-    const depContent = fs.readFileSync(depFile, 'utf8');
-    const depFrontmatter = parseFrontmatter(depContent);
-    const status = _extractStatus(depFrontmatter);
-
-    // Check if status is completed
-    if (status === 'completed') {
-      _printSuccess(`Task ${depId} - Status: completed ✓`);
-      resolvedCount++;
-    } else {
-      _printWarning(`Task ${depId} - Status: ${status || 'unknown'} ✗`);
-      allResolved = false;
-      unresolvedDeps.push(`${depId} (${status || 'unknown'})`);
-    }
-  }
-
-  console.log('');
-  _printInfo('=========================================');
-  _printInfo('Dependency Check Summary');
-  _printInfo('=========================================');
-  _printInfo(`Total dependencies: ${totalDeps}`);
-  _printInfo(`Resolved: ${resolvedCount}`);
-  _printInfo(`Unresolved: ${totalDeps - resolvedCount}`);
-  console.log('');
-
-  if (allResolved) {
-    _printSuccess(`All dependencies are resolved! Task ${taskId} is ready to execute.`);
-    process.exit(0);
-  } else {
-    _printError(`Task ${taskId} has unresolved dependencies:`);
-    unresolvedDeps.forEach(dep => {
-      console.log(dep);
-    });
-    _printInfo('Please complete the dependencies before executing this task.');
-    process.exit(1);
-  }
-};
-
-// Run the script
-if (require.main === module) {
-  _main();
-}
-
-module.exports = {
-  _main
-};

package/templates/ai-task-manager/config/scripts/compose-prompt.cjs

@@ -1,234 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Runtime Prompt Composition Script
- *
- * Reads markdown command files, performs variable substitution, and outputs
- * composed prompts to enable uninterrupted workflow execution.
- *
- * Usage:
- *   node compose-prompt.cjs --template "create-plan.md" --variable "ARGUMENTS=user input" --variable "1=51"
- *
- * Arguments:
- *   --template: Relative path to template file (e.g., "create-plan.md")
- *   --variable: Key=value pairs for substitution (can be specified multiple times)
- *
- * Output:
- *   Composed markdown prompt to stdout with variables substituted
- *
- * Exit Codes:
- *   0: Success
- *   1: Error (with message to stderr)
- */
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * Parse command line arguments
- * @returns {Object} Parsed arguments with template and variables
- */
-function parseArguments() {
-  const args = process.argv.slice(2);
-  const result = {
-    template: null,
-    variables: {}
-  };
-
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === '--template') {
-      if (i + 1 >= args.length) {
-        throw new Error('--template requires a value');
-      }
-      result.template = args[++i];
-    } else if (args[i] === '--variable') {
-      if (i + 1 >= args.length) {
-        throw new Error('--variable requires a value');
-      }
-      const varArg = args[++i];
-      const eqIndex = varArg.indexOf('=');
-      if (eqIndex === -1) {
-        throw new Error(`Invalid variable format: ${varArg}. Expected format: key=value`);
-      }
-      const key = varArg.substring(0, eqIndex);
-      const value = varArg.substring(eqIndex + 1);
-      result.variables[key] = value;
-    } else {
-      throw new Error(`Unknown argument: ${args[i]}`);
-    }
-  }
-
-  if (!result.template) {
-    throw new Error('--template argument is required');
-  }
-
-  return result;
-}
-
-/**
- * Find the template file in the appropriate directory
- * Priority: .claude/commands/tasks/ then templates/assistant/commands/tasks/
- * @param {string} templateName - Relative path to template file
- * @returns {string} Absolute path to template file
- */
-function findTemplateFile(templateName) {
-  // Get the root directory (assuming script is in templates/ai-task-manager/config/scripts/)
-  const scriptDir = __dirname;
-  const rootDir = path.resolve(scriptDir, '../../../..');
-
-  // Define search paths in priority order
-  const searchPaths = [
-    path.join(rootDir, '.claude', 'commands', 'tasks', templateName),
-    path.join(rootDir, 'templates', 'assistant', 'commands', 'tasks', templateName)
-  ];
-
-  for (const searchPath of searchPaths) {
-    if (fs.existsSync(searchPath)) {
-      return searchPath;
-    }
-  }
-
-  throw new Error(`Template not found: ${templateName}`);
-}
-
-/**
- * Parse YAML frontmatter from markdown content
- * Based on the parseFrontmatter function from src/utils.ts
- * @param {string} content - The markdown content with frontmatter
- * @returns {Object} Object containing frontmatter and body content
- */
-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
-    };
-  }
-
-  const frontmatterContent = match[1] || '';
-  const bodyContent = match[2] || '';
-
-  // Simple YAML parser for our specific use case
-  const frontmatter = {};
-  const lines = frontmatterContent.split('\n');
-
-  for (const line of lines) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith('#')) continue;
-
-    const colonIndex = trimmed.indexOf(':');
-    if (colonIndex === -1) continue;
-
-    const key = trimmed.substring(0, colonIndex).trim();
-    const value = trimmed.substring(colonIndex + 1).trim();
-
-    // Remove quotes if present
-    frontmatter[key] = value.replace(/^["']|["']$/g, '');
-  }
-
-  return {
-    frontmatter,
-    body: bodyContent
-  };
-}
-
-/**
- * Perform variable substitution in the template body
- * Replaces $ARGUMENTS, $1, $2, etc. with provided values
- * Does NOT process frontmatter variables (those stay as-is)
- * @param {string} body - The template body content
- * @param {Object} variables - Key-value pairs for substitution
- * @returns {string} Body content with substitutions applied
- */
-function substituteVariables(body, variables) {
-  let result = body;
-
-  // Replace $ARGUMENTS if provided
-  if (variables.ARGUMENTS !== undefined) {
-    // Use regex with negative lookahead to avoid replacing $ARGUMENTS that are part of longer identifiers
-    result = result.replace(/\$ARGUMENTS(?![0-9A-Za-z_])/g, variables.ARGUMENTS);
-  }
-
-  // Replace positional arguments ($1, $2, $3, etc.)
-  // Use regex with negative lookahead to avoid replacing $1 that's part of $10, etc.
-  for (const key in variables) {
-    if (/^\d+$/.test(key)) {
-      const pattern = new RegExp(`\\$${key}(?![0-9])`, 'g');
-      result = result.replace(pattern, variables[key]);
-    }
-  }
-
-  return result;
-}
-
-/**
- * Reconstruct markdown content with frontmatter
- * @param {Object} frontmatter - The frontmatter object
- * @param {string} body - The body content
- * @returns {string} Complete markdown content
- */
-function reconstructMarkdown(frontmatter, body) {
-  if (Object.keys(frontmatter).length === 0) {
-    return body;
-  }
-
-  let result = '---\n';
-  for (const [key, value] of Object.entries(frontmatter)) {
-    // Preserve original formatting - add quotes if value contains special characters
-    if (typeof value === 'string' && (value.includes(':') || value.includes('[') || value.includes(']'))) {
-      result += `${key}: "${value}"\n`;
-    } else {
-      result += `${key}: ${value}\n`;
-    }
-  }
-  result += '---\n';
-
-  if (body) {
-    result += body;
-  }
-
-  return result;
-}
-
-/**
- * Main execution function
- */
-function main() {
-  try {
-    // Parse command line arguments
-    const { template, variables } = parseArguments();
-
-    // Find the template file
-    const templatePath = findTemplateFile(template);
-
-    // Read the template file
-    const content = fs.readFileSync(templatePath, 'utf-8');
-
-    // Parse frontmatter and body
-    const { frontmatter, body } = parseFrontmatter(content);
-
-    // Perform variable substitution on the body only
-    const substitutedBody = substituteVariables(body, variables);
-
-    // Reconstruct the markdown with frontmatter preserved
-    const output = reconstructMarkdown(frontmatter, substitutedBody);
-
-    // Output to stdout
-    process.stdout.write(output);
-
-    // Exit successfully
-    process.exit(0);
-  } catch (error) {
-    // Write error to stderr
-    process.stderr.write(`Error: ${error.message}\n`);
-
-    // Exit with error code
-    process.exit(1);
-  }
-}
-
-// Execute main function
-main();

package/templates/ai-task-manager/config/scripts/create-feature-branch.cjs

@@ -1,204 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Script: create-feature-branch.cjs
- * Purpose: Create a git feature branch for a plan execution
- * Usage: node create-feature-branch.cjs <plan-id-or-path>
- *
- * Exit codes:
- *   0 = Success (branch created, already exists, or not on main/master)
- *   1 = Error (not git repo, uncommitted changes, plan not found)
- */
-
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-const { resolvePlan } = require('./shared-utils.cjs');
-
-// Color functions for output
-const _printError = (message) => {
-  console.error(`ERROR: ${message}`);
-};
-
-const _printSuccess = (message) => {
-  console.log(`✓ ${message}`);
-};
-
-const _printWarning = (message) => {
-  console.log(`⚠ ${message}`);
-};
-
-const _printInfo = (message) => {
-  console.log(message);
-};
-
-/**
- * Execute a git command and return the output
- * @param {string} command - Git command to execute
- * @returns {string|null} Command output or null on error
- */
-const _execGit = (command) => {
-  try {
-    return execSync(command, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
-  } catch (_error) {
-    return null;
-  }
-};
-
-/**
- * Check if current directory is inside a git repository
- * @returns {boolean}
- */
-const _isGitRepo = () => {
-  const result = _execGit('git rev-parse --is-inside-work-tree');
-  return result === 'true';
-};
-
-/**
- * Get current git branch name
- * @returns {string|null}
- */
-const _getCurrentBranch = () => {
-  return _execGit('git rev-parse --abbrev-ref HEAD');
-};
-
-/**
- * Check if working tree has uncommitted changes
- * @returns {boolean}
- */
-const _hasUncommittedChanges = () => {
-  const status = _execGit('git status --porcelain');
-  return status !== null && status.length > 0;
-};
-
-/**
- * Check if a branch exists locally or remotely
- * @param {string} branchName - Branch name to check
- * @returns {boolean}
- */
-const _branchExists = (branchName) => {
-  // Check local branches
-  const localBranches = _execGit('git branch --list');
-  if (localBranches && localBranches.split('\n').some(b => b.trim().replace('* ', '') === branchName)) {
-    return true;
-  }
-
-  // Check remote branches
-  const remoteBranches = _execGit('git branch -r --list');
-  if (remoteBranches && remoteBranches.split('\n').some(b => b.trim().includes(branchName))) {
-    return true;
-  }
-
-  return false;
-};
-
-/**
- * Sanitize plan name for use in branch name
- * @param {string} planName - Original plan name from directory
- * @returns {string} Sanitized branch name segment
- */
-const _sanitizeBranchName = (planName) => {
-  return planName
-    .toLowerCase()
-    .replace(/[^a-z0-9-]/g, '-')  // Replace non-alphanumeric chars with hyphens
-    .replace(/-+/g, '-')          // Collapse multiple hyphens
-    .replace(/^-|-$/g, '')        // Remove leading/trailing hyphens
-    .substring(0, 60);            // Max 60 chars
-};
-
-/**
- * Extract plan name from plan directory
- * @param {string} planDir - Full path to plan directory
- * @returns {string} Plan name portion (e.g., "update-docs" from "58--update-docs")
- */
-const _extractPlanName = (planDir) => {
-  const dirName = path.basename(planDir);
-  // Match pattern: {id}--{name}
-  const match = dirName.match(/^\d+--(.+)$/);
-  return match ? match[1] : dirName;
-};
-
-// Main function
-const _main = (startPath = process.cwd()) => {
-  // Check arguments
-  if (process.argv.length < 3) {
-    _printError('Missing plan ID argument');
-    console.log('Usage: node create-feature-branch.cjs <plan-id-or-path>');
-    console.log('Example: node create-feature-branch.cjs 58');
-    process.exit(1);
-  }
-
-  const inputId = process.argv[2];
-
-  // Step 1: Check if this is a git repository
-  if (!_isGitRepo()) {
-    _printError('Not a git repository');
-    process.exit(1);
-  }
-
-  // Step 2: Resolve the plan
-  const resolved = resolvePlan(inputId, startPath);
-
-  if (!resolved) {
-    _printError(`Plan "${inputId}" not found or invalid`);
-    process.exit(1);
-  }
-
-  const { planDir, planId } = resolved;
-  _printInfo(`Found plan: ${path.basename(planDir)}`);
-
-  // Step 3: Check current branch
-  const currentBranch = _getCurrentBranch();
-
-  if (!currentBranch) {
-    _printError('Could not determine current git branch');
-    process.exit(1);
-  }
-
-  if (currentBranch !== 'main' && currentBranch !== 'master') {
-    _printWarning(`Not on main/master branch (current: ${currentBranch})`);
-    _printInfo('Proceeding without creating a new branch');
-    process.exit(0);
-  }
-
-  // Step 4: Check for uncommitted changes
-  if (_hasUncommittedChanges()) {
-    _printError('Uncommitted changes detected in working tree');
-    _printInfo('Please commit or stash your changes before creating a feature branch');
-    process.exit(1);
-  }
-
-  // Step 5: Build branch name
-  const planName = _extractPlanName(planDir);
-  const sanitizedName = _sanitizeBranchName(planName);
-  const branchName = `feature/${planId}--${sanitizedName}`;
-
-  // Step 6: Check if branch already exists
-  if (_branchExists(branchName)) {
-    _printWarning(`Branch "${branchName}" already exists`);
-    _printInfo('Proceeding with existing branch');
-    process.exit(0);
-  }
-
-  // Step 7: Create and checkout the branch
-  const createResult = _execGit(`git checkout -b "${branchName}"`);
-
-  if (createResult === null) {
-    _printError(`Failed to create branch "${branchName}"`);
-    process.exit(1);
-  }
-
-  _printSuccess(`Created and switched to branch: ${branchName}`);
-  process.exit(0);
-};
-
-// Run the script
-if (require.main === module) {
-  _main();
-}
-
-module.exports = {
-  _main,
-  _sanitizeBranchName,
-  _extractPlanName
-};