sdtk-kit 0.3.0 → 0.3.1

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 (7) hide show
  1. package/assets/manifest/toolkit-bundle.manifest.json +8 -8
  2. package/assets/manifest/toolkit-bundle.sha256.txt +3 -3
  3. package/assets/toolkit/toolkit/scripts/init-feature.ps1 +9 -1
  4. package/assets/toolkit/toolkit/templates/README.md +6 -0
  5. package/assets/toolkit/toolkit/templates/docs/design/DESIGN_LAYOUT_TEMPLATE.md +1 -1
  6. package/package.json +1 -1
  7. package/src/commands/help.js +7 -1
package/assets/manifest/toolkit-bundle.manifest.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "buildTimestamp": "2026-03-01T02:47:01Z",
2
+ "buildTimestamp": "2026-03-03T01:05:51Z",
3
3
  "files": [
4
4
  {
5
5
  "path": "toolkit/AGENTS.md",
@@ -23,8 +23,8 @@
23
23
  },
24
24
  {
25
25
  "path": "toolkit/scripts/init-feature.ps1",
26
- "sha256": "4e44c36964f1933e09aaa92ac9764d5eb7f39dfa00a0ce7d5a649d217f848b04",
27
- "size": 10047
26
+ "sha256": "5c1f5442fd3c26b8bf62db4b25e9f1c4207258c7fe52f12ed533968f77dfbf65",
27
+ "size": 10557
28
28
  },
29
29
  {
30
30
  "path": "toolkit/scripts/install-codex-skills.ps1",
@@ -228,7 +228,7 @@
228
228
  },
229
229
  {
230
230
  "path": "toolkit/templates/docs/design/DESIGN_LAYOUT_TEMPLATE.md",
231
- "sha256": "fdc466bdf39a3678e8e3ef005cb3416eedacf681c2d56edbe17e9dfb22db21fd",
231
+ "sha256": "26fc80a5bced4b67debea943a49c729532a576146a81994f7e28615c3debe681",
232
232
  "size": 845
233
233
  },
234
234
  {
@@ -288,8 +288,8 @@
288
288
  },
289
289
  {
290
290
  "path": "toolkit/templates/README.md",
291
- "sha256": "065b5b536aa7adc7447b54d862ff41340b38d7cbf8f1e4b4fed69abcb45a97a9",
292
- "size": 2151
291
+ "sha256": "cec5f33d6d6eb4bb31ef2e30f2ace75985aa9eb32bc8c9a760c7464bf5d9bfac",
292
+ "size": 2522
293
293
  },
294
294
  {
295
295
  "path": "toolkit/templates/SHARED_PLANNING.md",
@@ -297,7 +297,7 @@
297
297
  "size": 3255
298
298
  }
299
299
  ],
300
- "sourceCommit": "23d2a15f3107eecec328abe120de2d1d8f53b02d",
301
- "version": "0.2.0",
300
+ "sourceCommit": "9a07f915dfc95b414fa86bcb7d97efcc2ab0e59d",
301
+ "version": "0.3.1",
302
302
  "fileCount": 59
303
303
  }
package/assets/manifest/toolkit-bundle.sha256.txt CHANGED
@@ -2,7 +2,7 @@
2
2
  cc717ae87a0dbcf5aef2204d45211fe59f9506f9d03314eb283eddb3a5997279 toolkit/install.ps1
3
3
  fdf45036d4c0079cdb03e65efb7b5a84ea130e67a4c82522bb93c2bb73aa6661 toolkit/runtimes/claude/CLAUDE_TEMPLATE.md
4
4
  4154c15c71f44d2f2caf07fb41722fa65d4f9ec7e78f798ee084effd12345c62 toolkit/runtimes/codex/CODEX_TEMPLATE.md
5
- 4e44c36964f1933e09aaa92ac9764d5eb7f39dfa00a0ce7d5a649d217f848b04 toolkit/scripts/init-feature.ps1
5
+ 5c1f5442fd3c26b8bf62db4b25e9f1c4207258c7fe52f12ed533968f77dfbf65 toolkit/scripts/init-feature.ps1
6
6
  68a82e421d0309e47cdb79e949b1044c17375ad7fd52e2ab9ccdc9dd33f8cdd0 toolkit/scripts/install-codex-skills.ps1
7
7
  e0d462bd6dcdb17cc003d459063ff341bd2e4f60b245cda9b7e9b9e94b3cf01f toolkit/scripts/uninstall-codex-skills.ps1
8
8
  de2921da9ce504487d9c7d97bf862b65d0ba00b9f1593a4fbfadf41ac36adb49 toolkit/sdtk.config.json
@@ -43,7 +43,7 @@ b79febaeefe8be7dbeec2d29f9c095f159629b8a19d99d3e2a46ff3620786e8d toolkit/templa
43
43
  a0c600bda1e884c91d4e678086136d7516cc2bd8595bbd54948a69ec8ebabc6b toolkit/templates/docs/api/FLOWCHART_CREATION_RULES.md
44
44
  bc32ad83f06dc60ada7312f8d05f56b12da2d5e99c275fbc7895cf1e34a6c358 toolkit/templates/docs/architecture/ARCH_DESIGN_TEMPLATE.md
45
45
  d4cec8811e2a336a0ab8dd6e68998753cf7eca927207cdb8afc20666a5c452f7 toolkit/templates/docs/database/DATABASE_SPEC_TEMPLATE.md
46
- fdc466bdf39a3678e8e3ef005cb3416eedacf681c2d56edbe17e9dfb22db21fd toolkit/templates/docs/design/DESIGN_LAYOUT_TEMPLATE.md
46
+ 26fc80a5bced4b67debea943a49c729532a576146a81994f7e28615c3debe681 toolkit/templates/docs/design/DESIGN_LAYOUT_TEMPLATE.md
47
47
  b7bb3ed90857029f3e7c38f628bac8e04f4ba0ea506c9bbf940765da55b19df1 toolkit/templates/docs/dev/FEATURE_IMPL_PLAN_TEMPLATE.md
48
48
  35488641da64f1bca10c985f66c495da85257d193aad1879a5bd9152e6bbc8c5 toolkit/templates/docs/product/BACKLOG_TEMPLATE.md
49
49
  8c04fe6dcfdc1f2de178dddcafe9ea92803f1a94b1bbc9ef351be632cf04af94 toolkit/templates/docs/product/PRD_TEMPLATE.md
@@ -55,5 +55,5 @@ e8d3554fc4893a8a57fbf006e58f37f21347de5f31ce02f0717e97d29b387eea toolkit/templa
55
55
  b1ed7f7cad8f4098bd305fa9aaea6cdf1c78cf909284547baa50235fa677d8c0 toolkit/templates/docs/specs/FLOW_ACTION_SPEC_CREATION_RULES.md
56
56
  afa6ac33875037495e28238a2c3fae2f4dcbb12f318c3cec0696fe45465cdf2a toolkit/templates/docs/specs/FLOW_ACTION_SPEC_TEMPLATE.md
57
57
  f9dc0d49ceeeb8814d77670e43f09b5221f46d406fb1e89eb575c1ab39bc022a toolkit/templates/QUALITY_CHECKLIST.md
58
- 065b5b536aa7adc7447b54d862ff41340b38d7cbf8f1e4b4fed69abcb45a97a9 toolkit/templates/README.md
58
+ cec5f33d6d6eb4bb31ef2e30f2ace75985aa9eb32bc8c9a760c7464bf5d9bfac toolkit/templates/README.md
59
59
  2b5d4d10019e3c9b3219d92b8123acc85872d9c76230107206e7a270a5ece5a2 toolkit/templates/SHARED_PLANNING.md
package/assets/toolkit/toolkit/scripts/init-feature.ps1 CHANGED
@@ -35,7 +35,7 @@ function Render-Template {
35
35
  [Parameter(Mandatory = $true)][hashtable]$Tokens
36
36
  )
37
37
 
38
- $content = Get-Content -Raw -Path $TemplatePath
38
+ $content = Get-Content -Raw -Path $TemplatePath -Encoding UTF8
39
39
  # Strip BOM if present (Windows PowerShell 5.1 may read BOM into string)
40
40
  if ($content.Length -gt 0 -and $content[0] -eq [char]0xFEFF) {
41
41
  $content = $content.Substring(1)
@@ -112,6 +112,14 @@ if ($ProjectPath) {
112
112
  $projectRoot = Resolve-Path (Join-Path $toolkitRoot '..')
113
113
  }
114
114
 
115
+ # Warn if legacy Docs/ compatibility folder exists at project root
116
+ $legacyDocs = Join-Path $projectRoot 'Docs'
117
+ if ((Test-Path -LiteralPath $legacyDocs) -and ($env:OS -eq 'Windows_NT')) {
118
+ Write-Host "[WARN] Legacy 'Docs/' folder detected at project root." -ForegroundColor Yellow
119
+ Write-Host " On Windows, 'docs/' and 'Docs/' resolve to same folder." -ForegroundColor Yellow
120
+ Write-Host " Consider: git mv Docs tmp-docs && git mv tmp-docs docs" -ForegroundColor Yellow
121
+ }
122
+
115
123
  $templateRoot = Join-Path $toolkitRoot 'templates'
116
124
 
117
125
  if (-not (Test-Path -LiteralPath $templateRoot)) {
package/assets/toolkit/toolkit/templates/README.md CHANGED
@@ -3,6 +3,12 @@
3
3
  Files in `toolkit/templates/` are skeleton artifacts used by `init-feature.ps1`
4
4
  to bootstrap a new feature across the SDLC phases.
5
5
 
6
+ **Note:** These templates produce *scaffold* files with TBD placeholders.
7
+ The scaffolds define the document structure for each SDLC phase. Content is
8
+ expected to be filled in by human authors or AI agents working through the
9
+ 6-phase pipeline (PM Init -> BA -> PM Planning -> ARCH -> DEV -> QA).
10
+ See `SHARED_PLANNING.md` (generated) for the phase pipeline tracker.
11
+
6
12
  ## Tokens
7
13
  - `{{FEATURE_KEY}}` (UPPER_SNAKE_CASE), example: `WORKFLOW_ENGINE`
8
14
  - `{{FEATURE_NAME}}`, example: `Workflow Engine`
package/assets/toolkit/toolkit/templates/docs/design/DESIGN_LAYOUT_TEMPLATE.md CHANGED
@@ -31,7 +31,7 @@
31
31
  ```plantuml
32
32
  @startsalt
33
33
  {
34
- { "① TBD" | [② Action] }
34
+ { "(1) TBD" | [(2) Action] }
35
35
  }
36
36
  @endsalt
37
37
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sdtk-kit",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "SDTK CLI toolkit for deterministic software documentation workflows",
5
5
  "bin": {
6
6
  "sdtk": "./bin/sdtk.js"
package/src/commands/help.js CHANGED
@@ -10,7 +10,7 @@ function cmdHelp() {
10
10
  "Commands:",
11
11
  " init Initialize SDTK workspace (runtime adapter + config)",
12
12
  " auth Manage GitHub authentication and entitlement",
13
- " generate Generate feature documentation from templates",
13
+ " generate Scaffold feature documentation from templates (17 files)",
14
14
  "",
15
15
  "Init options:",
16
16
  " --runtime <codex|claude> Runtime adapter (default: codex)",
@@ -33,6 +33,12 @@ function cmdHelp() {
33
33
  " --validate-only Validate templates without writing files",
34
34
  " --verbose Show detailed PowerShell script output",
35
35
  "",
36
+ "Generate behavior:",
37
+ " The generate command creates 17 scaffold files with TBD placeholders.",
38
+ " Scaffolds define document structure for each SDLC phase.",
39
+ " Content is filled in by agents or manually (PM -> BA -> ARCH -> DEV -> QA).",
40
+ " Output is written to docs/ subdirectories under the project path.",
41
+ "",
36
42
  "Global options:",
37
43
  " -h, --help Show this help",
38
44
  " -v, --version Show version",