specweave 1.0.324 → 1.0.326

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 (61) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CLAUDE.md +1 -1
  3. package/bin/specweave.js +2 -2
  4. package/dist/plugins/specweave-github/lib/github-feature-sync.js +2 -2
  5. package/dist/plugins/specweave-github/lib/github-feature-sync.js.map +1 -1
  6. package/dist/src/adapters/claude/README.md +3 -3
  7. package/dist/src/adapters/cursor/README.md +1 -1
  8. package/dist/src/adapters/generic/README.md +1 -1
  9. package/dist/src/cli/helpers/init/plugin-install-flags.d.ts +1 -1
  10. package/dist/src/cli/helpers/init/plugin-install-flags.js +1 -1
  11. package/dist/src/cli/helpers/init/plugin-installer.js +2 -2
  12. package/dist/src/cli/helpers/init/plugin-installer.js.map +1 -1
  13. package/dist/src/config/types.d.ts +2 -2
  14. package/dist/src/core/fabric/registry-schema.d.ts +1 -1
  15. package/dist/src/core/fabric/registry-schema.d.ts.map +1 -1
  16. package/dist/src/core/hooks/project-scope-guard.d.ts +1 -1
  17. package/dist/src/core/hooks/project-scope-guard.d.ts.map +1 -1
  18. package/dist/src/core/hooks/project-scope-guard.js +9 -4
  19. package/dist/src/core/hooks/project-scope-guard.js.map +1 -1
  20. package/dist/src/core/lazy-loading/llm-plugin-detector.d.ts +25 -23
  21. package/dist/src/core/lazy-loading/llm-plugin-detector.d.ts.map +1 -1
  22. package/dist/src/core/lazy-loading/llm-plugin-detector.js +77 -39
  23. package/dist/src/core/lazy-loading/llm-plugin-detector.js.map +1 -1
  24. package/dist/src/core/living-docs/scaffolding/scaffold.js +1 -1
  25. package/dist/src/core/session/handoff-context.d.ts +2 -2
  26. package/dist/src/core/session/handoff-context.js +28 -28
  27. package/dist/src/core/session/handoff-context.js.map +1 -1
  28. package/dist/src/core/session/plugin-install-detector.d.ts +2 -2
  29. package/dist/src/core/session/plugin-install-detector.js +3 -3
  30. package/dist/src/core/session/restart-warning.d.ts +2 -2
  31. package/dist/src/core/session/restart-warning.d.ts.map +1 -1
  32. package/dist/src/core/session/restart-warning.js +20 -21
  33. package/dist/src/core/session/restart-warning.js.map +1 -1
  34. package/dist/src/core/session/session-state.d.ts +1 -1
  35. package/dist/src/core/session/session-state.js +1 -1
  36. package/dist/src/core/types/plugin-scope.d.ts +2 -2
  37. package/dist/src/core/types/plugin-scope.js +1 -1
  38. package/dist/src/init/research/types.d.ts +1 -1
  39. package/dist/src/locales/en/cli.json +1 -1
  40. package/dist/src/locales/ru/cli.json +1 -1
  41. package/package.json +1 -1
  42. package/plugins/FINAL-AUDIT-RECOMMENDATIONS.md +3 -3
  43. package/plugins/SKILLS-VS-AGENTS.md +13 -13
  44. package/plugins/specweave/commands/team-status.md +1 -1
  45. package/plugins/specweave/hooks/user-prompt-submit.sh +22 -17
  46. package/plugins/specweave/hooks/v2/dispatchers/session-start.sh +2 -2
  47. package/plugins/specweave/skills/architect/SKILL.md +2 -2
  48. package/plugins/specweave/skills/team-build/SKILL.md +7 -7
  49. package/plugins/specweave/skills/team-lead/SKILL.md +17 -17
  50. package/plugins/specweave-docs/.claude-plugin/plugin.json +1 -1
  51. package/plugins/specweave-docs/PLUGIN.md +1 -1
  52. package/plugins/specweave-docs/commands/build.md +7 -7
  53. package/plugins/specweave-docs/commands/generate.md +21 -21
  54. package/plugins/specweave-docs/commands/health.md +9 -9
  55. package/plugins/specweave-docs/commands/init.md +8 -8
  56. package/plugins/specweave-docs/commands/organize.md +9 -9
  57. package/plugins/specweave-docs/commands/validate.md +8 -8
  58. package/plugins/specweave-docs/commands/view.md +13 -13
  59. package/plugins/specweave-github/lib/github-feature-sync.js +1 -1
  60. package/plugins/specweave-github/lib/github-feature-sync.ts +2 -2
  61. package/src/templates/CLAUDE.md.template +3 -3
@@ -9,34 +9,34 @@ Generate documentation automatically from TypeScript/JavaScript code, OpenAPI sp
9
9
  ## Usage
10
10
 
11
11
  ```
12
- /sw-docs:generate <source-type> <path> [options]
12
+ /docs:generate <source-type> <path> [options]
13
13
  ```
14
14
 
15
15
  ## Source Types
16
16
 
17
17
  ### 1. TypeScript/JavaScript Code
18
18
  ```bash
19
- /sw-docs:docs-generate code ./src \
19
+ /docs:docs-generate code ./src \
20
20
  --output ./docs/api \
21
21
  --format markdown
22
22
  ```
23
23
 
24
24
  ### 2. OpenAPI/Swagger Specs
25
25
  ```bash
26
- /sw-docs:docs-generate openapi ./api/openapi.yaml \
26
+ /docs:docs-generate openapi ./api/openapi.yaml \
27
27
  --output ./docs/api \
28
28
  --interactive
29
29
  ```
30
30
 
31
31
  ### 3. GraphQL Schema
32
32
  ```bash
33
- /sw-docs:docs-generate graphql ./schema.graphql \
33
+ /docs:docs-generate graphql ./schema.graphql \
34
34
  --output ./docs/graphql
35
35
  ```
36
36
 
37
37
  ### 4. SpecWeave Living Docs
38
38
  ```bash
39
- /sw-docs:docs-generate specweave ./.specweave/docs \
39
+ /docs:docs-generate specweave ./.specweave/docs \
40
40
  --output ./docs/specs \
41
41
  --include features,modules,architecture
42
42
  ```
@@ -286,7 +286,7 @@ new {{name}}({{#each constructorParams}}{{name}}: {{type}}{{#unless @last}}, {{/
286
286
 
287
287
  Auto-regenerate on file changes:
288
288
  ```bash
289
- /sw-docs:docs-generate code ./src --watch
289
+ /docs:docs-generate code ./src --watch
290
290
  ```
291
291
 
292
292
  ### CI/CD Integration
@@ -310,7 +310,7 @@ jobs:
310
310
  - name: Generate API docs
311
311
  run: |
312
312
  npm install
313
- npx claude /sw-docs:docs-generate code ./src
313
+ npx claude /docs:docs-generate code ./src
314
314
  - name: Deploy to GitHub Pages
315
315
  uses: peaceiris/actions-gh-pages@v3
316
316
  with:
@@ -356,9 +356,9 @@ export function transformNode(node: DocNode): DocNode {
356
356
 
357
357
  ```bash
358
358
  # Generate from multiple sources
359
- /sw-docs:docs-generate code ./src --output ./docs/api
360
- /sw-docs:docs-generate openapi ./api/openapi.yaml --output ./docs/api
361
- /sw-docs:docs-generate specweave ./.specweave/docs --output ./docs/specs
359
+ /docs:docs-generate code ./src --output ./docs/api
360
+ /docs:docs-generate openapi ./api/openapi.yaml --output ./docs/api
361
+ /docs:docs-generate specweave ./.specweave/docs --output ./docs/specs
362
362
 
363
363
  # Combine all outputs
364
364
  cat ./docs/api/index.md ./docs/specs/index.md > ./docs/complete-reference.md
@@ -368,16 +368,16 @@ cat ./docs/api/index.md ./docs/specs/index.md > ./docs/complete-reference.md
368
368
 
369
369
  ```bash
370
370
  # Generate docs in multiple languages
371
- /sw-docs:docs-generate code ./src --output ./docs/en --lang en
372
- /sw-docs:docs-generate code ./src --output ./docs/es --lang es
373
- /sw-docs:docs-generate code ./src --output ./docs/fr --lang fr
371
+ /docs:docs-generate code ./src --output ./docs/en --lang en
372
+ /docs:docs-generate code ./src --output ./docs/es --lang es
373
+ /docs:docs-generate code ./src --output ./docs/fr --lang fr
374
374
  ```
375
375
 
376
376
  ## Examples
377
377
 
378
378
  ### Generate TypeScript API Docs
379
379
  ```bash
380
- /sw-docs:docs-generate code ./src/api \
380
+ /docs:docs-generate code ./src/api \
381
381
  --output ./docs/api-reference \
382
382
  --exclude "**/*.test.ts" \
383
383
  --include-examples
@@ -385,7 +385,7 @@ cat ./docs/api/index.md ./docs/specs/index.md > ./docs/complete-reference.md
385
385
 
386
386
  ### Generate OpenAPI Docs with Playground
387
387
  ```bash
388
- /sw-docs:docs-generate openapi ./api/v1/openapi.yaml \
388
+ /docs:docs-generate openapi ./api/v1/openapi.yaml \
389
389
  --output ./docs/api/v1 \
390
390
  --interactive \
391
391
  --group-by tag
@@ -393,7 +393,7 @@ cat ./docs/api/index.md ./docs/specs/index.md > ./docs/complete-reference.md
393
393
 
394
394
  ### Generate SpecWeave Architecture Docs
395
395
  ```bash
396
- /sw-docs:docs-generate specweave ./.specweave/docs \
396
+ /docs:docs-generate specweave ./.specweave/docs \
397
397
  --output ./docs/architecture \
398
398
  --include architecture,modules \
399
399
  --format-adrs
@@ -401,14 +401,14 @@ cat ./docs/api/index.md ./docs/specs/index.md > ./docs/complete-reference.md
401
401
 
402
402
  ### Watch Mode for Development
403
403
  ```bash
404
- /sw-docs:docs-generate code ./src --watch
404
+ /docs:docs-generate code ./src --watch
405
405
  ```
406
406
 
407
407
  ## Related Commands
408
408
 
409
- - `/sw-docs:init` - Initialize Docusaurus documentation site
410
- - `/sw-docs:view` - View generated documentation
411
- - `/sw-docs:build` - Build static site from generated docs
409
+ - `/docs:init` - Initialize Docusaurus documentation site
410
+ - `/docs:view` - View generated documentation
411
+ - `/docs:build` - Build static site from generated docs
412
412
 
413
413
  ## Requirements
414
414
 
@@ -435,7 +435,7 @@ npm install --save-dev typedoc typedoc-plugin-markdown @redocly/cli
435
435
  ```bash
436
436
  # Increase Node.js memory
437
437
  NODE_OPTIONS="--max-old-space-size=4096" \
438
- /sw-docs:docs-generate code ./src
438
+ /docs:docs-generate code ./src
439
439
  ```
440
440
 
441
441
  ### Broken Links in Generated Docs
@@ -10,16 +10,16 @@ Analyze your documentation for health issues including freshness, coverage, nami
10
10
 
11
11
  ```bash
12
12
  # Full health report
13
- /sw-docs:health
13
+ /docs:health
14
14
 
15
15
  # Include archived documents
16
- /sw-docs:health --include-archived
16
+ /docs:health --include-archived
17
17
 
18
18
  # Output as JSON
19
- /sw-docs:health --format json
19
+ /docs:health --format json
20
20
 
21
21
  # Save report to file
22
- /sw-docs:health --output health-report.md
22
+ /docs:health --output health-report.md
23
23
  ```
24
24
 
25
25
  ## Your Task
@@ -187,7 +187,7 @@ Actionable suggestions based on analysis:
187
187
  - Add acceptance criteria
188
188
  - Fix naming conventions
189
189
  - Consolidate duplicates
190
- - Run `/sw-docs:organize` for large folders
190
+ - Run `/docs:organize` for large folders
191
191
 
192
192
  ## Output Example
193
193
 
@@ -220,7 +220,7 @@ RECOMMENDATIONS
220
220
  • Documentation coverage is limited. Add acceptance criteria to more documents.
221
221
  • 8 files use ALL CAPS naming. Rename to lowercase-kebab-case.
222
222
  • 3 sets of duplicate documents detected. Consider consolidating.
223
- • "ADRs" has 147 files. Run /sw-docs:organize to generate themed indexes.
223
+ • "ADRs" has 147 files. Run /docs:organize to generate themed indexes.
224
224
 
225
225
  Full report saved to: .specweave/docs/ENTERPRISE-HEALTH.md
226
226
  ```
@@ -262,6 +262,6 @@ jobs:
262
262
 
263
263
  ## See Also
264
264
 
265
- - `/sw-docs:organize` - Organize large folders with themed indexes
266
- - `/sw-docs:view` - View documentation with Docusaurus
267
- - `/sw-docs:generate` - Generate docs from code
265
+ - `/docs:organize` - Organize large folders with themed indexes
266
+ - `/docs:view` - View documentation with Docusaurus
267
+ - `/docs:generate` - Generate docs from code
@@ -9,7 +9,7 @@ Initialize a Docusaurus documentation site with spec-driven documentation struct
9
9
  ## Usage
10
10
 
11
11
  ```
12
- /sw-docs:init [options]
12
+ /docs:init [options]
13
13
  ```
14
14
 
15
15
  ## What I Do
@@ -287,29 +287,29 @@ themeConfig: {
287
287
 
288
288
  ### Basic Initialization
289
289
  ```bash
290
- /sw-docs:docs-init
290
+ /docs:docs-init
291
291
  ```
292
292
 
293
293
  ### TypeScript with Mermaid
294
294
  ```bash
295
- /sw-docs:docs-init --typescript --mermaid
295
+ /docs:docs-init --typescript --mermaid
296
296
  ```
297
297
 
298
298
  ### Material Theme with Versioning
299
299
  ```bash
300
- /sw-docs:docs-init --template material --versioning
300
+ /docs:docs-init --template material --versioning
301
301
  ```
302
302
 
303
303
  ### Custom Output Directory
304
304
  ```bash
305
- /sw-docs:init --output ./documentation
305
+ /docs:init --output ./documentation
306
306
  ```
307
307
 
308
308
  ## Related Commands
309
309
 
310
- - `/sw-docs:generate` - Generate docs from code/specs
311
- - `/sw-docs:view` - Launch documentation server
312
- - `/sw-docs:build` - Build static documentation site
310
+ - `/docs:generate` - Generate docs from code/specs
311
+ - `/docs:view` - Launch documentation server
312
+ - `/docs:build` - Build static documentation site
313
313
 
314
314
  ## Requirements
315
315
 
@@ -19,19 +19,19 @@ When folders grow beyond 30+ files, navigation becomes painful:
19
19
 
20
20
  ```bash
21
21
  # Analyze and organize all internal docs
22
- /sw-docs:organize
22
+ /docs:organize
23
23
 
24
24
  # Analyze specific folder only
25
- /sw-docs:organize --folder architecture/adr
25
+ /docs:organize --folder architecture/adr
26
26
 
27
27
  # Preview without generating files
28
- /sw-docs:organize --dry-run
28
+ /docs:organize --dry-run
29
29
 
30
30
  # Force regeneration even if under threshold
31
- /sw-docs:organize --force
31
+ /docs:organize --force
32
32
 
33
33
  # Set custom threshold (default: 30)
34
- /sw-docs:organize --threshold 20
34
+ /docs:organize --threshold 20
35
35
  ```
36
36
 
37
37
  ## Your Task
@@ -160,7 +160,7 @@ Generated 9 index files:
160
160
  After running this command, use:
161
161
 
162
162
  ```bash
163
- /sw-docs:view
163
+ /docs:view
164
164
  ```
165
165
 
166
166
  The generated indexes will appear in the sidebar:
@@ -178,6 +178,6 @@ The generated indexes will appear in the sidebar:
178
178
 
179
179
  ## See Also
180
180
 
181
- - `/sw-docs:view` - View documentation with Docusaurus
182
- - `/sw-docs:build` - Build static documentation site
183
- - `/sw-docs:health` - Documentation health report
181
+ - `/docs:view` - View documentation with Docusaurus
182
+ - `/docs:build` - Build static documentation site
183
+ - `/docs:health` - Documentation health report
@@ -19,16 +19,16 @@ This validator catches these issues **before** you see webpack errors.
19
19
 
20
20
  ```bash
21
21
  # Validate internal docs (default)
22
- /sw-docs:validate
22
+ /docs:validate
23
23
 
24
24
  # Validate with auto-fix
25
- /sw-docs:validate --fix
25
+ /docs:validate --fix
26
26
 
27
27
  # Validate public docs
28
- /sw-docs:validate public
28
+ /docs:validate public
29
29
 
30
30
  # Validate specific path
31
- /sw-docs:validate --path .specweave/docs/internal/specs
31
+ /docs:validate --path .specweave/docs/internal/specs
32
32
  ```
33
33
 
34
34
  ## Your Task
@@ -131,7 +131,7 @@ ERRORS (must fix):
131
131
  QUICK FIXES:
132
132
  ───────────────────────────────────────────────────────────────
133
133
  1. Run validation with auto-fix:
134
- /sw-docs:validate --fix
134
+ /docs:validate --fix
135
135
 
136
136
  2. Or fix manually:
137
137
  • YAML: Wrap values with colons in quotes
@@ -244,6 +244,6 @@ onBrokenMarkdownLinks: 'warn',
244
244
 
245
245
  ## See Also
246
246
 
247
- - `/sw-docs:view` - View docs (runs validation first)
248
- - `/sw-docs:build` - Build docs (runs validation first)
249
- - `/sw-docs:health` - Full documentation health report
247
+ - `/docs:view` - View docs (runs validation first)
248
+ - `/docs:build` - Build docs (runs validation first)
249
+ - `/docs:health` - Full documentation health report
@@ -12,11 +12,11 @@ Launch Docusaurus development server with hot reload, Mermaid diagrams, and auto
12
12
 
13
13
  ```bash
14
14
  # View internal docs (default) - port 3015
15
- /sw-docs:view
15
+ /docs:view
16
16
 
17
17
  # View public docs - port 3016
18
- /sw-docs:view --public
19
- /sw-docs:view public
18
+ /docs:view --public
19
+ /docs:view public
20
20
  ```
21
21
 
22
22
  ## Your Task
@@ -315,7 +315,7 @@ After starting, display:
315
315
  ### View Internal Docs (Default)
316
316
 
317
317
  ```bash
318
- /sw-docs:view
318
+ /docs:view
319
319
 
320
320
  # Output:
321
321
  📚 Starting Internal Documentation server...
@@ -331,7 +331,7 @@ After starting, display:
331
331
  ### View Public Docs
332
332
 
333
333
  ```bash
334
- /sw-docs:view --public
334
+ /docs:view --public
335
335
 
336
336
  # Output:
337
337
  📚 Starting Public Documentation server...
@@ -349,10 +349,10 @@ After starting, display:
349
349
  Run in separate terminals:
350
350
  ```bash
351
351
  # Terminal 1: Internal docs
352
- /sw-docs:view
352
+ /docs:view
353
353
 
354
354
  # Terminal 2: Public docs
355
- /sw-docs:view --public
355
+ /docs:view --public
356
356
 
357
357
  # Now both servers are running!
358
358
  # Internal: http://localhost:3015
@@ -373,10 +373,10 @@ lsof -i :3016 && kill -9 $(lsof -t -i :3016)
373
373
  ### Reinstall from scratch
374
374
  ```bash
375
375
  # For internal docs
376
- rm -rf .specweave/cache/docs-site && /sw-docs:view
376
+ rm -rf .specweave/cache/docs-site && /docs:view
377
377
 
378
378
  # For public docs
379
- rm -rf .specweave/cache/docs-site-public && /sw-docs:view --public
379
+ rm -rf .specweave/cache/docs-site-public && /docs:view --public
380
380
  ```
381
381
 
382
382
  ### npm registry issues
@@ -384,7 +384,7 @@ The setup uses `--registry=https://registry.npmjs.org` to bypass private registr
384
384
 
385
385
  ## See Also
386
386
 
387
- - `/sw-docs:build` - Build static site for deployment
388
- - `/sw-docs:organize` - Generate themed indexes for large folders
389
- - `/sw-docs:health` - Documentation health report
390
- - `/sw-docs:validate` - Validate documentation without starting server
387
+ - `/docs:build` - Build static site for deployment
388
+ - `/docs:organize` - Generate themed indexes for large folders
389
+ - `/docs:health` - Documentation health report
390
+ - `/docs:validate` - Validate documentation without starting server
@@ -331,7 +331,7 @@ const _GitHubFeatureSync = class _GitHubFeatureSync {
331
331
  */
332
332
  buildFeatureMd(featureId, title, status, priority, created, incrementId, userStories) {
333
333
  const now = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
334
- const mappedStatus = status === "planned" ? "planning" : status === "completed" || status === "done" ? "complete" : status === "active" || status === "in-progress" ? "active" : "planning";
334
+ const mappedStatus = status === "planned" ? "planning" : status === "completed" ? "complete" : status === "active" ? "active" : "planning";
335
335
  const fm = {
336
336
  id: featureId,
337
337
  title,
@@ -552,8 +552,8 @@ export class GitHubFeatureSync {
552
552
  ): string {
553
553
  const now = new Date().toISOString().split('T')[0];
554
554
  const mappedStatus = status === 'planned' ? 'planning'
555
- : status === 'completed' || status === 'done' ? 'complete'
556
- : status === 'active' || status === 'in-progress' ? 'active'
555
+ : status === 'completed' ? 'complete'
556
+ : status === 'active' ? 'active'
557
557
  : 'planning';
558
558
 
559
559
  const fm: Record<string, unknown> = {
@@ -21,11 +21,11 @@
21
21
  **Invoke**: `/skill-name` | auto-trigger by keywords | `Skill({ skill: "name" })`
22
22
  **Parallel work**: Append "use subagents" to requests
23
23
 
24
- **Key skills**: `sw:pm`, `sw:architect`, `sw:grill`, `sw:tdd-cycle`, `sw-frontend:*`, `sw-backend:*`, `sw-testing:*`
24
+ **Key skills**: `sw:pm`, `sw:architect`, `sw:grill`, `sw:tdd-cycle`, `frontend:*`, `backend:*`, `testing:*`
25
25
 
26
26
  **Skill chaining** — skills are NOT "one and done":
27
27
  1. **Planning**: `sw:pm` (specs) → `sw:architect` (design)
28
- 2. **Implementation**: Invoke domain skill per tech (React → `sw-frontend:frontend-architect`, .NET → `sw-backend:dotnet-backend`, Stripe → `sw-payments:stripe-integration`, etc.)
28
+ 2. **Implementation**: Invoke domain skill per tech (React → `frontend:architect`, .NET → `backend:dotnet`, Stripe → `payments:payment-core`, etc.)
29
29
  3. **Closure**: `sw:grill` runs automatically via `/sw:done`
30
30
 
31
31
  If auto-activation fails, invoke explicitly: `Skill({ skill: "name" })`
@@ -219,7 +219,7 @@ When `testing.defaultTestMode: "TDD"` in config.json: RED→GREEN→REFACTOR. Us
219
219
  <!-- SECTION:lazyloading -->
220
220
  ## Plugin Auto-Loading
221
221
 
222
- Plugins load automatically. Manual: `vskill add specweave --plugin sw-frontend`. Disable: `export SPECWEAVE_DISABLE_AUTO_LOAD=1`
222
+ Plugins load automatically. Manual: `vskill install --repo anton-abyzov/vskill --plugin frontend`. Disable: `export SPECWEAVE_DISABLE_AUTO_LOAD=1`
223
223
  <!-- /SECTION -->
224
224
 
225
225
  <!-- SECTION:principles -->