devflow-agents 0.7.0

package/lib/update.js

@@ -0,0 +1,181 @@
+const fs = require('node:fs');
+const path = require('node:path');
+const {
+  VERSION,
+  PACKAGE_ROOT,
+  BASE_DIRS,
+  DOCS_DIRS,
+  GITKEEP_DIRS,
+} = require('./constants');
+const {
+  printHeader,
+  success,
+  error,
+  warn,
+  info,
+  printUpdateSuccess,
+  confirm,
+  copyDir,
+  copyFile,
+  ensureDirs,
+  createGitkeep,
+  pathExists,
+  resolveTarget,
+} = require('./utils');
+
+async function updateCommand(targetArg, options) {
+  printHeader(VERSION);
+
+  const targetDir = resolveTarget(targetArg);
+
+  // 1. Verify DevFlow is installed
+  const hasAgents = await pathExists(path.join(targetDir, '.claude', 'commands', 'agents'));
+  const hasDevflow = await pathExists(path.join(targetDir, '.devflow'));
+
+  if (!hasAgents && !hasDevflow) {
+    error(`DevFlow not found in: ${targetDir}`);
+    info('Use "devflow init" to install for the first time.');
+    process.exit(1);
+  }
+
+  // 2. Read installed version
+  let installedVersion = 'unknown';
+  const projectYamlPath = path.join(targetDir, '.devflow', 'project.yaml');
+  try {
+    const content = await fs.promises.readFile(projectYamlPath, 'utf8');
+    const match = content.match(/^\s*version:\s*"?([^"\s]+)"?/m);
+    if (match) installedVersion = match[1];
+  } catch { /* file may not exist */ }
+
+  info(`Project: ${targetDir}`);
+  info(`Installed version: ${installedVersion}`);
+  info(`New version: ${VERSION}`);
+  console.log();
+
+  // 3. Check if already up to date
+  if (installedVersion === VERSION) {
+    success('DevFlow is already up to date!');
+    return;
+  }
+
+  // 4. Confirm update
+  if (!options.force) {
+    warn('The update will overwrite agent files.');
+    warn('Customizations in .claude/commands/agents/ will be lost.');
+    console.log();
+    const shouldContinue = await confirm('Continue with update?');
+    if (!shouldContinue) {
+      warn('Update cancelled.');
+      return;
+    }
+  }
+
+  console.log();
+  info('Updating DevFlow...');
+  console.log();
+
+  // 5. Backup existing agents
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+  const backupDir = path.join(targetDir, '.devflow', `backup-${timestamp}`);
+  await fs.promises.mkdir(backupDir, { recursive: true });
+
+  try {
+    await fs.promises.cp(
+      path.join(targetDir, '.claude', 'commands', 'agents'),
+      path.join(backupDir, 'agents'),
+      { recursive: true }
+    );
+  } catch { /* may not exist */ }
+
+  try {
+    await fs.promises.copyFile(
+      projectYamlPath,
+      path.join(backupDir, 'project.yaml')
+    );
+  } catch { /* may not exist */ }
+
+  success(`Backup created: .devflow/${path.basename(backupDir)}/`);
+
+  // 6. Update agents
+  console.log('  \u2192 Updating agents...');
+  await copyDir(
+    path.join(PACKAGE_ROOT, '.claude', 'commands', 'agents'),
+    path.join(targetDir, '.claude', 'commands', 'agents')
+  );
+  success('Agents updated (.claude/commands/agents/)');
+
+  // 7. Update quick commands
+  console.log('  \u2192 Updating quick commands...');
+  await copyDir(
+    path.join(PACKAGE_ROOT, '.claude', 'commands', 'quick'),
+    path.join(targetDir, '.claude', 'commands', 'quick')
+  );
+  success('Quick commands updated');
+
+  // 8. Update help & status commands
+  console.log('  \u2192 Updating help & status commands...');
+  for (const file of ['devflow-help.md', 'devflow-status.md']) {
+    try {
+      await copyFile(
+        path.join(PACKAGE_ROOT, '.claude', 'commands', file),
+        path.join(targetDir, '.claude', 'commands', file)
+      );
+    } catch { /* skip if missing */ }
+  }
+
+  // 9. Update .claude_project
+  console.log('  \u2192 Updating .claude_project...');
+  await copyFile(
+    path.join(PACKAGE_ROOT, '.claude_project'),
+    path.join(targetDir, '.claude_project')
+  );
+  success('.claude_project updated');
+
+  // 10. Update .devflow/agents/ meta.yaml files
+  console.log('  \u2192 Updating .devflow/agents/ meta.yaml files...');
+  await copyDir(
+    path.join(PACKAGE_ROOT, '.devflow', 'agents'),
+    path.join(targetDir, '.devflow', 'agents')
+  );
+  success('.devflow/agents/ updated');
+
+  // 11. Update project.yaml version
+  console.log('  \u2192 Updating project.yaml version...');
+  try {
+    let content = await fs.promises.readFile(projectYamlPath, 'utf8');
+    content = content.replace(
+      /version:\s*"?[^"\s]+"?/,
+      `version: "${VERSION}"`
+    );
+    await fs.promises.writeFile(projectYamlPath, content, 'utf8');
+    success(`project.yaml version updated to ${VERSION}`);
+  } catch {
+    await copyFile(
+      path.join(PACKAGE_ROOT, '.devflow', 'project.yaml'),
+      projectYamlPath
+    );
+    success('project.yaml created');
+  }
+
+  // 12. Ensure directory structure is complete
+  console.log('  \u2192 Verifying directory structure...');
+  await ensureDirs(targetDir, [...BASE_DIRS, ...DOCS_DIRS]);
+  await createGitkeep(targetDir, GITKEEP_DIRS);
+  success('Directory structure verified');
+
+  // 13. Success output
+  printUpdateSuccess(VERSION);
+  info('What was updated:');
+  console.log('  \u2022 Agents in .claude/commands/agents/');
+  console.log('  \u2022 Quick commands in .claude/commands/quick/');
+  console.log('  \u2022 .claude_project orchestration rules');
+  console.log('  \u2022 .devflow/agents/ meta.yaml files');
+  console.log('  \u2022 Directory structure');
+  console.log();
+  info(`Backup saved in: .devflow/${path.basename(backupDir)}/`);
+  console.log();
+  info('Tip: Use /agents:strategist to start a new feature');
+  console.log();
+}
+
+module.exports = { updateCommand };

package/lib/utils.js

@@ -0,0 +1,157 @@
+const { execSync } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+const readline = require('node:readline');
+
+// ANSI color helpers (no chalk dependency)
+const c = {
+  red:    (s) => `\x1b[0;31m${s}\x1b[0m`,
+  green:  (s) => `\x1b[0;32m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[1;33m${s}\x1b[0m`,
+  blue:   (s) => `\x1b[0;34m${s}\x1b[0m`,
+};
+
+function printHeader(version) {
+  const line = c.blue('\u2501'.repeat(55));
+  console.log(line);
+  console.log(c.blue(`  DevFlow CLI v${version}`));
+  console.log(line);
+  console.log();
+}
+
+function success(msg) { console.log(`${c.green('\u2713')} ${msg}`); }
+function error(msg)   { console.log(`${c.red('\u2717')} ${msg}`); }
+function warn(msg)    { console.log(`${c.yellow('\u26A0')} ${msg}`); }
+function info(msg)    { console.log(`${c.blue('\u2139')} ${msg}`); }
+
+function printSuccess(version) {
+  const line = c.green('\u2501'.repeat(55));
+  console.log();
+  console.log(line);
+  console.log(c.green(`  \u2713 DevFlow v${version} installed successfully!`));
+  console.log(line);
+  console.log();
+}
+
+function printUpdateSuccess(version) {
+  const line = c.green('\u2501'.repeat(55));
+  console.log();
+  console.log(line);
+  console.log(c.green(`  \u2713 DevFlow updated to v${version}!`));
+  console.log(line);
+  console.log();
+}
+
+// Interactive y/N confirmation
+function confirm(question) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+    rl.question(`${question} (y/N) `, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+    });
+  });
+}
+
+// Check if a CLI command exists
+function commandExists(cmd) {
+  try {
+    execSync(`command -v ${cmd}`, { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// Check required/recommended dependencies
+function checkDependencies() {
+  const platform = process.platform === 'darwin' ? 'macOS'
+    : process.platform === 'win32' ? 'Windows'
+    : 'Linux';
+  info(`System: ${platform}`);
+  console.log();
+
+  if (commandExists('claude')) {
+    success('Claude Code: installed');
+  } else {
+    warn('Claude Code: not found');
+    console.log('  Install: npm install -g @anthropic-ai/claude-code');
+  }
+
+  if (commandExists('git')) {
+    success('Git: installed');
+  } else {
+    warn('Git: not found (recommended)');
+  }
+
+  console.log();
+}
+
+// Copy directory recursively using Node 18+ fs.cp
+async function copyDir(src, dest) {
+  await fs.promises.mkdir(path.dirname(dest), { recursive: true });
+  await fs.promises.cp(src, dest, { recursive: true, force: true });
+}
+
+// Copy single file, creating parent dirs as needed
+async function copyFile(src, dest) {
+  await fs.promises.mkdir(path.dirname(dest), { recursive: true });
+  await fs.promises.copyFile(src, dest);
+}
+
+// Create multiple directories
+async function ensureDirs(root, dirs) {
+  for (const dir of dirs) {
+    await fs.promises.mkdir(path.join(root, dir), { recursive: true });
+  }
+}
+
+// Create .gitkeep in directories that should be tracked but are empty
+async function createGitkeep(root, dirs) {
+  for (const dir of dirs) {
+    const gitkeepPath = path.join(root, dir, '.gitkeep');
+    try {
+      await fs.promises.access(gitkeepPath);
+    } catch {
+      await fs.promises.writeFile(gitkeepPath, '');
+    }
+  }
+}
+
+// Check if a path exists
+async function pathExists(p) {
+  try {
+    await fs.promises.access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// Resolve target path relative to cwd
+function resolveTarget(targetArg) {
+  return path.resolve(process.cwd(), targetArg);
+}
+
+module.exports = {
+  c,
+  printHeader,
+  success,
+  error,
+  warn,
+  info,
+  printSuccess,
+  printUpdateSuccess,
+  confirm,
+  commandExists,
+  checkDependencies,
+  copyDir,
+  copyFile,
+  ensureDirs,
+  createGitkeep,
+  pathExists,
+  resolveTarget,
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "devflow-agents",
+  "version": "0.7.0",
+  "description": "Multi-agent system for software development with Claude Code. 6 specialized agents (Strategist, Architect, System Designer, Builder, Guardian, Chronicler) as slash commands.",
+  "keywords": [
+    "claude-code",
+    "ai-agents",
+    "multi-agent",
+    "devflow",
+    "claude",
+    "anthropic",
+    "software-development"
+  ],
+  "author": "Evolve Labs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/evolve-labs-cloud/devflow.git"
+  },
+  "homepage": "https://github.com/evolve-labs-cloud/devflow",
+  "bin": {
+    "devflow": "bin/devflow.js"
+  },
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    ".claude/commands/",
+    ".claude_project",
+    ".devflow/agents/",
+    ".devflow/project.yaml",
+    ".gitignore-template",
+    "docs/decisions/000-template.md",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "commander": "^12.0.0"
+  },
+  "scripts": {
+    "prepublishOnly": "cp .gitignore .gitignore-template"
+  }
+}