@aipper/aiws-spec 0.0.25 → 0.0.27

package/templates/workspace/tools/ws_change_check.py

@@ -16,6 +16,13 @@ from typing import Any, Dict, List, Optional, Tuple
 
 CHANGE_BRANCH_RE = re.compile(r"^(change|changes|ws|ws-change)/([a-z0-9]+(?:-[a-z0-9]+)*)$")
 CHANGE_ID_RE = re.compile(r"^[a-z0-9]+(?:-[a-z0-9]+)*$")
+PIN_BRANCH_RE = re.compile(r"^aiws/pin/.+$")
+FINISH_DONE_COMPLETED_CLEANUPS = {
+    "removed",
+    "pruned-missing",
+    "skipped:no_separate_change_worktree",
+    "skipped:current_worktree",
+}
 
 
 def eprint(msg: str) -> None:
@@ -93,6 +100,53 @@ def parse_submodule_targets(path: Path) -> Tuple[Dict[str, Tuple[str, str]], Lis
     return parsed, perr
 
 
+def git_text(root: Path, args: List[str]) -> Tuple[int, str, str]:
+    try:
+        res = subprocess.run(
+            ["git", "-C", str(root), *args],
+            check=False,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            text=True,
+        )
+        return (res.returncode, (res.stdout or "").strip(), (res.stderr or "").strip())
+    except Exception as exc:
+        return (1, "", str(exc))
+
+
+def resolve_change_gitlink_commit(root: Path, change_id: str, sub_path: str) -> str:
+    for spec in (f"change/{change_id}:{sub_path}", f"HEAD:{sub_path}"):
+        code, out, _ = git_text(root, ["rev-parse", spec])
+        if code == 0 and out:
+            return out
+    return ""
+
+
+def git_ref_exists(root: Path, ref: str) -> bool:
+    code, _, _ = git_text(root, ["show-ref", "--verify", "--quiet", ref])
+    return code == 0
+
+
+def git_revision_exists(root: Path, rev: str) -> bool:
+    code, _, _ = git_text(root, ["cat-file", "-e", f"{rev}^{{commit}}"])
+    return code == 0
+
+
+def git_is_ancestor(root: Path, older: str, newer: str) -> bool:
+    code, _, _ = git_text(root, ["merge-base", "--is-ancestor", older, newer])
+    return code == 0
+
+
+def resolve_branch_ref(repo_root: Path, remote: str, branch: str) -> str:
+    remote_ref = f"refs/remotes/{remote}/{branch}"
+    if git_ref_exists(repo_root, remote_ref):
+        return remote_ref
+    local_ref = f"refs/heads/{branch}"
+    if git_ref_exists(repo_root, local_ref):
+        return local_ref
+    return ""
+
+
 def sha256(path: Path) -> str:
     h = hashlib.sha256()
     with path.open("rb") as f:
@@ -128,6 +182,17 @@ def current_branch(root: Path) -> Optional[str]:
         return None
 
 
+def is_submodule_repo(root: Path) -> bool:
+    try:
+        parent = subprocess.check_output(
+            ["git", "-C", str(root), "rev-parse", "--show-superproject-working-tree"],
+            text=True,
+        ).strip()
+        return bool(parent)
+    except Exception:
+        return False
+
+
 def infer_change_id_from_branch(branch: Optional[str]) -> Optional[str]:
     if not branch:
         return None
@@ -137,6 +202,103 @@ def infer_change_id_from_branch(branch: Optional[str]) -> Optional[str]:
     return m.group(2)
 
 
+def parse_archived_change_dir_name(entry_name: str) -> Optional[Tuple[str, str, str]]:
+    m = re.match(r"^(\d{4}-\d{2}-\d{2})-(.+?)(?:-(\d{8}-\d{6}Z))?$", entry_name or "")
+    if not m:
+        return None
+    change_id = (m.group(2) or "").strip()
+    if not CHANGE_ID_RE.match(change_id):
+        return None
+    return (m.group(1) or "", change_id, m.group(3) or "")
+
+
+def find_archived_change(root: Path, change_id: str) -> Optional[Path]:
+    archive_root = root / "changes" / "archive"
+    if not archive_root.exists():
+        return None
+    matches: List[Path] = []
+    for entry in archive_root.iterdir():
+        if not entry.is_dir():
+            continue
+        parsed = parse_archived_change_dir_name(entry.name)
+        if parsed and parsed[1] == change_id:
+            matches.append(entry)
+    if not matches:
+        return None
+    return sorted(matches, key=lambda item: item.name)[-1]
+
+
+def classify_finish_lifecycle_event(ev: Dict[str, Any]) -> Optional[Tuple[str, str]]:
+    event_type = str((ev or {}).get("type") or "").strip()
+    if not event_type:
+        return None
+    if event_type == "finish_local":
+        return ("local", "")
+    if event_type == "finish_failed":
+        return ("failed", str((ev or {}).get("payload", {}).get("error") or ""))
+    if event_type == "finish_cleanup_pending":
+        payload = (ev or {}).get("payload") or {}
+        return ("cleanup_pending", str(payload.get("reason") or payload.get("cleanup") or ""))
+    if event_type == "finish":
+        return ("done", "")
+    if event_type != "finish_done":
+        return None
+    payload = (ev or {}).get("payload")
+    if not isinstance(payload, dict):
+        payload = {}
+    push_present = "push" in payload
+    push_completed = payload.get("push") is True if push_present else None
+    cleanup = str(payload.get("cleanup") or "").strip()
+    if push_completed is False or cleanup == "not_requested":
+        return ("local", "")
+    if not cleanup or cleanup in FINISH_DONE_COMPLETED_CLEANUPS:
+        return ("done", "")
+    reason = cleanup[len("skipped:") :] if cleanup.startswith("skipped:") else cleanup
+    return ("cleanup_pending", reason)
+
+
+def summarize_finish_state(change_dir: Path) -> str:
+    metrics_path = change_dir / "metrics.json"
+    if not metrics_path.exists():
+        return ""
+    try:
+        metrics = json.loads(read_text(metrics_path))
+    except Exception:
+        return ""
+    events = metrics.get("events")
+    if not isinstance(events, list):
+        return ""
+    finish_state = ""
+    for ev in events:
+        event_type = str((ev or {}).get("type") or "").strip()
+        if not event_type:
+            continue
+        if finish_state == "done" and event_type not in ("finish_done", "finish"):
+            continue
+        classified = classify_finish_lifecycle_event(ev)
+        if not classified:
+            continue
+        finish_state = classified[0]
+    return finish_state
+
+
+def terminated_change_message(root: Path, change_id: str) -> Optional[str]:
+    change_dir = root / "changes" / change_id
+    if change_dir.exists() and summarize_finish_state(change_dir) == "done":
+        return (
+            f"change/{change_id} already reached finish, but archive/push closeout is still pending; "
+            f"rerun `aiws change finish {change_id} --push` instead of continuing development on this branch"
+        )
+    archived = find_archived_change(root, change_id)
+    if archived:
+        handoff = archived / "handoff.md"
+        details = f"change/{change_id} is already archived at {archived.relative_to(root)}"
+        if handoff.exists():
+            details += f" (handoff: {handoff.relative_to(root)})"
+        return details + "; create a new follow-up change instead of reusing this branch"
+    return None
+
+
 def has_truth_files(root: Path) -> Tuple[bool, List[str]]:
     required = ["AI_PROJECT.md", "AI_WORKSPACE.md", "REQUIREMENTS.md"]
     missing = [f for f in required if not (root / f).exists()]
@@ -487,6 +649,45 @@ def validate_change(
                 else:
                     warnings.append(msg)
 
+        if subs:
+            targets_path = change_dir / "submodules.targets"
+            if targets_path.exists() and targets_path.stat().st_size > 0:
+                targets, _ = parse_submodule_targets(targets_path)
+                base_branch = str(meta.get("base_branch") or "").strip() or "main"
+                for _, sub_path in subs:
+                    target = targets.get(sub_path)
+                    if not target:
+                        continue
+                    target_branch = target[0] if target[0] != "." else base_branch
+                    remote = target[1] or "origin"
+                    gitlink_sha = resolve_change_gitlink_commit(root, change_id, sub_path)
+                    if not gitlink_sha:
+                        warnings.append(f"unable to resolve gitlink commit for submodule path: {sub_path}")
+                        continue
+                    sub_root = root / sub_path
+                    if not sub_root.exists():
+                        warnings.append(f"submodule path not initialized locally (skip target consistency check): {sub_path}")
+                        continue
+                    if not git_revision_exists(sub_root, gitlink_sha):
+                        warnings.append(
+                            f"{sub_path}: gitlink commit {gitlink_sha} is not available in local submodule clone; run `git submodule update --init --recursive`"
+                        )
+                        continue
+                    branch_ref = resolve_branch_ref(sub_root, remote, target_branch)
+                    if not branch_ref:
+                        warnings.append(
+                            f"{sub_path}: cannot verify target branch history locally (missing {remote}/{target_branch} and local branch {target_branch})"
+                        )
+                        continue
+                    if git_is_ancestor(sub_root, gitlink_sha, branch_ref):
+                        continue
+                    errors.append(
+                        f"{sub_path}: gitlink commit {gitlink_sha} is not contained in declared target branch {remote}/{target_branch}"
+                    )
+                    errors.append(
+                        f"hint: fix `.gitmodules` / `changes/{change_id}/submodules.targets`, or move the submodule gitlink onto a commit reachable from {remote}/{target_branch}"
+                    )
+
     def placeholder_scan(rel: str, text: str) -> None:
         if "{{CHANGE_ID}}" in text or "{{TITLE}}" in text or "{{CREATED_AT}}" in text:
             errors.append(f"unrendered template placeholders in {rel}")
@@ -942,6 +1143,8 @@ def main(argv: Optional[List[str]] = None) -> int:
 
     branch_arg = (args.branch or "").strip()
     branch = branch_arg or current_branch(root)
+    inferred_from_branch = False
+    submodule_repo = is_submodule_repo(root)
     if not change_id:
         # Detached HEAD during rebase/merge; do not block unless CI passes --branch.
         if not branch:
@@ -950,26 +1153,40 @@ def main(argv: Optional[List[str]] = None) -> int:
         allow = {b.strip() for b in (args.allow_branches or "").split(",") if b.strip()}
         if branch in allow:
             return 0
+        if submodule_repo and PIN_BRANCH_RE.match(branch):
+            return 0
         inferred = infer_change_id_from_branch(branch)
         if not inferred:
             eprint(f"error: branch must be change/<change-id> (current: {branch})")
             eprint("hint: switch/create: git switch -c change/<change-id>")
             return 2
         change_id = inferred
+        inferred_from_branch = True
     else:
         # If CI provides --branch, cross-check branch naming even when --change-id is provided.
         if branch_arg:
             allow = {b.strip() for b in (args.allow_branches or "").split(",") if b.strip()}
             if branch_arg not in allow:
-                inferred = infer_change_id_from_branch(branch_arg)
-                if not inferred:
-                    eprint(f"error: branch must be change/<change-id> (current: {branch_arg})")
-                    return 2
-                if inferred != change_id:
-                    eprint(f"error: change-id does not match branch (branch={branch_arg}, change_id={change_id})")
-                    return 2
+                if submodule_repo and PIN_BRANCH_RE.match(branch_arg):
+                    branch_arg = ""
+                else:
+                    inferred = infer_change_id_from_branch(branch_arg)
+                    if not inferred:
+                        eprint(f"error: branch must be change/<change-id> (current: {branch_arg})")
+                        return 2
+                    if inferred != change_id:
+                        eprint(f"error: change-id does not match branch (branch={branch_arg}, change_id={change_id})")
+                        return 2
 
     change_dir = root / "changes" / change_id
+    terminated = terminated_change_message(root, change_id) if (inferred_from_branch or bool(branch_arg)) else None
+    if terminated:
+        eprint(f"error: {terminated}")
+        eprint(
+            f"hint: stop using change/{change_id} for new work; rerun `aiws change finish {change_id} --push` "
+            "or archive manually only for local recovery"
+        )
+        return 2
     if not change_dir.exists():
         eprint(f"error: missing change dir: {change_dir}")
         eprint(f"hint: create: aiws change new {change_id} --no-design")

package/templates/workspace/.iflow/agents/feature-reviewer.md

@@ -1,27 +0,0 @@
----
-agentType: "feature-reviewer"
-whenToUse: "用于交付前审核：对照 REQUIREMENTS.md 检查实现/测试/日志/边界是否达标，并给出是否可提交的结论。"
-model: ""
-allowedTools: ["*"]
-proactive: false
-systemPrompt: |
-  你是“交付审核员（Feature Reviewer）”，默认中文输出，只做审核，不做实现。
-
-  审核输入：
-  - REQUIREMENTS.md（验收真值）
-  - issues/feature-issues.csv（任务状态）
-  - （如有）issues/server-api-issues.csv + .agentdocs/tmp/server-test/report.json（接口验收证据）
-
-  审核规则：
-  - 任何 TODO/DOING/BLOCKED 不允许进入提交阶段。
-  - 任何越过 policy 的行为（非 test 环境、base_url 不在 allowlist）视为不合格。
-  - 必须有可复现的测试命令与通过证据（不允许“口头通过”）。
-
-  输出：
-  - 结论：可提交 / 不可提交
-  - 阻塞项列表（引用文件路径）
-  - 推荐的最小下一步
----
-
-# Feature Reviewer
-

package/templates/workspace/.iflow/agents/requirements-analyst.md

@@ -1,24 +0,0 @@
----
-agentType: "requirements-analyst"
-whenToUse: "用于把 REQUIREMENTS.md 补齐成“可验收、可测试”的形态：只补字段与验收口径，不改变业务语义。"
-model: ""
-allowedTools: ["*"]
-proactive: false
-systemPrompt: |
-  你是“需求分析与验收规范化专家（Requirements Analyst）”，默认中文输出。
-
-  工作目标：
-  - 把 REQUIREMENTS.md 从“描述性”补齐到“可验收、可测试”的最小版本。
-  - 只补齐缺失字段/示例/验收口径，不改变需求语义；遇到语义不清只提问 1-2 个关键问题。
-
-  边界：
-  - 不引入 secrets，不打印 secrets/test-accounts.json。
-  - 不决定是否允许副作用；这属于 AI_WORKSPACE.md policy + REQUIREMENTS 明确许可的范围。
-
-  输出要求：
-  - 给出明确的“验收清单”（可对应到 issues CSV 的字段）。
-  - 给出需要补充或更新的文件路径与回滚方式。
----
-
-# Requirements Analyst
-

package/templates/workspace/.iflow/agents/server-commit-manager.md

@@ -1,28 +0,0 @@
----
-agentType: "server-commit-manager"
-whenToUse: "用于全部 DONE/SKIP 后的提交收口：submodule 内 commit + 工作区根仓库 gitlink bump commit，并做敏感文件防护。"
-model: ""
-allowedTools: ["*"]
-proactive: false
-systemPrompt: |
-  你是“提交管理员（Committer）”，默认中文输出，只负责在验收通过后安全提交。
-
-  硬性前置：
-  - `issues/server-api-issues.csv` 不得包含 TODO/DOING/BLOCKED。
-  - 必须处于测试环境：`AI_WORKSPACE.md` 中 `environment: "test"`。
-
-  安全边界：
-  - 禁止提交 `.env`、`secrets/`、token/key/credential 等敏感文件；发现立即停止并提示用户移除。
-  - 不执行 push。
-  - commit message 使用通用、简洁、可审阅的约定（Conventional Commits）。
-
-  执行方式：
-  - 优先调用 `/server:commit`（或 `/server:fix-and-commit` / `/server:fix-and-commit`）。
-  - 若启用 hooks 自动提交，也要强调以 AI_WORKSPACE.md 的边界为准。
----
-
-# Server Commit Manager
-
-使用提示：
-- 全通过后用 `/server:commit` 或 `/server:fix-and-commit`。
-

package/templates/workspace/.iflow/agents/server-fix-implementer.md

@@ -1,31 +0,0 @@
----
-agentType: "server-fix-implementer"
-whenToUse: "用于代码修复阶段：根据 triage 结论做最小修复，并确保 request-id/trace-id 约定与 OpenAPI/需求一致。"
-model: ""
-allowedTools: ["*"]
-proactive: false
-systemPrompt: |
-  你是“服务端修复实现者（Implementer）”，默认中文输出，只做最小代码修改与可验证修复。
-
-  硬性前置（每次准备改代码前都要做）：
-  - 先阅读工作区真值文件：`REQUIREMENTS.md`、`AI_PROJECT.md`、`AI_WORKSPACE.md`（缺任何一个都先停止并让用户补齐/确认）。
-  - 明确本次要改动的 GOALS / NON-GOALS，并把改动映射到 REQUIREMENTS 的具体验收项（无法映射就不要改代码）。
-  - 如果 iFlow 的 pre_tool_guard 拦截提示缺少 contract-check：先执行 `/ws:contract-check` 再继续。
-
-  工作边界：
-  - 你只改代码/配置，不改 REQUIREMENTS 的业务期望（除非明确是需求文档缺失且用户同意补齐）。
-  - 修复前必须先阅读证据：resp/out、log_snippet、以及 CSV 的 Expected_* 字段。
-  - 对框架/API 用法不确定时，优先用 Context7 查官方文档后再修改。
-  - 严格遵守 Request-ID 约定：客户端携带 `X-Request-Id`，服务端响应回传，并在日志中输出 `request_id=<id>`（或 AI_WORKSPACE.md 定义的等价字段）。
-
-  验证要求：
-  - 每次修复后给出最小复测命令（runner 优先；只重测相关 service/相关 endpoint）。
-  - 不声称通过，除非确实运行并看到结果。
-  - 不做 git commit。
----
-
-# Server Fix Implementer
-
-使用提示：
-- 优先配合 `/server:fix` 使用（它会驱动 runner→triage→修复→复测闭环）。
-

package/templates/workspace/.iflow/agents/server-test-planner.md

@@ -1,28 +0,0 @@
----
-agentType: "server-test-planner"
-whenToUse: "用于工作区（目录A）服务端接口自动化测试的计划阶段：读 REQUIREMENTS/AI_WORKSPACE，生成可执行计划与执行合同（OpenAPI/CSV/边界）。"
-model: ""
-allowedTools: ["*"]
-proactive: false
-systemPrompt: |
-  你是“服务端接口测试规划师（Planner）”，只负责把需求变成可执行计划与执行合同，默认中文输出。
-
-  核心职责：
-  - 读取并严格遵守 `REQUIREMENTS.md`（唯一真值）与 `AI_WORKSPACE.md`（工作区约定）。
-  - 明确 GOALS / NON-GOALS，输出可以直接执行的步骤与命令（Linux-first）。
-  - 以 `docs/openapi.json` 为接口清单真值来源；缺失则优先规划“如何导出并固化到 docs/openapi.json”。
-  - 以 `issues/server-api-issues.csv` 为执行合同：为每个 endpoint 填入可验收字段（状态码/关键字段/日志检查/鉴权）。
-  - 明确边界：默认不测破坏性接口；只有在 `AI_WORKSPACE.md` 中 `allow_mutations=true` 且 REQUIREMENTS 明确允许时才覆盖。
-
-  输出要求：
-  - 用中文叙述，但命令/路径/代码标识符保持原样不翻译。
-  - 任何需要修改的文件必须列出路径，并提供回滚与验证命令。
-  - 不打印 `secrets/test-accounts.json` 内容；只引用其字段名/用途。
----
-
-# Server Test Planner
-
-使用提示：
-- 优先配合 `/server:test-plan` 或 `/server_test-plan` 使用。
-- 如果 `AI_WORKSPACE.md` 未声明 `server_dirs`，先让用户补齐（初始化阶段固定下来）。
-

package/templates/workspace/.iflow/agents/server-test-triager.md

@@ -1,30 +0,0 @@
----
-agentType: "server-test-triager"
-whenToUse: "用于接口测试失败分析：基于 report.json / CSV / 日志片段，把 BLOCKED 转换为可执行修复清单，并区分需求对齐 vs 代码缺陷。"
-model: ""
-allowedTools: ["*"]
-proactive: false
-systemPrompt: |
-  你是“服务端接口测试分诊师（Triage）”，默认中文输出，专注把失败项变成最小可执行修复动作。
-
-  输入优先级：
-  1) `.agentdocs/tmp/server-test/report.json`（机器可读失败清单）
-  2) `issues/server-api-issues.csv`（执行合同：Expected_* 与状态机）
-  3) `REQUIREMENTS.md`（业务验收真值）
-  4) 证据文件：`.out`（响应）与 `.log.txt`（按 request_id 命中的日志片段）
-
-  归因规则（必须明确写在输出里）：
-  - 若 Expected_Status/期望字段与 REQUIREMENTS 不一致：这是“需求/业务对齐问题”，先改 REQUIREMENTS/CSV，再决定是否改代码。
-  - 若响应 500/解析异常/安全链路错误/缺 request_id 日志：这是“代码/配置问题”，先用 Context7 查对应栈文档，再给最小修复点。
-
-  输出要求：
-  - 每个 BLOCKED 都必须引用 Issue_ID + endpoint + 证据路径（report.json/resp/log_snippet）。
-  - 提供“复测命令”：优先 `uv run tools/server_test_runner.py --workspace . --manage-service`，必要时只测单服务（--service）。
-  - 不打印 secrets；不做 git commit。
----
-
-# Server Test Triager
-
-使用提示：
-- 优先配合 `/server:triage` 使用（它会自动读取 report/CSV/requirements）。
-

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

@@ -1,24 +0,0 @@
-# Command: aiws:init
-# Description: 初始化/补齐 aiws workspace 模板（生成真值文件与门禁）
-# Category: aiws
-# Version: 1
-
-description = "初始化/补齐 aiws workspace 模板（生成真值文件与门禁）"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：
-- 生成/补齐真值文件与门禁文件（以 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md` 为准）
-- 写入/更新 `.gitignore` 的 aiws 托管块
-- 生成/更新 `.aiws/manifest.json`（用于漂移检测）
-
-建议执行：
-1) `npx @aipper/aiws init .`
-2) `npx @aipper/aiws validate .`
-
-约束：
-- 不写入任何 secrets
-- 只允许更新托管块（`AIWS_MANAGED_BEGIN/END`）或 spec 指定的 `replace_file` 文件
-"""
-

package/templates/workspace/.iflow/commands/aiws-rollback.toml

@@ -1,18 +0,0 @@
-# Command: aiws:rollback
-# Description: 从 `.aiws/backups/` 回滚到某次快照（latest|timestamp）
-# Category: aiws
-# Version: 1
-
-description = "从 `.aiws/backups/` 回滚到某次快照（latest|timestamp）"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-用法：
-- `npx @aipper/aiws rollback . latest`
-- `npx @aipper/aiws rollback . <timestamp>`
-
-说明：
-- 仅恢复 aiws 备份过的文件；不会做额外推断或重建
-"""
-

package/templates/workspace/.iflow/commands/aiws-update.toml

@@ -1,23 +0,0 @@
-# Command: aiws:update
-# Description: 更新 aiws workspace 托管面（仅更新 replace_file/托管块）
-# Category: aiws
-# Version: 1
-
-description = "更新 aiws workspace 托管面（仅更新 replace_file/托管块）"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：
-- 从当前安装的 `@aipper/aiws-spec` 刷新模板托管面（replace_file + managed blocks）
-- 更新前备份到 `.aiws/backups/<timestamp>/`
-
-建议执行：
-1) `npx @aipper/aiws update .`
-2) `npx @aipper/aiws validate .`
-
-约束：
-- 不写入任何 secrets
-- 若托管块 marker 被破坏，`aiws update` 必须失败（提示重新 `aiws init` 或手工修复）
-"""
-

package/templates/workspace/.iflow/commands/aiws-validate.toml

@@ -1,18 +0,0 @@
-# Command: aiws:validate
-# Description: aiws 强门禁校验（required 结构 + 漂移检测 + python3 gate）
-# Category: aiws
-# Version: 1
-
-description = "aiws 强门禁校验（required 结构 + 漂移检测 + python3 gate）"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：
-- 作为 CI/本地门禁：校验 required 文件结构、托管块、`.aiws/manifest.json` 漂移
-- 强门禁：缺 `python3`/缺 required 脚本也应失败
-
-建议执行：
-- `npx @aipper/aiws validate .`
-"""
-

package/templates/workspace/.iflow/commands/server-commit.toml

@@ -1,27 +0,0 @@
-# Command: server:commit
-# Description: 提交 server 子模块并更新 workspace gitlink（安全，优先 Linux）
-# Category: server
-# Version: 1
-
-description = "提交 server 子模块并更新 workspace gitlink（安全，优先 Linux）"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：在“目录A工作区”根目录下，对 `AI_WORKSPACE.md` 指定的 `server_dirs` 进行安全提交：
-1) 在每个 server 子仓库（git submodule）内提交代码变更
-2) 在工作区根仓库提交 submodule 指针更新（gitlink bump）
-
-边界（必须遵守）：
-- 只允许在 `server_dirs` 指定的目录里提交（不自动扫描未知目录）
-- 若 `issues/server-api-issues.csv` 仍存在 TODO/DOING/BLOCKED，则拒绝提交（避免“未验收就提交”）
-- 禁止提交敏感文件：`.env`、`secrets/`、`*token*`、`*key*`、`*credential*` 等（发现则拒绝提交并提示整改）
-- 不执行 push，只做 commit
-- 若设置 `IFLOW_DRY_RUN=1`，只打印将执行的 git 命令，不实际提交
-
-执行：
-!{bash -lc '
-set -euo pipefail
-bash "$HOME/.iflow/hooks/server_commit.sh"
-'}
-"""