aiwcli 0.12.3 → 0.12.7

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 (125) hide show
  1. package/bin/dev.cmd +3 -3
  2. package/bin/dev.js +16 -16
  3. package/bin/run.cmd +3 -3
  4. package/bin/run.js +21 -21
  5. package/dist/commands/branch.js +7 -2
  6. package/dist/lib/bmad-installer.js +37 -37
  7. package/dist/lib/terminal.d.ts +2 -0
  8. package/dist/lib/terminal.js +57 -7
  9. package/dist/templates/CLAUDE.md +205 -205
  10. package/dist/templates/_shared/.claude/commands/handoff-resume.md +12 -64
  11. package/dist/templates/_shared/.claude/commands/handoff.md +12 -198
  12. package/dist/templates/_shared/.claude/settings.json +65 -65
  13. package/dist/templates/_shared/.codex/workflows/handoff.md +226 -226
  14. package/dist/templates/_shared/.windsurf/workflows/handoff.md +226 -226
  15. package/dist/templates/_shared/handoff-system/CLAUDE.md +421 -0
  16. package/dist/templates/_shared/{lib-ts/handoff → handoff-system/lib}/document-generator.ts +215 -216
  17. package/dist/templates/_shared/{lib-ts/handoff → handoff-system/lib}/handoff-reader.ts +157 -158
  18. package/dist/templates/_shared/{scripts → handoff-system/scripts}/resume_handoff.ts +373 -373
  19. package/dist/templates/_shared/{scripts → handoff-system/scripts}/save_handoff.ts +469 -358
  20. package/dist/templates/_shared/handoff-system/workflows/handoff-resume.md +66 -0
  21. package/dist/templates/_shared/{workflows → handoff-system/workflows}/handoff.md +254 -254
  22. package/dist/templates/_shared/hooks-ts/_utils/git-state.ts +2 -2
  23. package/dist/templates/_shared/hooks-ts/archive_plan.ts +159 -159
  24. package/dist/templates/_shared/hooks-ts/context_monitor.ts +147 -147
  25. package/dist/templates/_shared/hooks-ts/file-suggestion.ts +128 -128
  26. package/dist/templates/_shared/hooks-ts/pre_compact.ts +49 -49
  27. package/dist/templates/_shared/hooks-ts/session_end.ts +196 -183
  28. package/dist/templates/_shared/hooks-ts/session_start.ts +163 -151
  29. package/dist/templates/_shared/hooks-ts/task_create_capture.ts +48 -48
  30. package/dist/templates/_shared/hooks-ts/task_update_capture.ts +74 -74
  31. package/dist/templates/_shared/hooks-ts/user_prompt_submit.ts +93 -93
  32. package/dist/templates/_shared/lib-ts/CLAUDE.md +367 -367
  33. package/dist/templates/_shared/lib-ts/base/atomic-write.ts +138 -138
  34. package/dist/templates/_shared/lib-ts/base/constants.ts +303 -303
  35. package/dist/templates/_shared/lib-ts/base/git-state.ts +58 -58
  36. package/dist/templates/_shared/lib-ts/base/hook-utils.ts +582 -582
  37. package/dist/templates/_shared/lib-ts/base/inference.ts +301 -301
  38. package/dist/templates/_shared/lib-ts/base/logger.ts +247 -247
  39. package/dist/templates/_shared/lib-ts/base/state-io.ts +202 -130
  40. package/dist/templates/_shared/lib-ts/base/stop-words.ts +184 -184
  41. package/dist/templates/_shared/lib-ts/base/subprocess-utils.ts +56 -0
  42. package/dist/templates/_shared/lib-ts/base/utils.ts +184 -184
  43. package/dist/templates/_shared/lib-ts/context/context-formatter.ts +566 -560
  44. package/dist/templates/_shared/lib-ts/context/context-selector.ts +524 -515
  45. package/dist/templates/_shared/lib-ts/context/context-store.ts +712 -668
  46. package/dist/templates/_shared/lib-ts/context/plan-manager.ts +312 -312
  47. package/dist/templates/_shared/lib-ts/context/task-tracker.ts +185 -185
  48. package/dist/templates/_shared/lib-ts/package.json +20 -20
  49. package/dist/templates/_shared/lib-ts/templates/formatters.ts +102 -102
  50. package/dist/templates/_shared/lib-ts/templates/plan-context.ts +58 -58
  51. package/dist/templates/_shared/lib-ts/tsconfig.json +13 -13
  52. package/dist/templates/_shared/lib-ts/types.ts +186 -180
  53. package/dist/templates/_shared/scripts/resolve_context.ts +33 -33
  54. package/dist/templates/_shared/scripts/status_line.ts +690 -690
  55. package/dist/templates/cc-native/.claude/commands/{rlm → cc-native/rlm}/ask.md +136 -136
  56. package/dist/templates/cc-native/.claude/commands/{rlm → cc-native/rlm}/index.md +21 -21
  57. package/dist/templates/cc-native/.claude/commands/{rlm → cc-native/rlm}/overview.md +56 -56
  58. package/dist/templates/cc-native/.claude/commands/cc-native/specdev.md +10 -10
  59. package/dist/templates/cc-native/.windsurf/workflows/cc-native/fix.md +8 -8
  60. package/dist/templates/cc-native/.windsurf/workflows/cc-native/implement.md +8 -8
  61. package/dist/templates/cc-native/.windsurf/workflows/cc-native/research.md +8 -8
  62. package/dist/templates/cc-native/CC-NATIVE-README.md +189 -189
  63. package/dist/templates/cc-native/TEMPLATE-SCHEMA.md +304 -304
  64. package/dist/templates/cc-native/_cc-native/agents/CLAUDE.md +143 -143
  65. package/dist/templates/cc-native/_cc-native/agents/PLAN-ORCHESTRATOR.md +213 -213
  66. package/dist/templates/cc-native/_cc-native/agents/plan-questions/PLAN-QUESTIONER.md +70 -70
  67. package/dist/templates/cc-native/_cc-native/cc-native.config.json +96 -96
  68. package/dist/templates/cc-native/_cc-native/hooks/CLAUDE.md +247 -247
  69. package/dist/templates/cc-native/_cc-native/hooks/cc-native-plan-review.ts +76 -76
  70. package/dist/templates/cc-native/_cc-native/hooks/enhance_plan_post_subagent.ts +54 -54
  71. package/dist/templates/cc-native/_cc-native/hooks/enhance_plan_post_write.ts +51 -51
  72. package/dist/templates/cc-native/_cc-native/hooks/mark_questions_asked.ts +53 -53
  73. package/dist/templates/cc-native/_cc-native/hooks/plan_questions_early.ts +61 -61
  74. package/dist/templates/cc-native/_cc-native/lib-ts/agent-selection.ts +163 -163
  75. package/dist/templates/cc-native/_cc-native/lib-ts/aggregate-agents.ts +156 -156
  76. package/dist/templates/cc-native/_cc-native/lib-ts/artifacts/format.ts +597 -597
  77. package/dist/templates/cc-native/_cc-native/lib-ts/artifacts/index.ts +26 -26
  78. package/dist/templates/cc-native/_cc-native/lib-ts/artifacts/tracker.ts +107 -107
  79. package/dist/templates/cc-native/_cc-native/lib-ts/artifacts/write.ts +119 -119
  80. package/dist/templates/cc-native/_cc-native/lib-ts/artifacts.ts +21 -21
  81. package/dist/templates/cc-native/_cc-native/lib-ts/cc-native-state.ts +319 -319
  82. package/dist/templates/cc-native/_cc-native/lib-ts/cli-output-parser.ts +144 -144
  83. package/dist/templates/cc-native/_cc-native/lib-ts/config.ts +57 -57
  84. package/dist/templates/cc-native/_cc-native/lib-ts/constants.ts +83 -83
  85. package/dist/templates/cc-native/_cc-native/lib-ts/corroboration.ts +119 -119
  86. package/dist/templates/cc-native/_cc-native/lib-ts/debug.ts +79 -79
  87. package/dist/templates/cc-native/_cc-native/lib-ts/graduation.ts +132 -132
  88. package/dist/templates/cc-native/_cc-native/lib-ts/index.ts +116 -116
  89. package/dist/templates/cc-native/_cc-native/lib-ts/json-parser.ts +168 -168
  90. package/dist/templates/cc-native/_cc-native/lib-ts/orchestrator.ts +70 -70
  91. package/dist/templates/cc-native/_cc-native/lib-ts/output-builder.ts +130 -130
  92. package/dist/templates/cc-native/_cc-native/lib-ts/plan-discovery.ts +80 -80
  93. package/dist/templates/cc-native/_cc-native/lib-ts/plan-enhancement.ts +41 -41
  94. package/dist/templates/cc-native/_cc-native/lib-ts/plan-questions.ts +101 -101
  95. package/dist/templates/cc-native/_cc-native/lib-ts/review-pipeline.ts +511 -511
  96. package/dist/templates/cc-native/_cc-native/lib-ts/reviewers/agent.ts +71 -71
  97. package/dist/templates/cc-native/_cc-native/lib-ts/reviewers/base/base-agent.ts +217 -217
  98. package/dist/templates/cc-native/_cc-native/lib-ts/reviewers/index.ts +12 -12
  99. package/dist/templates/cc-native/_cc-native/lib-ts/reviewers/providers/claude-agent.ts +66 -65
  100. package/dist/templates/cc-native/_cc-native/lib-ts/reviewers/providers/codex-agent.ts +184 -184
  101. package/dist/templates/cc-native/_cc-native/lib-ts/reviewers/providers/gemini-agent.ts +39 -39
  102. package/dist/templates/cc-native/_cc-native/lib-ts/reviewers/providers/orchestrator-claude-agent.ts +196 -195
  103. package/dist/templates/cc-native/_cc-native/lib-ts/reviewers/schemas.ts +201 -201
  104. package/dist/templates/cc-native/_cc-native/lib-ts/reviewers/types.ts +21 -21
  105. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/CLAUDE.md +480 -480
  106. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/embedding-indexer.ts +287 -287
  107. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/hyde.ts +148 -148
  108. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/index.ts +54 -54
  109. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/logger.ts +58 -58
  110. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/ollama-client.ts +208 -208
  111. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/retrieval-pipeline.ts +460 -460
  112. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/transcript-indexer.ts +446 -447
  113. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/transcript-loader.ts +280 -280
  114. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/transcript-searcher.ts +274 -274
  115. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/types.ts +201 -201
  116. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/vector-store.ts +278 -278
  117. package/dist/templates/cc-native/_cc-native/lib-ts/settings.ts +184 -184
  118. package/dist/templates/cc-native/_cc-native/lib-ts/state.ts +275 -275
  119. package/dist/templates/cc-native/_cc-native/lib-ts/tsconfig.json +18 -18
  120. package/dist/templates/cc-native/_cc-native/lib-ts/types.ts +329 -329
  121. package/dist/templates/cc-native/_cc-native/lib-ts/verdict.ts +72 -72
  122. package/dist/templates/cc-native/_cc-native/workflows/specdev.md +9 -9
  123. package/oclif.manifest.json +1 -1
  124. package/package.json +108 -108
  125. package/dist/templates/cc-native/_cc-native/lib-ts/nul +0 -3
@@ -1,136 +1,136 @@
1
- ---
2
- description: Answer a question using past session transcripts
3
- ---
4
- # RLM Ask — Intelligent Q&A About Past Work
5
-
6
- Ask any question about past Claude Code sessions. Auto-selects the best search method (semantic or keyword) based on available indexes.
7
-
8
- ## Input
9
-
10
- A natural language question. Examples:
11
- - "How did we implement the plan review system?"
12
- - "What approach did we use for hook error handling?"
13
- - "When did we last work on the bridge app?"
14
-
15
- ## Workflow
16
-
17
- ### Step 1: Auto-Index Check
18
- Check if indexes exist, build if missing (one-time setup):
19
- ```bash
20
- INDEX_DIR="$HOME/.claude/rlm-index"
21
- if [ ! -d "$INDEX_DIR" ] || [ -z "$(ls -A $INDEX_DIR 2>/dev/null)" ]; then
22
- echo "🔄 Building indexes (one-time setup, ~10-30s)..."
23
-
24
- # Run indexer with explicit error handling
25
- if ! bun .aiwcli/_cc-native/lib-ts/rlm/transcript-indexer.ts --batch; then
26
- echo ""
27
- echo "❌ Index build failed"
28
- echo ""
29
- echo "Troubleshooting:"
30
- echo "- Check file permissions in ~/.claude/projects/"
31
- echo "- Look for corrupted .jsonl files"
32
- echo "- Try manual rebuild: /rlm:index"
33
- echo ""
34
- exit 1
35
- fi
36
-
37
- echo "✅ Indexes built successfully"
38
- fi
39
- ```
40
-
41
- ### Step 2: Search Strategy Selection
42
- Auto-detect best search method with auto-model-pull:
43
-
44
- ```bash
45
- VECTOR_DB="$HOME/.claude/rlm-vectors.db"
46
- OLLAMA_RUNNING=false
47
- MODEL_PRESENT=false
48
-
49
- # Check if Ollama is running
50
- if curl -s http://localhost:11434/api/tags >/dev/null 2>&1; then
51
- OLLAMA_RUNNING=true
52
-
53
- # Check if nomic-embed-text model is installed
54
- if ollama list | grep -q "nomic-embed-text"; then
55
- MODEL_PRESENT=true
56
- else
57
- echo "📥 Ollama running but nomic-embed-text model missing"
58
- echo "🔄 Downloading model (~400MB, this may take 1-2 minutes)..."
59
-
60
- # Auto-pull model with error handling
61
- if ollama pull nomic-embed-text; then
62
- echo "✅ Model downloaded successfully"
63
- MODEL_PRESENT=true
64
- else
65
- echo "⚠️ Model download failed, falling back to keyword search"
66
- OLLAMA_RUNNING=false
67
- fi
68
- fi
69
- fi
70
-
71
- # Use semantic search if vector DB + Ollama + model available
72
- if [ -f "$VECTOR_DB" ] && [ "$OLLAMA_RUNNING" = true ] && [ "$MODEL_PRESENT" = true ]; then
73
- echo "Using semantic search (vector similarity)..."
74
- SEARCH_RESULTS=$(bun .aiwcli/_cc-native/lib-ts/rlm/retrieval-pipeline.ts "$ARGUMENTS")
75
- else
76
- echo "Using keyword search (weighted scoring)..."
77
- SEARCH_RESULTS=$(bun .aiwcli/_cc-native/lib-ts/rlm/transcript-searcher.ts "$ARGUMENTS" --top=10)
78
- fi
79
- ```
80
-
81
- If zero results, tell the user and suggest refining the query or running `/rlm:index`.
82
-
83
- ### Step 3: Load Transcript Segments
84
- Parse search results and load top N segments (N = result count, capped at 5):
85
-
86
- For each of the top 1-5 results, load the relevant transcript segments:
87
-
88
- ```bash
89
- bun .aiwcli/_cc-native/lib-ts/rlm/transcript-loader.ts "<source_path>" --lines=<start>-<end>
90
- ```
91
-
92
- Use the `matching_segments` from search results to target specific line ranges. If no segments matched, load the first 200 lines.
93
-
94
- ### Step 4: Parallel Analysis
95
- Spawn N parallel sub-agents (Task tool, subagent_type=general-purpose) where N = min(result_count, 5):
96
- - 1 result → 1 agent
97
- - 3 results → 3 agents
98
- - 10 results → 5 agents (capped)
99
-
100
- Each agent analyzes one segment:
101
-
102
- > Given this session transcript segment, extract all information relevant to: **{user's question}**
103
- >
104
- > Include: specific details, code snippets, decisions made, exact quotes, and file paths mentioned.
105
- > Cite line numbers where possible.
106
- >
107
- > Transcript:
108
- > {loaded segment content}
109
-
110
- ### Step 5: Synthesis
111
- Combine findings into a coherent answer:
112
- 1. Group findings by theme/topic
113
- 2. Add citations: "In session {date} (project: {project}): {finding}"
114
- 3. Note contradictions or evolution across sessions
115
- 4. Highlight most recent/relevant information
116
-
117
- ### Output Format
118
- ```
119
- ## Answer: {user's question}
120
-
121
- {Synthesized answer with inline citations}
122
-
123
- ### Sources
124
- | Date | Project | Session | Relevance |
125
- |------|---------|---------|-----------|
126
- | YYYY-MM-DD | project-name | session-id | Brief match reason |
127
- ```
128
-
129
- Always include the sources table. If findings are sparse, say so honestly rather than speculating.
130
-
131
- ## Notes
132
-
133
- - **First run:** Auto-builds indexes (10-30s delay)
134
- - **Semantic search:** Uses vector similarity (higher quality, requires Ollama)
135
- - **Keyword search:** Uses weighted scoring (faster, always available)
136
- - **Graceful fallback:** No Ollama? Automatically uses keyword search
1
+ ---
2
+ description: Answer a question using past session transcripts
3
+ ---
4
+ # RLM Ask — Intelligent Q&A About Past Work
5
+
6
+ Ask any question about past Claude Code sessions. Auto-selects the best search method (semantic or keyword) based on available indexes.
7
+
8
+ ## Input
9
+
10
+ A natural language question. Examples:
11
+ - "How did we implement the plan review system?"
12
+ - "What approach did we use for hook error handling?"
13
+ - "When did we last work on the bridge app?"
14
+
15
+ ## Workflow
16
+
17
+ ### Step 1: Auto-Index Check
18
+ Check if indexes exist, build if missing (one-time setup):
19
+ ```bash
20
+ INDEX_DIR="$HOME/.claude/rlm-index"
21
+ if [ ! -d "$INDEX_DIR" ] || [ -z "$(ls -A $INDEX_DIR 2>/dev/null)" ]; then
22
+ echo "🔄 Building indexes (one-time setup, ~10-30s)..."
23
+
24
+ # Run indexer with explicit error handling
25
+ if ! bun .aiwcli/_cc-native/lib-ts/rlm/transcript-indexer.ts --batch; then
26
+ echo ""
27
+ echo "❌ Index build failed"
28
+ echo ""
29
+ echo "Troubleshooting:"
30
+ echo "- Check file permissions in ~/.claude/projects/"
31
+ echo "- Look for corrupted .jsonl files"
32
+ echo "- Try manual rebuild: /rlm:index"
33
+ echo ""
34
+ exit 1
35
+ fi
36
+
37
+ echo "✅ Indexes built successfully"
38
+ fi
39
+ ```
40
+
41
+ ### Step 2: Search Strategy Selection
42
+ Auto-detect best search method with auto-model-pull:
43
+
44
+ ```bash
45
+ VECTOR_DB="$HOME/.claude/rlm-vectors.db"
46
+ OLLAMA_RUNNING=false
47
+ MODEL_PRESENT=false
48
+
49
+ # Check if Ollama is running
50
+ if curl -s http://localhost:11434/api/tags >/dev/null 2>&1; then
51
+ OLLAMA_RUNNING=true
52
+
53
+ # Check if nomic-embed-text model is installed
54
+ if ollama list | grep -q "nomic-embed-text"; then
55
+ MODEL_PRESENT=true
56
+ else
57
+ echo "📥 Ollama running but nomic-embed-text model missing"
58
+ echo "🔄 Downloading model (~400MB, this may take 1-2 minutes)..."
59
+
60
+ # Auto-pull model with error handling
61
+ if ollama pull nomic-embed-text; then
62
+ echo "✅ Model downloaded successfully"
63
+ MODEL_PRESENT=true
64
+ else
65
+ echo "⚠️ Model download failed, falling back to keyword search"
66
+ OLLAMA_RUNNING=false
67
+ fi
68
+ fi
69
+ fi
70
+
71
+ # Use semantic search if vector DB + Ollama + model available
72
+ if [ -f "$VECTOR_DB" ] && [ "$OLLAMA_RUNNING" = true ] && [ "$MODEL_PRESENT" = true ]; then
73
+ echo "Using semantic search (vector similarity)..."
74
+ SEARCH_RESULTS=$(bun .aiwcli/_cc-native/lib-ts/rlm/retrieval-pipeline.ts "$ARGUMENTS")
75
+ else
76
+ echo "Using keyword search (weighted scoring)..."
77
+ SEARCH_RESULTS=$(bun .aiwcli/_cc-native/lib-ts/rlm/transcript-searcher.ts "$ARGUMENTS" --top=10)
78
+ fi
79
+ ```
80
+
81
+ If zero results, tell the user and suggest refining the query or running `/rlm:index`.
82
+
83
+ ### Step 3: Load Transcript Segments
84
+ Parse search results and load top N segments (N = result count, capped at 5):
85
+
86
+ For each of the top 1-5 results, load the relevant transcript segments:
87
+
88
+ ```bash
89
+ bun .aiwcli/_cc-native/lib-ts/rlm/transcript-loader.ts "<source_path>" --lines=<start>-<end>
90
+ ```
91
+
92
+ Use the `matching_segments` from search results to target specific line ranges. If no segments matched, load the first 200 lines.
93
+
94
+ ### Step 4: Parallel Analysis
95
+ Spawn N parallel sub-agents (Task tool, subagent_type=general-purpose) where N = min(result_count, 5):
96
+ - 1 result → 1 agent
97
+ - 3 results → 3 agents
98
+ - 10 results → 5 agents (capped)
99
+
100
+ Each agent analyzes one segment:
101
+
102
+ > Given this session transcript segment, extract all information relevant to: **{user's question}**
103
+ >
104
+ > Include: specific details, code snippets, decisions made, exact quotes, and file paths mentioned.
105
+ > Cite line numbers where possible.
106
+ >
107
+ > Transcript:
108
+ > {loaded segment content}
109
+
110
+ ### Step 5: Synthesis
111
+ Combine findings into a coherent answer:
112
+ 1. Group findings by theme/topic
113
+ 2. Add citations: "In session {date} (project: {project}): {finding}"
114
+ 3. Note contradictions or evolution across sessions
115
+ 4. Highlight most recent/relevant information
116
+
117
+ ### Output Format
118
+ ```
119
+ ## Answer: {user's question}
120
+
121
+ {Synthesized answer with inline citations}
122
+
123
+ ### Sources
124
+ | Date | Project | Session | Relevance |
125
+ |------|---------|---------|-----------|
126
+ | YYYY-MM-DD | project-name | session-id | Brief match reason |
127
+ ```
128
+
129
+ Always include the sources table. If findings are sparse, say so honestly rather than speculating.
130
+
131
+ ## Notes
132
+
133
+ - **First run:** Auto-builds indexes (10-30s delay)
134
+ - **Semantic search:** Uses vector similarity (higher quality, requires Ollama)
135
+ - **Keyword search:** Uses weighted scoring (faster, always available)
136
+ - **Graceful fallback:** No Ollama? Automatically uses keyword search
@@ -1,21 +1,21 @@
1
- ---
2
- description: Build/refresh the RLM transcript index across all Claude Code sessions
3
- ---
4
- # RLM Index — Build Transcript Index
5
-
6
- Run the TranscriptIndexer to scan all Claude Code session transcripts and build searchable indexes.
7
-
8
- ## Steps
9
-
10
- 1. Run the indexer:
11
- ```bash
12
- bun .aiwcli/_cc-native/lib-ts/rlm/transcript-indexer.ts --batch $ARGUMENTS
13
- ```
14
-
15
- The indexer accepts optional flags:
16
- - `--limit=N` — Index only the first N unindexed sessions
17
- - `--project=<name>` — Only index sessions for projects matching this name (partial match)
18
-
19
- 2. Report the results from the JSON output (indexed count, skipped, errors, total).
20
-
21
- 3. If this is the first run, suggest: "Index is ready. Try `/rlm:search <query>` or `/rlm:recall <question>` to search your session history."
1
+ ---
2
+ description: Build/refresh the RLM transcript index across all Claude Code sessions
3
+ ---
4
+ # RLM Index — Build Transcript Index
5
+
6
+ Run the TranscriptIndexer to scan all Claude Code session transcripts and build searchable indexes.
7
+
8
+ ## Steps
9
+
10
+ 1. Run the indexer:
11
+ ```bash
12
+ bun .aiwcli/_cc-native/lib-ts/rlm/transcript-indexer.ts --batch $ARGUMENTS
13
+ ```
14
+
15
+ The indexer accepts optional flags:
16
+ - `--limit=N` — Index only the first N unindexed sessions
17
+ - `--project=<name>` — Only index sessions for projects matching this name (partial match)
18
+
19
+ 2. Report the results from the JSON output (indexed count, skipped, errors, total).
20
+
21
+ 3. If this is the first run, suggest: "Index is ready. Try `/rlm:search <query>` or `/rlm:recall <question>` to search your session history."
@@ -1,56 +1,56 @@
1
- ---
2
- description: Get a timeline overview of sessions by topic or time range
3
- ---
4
- # RLM Overview — Timeline Summary of Past Work
5
-
6
- Get a grouped timeline summary of sessions matching a topic or time range.
7
-
8
- ## Input
9
-
10
- A topic, project name, or time range. Examples:
11
- - "hook development this week"
12
- - "bridge-practice-app"
13
- - "last 3 days"
14
-
15
- ## Workflow
16
-
17
- ### Step 1: Search
18
- Find matching sessions:
19
- ```bash
20
- bun .aiwcli/_cc-native/lib-ts/rlm/transcript-searcher.ts "$ARGUMENTS" --top=20
21
- ```
22
-
23
- For time-range queries ("this week", "last 3 days"), search with broad terms and filter by date in output.
24
-
25
- ### Step 2: Group
26
- Group results by:
27
- - **Date** (if sessions span multiple days)
28
- - **Project** (if sessions span multiple projects)
29
- - **Theme** (cluster by keywords/summary similarity)
30
-
31
- ### Step 3: Summarize per Group
32
- For each group of 3+ sessions, load excerpts from 2-3 representative sessions:
33
- ```bash
34
- bun .aiwcli/_cc-native/lib-ts/rlm/transcript-loader.ts "<source_path>" --lines=1-100
35
- ```
36
-
37
- Spawn parallel sub-agents (Task tool, subagent_type=general-purpose, model=haiku):
38
-
39
- > Summarize these session excerpts in 2-3 sentences. Focus on: what was built, what decisions were made, what problems were solved.
40
-
41
- ### Step 4: Output
42
- Present a timeline-style summary:
43
-
44
- ```
45
- ## Session Overview: {topic/range}
46
-
47
- ### {Date or Group 1}
48
- - {2-3 sentence summary}
49
- - Sessions: {count} | Project: {name}
50
-
51
- ### {Date or Group 2}
52
- - {2-3 sentence summary}
53
- - Sessions: {count} | Project: {name}
54
-
55
- **Total: {N} sessions across {M} projects**
56
- ```
1
+ ---
2
+ description: Get a timeline overview of sessions by topic or time range
3
+ ---
4
+ # RLM Overview — Timeline Summary of Past Work
5
+
6
+ Get a grouped timeline summary of sessions matching a topic or time range.
7
+
8
+ ## Input
9
+
10
+ A topic, project name, or time range. Examples:
11
+ - "hook development this week"
12
+ - "bridge-practice-app"
13
+ - "last 3 days"
14
+
15
+ ## Workflow
16
+
17
+ ### Step 1: Search
18
+ Find matching sessions:
19
+ ```bash
20
+ bun .aiwcli/_cc-native/lib-ts/rlm/transcript-searcher.ts "$ARGUMENTS" --top=20
21
+ ```
22
+
23
+ For time-range queries ("this week", "last 3 days"), search with broad terms and filter by date in output.
24
+
25
+ ### Step 2: Group
26
+ Group results by:
27
+ - **Date** (if sessions span multiple days)
28
+ - **Project** (if sessions span multiple projects)
29
+ - **Theme** (cluster by keywords/summary similarity)
30
+
31
+ ### Step 3: Summarize per Group
32
+ For each group of 3+ sessions, load excerpts from 2-3 representative sessions:
33
+ ```bash
34
+ bun .aiwcli/_cc-native/lib-ts/rlm/transcript-loader.ts "<source_path>" --lines=1-100
35
+ ```
36
+
37
+ Spawn parallel sub-agents (Task tool, subagent_type=general-purpose, model=haiku):
38
+
39
+ > Summarize these session excerpts in 2-3 sentences. Focus on: what was built, what decisions were made, what problems were solved.
40
+
41
+ ### Step 4: Output
42
+ Present a timeline-style summary:
43
+
44
+ ```
45
+ ## Session Overview: {topic/range}
46
+
47
+ ### {Date or Group 1}
48
+ - {2-3 sentence summary}
49
+ - Sessions: {count} | Project: {name}
50
+
51
+ ### {Date or Group 2}
52
+ - {2-3 sentence summary}
53
+ - Sessions: {count} | Project: {name}
54
+
55
+ **Total: {N} sessions across {M} projects**
56
+ ```
@@ -1,10 +1,10 @@
1
- ---
2
- description: Interview user about a spec file and develop detailed requirements
3
- ---
4
- # Spec Development
5
-
6
- First, ask the user for the path to the spec file they want to develop.
7
-
8
- Then load and execute `_cc-native/workflows/specdev.md`.
9
-
10
- Follow the Clarify → Explore → Write pattern using native tools.
1
+ ---
2
+ description: Interview user about a spec file and develop detailed requirements
3
+ ---
4
+ # Spec Development
5
+
6
+ First, ask the user for the path to the spec file they want to develop.
7
+
8
+ Then load and execute `_cc-native/workflows/specdev.md`.
9
+
10
+ Follow the Clarify → Explore → Write pattern using native tools.
@@ -1,8 +1,8 @@
1
- ---
2
- description: Fix an issue with clarification, exploration, and planning
3
- ---
4
- # Fix Issue
5
-
6
- Load and execute `_cc-native/workflows/fix.md`.
7
-
8
- Follow the Clarify → Explore → Plan → Execute pattern.
1
+ ---
2
+ description: Fix an issue with clarification, exploration, and planning
3
+ ---
4
+ # Fix Issue
5
+
6
+ Load and execute `_cc-native/workflows/fix.md`.
7
+
8
+ Follow the Clarify → Explore → Plan → Execute pattern.
@@ -1,8 +1,8 @@
1
- ---
2
- description: Implement a new feature with discovery and planning
3
- ---
4
- # Implement Feature
5
-
6
- Load and execute `_cc-native/workflows/implement.md`.
7
-
8
- Follow the Clarify → Explore → Plan → Execute pattern.
1
+ ---
2
+ description: Implement a new feature with discovery and planning
3
+ ---
4
+ # Implement Feature
5
+
6
+ Load and execute `_cc-native/workflows/implement.md`.
7
+
8
+ Follow the Clarify → Explore → Plan → Execute pattern.
@@ -1,8 +1,8 @@
1
- ---
2
- description: Research a topic and persist findings
3
- ---
4
- # Research
5
-
6
- Load and execute `_cc-native/workflows/research.md`.
7
-
8
- Follow the Clarify → Explore → Write pattern.
1
+ ---
2
+ description: Research a topic and persist findings
3
+ ---
4
+ # Research
5
+
6
+ Load and execute `_cc-native/workflows/research.md`.
7
+
8
+ Follow the Clarify → Explore → Write pattern.