@alxyrgin/agent-forge 1.0.0 → 3.1.0

package/dist/index.js

@@ -181,9 +181,9 @@ async function promptProjectSetup(targetDir) {
       name: "agentPreset",
       message: "Agent preset:",
       choices: [
-        { name: "Core (8 agents \u2014 recommended)", value: "core" },
-        { name: "Full (11 agents)", value: "full" },
-        { name: "Minimal (4 agents)", value: "minimal" }
+        { name: "Core (8 agents \u2014 development pipeline)", value: "core" },
+        { name: "Full (20 agents \u2014 all categories + extra skills)", value: "full" },
+        { name: "Minimal (5 agents \u2014 essentials + inspector)", value: "minimal" }
       ]
     },
     {
@@ -276,6 +276,9 @@ async function fileExists(filePath) {
 async function readFile(filePath) {
   return fs.readFile(filePath, "utf-8");
 }
+async function makeExecutable(filePath) {
+  await fs.chmod(filePath, 493);
+}
 
 // src/utils/template.ts
 import fs2 from "fs";
@@ -302,7 +305,8 @@ var MEMORY_FILES = [
   "tech-stack.md",
   "tech-debt.md",
   "patterns.md",
-  "troubleshooting.md"
+  "troubleshooting.md",
+  "checkpoint.yml"
 ];
 async function generateMemoryBank(ctx, overwrite) {
   const result = {
@@ -333,39 +337,82 @@ async function generateMemoryBank(ctx, overwrite) {
 
 // src/generators/agents.ts
 import path4 from "path";
-var CORE_AGENTS = [
+var PIPELINE_AGENTS = [
   "analyst",
   "architect",
+  "skeptic",
   "developer",
-  "unit-tester",
+  "tester",
+  "inspector",
   "reviewer",
-  "security-auditor",
-  "doc-writer",
-  "progress-tracker"
+  "planner"
+];
+var PLANNING_AGENTS = [
+  "researcher",
+  "validator",
+  "interviewer",
+  "decomposer"
 ];
-var EXTRA_AGENTS = [
-  "planner",
-  "integration-tester",
-  "acceptance-tester"
+var SECURITY_AGENTS = [
+  "auditor",
+  "prompter",
+  "deployer",
+  "scaffolder"
+];
+var DOCUMENTATION_AGENTS = [
+  "librarian",
+  "writer",
+  "gatekeeper",
+  "verifier"
 ];
 var MINIMAL_AGENTS = [
   "analyst",
   "developer",
-  "unit-tester",
-  "reviewer"
+  "tester",
+  "reviewer",
+  "inspector"
 ];
+var CORE_AGENTS = [...PIPELINE_AGENTS];
+var FULL_AGENTS = [
+  ...PIPELINE_AGENTS,
+  ...PLANNING_AGENTS,
+  ...SECURITY_AGENTS,
+  ...DOCUMENTATION_AGENTS
+];
+var CATEGORY_MAP = {};
+for (const name of PIPELINE_AGENTS) {
+  CATEGORY_MAP[name] = "pipeline";
+}
+for (const name of PLANNING_AGENTS) {
+  CATEGORY_MAP[name] = "planning";
+}
+for (const name of SECURITY_AGENTS) {
+  CATEGORY_MAP[name] = "security";
+}
+for (const name of DOCUMENTATION_AGENTS) {
+  CATEGORY_MAP[name] = "documentation";
+}
+function getAgentCategory(name) {
+  return CATEGORY_MAP[name] || "pipeline";
+}
 function getAgentList(preset) {
-  const agents = [];
-  const coreList = preset === "minimal" ? MINIMAL_AGENTS : CORE_AGENTS;
-  for (const name of coreList) {
-    agents.push({ name, dir: "core" });
+  let names;
+  switch (preset) {
+    case "minimal":
+      names = MINIMAL_AGENTS;
+      break;
+    case "full":
+      names = FULL_AGENTS;
+      break;
+    case "core":
+    default:
+      names = CORE_AGENTS;
+      break;
   }
-  if (preset === "full") {
-    for (const name of EXTRA_AGENTS) {
-      agents.push({ name, dir: "extra" });
-    }
-  }
-  return agents;
+  return names.map((name) => ({
+    name,
+    category: getAgentCategory(name)
+  }));
 }
 async function generateAgents(ctx, overwrite) {
   const result = {
@@ -381,7 +428,7 @@ async function generateAgents(ctx, overwrite) {
   for (const agent of agents) {
     try {
       const content = await renderTemplate(
-        `agents/${agent.dir}/${agent.name}.md.ejs`,
+        `agents/${agent.category}/${agent.name}.md.ejs`,
         templateData
       );
       const outputPath = path4.join(ctx.targetDir, ".claude/agents", `${agent.name}.md`);
@@ -400,15 +447,43 @@ async function generateAgents(ctx, overwrite) {
 
 // src/generators/skills.ts
 import path5 from "path";
-var SKILLS = [
+var CORE_SKILLS = [
   "start-session",
   "end-session",
   "take-task",
   "complete-task",
   "status",
   "plan",
-  "review"
+  "review",
+  "code",
+  "test",
+  "done"
+];
+var EXTRA_SKILLS = [
+  "interview",
+  "audit-wave",
+  "write-report",
+  "dashboard",
+  "skill-master",
+  "decompose",
+  "feature",
+  "security",
+  "spec",
+  "techspec",
+  "prompts"
 ];
+function getSkillList(preset) {
+  const skills = [];
+  for (const name of CORE_SKILLS) {
+    skills.push({ name, dir: "core" });
+  }
+  if (preset === "full") {
+    for (const name of EXTRA_SKILLS) {
+      skills.push({ name, dir: "extra" });
+    }
+  }
+  return skills;
+}
 async function generateSkills(ctx, overwrite) {
   const result = {
     filesCreated: [],
@@ -419,13 +494,14 @@ async function generateSkills(ctx, overwrite) {
     ...ctx,
     defaultBranch: "main"
   };
-  for (const skill of SKILLS) {
+  const skills = getSkillList(ctx.agentPreset);
+  for (const skill of skills) {
     try {
       const content = await renderTemplate(
-        `skills/core/${skill}/SKILL.md.ejs`,
+        `skills/${skill.dir}/${skill.name}/SKILL.md.ejs`,
         templateData
       );
-      const outputPath = path5.join(ctx.targetDir, `.claude/skills/${skill}`, "SKILL.md");
+      const outputPath = path5.join(ctx.targetDir, `.claude/skills/${skill.name}`, "SKILL.md");
       const status = await writeFileSafe(outputPath, content, overwrite);
       if (status === "skipped") {
         result.filesSkipped.push(outputPath);
@@ -433,7 +509,7 @@ async function generateSkills(ctx, overwrite) {
         result.filesCreated.push(outputPath);
       }
     } catch (err) {
-      result.errors.push(`Skill ${skill}: ${err}`);
+      result.errors.push(`Skill ${skill.name}: ${err}`);
     }
   }
   return result;
@@ -444,7 +520,12 @@ import path6 from "path";
 var RULES = [
   "commit-conventions",
   "development-cycle",
-  "testing-standards"
+  "testing-standards",
+  "shared-resources",
+  "context-loading",
+  "agent-output-format",
+  "quality-gates",
+  "rollback-protocol"
 ];
 async function generateRules(ctx, overwrite) {
   const result = {
@@ -558,14 +639,7 @@ async function generateInfra(ctx, overwrite) {
     }
   }
   try {
-    const manifest = {
-      version: "1.0.0",
-      createdAt: ctx.today,
-      projectName: ctx.projectName,
-      agentPreset: ctx.agentPreset,
-      language: ctx.language,
-      expectedFiles: getExpectedFiles(ctx)
-    };
+    const manifest = buildManifest(ctx);
     const outputPath = path8.join(ctx.targetDir, ".claude-forge.json");
     const status = await writeFileSafe(
       outputPath,
@@ -582,6 +656,25 @@ async function generateInfra(ctx, overwrite) {
   }
   return result;
 }
+function buildManifest(ctx) {
+  return {
+    version: "3.0.0",
+    createdAt: ctx.today,
+    updatedAt: ctx.today,
+    projectName: ctx.projectName,
+    projectDescription: ctx.projectDescription,
+    language: ctx.language,
+    agentPreset: ctx.agentPreset,
+    stack: ctx.stack,
+    framework: ctx.framework,
+    testFramework: ctx.testFramework,
+    testCommand: ctx.testCommand,
+    srcDir: ctx.srcDir,
+    testDir: ctx.testDir,
+    commitStyle: ctx.commitStyle,
+    expectedFiles: getExpectedFiles(ctx)
+  };
+}
 function getExpectedFiles(ctx) {
   const files = [
     ".claude/CLAUDE.md",
@@ -595,44 +688,105 @@ function getExpectedFiles(ctx) {
     "dev-infra/memory/tech-stack.md",
     "dev-infra/memory/tech-debt.md",
     "dev-infra/memory/patterns.md",
-    "dev-infra/memory/troubleshooting.md"
+    "dev-infra/memory/troubleshooting.md",
+    "dev-infra/memory/checkpoint.yml"
   ];
+  files.push(".claude/hooks/protect-docs.sh");
   files.push(
     ".claude/rules/commit-conventions.md",
     ".claude/rules/development-cycle.md",
-    ".claude/rules/testing-standards.md"
+    ".claude/rules/testing-standards.md",
+    ".claude/rules/shared-resources.md",
+    ".claude/rules/context-loading.md",
+    ".claude/rules/agent-output-format.md",
+    ".claude/rules/quality-gates.md",
+    ".claude/rules/rollback-protocol.md"
   );
-  const skills = [
+  const coreSkills = [
     "start-session",
     "end-session",
     "take-task",
     "complete-task",
     "status",
     "plan",
-    "review"
+    "review",
+    "code",
+    "test",
+    "done"
   ];
+  const extraSkills = [
+    "interview",
+    "audit-wave",
+    "write-report",
+    "dashboard",
+    "skill-master",
+    "decompose",
+    "feature",
+    "security",
+    "spec",
+    "techspec",
+    "prompts"
+  ];
+  const skills = ctx.agentPreset === "full" ? [...coreSkills, ...extraSkills] : coreSkills;
   for (const skill of skills) {
     files.push(`.claude/skills/${skill}/SKILL.md`);
   }
-  const coreAgents = [
+  const pipelineAgents = [
     "analyst",
     "architect",
+    "skeptic",
     "developer",
-    "unit-tester",
+    "tester",
+    "inspector",
     "reviewer",
-    "security-auditor",
-    "doc-writer",
-    "progress-tracker"
+    "planner"
+  ];
+  const planningAgents = ["researcher", "validator", "interviewer", "decomposer"];
+  const securityAgents = ["auditor", "prompter", "deployer", "scaffolder"];
+  const documentationAgents = ["librarian", "writer", "gatekeeper", "verifier"];
+  const minimalAgents = ["analyst", "developer", "tester", "reviewer", "inspector"];
+  const coreAgents = [...pipelineAgents];
+  const fullAgents = [
+    ...pipelineAgents,
+    ...planningAgents,
+    ...securityAgents,
+    ...documentationAgents
   ];
-  const minimalAgents = ["analyst", "developer", "unit-tester", "reviewer"];
-  const extraAgents = ["planner", "integration-tester", "acceptance-tester"];
-  const agents = ctx.agentPreset === "minimal" ? minimalAgents : ctx.agentPreset === "full" ? [...coreAgents, ...extraAgents] : coreAgents;
+  const agents = ctx.agentPreset === "minimal" ? minimalAgents : ctx.agentPreset === "full" ? fullAgents : coreAgents;
   for (const agent of agents) {
     files.push(`.claude/agents/${agent}.md`);
   }
   return files;
 }
 
+// src/generators/hooks.ts
+import path9 from "path";
+async function generateHooks(ctx, overwrite) {
+  const result = {
+    filesCreated: [],
+    filesSkipped: [],
+    errors: []
+  };
+  const templateData = {
+    ...ctx,
+    defaultBranch: "main"
+  };
+  try {
+    const content = await renderTemplate("hooks/protect-docs.sh.ejs", templateData);
+    const outputPath = path9.join(ctx.targetDir, ".claude/hooks/protect-docs.sh");
+    const status = await writeFileSafe(outputPath, content, overwrite);
+    if (status === "skipped") {
+      result.filesSkipped.push(outputPath);
+    } else {
+      result.filesCreated.push(outputPath);
+      await makeExecutable(outputPath);
+    }
+  } catch (err) {
+    result.errors.push(`Hook protect-docs.sh: ${err}`);
+  }
+  return result;
+}
+
 // src/generators/index.ts
 async function generateAll(ctx, overwrite = false) {
   const result = {
@@ -646,6 +800,7 @@ async function generateAll(ctx, overwrite = false) {
     generateSkills,
     generateRules,
     generateMemoryBank,
+    generateHooks,
     generateInfra
   ];
   for (const generator of generators) {
@@ -665,7 +820,7 @@ async function generateAll(ctx, overwrite = false) {
 async function initCommand(options) {
   const targetDir = process.cwd();
   console.log();
-  console.log(chalk.bold("  agent-forge v1.0.0"));
+  console.log(chalk.bold("  agent-forge v3.0.0"));
   console.log(chalk.dim("  AI-driven Development Framework for Claude Code"));
   console.log();
   let ctx;
@@ -708,7 +863,7 @@ async function initCommand(options) {
 }
 
 // src/commands/doctor.ts
-import path9 from "path";
+import path10 from "path";
 import chalk2 from "chalk";
 async function doctorCommand() {
   const targetDir = process.cwd();
@@ -716,7 +871,7 @@ async function doctorCommand() {
   console.log(chalk2.bold("  agent-forge doctor"));
   console.log(chalk2.dim("  Checking project structure integrity..."));
   console.log();
-  const manifestPath = path9.join(targetDir, ".claude-forge.json");
+  const manifestPath = path10.join(targetDir, ".claude-forge.json");
   const manifestExists = await fileExists(manifestPath);
   if (!manifestExists) {
     console.log(chalk2.red("  .claude-forge.json not found"));
@@ -739,7 +894,7 @@ async function doctorCommand() {
   let okCount = 0;
   let failCount = 0;
   for (const file of manifest.expectedFiles) {
-    const filePath = path9.join(targetDir, file);
+    const filePath = path10.join(targetDir, file);
     const exists = await fileExists(filePath);
     const check = {
       name: file,
@@ -799,10 +954,152 @@ async function doctorCommand() {
   }
 }
 
+// src/commands/update.ts
+import path11 from "path";
+import chalk3 from "chalk";
+import ora2 from "ora";
+function today2() {
+  return (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+}
+function contextFromManifest(manifest, targetDir) {
+  return {
+    projectName: manifest.projectName || targetDir.split("/").pop() || "my-project",
+    projectDescription: manifest.projectDescription || "AI-driven project",
+    stack: manifest.stack || "typescript",
+    framework: manifest.framework || "None",
+    testFramework: manifest.testFramework || "vitest",
+    testCommand: manifest.testCommand || "npx vitest run",
+    srcDir: manifest.srcDir || "src/",
+    testDir: manifest.testDir || "tests/",
+    team: [],
+    milestones: [],
+    agentPreset: manifest.agentPreset || "core",
+    language: manifest.language || "ru",
+    commitStyle: manifest.commitStyle || "standard",
+    today: today2(),
+    targetDir
+  };
+}
+async function updateCommand() {
+  const targetDir = process.cwd();
+  console.log();
+  console.log(chalk3.bold("  agent-forge update v3.0.0"));
+  console.log(chalk3.dim("  Updating framework files..."));
+  console.log();
+  const manifestPath = path11.join(targetDir, ".claude-forge.json");
+  const manifestExists = await fileExists(manifestPath);
+  if (!manifestExists) {
+    console.log(chalk3.red("  .claude-forge.json not found"));
+    console.log(
+      chalk3.dim("  This project is not initialized. Run `agent-forge init` first.")
+    );
+    console.log();
+    process.exit(1);
+  }
+  const manifestRaw = await readFile(manifestPath);
+  let existingManifest;
+  try {
+    existingManifest = JSON.parse(manifestRaw);
+  } catch {
+    console.log(chalk3.red("  .claude-forge.json is corrupted. Cannot update."));
+    console.log(
+      chalk3.dim("  Run `agent-forge init --overwrite` to reinitialize.")
+    );
+    console.log();
+    process.exit(1);
+  }
+  const previousVersion = existingManifest.version || "unknown";
+  const ctx = contextFromManifest(existingManifest, targetDir);
+  const spinner = ora2("Updating framework files...").start();
+  try {
+    const result = {
+      filesCreated: [],
+      filesSkipped: [],
+      errors: []
+    };
+    const frameworkGenerators = [
+      generateClaudeMd,
+      generateAgents,
+      generateSkills,
+      generateRules,
+      generateHooks
+    ];
+    for (const generator of frameworkGenerators) {
+      try {
+        const partial = await generator(ctx, true);
+        result.filesCreated.push(...partial.filesCreated);
+        result.filesSkipped.push(...partial.filesSkipped);
+        result.errors.push(...partial.errors);
+      } catch (err) {
+        result.errors.push(`Generator error: ${err}`);
+      }
+    }
+    const userDataGenerators = [
+      generateMemoryBank,
+      generateInfra
+    ];
+    for (const generator of userDataGenerators) {
+      try {
+        const partial = await generator(ctx, false);
+        result.filesCreated.push(...partial.filesCreated);
+        result.filesSkipped.push(...partial.filesSkipped);
+        result.errors.push(...partial.errors);
+      } catch (err) {
+        result.errors.push(`Generator error: ${err}`);
+      }
+    }
+    const updatedManifest = buildManifest(ctx);
+    updatedManifest.createdAt = existingManifest.createdAt || updatedManifest.createdAt;
+    updatedManifest.updatedAt = today2();
+    await writeFileSafe(
+      manifestPath,
+      JSON.stringify(updatedManifest, null, 2) + "\n",
+      true
+    );
+    spinner.succeed(chalk3.green("Framework files updated"));
+    const newFiles = result.filesCreated.filter((f) => !result.filesSkipped.includes(f));
+    const updatedCount = newFiles.length;
+    const skippedCount = result.filesSkipped.length;
+    console.log();
+    if (updatedCount > 0) {
+      console.log(
+        chalk3.green(`  + ${updatedCount} files updated/added`)
+      );
+    }
+    if (skippedCount > 0) {
+      console.log(
+        chalk3.yellow(`  ~ ${skippedCount} files skipped (user data preserved)`)
+      );
+    }
+    if (result.errors.length > 0) {
+      console.log(chalk3.red(`  ! ${result.errors.length} errors:`));
+      for (const err of result.errors) {
+        console.log(chalk3.red(`    - ${err}`));
+      }
+    }
+    console.log();
+    if (previousVersion !== updatedManifest.version) {
+      console.log(
+        chalk3.dim(`  .claude-forge.json updated: ${previousVersion} -> v${updatedManifest.version}`)
+      );
+    } else {
+      console.log(
+        chalk3.dim(`  .claude-forge.json updated (v${updatedManifest.version})`)
+      );
+    }
+    console.log();
+  } catch (err) {
+    spinner.fail(chalk3.red("Failed to update framework files"));
+    console.error(err);
+    process.exit(1);
+  }
+}
+
 // src/index.ts
 var program = new Command();
-program.name("agent-forge").description("AI-driven Development Framework for Claude Code").version("1.0.0");
+program.name("agent-forge").description("AI-driven Development Framework for Claude Code").version("3.0.0");
 program.command("init").description("Initialize AI-driven development infrastructure in the current project").option("-y, --yes", "Skip prompts and use defaults").option("--overwrite", "Overwrite existing files").action(initCommand);
 program.command("doctor").description("Check integrity of the generated structure").action(doctorCommand);
+program.command("update").description("Update framework files to the latest version (preserves user data)").action(updateCommand);
 program.parse();
 //# sourceMappingURL=index.js.map