@aipper/aiws-spec 0.0.25 → 0.0.27

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

@@ -1,40 +0,0 @@
-# Command: ws:push
-# Description: 推送（submodule 感知：先 submodules 后 superproject；fast-forward；不 force）
-# Category: workspace
-# Version: 1
-
-description = "推送（submodule 感知：先 submodules 后 superproject；fast-forward；不 force）"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：安全 push 当前仓库；若仓库包含 submodules，则先 push submodules，再 push superproject（默认 fast-forward；不 force）。
-
-约束：
-- 不自动提交、不自动 `git add -A`
-- 不使用 `--force` / `--force-with-lease`
-- 若工作区不干净：停止并要求先 commit 或 stash
-
-步骤（建议）：
-1) 输出上下文并检查工作区干净：
-   - `git branch --show-current`
-   - `git status --porcelain`
-   - `git status -sb`
-   - 非空则停止。
-
-2) 判断是否存在 submodules：若存在 `.gitmodules`，输出 submodule 列表：
-   - `git config --file .gitmodules --get-regexp '^submodule\\..*\\.path$'`
-
-3) 若没有 submodules：正常 push（仍需用户确认远端/分支）：
-   - `git remote -v`
-   - `git push`
-
-4) 若有 submodules：先检查 `.gitmodules` 的 `submodule.<name>.branch` 是否齐全（缺失则停止并提示 `ws:submodule-setup`）。
-
-5) 逐个 push submodules（fast-forward only），再 push superproject：
-   - `git -C "<sub_path>" fetch origin --prune`
-   - 若 `origin/<target_branch>` 不是 `HEAD` 的祖先：停止并提示先在 submodule 做 rebase/merge
-   - `git -C "<sub_path>" push origin "HEAD:refs/heads/<target_branch>"`
-   - 最后 `git push`
-"""
-

package/templates/workspace/.iflow/commands/ws-req-change.toml

@@ -1,64 +0,0 @@
-# Command: ws:req-change
-# Description: 记录需求变更到 requirements/CHANGELOG.md 并更新 REQUIREMENTS.md
-# Category: requirements
-# Version: 1
-
-description = "记录需求变更到 requirements/CHANGELOG.md 并更新 REQUIREMENTS.md"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：处理“进行中的需求变更”，并把变更记录到独立的变更文件中，避免 REQUIREMENTS.md 的历史被覆盖。
-
-约定：
-- `REQUIREMENTS.md`：当前有效需求（唯一真值）
-- `requirements/CHANGELOG.md`：需求变更历史（追加记录，不改旧记录）
-- `requirements/requirements-issues.csv`：需求拆解执行合同（机器可读；用于审核/回放/状态机）
-
-步骤（必须按顺序）：
-1) 读取 `REQUIREMENTS.md` 与 `requirements/CHANGELOG.md`（若不存在则创建 changelog 文件与目录）
-2) 明确本次变更的类型：
-   - Clarify：补充不清晰的验收字段（不改变语义）
-   - Change：修改/新增/删除需求（改变语义）
-3) 产出“变更摘要”（1-5 条）并在执行前确认边界：
-   - 是否影响 API（OpenAPI/状态码/鉴权/字段）
-   - 是否影响自动化测试边界（allow_mutations/dangerous_disabled/base_url_allowlist）
-4) 对比与冲突检查（强制，不写文件）：
-   - 对比“变更前 vs 拟变更后”的差异清单（新增/删除/语义变化）
-   - 整理潜在冲突/不确定点（只列“最可能影响验收/实现”的，避免噪音）
-5) 逐条澄清（强制，避免一次问完）：
-   - 若存在潜在冲突/不确定点：本轮只问 1 个最高优先级问题（给出 2–4 个可选答案或二选一），然后停止，等待用户回复；不要继续问下一题，也不要写文件。
-   - 收到用户回复后：更新拟变更方案，回到步骤 4) 重新对比，直至没有未决问题。
-6) 强制停下来让用户确认：是否继续落盘？(Y/N)
-7) 用户确认 Y 后再写入：
-   - 更新 `REQUIREMENTS.md`（只留下当前有效版本；不要在文件中堆历史表格）
-   - 追加一条 changelog 记录到 `requirements/CHANGELOG.md`（必须包含：日期、变更内容、原因、影响范围、关联 issues/PR、记录人）
-8) 需求拆解到 CSV 执行合同（强制）：
-   - 确保存在 `requirements/requirements-issues.csv`（若无则初始化）：
-     - `python3 tools/requirements_contract.py init`
-   - 为本次变更新增/更新 1..N 条 Req 行，并拆到“可实现、可测试”的粒度：
-     - 每条至少写清：CRUD、Scenario、Inputs、Outputs、Business_Logic、Tests
-     - 状态机：
-       - `Spec_Status`: DRAFT(未完善)/READY(已完善可开工)
-       - `Impl_Status`: TODO/DOING/DONE/BLOCKED/SKIP
-   - 完成后必须跑一次校验（READY/DONE 的必填字段会被检查）：
-     - `python3 tools/requirements_contract.py validate`
-9) 同步/补齐需求执行合同（强制，自动处理 FlowSpec 有/无两种情况）：
-   - `python3 tools/requirements_contract_sync.py --workspace .`
-   - 说明：若 `REQUIREMENTS.md` 中不存在 FlowSpec（或 flows 为空），该命令只会确保 `requirements/requirements-issues.csv` 表头存在并给出 WARN（这是预期行为，不要当成失败）。
-10) 同步执行合同（至少做到其中之一）：
-   - 更新 `issues/feature-issues.csv`（新增/调整对应任务，并关联 Req_ID）
-   - 若涉及 API：运行/更新 runner 产物并修正 `issues/server-api-issues.csv` 的验收字段
-11) 生成简短逻辑图与场景执行合同（可选，但若存在 FlowSpec 则强烈建议自动执行）：
-   - 若 `REQUIREMENTS.md` 同时包含 `<!-- FLOW_SPEC_BEGIN -->` 与 `<!-- FLOW_SPEC_END -->`：运行 `/ws-req-flow-sync` 生成/更新 `docs/api-flow.mmd` 与 `issues/server-scenario-issues.csv`
-   - 否则：跳过，并提示用户“可以先不维护 FlowSpec；后续需要场景回归时再补”
-
-输出必须包含：
-- 本次更新的文件清单（路径）
-- 回滚方案（如何撤销本次需求变更）
-- 下一步建议命令（若存在 FlowSpec：包含 `/ws-req-flow-sync`；以及 `/server-fix` 或 runner 命令）
-
-安全规则：
-- 不打印 secrets/test-accounts.json
-- 不引入任何 token/密钥到仓库
-"""

package/templates/workspace/.iflow/commands/ws-req-contract-sync.toml

@@ -1,25 +0,0 @@
-# Command: ws:req-contract-sync
-# Description: 从 REQUIREMENTS.md 的 FlowSpec 补齐 requirements/requirements-issues.csv（半自动）
-# Category: requirements
-# Version: 1
-
-description = "从 REQUIREMENTS.md 的 FlowSpec 补齐 requirements/requirements-issues.csv（半自动）"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-用途：当项目已经做了一部分，但 `requirements/requirements-issues.csv` 还没建立/没补齐时，用本命令从 `REQUIREMENTS.md` 的 FlowSpec（机器可读）生成/补齐需求条目骨架。
-
-说明：
-- 本命令只做“补齐骨架”：把每条 Flow 变成一条 Req（默认 `Spec_Status=DRAFT`、`Impl_Status=TODO`），不会猜测你已完成哪些。
-- 生成后请手工补齐 CRUD/Inputs/Outputs/Business_Logic/Tests，并把可开工的条目标为 `Spec_Status=READY`。
-
-执行：
-!{bash -lc '
-set -euo pipefail
-python3 tools/requirements_contract_sync.py --workspace .
-'}
-
-下一步：
-- 运行：`/ws-req-contract-validate`
-"""

package/templates/workspace/.iflow/commands/ws-req-contract-validate.toml

@@ -1,16 +0,0 @@
-# Command: ws:req-contract-validate
-# Description: 校验 requirements/requirements-issues.csv（READY/DONE 必填字段）
-# Category: requirements
-# Version: 1
-
-description = "校验 requirements/requirements-issues.csv（READY/DONE 必填字段）"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-执行（失败则修正 CSV 再重试）：
-!{bash -lc '
-set -euo pipefail
-python3 tools/requirements_contract.py validate
-'}
-"""

package/templates/workspace/.iflow/commands/ws-req-flow-sync.toml

@@ -1,36 +0,0 @@
-# Command: ws:req-flow-sync
-# Description: 从 REQUIREMENTS.md FlowSpec 生成流程图与场景 CSV
-# Category: requirements
-# Version: 1
-
-description = "从 REQUIREMENTS.md FlowSpec 生成流程图与场景 CSV"
-
-prompt = """
-用中文输出；命令与路径保持原样不翻译。
-
-目标：在工作区根目录基于 `REQUIREMENTS.md` 内的 FlowSpec（FLOW_SPEC_BEGIN/END 标记）生成：
-- `docs/api-flow.mmd`（简短逻辑图，Mermaid）
-- `issues/server-scenario-issues.csv`（场景执行合同：TODO/DONE/BLOCKED）
-
-要求：
-- 不读取/不打印 secrets
-- 输出要短：只打印生成的文件路径与下一步命令
-
-Execute:
-!{bash -lc '
-set -euo pipefail
-
-[[ -f REQUIREMENTS.md ]] || { echo "缺少 REQUIREMENTS.md（请先 /aiws-init 或补齐需求文件）" >&2; exit 2; }
-
-if [[ -f tools/requirements_flow_gen.py ]]; then
-  python3 tools/requirements_flow_gen.py --workspace .
-  echo ""
-  echo "下一步:"
-  echo "  - 查看逻辑图: cat docs/api-flow.mmd"
-  echo "  - 查看场景合同: cat issues/server-scenario-issues.csv"
-else
-  echo "缺少工具: tools/requirements_flow_gen.py（建议运行 /aiws-init 或从模板复制）" >&2
-  exit 2
-fi
-'}
-"""

package/templates/workspace/.iflow/commands/ws-req-review.toml

@@ -1,56 +0,0 @@
-# Command: ws:req-review
-# Description: 需求整体评估（不落盘）：对 REQUIREMENTS.md 做 QA，输出缺口/冲突/风险，减少漂移
-# Category: requirements
-# Version: 1
-
-description = "需求整体评估（不落盘）：对 REQUIREMENTS.md 做 QA，输出缺口/冲突/风险，减少漂移"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：在不修改任何文件的前提下，对“当前整体需求”做一次质量评估（Requirements QA），提前发现不清晰/不可验收/与项目约束冲突的点，减少后续实现漂移。
-
-执行步骤（必须按顺序）：
-1) 定位项目根目录（优先 `git rev-parse --show-toplevel`；失败则停止并让用户确认根目录）。
-2) 在项目根目录读取（存在则必须读取；缺失则明确报告缺失项，不要臆测内容）：
-   - `AI_PROJECT.md`
-   - `REQUIREMENTS.md`
-   - `AI_WORKSPACE.md`
-   - `requirements/CHANGELOG.md`（若存在）
-   - `requirements/requirements-issues.csv`（若存在）
-3) 输出一个固定结构的评估报告（Markdown）：
-
-## Requirements QA
-
-### 1) 结论（1–3 行）
-- 当前需求是否“可进入实现阶段”？（是/否/有条件）
-
-### 2) 漂移风险（必须列出）
-- 哪些点最容易导致实现与需求不一致？为什么？
-
-### 3) 可验收性（必须列出）
-- 列出“缺少明确验收标准”的条目（输入/输出/错误码/边界条件/示例）。
-
-### 4) 完整性（必须列出）
-- 是否缺少：Non-goals、兼容性/迁移、鉴权/权限、失败重试、并发/幂等、观测性（日志/trace/request-id）、性能预算。
-
-### 5) 一致性（必须列出）
-- 与 `AI_PROJECT.md`（禁止项/产物要求/验证要求/边界）是否冲突？逐条列冲突与建议。
-
-### 6) 可测试性与证据（必须列出）
-- 给出最小验证路径（命令 + 期望结果 + 证据落盘路径建议，例如 `.agentdocs/tmp/...`）。
-
-### 7) 风险清单（3–8 条）
-- 风险 → 影响面 → 缓解建议（尽量可操作）。
-
-### 8) 需要澄清的问题（优先级排序）
-- 用 5–12 个问题把不确定点一次问清（每题说明“为什么要问/影响什么验收”）。
-
-4) **强制停下来询问用户确认**：
-   - 问用户：**“是否基于上述评估进入需求落盘/变更流程 `/ws-req-change`？(Y/N)”**
-   - 若 N：停止，等待用户补充信息或调整需求文本。
-
-边界：
-- 不打印任何 secrets（尤其是 `secrets/test-accounts.json`）。
-- 不执行破坏性命令。
-"""

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

@@ -1,33 +0,0 @@
-# Command: ws:review
-# Description: AI Workspace 交叉审计交付（Claude + Codex + Gemini），证据优先落盘到 changes/<change-id>/review/
-# Category: workspace
-# Version: 1
-
-description = "AI Workspace 交叉审计交付（Claude + Codex + Gemini），证据优先落盘到 changes/<change-id>/review/"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：在实现/提交前，对当前工作区改动进行交叉审计，并把审计结论优先落盘到 `changes/<change-id>/review/`（若无法确定 `change-id` 再回退 `.agentdocs/tmp/review/`），便于回放与追责。
-
-强制步骤：
-1) 读取真值文件：`AI_PROJECT.md`、`REQUIREMENTS.md`、`AI_WORKSPACE.md`。
-2) 若 iFlow 拦截写入：先执行 `/ws-contract-check`，再继续。
-3) 审计输入（按优先级）：
-   - `git diff`（或变更工件 `changes/<change-id>/`）
-   - `issues/*.csv`（状态机是否存在 TODO/DOING/BLOCKED）
-   - 最近一次门禁输出（如 `aiws validate .`）
-4) 输出（必须）：
-   - Findings：问题清单（按严重性排序，引用具体文件路径）
-   - Risks：3–8 条
-   - Next：最小修复清单 + 最小验证命令
-5) 证据落盘（必须）：
-   - 默认：在 `changes/<change-id>/review/` 写入一份 `iflow-review.<timestamp>.md`
-   - 回退：在 `.agentdocs/tmp/review/` 写入同名文件（仅在无法确定 `change-id` 时使用）
-6) 如果目标是提交前门禁：
-   - 建议运行：`aiws validate .`（或 `npx @aipper/aiws validate .`）
-
-边界：
-- 不打印任何 secrets（尤其是 `secrets/test-accounts.json`）。
-- 不执行破坏性命令。
-"""

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

@@ -1,43 +0,0 @@
-# Command: ws:rule
-# Description: 整理项目规则写入 AI_PROJECT.md 的 managed block
-# Category: workspace
-# Version: 1
-
-description = "整理项目规则写入 AI_PROJECT.md 的 managed block"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：当用户提出“项目规则/约束/边界”时，将其整理为结构化条款，并写入工作区根目录的 `AI_PROJECT.md`。
-
-约定真值：
-- `AI_PROJECT.md`：项目约束真值（本命令只维护其中的 managed block）
-- `REQUIREMENTS.md`：需求真值（本命令不改需求）
-- `AI_WORKSPACE.md`：运行/测试真值（本命令不改运行方式）
-
-安全规则（强制）：
-- 不打印 secrets；不把 token/密钥/内网地址写入 `AI_PROJECT.md`。
-- 不进行破坏性命令。
-- 写入前必须创建备份：`.aiws/backups/manual/AI_PROJECT.md.bak.<timestamp>`
-
-写入位置（强制）：
-- 仅修改 `AI_PROJECT.md` 中 `<!-- AI_PROJECT_RULES_BEGIN -->` 与 `<!-- AI_PROJECT_RULES_END -->` 之间的内容。
-- 若文件/标记不存在：先运行 `/aiws-init`（或 `aiws init .`）补齐模板，再继续。
-
-工作流：
-1) 读取（或创建）`AI_PROJECT.md`，并定位 managed block。
-2) 如果用户还没给出明确的规则文本：最多问 3 个澄清问题（例如：允许改动目录白名单/必须跑哪些测试/是否允许有副作用接口/是否允许自动提交）。
-3) 将用户输入整理为短而硬的条款（建议按以下结构）：
-   - 范围/目录白名单
-   - 必须执行的验证命令（含期望结果）
-   - 禁止项（危险操作/敏感文件/越界访问）
-   - 交付产物（必须更新哪些文件：issues/证据/文档）
-4) 更新 managed block：合并去重（同义合并）、保持条款可执行；避免重写文件其它部分。
-4.1) 写入前必须复述“将写入的规则清单”，并要求用户回复 `CONFIRM` 后再落盘（避免误写/误删）。
-5) 输出必须包含：
-   - 更新了哪些文件（路径）
-   - 回滚方式（恢复备份文件）
-   - 下一步建议（例如运行 `/ws-doctor`）
-
-提示：用户的“规则”可能零散，优先把它们变成可检查的条款（能落到命令/文件/目录）。
-"""

package/templates/workspace/.iflow/commands/ws-submodule-setup.toml

@@ -1,32 +0,0 @@
-# Command: ws:submodule-setup
-# Description: 子模块分支对齐（写入 .gitmodules 的 submodule.<name>.branch）
-# Category: workspace
-# Version: 1
-
-description = "子模块分支对齐（写入 .gitmodules 的 submodule.<name>.branch）"
-
-prompt = """
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：为每个 submodule 写入 `.gitmodules` 的 `submodule.<name>.branch`（团队真值），让 `ws:pull`、`ws:finish` 能确定性地减少 detached 与人为差异；并使 `aiws validate` 的 submodule 分支门禁通过。
-
-约束：
-- 不自动提交、不自动 push（必须先输出 diff 并让用户确认）
-- 不做破坏性命令
-
-步骤（建议）：
-1) 确认工作区干净：`git status --porcelain`（非空则停止）。
-2) 列出 submodules：
-   - `test -f .gitmodules || { echo "no .gitmodules"; exit 0; }`
-   - `git config --file .gitmodules --get-regexp '^submodule\\..*\\.path$'`
-3) 对每个 submodule 让用户选择目标分支（推荐具体分支名；可选 `.` 表示跟随 superproject 分支名）。
-4) 写入分支配置：
-   - `git submodule set-branch --branch <branch-or-dot> <sub_path>`
-5) 输出 diff 并让用户确认是否提交：
-   - `git diff -- .gitmodules`
-   - `git status --porcelain`
-6) 用户确认后提交：
-   - `git add .gitmodules`
-   - `git commit -m "chore(submodule): set tracking branches"`
-"""
-

package/templates/workspace/tools/iflow_watchdog.sh

@@ -1,138 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# iFlow unattended watchdog for AI Workspace (Arch Linux/systemd friendly).
-#
-# Goal:
-# - Run /server-drain in a loop (low output, small batches).
-# - If drain reports BLOCKED (exit 3) or crashes, run /server-fix in a fresh iFlow process (bounded).
-# - Keep outputs in .agentdocs/tmp/server-test/ to avoid blowing up interactive sessions.
-#
-# Safety:
-# - Intended for test environments only.
-# - Requires explicit IFLOW_WATCHDOG_YOLO=1 to run with --yolo.
-
-die() { echo "error: $*" >&2; exit 2; }
-need_file() { [[ -f "$1" ]] || die "missing: $1"; }
-have() { command -v "$1" >/dev/null 2>&1; }
-
-root="${IFLOW_WATCHDOG_ROOT:-.}"
-cd "$root"
-
-need_file "AI_WORKSPACE.md"
-need_file "REQUIREMENTS.md"
-need_file "tools/server_test_runner.py"
-need_file "secrets/test-accounts.json"
-
-have iflow || die "missing: iflow"
-have uv || die "missing: uv (runner requires uv)"
-
-csv="issues/server-api-issues.csv"
-workspace_dir="$(pwd)"
-log_dir="${IFLOW_WATCHDOG_LOG_DIR:-$workspace_dir/.agentdocs/tmp/server-test}"
-mkdir -p "$log_dir"
-
-fatal_log="$log_dir/watchdog-fatal.log"
-timestamp() { date +"%Y-%m-%dT%H:%M:%S%z"; }
-say() { printf "[%s] %s\n" "$(timestamp)" "$*"; }
-fatal() { say "fatal: $*" | tee -a "$fatal_log" >&2; exit 2; }
-
-yolo="${IFLOW_WATCHDOG_YOLO:-0}"
-if [[ "$yolo" != "1" ]]; then
-  fatal "unattended mode requires IFLOW_WATCHDOG_YOLO=1 (this will use iflow --yolo; test env only)"
-fi
-
-if ! iflow --version >/dev/null 2>&1; then
-  fatal "iflow command failed (check auth/config/environment)"
-fi
-
-date_suffix="$(date +%Y%m%d)"
-drain_log="${IFLOW_WATCHDOG_DRAIN_LOG:-$log_dir/iflow-drain-$date_suffix.log}"
-fix_log="${IFLOW_WATCHDOG_FIX_LOG:-$log_dir/iflow-fix-$date_suffix.log}"
-find "$log_dir" -maxdepth 1 -type f -name "iflow-*.log" -mtime +7 -delete 2>/dev/null || true
-
-lock_dir="$log_dir/.watchdog.lock"
-pid_file="$lock_dir/pid"
-if ! mkdir "$lock_dir" 2>/dev/null; then
-  other_pid="$(cat "$pid_file" 2>/dev/null || true)"
-  fatal "another watchdog is running (lock: $lock_dir pid=${other_pid:-unknown})"
-fi
-printf "%s\n" "$$" >"$pid_file" 2>/dev/null || true
-
-cleanup() {
-  say "cleanup: stopping child iflow processes (if any)" >>"$fatal_log" 2>/dev/null || true
-  pkill -P $$ iflow 2>/dev/null || true
-  rm -f "$pid_file" 2>/dev/null || true
-  rmdir "$lock_dir" 2>/dev/null || true
-}
-trap cleanup EXIT INT TERM
-
-drain_timeout="${IFLOW_WATCHDOG_DRAIN_TIMEOUT:-7200}"
-fix_timeout="${IFLOW_WATCHDOG_FIX_TIMEOUT:-3600}"
-drain_max_turns="${IFLOW_WATCHDOG_DRAIN_MAX_TURNS:-6}"
-fix_max_turns="${IFLOW_WATCHDOG_FIX_MAX_TURNS:-12}"
-drain_max_tokens="${IFLOW_WATCHDOG_DRAIN_MAX_TOKENS:-15000}"
-fix_max_tokens="${IFLOW_WATCHDOG_FIX_MAX_TOKENS:-30000}"
-
-max_cycles="${IFLOW_WATCHDOG_MAX_CYCLES:-200}"
-sleep_s="${IFLOW_WATCHDOG_SLEEP_S:-10}"
-fix_retry_max="${IFLOW_WATCHDOG_FIX_RETRY_MAX:-3}"
-fix_retry_file="$log_dir/.fix-retry-count"
-
-drain_max_endpoints="${IFLOW_DRAIN_MAX_ENDPOINTS:-30}"
-drain_sleep_s="${IFLOW_DRAIN_SLEEP_S:-0}"
-
-csv_has_blocked() { [[ -f "$csv" ]] && grep -qE ",BLOCKED," "$csv"; }
-
-run_drain() {
-  say "run: /server-drain (max_endpoints=$drain_max_endpoints)"
-  IFLOW_DRAIN_MAX_ENDPOINTS="$drain_max_endpoints" \
-  IFLOW_DRAIN_SLEEP_S="$drain_sleep_s" \
-  iflow --yolo -p "/server-drain" --timeout "$drain_timeout" --max-turns "$drain_max_turns" --max-tokens "$drain_max_tokens" >>"$drain_log" 2>&1
-}
-
-run_fix() {
-  say "run: /server-fix"
-  retry_count="$(cat "$fix_retry_file" 2>/dev/null || echo 0)"
-  if [[ "$retry_count" -ge "$fix_retry_max" ]]; then
-    fatal "fix reached retry limit ($fix_retry_max); check $fix_log"
-  fi
-  if iflow --yolo -p "/server-fix" --timeout "$fix_timeout" --max-turns "$fix_max_turns" --max-tokens "$fix_max_tokens" >>"$fix_log" 2>&1; then
-    rm -f "$fix_retry_file" 2>/dev/null || true
-  else
-    echo $((retry_count + 1)) >"$fix_retry_file" 2>/dev/null || true
-  fi
-}
-
-say "watchdog: start (cycles=$max_cycles sleep_s=$sleep_s)"
-say "logs: drain=$drain_log fix=$fix_log"
-
-cycle=1
-while [[ "$cycle" -le "$max_cycles" ]]; do
-  if csv_has_blocked; then
-    say "state: BLOCKED detected in $csv (trigger fix)"
-    run_fix
-  fi
-
-set +e
-run_drain
-rc=$?
-set -e
-
-if [[ "$rc" == "0" ]]; then
-  say "done: drain finished with all DONE/SKIP"
-  exit 0
-fi
-
-if [[ "$rc" == "3" ]] || csv_has_blocked; then
-  say "blocked: drain reported BLOCKED (rc=$rc), trigger fix"
-  run_fix
-else
-  say "warn: drain exited rc=$rc without BLOCKED; will retry"
-fi
-
-sleep "$sleep_s" || true
-cycle=$((cycle + 1))
-done
-
-fatal "reached max cycles ($max_cycles); check logs under $log_dir"

package/templates/workspace/tools/install_iflow_watchdog_systemd_user.sh

@@ -1,118 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-die() { echo "error: $*" >&2; exit 2; }
-have() { command -v "$1" >/dev/null 2>&1; }
-
-usage() {
-  cat <<'EOF'
-Usage:
-  bash tools/install_iflow_watchdog_systemd_user.sh
-  bash tools/install_iflow_watchdog_systemd_user.sh --name <instance>
-  bash tools/install_iflow_watchdog_systemd_user.sh --workspace <abs_path>
-  bash tools/install_iflow_watchdog_systemd_user.sh --name <instance> --workspace <abs_path>
-
-What it does:
-  - Installs systemd user instance units:
-      ~/.config/systemd/user/iflow-watchdog@.service
-      ~/.config/systemd/user/iflow-watchdog@.timer
-  - Writes per-instance env file:
-      ~/.config/iflow-watchdog/<instance>.env
-  - Enables and starts the timer:
-      systemctl --user enable --now iflow-watchdog@<instance>.timer
-
-Notes:
-  - You can run multiple instances on one server (different --name and --workspace).
-  - Unattended mode uses --yolo; only use in test environment.
-Defaults:
-  - --workspace defaults to current directory (pwd)
-  - --name defaults to basename(--workspace)
-EOF
-}
-
-name=""
-workspace=""
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --name) name="${2:-}"; shift 2 ;;
-    --workspace) workspace="${2:-}"; shift 2 ;;
-    -h|--help) usage; exit 0 ;;
-    *) die "unknown arg: $1" ;;
-  esac
-done
-
-if [[ -z "$workspace" ]]; then
-  workspace="$(pwd)"
-fi
-
-if [[ -z "$name" ]]; then
-  name="$(basename "$workspace")"
-fi
-
-[[ "$workspace" == /* ]] || die "--workspace must be an absolute path"
-[[ -d "$workspace" ]] || die "workspace not found: $workspace"
-
-have systemctl || die "missing: systemctl"
-
-if [[ ! -f "$workspace/AI_WORKSPACE.md" ]] || [[ ! -f "$workspace/REQUIREMENTS.md" ]]; then
-  die "workspace must contain AI_WORKSPACE.md and REQUIREMENTS.md: $workspace"
-fi
-
-# Best-effort check that systemd --user is available (common pitfall on servers).
-if [[ -z "${XDG_RUNTIME_DIR:-}" ]] || ! systemctl --user is-system-running >/dev/null 2>&1; then
-  die "systemd --user not running (try: loginctl enable-linger $USER, then re-login)"
-fi
-
-unit_dir="$HOME/.config/systemd/user"
-env_dir="$HOME/.config/iflow-watchdog"
-mkdir -p "$unit_dir" "$env_dir"
-
-src_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-tpl_service="$src_dir/systemd/iflow-watchdog@.service"
-tpl_timer="$src_dir/systemd/iflow-watchdog@.timer"
-[[ -f "$tpl_service" ]] || die "missing template: $tpl_service"
-[[ -f "$tpl_timer" ]] || die "missing template: $tpl_timer"
-
-cp -a "$tpl_service" "$unit_dir/iflow-watchdog@.service"
-cp -a "$tpl_timer" "$unit_dir/iflow-watchdog@.timer"
-
-env_file="$env_dir/${name}.env"
-
-# Only allow unattended --yolo if AI_WORKSPACE.md declares test environment.
-yo="0"
-if grep -Eq '^\s*-\s*environment\s*:\s*"?test"?\s*$' "$workspace/AI_WORKSPACE.md"; then
-  yo="1"
-fi
-
-cat >"$env_file" <<EOF
-# Generated by tools/install_iflow_watchdog_systemd_user.sh
-WORKSPACE_DIR=${workspace}
-IFLOW_WATCHDOG_ROOT=.
-# Unattended mode (uses iflow --yolo). Only safe when environment=test.
-IFLOW_WATCHDOG_YOLO=${yo}
-# Optional: override logs dir (default: <workspace>/.agentdocs/tmp/server-test)
-# IFLOW_WATCHDOG_LOG_DIR=${workspace}/.agentdocs/tmp/server-test
-IFLOW_DRAIN_MAX_ENDPOINTS=30
-IFLOW_WATCHDOG_SLEEP_S=10
-EOF
-
-systemctl --user daemon-reload
-
-if [[ "$yo" == "1" ]]; then
-  systemctl --user enable --now "iflow-watchdog@${name}.timer"
-  enabled_msg="enabled"
-else
-  enabled_msg="not enabled (edit IFLOW_WATCHDOG_YOLO=1 after confirming test env)"
-fi
-
-echo "OK: installed iflow-watchdog@${name}"
-echo "env:  $env_file"
-echo "unit: $unit_dir/iflow-watchdog@.service"
-echo "timer: iflow-watchdog@${name}.timer ($enabled_msg)"
-echo "tune: edit $env_file, then run:"
-echo "  systemctl --user daemon-reload"
-echo "  systemctl --user restart iflow-watchdog@${name}.service"
-if [[ "$yo" != "1" ]]; then
-  echo "enable:"
-  echo "  systemctl --user enable --now iflow-watchdog@${name}.timer"
-fi

package/templates/workspace/tools/systemd/iflow-watchdog@.service

@@ -1,16 +0,0 @@
-[Unit]
-Description=iFlow AI Workspace API Test Watchdog (%i)
-After=network.target
-
-[Service]
-Type=simple
-# Per-instance environment file created by tools/install_iflow_watchdog_systemd_user.sh
-EnvironmentFile=%h/.config/iflow-watchdog/%i.env
-ExecStart=/usr/bin/env bash -lc 'cd "${WORKSPACE_DIR}" && bash tools/iflow_watchdog.sh'
-Restart=always
-RestartSec=30
-KillMode=mixed
-TimeoutStopSec=30
-
-[Install]
-WantedBy=default.target

package/templates/workspace/tools/systemd/iflow-watchdog@.timer

@@ -1,11 +0,0 @@
-[Unit]
-Description=Nightly iFlow API Test Watchdog (%i)
-
-[Timer]
-OnCalendar=*-*-* 02:00:00
-Persistent=true
-Unit=iflow-watchdog@%i.service
-
-[Install]
-WantedBy=timers.target
-