abelworkflow 0.6.5 → 0.8.0

package/.gitignore

@@ -7,10 +7,12 @@
 */tmp/
 skills/dev-browser/profiles/
 skills/dev-browser/tmp/
+skills/dev-browser/.cache/
+*cache*/
 */dist/
 */build/
 .claude/
 .codex/
 *pycache*/
-.codex
 openspec/
+package-lock.json

package/AGENTS.md

@@ -13,15 +13,15 @@
 
 ## Context Rules
 
-- Use `mcp__augment-context-engine__codebase-retrieval` as the primary codebase search tool
+- {{CODEBASE_RETRIEVAL_POLICY}}
 - Rely only on project code plus `grok/context7` results
 - If information is insufficient or uncertain, state it explicitly
 
 ## Workflow
 
 ```
-/oc:init → /oc:research → /oc:plan → /oc:implementation(TDD)
-                                   ↘ /oc:diagnose (bug fix)
+/abel-init → /abel-research → /abel-plan → /abel-implement(TDD)
+                                      ↘ /abel-diagnose (bug fix)
 ```
 
 ## Universal Constraints

package/README.md

@@ -112,7 +112,7 @@ npx abelworkflow --help
 |---|---|---|
 | `grok-search` | `~/.agents/skills/grok-search/.env` | `GROK_API_URL` `GROK_API_KEY` `GROK_MODEL` |
 | `context7-auto-research` | `~/.agents/skills/context7-auto-research/.env` | `CONTEXT7_API_KEY` |
-| `prompt-enhancer` | `~/.agents/skills/prompt-enhancer/.env` | `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` `PE_MODEL` |
+| `prompt-enhancer` | `~/.agents/skills/prompt-enhancer/.env` | `PE_API_URL` `PE_API_KEY` `PE_MODEL` |
 
 ### 方法二：源码克隆安装
 
@@ -178,15 +178,15 @@ node .\bin\abelworkflow.mjs install
 |---|---|---|---|
 | `AGENTS.md` | `~/.claude/CLAUDE.md` | `~/.codex/AGENTS.md` | 全局系统提示词/规则 |
 | `skills/<skill>/` | `~/.claude/skills/<skill>/` | `~/.codex/skills/<skill>/` | Skills（每个目录一个技能） |
-| `commands/oc/` | `~/.claude/commands/oc/` | `~/.codex/prompts/*.md` | Claude 读 `commands/`；Codex 读 `prompts/` |
+| `commands/abel-*.md` | `~/.claude/commands/abel-*.md` | `~/.codex/prompts/abel-*.md` | 扁平化部署，避免命名冲突 |
 
 ### 验证（可选）
 
 **Linux/macOS（bash/zsh）**
 
 ```bash
-ls -la "$HOME/.claude/CLAUDE.md" "$HOME/.claude/commands/oc"
-ls -la "$HOME/.codex/AGENTS.md" "$HOME/.codex/prompts/"{init,research,plan,implementation,diagnose}.md
+ls -la "$HOME/.claude/CLAUDE.md" "$HOME/.claude/commands/"abel-*.md
+ls -la "$HOME/.codex/AGENTS.md" "$HOME/.codex/prompts/"abel-*.md
 cat "$HOME/.claude/settings.json" | head
 cat "$HOME/.codex/config.toml" | head
 ```
@@ -194,9 +194,9 @@ cat "$HOME/.codex/config.toml" | head
 **Windows（PowerShell）**
 
 ```powershell
-Get-Item "$HOME\.claude\CLAUDE.md", "$HOME\.claude\commands\oc"
+Get-Item "$HOME\.claude\CLAUDE.md"; Get-ChildItem "$HOME\.claude\commands\abel-*.md"
 Get-Item "$HOME\.codex\AGENTS.md"
-Get-ChildItem "$HOME\.codex\prompts" | Where-Object { $_.Name -in @("init.md", "research.md", "plan.md", "implementation.md", "diagnose.md") }
+Get-ChildItem "$HOME\.codex\prompts\abel-*.md"
 Get-Content "$HOME\.claude\settings.json" -TotalCount 10
 Get-Content "$HOME\.codex\config.toml" -TotalCount 10
 ```

package/commands/{oc/diagnose.md → abel-diagnose.md}

@@ -1,11 +1,11 @@
 ---
-name: OC:Diagnose
+name: abel-diagnose
 description: Parallel diagnosis with batch fix reporting via systematic root cause analysis.
-category: OC
-tags: [diagnosis, bugfix]
+category: abel
+tags: [abel, diagnosis, bugfix]
 argument-hint: <problem-description>
 ---
-<!-- OC:START -->
+<!-- ABEL:START -->
 **Arguments**
 - Required: `<problem-description>` (one or more bug descriptions; comma-separated supported)
 
@@ -31,7 +31,7 @@ argument-hint: <problem-description>
 
 **Steps**
 1. Parse input, infer scope, and split into issue list (single or multiple).
-2. For each issue in parallel: collect logs/traces and locate code via `mcp__augment-context-engine__codebase-retrieval`.
+2. For each issue in parallel: collect logs/traces and locate code via the configured codebase retrieval policy.
 3. For each issue in parallel: perform root cause analysis; use `/sequential-think` for multi-component chains.
 4. Build dependency/conflict graph across issues and compute safe fix order.
 5. Run `/confidence-check` per issue; only issues with score ≥90% can move to fix generation.
@@ -60,4 +60,4 @@ Total: {n} | ReadyToFix: {n_ready} | Blocked: {n_blocked}
 ### Final Status
 {FIXED|PARTIAL|NEEDS_REVIEW|BLOCKED}
 ```
-<!-- OC:END -->
+<!-- ABEL:END -->

package/commands/{oc/implementation.md → abel-implement.md}

@@ -1,12 +1,12 @@
 ---
-name: OC:Implementation
+name: abel-implement
 description: Implement approved changes with mandatory TDD.
-category: OC
-tags: [openspec, implementation, TDD]
+category: abel
+tags: [abel, implementation, TDD]
 argument-hint: [change_name]
 ---
 
-<!-- OC:START -->
+<!-- ABEL:START -->
 **Arguments**
 - Requested: `<change_name>`
 
@@ -154,4 +154,4 @@ Frontend Review
 
 ✓ Implementation complete
 ```
-<!-- OC:END -->
+<!-- ABEL:END -->

package/commands/{oc/init.md → abel-init.md}

@@ -1,11 +1,11 @@
 ---
-name: OC:Init
+name: abel-init
 description: Initialize OpenSpec environment and validate required tooling.
-category: OC
+category: abel
 tags: [openspec, init, setup]
 ---
 
-<!-- OC:START -->
+<!-- ABEL:START -->
 **Guardrails**
 - Complete steps in order; stop on failure
 - Preserve existing config; do not overwrite without confirmation
@@ -16,12 +16,12 @@ tags: [openspec, init, setup]
 2. Verify `openspec` availability via `openspec --version`.
 3. If missing, `npm install -g @fission-ai/openspec@latest`, then re-check version.
 4. Run `openspec init` (or `openspec update` for existing projects).
-5. Verify required capability:
-   - MCP: `mcp__augment-context-engine__codebase-retrieval`
+5. {{AUGMENT_CONTEXT_ENGINE_VALIDATION}}
+6. Verify required skills:
    - Skills: `/dev-browser` `/sequential-think` `/context7-auto-research` `/grok-search` `/confidence-check`
-6. Output summary with ✓/✗:
+7. Output summary with ✓/✗:
    - OpenSpec installation
    - Project initialization
-   - MCP availability
+   - MCP availability if enabled
    - Required skills availability
-<!-- OC:END -->
+<!-- ABEL:END -->

package/commands/{oc/plan.md → abel-plan.md}

@@ -1,11 +1,11 @@
 ---
-name: OC:Plan
+name: abel-plan
 description: Refine approved change into a zero-decision executable plan.
-category: OC
-tags: [OC, plan, PBT]
+category: abel
+tags: [abel, plan, PBT]
 argument-hint: [change_name]
 ---
-<!-- OC:START -->
+<!-- ABEL:START -->
 **Guardrails**
 - Strictly adhere to **OpenSpec** rules when writing **standardized spec-structured projects**.
 - The goal of this phase is to eliminate ALL decision points from the task flow—implementation should be pure mechanical execution.
@@ -39,8 +39,8 @@ argument-hint: [change_name]
 
 4. **Uncertainty Elimination Audit**: Invoke skills to detect and eliminate remaining ambiguities:
    ```
-   # First, use augment-context-engine to validate against existing codebase patterns
-   mcp__augment-context-engine__codebase-retrieval: "Search for existing implementations similar to change <change_name>. Keywords: [key concepts from proposal]"
+   # First, validate against existing codebase patterns
+   {{CODEBASE_RETRIEVAL_PATTERN_AUDIT}}
    # Then audit for ambiguities directly and list them explicitly
    Review change <change_name> for decision points that remain unspecified. For each: [AMBIGUITY] <description> → [REQUIRED CONSTRAINT] <what must be specified>.
    Identify implicit assumptions in change <change_name>. For each: [ASSUMPTION] <description> → [EXPLICIT CONSTRAINT NEEDED] <concrete specification>.
@@ -85,4 +85,4 @@ A proposal is ready to exit the Plan phase only when:
 - [ ] All PBT properties documented with falsification strategies
 - [ ] `openspec validate <change_name> --strict` returns zero issues
 - [ ] User has explicitly approved all constraint decisions
-<!-- OC:END -->
+<!-- ABEL:END -->

package/commands/{oc/research.md → abel-research.md}

@@ -1,13 +1,13 @@
 ---
-name: OC:Research
+name: abel-research
 description: Transform user requirements into constraint sets via structured exploration (NO implementation)
-category: OC
-tags: [OC, research, constraints, exploration, subagents]
+category: abel
+tags: [abel, research, constraints, exploration, subagents]
 ---
 
-<!-- OC:RESEARCH:START -->
+<!-- ABEL:RESEARCH:START -->
 
-# OC:Research — Operating Mode (Constraints & Specs Only)
+# abel-research — Operating Mode (Constraints & Specs Only)
 
 ## Non‑Negotiable Rules (Highest Priority)
 1. RESEARCH MODE ONLY.
@@ -38,7 +38,7 @@ Produce constraint sets that narrow the solution space, plus measurable success
 ---
 
 ## Phase 2 — Initial Codebase Assessment (Read‑Only)
-- Use `mcp__augment-context-engine__codebase-retrieval` as the primary way to locate relevant code; avoid grep/find unless unavoidable.
+- {{CODEBASE_RETRIEVAL_POLICY}}
 - If technical research needed (architectural patterns, best practices), invoke `/grok-search` skill
 - If the codebase spans multiple modules/directories, dispatch parallel explore subagents by context boundary.
 
@@ -73,7 +73,7 @@ All explore subagents MUST return valid JSON using this schema:
 ## Phase 5 — Parallel Subagent Dispatch
 - Monitor subagent execution and collect structured reports.
 - For each boundary, spawn an Explore subagent with:
-  - Mandatory use of `mcp__augment-context-engine__codebase-retrieval`
+  - {{CODEBASE_RETRIEVAL_MANDATORY_RULE}}
   - Clear scope
   - self-contained with independent output
   - Required output template (from Phase 4)
@@ -113,7 +113,7 @@ All explore subagents MUST return valid JSON using this schema:
 
 ## Reference
 - Review existing constraints: `rg -n "Constraint:|MUST|MUST NOT" openspec/specs`
-- Inspect codebase structure: `ls -R` or `mcp__augment-context-engine__codebase-retrieval` with `file list --recursive`
+- {{CODEBASE_RETRIEVAL_STRUCTURE_REFERENCE}}
 
 - Check prior research outputs: `ls openspec/changes/*/`
 - OpenSpec CLI commands:
@@ -123,4 +123,4 @@ All explore subagents MUST return valid JSON using this schema:
   - `openspec instructions proposal --change <name>` - Get proposal instructions
 - Validate subagent outputs conform to template before aggregation.
 - Ask the user directly for ANY ambiguity—do not assume or guess.
-<!-- OC:RESEARCH:END -->
+<!-- ABEL:RESEARCH:END -->

package/lib/cli/logic.mjs

@@ -1,23 +1,91 @@
+import * as p from "@clack/prompts";
+
 const interactiveMenuDescriptors = [
-  { value: "full-init", label: "完整初始化：同步工作流 + 可选安装/配置 Claude Code、Codex、技能环境" },
-  { value: "install", label: "仅同步/更新工作流到 ~/.agents 并重新链接 Claude/Codex" },
-  { value: "grok-search", label: "配置 grok-search 环境变量" },
-  { value: "context7", label: "配置 context7-auto-research 环境变量" },
-  { value: "prompt-enhancer", label: "配置 prompt-enhancer 环境变量" },
-  { value: "claude-install", label: "安装或更新 Claude Code CLI" },
-  { value: "claude-api", label: "配置 Claude Code 第三方 API" },
-  { value: "codex-install", label: "安装或更新 Codex CLI" },
-  { value: "codex-api", label: "配置 Codex 第三方 API" },
-  { value: "exit", label: "退出" }
+  { value: "full-init", label: "完整初始化", hint: "同步 + 安装 + 配置", group: "main" },
+  { value: "install", label: "仅同步工作流", group: "main" },
+  { value: "grok-search", label: "配置 grok-search", hint: "技能", group: "skill" },
+  { value: "context7", label: "配置 context7-auto-research", hint: "技能", group: "skill" },
+  { value: "prompt-enhancer", label: "配置 prompt-enhancer", hint: "技能", group: "skill" },
+  { value: "claude-install", label: "安装/更新 Claude Code", hint: "CLI", group: "cli" },
+  { value: "claude-api", label: "配置 Claude API", hint: "CLI", group: "cli" },
+  { value: "codex-install", label: "安装/更新 Codex", hint: "CLI", group: "cli" },
+  { value: "codex-api", label: "配置 Codex API", hint: "CLI", group: "cli" },
+  { value: "exit", label: "退出", group: "exit" }
 ];
 
 const interactiveMenuDefaultValue = "full-init";
 
+class CancelledError extends Error {
+  constructor(message = "用户取消") {
+    super(message);
+    this.name = "CancelledError";
+  }
+}
+
+function required(message = "此项不能为空") {
+  return (value) => {
+    if (value === undefined || value === null || (typeof value === "string" && value.trim() === "")) {
+      return message;
+    }
+  };
+}
+
+function requiredUnlessExisting(existingValue, message = "此项不能为空") {
+  return (value) => {
+    if ((value === undefined || value === null || (typeof value === "string" && value.trim() === "")) && !existingValue) {
+      return message;
+    }
+  };
+}
+
+/**
+ * 回退逻辑：用户输入非空则用新值，否则用旧值。
+ * 输入 "-" 表示清除已有值（返回 undefined）。
+ * existingValue 可能来自 dotenv / JSON 读取，会传入空字符串；
+ * 空字符串将被净化为 undefined，避免写入无意义的空配置。
+ * 注意：本函数仅适用于字符串类型的配置值，不适用于可能为 0/false 的数字或布尔值。
+ */
+function resolvePasswordValue(userInput, existingValue) {
+  if (typeof userInput === "string") {
+    const trimmed = userInput.trim();
+    if (trimmed === "") {
+      if (typeof existingValue === "string" && existingValue.trim() === "") {
+        return undefined;
+      }
+      return existingValue || undefined;
+    }
+    return trimmed === "-" ? undefined : trimmed;
+  }
+  if (typeof existingValue === "string" && existingValue.trim() === "") {
+    return undefined;
+  }
+  return existingValue || undefined;
+}
+
+function assertNotCancelled(value) {
+  if (p.isCancel(value)) {
+    throw new CancelledError();
+  }
+}
+
+async function confirmOrCancel({ message, initialValue = false }) {
+  const value = await p.confirm({ message, initialValue, active: "是", inactive: "否" });
+  assertNotCancelled(value);
+  return value;
+}
+
+async function selectOrCancel(options) {
+  const value = await p.select(options);
+  assertNotCancelled(value);
+  return value;
+}
+
 function parseArgs(argv, { defaultAgentsDir, resolvePath }) {
   const options = {
     agentsDir: defaultAgentsDir,
     force: false,
     relinkOnly: false,
+    nonInteractive: false,
     command: "menu"
   };
   const positional = [];
@@ -42,6 +110,10 @@ function parseArgs(argv, { defaultAgentsDir, resolvePath }) {
       i += 1;
       continue;
     }
+    if (arg === "--non-interactive") {
+      options.nonInteractive = true;
+      continue;
+    }
     if (arg === "--help" || arg === "-h" || arg === "help") {
       helpRequested = true;
       options.command = "help";
@@ -75,40 +147,22 @@ function parseArgs(argv, { defaultAgentsDir, resolvePath }) {
     throw new Error("`--force`、`--link-only`、`--agents-dir` 仅能与 `install` 命令一起使用");
   }
 
-  return options;
-}
-
-function assertInteractiveMenuSupported({ command, inputIsTTY, outputIsTTY }) {
-  if (command === "menu" && (!inputIsTTY || !outputIsTTY)) {
-    throw new Error("交互式菜单需要 TTY 终端；非交互场景请显式使用 `npx abelworkflow install`");
+  if (!options.nonInteractive && process.env.CI) {
+    options.nonInteractive = true;
   }
-}
 
-function resolvePromptValue(answer, { defaultValue, allowEmpty = false } = {}) {
-  const value = String(answer).trim();
-  if (!value && defaultValue !== undefined) {
-    return { ok: true, value: defaultValue };
-  }
-  if (!value && !allowEmpty) {
-    return { ok: false, error: "此项不能为空。" };
-  }
-  return { ok: true, value };
+  return options;
 }
 
-function resolveSelectValue(answer, choices) {
-  const index = Number(answer) - 1;
-  if (Number.isInteger(index) && index >= 0 && index < choices.length) {
-    return { ok: true, value: choices[index].value };
+function assertInteractiveMenuSupported({ command, inputIsTTY, outputIsTTY, nonInteractive }) {
+  // 防御性检查（死代码守护）：main() 已在调用前将非交互 menu 降级为 install，
+  // 此处仅防止外部直接调用 assertInteractiveMenuSupported 时漏掉判断。
+  if (command === "menu" && nonInteractive) {
+    throw new Error("非交互模式已启用；请显式使用 `npx abelworkflow install` 进行安装");
   }
-  const direct = choices.find((choice) => choice.value === answer);
-  if (direct) {
-    return { ok: true, value: direct.value };
+  if (command === "menu" && (!inputIsTTY || !outputIsTTY)) {
+    throw new Error("交互式菜单需要 TTY 终端；非交互场景请显式使用 `npx abelworkflow install`");
   }
-  return { ok: false, error: "无效选择，请重新输入。" };
-}
-
-function shouldUseVisibleSecretFallback({ inputIsTTY, platform }) {
-  return !inputIsTTY || platform === "win32";
 }
 
 function getRunCommandSpawnOptions(platform = process.env.ABELWORKFLOW_TEST_PLATFORM || process.platform) {
@@ -120,11 +174,15 @@ function getRunCommandSpawnOptions(platform = process.env.ABELWORKFLOW_TEST_PLAT
 
 export {
   assertInteractiveMenuSupported,
+  assertNotCancelled,
+  CancelledError,
+  confirmOrCancel,
   getRunCommandSpawnOptions,
   interactiveMenuDefaultValue,
   interactiveMenuDescriptors,
   parseArgs,
-  resolvePromptValue,
-  resolveSelectValue,
-  shouldUseVisibleSecretFallback
+  required,
+  requiredUnlessExisting,
+  resolvePasswordValue,
+  selectOrCancel
 };