specwf 0.2.1 → 0.2.2

package/dist/cli.js

@@ -4,7 +4,7 @@
 import { program } from "commander";
 
 // src/commands/specwf-init.ts
-import { join as join5 } from "path";
+import { join as join8 } from "path";
 
 // src/core/config.ts
 import { join } from "path";
@@ -468,66 +468,9 @@ async function runBrownfieldInit(rootDir, specwfDir, info) {
   return domains;
 }
 
-// src/commands/specwf-init.ts
-function register(program2) {
-  program2.command("init").description("\u521D\u59CB\u5316 specwf \u9879\u76EE\u7ED3\u6784").option("--dir <path>", "\u76EE\u6807\u76EE\u5F55", ".").option("--profile <profile>", "\u5DE5\u4F5C\u6D41\u4E25\u683C\u5EA6 (lite|standard|strict)", "standard").option("--brownfield", "\u5B58\u91CF\u9879\u76EE\u6A21\u5F0F\uFF08codebase mapping + spec bootstrap\uFF09").option("--yes", "\u8DF3\u8FC7\u786E\u8BA4\u4F7F\u7528\u9ED8\u8BA4\u503C").action(initHandler);
-}
-async function initHandler(options) {
-  const baseDir = options.dir.startsWith("/") ? options.dir : join5(process.cwd(), options.dir);
-  const specwfDir = join5(baseDir, "specwf");
-  if (isInitialized(specwfDir)) {
-    console.error("specwf \u5DF2\u521D\u59CB\u5316\u3002\u8FD0\u884C `specwf update` \u66F4\u65B0\u5E73\u53F0\u6587\u4EF6\u3002");
-    process.exit(1);
-  }
-  const wizard = await runInitWizard({ profile: options.profile, yes: options.yes });
-  const profile = wizard.profile;
-  const platform = wizard.platform;
-  const isBrownfield = options.brownfield || wizard.brownfield;
-  createSpecwfStructure(specwfDir);
-  console.log("\u2713 \u521B\u5EFA specwf/ \u76EE\u5F55\u7ED3\u6784");
-  saveConfig(specwfDir, {
-    version: 1,
-    platform,
-    profile,
-    context: wizard.context,
-    workflow: {},
-    review: {},
-    change: {},
-    git: { branching: "none", create_tag: true },
-    conventions: { inject: true },
-    models: {}
-  });
-  console.log("\u2713 \u521B\u5EFA project.yml (profile: " + profile + ")");
-  saveState(specwfDir, {
-    project: {
-      name: baseDir.split("/").pop() || "project",
-      status: "initialized",
-      current_milestone: null,
-      current_phase: null
-    },
-    active_context: {
-      type: "project",
-      ref: null,
-      step: "init"
-    },
-    changes: [],
-    adhoc: []
-  });
-  console.log("\u2713 \u521B\u5EFA state.md");
-  if (isBrownfield) {
-    const info = detectProjectInfo(process.cwd());
-    const domains = await runBrownfieldInit(process.cwd(), specwfDir, info);
-    console.log("\u2713 \u5B58\u91CF\u9879\u76EE codebase mapping \u5B8C\u6210 (" + domains.length + " \u4E2A spec \u57DF)");
-  }
-  console.log("specwf \u521D\u59CB\u5316\u5B8C\u6210\u3002\u8FD0\u884C `specwf update` \u751F\u6210\u5E73\u53F0\u6587\u4EF6\u3002");
-}
-
-// src/commands/specwf-update.ts
-import { join as join9 } from "path";
-
 // src/generators/omp-commands.ts
 import { readFileSync as readFileSync6 } from "fs";
-import { join as join6, dirname } from "path";
+import { join as join5, dirname } from "path";
 import { fileURLToPath } from "url";
 var STEP_DEFS = [
   { step: "init", name: "specwf:init", description: "\u521D\u59CB\u5316 specwf \u9879\u76EE\u7ED3\u6784", usesAgent: true, agents: ["researcher"] },
@@ -548,9 +491,9 @@ var STEP_DEFS = [
   { step: "continue", name: "specwf:continue", description: "\u81EA\u52A8\u63A8\u8FDB \u2014 \u8BFB STATE \u786E\u5B9A\u4E0B\u4E00\u6B65", usesAgent: false, agents: [] }
 ];
 var __dirname = dirname(fileURLToPath(import.meta.url));
-var TEMPLATES_DIR = join6(__dirname, "templates", "commands");
+var TEMPLATES_DIR = join5(__dirname, "templates", "commands");
 function loadTemplate(step) {
-  return readFileSync6(join6(TEMPLATES_DIR, `${step}.md`), "utf-8");
+  return readFileSync6(join5(TEMPLATES_DIR, `${step}.md`), "utf-8");
 }
 function renderTemplate(template, vars) {
   return template.replace(/\{\{(\w+)\}\}/g, (_, key) => vars[key] ?? "");
@@ -634,12 +577,12 @@ function generateAllCommands(config) {
 
 // src/generators/omp-agents.ts
 import { readFileSync as readFileSync7 } from "fs";
-import { join as join7, dirname as dirname2 } from "path";
+import { join as join6, dirname as dirname2 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
-var TEMPLATES_DIR2 = join7(__dirname2, "templates", "agents");
+var TEMPLATES_DIR2 = join6(__dirname2, "templates", "agents");
 function loadTemplate2(role) {
-  return readFileSync7(join7(TEMPLATES_DIR2, `${role}.md`), "utf-8");
+  return readFileSync7(join6(TEMPLATES_DIR2, `${role}.md`), "utf-8");
 }
 function renderTemplate2(template, vars) {
   return template.replace(/\{\{(\w+)\}\}/g, (_, key) => vars[key] ?? "");
@@ -750,12 +693,12 @@ function generateAllAgents(config) {
 
 // src/generators/skills.ts
 import { readFileSync as readFileSync8 } from "fs";
-import { join as join8, dirname as dirname3 } from "path";
+import { join as join7, dirname as dirname3 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var __dirname3 = dirname3(fileURLToPath3(import.meta.url));
-var TEMPLATES_DIR3 = join8(__dirname3, "templates", "skills");
+var TEMPLATES_DIR3 = join7(__dirname3, "templates", "skills");
 function loadTemplate3(step) {
-  return readFileSync8(join8(TEMPLATES_DIR3, `${step}.md`), "utf-8");
+  return readFileSync8(join7(TEMPLATES_DIR3, `${step}.md`), "utf-8");
 }
 function renderTemplate3(template, vars) {
   return template.replace(/\{\{(\w+)\}\}/g, (_, key) => vars[key] ?? "");
@@ -828,7 +771,69 @@ function writeGeneratedFiles(files) {
   }
 }
 
+// src/commands/specwf-init.ts
+function register(program2) {
+  program2.command("init").description("\u521D\u59CB\u5316 specwf \u9879\u76EE\u7ED3\u6784").option("--dir <path>", "\u76EE\u6807\u76EE\u5F55", ".").option("--profile <profile>", "\u5DE5\u4F5C\u6D41\u4E25\u683C\u5EA6 (lite|standard|strict)", "standard").option("--brownfield", "\u5B58\u91CF\u9879\u76EE\u6A21\u5F0F\uFF08codebase mapping + spec bootstrap\uFF09").option("--yes", "\u8DF3\u8FC7\u786E\u8BA4\u4F7F\u7528\u9ED8\u8BA4\u503C").action(initHandler);
+}
+async function initHandler(options) {
+  const baseDir = options.dir.startsWith("/") ? options.dir : join8(process.cwd(), options.dir);
+  const specwfDir = join8(baseDir, "specwf");
+  if (isInitialized(specwfDir)) {
+    console.error("specwf \u5DF2\u521D\u59CB\u5316\u3002\u8FD0\u884C `specwf update` \u66F4\u65B0\u5E73\u53F0\u6587\u4EF6\u3002");
+    process.exit(1);
+  }
+  const wizard = await runInitWizard({ profile: options.profile, yes: options.yes });
+  const profile = wizard.profile;
+  const platform = wizard.platform;
+  const isBrownfield = options.brownfield || wizard.brownfield;
+  createSpecwfStructure(specwfDir);
+  console.log("\u2713 \u521B\u5EFA specwf/ \u76EE\u5F55\u7ED3\u6784");
+  saveConfig(specwfDir, {
+    version: 1,
+    platform,
+    profile,
+    context: wizard.context,
+    workflow: {},
+    review: {},
+    change: {},
+    git: { branching: "none", create_tag: true },
+    conventions: { inject: true },
+    models: {}
+  });
+  console.log("\u2713 \u521B\u5EFA project.yml (profile: " + profile + ")");
+  saveState(specwfDir, {
+    project: {
+      name: baseDir.split("/").pop() || "project",
+      status: "initialized",
+      current_milestone: null,
+      current_phase: null
+    },
+    active_context: {
+      type: "project",
+      ref: null,
+      step: "init"
+    },
+    changes: [],
+    adhoc: []
+  });
+  console.log("\u2713 \u521B\u5EFA state.md");
+  if (isBrownfield) {
+    const info = detectProjectInfo(process.cwd());
+    const domains = await runBrownfieldInit(process.cwd(), specwfDir, info);
+    console.log("\u2713 \u5B58\u91CF\u9879\u76EE codebase mapping \u5B8C\u6210 (" + domains.length + " \u4E2A spec \u57DF)");
+  }
+  console.log("specwf \u521D\u59CB\u5316\u5B8C\u6210\u3002");
+  try {
+    const files = generateAll({ version: 1, platform, profile, context: wizard.context, workflow: {}, review: {}, change: {}, git: { branching: "none", create_tag: true }, conventions: { inject: true }, models: {} });
+    writeGeneratedFiles(files);
+    console.log(`\u2713 \u5E73\u53F0\u6587\u4EF6\u5DF2\u751F\u6210 (${files.length} \u4E2A)`);
+  } catch {
+    console.log("\u26A0 \u5E73\u53F0\u6587\u4EF6\u751F\u6210\u5931\u8D25\uFF0C\u53EF\u7A0D\u540E\u8FD0\u884C `specwf update` \u91CD\u8BD5");
+  }
+}
+
 // src/commands/specwf-update.ts
+import { join as join9 } from "path";
 function register2(program2) {
   program2.command("update").description("\u66F4\u65B0\u5E73\u53F0\u6587\u4EF6\uFF08commands + agents\uFF09").option("--dir <path>", "specwf \u76EE\u5F55", "specwf").action(updateHandler);
 }

package/dist/templates/commands/init.md

@@ -1,10 +1,23 @@
 # 初始化项目
 
-执行 `specwf init` 创建 specwf 目录结构。
+运行 `specwf init` 创建 specwf/ 目录结构 + platform.yml + state.md。
 
 ## 存量项目
 
-如果已有代码，执行 `specwf init --brownfield`，CLI 自动完成 codebase mapping + spec bootstrap。
+已有代码的项目使用 brownfield 模式：
+
+```bash
+specwf init --brownfield
+```
+
+CLI 创建目录结构后，**agent 需使用 specwf 子代理并行执行以下任务**：
+
+1. **Codebase Mapping**（`specwf-researcher`）— 分析技术栈、模块结构、依赖关系
+   - 产出: `specwf/research/STACK.md` + `specwf/research/ARCHITECTURE.md`
+2. **Spec Bootstrap**（`specwf-researcher`）— 从核心模块提取行为契约
+   - 产出: `specwf/specs/<domain>/spec.md`（标记 BOOTSTRAPPED）
+
+使用 task 工具 fan-out 两个 specwf-researcher 并行执行。
 
 ## 上下文
 
@@ -13,8 +26,12 @@ specwf context init
 specwf state
 ```
 
+可参考 @specwf/conventions/coding.md。
+
 ## 下一步
 
+完成后：
+
 ```bash
 specwf continue
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specwf",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "规格驱动开发工作流 — spec-driven development workflow for AI coding agents",
   "type": "module",
   "bin": {