diff --git a/skills/auto-tmux/AGENTS.md b/skills/auto-tmux/AGENTS.md index 7f8a9a7..09138a5 100644 --- a/skills/auto-tmux/AGENTS.md +++ b/skills/auto-tmux/AGENTS.md @@ -22,6 +22,7 @@ skills/auto-tmux/ │ ├── swarm-export.sh │ ├── swarm-timeline.sh │ ├── swarm-blockers.sh +│ ├── swarm-report-pack.sh │ ├── swarm-assign.sh │ ├── swarm-health.sh │ ├── record-summary.sh @@ -59,6 +60,7 @@ skills/auto-tmux/ - `scripts/swarm-export.sh` 是机器可读导出层,将任务、依赖和锁导出为 JSONL。 - `scripts/swarm-timeline.sh` 是状态时间线层,将 `status.log` 渲染为 Markdown。 - `scripts/swarm-blockers.sh` 是阻塞报告层,聚合 BLOCKED/FAIL、锁和异常状态。 +- `scripts/swarm-report-pack.sh` 是报告包层,聚合多个只读报告与 JSONL 导出。 - `scripts/swarm-assign.sh` 是分配建议层,将 ready task 轮询映射到 worker pane。 - `scripts/swarm-health.sh` 是健康检查层,汇总 tmux 和 swarm state 的只读报告包。 - `scripts/record-summary.sh` 是复盘摘要层,将 pane 录制日志整理为 Markdown。 @@ -75,4 +77,4 @@ skills/auto-tmux/ - 上游来源:`tools/external/.tmux` 与 `tools/external/tmux`。 - 下游使用:`SKILL.md` 和 `references/` 中的命令示例。 - 验证入口:`skills/auto-skill/scripts/validate-skill.sh skills/auto-tmux --strict`。 -- 脚本验证:`skills/auto-tmux/scripts/validate-auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/swarm-state.sh`、`bash -n skills/auto-tmux/scripts/swarm-brief.sh`、`bash -n skills/auto-tmux/scripts/swarm-watch.sh`、`bash -n skills/auto-tmux/scripts/swarm-archive.sh`、`bash -n skills/auto-tmux/scripts/swarm-board.sh`、`bash -n skills/auto-tmux/scripts/swarm-deps-graph.sh`、`bash -n skills/auto-tmux/scripts/swarm-export.sh`、`bash -n skills/auto-tmux/scripts/swarm-timeline.sh`、`bash -n skills/auto-tmux/scripts/swarm-blockers.sh`、`bash -n skills/auto-tmux/scripts/swarm-assign.sh`、`bash -n skills/auto-tmux/scripts/swarm-health.sh`、`bash -n skills/auto-tmux/scripts/record-summary.sh`、`bash -n skills/auto-tmux/scripts/completion.bash`、`bash -n skills/auto-tmux/scripts/safety-check.sh`、`bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh`、`bash -n skills/auto-tmux/scripts/swarm-dispatch.sh`、`skills/auto-tmux/scripts/auto-tmux-smoke-test.sh`。 +- 脚本验证:`skills/auto-tmux/scripts/validate-auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/swarm-state.sh`、`bash -n skills/auto-tmux/scripts/swarm-brief.sh`、`bash -n skills/auto-tmux/scripts/swarm-watch.sh`、`bash -n skills/auto-tmux/scripts/swarm-archive.sh`、`bash -n skills/auto-tmux/scripts/swarm-board.sh`、`bash -n skills/auto-tmux/scripts/swarm-deps-graph.sh`、`bash -n skills/auto-tmux/scripts/swarm-export.sh`、`bash -n skills/auto-tmux/scripts/swarm-timeline.sh`、`bash -n skills/auto-tmux/scripts/swarm-blockers.sh`、`bash -n skills/auto-tmux/scripts/swarm-report-pack.sh`、`bash -n skills/auto-tmux/scripts/swarm-assign.sh`、`bash -n skills/auto-tmux/scripts/swarm-health.sh`、`bash -n skills/auto-tmux/scripts/record-summary.sh`、`bash -n skills/auto-tmux/scripts/completion.bash`、`bash -n skills/auto-tmux/scripts/safety-check.sh`、`bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh`、`bash -n skills/auto-tmux/scripts/swarm-dispatch.sh`、`skills/auto-tmux/scripts/auto-tmux-smoke-test.sh`。 diff --git a/skills/auto-tmux/README.md b/skills/auto-tmux/README.md index 80f877b..da9ac86 100644 --- a/skills/auto-tmux/README.md +++ b/skills/auto-tmux/README.md @@ -29,6 +29,7 @@ bash -n skills/auto-tmux/scripts/swarm-deps-graph.sh bash -n skills/auto-tmux/scripts/swarm-export.sh bash -n skills/auto-tmux/scripts/swarm-timeline.sh bash -n skills/auto-tmux/scripts/swarm-blockers.sh +bash -n skills/auto-tmux/scripts/swarm-report-pack.sh bash -n skills/auto-tmux/scripts/swarm-assign.sh bash -n skills/auto-tmux/scripts/swarm-health.sh bash -n skills/auto-tmux/scripts/record-summary.sh diff --git a/skills/auto-tmux/SKILL.md b/skills/auto-tmux/SKILL.md index fb4635e..af4739e 100644 --- a/skills/auto-tmux/SKILL.md +++ b/skills/auto-tmux/SKILL.md @@ -43,6 +43,7 @@ bash -n skills/auto-tmux/scripts/swarm-deps-graph.sh bash -n skills/auto-tmux/scripts/swarm-export.sh bash -n skills/auto-tmux/scripts/swarm-timeline.sh bash -n skills/auto-tmux/scripts/swarm-blockers.sh +bash -n skills/auto-tmux/scripts/swarm-report-pack.sh bash -n skills/auto-tmux/scripts/swarm-assign.sh bash -n skills/auto-tmux/scripts/swarm-health.sh bash -n skills/auto-tmux/scripts/record-summary.sh @@ -131,6 +132,7 @@ skills/auto-tmux/scripts/swarm-deps-graph.sh --dir /tmp/ai_swarm --out /tmp/ai-s skills/auto-tmux/scripts/swarm-export.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-export skills/auto-tmux/scripts/swarm-timeline.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-timeline.md skills/auto-tmux/scripts/swarm-blockers.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-blockers.md +skills/auto-tmux/scripts/swarm-report-pack.sh --dir /tmp/ai_swarm --session ai-hub --out /tmp/ai-swarm-report-pack skills/auto-tmux/scripts/swarm-assign.sh --swarm-dir /tmp/ai_swarm --session ai-hub --out /tmp/ai-swarm-assign.md skills/auto-tmux/scripts/swarm-health.sh --session ai-hub --swarm-dir /tmp/ai_swarm --out /tmp/auto-tmux-health ``` @@ -282,6 +284,7 @@ skills/auto-tmux/scripts/swarm-dispatch.sh --role worker --target ::/dev/null || true - rm -rf "$SWARM_DIR" "$DEP_SWARM_DIR" "$SNAPSHOT_DIR" "$RECORD_DIR" "$RECORD_SUMMARY_FILE" "$BRIEF_DIR" "$WATCH_DIR" "$ARCHIVE_FILE" "$BOARD_FILE" "$DEPS_GRAPH_FILE" "$EXPORT_DIR" "$TIMELINE_FILE" "$BLOCKERS_FILE" "$ASSIGN_FILE" "$HEALTH_DIR" "$DISPATCH_PROMPT" "$TASK_IMPORT_FILE" "$PASTE_FILE" + rm -rf "$SWARM_DIR" "$DEP_SWARM_DIR" "$SNAPSHOT_DIR" "$RECORD_DIR" "$RECORD_SUMMARY_FILE" "$BRIEF_DIR" "$WATCH_DIR" "$ARCHIVE_FILE" "$BOARD_FILE" "$DEPS_GRAPH_FILE" "$EXPORT_DIR" "$TIMELINE_FILE" "$BLOCKERS_FILE" "$REPORT_PACK_DIR" "$ASSIGN_FILE" "$HEALTH_DIR" "$DISPATCH_PROMPT" "$TASK_IMPORT_FILE" "$PASTE_FILE" } trap cleanup EXIT @@ -62,6 +64,7 @@ bash -n "$SWARM_DEPS_GRAPH" bash -n "$SWARM_EXPORT" bash -n "$SWARM_TIMELINE" bash -n "$SWARM_BLOCKERS" +bash -n "$SWARM_REPORT_PACK" bash -n "$SWARM_ASSIGN" bash -n "$SWARM_HEALTH" bash -n "$RECORD_SUMMARY" @@ -173,6 +176,10 @@ grep -q 'DONE' "$TIMELINE_FILE" "$SWARM_BLOCKERS" --dir "$SWARM_DIR" --out "$BLOCKERS_FILE" -n 50 >/tmp/auto-tmux-smoke-blockers.txt grep -q 'auto-tmux Swarm Blockers' "$BLOCKERS_FILE" grep -q 'smoke-fail' "$BLOCKERS_FILE" +"$SWARM_REPORT_PACK" --dir "$SWARM_DIR" --session "$SESSION" --out "$REPORT_PACK_DIR" >/tmp/auto-tmux-smoke-report-pack.txt +grep -q 'auto-tmux Swarm Report Pack' "$REPORT_PACK_DIR/index.md" +test -s "$REPORT_PACK_DIR/board.md" +test -s "$REPORT_PACK_DIR/export/tasks.jsonl" "$SWARM_ASSIGN" --swarm-dir "$SWARM_DIR" --session "$SESSION" --out "$ASSIGN_FILE" --limit 20 >/tmp/auto-tmux-smoke-assign.txt grep -q 'auto-tmux Swarm Assignment Suggestions' "$ASSIGN_FILE" grep -q 'swarm-dispatch.sh' "$ASSIGN_FILE" diff --git a/skills/auto-tmux/scripts/auto-tmux.sh b/skills/auto-tmux/scripts/auto-tmux.sh index ca13db9..e8024b0 100755 --- a/skills/auto-tmux/scripts/auto-tmux.sh +++ b/skills/auto-tmux/scripts/auto-tmux.sh @@ -153,7 +153,7 @@ cmd_doctor() { status_line "WARN" "tmux server has no reachable session yet" fi - for script in auto-tmux.sh swarm-state.sh swarm-brief.sh swarm-watch.sh swarm-archive.sh swarm-board.sh swarm-deps-graph.sh swarm-export.sh swarm-timeline.sh swarm-blockers.sh swarm-assign.sh swarm-health.sh record-summary.sh safety-check.sh render-swarm-prompt.sh swarm-dispatch.sh auto-tmux-smoke-test.sh validate-auto-tmux.sh; do + for script in auto-tmux.sh swarm-state.sh swarm-brief.sh swarm-watch.sh swarm-archive.sh swarm-board.sh swarm-deps-graph.sh swarm-export.sh swarm-timeline.sh swarm-blockers.sh swarm-report-pack.sh swarm-assign.sh swarm-health.sh record-summary.sh safety-check.sh render-swarm-prompt.sh swarm-dispatch.sh auto-tmux-smoke-test.sh validate-auto-tmux.sh; do if [[ -x "$script_dir/$script" ]]; then status_line "OK" "script executable: $script" else diff --git a/skills/auto-tmux/scripts/swarm-report-pack.sh b/skills/auto-tmux/scripts/swarm-report-pack.sh new file mode 100755 index 0000000..1523e53 --- /dev/null +++ b/skills/auto-tmux/scripts/swarm-report-pack.sh @@ -0,0 +1,97 @@ +#!/usr/bin/env bash +# swarm-report-pack: build a portable read-only report pack for swarm state. +set -euo pipefail + +usage() { + cat <<'EOF' +swarm-report-pack: build an auto-tmux swarm report pack + +Usage: + swarm-report-pack.sh [--dir DIR] [--session NAME] [--out DIR] + +Defaults: + --dir AUTO_TMUX_SWARM_DIR or /tmp/ai_swarm + --out /tmp/auto-tmux-report-pack-YYYYmmdd-HHMMSS + +This script is read-only for tmux and swarm state. It writes only to --out. +EOF +} + +die() { + printf 'error: %s\n' "$*" >&2 + exit 1 +} + +script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +swarm_dir="${AUTO_TMUX_SWARM_DIR:-/tmp/ai_swarm}" +session="" +out_dir="/tmp/auto-tmux-report-pack-$(date +%Y%m%d-%H%M%S)" + +while [[ $# -gt 0 ]]; do + case "$1" in + --dir|--swarm-dir) + swarm_dir="${2:-}" + shift 2 + ;; + --session) + session="${2:-}" + shift 2 + ;; + --out) + out_dir="${2:-}" + shift 2 + ;; + -h|--help) + usage + exit 0 + ;; + *) + die "unknown option: $1" + ;; + esac +done + +mkdir -p "$out_dir/export" + +run_report() { + local label="$1" + shift + if "$@" >/tmp/auto-tmux-report-pack.log 2>&1; then + printf '[OK] %s\n' "$label" + else + printf '[WARN] %s failed\n' "$label" >&2 + sed -n '1,80p' /tmp/auto-tmux-report-pack.log >&2 + fi +} + +run_report "board" "$script_dir/swarm-board.sh" --dir "$swarm_dir" --out "$out_dir/board.md" +run_report "dependency graph" "$script_dir/swarm-deps-graph.sh" --dir "$swarm_dir" --out "$out_dir/deps.md" +run_report "timeline" "$script_dir/swarm-timeline.sh" --dir "$swarm_dir" --out "$out_dir/timeline.md" +run_report "blockers" "$script_dir/swarm-blockers.sh" --dir "$swarm_dir" --out "$out_dir/blockers.md" +run_report "export" "$script_dir/swarm-export.sh" --dir "$swarm_dir" --out "$out_dir/export" + +if [[ -n "$session" ]]; then + run_report "assign" "$script_dir/swarm-assign.sh" --swarm-dir "$swarm_dir" --session "$session" --out "$out_dir/assign.md" +else + run_report "assign" "$script_dir/swarm-assign.sh" --swarm-dir "$swarm_dir" --out "$out_dir/assign.md" +fi + +cat > "$out_dir/index.md" <}\` + +## Files + +- [board.md](./board.md) +- [deps.md](./deps.md) +- [timeline.md](./timeline.md) +- [blockers.md](./blockers.md) +- [assign.md](./assign.md) +- [export/manifest.json](./export/manifest.json) +EOF + +rm -f /tmp/auto-tmux-report-pack.log +printf 'swarm report pack written: %s\n' "$out_dir" diff --git a/skills/auto-tmux/scripts/validate-auto-tmux.sh b/skills/auto-tmux/scripts/validate-auto-tmux.sh index 94319ee..dbf9911 100755 --- a/skills/auto-tmux/scripts/validate-auto-tmux.sh +++ b/skills/auto-tmux/scripts/validate-auto-tmux.sh @@ -87,6 +87,7 @@ scripts=( "$script_dir/swarm-export.sh" "$script_dir/swarm-timeline.sh" "$script_dir/swarm-blockers.sh" + "$script_dir/swarm-report-pack.sh" "$script_dir/swarm-assign.sh" "$script_dir/swarm-health.sh" "$script_dir/record-summary.sh" @@ -114,6 +115,7 @@ run_gate "swarm-deps-graph help" "$script_dir/swarm-deps-graph.sh" --help run_gate "swarm-export help" "$script_dir/swarm-export.sh" --help run_gate "swarm-timeline help" "$script_dir/swarm-timeline.sh" --help run_gate "swarm-blockers help" "$script_dir/swarm-blockers.sh" --help +run_gate "swarm-report-pack help" "$script_dir/swarm-report-pack.sh" --help run_gate "swarm-assign help" "$script_dir/swarm-assign.sh" --help run_gate "swarm-health help" "$script_dir/swarm-health.sh" --help run_gate "record-summary help" "$script_dir/record-summary.sh" --help @@ -136,6 +138,7 @@ require_contains "$skill_dir/SKILL.md" "scripts/swarm-deps-graph.sh" require_contains "$skill_dir/SKILL.md" "scripts/swarm-export.sh" require_contains "$skill_dir/SKILL.md" "scripts/swarm-timeline.sh" require_contains "$skill_dir/SKILL.md" "scripts/swarm-blockers.sh" +require_contains "$skill_dir/SKILL.md" "scripts/swarm-report-pack.sh" require_contains "$skill_dir/SKILL.md" "scripts/swarm-assign.sh" require_contains "$skill_dir/SKILL.md" "scripts/swarm-health.sh" require_contains "$skill_dir/SKILL.md" "scripts/record-summary.sh" @@ -155,6 +158,7 @@ require_contains "$script_dir/README.md" "swarm-deps-graph.sh" require_contains "$script_dir/README.md" "swarm-export.sh" require_contains "$script_dir/README.md" "swarm-timeline.sh" require_contains "$script_dir/README.md" "swarm-blockers.sh" +require_contains "$script_dir/README.md" "swarm-report-pack.sh" require_contains "$script_dir/README.md" "swarm-assign.sh" require_contains "$script_dir/README.md" "swarm-health.sh" require_contains "$script_dir/README.md" "record-summary.sh" @@ -169,6 +173,7 @@ require_contains "$script_dir/AGENTS.md" "swarm-deps-graph.sh" require_contains "$script_dir/AGENTS.md" "swarm-export.sh" require_contains "$script_dir/AGENTS.md" "swarm-timeline.sh" require_contains "$script_dir/AGENTS.md" "swarm-blockers.sh" +require_contains "$script_dir/AGENTS.md" "swarm-report-pack.sh" require_contains "$script_dir/AGENTS.md" "swarm-assign.sh" require_contains "$script_dir/AGENTS.md" "swarm-health.sh" require_contains "$script_dir/AGENTS.md" "record-summary.sh"