npm - tmux-agent - Versions diffs - 0.1.0 - Mend

tmux-agent 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (161) hide show

package/.codex/skills/speckit/SKILL.md +173 -0
package/.codex/skills/speckit/assets/templates/checklist-template.md +49 -0
package/.codex/skills/speckit/assets/templates/notes-entrypoints-template.md +11 -0
package/.codex/skills/speckit/assets/templates/notes-questions-template.md +7 -0
package/.codex/skills/speckit/assets/templates/notes-readme-template.md +36 -0
package/.codex/skills/speckit/assets/templates/notes-session-template.md +21 -0
package/.codex/skills/speckit/assets/templates/plan-template.md +126 -0
package/.codex/skills/speckit/assets/templates/spec-template.md +135 -0
package/.codex/skills/speckit/assets/templates/tasks-template.md +269 -0
package/.codex/skills/speckit/references/acceptance.md +183 -0
package/.codex/skills/speckit/references/analyze.md +186 -0
package/.codex/skills/speckit/references/checklist.md +302 -0
package/.codex/skills/speckit/references/clarify-auto.md +69 -0
package/.codex/skills/speckit/references/clarify-detailed.md +78 -0
package/.codex/skills/speckit/references/clarify.md +189 -0
package/.codex/skills/speckit/references/constitution.md +90 -0
package/.codex/skills/speckit/references/group.md +89 -0
package/.codex/skills/speckit/references/implement-task.md +115 -0
package/.codex/skills/speckit/references/implement.md +129 -0
package/.codex/skills/speckit/references/notes.md +82 -0
package/.codex/skills/speckit/references/plan-deep.md +87 -0
package/.codex/skills/speckit/references/plan-from-questions.md +115 -0
package/.codex/skills/speckit/references/plan-from-review.md +89 -0
package/.codex/skills/speckit/references/plan.md +97 -0
package/.codex/skills/speckit/references/review-plan.md +156 -0
package/.codex/skills/speckit/references/specify.md +246 -0
package/.codex/skills/speckit/references/tasks.md +155 -0
package/.codex/skills/speckit/references/taskstoissues.md +33 -0
package/.codex/skills/speckit/scripts/bash/check-prerequisites.sh +206 -0
package/.codex/skills/speckit/scripts/bash/common.sh +191 -0
package/.codex/skills/speckit/scripts/bash/create-new-feature.sh +259 -0
package/.codex/skills/speckit/scripts/bash/extract-coded-points.sh +322 -0
package/.codex/skills/speckit/scripts/bash/extract-spec-ids.sh +238 -0
package/.codex/skills/speckit/scripts/bash/extract-tasks.sh +295 -0
package/.codex/skills/speckit/scripts/bash/extract-user-stories.sh +312 -0
package/.codex/skills/speckit/scripts/bash/setup-notes.sh +182 -0
package/.codex/skills/speckit/scripts/bash/setup-plan.sh +110 -0
package/.codex/skills/speckit/scripts/bash/show-todo-tasks.sh +257 -0
package/.codex/skills/speckit/scripts/bash/spec-group-checklist.sh +402 -0
package/.codex/skills/speckit/scripts/bash/spec-group-members.sh +215 -0
package/.codex/skills/speckit/scripts/bash/spec-registry-graph.sh +399 -0
package/.specify/memory/constitution.md +67 -0
package/.specify/templates/agent-file-template.md +28 -0
package/.specify/templates/checklist-template.md +49 -0
package/.specify/templates/plan-template.md +126 -0
package/.specify/templates/spec-template.md +135 -0
package/.specify/templates/tasks-template.md +269 -0
package/README.md +128 -0
package/README.zh-CN.md +127 -0
package/bun.lock +269 -0
package/dist/cli/commands/codex/forkHome.js +88 -0
package/dist/cli/commands/codex/send.js +55 -0
package/dist/cli/commands/codex/sessionInfo.js +42 -0
package/dist/cli/commands/codex/spawn.js +68 -0
package/dist/cli/commands/find.js +26 -0
package/dist/cli/commands/paneKill.js +33 -0
package/dist/cli/commands/paneSpawn.js +40 -0
package/dist/cli/commands/paneTitle.js +33 -0
package/dist/cli/commands/read.js +34 -0
package/dist/cli/commands/send.js +51 -0
package/dist/cli/commands/snapshot.js +19 -0
package/dist/cli/commands/ui/select.js +41 -0
package/dist/cli/commands/windowKill.js +25 -0
package/dist/cli/commands/windowLs.js +15 -0
package/dist/cli/commands/windowNew.js +28 -0
package/dist/cli/commands/windowRename.js +25 -0
package/dist/cli/index.js +365 -0
package/dist/cli/parse.js +39 -0
package/dist/lib/codex/forkHome.js +101 -0
package/dist/lib/codex/isCodexPane.js +55 -0
package/dist/lib/codex/send.js +58 -0
package/dist/lib/codex/sessionInfo.js +449 -0
package/dist/lib/codex/spawn.js +246 -0
package/dist/lib/contracts/types.js +2 -0
package/dist/lib/fs/safeRm.js +32 -0
package/dist/lib/io/readStdin.js +14 -0
package/dist/lib/os/process.js +55 -0
package/dist/lib/output/format.js +95 -0
package/dist/lib/proc/lsof.js +42 -0
package/dist/lib/proc/ps.js +60 -0
package/dist/lib/targeting/errors.js +13 -0
package/dist/lib/targeting/resolvePaneTarget.js +91 -0
package/dist/lib/targeting/resolveWindowTarget.js +40 -0
package/dist/lib/targeting/scope.js +58 -0
package/dist/lib/tmux/capturePane.js +20 -0
package/dist/lib/tmux/exec.js +66 -0
package/dist/lib/tmux/paneOps.js +29 -0
package/dist/lib/tmux/paste.js +23 -0
package/dist/lib/tmux/sendKeys.js +47 -0
package/dist/lib/tmux/session.js +29 -0
package/dist/lib/tmux/snapshotPanes.js +46 -0
package/dist/lib/tmux/snapshotWindows.js +24 -0
package/dist/lib/tmux/windowOps.js +32 -0
package/dist/lib/ui/popupSelect.js +432 -0
package/dist/lib/ui/popupSupport.js +76 -0
package/package.json +23 -0
package/src/cli/commands/codex/forkHome.ts +141 -0
package/src/cli/commands/codex/send.ts +83 -0
package/src/cli/commands/codex/sessionInfo.ts +59 -0
package/src/cli/commands/codex/spawn.ts +90 -0
package/src/cli/commands/find.ts +40 -0
package/src/cli/commands/paneKill.ts +49 -0
package/src/cli/commands/paneSpawn.ts +53 -0
package/src/cli/commands/paneTitle.ts +50 -0
package/src/cli/commands/read.ts +48 -0
package/src/cli/commands/send.ts +71 -0
package/src/cli/commands/snapshot.ts +28 -0
package/src/cli/commands/ui/select.ts +49 -0
package/src/cli/commands/windowKill.ts +35 -0
package/src/cli/commands/windowLs.ts +20 -0
package/src/cli/commands/windowNew.ts +40 -0
package/src/cli/commands/windowRename.ts +36 -0
package/src/cli/index.ts +430 -0
package/src/lib/codex/forkHome.ts +148 -0
package/src/lib/codex/isCodexPane.ts +56 -0
package/src/lib/codex/send.ts +84 -0
package/src/lib/codex/sessionInfo.ts +521 -0
package/src/lib/codex/spawn.ts +305 -0
package/src/lib/contracts/types.ts +30 -0
package/src/lib/fs/safeRm.ts +32 -0
package/src/lib/io/readStdin.ts +11 -0
package/src/lib/output/format.ts +105 -0
package/src/lib/proc/lsof.ts +44 -0
package/src/lib/proc/ps.ts +70 -0
package/src/lib/targeting/errors.ts +25 -0
package/src/lib/targeting/resolvePaneTarget.ts +106 -0
package/src/lib/targeting/resolveWindowTarget.ts +45 -0
package/src/lib/targeting/scope.ts +76 -0
package/src/lib/tmux/capturePane.ts +21 -0
package/src/lib/tmux/exec.ts +90 -0
package/src/lib/tmux/paneOps.ts +35 -0
package/src/lib/tmux/paste.ts +20 -0
package/src/lib/tmux/sendKeys.ts +72 -0
package/src/lib/tmux/session.ts +27 -0
package/src/lib/tmux/snapshotPanes.ts +52 -0
package/src/lib/tmux/snapshotWindows.ts +23 -0
package/src/lib/tmux/windowOps.ts +43 -0
package/src/lib/ui/popupSelect.ts +561 -0
package/src/lib/ui/popupSupport.ts +84 -0
package/tests/e2e/codexForkHome.test.ts +146 -0
package/tests/e2e/codexSessionInfo.test.ts +112 -0
package/tests/e2e/codexTuiSend.test.ts +68 -0
package/tests/integration/codexSpawn.test.ts +113 -0
package/tests/integration/paneOps.test.ts +60 -0
package/tests/integration/sendRead.test.ts +52 -0
package/tests/integration/snapshot.test.ts +39 -0
package/tests/integration/tmuxHarness.ts +39 -0
package/tests/integration/windowOps.test.ts +60 -0
package/tests/unit/codexSend.test.ts +105 -0
package/tests/unit/codexSessionInfo.test.ts +88 -0
package/tests/unit/codexSpawn.test.ts +34 -0
package/tests/unit/keys.test.ts +30 -0
package/tests/unit/outputFormat.test.ts +52 -0
package/tests/unit/popupSelect.test.ts +77 -0
package/tests/unit/popupSupport.test.ts +109 -0
package/tests/unit/resolvePaneTarget.test.ts +43 -0
package/tests/unit/resolveWindowTarget.test.ts +36 -0
package/tests/unit/safeRm.test.ts +41 -0
package/tests/unit/scope.test.ts +57 -0
package/tsconfig.json +14 -0
package/vitest.config.ts +16 -0

package/.codex/skills/speckit/scripts/bash/extract-tasks.sh ADDED Viewed

@@ -0,0 +1,295 @@
+#!/usr/bin/env bash
+# Extract tasks (checkbox + id + status) from one or more tasks.md files.
+#
+# This script is intentionally read-only and deterministic: it emits an inventory
+# of tasks with file+line evidence so acceptance review does not rely on ad-hoc grep.
+#
+# Usage:
+#   ./extract-tasks.sh [--json] [--feature <id>]... [<id>...]
+#
+# Examples:
+#   ./extract-tasks.sh --json --feature 024 --feature 025
+#   ./extract-tasks.sh 024 025
+#
+# Notes:
+# - <id> can be "024" (numeric prefix) or "024-some-feature" (full directory).
+# - Feature resolution reuses check-prerequisites.sh to find absolute paths.
+set -euo pipefail
+JSON_MODE=false
+FEATURES=()
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --json)
+      JSON_MODE=true
+      shift
+      ;;
+    --feature)
+      if [[ $# -lt 2 || "${2:-}" == --* ]]; then
+        echo "ERROR: --feature requires a value." >&2
+        exit 1
+      fi
+      FEATURES+=("$2")
+      shift 2
+      ;;
+    --feature=*)
+      FEATURES+=("${1#--feature=}")
+      shift
+      ;;
+    --help|-h)
+      cat << 'EOF'
+Usage: extract-tasks.sh [--json] [--feature <id>]... [<id>...]
+Extract checkbox tasks from one or more tasks.md files and emit an inventory
+with file+line evidence (useful for speckit.acceptance).
+Options:
+  --json              Output JSON (default: text)
+  --feature <id>      Target a specific spec (repeatable)
+  --help, -h          Show this help message
+Examples:
+  ./extract-tasks.sh --json --feature 024 --feature 025
+  ./extract-tasks.sh 024 025
+EOF
+      exit 0
+      ;;
+    --*)
+      echo "ERROR: Unknown option '$1'. Use --help for usage information." >&2
+      exit 1
+      ;;
+    *)
+      if [[ "$1" =~ ^[0-9]{3}(-.+)?$ ]]; then
+        FEATURES+=("$1")
+        shift
+      else
+        echo "ERROR: Unknown argument '$1'. Expected feature id like 024 or 024-some-feature." >&2
+        exit 1
+      fi
+      ;;
+  esac
+done
+SCRIPT_DIR="$(CDPATH="" cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CHECK_PREREQ="$SCRIPT_DIR/check-prerequisites.sh"
+python3 - "$CHECK_PREREQ" "$JSON_MODE" "${FEATURES[@]}" << 'PY'
+from __future__ import annotations
+import json
+import re
+import subprocess
+import sys
+from pathlib import Path
+from typing import Any
+CHECK = sys.argv[1]
+JSON_MODE = sys.argv[2].lower() == "true"
+INPUT_FEATURES = sys.argv[3:]
+TASK_PATTERN = re.compile(r"^\s*-\s*\[(?P<state>[ xX])\]\s+(?P<id>[A-Z]\d{3,})\b(?P<rest>.*)$")
+HEADING_PATTERN = re.compile(r"^(#{1,6})\s+(.+?)\s*$")
+STORY_PATTERN = re.compile(r"\[(US\d+)\]")
+PARALLEL_PATTERN = re.compile(r"\[P\]")
+CODE_PATTERN = re.compile(r"\b(?:FR|NFR|SC)-\d{3}\b")
+REFS_MARKER_PATTERN = re.compile(r"\bRefs:\s*(?P<body>.+?)\s*[)）]\s*$")
+def run_check(feature: str | None) -> dict[str, Any]:
+    cmd = [CHECK, "--json", "--paths-only"]
+    if feature:
+        cmd += ["--feature", feature]
+    out = subprocess.check_output(cmd, text=True)
+    return json.loads(out)
+def parse_tasks(tasks_path: Path) -> tuple[list[dict[str, Any]], list[dict[str, Any]]]:
+    if not tasks_path.exists():
+        raise FileNotFoundError(str(tasks_path))
+    lines = tasks_path.read_text(encoding="utf-8", errors="replace").splitlines()
+    last_h2: str | None = None
+    last_h3: str | None = None
+    tasks: list[dict[str, Any]] = []
+    non_task_checkboxes: list[dict[str, Any]] = []
+    for line_no, line in enumerate(lines, start=1):
+        heading_match = HEADING_PATTERN.match(line)
+        if heading_match:
+            level = len(heading_match.group(1))
+            title = heading_match.group(2).strip() or None
+            if level == 2:
+                last_h2 = title
+                last_h3 = None
+            elif level == 3:
+                last_h3 = title
+        m = TASK_PATTERN.match(line)
+        if not m:
+            # Keep compatibility: some tasks files may include checkboxes without IDs;
+            # we intentionally ignore them, but record them for diagnostics.
+            if re.match(r"^\s*-\s*\[[ xX]\]\s+", line):
+                non_task_checkboxes.append({"line": line_no, "raw": line})
+            continue
+        state = m.group("state")
+        task_id = m.group("id")
+        rest = m.group("rest").strip()
+        story_match = STORY_PATTERN.search(rest)
+        story = story_match.group(1) if story_match else None
+        parallel = bool(PARALLEL_PATTERN.search(rest))
+        refs_codes: list[str] = []
+        refs_marker = REFS_MARKER_PATTERN.search(rest)
+        if refs_marker:
+            refs_body = refs_marker.group("body")
+            refs_codes = sorted(set(CODE_PATTERN.findall(refs_body)))
+        tasks.append(
+            {
+                "id": task_id,
+                "done": state.lower() == "x",
+                "line": line_no,
+                "phase": last_h2,
+                "section": last_h3,
+                "parallel": parallel,
+                "story": story,
+                "refs": refs_codes,
+                "raw": line.rstrip("\n"),
+            }
+        )
+    return tasks, non_task_checkboxes
+def summarize_duplicates(tasks: list[dict[str, Any]]) -> list[dict[str, Any]]:
+    by_id: dict[str, list[dict[str, Any]]] = {}
+    for t in tasks:
+        by_id.setdefault(t["id"], []).append(t)
+    duplicates = []
+    for task_id, items in by_id.items():
+        if len(items) > 1:
+            duplicates.append(
+                {
+                    "id": task_id,
+                    "occurrences": [{"line": it["line"], "raw": it["raw"]} for it in items],
+                }
+            )
+    return sorted(duplicates, key=lambda x: x["id"])
+def summarize_by_key(tasks: list[dict[str, Any]], key: str) -> dict[str, Any]:
+    out: dict[str, Any] = {}
+    for t in tasks:
+        k = t.get(key) or "(none)"
+        bucket = out.setdefault(k, {"total": 0, "done": 0, "todo": 0})
+        bucket["total"] += 1
+        if t["done"]:
+            bucket["done"] += 1
+        else:
+            bucket["todo"] += 1
+    return out
+def main() -> int:
+    features = list(INPUT_FEATURES)
+    if not features:
+        features = [None]  # type: ignore[list-item]
+    targets: list[dict[str, Any]] = []
+    had_error = False
+    for feature in features:
+        try:
+            paths = run_check(feature)
+            tasks_path = Path(paths.get("TASKS", ""))
+            tasks, non_task_checkboxes = parse_tasks(tasks_path)
+        except Exception as e:
+            had_error = True
+            targets.append(
+                {
+                    "input": feature,
+                    "error": {"message": str(e), "type": type(e).__name__},
+                }
+            )
+            continue
+        total = len(tasks)
+        done = sum(1 for t in tasks if t["done"])
+        todo = total - done
+        duplicates = summarize_duplicates(tasks)
+        if duplicates:
+            had_error = True
+        targets.append(
+            {
+                "input": feature,
+                "feature": paths.get("BRANCH"),
+                "repoRoot": paths.get("REPO_ROOT"),
+                "featureDir": paths.get("FEATURE_DIR"),
+                "tasksFile": str(Path(paths.get("FEATURE_DIR", "")) / "tasks.md"),
+                "counts": {
+                    "total": total,
+                    "done": done,
+                    "todo": todo,
+                    "duplicates": len(duplicates),
+                    "nonTaskCheckboxes": len(non_task_checkboxes),
+                },
+                "byPhase": summarize_by_key(tasks, "phase"),
+                "byStory": summarize_by_key(tasks, "story"),
+                "duplicates": duplicates,
+                "nonTaskCheckboxes": non_task_checkboxes,
+                "tasks": tasks,
+            }
+        )
+    if JSON_MODE:
+        print(json.dumps({"targets": targets}, ensure_ascii=False, indent=2))
+        return 1 if had_error else 0
+    for t in targets:
+        if "error" in t:
+            print(f"[ERROR] {t.get('input')}: {t['error']['type']}: {t['error']['message']}")
+            continue
+        counts = t.get("counts", {})
+        print(f"{t.get('feature')}  ({t.get('tasksFile')})")
+        print(
+            "  "
+            + " ".join(
+                [
+                    f"total={counts.get('total')}",
+                    f"done={counts.get('done')}",
+                    f"todo={counts.get('todo')}",
+                    f"dup={counts.get('duplicates')}",
+                    f"nonTaskCheckboxes={counts.get('nonTaskCheckboxes')}",
+                ]
+            )
+        )
+        for task in t.get("tasks", []):
+            mark = "x" if task["done"] else " "
+            phase = task.get("phase") or ""
+            story = task.get("story") or ""
+            refs = task.get("refs") or []
+            refs_part = f" refs={','.join(refs)}" if refs else ""
+            context = " / ".join([p for p in [phase, story] if p]) if (phase or story) else ""
+            context_part = f" [{context}]" if context else ""
+            print(f"  - [{mark}] {task['id']}:{task['line']}{context_part}{refs_part} {task['raw']}")
+        print()
+    return 1 if had_error else 0
+if __name__ == "__main__":
+    raise SystemExit(main())
+PY

package/.codex/skills/speckit/scripts/bash/extract-user-stories.sh ADDED Viewed

@@ -0,0 +1,312 @@
+#!/usr/bin/env bash
+# Extract user stories (US) from one or more spec.md files.
+#
+# This script is intentionally read-only and deterministic: it emits an inventory
+# of User Story definitions with file+line evidence.
+#
+# Usage:
+#   ./extract-user-stories.sh [--json] [--feature <id>]... [<id>...]
+#
+# Examples:
+#   ./extract-user-stories.sh --json --feature 061
+#   ./extract-user-stories.sh 060 061
+#
+# Notes:
+# - <id> can be "024" (numeric prefix) or "024-some-feature" (full directory).
+# - Feature resolution reuses check-prerequisites.sh to find absolute paths.
+set -euo pipefail
+JSON_MODE=false
+FEATURES=()
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --json)
+      JSON_MODE=true
+      shift
+      ;;
+    --feature)
+      if [[ $# -lt 2 || "${2:-}" == --* ]]; then
+        echo "ERROR: --feature requires a value." >&2
+        exit 1
+      fi
+      FEATURES+=("$2")
+      shift 2
+      ;;
+    --feature=*)
+      FEATURES+=("${1#--feature=}")
+      shift
+      ;;
+    --help|-h)
+      cat << 'EOF'
+Usage: extract-user-stories.sh [--json] [--feature <id>]... [<id>...]
+Extract User Story (US) definitions from one or more spec files and emit an inventory
+with file+line evidence.
+Options:
+  --json              Output JSON (default: text)
+  --feature <id>      Target a specific spec (repeatable)
+  --help, -h          Show this help message
+Examples:
+  ./extract-user-stories.sh --json --feature 061
+  ./extract-user-stories.sh 060 061
+EOF
+      exit 0
+      ;;
+    --*)
+      echo "ERROR: Unknown option '$1'. Use --help for usage information." >&2
+      exit 1
+      ;;
+    *)
+      if [[ "$1" =~ ^[0-9]{3}(-.+)?$ ]]; then
+        FEATURES+=("$1")
+        shift
+      else
+        echo "ERROR: Unknown argument '$1'. Expected feature id like 024 or 024-some-feature." >&2
+        exit 1
+      fi
+      ;;
+  esac
+done
+SCRIPT_DIR="$(CDPATH="" cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CHECK_PREREQ="$SCRIPT_DIR/check-prerequisites.sh"
+python3 - "$CHECK_PREREQ" "$JSON_MODE" "${FEATURES[@]}" << 'PY'
+from __future__ import annotations
+import json
+import re
+import subprocess
+import sys
+from pathlib import Path
+from typing import Any
+CHECK = sys.argv[1]
+JSON_MODE = sys.argv[2].lower() == "true"
+INPUT_FEATURES = sys.argv[3:]
+HEADING_PATTERN = re.compile(r"^(#{1,6})\s+(.+?)\s*$")
+USER_STORY_PATTERN = re.compile(r"^User\s+Story\s+(?P<num>\d+)\b(?P<rest>.*)$", re.IGNORECASE)
+PRIORITY_PATTERN = re.compile(r"\(\s*Priority\s*:\s*(?P<priority>P\d+)\s*\)\s*$", re.IGNORECASE)
+US_CODE_PATTERN = re.compile(r"\bUS(?P<num>\d+)\b")
+def run_check(feature: str | None) -> dict[str, Any]:
+    cmd = [CHECK, "--json", "--paths-only"]
+    if feature:
+        cmd += ["--feature", feature]
+    out = subprocess.check_output(cmd, text=True)
+    return json.loads(out)
+def normalize_title(rest: str) -> tuple[str, str | None]:
+    rest = rest.strip()
+    priority: str | None = None
+    pri = PRIORITY_PATTERN.search(rest)
+    if pri:
+        priority = pri.group("priority")
+        rest = rest[: pri.start()].rstrip()
+    rest = rest.lstrip()
+    if rest.startswith(("-", "–", "—")):
+        rest = rest[1:].lstrip()
+    if rest.startswith(":"):
+        rest = rest[1:].lstrip()
+    return rest.strip(), priority
+def parse_user_stories(spec_path: Path) -> tuple[list[dict[str, Any]], list[dict[str, Any]], list[dict[str, Any]]]:
+    if not spec_path.exists():
+        return [], [], []
+    lines = spec_path.read_text(encoding="utf-8", errors="replace").splitlines()
+    # Collect story headings (definitions).
+    definitions: list[dict[str, Any]] = []
+    by_code: dict[str, list[dict[str, Any]]] = {}
+    for line_no, line in enumerate(lines, start=1):
+        heading = HEADING_PATTERN.match(line)
+        if not heading:
+            continue
+        heading_text = heading.group(2).strip()
+        m = USER_STORY_PATTERN.match(heading_text)
+        if not m:
+            continue
+        num = int(m.group("num"))
+        raw_rest = m.group("rest")
+        title, priority = normalize_title(raw_rest)
+        code = f"US{num}"
+        definition = {
+            "code": code,
+            "index": num,
+            "line": line_no,
+            "title": title,
+            "priority": priority,
+            "raw": line.rstrip("\n"),
+        }
+        definitions.append(definition)
+        by_code.setdefault(code, []).append(definition)
+    # Pick canonical definitions per code (keep order by index).
+    stories: list[dict[str, Any]] = []
+    duplicates: list[dict[str, Any]] = []
+    for code, defs in sorted(by_code.items(), key=lambda kv: int(kv[0][2:])):
+        canonical = defs[0]
+        story = dict(canonical)
+        story["references"] = []
+        stories.append(story)
+        if len(defs) > 1:
+            duplicates.append(
+                {
+                    "code": code,
+                    "definitions": [{"line": d["line"], "raw": d["raw"]} for d in defs],
+                }
+            )
+    by_code_story: dict[str, dict[str, Any]] = {s["code"]: s for s in stories}
+    # Collect references (USn mentions) and orphan references (USn without heading).
+    orphan_refs: dict[str, list[dict[str, Any]]] = {}
+    total_refs = 0
+    for line_no, line in enumerate(lines, start=1):
+        for match in US_CODE_PATTERN.finditer(line):
+            code = f"US{match.group('num')}"
+            occ = {"line": line_no, "col": match.start() + 1, "raw": line.rstrip("\n")}
+            total_refs += 1
+            story = by_code_story.get(code)
+            if story is not None:
+                story["references"].append(occ)
+            else:
+                orphan_refs.setdefault(code, []).append(occ)
+    orphan_references = [
+        {"code": code, "references": refs} for code, refs in sorted(orphan_refs.items(), key=lambda kv: int(kv[0][2:]))
+    ]
+    return stories, duplicates, orphan_references
+def summarize_by_priority(stories: list[dict[str, Any]]) -> dict[str, int]:
+    out: dict[str, int] = {}
+    for s in stories:
+        p = s.get("priority") or "(none)"
+        out[p] = out.get(p, 0) + 1
+    return dict(sorted(out.items(), key=lambda kv: kv[0]))
+def main() -> int:
+    features = list(INPUT_FEATURES)
+    if not features:
+        features = [None]  # type: ignore[list-item]
+    targets: list[dict[str, Any]] = []
+    had_error = False
+    for feature in features:
+        try:
+            paths = run_check(feature)
+        except subprocess.CalledProcessError as e:
+            had_error = True
+            targets.append(
+                {
+                    "input": feature,
+                    "error": {
+                        "message": "check-prerequisites failed",
+                        "exitCode": e.returncode,
+                        "stdout": (e.stdout or "").strip(),
+                        "stderr": (e.stderr or "").strip(),
+                    },
+                }
+            )
+            continue
+        spec_path = Path(paths.get("FEATURE_SPEC", ""))
+        stories, duplicate_definitions, orphan_references = parse_user_stories(spec_path)
+        if duplicate_definitions:
+            had_error = True
+        counts = {
+            "definitions": len(stories),
+            "byPriority": summarize_by_priority(stories),
+            "references": sum(len(s.get("references") or []) for s in stories),
+            "duplicateDefinitions": len(duplicate_definitions),
+            "orphanReferences": len(orphan_references),
+        }
+        targets.append(
+            {
+                "input": feature,
+                "feature": paths.get("BRANCH"),
+                "repoRoot": paths.get("REPO_ROOT"),
+                "featureDir": paths.get("FEATURE_DIR"),
+                "specFile": str(spec_path),
+                "planFile": paths.get("IMPL_PLAN"),
+                "tasksFile": paths.get("TASKS"),
+                "counts": counts,
+                "duplicateDefinitions": duplicate_definitions,
+                "orphanReferences": orphan_references,
+                "stories": stories,
+            }
+        )
+    if JSON_MODE:
+        print(json.dumps({"targets": targets}, ensure_ascii=False, indent=2))
+        return 1 if had_error else 0
+    for t in targets:
+        if "error" in t:
+            err = t.get("error") or {}
+            print(f"[ERROR] {t.get('input')}: {err.get('message')}")
+            continue
+        print(f"{t.get('feature')}  ({t.get('specFile')})")
+        counts = t.get("counts") or {}
+        by_pri = counts.get("byPriority") or {}
+        print(
+            "  "
+            + " ".join(
+                [
+                    f"definitions={counts.get('definitions')}",
+                    f"byPriority={by_pri}",
+                    f"refs={counts.get('references')}",
+                    f"dupDefs={counts.get('duplicateDefinitions')}",
+                    f"orphanRefs={counts.get('orphanReferences')}",
+                ]
+            )
+        )
+        for s in t.get("stories") or []:
+            pri = s.get("priority")
+            pri_part = f" pri={pri}" if pri else ""
+            title = s.get("title") or ""
+            refs = s.get("references") or []
+            refs_part = f" refs={len(refs)}" if refs else ""
+            print(f"  - {s['code']}:{s['line']}{pri_part}{refs_part} {title}".rstrip())
+        print()
+    return 1 if had_error else 0
+if __name__ == "__main__":
+    raise SystemExit(main())
+PY