@aipper/aiws-spec 0.0.25 → 0.0.27

package/templates/workspace/.iflow/commands/ws-doctor.toml

@@ -1,141 +0,0 @@
-# Command: ws:doctor
-# Description: 检查 workspace-A 约定并给出可执行的下一步
-# Category: workspace
-# Version: 1
-
-description = "检查 workspace-A 约定并给出可执行的下一步"
-
-prompt = """
-用中文输出。检查当前目录是否符合 AIWS workspace 约定，并给出可执行的下一步建议。
-
-Rules:
-- Do not print secrets (especially secrets/test-accounts.json).
-- Only report presence/absence and safe guidance.
-- Prefer Linux-first commands.
-
-Execute:
-!{bash -lc '
-set -euo pipefail
-
-ok()   { printf "OK: %s\n" "$*"; }
-warn() { printf "警告: %s\n" "$*"; }
-miss() { printf "缺失: %s\n" "$*"; }
-note() { printf "说明: %s\n" "$*"; }
-
-project_root() {
-  local root
-  root="$(git rev-parse --show-toplevel 2>/dev/null || true)"
-  if [[ -n "${root:-}" ]]; then
-    echo "$root"
-  else
-    pwd
-  fi
-}
-
-workspace_root() {
-  local d="$PWD"
-  while true; do
-    if [[ -f "$d/AI_WORKSPACE.md" || -f "$d/REQUIREMENTS.md" || -f "$d/AI_PROJECT.md" ]]; then
-      echo "$d"
-      return 0
-    fi
-    [[ "$d" == "/" ]] && break
-    d="$(dirname "$d")"
-  done
-  project_root
-}
-
-workspace_env() {
-  [[ -f AI_WORKSPACE.md ]] || return 0
-  local line
-  line="$(grep -m1 -E "^[[:space:]]*- environment:[[:space:]]*" AI_WORKSPACE.md 2>/dev/null || true)"
-  [[ -n "${line:-}" ]] || return 0
-  printf "%s\n" "$line" | sed -E "s/.*environment:[[:space:]]*\\\"?([^\\\"#[:space:]]+).*/\\1/"
-}
-
-subdir="$(pwd)"
-root="$(workspace_root)"
-cd "$root"
-
-echo "工作目录: $root"
-if [[ "$subdir" != "$root" ]]; then
-  echo "当前子目录: $subdir"
-fi
-echo
-
-need_init=0
-
-if [[ -f AGENTS.md ]]; then ok "AGENTS.md"; else warn "AGENTS.md 未发现（建议运行 /aiws-init 补齐）"; fi
-if [[ -f AI_PROJECT.md ]]; then ok "AI_PROJECT.md"; else miss "AI_PROJECT.md"; need_init=1; fi
-if [[ -f AI_WORKSPACE.md ]]; then ok "AI_WORKSPACE.md"; else miss "AI_WORKSPACE.md"; need_init=1; fi
-if [[ -f REQUIREMENTS.md ]]; then ok "REQUIREMENTS.md"; else miss "REQUIREMENTS.md"; need_init=1; fi
-
-if [[ -f requirements/CHANGELOG.md ]]; then ok "requirements/CHANGELOG.md"; else warn "requirements/CHANGELOG.md 未发现"; fi
-if [[ -f requirements/requirements-issues.csv ]]; then ok "requirements/requirements-issues.csv"; else warn "requirements/requirements-issues.csv 未发现"; fi
-if [[ -f issues/problem-issues.csv ]]; then ok "issues/problem-issues.csv"; else warn "issues/problem-issues.csv 未发现"; fi
-
-if [[ -f .aiws/manifest.json ]]; then ok ".aiws/manifest.json"; else miss ".aiws/manifest.json"; need_init=1; fi
-if [[ -f .githooks/pre-commit ]]; then ok ".githooks/pre-commit"; else warn ".githooks/pre-commit 未发现"; fi
-if [[ -f .githooks/pre-push ]]; then ok ".githooks/pre-push"; else warn ".githooks/pre-push 未发现"; fi
-
-echo
-echo "工具链:"
-if command -v python3 >/dev/null 2>&1; then ok "python3"; else warn "python3 未发现（aiws validate 需要）"; fi
-if command -v uv >/dev/null 2>&1; then ok "uv"; else note "uv 未发现（可选；用于运行 tools/server_test_runner.py）"; fi
-if command -v aiws >/dev/null 2>&1; then ok "aiws"; else note "aiws 未发现（可用 npx @aipper/aiws ...）"; fi
-
-echo
-echo "git hooks:"
-git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"
-if [[ -n "${git_root:-}" ]]; then
-  hooks_path="$(git config --get core.hooksPath 2>/dev/null || true)"
-  if [[ "$hooks_path" == ".githooks" ]]; then
-    ok "core.hooksPath=.githooks（提交/推送将自动运行 aiws validate）"
-  else
-    warn "core.hooksPath 未设置为 .githooks（当前：${hooks_path:-<unset>}）"
-    note "可执行：git config core.hooksPath .githooks"
-  fi
-else
-  note "未检测到 git 仓库（跳过 hooks 检查）"
-fi
-
-echo
-echo ".gitignore:"
-if [[ -f .gitignore ]]; then
-  if grep -qF "# AIWS_MANAGED_BEGIN:gitignore" .gitignore; then
-    ok ".gitignore 已包含 AIWS managed block"
-  else
-    warn ".gitignore 缺少 AIWS managed block（建议运行 /aiws-init 或 /aiws-update 修复）"
-  fi
-else
-  warn "未找到 .gitignore"
-fi
-
-echo
-env="$(workspace_env || true)"
-if [[ -n "${env:-}" ]]; then
-  echo "environment: ${env}"
-fi
-
-echo
-echo "下一步建议:"
-if [[ "$need_init" -eq 1 ]]; then
-  echo "  - 执行: /aiws-init（或 `npx @aipper/aiws init .`）"
-else
-  echo "  - 运行门禁: aiws validate .（或 `npx @aipper/aiws validate .`）"
-fi
-echo "  - 如 iFlow 拦截写入：/ws-contract-check（写入 stamp）"
-if [[ ! -f secrets/test-accounts.json && -f secrets/test-accounts.example.json ]]; then
-  echo "  - 创建 secrets：cp -n secrets/test-accounts.example.json secrets/test-accounts.json"
-fi
-if [[ -f tools/server_test_runner.py ]]; then
-  echo "  - 接口闭环（自动修复）：/server-fix"
-  echo "  - 仅执行 runner：uv run tools/server_test_runner.py --workspace . --manage-service"
-fi
-if [[ -d memory-bank ]]; then
-  echo "  - 固定上下文：更新 memory-bank/progress.md"
-else
-  echo "  - 初始化 memory-bank：/ws-memory-bank-init"
-fi
-'}
-"""

package/templates/workspace/.iflow/commands/ws-env-doctor.toml

@@ -1,74 +0,0 @@
-# Command: ws:env-doctor
-# Description: 检查工具链并给出 node/java/python/uv 切换建议（workspace-A）
-# Category: workspace
-# Version: 1
-
-description = "检查工具链并给出 node/java/python/uv 切换建议（workspace-A）"
-
-prompt = """
-用中文输出。检查当前环境的工具链与版本，并根据 AI_WORKSPACE.md 给出可执行的切换建议。
-
-规则：
-- 只读检查，不修改系统状态
-- 优先 Linux-first
-
-Execute:
-!{bash -lc '
-set -euo pipefail
-
-say() { printf "%s\n" "$*"; }
-have() { command -v "$1" >/dev/null 2>&1; }
-
-ws="$(pwd)"
-say "工作目录: $ws"
-
-if [[ -f AI_WORKSPACE.md ]]; then
-  say "OK: 发现 AI_WORKSPACE.md"
-else
-  say "警告: 未发现 AI_WORKSPACE.md（建议先 /aiws-init）"
-fi
-
-say ""
-say "== 工具可用性 =="
-for c in git uv node npm pnpm yarn java javac mvn gradle python3 mise asdf nvm sdk jenv; do
-  if have "$c"; then
-    say "OK: $c"
-  else
-    say "缺失: $c"
-  fi
-done
-
-say ""
-say "== 版本信息 =="
-have node && say "node: $(node -v 2>/dev/null || true)" || true
-have npm && say "npm: $(npm -v 2>/dev/null || true)" || true
-have pnpm && say "pnpm: $(pnpm -v 2>/dev/null || true)" || true
-have java && say "java: $(java -version 2>&1 | head -n 1)" || true
-have javac && say "javac: $(javac -version 2>&1 | head -n 1)" || true
-have python3 && say "python3: $(python3 -V 2>/dev/null || true)" || true
-have uv && say "uv: $(uv --version 2>/dev/null || true)" || true
-
-say ""
-say "== AI_WORKSPACE.md 建议执行的切换命令（如果已配置） =="
-extract_cmd() {
-  local key="$1"
-  rg -n \"^\\s*-\\s*${key}\\s*:\\s*\\\"(.*)\\\"\\s*$\" AI_WORKSPACE.md 2>/dev/null | sed -E \"s/.*\\\"(.*)\\\".*/\\1/\" | head -n 1
-}
-
-if [[ -f AI_WORKSPACE.md ]]; then
-  boot="$(extract_cmd toolchain_bootstrap_cmd || true)"
-  node_use="$(extract_cmd node_use_cmd || true)"
-  java_use="$(extract_cmd java_use_cmd || true)"
-
-  [[ -n \"$boot\" ]] && say \"toolchain_bootstrap_cmd: $boot\"
-  [[ -n \"$node_use\" ]] && say \"node_use_cmd: $node_use\"
-  [[ -n \"$java_use\" ]] && say \"java_use_cmd: $java_use\"
-fi
-
-say ""
-say "下一步建议："
-say "- 若版本不匹配：把 node/java 的版本与切换命令写进 AI_WORKSPACE.md 的 3.3 节"
-say "- 跑服务端接口测试：uv run tools/server_test_runner.py --workspace . --manage-service"
-say "- 跑需求交付闭环：/ws-feature-plan -> /ws-feature-deliver"
-'}
-"""

package/templates/workspace/.iflow/commands/ws-feature-deliver.toml

@@ -1,44 +0,0 @@
-# Command: ws:feature-deliver
-# Description: 执行跨子项目交付闭环（需求 -> 代码 -> 测试 -> Review -> 提交）
-# Category: workspace
-# Version: 1
-
-description = "执行跨子项目交付闭环（需求 -> 代码 -> 测试 -> Review -> 提交）"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：在工作区根目录执行“需求->实现->测试->审核->提交”的闭环，尽量减少人工干预，但严格遵守边界与可回滚。
-
-必须遵守：
-- REQUIREMENTS.md 为唯一真值；若发现需求缺口，先补齐“可验收字段”，不要擅自改语义
-- 需求变更必须通过 `/ws-req-change` 处理，并写入 `requirements/CHANGELOG.md`，再同步 issues 执行合同（避免需求漂移）
-- AI_WORKSPACE.md policy 为硬边界（默认 environment=test、base_url_allowlist=localhost）；不满足时不得执行自动化测试/自动提交
-- secrets/test-accounts.json 为敏感文件，禁止输出内容
-- 反死循环：连续 2 轮无法减少 BLOCKED 或无法推进 issues 状态，必须缩小范围或先修环境/补齐 REQUIREMENTS，不能继续盲改
-
-步骤（按顺序）：
-1) 预检（缺失则补齐）：
-   - 若不存在 `issues/feature-issues.csv`：先执行 `/ws-feature-plan` 生成计划与执行合同
-   - 检查 AI_WORKSPACE.md 是否有 environment/test 与 base_url_allowlist；缺失则用默认安全值并提示用户确认
-   - 若 AI_WORKSPACE.md 定义了 toolchain_bootstrap_cmd / node_use_cmd / java_use_cmd：在任何 build/test 前必须先执行（用 bash -lc 保证加载 shell 环境）
-2) 执行（每次只推进 1~3 个 TODO）：
-   - 从 issues/feature-issues.csv 选取 TODO，标为 DOING
-   - 先做“现状验证”：检查该 issue 对应能力是否已存在（避免重复实现/冲突）；若已满足则记录证据并直接标 DONE
-   - 否则实现最小代码修改（只改与该 issue 相关的文件）
-   - 运行对应 Tests（按 issue 的 Tests 字段或 AI_WORKSPACE.md 的 *_test_cmd）
-   - 通过则标 DONE；失败则标 BLOCKED 并写 Notes（含复现命令与证据路径）
-3) 如果涉及服务端 API 或你检测到存在 tools/server_test_runner.py：
-   - 运行 runner 生成证据包与接口合同：
-     `uv run tools/server_test_runner.py --workspace . --manage-service`
-   - 若存在 BLOCKED：执行 `/server-fix`（或 `/server-triage` 输出修复清单），直到接口验收通过或达到迭代上限
-4) 审核：
-   - 对照 REQUIREMENTS.md 验收标准逐项确认（不满足就回到步骤2/3）
-5) 提交：
-   - 若工作区使用 git submodule：优先 `/server-commit`（仅提交 server_dirs），或用 `/server-fix-and-commit`
-   - 其它 submodule（web/app）若需要提交：先给出“将提交哪些目录/文件”的清单，再执行对应子仓库 commit（不要 push）
-
-输出要求：
-- 每轮输出：本轮处理的 Issue_ID、改动文件、测试命令与结果摘要、下一步
-- 全部完成时输出：可以 merge/提 PR 的最小检查清单
-"""

package/templates/workspace/.iflow/commands/ws-feature-plan.toml

@@ -1,47 +0,0 @@
-# Command: ws:feature-plan
-# Description: 规划跨子项目的交付（需求 -> 代码 -> 测试 -> Review -> 提交）
-# Category: workspace
-# Version: 1
-
-description = "规划跨子项目的交付（需求 -> 代码 -> 测试 -> Review -> 提交）"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：在“目录A工作区”（可能包含 server/web/app 等多个 submodule 目录）为本次需求变更产出一个可执行计划，并把计划落到可追踪的执行合同里。
-
-输入（按优先级读取）：
-- REQUIREMENTS.md：需求与验收标准（唯一真值来源）
-- AI_WORKSPACE.md：工作区结构、目录发现、policy（environment/base_url_allowlist 等）、启动/测试覆盖方式
-- docs/openapi.json（若涉及服务端 API）
-
-进行中项目（必须先做，不允许“从零假设”）：
-1) 代码现状盘点：扫描当前工作区（server/web/app）已有实现与现有接口（OpenAPI/路由/关键模块）。
-2) 需求对比：将 REQUIREMENTS.md 的目标逐项映射到“已有/缺失/部分完成”，并给证据（文件路径/接口路径）。
-3) 只为“缺失/部分完成”的项创建 issues；已有项要么标 DONE（需有证据），要么标 SKIP（说明理由）。
-
-输出必须包含：
-1) GOALS / NON-GOALS（必须与 REQUIREMENTS.md 一致）
-2) 影响范围（按 subproject 列出：server/web/app；给出候选目录与识别依据）
-3) 执行合同（写入/维护这些文件）：
-   - issues/feature-issues.csv：任务分解（TODO/DOING/DONE/BLOCKED/SKIP）
-   - （如涉及 API）issues/server-api-issues.csv：接口验收合同（由 runner 维护）
-4) 测试策略（按 subproject）：
-   - server：优先 runner（uv），并遵守 AI_WORKSPACE.md policy（base_url_allowlist/allow_mutations）
-   - web/app：优先使用 AI_WORKSPACE.md 指定的 *_test_cmd；若缺失则基于常见标记提出建议但不臆测结果
-   - 工具链准备：如果 AI_WORKSPACE.md 定义了 toolchain_bootstrap_cmd / node_use_cmd / java_use_cmd，必须在 build/test 前执行
-5) 风险/边界：
-    - 不改需求语义；需求不清先补 REQUIREMENTS.md（只补可验收字段）
-    - 需求变更必须通过 `/ws-req-change` 处理，并写入 `requirements/CHANGELOG.md`，再同步 issues 执行合同
-    - 不触发破坏性数据操作（除非 environment=test 且 allow_mutations=true 且 REQUIREMENTS 明确允许）
-6) 回滚方案（按 submodule/根仓库分别写）
-7) 完成条件：满足 REQUIREMENTS.md 的验收 + 所有相关测试通过 + 无未解释错误日志
-
-执行合同 CSV（必须创建或更新）：
-- 文件：issues/feature-issues.csv
-- 列（固定）：Issue_ID, Subproject, Title, Files, Tests, Status, Notes
-- Status：TODO | DOING | DONE | BLOCKED | SKIP
-
-最后给出下一步命令（建议）：
-- 运行交付闭环：`/ws-feature-deliver`
-"""

package/templates/workspace/.iflow/commands/ws-finish.toml

@@ -1,54 +0,0 @@
-# Command: ws:finish
-# Description: AI Workspace 安全收尾（门禁 + fast-forward 合并 + submodule 并回分支后顺序 push）
-# Category: workspace
-# Version: 1
-
-description = "AI Workspace 安全收尾（门禁 + fast-forward 合并 + submodule 并回分支后顺序 push）"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：安全把 `change/<change-id>` fast-forward 合并回目标分支，并按 `submodule -> superproject` 顺序 push，减少遗漏。
-补充：若团队希望减少 submodule detached 的人为差异，建议在 `.gitmodules` 配置 `submodule.<name>.branch`，并在日常拉取时使用 `ws:pull`。
-
-强制步骤：
-1) 读取真值文件：`AI_PROJECT.md`、`REQUIREMENTS.md`、`AI_WORKSPACE.md`（缺失则先运行 `/aiws-init` 或 `aiws init .`）。
-2) 若 iFlow 拦截写入：先执行 `/ws-contract-check`，再继续。
-3) 确认 git 状态（必须输出给用户）：
-   - `git status --porcelain`
-   - `git branch --show-current`（或 `git rev-parse --abbrev-ref HEAD`）
-4) 若工作区不干净：停止，并要求先 commit 或 stash（不要尝试自动处理）。
-4.1) 若存在 `.gitmodules`：必须为每个 submodule 配置 `submodule.<name>.branch`（否则先运行 `ws:submodule-setup` 并提交 `.gitmodules`）。
-5) （推荐）门禁校验并落盘证据：`aiws validate . --stamp`（未安装全局 aiws 时可用 `npx @aipper/aiws validate . --stamp`）。
-5.1) （强烈建议）收敛持久证据并回填 `Evidence_Path`：`aiws change evidence <change-id>`（未安装全局 aiws 时可用 `npx @aipper/aiws change evidence <change-id>`）。
-5.2) （可选）生成状态快照（建议）：`aiws change state <change-id> --write`。
-6) 若不存在 `.gitmodules`，或 submodules 已按顺序处理完成，优先直接执行最小收尾闭环：
-   - `aiws change finish <change-id> --push`
-   - 在 `change/<change-id>` 分支上也可省略 `<change-id>`；命令会尝试读取 `changes/<change-id>/.ws-change.json` 的 `base_branch`
-   - 该命令会在 fast-forward 合并成功后 push 目标分支；默认优先使用 upstream 配置（`branch.<name>.remote` + `branch.<name>.merge`），只有在你明确知道要推向别的 remote 时才追加 `--remote <name>`
-   - 若 `change/<change-id>` 位于独立 worktree，且该 worktree 干净，则会在 push 成功后自动执行 `git worktree remove` + `git worktree prune`
-   - AI 入口执行前，应先向用户说明将要 push 的 remote/branch；显式传入 `--push` 即视为确认
-7) 若提示无法 fast-forward：先在 change 分支（或对应 worktree）里执行 `git rebase <target-branch>`，再重试 `aiws change finish --push`。
-8) 若需要先处理 submodules，则按顺序处理每个 submodule（先并回目标分支，再 push）：
-   - 先显式解析 base branch，不要用当前分支名替代：
-     - `python3 - <<'PY'`
-     - `import json, pathlib; meta = pathlib.Path("changes") / "<change-id>" / ".ws-change.json"; print((json.loads(meta.read_text(encoding="utf-8")).get("base_branch") or "").strip())`
-     - `PY`
-   - 发现 submodules：`git config --file .gitmodules --get-regexp '^submodule\\..*\\.path$'`
-   - 对每个 `<sub_path>`：
-     - 读取 superproject 当前 gitlink：`git rev-parse "HEAD:<sub_path>"`
-     - 目标分支真值：`changes/<change-id>/submodules.targets`；若条目里分支写 `.`，则展开为刚才解析出的 `base_branch`
-     - 生成/检查 `submodules.targets` 时，detached HEAD 默认建议取 `.gitmodules` 的 `submodule.<name>.branch`；已附着在本地分支时默认建议取当前分支；这些都只是预填建议，不是 finish/push 的运行时真值
-     - 不要直接切 `change/<change-id>` / `main` / `master` 来解 detached
-     - 用 pin 分支挂回（不改动现有 main/master 指针）：`git -C "<sub_path>" checkout -B "aiws/pin/<target-branch>" <gitlink-sha>`
-     - 仅当 `<gitlink-sha>` 属于 `origin/<target-branch>` 历史时才允许 push；否则停止并人工处理分叉
-     - push（只允许 fast-forward）：`git -C "<sub_path>" push origin "<gitlink-sha>:refs/heads/<target-branch>"`
-9) 任一 submodule 不满足 fast-forward 条件时立即停止（不要继续 push 主仓库）。
-10) submodules push 完成后，再回到主仓库执行：
-   - `aiws change finish <change-id> --push`
-11) （可选）交付完成后归档变更工件：`aiws change archive <change-id>`。
-
-边界：
-- push 前先输出状态并说明远端/分支。
-- 不执行破坏性命令。
-"""

package/templates/workspace/.iflow/commands/ws-init.toml

@@ -1,53 +0,0 @@
-# Command: ws:init
-# Description: 初始化当前目录为 workspace-A（AI_WORKSPACE/REQUIREMENTS/tools/secrets 示例）
-# Category: workspace
-# Version: 1
-
-description = "初始化当前目录为 workspace-A（AI_WORKSPACE/REQUIREMENTS/tools/secrets 示例）"
-
-prompt = """
-用中文输出；命令与路径保持原样不翻译。
-
-目标：把“当前目录”初始化为 aiws `workspace` 模板（真值文件 + 门禁 + tool-native commands）。
-
-约束：
-- 不创建/不打印真实 secrets；只生成 `secrets/test-accounts.example.json` 示例文件。
-- 默认不做破坏性操作。
-
-执行：
-!{bash -lc '
-set -euo pipefail
-
-root="$(pwd)"
-
-run_aiws() {
-  local subcmd="$1"
-  shift
-
-  if [[ -x "$root/node_modules/.bin/aiws" ]]; then
-    "$root/node_modules/.bin/aiws" "$subcmd" "$@"
-    return 0
-  fi
-  if command -v aiws >/dev/null 2>&1; then
-    aiws "$subcmd" "$@"
-    return 0
-  fi
-  if command -v npx >/dev/null 2>&1; then
-    npx -y @aipper/aiws "$subcmd" "$@"
-    return 0
-  fi
-
-  echo "error: aiws not found (install @aipper/aiws or ensure npx is available)" >&2
-  exit 2
-}
-
-run_aiws init .
-run_aiws validate .
-
-echo "下一步:"
-echo "  - 启用本机 hooks：git config core.hooksPath .githooks"
-echo "  - 如启用了 iFlow pre_tool_guard：执行 /ws-contract-check（写入 stamp）"
-echo "  - 创建 secrets：cp -n secrets/test-accounts.example.json secrets/test-accounts.json"
-echo "  - 重新运行门禁：aiws validate ."
-'}
-"""

package/templates/workspace/.iflow/commands/ws-memory-bank-init.toml

@@ -1,100 +0,0 @@
-# Command: ws:memory-bank-init
-# Description: 初始化 memory-bank/（用于固定上下文，避免会话跑偏）
-# Category: workspace
-# Version: 1
-
-description = "初始化 memory-bank/（用于固定上下文，避免会话跑偏）"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：在当前 git workspace 根目录创建/更新 `memory-bank/` 的模板文件（非需求真值），用于固定工程上下文。
-
-执行：
-!{bash -lc '
-set -euo pipefail
-
-ws_root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
-cd "$ws_root"
-
-mkdir -p memory-bank
-
-write_if_missing() {
-  local p="$1"
-  shift
-  if [[ -f "$p" ]]; then
-    echo "OK: exists: $p"
-    return 0
-  fi
-  mkdir -p "$(dirname "$p")"
-  cat >"$p" <<EOF
-$*
-EOF
-  echo "OK: created: $p"
-}
-
-write_if_missing "memory-bank/README.md" "# Memory Bank（工作区上下文）
-
-目的：给 iFlow/Codex/Claude 一个“固定且可持续更新”的上下文集合，避免每次会话重新讲一遍导致跑偏。
-
-在你的工作区中：
-- \`REQUIREMENTS.md\` 仍是**需求真值**（不要复制到这里）。
-- \`AI_PROJECT.md\` / \`AI_WORKSPACE.md\` 是**边界与运行真值**。
-- 本目录补齐的是“实现过程中的稳定上下文”（更偏工程视角）。
-
-建议规则：
-- 改代码前：先看 \`REQUIREMENTS.md\` + \`AI_PROJECT.md\` + \`AI_WORKSPACE.md\`，再结合本目录的 \`architecture.md\`/\`progress.md\`。
-- 每次完成一个可验证的小步：更新 \`progress.md\`（写清：做了什么、证据路径、下一步）。
-- 发生重大结构变化：更新 \`architecture.md\`（只写高层关系，不要堆细节）。
-"
-
-write_if_missing "memory-bank/tech-stack.md" "# Tech Stack
-
-填写原则：只写“确实在用且影响决策”的信息，避免长篇大论。
-
-建议包含：
-- 语言/运行时版本（例如 Java/Node/Python）
-- 构建工具链（Gradle/Maven、pnpm、uv 等）
-- 关键框架与约束（Spring Boot、Ktor、Vue、React 等）
-- 数据层（DB/Redis/MQ）与迁移方式
-- 本地/测试环境切换方式（引用 \`AI_WORKSPACE.md\` 的命令即可）
-"
-
-write_if_missing "memory-bank/architecture.md" "# Architecture
-
-目标：记录“模块关系与关键边界”，让新的会话可以快速对齐代码布局。
-
-建议包含：
-- 目录/模块分层（例如 server/web/app）
-- 核心数据流（请求入口 → service → repo → DB）
-- 关键约束（鉴权、request-id、幂等、事务）
-"
-
-write_if_missing "memory-bank/implementation-plan.md" "# Implementation Plan
-
-目标：把需求拆成可验证的小步（每步都有验证命令与期望结果）。
-
-模板（示例字段）：
-- Step 1: …
-  - Scope:
-  - Files:
-  - Verify: \`...\`
-  - Expected:
-"
-
-write_if_missing "memory-bank/progress.md" "# Progress
-
-每次完成一个可验证小步就追加一条：
-
-- YYYY-MM-DD HH:MM: 做了什么（关联 Issue_ID/验收项）
-  - Changed: \`path/to/file\`
-  - Verify: \`command\`
-  - Evidence: \`path/to/log_or_report\`
-  - Next:
-"
-'}
-
-说明：
-- `REQUIREMENTS.md` 仍是需求真值；不要把需求复制进 memory-bank。
-- 建议完成后立刻执行：`/ws-contract-check`（让 pre_tool_guard 放行写入类工具）。
-"""

package/templates/workspace/.iflow/commands/ws-migrate.toml

@@ -1,59 +0,0 @@
-# Command: ws:migrate
-# Description: 将当前目录迁移到最新的 workspace-A 约定（安全，默认不覆盖）
-# Category: workspace
-# Version: 1
-
-description = "迁移当前目录为 workspace-A 约定（补齐 AI_PROJECT.md 与 .gitignore managed block，默认不覆盖）"
-
-prompt = """
-用中文输出；命令与路径保持原样不翻译。
-
-目标：将“当前目录”迁移/补齐为最新的 aiws `workspace` 约定（以 `.aiws/manifest.json` 与模板托管面为准）。
-
-安全规则：
-- 不要打印 secrets；不要创建真实 secrets。
-- 只通过 `aiws init/update/validate` 更新托管面（replace_file + managed blocks）。
-
-迁移完成后建议运行 `/ws-doctor` 并手工检查 `AI_PROJECT.md` 的“项目特有规则”段是否符合本项目约束。
-
-Execute:
-!{bash -lc '
-set -euo pipefail
-
-root="$(pwd)"
-
-run_aiws() {
-  local subcmd="$1"
-  shift
-
-  if [[ -x "$root/node_modules/.bin/aiws" ]]; then
-    "$root/node_modules/.bin/aiws" "$subcmd" "$@"
-    return 0
-  fi
-  if command -v aiws >/dev/null 2>&1; then
-    aiws "$subcmd" "$@"
-    return 0
-  fi
-  if command -v npx >/dev/null 2>&1; then
-    npx -y @aipper/aiws "$subcmd" "$@"
-    return 0
-  fi
-
-  echo "error: aiws not found (install @aipper/aiws or ensure npx is available)" >&2
-  exit 2
-}
-
-if [[ -f ".aiws/manifest.json" ]]; then
-  run_aiws update .
-else
-  run_aiws init .
-fi
-run_aiws validate .
-
-echo
-echo "下一步:"
-echo "  - 运行: /ws-doctor"
-echo "  - 手工检查: AI_PROJECT.md（把本项目的特殊约束补齐进去）"
-echo "  - 如启用了 iFlow pre_tool_guard：执行 /ws-contract-check（写入 stamp）"
-'}
-"""

package/templates/workspace/.iflow/commands/ws-preflight.toml

@@ -1,30 +0,0 @@
-# Command: ws:preflight
-# Description: AI Workspace 预检：读 AI_PROJECT/REQUIREMENTS/AI_WORKSPACE 并输出约束摘要
-# Category: workspace
-# Version: 1
-
-description = "AI Workspace 预检：读 AI_PROJECT/REQUIREMENTS/AI_WORKSPACE 并输出约束摘要"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：在开始“写代码/改配置/给补丁”之前，先把工作区真值文件读全并对齐，避免规则漂移。
-
-执行步骤（强制）：
-1) 定位项目根目录：
-   - 优先：`git rev-parse --show-toplevel`
-   - 若失败：说明无法判断项目根；请用户确认当前目录是否为项目根（不要猜测）。
-2) 在项目根目录读取以下文件（存在则必须读取；缺失则明确报告缺失项，不要臆测内容）：
-   - `AI_PROJECT.md`
-   - `REQUIREMENTS.md`
-   - `AI_WORKSPACE.md`
-3) 输出：
-   - `Root:` <项目根路径>
-   - `Found:` 列出实际读取到的文件列表
-   - `Missing:` 列出缺失文件（若缺失 `AI_PROJECT.md`，建议用户先运行 `/ws-migrate` 或 `/aiws-init` 补齐）
-   - `Key rules:` 用 3–8 条 bullet 摘要关键约束（范围/禁止项/必须产物/必须验证命令）
-
-安全规则：
-- 不打印 secrets；遇到疑似敏感值仅提示并建议迁移到本地私密文件（不要复述原文）。
-- 不执行破坏性命令。
-"""

package/templates/workspace/.iflow/commands/ws-pull.toml

@@ -1,47 +0,0 @@
-# Command: ws:pull
-# Description: 拉取并对齐 submodules（fast-forward；尽量避免 detached）
-# Category: workspace
-# Version: 1
-
-description = "拉取并对齐 submodules（fast-forward；尽量避免 detached）"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：安全拉取 superproject，并对齐 submodules，尽量把 submodule 从 detached HEAD “挂回”分支（仅当该分支包含 gitlink commit），减少人为操作差异。
-
-安全约束（强制）：
-- 不执行破坏性命令；不自动提交/不自动 push
-- 若工作区不干净：停止并要求用户先 commit 或 stash
-- `git pull` 默认只允许 fast-forward（避免隐式 merge/rebase）
-
-步骤（建议）：
-1) 输出上下文并检查工作区干净：
-   - `git rev-parse --show-toplevel`
-   - `git branch --show-current`
-   - `git status --porcelain`
-   - 若 `git status --porcelain` 非空：停止。
-
-2) 拉取 superproject（fast-forward only）：
-   - `git pull --ff-only`
-   - 若失败：停止并说明需要用户明确选择 `git pull --rebase` 或手动处理。
-
-3) 更新 submodules 到 superproject 记录的 gitlink commit：
-   - 若存在 `.gitmodules`：
-     - `git submodule sync --recursive`
-     - `git submodule update --init --recursive`
-
-4) （可选但推荐）把 submodule 从 detached HEAD 尽量“挂回分支”（不改动 gitlink commit）：
-   - 为避免 origin 多分支时“猜错分支”，只在 `.gitmodules` 明确配置了 `submodule.<name>.branch` 时才执行；否则保持 detached 并提示先对齐配置
-   - 目标分支：`.gitmodules` 的 `submodule.<name>.branch`（若为 `.` 则用 superproject 当前分支）
-   - 对每个 submodule：
-     - `sub_sha="$(git rev-parse "HEAD:<sub_path>")"`
-     - `git -C "<sub_path>" fetch origin --prune`
-     - 若 `sub_sha` 属于 `origin/<target_branch>`：创建/更新 pin 分支 `aiws/pin/<target_branch>` 指向 `$sub_sha`（不改动现有分支）
-     - 否则保持 detached 并提示原因
-
-可选（方案 2，一次性设置 submodule 跟踪分支，会改 `.gitmodules`，需提交）：
-- `git submodule set-branch --branch main <sub_path>`
-- `git add .gitmodules && git commit -m "chore(submodule): set tracking branch"`
-推荐：优先使用 `ws:submodule-setup` 交互式对齐所有 submodules 的 branch，并提交 `.gitmodules`。
-"""