abelworkflow 0.7.0 → 0.8.1

package/.gitignore

@@ -7,6 +7,8 @@
 */tmp/
 skills/dev-browser/profiles/
 skills/dev-browser/tmp/
+skills/dev-browser/.cache/
+*cache*/
 */dist/
 */build/
 .claude/

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

@@ -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.mjs

@@ -35,6 +35,14 @@ const codexTemplateConfigPath = join(codexTemplateRoot, "config-base.toml");
 const codexTemplateAgentsPath = join(codexTemplateRoot, "agents");
 const installBackupStamp = Date.now();
 const createdBackupPaths = new Set();
+const augmentContextEnginePermission = "mcp__augment-context-engine";
+const augmentContextEngineRetrievalTool = "mcp__augment-context-engine__codebase-retrieval";
+const augmentContextEngineFeaturePrompt = {
+  message: "是否启用 augment-context-engine MCP 代码检索支持？不确定建议选否，可减少 MCP 安装和配置麻烦。",
+  initialValue: false
+};
+const localCodebaseRetrievalPolicy = "Use local codebase retrieval with `rg`, `rg --files`, `git grep`, and direct file reads. Do not require augment-context-engine MCP.";
+const augmentCodebaseRetrievalPolicy = `Use \`${augmentContextEngineRetrievalTool}\` as the primary codebase search tool.`;
 const claudeModelEnvKeys = [
   "ANTHROPIC_MODEL",
   "ANTHROPIC_DEFAULT_OPUS_MODEL",
@@ -74,8 +82,7 @@ const defaultClaudeSettings = {
       "WebSearch",
       "TodoWrite",
       "NotebookRead",
-      "NotebookEdit",
-      "mcp__augment-context-engine"
+      "NotebookEdit"
     ],
     deny: []
   },
@@ -103,6 +110,69 @@ const ignoredSkillPathPatterns = [
   /^dev-browser\/tmp(\/|$)/
 ];
 
+function buildDefaultClaudeSettings({ augmentContextEngine = false } = {}) {
+  const settings = {
+    ...defaultClaudeSettings,
+    env: { ...defaultClaudeSettings.env },
+    permissions: {
+      ...defaultClaudeSettings.permissions,
+      allow: [...defaultClaudeSettings.permissions.allow],
+      deny: [...defaultClaudeSettings.permissions.deny]
+    },
+    hooks: { ...defaultClaudeSettings.hooks }
+  };
+
+  if (augmentContextEngine && !settings.permissions.allow.includes(augmentContextEnginePermission)) {
+    settings.permissions.allow.push(augmentContextEnginePermission);
+  }
+
+  return settings;
+}
+
+function getAugmentContextEnginePromptOptions() {
+  return { ...augmentContextEngineFeaturePrompt };
+}
+
+function resolveAugmentContextEngineFeature(options = {}, previousMetadata = {}) {
+  if (typeof options.augmentContextEngine === "boolean") {
+    return options.augmentContextEngine;
+  }
+
+  if (typeof previousMetadata?.features?.augmentContextEngine === "boolean") {
+    return previousMetadata.features.augmentContextEngine;
+  }
+
+  return false;
+}
+
+function getWorkflowRenderValues(augmentContextEngine) {
+  return {
+    CODEBASE_RETRIEVAL_POLICY: augmentContextEngine
+      ? augmentCodebaseRetrievalPolicy
+      : localCodebaseRetrievalPolicy,
+    AUGMENT_CONTEXT_ENGINE_VALIDATION: augmentContextEngine
+      ? `Verify MCP availability:\n   - \`${augmentContextEngineRetrievalTool}\``
+      : "Skip augment-context-engine MCP validation; use local retrieval tools.",
+    CODEBASE_RETRIEVAL_MANDATORY_RULE: augmentContextEngine
+      ? `Mandatory use of \`${augmentContextEngineRetrievalTool}\``
+      : "Mandatory use of configured codebase retrieval policy.",
+    CODEBASE_RETRIEVAL_STRUCTURE_REFERENCE: augmentContextEngine
+      ? `Inspect codebase structure: \`${augmentContextEngineRetrievalTool}\` with \`file list --recursive\`.`
+      : "Inspect codebase structure with `rg --files`, `git grep`, and direct file reads.",
+    CODEBASE_RETRIEVAL_PATTERN_AUDIT: augmentContextEngine
+      ? `Use augment-context-engine to validate against existing codebase patterns.\n   ${augmentContextEngineRetrievalTool}: "Search for existing implementations similar to change <change_name>. Keywords: [key concepts from proposal]"`
+      : "Use `rg`, `rg --files`, `git grep`, and direct file reads to validate against existing codebase patterns."
+  };
+}
+
+function renderManagedWorkflowContent(content, { augmentContextEngine = false } = {}) {
+  let nextContent = content;
+  for (const [key, value] of Object.entries(getWorkflowRenderValues(augmentContextEngine))) {
+    nextContent = nextContent.replaceAll(`{{${key}}}`, value);
+  }
+  return nextContent;
+}
+
 function printHelp() {
   console.log(`${c.bold("AbelWorkflow")} ${c.cyan("installer")}
 
@@ -320,6 +390,28 @@ async function writeInstallMetadata(agentsDir, metadata) {
   await writeFile(join(agentsDir, installMetadataName), `${JSON.stringify(metadata, null, 2)}\n`, "utf8");
 }
 
+async function renderManagedWorkflowFile(path, augmentContextEngine) {
+  if (!(await pathIsFile(path))) {
+    return;
+  }
+
+  const content = await readFile(path, "utf8");
+  const rendered = renderManagedWorkflowContent(content, { augmentContextEngine });
+  if (rendered !== content) {
+    await writeFile(path, rendered, "utf8");
+  }
+}
+
+async function renderManagedWorkflowFiles(agentsDir, augmentContextEngine) {
+  await renderManagedWorkflowFile(join(agentsDir, "AGENTS.md"), augmentContextEngine);
+
+  const commandsDir = join(agentsDir, "commands");
+  const commandFiles = await getCommandNames(commandsDir);
+  for (const fileName of commandFiles) {
+    await renderManagedWorkflowFile(join(commandsDir, fileName), augmentContextEngine);
+  }
+}
+
 async function syncPreservedManagedEntry(sourceRoot, targetRoot, entry, previousManagedChildren) {
   await removeIfNotDirectory(targetRoot);
   await mkdir(targetRoot, { recursive: true });
@@ -685,12 +777,27 @@ async function linkClaude(agentsDir, previousLinkedTargets) {
       "file",
       previousLinkedTargets
     ),
-    await ensureManagedLink(
-      join(claudeDir, "commands", "oc"),
-      join(agentsDir, "commands", "oc"),
-      "dir",
-      previousLinkedTargets
-    ),
+    ...(await (async () => {
+      const commandFiles = await getCommandNames(join(agentsDir, "commands"));
+      const r = [];
+      r.push(...(await pruneManagedTargets(
+        join(claudeDir, "commands"),
+        join(agentsDir, "commands"),
+        commandFiles,
+        previousLinkedTargets
+      )));
+      for (const fileName of commandFiles) {
+        r.push(
+          await ensureManagedLink(
+            join(claudeDir, "commands", fileName),
+            join(agentsDir, "commands", fileName),
+            "file",
+            previousLinkedTargets
+          )
+        );
+      }
+      return r;
+    })()),
     ...(await linkSkillDirectories(claudeDir, agentsDir, previousLinkedTargets))
   ];
 }
@@ -714,11 +821,11 @@ async function linkCodex(agentsDir, previousLinkedTargets) {
   );
   results.push(...(await linkSkillDirectories(codexDir, agentsDir, previousLinkedTargets)));
 
-  const commandFiles = await getCommandNames(join(agentsDir, "commands", "oc"));
+  const commandFiles = await getCommandNames(join(agentsDir, "commands"));
   results.push(
     ...(await pruneManagedTargets(
       join(codexDir, "prompts"),
-      join(agentsDir, "commands", "oc"),
+      join(agentsDir, "commands"),
       commandFiles,
       previousLinkedTargets
     ))
@@ -727,7 +834,7 @@ async function linkCodex(agentsDir, previousLinkedTargets) {
     results.push(
       await ensureManagedLink(
         join(codexDir, "prompts", fileName),
-        join(agentsDir, "commands", "oc", fileName),
+        join(agentsDir, "commands", fileName),
         "file",
         previousLinkedTargets
       )
@@ -740,12 +847,15 @@ async function linkCodex(agentsDir, previousLinkedTargets) {
 async function installManagedWorkflow(options) {
   let previousMetadata = {};
   let managedChildren = {};
+  let augmentContextEngine = false;
   const s = p.spinner();
 
   if (!options.relinkOnly) {
     s.start("正在同步工作流文件...");
     try {
       ({ previousMetadata, managedChildren } = await syncManagedFiles(options.agentsDir));
+      augmentContextEngine = resolveAugmentContextEngineFeature(options, previousMetadata);
+      await renderManagedWorkflowFiles(options.agentsDir, augmentContextEngine);
     } catch (e) {
       s.cancel(c.red(`同步失败: ${e.message}`));
       throw e;
@@ -756,6 +866,7 @@ async function installManagedWorkflow(options) {
   } else {
     previousMetadata = await readInstallMetadata(options.agentsDir);
     managedChildren = previousMetadata.managedChildren ?? {};
+    augmentContextEngine = resolveAugmentContextEngineFeature(options, previousMetadata);
   }
 
   const previousLinkedTargets = previousMetadata.linkedTargets ?? {};
@@ -784,10 +895,17 @@ async function installManagedWorkflow(options) {
       ])
   );
 
+  const managedClaudePermissions = await ensureClaudeSettingsForFeature(augmentContextEngine, previousMetadata);
+
   await writeInstallMetadata(options.agentsDir, {
     package: "abelworkflow",
     installedAt: new Date().toISOString(),
+    features: {
+      ...(previousMetadata.features && typeof previousMetadata.features === "object" ? previousMetadata.features : {}),
+      augmentContextEngine
+    },
     managedChildren,
+    managedClaudePermissions,
     linkedTargets
   });
 
@@ -1064,26 +1182,104 @@ async function configurePromptEnhancerEnv(agentsDir) {
   p.log.step(`已写入 ${pathToLabel(envPath)}`);
 }
 
-function mergeClaudeSettingsWithDefaults(settings) {
+function mergeClaudeSettingsWithDefaults(settings, { augmentContextEngine = false } = {}) {
+  const defaults = buildDefaultClaudeSettings({ augmentContextEngine });
   const env = settings?.env && typeof settings.env === "object" ? settings.env : {};
   const permissions = settings?.permissions && typeof settings.permissions === "object" ? settings.permissions : {};
   return {
-    ...defaultClaudeSettings,
+    ...defaults,
     ...settings,
     env: {
-      ...defaultClaudeSettings.env,
+      ...defaults.env,
       ...env
     },
     permissions: {
-      ...defaultClaudeSettings.permissions,
+      ...defaults.permissions,
       ...permissions,
-      allow: Array.isArray(permissions.allow) ? permissions.allow : defaultClaudeSettings.permissions.allow,
-      deny: Array.isArray(permissions.deny) ? permissions.deny : defaultClaudeSettings.permissions.deny
+      allow: Array.isArray(permissions.allow) ? permissions.allow : defaults.permissions.allow,
+      deny: Array.isArray(permissions.deny) ? permissions.deny : defaults.permissions.deny
     },
-    hooks: settings?.hooks && typeof settings.hooks === "object" ? settings.hooks : defaultClaudeSettings.hooks
+    hooks: settings?.hooks && typeof settings.hooks === "object" ? settings.hooks : defaults.hooks
   };
 }
 
+function getPreviousManagedClaudePermissions(previousMetadata = {}) {
+  return Array.isArray(previousMetadata.managedClaudePermissions)
+    ? previousMetadata.managedClaudePermissions.filter((value) => typeof value === "string")
+    : [];
+}
+
+function applyClaudePermissionFeature(settings, {
+  augmentContextEngine = false,
+  previousManagedPermissions = []
+} = {}) {
+  const hasSettings = settings && typeof settings === "object";
+  const wasManaged = previousManagedPermissions.includes(augmentContextEnginePermission);
+  if (!hasSettings && !augmentContextEngine) {
+    return { settings, changed: false, managedPermissions: [] };
+  }
+
+  const defaults = buildDefaultClaudeSettings({ augmentContextEngine: false });
+  const nextSettings = hasSettings
+    ? {
+        ...settings,
+        permissions: settings.permissions && typeof settings.permissions === "object"
+          ? { ...settings.permissions }
+          : {}
+      }
+    : defaults;
+  const permissions = nextSettings.permissions;
+  const allow = Array.isArray(permissions.allow)
+    ? [...permissions.allow]
+    : [...defaults.permissions.allow];
+  let changed = !hasSettings;
+  let isManaged = wasManaged;
+
+  if (augmentContextEngine) {
+    if (!allow.includes(augmentContextEnginePermission)) {
+      allow.push(augmentContextEnginePermission);
+      changed = true;
+      isManaged = true;
+    }
+  } else if (wasManaged && allow.includes(augmentContextEnginePermission)) {
+    allow.splice(allow.indexOf(augmentContextEnginePermission), 1);
+    changed = true;
+    isManaged = false;
+  } else {
+    isManaged = false;
+  }
+
+  permissions.allow = allow;
+  if (!Array.isArray(permissions.deny)) {
+    permissions.deny = [...defaults.permissions.deny];
+  }
+  nextSettings.permissions = permissions;
+
+  return {
+    settings: nextSettings,
+    changed,
+    managedPermissions: isManaged ? [augmentContextEnginePermission] : []
+  };
+}
+
+async function ensureClaudeSettingsForFeature(augmentContextEngine, previousMetadata) {
+  const settingsExists = await pathExists(claudeSettingsPath);
+  const settings = settingsExists ? await readJsonFileSafe(claudeSettingsPath, {}) : undefined;
+  const result = applyClaudePermissionFeature(settings, {
+    augmentContextEngine,
+    previousManagedPermissions: getPreviousManagedClaudePermissions(previousMetadata)
+  });
+
+  if (result.changed && result.settings) {
+    if (settingsExists) {
+      await backupExistingPath(claudeSettingsPath);
+    }
+    await writeJsonFileSafe(claudeSettingsPath, result.settings);
+  }
+
+  return result.managedPermissions;
+}
+
 function getExistingClaudeApiConfig(settings) {
   const env = mergeClaudeSettingsWithDefaults(settings).env;
   return {
@@ -1801,10 +1997,15 @@ async function installCliTool(tool) {
 }
 
 async function runFullInit(options) {
+  const augmentContextEngine = options.nonInteractive
+    ? false
+    : await confirmOrCancel(getAugmentContextEnginePromptOptions());
+
   await installManagedWorkflow({
     agentsDir: options.agentsDir,
     force: options.force,
-    relinkOnly: false
+    relinkOnly: false,
+    augmentContextEngine
   });
 
   if (await confirmOrCancel({ message: "是否安装或更新 Claude Code CLI？", initialValue: false })) {
@@ -1967,12 +2168,17 @@ async function main() {
 }
 
 export {
+  applyClaudePermissionFeature,
+  buildDefaultClaudeSettings,
   buildCodexConfigContent,
+  getAugmentContextEnginePromptOptions,
   getRunCommandSpawnOptions,
   hasPromptEnhancerApiConfig,
   main,
   mergeCodexAuthData,
   mergeClaudeSettingsWithDefaults,
+  renderManagedWorkflowContent,
+  resolveAugmentContextEngineFeature,
   resolvePromptEnhancerMode,
   resolveExistingCodexApiConfig,
   updateTomlSectionFields

package/lib/templates/codex/agents/default.toml

@@ -12,7 +12,7 @@ pre-implementation planning, post-implementation review, or bounded
 module-level implementation.
 """
 nickname_candidates    = ["Relay", "Pivot", "Anchor"]
-model                  = "gpt-5.4"
+model                  = "gpt-5.5"
 model_reasoning_effort = "high"
 sandbox_mode           = "workspace-write"
 

package/lib/templates/codex/agents/explorer.toml

@@ -11,7 +11,7 @@ Do NOT dispatch for review after implementation — use reviewer instead.
 Do NOT dispatch if the affected files are already known and confirmed.
 """
 nickname_candidates    = ["Atlas", "Trace", "Scout"]
-model                  = "gpt-5.4"
+model                  = "gpt-5.5"
 model_reasoning_effort = "high"
 sandbox_mode           = "read-only"
 

package/lib/templates/codex/agents/planner.toml

@@ -14,7 +14,7 @@ exceed execution value.
 Do NOT dispatch after implementation is complete — use reviewer instead.
 """
 nickname_candidates    = ["Blueprint", "Compass", "Architect"]
-model                  = "gpt-5.4"
+model                  = "gpt-5.5"
 model_reasoning_effort = "high"
 sandbox_mode           = "read-only"
 

package/lib/templates/codex/agents/reviewer.toml

@@ -11,7 +11,7 @@ Do NOT dispatch for codebase mapping or exploration — use explorer instead.
 Do NOT dispatch before implementation is complete.
 """
 nickname_candidates    = ["Delta", "Echo", "Sigma"]
-model                  = "gpt-5.4"
+model                  = "gpt-5.5"
 model_reasoning_effort = "xhigh"
 sandbox_mode           = "read-only"
 

package/lib/templates/codex/agents/worker.toml

@@ -10,7 +10,7 @@ Do NOT dispatch when the task touches global configs, shared utilities,
 public interfaces used across modules, or project scaffolding.
 """
 nickname_candidates    = ["Forge", "Patch", "Builder"]
-model                  = "gpt-5.4"
+model                  = "gpt-5.5"
 model_reasoning_effort = "high"
 sandbox_mode           = "workspace-write"
 

package/lib/templates/codex/config-base.toml

@@ -5,9 +5,11 @@ preferred_auth_method = "apikey"
 approvals_reviewer = "guardian_subagent"
 approval_policy = "on-request"
 sandbox_mode = "workspace-write"
-service_tier = "fast"
-model = "gpt-5.4"
+model = "gpt-5.5"
 model_reasoning_effort = "high"
+network_access = true
+supports_websockets = true
+requires_openai_auth = true
 developer_instructions = """
 Act as the default orchestrator for specialized subagents.
 
@@ -86,10 +88,12 @@ take precedence over the default routing below.
 
 [agents]
 max_threads = 10
-max_depth = 2
+max_depth = 1
 job_max_runtime_seconds = 2400
 
 [features]
 multi_agent = true
 js_repl = true
 guardian_approval = true
+responses_websockets_v2 = true
+shell_snapshot = true

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "abelworkflow",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Install AbelWorkflow into ~/.agents and create Claude/Codex symlinks.",
   "type": "module",
   "scripts": {
+    "test": "node --test test/runtime-doc-contracts.test.mjs test/cli-contracts.test.mjs test/codex-config.test.mjs",
     "test:contracts": "node --test test/runtime-doc-contracts.test.mjs test/cli-contracts.test.mjs"
   },
   "bin": {