tmux-agent 0.1.0

package/.codex/skills/speckit/scripts/bash/setup-notes.sh

@@ -0,0 +1,182 @@
+#!/usr/bin/env bash
+
+set -e
+
+JSON_MODE=false
+FORCE_OVERWRITE=false
+DRY_RUN=false
+FEATURE_OVERRIDE=""
+POSITIONAL=()
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --json)
+            JSON_MODE=true
+            shift
+            ;;
+        --force)
+            FORCE_OVERWRITE=true
+            shift
+            ;;
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        --feature)
+            if [[ $# -lt 2 || "$2" == --* ]]; then
+                echo "Error: --feature requires a value" >&2
+                exit 1
+            fi
+            FEATURE_OVERRIDE="$2"
+            shift 2
+            ;;
+        --feature=*)
+            FEATURE_OVERRIDE="${1#--feature=}"
+            shift
+            ;;
+        --help|-h)
+            cat << 'EOF'
+Usage: setup-notes.sh [--json] [--dry-run] [--force] [--feature <NNN|NNN-name>] [NNN|NNN-name]
+
+Ensure `specs/<feature>/notes/` exists with minimal skeleton files (no overwrite by default).
+
+OPTIONS:
+  --json        Output results in JSON format
+  --dry-run     Preview what would be created/overwritten without writing
+  --force       Overwrite existing notes files from templates
+  --feature     Target a specific spec (e.g., 025 or 025-my-feature)
+  --help        Show this help message
+EOF
+            exit 0
+            ;;
+        --*)
+            echo "Error: Unknown option '$1' (use --help for usage information)" >&2
+            exit 1
+            ;;
+        *)
+            POSITIONAL+=("$1")
+            shift
+            ;;
+    esac
+done
+
+if [[ -n "$FEATURE_OVERRIDE" ]]; then
+    SPECIFY_FEATURE="$FEATURE_OVERRIDE"
+fi
+
+if [[ ${#POSITIONAL[@]} -gt 0 ]]; then
+    if [[ -z "$FEATURE_OVERRIDE" && ${#POSITIONAL[@]} -eq 1 && "${POSITIONAL[0]}" =~ ^[0-9]{3}(-.+)?$ ]]; then
+        SPECIFY_FEATURE="${POSITIONAL[0]}"
+    else
+        echo "Error: Unknown argument(s): ${POSITIONAL[*]} (use --help for usage information)" >&2
+        exit 1
+    fi
+fi
+
+SCRIPT_DIR="$(CDPATH="" cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SKILL_DIR="$(CDPATH="" cd "$SCRIPT_DIR/../.." && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+eval $(get_feature_paths)
+check_feature_branch "$CURRENT_BRANCH" || exit 1
+
+if [[ ! -d "$FEATURE_DIR" ]]; then
+    echo "ERROR: Feature directory not found: $FEATURE_DIR" >&2
+    echo 'Run $speckit specify first to create the feature structure.' >&2
+    exit 1
+fi
+
+NOTES_DIR="$FEATURE_DIR/notes"
+SESSIONS_DIR="$NOTES_DIR/sessions"
+NOTES_README="$NOTES_DIR/README.md"
+NOTES_ENTRYPOINTS="$NOTES_DIR/entrypoints.md"
+NOTES_QUESTIONS="$NOTES_DIR/questions.md"
+
+TEMPLATE_README="$SKILL_DIR/assets/templates/notes-readme-template.md"
+TEMPLATE_ENTRYPOINTS="$SKILL_DIR/assets/templates/notes-entrypoints-template.md"
+TEMPLATE_QUESTIONS="$SKILL_DIR/assets/templates/notes-questions-template.md"
+
+declare -a would_create=()
+declare -a would_overwrite=()
+
+if [[ ! -d "$NOTES_DIR" ]]; then
+    would_create+=("notes/")
+fi
+if [[ ! -d "$SESSIONS_DIR" ]]; then
+    would_create+=("notes/sessions/")
+fi
+
+if [[ ! -f "$NOTES_README" || ! -s "$NOTES_README" ]]; then
+    would_create+=("notes/README.md")
+elif $FORCE_OVERWRITE; then
+    would_overwrite+=("notes/README.md")
+fi
+
+if [[ ! -f "$NOTES_ENTRYPOINTS" || ! -s "$NOTES_ENTRYPOINTS" ]]; then
+    would_create+=("notes/entrypoints.md")
+elif $FORCE_OVERWRITE; then
+    would_overwrite+=("notes/entrypoints.md")
+fi
+
+if [[ ! -f "$NOTES_QUESTIONS" || ! -s "$NOTES_QUESTIONS" ]]; then
+    would_create+=("notes/questions.md")
+elif $FORCE_OVERWRITE; then
+    would_overwrite+=("notes/questions.md")
+fi
+
+if ! $DRY_RUN; then
+    mkdir -p "$SESSIONS_DIR"
+
+    if $FORCE_OVERWRITE || [[ ! -s "$NOTES_README" ]]; then
+        if [[ -f "$TEMPLATE_README" ]]; then
+            cp "$TEMPLATE_README" "$NOTES_README"
+        else
+            [[ -f "$NOTES_README" ]] || touch "$NOTES_README"
+        fi
+    fi
+
+    if $FORCE_OVERWRITE || [[ ! -s "$NOTES_ENTRYPOINTS" ]]; then
+        if [[ -f "$TEMPLATE_ENTRYPOINTS" ]]; then
+            cp "$TEMPLATE_ENTRYPOINTS" "$NOTES_ENTRYPOINTS"
+        else
+            [[ -f "$NOTES_ENTRYPOINTS" ]] || touch "$NOTES_ENTRYPOINTS"
+        fi
+    fi
+
+    if $FORCE_OVERWRITE || [[ ! -s "$NOTES_QUESTIONS" ]]; then
+        if [[ -f "$TEMPLATE_QUESTIONS" ]]; then
+            cp "$TEMPLATE_QUESTIONS" "$NOTES_QUESTIONS"
+        else
+            [[ -f "$NOTES_QUESTIONS" ]] || touch "$NOTES_QUESTIONS"
+        fi
+    fi
+fi
+
+if $JSON_MODE; then
+    if [[ ${#would_create[@]} -eq 0 ]]; then
+        json_create="[]"
+    else
+        json_create=$(printf '"%s",' "${would_create[@]}")
+        json_create="[${json_create%,}]"
+    fi
+
+    if [[ ${#would_overwrite[@]} -eq 0 ]]; then
+        json_overwrite="[]"
+    else
+        json_overwrite=$(printf '"%s",' "${would_overwrite[@]}")
+        json_overwrite="[${json_overwrite%,}]"
+    fi
+
+    printf '{"FEATURE_DIR":"%s","NOTES_DIR":"%s","NOTES_README":"%s","NOTES_ENTRYPOINTS":"%s","NOTES_QUESTIONS":"%s","SESSIONS_DIR":"%s","WOULD_CREATE":%s,"WOULD_OVERWRITE":%s,"DRY_RUN":%s}\n' \
+        "$FEATURE_DIR" "$NOTES_DIR" "$NOTES_README" "$NOTES_ENTRYPOINTS" "$NOTES_QUESTIONS" "$SESSIONS_DIR" \
+        "$json_create" "$json_overwrite" "$DRY_RUN"
+else
+    echo "FEATURE_DIR: $FEATURE_DIR"
+    echo "NOTES_DIR: $NOTES_DIR"
+    echo "NOTES_README: $NOTES_README"
+    echo "NOTES_ENTRYPOINTS: $NOTES_ENTRYPOINTS"
+    echo "NOTES_QUESTIONS: $NOTES_QUESTIONS"
+    echo "SESSIONS_DIR: $SESSIONS_DIR"
+    echo "DRY_RUN: $DRY_RUN"
+fi
+

package/.codex/skills/speckit/scripts/bash/setup-plan.sh

@@ -0,0 +1,110 @@
+#!/usr/bin/env bash
+
+set -e
+
+JSON_MODE=false
+FORCE_OVERWRITE=false
+FEATURE_OVERRIDE=""
+POSITIONAL=()
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --json)
+            JSON_MODE=true
+            shift
+            ;;
+        --force)
+            FORCE_OVERWRITE=true
+            shift
+            ;;
+        --feature)
+            if [[ $# -lt 2 || "$2" == --* ]]; then
+                echo "Error: --feature requires a value" >&2
+                exit 1
+            fi
+            FEATURE_OVERRIDE="$2"
+            shift 2
+            ;;
+        --feature=*)
+            FEATURE_OVERRIDE="${1#--feature=}"
+            shift
+            ;;
+        --help|-h)
+            echo "Usage: $0 [--json] [--force] [--feature <NNN|NNN-name>] [NNN|NNN-name]"
+            echo "  --json        Output results in JSON format"
+            echo "  --force       Overwrite existing plan.md from template"
+            echo "  --feature     Target a specific spec (e.g., 025 or 025-my-feature)"
+            echo "  --help        Show this help message"
+            exit 0
+            ;;
+        --*)
+            echo "Error: Unknown option '$1' (use --help for usage information)" >&2
+            exit 1
+            ;;
+        *)
+            POSITIONAL+=("$1")
+            shift
+            ;;
+    esac
+done
+
+if [[ -n "$FEATURE_OVERRIDE" ]]; then
+    SPECIFY_FEATURE="$FEATURE_OVERRIDE"
+fi
+
+if [[ ${#POSITIONAL[@]} -gt 0 ]]; then
+    if [[ -z "$FEATURE_OVERRIDE" && ${#POSITIONAL[@]} -eq 1 && "${POSITIONAL[0]}" =~ ^[0-9]{3}(-.+)?$ ]]; then
+        SPECIFY_FEATURE="${POSITIONAL[0]}"
+    else
+        echo "Error: Unknown argument(s): ${POSITIONAL[*]} (use --help for usage information)" >&2
+        exit 1
+    fi
+fi
+
+# Get script directory and load common functions
+SCRIPT_DIR="$(CDPATH="" cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SKILL_DIR="$(CDPATH="" cd "$SCRIPT_DIR/../.." && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# Get all paths and variables from common functions
+eval $(get_feature_paths)
+
+# Check if we have a valid feature id
+check_feature_branch "$CURRENT_BRANCH" || exit 1
+
+# Ensure the feature directory exists
+mkdir -p "$FEATURE_DIR"
+
+# Copy plan template if it exists (but do not overwrite by default)
+TEMPLATE="$SKILL_DIR/assets/templates/plan-template.md"
+if [[ -f "$TEMPLATE" ]]; then
+    if $FORCE_OVERWRITE || [[ ! -s "$IMPL_PLAN" ]]; then
+        cp "$TEMPLATE" "$IMPL_PLAN"
+        if ! $JSON_MODE; then
+            echo "Copied plan template to $IMPL_PLAN"
+        fi
+    else
+        if ! $JSON_MODE; then
+            echo "Plan already exists at $IMPL_PLAN (use --force to overwrite)"
+        fi
+    fi
+else
+    if ! $JSON_MODE; then
+        echo "Warning: Plan template not found at $TEMPLATE"
+    fi
+    # Create a basic plan file if template doesn't exist
+    if [[ ! -f "$IMPL_PLAN" ]]; then
+        touch "$IMPL_PLAN"
+    fi
+fi
+
+# Output results
+if $JSON_MODE; then
+    printf '{"FEATURE_SPEC":"%s","IMPL_PLAN":"%s","SPECS_DIR":"%s","BRANCH":"%s"}\n' \
+        "$FEATURE_SPEC" "$IMPL_PLAN" "$FEATURE_DIR" "$CURRENT_BRANCH"
+else
+    echo "FEATURE_SPEC: $FEATURE_SPEC"
+    echo "IMPL_PLAN: $IMPL_PLAN" 
+    echo "SPECS_DIR: $FEATURE_DIR"
+    echo "BRANCH: $CURRENT_BRANCH"
+fi

package/.codex/skills/speckit/scripts/bash/show-todo-tasks.sh

@@ -0,0 +1,257 @@
+#!/usr/bin/env bash
+
+# Show pending (unchecked) tasks across specs, or for specific specs.
+#
+# Default (no feature args): summarize all specs that still have TODO tasks.
+# With feature args: show all TODO tasks under the specified spec(s).
+#
+# This script is read-only and uses extract-tasks.sh for the detailed view.
+#
+# Usage:
+#   ./show-todo-tasks.sh [--json] [--feature <id>]... [<id>...]
+#
+# Examples:
+#   ./show-todo-tasks.sh
+#   ./show-todo-tasks.sh 024
+#   ./show-todo-tasks.sh --feature 024 --feature 025
+#   ./show-todo-tasks.sh --json --feature 024
+#
+# Notes:
+# - Exit code matches extract-tasks.sh (e.g. duplicates => non-zero), but output is still printed.
+# - Read-only.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(CDPATH="" cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+EXTRACT="$SCRIPT_DIR/extract-tasks.sh"
+
+JSON_MODE=false
+SHOW_HELP=false
+FORWARD_ARGS=()
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --json)
+      JSON_MODE=true
+      shift
+      ;;
+    --help|-h)
+      SHOW_HELP=true
+      shift
+      ;;
+    *)
+      FORWARD_ARGS+=("$1")
+      shift
+      ;;
+  esac
+done
+
+if $SHOW_HELP; then
+  cat << 'EOF'
+Usage: show-todo-tasks.sh [--json] [--feature <id>]... [<id>...]
+
+Default (no feature args): summarize all specs that still have TODO tasks.
+With feature args: show pending tasks from tasks.md, with file+line evidence.
+
+Options:
+  --json              Output JSON (default: text)
+  --feature <id>      Target a specific spec (repeatable)
+  --help, -h          Show this help message
+
+Examples:
+  ./show-todo-tasks.sh
+  ./show-todo-tasks.sh 024
+  ./show-todo-tasks.sh --feature 024 --feature 025
+  ./show-todo-tasks.sh --json --feature 024
+EOF
+  exit 0
+fi
+
+if [[ ${#FORWARD_ARGS[@]} -eq 0 ]]; then
+  source "$SCRIPT_DIR/common.sh"
+  REPO_ROOT="$(get_repo_root)"
+  SPECS_DIR="$REPO_ROOT/specs"
+
+  python3 - "$JSON_MODE" "$REPO_ROOT" "$SPECS_DIR" << 'PY'
+from __future__ import annotations
+
+import json
+import re
+import sys
+from pathlib import Path
+from typing import Any
+
+
+JSON_MODE = sys.argv[1].lower() == "true"
+REPO_ROOT = Path(sys.argv[2])
+SPECS_DIR = Path(sys.argv[3])
+
+TASK_PATTERN = re.compile(r"^\s*-\s*\[(?P<state>[ xX])\]\s+(?P<id>[A-Z]\d{3,})\b")
+FEATURE_PATTERN = re.compile(r"^(?P<num>\d{3})-")
+
+
+def feature_sort_key(name: str) -> tuple[int, str]:
+    m = FEATURE_PATTERN.match(name)
+    if not m:
+        return (-1, name)
+    return (int(m.group("num")), name)
+
+
+def count_todo(tasks_path: Path) -> dict[str, int]:
+    total = 0
+    done = 0
+    todo = 0
+
+    for line in tasks_path.read_text(encoding="utf-8", errors="replace").splitlines():
+        m = TASK_PATTERN.match(line)
+        if not m:
+            continue
+        total += 1
+        state = m.group("state").lower()
+        if state == "x":
+            done += 1
+        else:
+            todo += 1
+
+    return {"total": total, "done": done, "todo": todo}
+
+
+if not SPECS_DIR.is_dir():
+    raise SystemExit(f"ERROR: specs dir not found: {SPECS_DIR}")
+
+rows: list[dict[str, Any]] = []
+total_todo = 0
+
+for feature_dir in sorted((p for p in SPECS_DIR.iterdir() if p.is_dir()), key=lambda p: feature_sort_key(p.name)):
+    name = feature_dir.name
+    if not FEATURE_PATTERN.match(name):
+        continue
+
+    tasks_path = feature_dir / "tasks.md"
+    if not tasks_path.is_file():
+        continue
+
+    counts = count_todo(tasks_path)
+    if counts["todo"] <= 0:
+        continue
+
+    rows.append({"feature": name, "todo": counts["todo"]})
+    total_todo += counts["todo"]
+
+if JSON_MODE:
+    print(json.dumps({"repoRoot": str(REPO_ROOT), "counts": {"specs": len(rows), "todo": total_todo}, "specs": rows}, ensure_ascii=False, indent=2))
+    raise SystemExit(0)
+
+for r in rows:
+    print(f"{r['feature']} todo={r['todo']}")
+print(f"TOTAL todo={total_todo} specs={len(rows)}")
+PY
+
+  exit 0
+fi
+
+set +e
+RAW_JSON="$("$EXTRACT" --json "${FORWARD_ARGS[@]}")"
+STATUS=$?
+set -e
+
+TMP_JSON="$(mktemp -t speckit-todo-tasks.XXXXXX)"
+trap 'rm -f "$TMP_JSON"' EXIT
+printf '%s' "$RAW_JSON" > "$TMP_JSON"
+
+python3 - "$JSON_MODE" "$TMP_JSON" << 'PY'
+from __future__ import annotations
+
+import json
+import re
+import sys
+from pathlib import Path
+from typing import Any
+
+
+JSON_MODE = sys.argv[1].lower() == "true"
+JSON_PATH = Path(sys.argv[2])
+
+raw = JSON_PATH.read_text(encoding="utf-8", errors="replace")
+try:
+    payload = json.loads(raw)
+except json.JSONDecodeError:
+    sys.stdout.write(raw)
+    raise SystemExit(1)
+
+targets: list[dict[str, Any]] = payload.get("targets") or []
+
+TASK_DESC_PATTERN = re.compile(r"^\s*-\s*\[[ xX]\]\s+[A-Z]\d{3,}\b(?P<desc>.*)$")
+
+
+def format_task(task: dict[str, Any]) -> str:
+    task_id = task.get("id") or "(unknown)"
+    line = task.get("line") or "?"
+    phase = task.get("phase")
+    section = task.get("section")
+    story = task.get("story")
+    refs = task.get("refs") or []
+    raw_line = (task.get("raw") or "").rstrip("\n")
+
+    m = TASK_DESC_PATTERN.match(raw_line)
+    desc = (m.group("desc").strip() if m else raw_line.strip()) or raw_line
+
+    ctx_parts = [p for p in [phase, section, story] if p]
+    ctx = " / ".join(ctx_parts)
+    ctx_part = f" [{ctx}]" if ctx else ""
+    refs_part = f" refs={','.join(refs)}" if refs else ""
+
+    return f"  - {task_id}:{line}{ctx_part}{refs_part} {desc}"
+
+
+filtered_targets: list[dict[str, Any]] = []
+for t in targets:
+    if "error" in t:
+        filtered_targets.append(t)
+        continue
+
+    tasks = t.get("tasks") or []
+    todo_tasks = [task for task in tasks if not task.get("done")]
+
+    t2 = dict(t)
+    t2["tasks"] = todo_tasks
+    filtered_targets.append(t2)
+
+if JSON_MODE:
+    print(json.dumps({"targets": filtered_targets}, ensure_ascii=False, indent=2))
+    raise SystemExit(0)
+
+for t in filtered_targets:
+    if "error" in t:
+        err = t.get("error") or {}
+        print(f"[ERROR] {t.get('input')}: {err.get('type')}: {err.get('message')}")
+        continue
+
+    counts = t.get("counts") or {}
+    feature = t.get("feature") or "(unknown)"
+    tasks_file = t.get("tasksFile") or ""
+    print(f"{feature}  ({tasks_file})")
+    print(
+        "  "
+        + " ".join(
+            [
+                f"todo={counts.get('todo')}",
+                f"total={counts.get('total')}",
+                f"done={counts.get('done')}",
+                f"dup={counts.get('duplicates')}",
+            ]
+        )
+    )
+
+    todo_tasks = t.get("tasks") or []
+    if not todo_tasks:
+        print("  (no pending tasks)")
+        print()
+        continue
+
+    for task in todo_tasks:
+        print(format_task(task))
+    print()
+PY
+
+exit $STATUS