@paths.design/caws-cli 9.0.0 → 9.1.1

package/dist/templates/.claude/hooks/session-log.sh

@@ -0,0 +1,528 @@
+#!/bin/bash
+# Session Logger for Claude Code → ChatGPT Context Transfer
+#
+# On Stop/PreCompact: reads the full transcript from ~/.claude/ and generates:
+#   session.txt        — lightweight index (header + turn list + exploration + audit)
+#   turn-001.txt       — per-turn narrative (user message + reasoning + key tool output)
+#   turn-001.json      — per-turn structured data (reasoning + tools + edits + results)
+#
+# Output: ./tmp/<session-id>/
+#
+# Wired into: SessionStart (metadata), Stop (generate), PreCompact (safety net)
+
+set -euo pipefail
+
+INPUT=$(cat)
+
+# --- Parse common fields ---
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // "unknown"')
+HOOK_EVENT=$(echo "$INPUT" | jq -r '.hook_event_name // "unknown"')
+CWD=$(echo "$INPUT" | jq -r '.cwd // "."')
+TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // ""')
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# --- Log directory ---
+LOG_DIR="${CWD}/tmp/${SESSION_ID}"
+mkdir -p "$LOG_DIR"
+
+SESSION_MD="$LOG_DIR/session.txt"
+META_FILE="$LOG_DIR/.meta.json"
+
+# ============================================================
+# Helper: resolve transcript path
+# ============================================================
+resolve_transcript() {
+  if [ -n "$TRANSCRIPT_PATH" ] && [ -f "$TRANSCRIPT_PATH" ]; then
+    echo "$TRANSCRIPT_PATH"
+    return
+  fi
+  local slug
+  slug=$(echo "$CWD" | sed 's|/|-|g; s|^-||')
+  local candidate="$HOME/.claude/projects/${slug}/${SESSION_ID}.jsonl"
+  if [ -f "$candidate" ]; then
+    echo "$candidate"
+    return
+  fi
+  candidate="$HOME/.claude/projects/-${slug}/${SESSION_ID}.jsonl"
+  if [ -f "$candidate" ]; then
+    echo "$candidate"
+    return
+  fi
+  echo ""
+}
+
+# ============================================================
+# Helper: make path relative to project
+# ============================================================
+rel_path() {
+  echo "$1" | sed "s|${CWD}/||"
+}
+
+# ============================================================
+# Generate per-turn files + session.md index from transcript
+# ============================================================
+generate_session_output() {
+  local transcript="$1"
+  local branch head_sha dirty_count
+  branch=$(cd "$CWD" 2>/dev/null && git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown")
+  head_sha=$(cd "$CWD" 2>/dev/null && git rev-parse --short HEAD 2>/dev/null || echo "unknown")
+  dirty_count=$(cd "$CWD" 2>/dev/null && git status --porcelain 2>/dev/null | wc -l | tr -d ' ' || echo "0")
+
+  # --- Read metadata if available ---
+  local started_at model start_sha
+  if [ -f "$META_FILE" ]; then
+    started_at=$(jq -r '.local_time // "unknown"' "$META_FILE")
+    model=$(jq -r '.model // "unknown"' "$META_FILE")
+    start_sha=$(jq -r '.head_sha // ""' "$META_FILE")
+  else
+    started_at="(resumed session)"
+    model="unknown"
+    start_sha=""
+  fi
+
+  if [ -z "$transcript" ] || [ ! -f "$transcript" ]; then
+    cat > "$SESSION_MD" << MDEOF
+# Session Log: $(basename "$CWD")
+
+| Field | Value |
+|-------|-------|
+| Session ID | \`${SESSION_ID}\` |
+| Started | ${started_at} |
+| Model | ${model} |
+| Branch | \`${branch}\` @ \`${head_sha}\` |
+
+---
+
+_No transcript found. Narrative extraction unavailable._
+MDEOF
+    return
+  fi
+
+  # --- Generate per-turn files via python ---
+  # jq emits each content block as a separate chronological event.
+  # Python accumulates into turns and writes sequential timeline per turn.
+  jq -c '
+    if .type == "user" then
+      if (.message.content | type) == "string" then
+        {ev: "user_text", text: .message.content}
+      elif (.message.content | type) == "array" then
+        .message.content[]? |
+        if .type == "tool_result" then
+          {ev: "tool_result", id: .tool_use_id, content: ((.content // "") | tostring), is_error: (.is_error // false)}
+        else
+          empty
+        end
+      else
+        empty
+      end
+    elif .type == "assistant" then
+      .message.content[]? |
+      if .type == "text" then
+        {ev: "text", text: .text}
+      elif .type == "tool_use" then
+        {ev: "tool_use", name, id,
+         file: (.input.file_path // null),
+         command: (.input.command // null),
+         description: (.input.description // null),
+         pattern: (.input.pattern // null),
+         prompt: (.input.prompt // null),
+         subagent_type: (.input.subagent_type // null)}
+      else
+        empty
+      end
+    else
+      empty
+    end
+  ' "$transcript" 2>/dev/null > "$LOG_DIR/.events.jsonl"
+
+  # Write python script to temp file (can't pipe + heredoc simultaneously)
+  local pyscript
+  pyscript=$(mktemp "${TMPDIR:-/tmp}/session-log-XXXX.py")
+  trap "rm -f '$pyscript'" RETURN
+  cat > "$pyscript" << 'PYEOF'
+import json, sys, os
+
+log_dir = sys.argv[1]
+cwd = sys.argv[2]
+session_id = sys.argv[3]
+started_at = sys.argv[4]
+model = sys.argv[5]
+branch = sys.argv[6]
+head_sha = sys.argv[7]
+dirty_count = sys.argv[8]
+start_sha = sys.argv[9]
+
+def rel(path):
+    if path and path.startswith(cwd + "/"):
+        return path[len(cwd) + 1:]
+    return path or ""
+
+# ---- Accumulate turns as chronological event timelines ----
+turns = []
+# Each turn: {user, timeline: [{kind, ...}, ...], edits, reads, searches, commands}
+current = {"user": None, "timeline": [], "edits": [], "reads": [], "searches": [], "commands": []}
+
+def new_turn(user_text):
+    return {
+        "user": user_text if user_text else None,
+        "timeline": [], "edits": [], "reads": [], "searches": [], "commands": [],
+    }
+
+# Track pending tool_use IDs to match with results
+pending_tools = {}  # id -> {name, ...}
+
+NOISE_PREFIXES = ("<local-command", "<command-name", "<local-command-stdout",
+                  "<local-command-caveat", "This session is being continued")
+
+# Keywords that make a tool result "notable" (worth showing inline)
+NOTABLE_KW = ["error", "fail", "refusal", "mismatch", "passed", "assert",
+              "traceback", "exception", "pytest", "PASSED", "FAILED", "TypedRefusal"]
+
+for line in sys.stdin:
+    try:
+        entry = json.loads(line)
+    except json.JSONDecodeError:
+        continue
+
+    ev = entry.get("ev")
+
+    if ev == "user_text":
+        text = entry["text"]
+        if any(text.startswith(p) for p in NOISE_PREFIXES):
+            continue
+        if not text.strip():
+            continue
+        if current["user"] or current["timeline"]:
+            turns.append(current)
+        current = new_turn(text)
+
+    elif ev == "text":
+        text = entry.get("text", "")
+        if len(text) > 20:
+            current["timeline"].append({"kind": "reasoning", "text": text})
+
+    elif ev == "tool_use":
+        name = entry.get("name", "")
+        tid = entry.get("id", "")
+        tool_entry = {"kind": "tool_call", "name": name, "id": tid}
+
+        if name in ("Write", "Edit"):
+            f = rel(entry.get("file"))
+            tool_entry["file"] = f
+            if f and f not in current["edits"]:
+                current["edits"].append(f)
+        elif name == "Read":
+            f = rel(entry.get("file"))
+            tool_entry["file"] = f
+            if f and f not in current["reads"]:
+                current["reads"].append(f)
+        elif name in ("Grep", "Glob"):
+            pat = entry.get("pattern", "")
+            tool_entry["pattern"] = pat
+            if pat:
+                current["searches"].append(pat)
+        elif name == "Bash":
+            cmd = entry.get("command", "")
+            desc = entry.get("description", "")
+            tool_entry["command"] = cmd
+            tool_entry["description"] = desc or ""
+            if cmd:
+                current["commands"].append({"cmd": cmd, "desc": desc or ""})
+        elif name == "Task":
+            tool_entry["prompt"] = entry.get("prompt", "")
+            tool_entry["subagent_type"] = entry.get("subagent_type", "")
+
+        current["timeline"].append(tool_entry)
+        pending_tools[tid] = tool_entry
+
+    elif ev == "tool_result":
+        tid = entry.get("id", "")
+        content = entry.get("content", "")
+        is_error = entry.get("is_error", False)
+        tool_info = pending_tools.get(tid, {})
+        name = tool_info.get("name", "unknown")
+
+        # Decide if this result is notable enough to show inline
+        # Task results are always notable (subagent did substantive work)
+        notable = is_error or name == "Task"
+        if not notable and content:
+            content_lower = content.lower()
+            notable = any(kw.lower() in content_lower for kw in NOTABLE_KW)
+
+        if notable and content:
+            # Cap file-content tools (full file reads/writes blow out turn files)
+            display = content
+            if name in ("Read", "Write", "Edit") and len(content) > 2000:
+                display = content[:2000] + "\n...(file content truncated)"
+            # Graft result onto the original tool_call entry (not a separate timeline item)
+            if tool_info:
+                tool_info["output"] = display
+                tool_info["is_error"] = is_error
+            else:
+                # Orphan result (no matching call) — append standalone
+                current["timeline"].append({
+                    "kind": "tool_output",
+                    "name": name,
+                    "content": display,
+                    "is_error": is_error,
+                })
+
+if current["user"] or current["timeline"]:
+    turns.append(current)
+
+# ---- Write per-turn files ----
+turn_index = []
+
+for i, turn in enumerate(turns):
+    num = i + 1
+    padded = f"{num:03d}"
+
+    # --- Build per-turn markdown: chronological timeline ---
+    md_lines = [f"# Turn {num}", ""]
+
+    if turn["user"]:
+        md_lines.extend([f"> ---user---\n{turn['user']}\n---/user---", ""])
+
+    for event in turn["timeline"]:
+        kind = event["kind"]
+
+        if kind == "reasoning":
+            text = event["text"]
+            md_lines.append(text)
+            md_lines.extend(["", "---", ""])
+
+        elif kind == "tool_call":
+            name = event.get("name", "")
+            if name in ("Read", "Glob"):
+                f = event.get("file") or event.get("pattern", "")
+                md_lines.append(f"`{name}` {f}")
+            elif name in ("Write", "Edit"):
+                md_lines.append(f"`{name}` {event.get('file', '')}")
+            elif name == "Bash":
+                cmd = event.get("command", "")
+                desc = event.get("description", "")
+                header = f"`Bash` _{desc}_" if desc else "`Bash`"
+                if len(cmd) > 120:
+                    md_lines.extend([header, "```", cmd, "```"])
+                else:
+                    md_lines.append(f"{header} `{cmd}`" if cmd else header)
+            elif name in ("Grep",):
+                md_lines.append(f"`Grep` {event.get('pattern', '')}")
+            elif name == "Task":
+                sa = event.get("subagent_type", "subagent")
+                prompt = event.get("prompt", "")
+                header = f"`Task` ({sa})" if sa else "`Task` (subagent)"
+                if prompt:
+                    # Show the dispatch prompt so readers know what the subagent was asked
+                    short_prompt = prompt[:500]
+                    if len(prompt) > 500:
+                        short_prompt += "..."
+                    md_lines.extend([header, "", f"> {short_prompt}", ""])
+            else:
+                md_lines.append(f"`{name}`")
+            md_lines.append("")
+
+            # If tool result was grafted onto this call, render it inline
+            if "output" in event:
+                output = event["output"]
+                is_error = event.get("is_error", False)
+                label = "error" if is_error else "output"
+                md_lines.extend([
+                    f"**{name}** ({label}):",
+                    "```",
+                    output,
+                    "```",
+                    "",
+                ])
+
+        elif kind == "tool_output":
+            # Orphan result (no matching call found) — render standalone
+            content = event.get("content", "")
+            name = event.get("name", "")
+            is_error = event.get("is_error", False)
+            label = "error" if is_error else "output"
+            md_lines.extend([
+                f"**{name}** ({label}):",
+                "```",
+                content,
+                "```",
+                "",
+            ])
+
+    # Write turn markdown
+    with open(os.path.join(log_dir, f"turn-{padded}.txt"), "w") as f:
+        f.write("\n".join(md_lines))
+
+    # --- Build per-turn JSON: chronological timeline ---
+    tool_summary = {}
+    for event in turn["timeline"]:
+        if event["kind"] == "tool_call":
+            n = event.get("name", "")
+            tool_summary[n] = tool_summary.get(n, 0) + 1
+
+    def group_by_ext(paths):
+        groups = {}
+        for p in paths:
+            ext = os.path.splitext(p)[1] or "(no ext)"
+            groups.setdefault(ext, []).append(p)
+        return groups
+
+    turn_json = {
+        "turn": num,
+        "user": turn["user"],
+        "timeline": turn["timeline"],
+        "tool_summary": tool_summary,
+        "files_edited": group_by_ext(turn["edits"]),
+        "files_read": group_by_ext(turn["reads"]),
+        "searches": turn["searches"],
+        "commands": [c["cmd"] for c in turn["commands"]],
+    }
+
+    with open(os.path.join(log_dir, f"turn-{padded}.json"), "w") as f:
+        json.dump(turn_json, f, indent=2)
+
+    # Index entry
+    user_preview = (turn["user"] or "(no user message)")[:120]
+    reasoning_count = sum(1 for e in turn["timeline"] if e["kind"] == "reasoning")
+    tool_count = sum(1 for e in turn["timeline"] if e["kind"] == "tool_call")
+    turn_index.append({
+        "num": num,
+        "padded": padded,
+        "user_preview": user_preview,
+        "reasoning_count": reasoning_count,
+        "tool_count": tool_count,
+        "edits": turn["edits"],
+    })
+
+# ---- Write session.md index ----
+with open(os.path.join(log_dir, "session.txt"), "w") as f:
+    f.write(f"# Session Log: {os.path.basename(cwd)}\n\n")
+    f.write("| Field | Value |\n")
+    f.write("|-------|-------|\n")
+    f.write(f"| Session ID | `{session_id}` |\n")
+    f.write(f"| Started | {started_at} |\n")
+    f.write(f"| Model | {model} |\n")
+    f.write(f"| Branch | `{branch}` @ `{head_sha}` |\n")
+    f.write(f"| Turns | {len(turn_index)} |\n")
+    f.write("\n---\n\n")
+
+    f.write("## Turns\n\n")
+    for t in turn_index:
+        edits_str = ", ".join(f"`{e}`" for e in t["edits"][:3])
+        if len(t["edits"]) > 3:
+            edits_str += f" +{len(t['edits'])-3} more"
+        summary = f"{t['reasoning_count']} msgs, {t['tool_count']} tools"
+        if edits_str:
+            summary += f" | {edits_str}"
+        f.write(f"- **[Turn {t['num']}](turn-{t['padded']}.md)** — {t['user_preview']}\n")
+        f.write(f"  _{summary}_\n")
+
+    f.write("\n---\n\n")
+
+    # Exploration summary (deduplicated across all turns)
+    all_reads = []
+    all_searches = []
+    all_edits = []
+    all_commands = []
+    for turn in turns:
+        all_reads.extend(turn["reads"])
+        all_searches.extend(turn["searches"])
+        all_edits.extend(turn["edits"])
+        all_commands.extend(turn["commands"])
+
+    f.write("## Exploration\n")
+    f.write("_Files read and searches performed (deduplicated)._\n\n")
+    for r in sorted(set(all_reads)):
+        f.write(f"- READ `{r}`\n")
+    for s in sorted(set(all_searches)):
+        f.write(f"- SEARCH `{s}`\n")
+    f.write("\n")
+
+    f.write("## Audit\n")
+    f.write("_Edits, commands, git activity._\n\n")
+    for e in sorted(set(all_edits)):
+        f.write(f"- EDIT `{e}`\n")
+    for cmd in all_commands:
+        short = cmd["cmd"][:120]
+        # Only log meaningful commands
+        meaningful = any(kw in short for kw in [
+            "pytest", "cargo test", "ruff", "mypy", "npm test",
+            "git log", "git diff", "git status", "git add", "git commit",
+            "git merge", "caws ", "pip install", "make", "cargo build"
+        ])
+        if meaningful:
+            if cmd["desc"]:
+                f.write(f"- BASH `{short}` — {cmd['desc']}\n")
+            else:
+                f.write(f"- BASH `{short}`\n")
+    f.write("\n")
+
+    f.write("## Session Snapshot\n\n")
+    f.write("| Field | Value |\n")
+    f.write("|-------|-------|\n")
+    f.write(f"| Branch | `{branch}` @ `{head_sha}` |\n")
+    f.write(f"| Dirty files | {dirty_count} |\n")
+    f.write(f"| Total turns | {len(turn_index)} |\n")
+
+PYEOF
+
+  # Run the python script with events as input
+  python3 "$pyscript" "$LOG_DIR" "$CWD" "$SESSION_ID" "$started_at" "$model" "$branch" "$head_sha" "$dirty_count" "$start_sha" < "$LOG_DIR/.events.jsonl"
+  rm -f "$LOG_DIR/.events.jsonl"
+}
+
+# ============================================================
+# EVENT: SessionStart — save metadata
+# ============================================================
+handle_session_start() {
+  local model source branch head_sha dirty_count full_time
+  model=$(echo "$INPUT" | jq -r '.model // "unknown"')
+  source=$(echo "$INPUT" | jq -r '.source // "unknown"')
+  branch=$(cd "$CWD" 2>/dev/null && git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown")
+  head_sha=$(cd "$CWD" 2>/dev/null && git rev-parse --short HEAD 2>/dev/null || echo "unknown")
+  dirty_count=$(cd "$CWD" 2>/dev/null && git status --porcelain 2>/dev/null | wc -l | tr -d ' ' || echo "0")
+  full_time=$(date +"%Y-%m-%d %H:%M:%S %Z")
+
+  jq -cn \
+    --arg sid "$SESSION_ID" \
+    --arg ts "$TIMESTAMP" \
+    --arg lt "$full_time" \
+    --arg model "$model" \
+    --arg source "$source" \
+    --arg branch "$branch" \
+    --arg head "$head_sha" \
+    --arg dirty "$dirty_count" \
+    --arg project "$(basename "$CWD")" \
+    --arg transcript "$TRANSCRIPT_PATH" \
+    '{session_id: $sid, started_at: $ts, local_time: $lt, model: $model, source: $source, branch: $branch, head_sha: $head, dirty_files: $dirty, project: $project, transcript_path: $transcript}' \
+    > "$META_FILE"
+
+  # Generate initial output (may be empty if transcript not ready)
+  generate_session_output "$(resolve_transcript)"
+}
+
+# ============================================================
+# EVENT: Stop — regenerate from transcript
+# ============================================================
+handle_stop() {
+  generate_session_output "$(resolve_transcript)"
+}
+
+# ============================================================
+# EVENT: PreCompact — safety net before context eviction
+# ============================================================
+handle_pre_compact() {
+  generate_session_output "$(resolve_transcript)"
+}
+
+# ============================================================
+# DISPATCH
+# ============================================================
+case "$HOOK_EVENT" in
+  SessionStart)   handle_session_start ;;
+  Stop)           handle_stop ;;
+  PreCompact)     handle_pre_compact ;;
+  *)              ;; # Other events: no-op
+esac
+
+exit 0

package/dist/templates/CLAUDE.md

@@ -38,15 +38,19 @@ caws agent evaluate
 
 ### Working Spec
 
-The project spec lives at `.caws/working-spec.yaml`. It defines:
+The project spec lives at `.caws/working-spec.yaml`. Feature specs live at `.caws/specs/<ID>.yaml`. It defines:
 
 - **Risk tier**: Quality requirements (T1: critical, T2: standard, T3: low risk)
 - **Scope**: Which files you can edit (`scope.in`) and which are off-limits (`scope.out`)
-- **Change budget**: Max files and lines of code per change
-- **Acceptance criteria**: What "done" means
+- **Change budget**: Max files and lines of code per change (see note below)
+- **Acceptance criteria**: What "done" means — IDs must match `^A\d+$` (e.g. `A1`, `A12`)
 
 Always stay within scope boundaries and change budgets.
 
+> **Budget note**: `change_budget:` in a spec is informational documentation only. CAWS
+> derives the enforced budget from `policy.yaml` keyed on `risk_tier`. The field in the
+> spec is not used by `caws validate` for enforcement.
+
 ### Quality Gates
 
 Quality requirements are tiered:

package/dist/utils/gitignore-updater.d.ts

@@ -35,5 +35,5 @@ export function verifyGitignore(projectRoot: string): Promise<boolean>;
  * - Logs (caws.log, debug logs)
  * - Local overrides (caws.local.*)
  */
-export const CAWS_GITIGNORE_ENTRIES: "\n# CAWS Local Runtime Data (developer-specific, should not be tracked)\n# ====================================================================\n# Note: Specs, policy, waivers, provenance, and plans ARE tracked for team collaboration\n# Only local agent tracking, generated tools, and temporary files are ignored\n\n# Agent runtime tracking (local to each developer)\n.agent/\n\n# CAWS tools (now in .caws/tools/)\n.caws/tools/\n# Legacy location (for backward compatibility)\napps/tools/caws/\n\n# Temporary CAWS files\n**/*.caws.tmp\n**/*.working-spec.bak\n.caws/*.tmp\n.caws/*.bak\n\n# CAWS logs (local debugging)\ncaws-debug.log*\n**/caws.log\n.caws/*.log\n\n# Local development overrides (developer-specific)\ncaws.local.*\n.caws/local.*\n\n# CAWS Worktrees (local, should not be tracked)\n.caws/worktrees/\n.caws/worktrees.json\n";
+export const CAWS_GITIGNORE_ENTRIES: "\n# CAWS Local Runtime Data (developer-specific, should not be tracked)\n# ====================================================================\n# Note: Specs, policy, waivers, provenance, and plans ARE tracked for team collaboration\n# Only local agent tracking, generated tools, and temporary files are ignored\n\n# Agent runtime tracking (local to each developer)\n.agent/\n\n# CAWS tools (now in .caws/tools/)\n.caws/tools/\n# Legacy location (for backward compatibility)\napps/tools/caws/\n\n# Temporary CAWS files\n**/*.caws.tmp\n**/*.working-spec.bak\n.caws/*.tmp\n.caws/*.bak\n\n# CAWS logs (local debugging)\ncaws-debug.log*\n**/caws.log\n.caws/*.log\n\n# Local development overrides (developer-specific)\ncaws.local.*\n.caws/local.*\n\n# CAWS Worktrees (local, should not be tracked)\n.caws/worktrees/\n.caws/worktrees.json\n\n# Session transcripts (generated by session-log hook)\ntmp/\n";
 //# sourceMappingURL=gitignore-updater.d.ts.map

package/dist/utils/gitignore-updater.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gitignore-updater.d.ts","sourceRoot":"","sources":["../../src/utils/gitignore-updater.js"],"names":[],"mappings":"AAiEA;;;;;;GAMG;AACH,6CALW,MAAM,YAEd;IAAyB,KAAK,EAAtB,OAAO;CACf,GAAU,OAAO,CAAC,OAAO,CAAC,CA2D5B;AAED;;;;GAIG;AACH,6CAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAW5B;AAvID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,22BAgCE"}
+{"version":3,"file":"gitignore-updater.d.ts","sourceRoot":"","sources":["../../src/utils/gitignore-updater.js"],"names":[],"mappings":"AAoEA;;;;;;GAMG;AACH,6CALW,MAAM,YAEd;IAAyB,KAAK,EAAtB,OAAO;CACf,GAAU,OAAO,CAAC,OAAO,CAAC,CA2D5B;AAED;;;;GAIG;AACH,6CAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAW5B;AA1ID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,06BAmCE"}

package/dist/utils/gitignore-updater.js

@@ -61,6 +61,9 @@ caws.local.*
 # CAWS Worktrees (local, should not be tracked)
 .caws/worktrees/
 .caws/worktrees.json
+
+# Session transcripts (generated by session-log hook)
+tmp/
 `;
 
 /**

package/dist/utils/ide-detection.d.ts

@@ -0,0 +1,89 @@
+export namespace IDE_REGISTRY {
+    namespace cursor {
+        let id: string;
+        let name: string;
+        let description: string;
+        let envVars: string[];
+    }
+    namespace claude {
+        let id_1: string;
+        export { id_1 as id };
+        let name_1: string;
+        export { name_1 as name };
+        let description_1: string;
+        export { description_1 as description };
+        let envVars_1: string[];
+        export { envVars_1 as envVars };
+    }
+    namespace vscode {
+        let id_2: string;
+        export { id_2 as id };
+        let name_2: string;
+        export { name_2 as name };
+        let description_2: string;
+        export { description_2 as description };
+        let envVars_2: string[];
+        export { envVars_2 as envVars };
+    }
+    namespace intellij {
+        let id_3: string;
+        export { id_3 as id };
+        let name_3: string;
+        export { name_3 as name };
+        let description_3: string;
+        export { description_3 as description };
+        let envVars_3: string[];
+        export { envVars_3 as envVars };
+    }
+    namespace windsurf {
+        let id_4: string;
+        export { id_4 as id };
+        let name_4: string;
+        export { name_4 as name };
+        let description_4: string;
+        export { description_4 as description };
+        let envVars_4: string[];
+        export { envVars_4 as envVars };
+    }
+    namespace copilot {
+        let id_5: string;
+        export { id_5 as id };
+        let name_5: string;
+        export { name_5 as name };
+        let description_5: string;
+        export { description_5 as description };
+        let envVars_5: any[];
+        export { envVars_5 as envVars };
+    }
+    namespace junie {
+        let id_6: string;
+        export { id_6 as id };
+        let name_6: string;
+        export { name_6 as name };
+        let description_6: string;
+        export { description_6 as description };
+        let envVars_6: any[];
+        export { envVars_6 as envVars };
+    }
+}
+export const ALL_IDE_IDS: string[];
+/**
+ * Detect currently active IDEs from environment variables.
+ * @returns {string[]} Array of detected IDE identifiers
+ */
+export function detectActiveIDEs(): string[];
+/**
+ * Get recommended IDE set based on detection and natural pairings.
+ * - Cursor detected -> also recommend Claude Code
+ * - VS Code detected -> also recommend Copilot
+ * - Nothing detected -> default to cursor + claude (AI-first set)
+ * @returns {string[]} Array of recommended IDE identifiers
+ */
+export function getRecommendedIDEs(): string[];
+/**
+ * Parse an IDE selection from a CLI flag value or prompt answer.
+ * @param {string|string[]} input - Comma-separated string or array of IDE ids
+ * @returns {string[]} Normalized, validated array of IDE identifiers
+ */
+export function parseIDESelection(input: string | string[]): string[];
+//# sourceMappingURL=ide-detection.d.ts.map

package/dist/utils/ide-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ide-detection.d.ts","sourceRoot":"","sources":["../../src/utils/ide-detection.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0DA,mCAA8C;AAE9C;;;GAGG;AACH,oCAFa,MAAM,EAAE,CAUpB;AAED;;;;;;GAMG;AACH,sCAFa,MAAM,EAAE,CAcpB;AAED;;;;GAIG;AACH,yCAHW,MAAM,GAAC,MAAM,EAAE,GACb,MAAM,EAAE,CA0BpB"}

package/dist/validation/spec-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-validation.d.ts","sourceRoot":"","sources":["../../src/validation/spec-validation.js"],"names":[],"mappings":"AA6DA;;;;;GAKG;AACH,mEA8HC;AAED;;;;;GAKG;AACH,kFAgdC;AAoCD;;;;;GAKG;AACH,0CAJW,MAAM,eAEJ,MAAM,CAkBlB;AAED;;;;;GAKG;AACH,uCAJW,MAAM,eAEJ,OAAO,CAKnB;AAnED;;;;;;GAMG;AACH,0EAFa,MAAM,CAclB;AAED;;;;GAIG;AACH,0CAHW,MAAM,GACJ,MAAM,CAQlB"}
+{"version":3,"file":"spec-validation.d.ts","sourceRoot":"","sources":["../../src/validation/spec-validation.js"],"names":[],"mappings":"AA6DA;;;;;GAKG;AACH,mEA8IC;AAED;;;;;GAKG;AACH,kFAycC;AAoCD;;;;;GAKG;AACH,0CAJW,MAAM,eAEJ,MAAM,CAkBlB;AAED;;;;;GAKG;AACH,uCAJW,MAAM,eAEJ,OAAO,CAKnB;AAnED;;;;;;GAMG;AACH,0EAFa,MAAM,CAclB;AAED;;;;GAIG;AACH,0CAHW,MAAM,GACJ,MAAM,CAQlB"}