specweave 1.0.269 → 1.0.270

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.
package/CLAUDE.md CHANGED
@@ -1,16 +1,16 @@
1
- <!-- SW:META template="claude" version="1.0.268" sections="header,lsp,start,autodetect,metarule,rules,workflow,reflect,context,structure,taskformat,secrets,syncing,testing,tdd,api,limits,troubleshooting,lazyloading,principles,linking,mcp,auto,docs" -->
1
+ <!-- SW:META template="claude" version="1.0.269" sections="header,lsp,start,autodetect,metarule,rules,workflow,reflect,context,structure,taskformat,secrets,syncing,testing,tdd,api,limits,troubleshooting,lazyloading,principles,linking,mcp,auto,docs" -->
2
2
 
3
- <!-- SW:SECTION:header version="1.0.268" -->
3
+ <!-- SW:SECTION:header version="1.0.269" -->
4
4
  **Framework**: SpecWeave | **Truth**: `spec.md` + `tasks.md`
5
5
  <!-- SW:END:header -->
6
6
 
7
- <!-- SW:SECTION:lsp version="1.0.268" -->
7
+ <!-- SW:SECTION:lsp version="1.0.269" -->
8
8
  ## LSP (Code Intelligence)
9
9
 
10
10
  **Native LSP broken in v2.1.0+.** Use: `specweave lsp refs|def|hover src/file.ts SymbolName`
11
11
  <!-- SW:END:lsp -->
12
12
 
13
- <!-- SW:SECTION:start version="1.0.268" -->
13
+ <!-- SW:SECTION:start version="1.0.269" -->
14
14
  ## Getting Started
15
15
 
16
16
  **Initial increment**: `0001-project-setup` (auto-created by `specweave init`)
@@ -20,7 +20,7 @@
20
20
  2. **Customize**: Edit spec.md and use for setup tasks
21
21
  <!-- SW:END:start -->
22
22
 
23
- <!-- SW:SECTION:autodetect version="1.0.268" -->
23
+ <!-- SW:SECTION:autodetect version="1.0.269" -->
24
24
  ## Auto-Detection
25
25
 
26
26
  SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
@@ -30,7 +30,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
30
30
  **Opt-out phrases**: "Just brainstorm first" | "Don't plan yet" | "Quick discussion" | "Let's explore ideas"
31
31
  <!-- SW:END:autodetect -->
32
32
 
33
- <!-- SW:SECTION:metarule version="1.0.268" -->
33
+ <!-- SW:SECTION:metarule version="1.0.269" -->
34
34
  ## Workflow Orchestration
35
35
 
36
36
  ### 1. Plan Mode Default
@@ -57,7 +57,7 @@ Good: npm run build → node script.js → Success
57
57
  ```
58
58
  <!-- SW:END:metarule -->
59
59
 
60
- <!-- SW:SECTION:rules version="1.0.268" -->
60
+ <!-- SW:SECTION:rules version="1.0.269" -->
61
61
  ## Rules
62
62
 
63
63
  1. **Files** → `.specweave/increments/####-name/` (see Structure section for details)
@@ -73,7 +73,7 @@ Good: npm run build → node script.js → Success
73
73
  8. **Multi-repo**: ALL repos MUST be at `repositories/{org}/{repo-name}/` — NEVER directly under `repositories/`
74
74
  <!-- SW:END:rules -->
75
75
 
76
- <!-- SW:SECTION:workflow version="1.0.268" -->
76
+ <!-- SW:SECTION:workflow version="1.0.269" -->
77
77
  ## Workflow
78
78
 
79
79
  `/sw:increment "X"` → `/sw:do` → `/sw:progress` → `/sw:done 0001`
@@ -93,7 +93,7 @@ Good: npm run build → node script.js → Success
93
93
  **Natural language**: "Let's build X" → `/sw:increment` | "What's status?" → `/sw:progress` | "We're done" → `/sw:done` | "Ship while sleeping" → `/sw:auto`
94
94
  <!-- SW:END:workflow -->
95
95
 
96
- <!-- SW:SECTION:reflect version="1.0.268" -->
96
+ <!-- SW:SECTION:reflect version="1.0.269" -->
97
97
  ## Skill Memories
98
98
 
99
99
  SpecWeave learns from corrections. Learnings saved here automatically. Edit or delete as needed.
@@ -101,7 +101,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
101
101
  **Disable**: Set `"reflect": { "enabled": false }` in `.specweave/config.json`
102
102
  <!-- SW:END:reflect -->
103
103
 
104
- <!-- SW:SECTION:context version="1.0.268" -->
104
+ <!-- SW:SECTION:context version="1.0.269" -->
105
105
  ## Context
106
106
 
107
107
  **Before implementing**: Check ADRs at `.specweave/docs/internal/architecture/adr/`
@@ -109,7 +109,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
109
109
  **Load context**: `/sw:docs <topic>` loads relevant living docs into conversation
110
110
  <!-- SW:END:context -->
111
111
 
112
- <!-- SW:SECTION:structure version="1.0.268" -->
112
+ <!-- SW:SECTION:structure version="1.0.269" -->
113
113
  ## Structure
114
114
 
115
115
  ```
@@ -124,7 +124,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
124
124
  **Everything else → subfolders**: `reports/` | `logs/` | `scripts/` | `backups/`
125
125
  <!-- SW:END:structure -->
126
126
 
127
- <!-- SW:SECTION:taskformat version="1.0.268" -->
127
+ <!-- SW:SECTION:taskformat version="1.0.269" -->
128
128
  ## Task Format
129
129
 
130
130
  ```markdown
@@ -134,41 +134,41 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
134
134
  ```
135
135
  <!-- SW:END:taskformat -->
136
136
 
137
- <!-- SW:SECTION:secrets version="1.0.268" -->
137
+ <!-- SW:SECTION:secrets version="1.0.269" -->
138
138
  ## Secrets
139
139
 
140
140
  Before CLI tools, check existing config (`grep -q` only — never display values).
141
141
  <!-- SW:END:secrets -->
142
142
 
143
- <!-- SW:SECTION:syncing version="1.0.268" -->
143
+ <!-- SW:SECTION:syncing version="1.0.269" -->
144
144
  ## External Sync
145
145
 
146
146
  Primary: `/sw:progress-sync`. Individual: `/sw-github:push`, `/sw-github:close`. Mapping: Feature→Milestone | Story→Issue | Task→Checkbox.
147
147
  <!-- SW:END:syncing -->
148
148
 
149
- <!-- SW:SECTION:testing version="1.0.268" -->
149
+ <!-- SW:SECTION:testing version="1.0.269" -->
150
150
  ## Testing
151
151
 
152
152
  BDD in tasks.md | Unit >80% | `.test.ts` (Vitest) | ESM mocking: `vi.hoisted()` + `vi.mock()`
153
153
  <!-- SW:END:testing -->
154
154
 
155
- <!-- SW:SECTION:tdd version="1.0.268" -->
155
+ <!-- SW:SECTION:tdd version="1.0.269" -->
156
156
  ## TDD
157
157
 
158
158
  When `testing.defaultTestMode: "TDD"` in config.json: RED→GREEN→REFACTOR. Use `/sw:tdd-cycle`. Enforcement via `testing.tddEnforcement` (strict|warn|off).
159
159
  <!-- SW:END:tdd -->
160
160
 
161
- <!-- SW:SECTION:api version="1.0.268" -->
161
+ <!-- SW:SECTION:api version="1.0.269" -->
162
162
  <!-- API: Enable `apiDocs` in config.json. Commands: /sw:api-docs -->
163
163
  <!-- SW:END:api -->
164
164
 
165
- <!-- SW:SECTION:limits version="1.0.268" -->
165
+ <!-- SW:SECTION:limits version="1.0.269" -->
166
166
  ## Limits
167
167
 
168
168
  **Max 1500 lines/file** — extract before adding
169
169
  <!-- SW:END:limits -->
170
170
 
171
- <!-- SW:SECTION:troubleshooting version="1.0.268" -->
171
+ <!-- SW:SECTION:troubleshooting version="1.0.269" -->
172
172
  ## Troubleshooting
173
173
 
174
174
  | Issue | Fix |
@@ -179,13 +179,13 @@ When `testing.defaultTestMode: "TDD"` in config.json: RED→GREEN→REFACTOR. Us
179
179
  | Session stuck | `rm -f .specweave/state/*.lock` + restart |
180
180
  <!-- SW:END:troubleshooting -->
181
181
 
182
- <!-- SW:SECTION:lazyloading version="1.0.268" -->
182
+ <!-- SW:SECTION:lazyloading version="1.0.269" -->
183
183
  ## Plugin Auto-Loading
184
184
 
185
185
  Plugins load automatically. Manual: `claude plugin install sw-frontend@specweave`. Disable: `export SPECWEAVE_DISABLE_AUTO_LOAD=1`
186
186
  <!-- SW:END:lazyloading -->
187
187
 
188
- <!-- SW:SECTION:principles version="1.0.268" -->
188
+ <!-- SW:SECTION:principles version="1.0.269" -->
189
189
  ## Principles
190
190
 
191
191
  1. **Spec-first**: `/sw:increment` before coding
@@ -194,7 +194,7 @@ Plugins load automatically. Manual: `claude plugin install sw-frontend@specweave
194
194
  4. **No Laziness**: Root causes, senior standards
195
195
  <!-- SW:END:principles -->
196
196
 
197
- <!-- SW:SECTION:linking version="1.0.268" -->
197
+ <!-- SW:SECTION:linking version="1.0.269" -->
198
198
  ## Bidirectional Linking
199
199
 
200
200
  Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
@@ -202,13 +202,13 @@ Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
202
202
  Task format: `**AC**: AC-US1-01, AC-US1-02` (CRITICAL for linking)
203
203
  <!-- SW:END:linking -->
204
204
 
205
- <!-- SW:SECTION:mcp version="1.0.268" -->
205
+ <!-- SW:SECTION:mcp version="1.0.269" -->
206
206
  ## External Services
207
207
 
208
208
  CLI tools first (`gh`, `wrangler`, `supabase`) → MCP for complex integrations.
209
209
  <!-- SW:END:mcp -->
210
210
 
211
- <!-- SW:SECTION:auto version="1.0.268" -->
211
+ <!-- SW:SECTION:auto version="1.0.269" -->
212
212
  ## Auto Mode
213
213
 
214
214
  `/sw:auto` (start) | `/sw:auto-status` (check) | `/sw:cancel-auto` (emergency)
@@ -216,7 +216,7 @@ CLI tools first (`gh`, `wrangler`, `supabase`) → MCP for complex integrations.
216
216
  Pattern: IMPLEMENT → TEST → FAIL? → FIX → PASS → NEXT. STOP & ASK if spec conflicts or ambiguity.
217
217
  <!-- SW:END:auto -->
218
218
 
219
- <!-- SW:SECTION:docs version="1.0.268" -->
219
+ <!-- SW:SECTION:docs version="1.0.269" -->
220
220
  ## Docs
221
221
 
222
222
  [spec-weave.com](https://spec-weave.com)