sdtk-kit 1.1.0 → 1.2.0

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/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 SDTK
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 SDTK
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,135 +1,135 @@
1
- # sdtk-kit
2
-
3
- > Install all five SDTK toolkits in one command.
4
-
5
- ```bash
6
- npm install -g sdtk-kit
7
- ```
8
-
9
- After install, all five SDTK CLI tools are available globally:
10
-
11
- | CLI | Toolkit | Purpose |
12
- |---------------|----------------|--------------------------------------------------|
13
- | `sdtk-spec` | SDTK-SPEC | Spec-first SDLC: PM → BA → ARCH → DEV → QA |
14
- | `sdtk-design` | SDTK-DESIGN | MVP design: idea → prototype → handoff |
15
- | `sdtk-code` | SDTK-CODE | Governed coding: handoff → PR with review gates |
16
- | `sdtk-ops` | SDTK-OPS | Operations: deploy → smoke → sign-off |
17
- | `sdtk-wiki` | SDTK-WIKI | Local second brain: your project memory |
18
-
19
- ## Quick start
20
-
21
- ```bash
22
- # Initialize the spec toolkit in your project
23
- sdtk-spec init --runtime claude # or --runtime codex
24
-
25
- # Generate a 17-file spec scaffold for your first feature
26
- sdtk-spec generate --feature-key MY_FEATURE
27
- ```
28
-
29
- ## Unified vs standalone install
30
-
31
- You have two install options:
32
-
33
- **Option 1 — Install everything at once (recommended for new projects)**
34
-
35
- ```bash
36
- npm install -g sdtk-kit
37
- ```
38
-
39
- npm installs all five sub-toolkits as dependencies. All CLI binaries land on PATH in one step.
40
-
41
- **Option 2 — Install individual toolkits**
42
-
43
- ```bash
44
- npm install -g sdtk-spec-kit # spec / planning
45
- npm install -g sdtk-design-kit # design
46
- npm install -g sdtk-code-kit # coding
47
- npm install -g sdtk-ops-kit # operations
48
- npm install -g sdtk-wiki-kit # local second brain
49
- ```
50
-
51
- Use Option 2 if you only need one or two toolkits, or if you want granular version control per toolkit.
52
-
53
- Both options are permanently supported. `sdtk-kit` does not replace the standalone packages.
54
-
55
- ## How the unified CLI works (maintainer note)
56
-
57
- `sdtk-kit` declares the five sub-toolkits as dependencies AND ships thin bin
58
- shims (`bin/sdtk-*.js`) that re-export each sub-package's CLI. This is required
59
- because `npm install -g <pkg>` only links the bin entries of the top-level
60
- package, never of its dependencies. A pure deps-only meta-package would install
61
- the sub-toolkits but leave zero CLIs on PATH.
62
-
63
- Do not remove the `bin` field or the `bin/` shims — they are the mechanism that
64
- puts `sdtk-spec`, `sdtk-code`, `sdtk-ops`, `sdtk-design`, and `sdtk-wiki` on PATH
65
- after a global install.
66
-
67
- ## Version pinning model
68
-
69
- `sdtk-kit` uses caret-range dependencies (`^X.Y.Z`) on each sub-toolkit. This means:
70
-
71
- - **Patch and minor updates** of sub-toolkits are picked up automatically when you run `npm update -g sdtk-kit`.
72
- - **Major version bumps** in any sub-toolkit require a coordinated `sdtk-kit` major-bump and re-publish.
73
- - If you need exact version control per toolkit, use standalone packages instead.
74
-
75
- Current pinned versions (as of sdtk-kit v1.0.0):
76
-
77
- | Package | Version |
78
- |------------------|---------|
79
- | sdtk-spec-kit | ^0.4.7 |
80
- | sdtk-code-kit | ^0.1.3 |
81
- | sdtk-ops-kit | ^0.2.4 |
82
- | sdtk-design-kit | ^0.3.0 |
83
- | sdtk-wiki-kit | ^0.1.4 |
84
-
85
- ## Updating
86
-
87
- ```bash
88
- npm update -g sdtk-kit
89
- ```
90
-
91
- This updates all sub-toolkits within their caret ranges.
92
-
93
- ## Uninstalling
94
-
95
- To remove sdtk-kit and its sub-toolkits:
96
-
97
- ```bash
98
- npm uninstall -g sdtk-kit
99
- ```
100
-
101
- Note: `npm uninstall` removes the package and its transitive dependencies. If you had any sub-toolkits installed standalone _before_ installing sdtk-kit, npm may or may not remove them depending on your npm version. Run `npm uninstall -g sdtk-spec-kit sdtk-code-kit sdtk-ops-kit sdtk-design-kit sdtk-wiki-kit` to be sure.
102
-
103
- ## Troubleshooting
104
-
105
- **Command not found after install**
106
-
107
- Re-open your terminal. npm global installs require a new shell session on some systems.
108
-
109
- Check your global prefix:
110
-
111
- ```bash
112
- npm config get prefix
113
- ```
114
-
115
- Ensure `<prefix>/bin` is in `PATH`.
116
-
117
- **Windows PATH issues**
118
-
119
- On Windows, npm global binaries land in `%APPDATA%\npm`. Make sure this is in your `PATH`. Run `npm config get prefix` to confirm the location.
120
-
121
- **Binary collision**
122
-
123
- If you have standalone sub-toolkits installed at different versions than what `sdtk-kit` pins, `npm install -g sdtk-kit` will upgrade them to the pinned versions. To keep a standalone version pinned, install it standalone after sdtk-kit:
124
-
125
- ```bash
126
- npm install -g sdtk-kit
127
- npm install -g sdtk-spec-kit@0.4.6 # pin to an older version
128
- ```
129
-
130
- ## Links
131
-
132
- - Docs: [https://sdtk.dev](https://sdtk.dev)
133
- - Source: [https://github.com/codexsdtk/sdtk-toolkit](https://github.com/codexsdtk/sdtk-toolkit)
134
- - Issues: [https://github.com/codexsdtk/sdtk-toolkit/issues](https://github.com/codexsdtk/sdtk-toolkit/issues)
135
- - License: MIT
1
+ # sdtk-kit
2
+
3
+ > Install all five SDTK toolkits in one command.
4
+
5
+ ```bash
6
+ npm install -g sdtk-kit
7
+ ```
8
+
9
+ After install, all five SDTK CLI tools are available globally:
10
+
11
+ | CLI | Toolkit | Purpose |
12
+ |---------------|----------------|--------------------------------------------------|
13
+ | `sdtk-spec` | SDTK-SPEC | Spec-first SDLC: PM → BA → ARCH → DEV → QA |
14
+ | `sdtk-design` | SDTK-DESIGN | MVP design: idea → prototype → handoff |
15
+ | `sdtk-code` | SDTK-CODE | Governed coding: handoff → PR with review gates |
16
+ | `sdtk-ops` | SDTK-OPS | Operations: deploy → smoke → sign-off |
17
+ | `sdtk-wiki` | SDTK-WIKI | Local second brain: your project memory |
18
+
19
+ ## Quick start
20
+
21
+ ```bash
22
+ # Initialize the spec toolkit in your project
23
+ sdtk-spec init --runtime claude # or --runtime codex
24
+
25
+ # Generate a 17-file spec scaffold for your first feature
26
+ sdtk-spec generate --feature-key MY_FEATURE
27
+ ```
28
+
29
+ ## Unified vs standalone install
30
+
31
+ You have two install options:
32
+
33
+ **Option 1 — Install everything at once (recommended for new projects)**
34
+
35
+ ```bash
36
+ npm install -g sdtk-kit
37
+ ```
38
+
39
+ npm installs all five sub-toolkits as dependencies. All CLI binaries land on PATH in one step.
40
+
41
+ **Option 2 — Install individual toolkits**
42
+
43
+ ```bash
44
+ npm install -g sdtk-spec-kit # spec / planning
45
+ npm install -g sdtk-design-kit # design
46
+ npm install -g sdtk-code-kit # coding
47
+ npm install -g sdtk-ops-kit # operations
48
+ npm install -g sdtk-wiki-kit # local second brain
49
+ ```
50
+
51
+ Use Option 2 if you only need one or two toolkits, or if you want granular version control per toolkit.
52
+
53
+ Both options are permanently supported. `sdtk-kit` does not replace the standalone packages.
54
+
55
+ ## How the unified CLI works (maintainer note)
56
+
57
+ `sdtk-kit` declares the five sub-toolkits as dependencies AND ships thin bin
58
+ shims (`bin/sdtk-*.js`) that re-export each sub-package's CLI. This is required
59
+ because `npm install -g <pkg>` only links the bin entries of the top-level
60
+ package, never of its dependencies. A pure deps-only meta-package would install
61
+ the sub-toolkits but leave zero CLIs on PATH.
62
+
63
+ Do not remove the `bin` field or the `bin/` shims — they are the mechanism that
64
+ puts `sdtk-spec`, `sdtk-code`, `sdtk-ops`, `sdtk-design`, and `sdtk-wiki` on PATH
65
+ after a global install.
66
+
67
+ ## Version pinning model
68
+
69
+ `sdtk-kit` uses caret-range dependencies (`^X.Y.Z`) on each sub-toolkit. This means:
70
+
71
+ - **Patch and minor updates** of sub-toolkits are picked up automatically when you run `npm update -g sdtk-kit`.
72
+ - **Major version bumps** in any sub-toolkit require a coordinated `sdtk-kit` major-bump and re-publish.
73
+ - If you need exact version control per toolkit, use standalone packages instead.
74
+
75
+ Current pinned versions (as of sdtk-kit v1.0.0):
76
+
77
+ | Package | Version |
78
+ |------------------|---------|
79
+ | sdtk-spec-kit | ^0.4.7 |
80
+ | sdtk-code-kit | ^0.1.3 |
81
+ | sdtk-ops-kit | ^0.2.4 |
82
+ | sdtk-design-kit | ^0.3.0 |
83
+ | sdtk-wiki-kit | ^0.1.4 |
84
+
85
+ ## Updating
86
+
87
+ ```bash
88
+ npm update -g sdtk-kit
89
+ ```
90
+
91
+ This updates all sub-toolkits within their caret ranges.
92
+
93
+ ## Uninstalling
94
+
95
+ To remove sdtk-kit and its sub-toolkits:
96
+
97
+ ```bash
98
+ npm uninstall -g sdtk-kit
99
+ ```
100
+
101
+ Note: `npm uninstall` removes the package and its transitive dependencies. If you had any sub-toolkits installed standalone _before_ installing sdtk-kit, npm may or may not remove them depending on your npm version. Run `npm uninstall -g sdtk-spec-kit sdtk-code-kit sdtk-ops-kit sdtk-design-kit sdtk-wiki-kit` to be sure.
102
+
103
+ ## Troubleshooting
104
+
105
+ **Command not found after install**
106
+
107
+ Re-open your terminal. npm global installs require a new shell session on some systems.
108
+
109
+ Check your global prefix:
110
+
111
+ ```bash
112
+ npm config get prefix
113
+ ```
114
+
115
+ Ensure `<prefix>/bin` is in `PATH`.
116
+
117
+ **Windows PATH issues**
118
+
119
+ On Windows, npm global binaries land in `%APPDATA%\npm`. Make sure this is in your `PATH`. Run `npm config get prefix` to confirm the location.
120
+
121
+ **Binary collision**
122
+
123
+ If you have standalone sub-toolkits installed at different versions than what `sdtk-kit` pins, `npm install -g sdtk-kit` will upgrade them to the pinned versions. To keep a standalone version pinned, install it standalone after sdtk-kit:
124
+
125
+ ```bash
126
+ npm install -g sdtk-kit
127
+ npm install -g sdtk-spec-kit@0.4.6 # pin to an older version
128
+ ```
129
+
130
+ ## Links
131
+
132
+ - Docs: [https://sdtk.dev](https://sdtk.dev)
133
+ - Source: [https://github.com/codexsdtk/sdtk-toolkit](https://github.com/codexsdtk/sdtk-toolkit)
134
+ - Issues: [https://github.com/codexsdtk/sdtk-toolkit/issues](https://github.com/codexsdtk/sdtk-toolkit/issues)
135
+ - License: MIT
package/bin/sdtk-code.js CHANGED
@@ -1,6 +1,6 @@
1
- #!/usr/bin/env node
2
- "use strict";
3
-
4
- // Bin shim — re-exports the sdtk-code CLI from the sdtk-code-kit dependency.
5
- // See bin/sdtk-spec.js for the rationale behind these shims.
6
- require("sdtk-code-kit/bin/sdtk-code.js");
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+
4
+ // Bin shim — re-exports the sdtk-code CLI from the sdtk-code-kit dependency.
5
+ // See bin/sdtk-spec.js for the rationale behind these shims.
6
+ require("sdtk-code-kit/bin/sdtk-code.js");
@@ -1,6 +1,6 @@
1
- #!/usr/bin/env node
2
- "use strict";
3
-
4
- // Bin shim — re-exports the sdtk-design CLI from the sdtk-design-kit dependency.
5
- // See bin/sdtk-spec.js for the rationale behind these shims.
6
- require("sdtk-design-kit/bin/sdtk-design.js");
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+
4
+ // Bin shim — re-exports the sdtk-design CLI from the sdtk-design-kit dependency.
5
+ // See bin/sdtk-spec.js for the rationale behind these shims.
6
+ require("sdtk-design-kit/bin/sdtk-design.js");
package/bin/sdtk-ops.js CHANGED
@@ -1,6 +1,6 @@
1
- #!/usr/bin/env node
2
- "use strict";
3
-
4
- // Bin shim — re-exports the sdtk-ops CLI from the sdtk-ops-kit dependency.
5
- // See bin/sdtk-spec.js for the rationale behind these shims.
6
- require("sdtk-ops-kit/bin/sdtk-ops.js");
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+
4
+ // Bin shim — re-exports the sdtk-ops CLI from the sdtk-ops-kit dependency.
5
+ // See bin/sdtk-spec.js for the rationale behind these shims.
6
+ require("sdtk-ops-kit/bin/sdtk-ops.js");
package/bin/sdtk-spec.js CHANGED
@@ -1,12 +1,12 @@
1
- #!/usr/bin/env node
2
- "use strict";
3
-
4
- // Bin shim — re-exports the sdtk-spec CLI from the sdtk-spec-kit dependency.
5
- //
6
- // Why this exists: `npm install -g <pkg>` only links the bin entries of the
7
- // top-level package, NOT of its dependencies. A pure meta-package (deps only,
8
- // no bin) therefore installs the sub-packages but leaves no CLI on PATH.
9
- //
10
- // Each sub-toolkit CLI reads process.argv directly, so requiring its bin
11
- // entry here runs it with the real arguments unchanged.
12
- require("sdtk-spec-kit/bin/sdtk.js");
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+
4
+ // Bin shim — re-exports the sdtk-spec CLI from the sdtk-spec-kit dependency.
5
+ //
6
+ // Why this exists: `npm install -g <pkg>` only links the bin entries of the
7
+ // top-level package, NOT of its dependencies. A pure meta-package (deps only,
8
+ // no bin) therefore installs the sub-packages but leaves no CLI on PATH.
9
+ //
10
+ // Each sub-toolkit CLI reads process.argv directly, so requiring its bin
11
+ // entry here runs it with the real arguments unchanged.
12
+ require("sdtk-spec-kit/bin/sdtk.js");
package/bin/sdtk-wiki.js CHANGED
@@ -1,6 +1,6 @@
1
- #!/usr/bin/env node
2
- "use strict";
3
-
4
- // Bin shim — re-exports the sdtk-wiki CLI from the sdtk-wiki-kit dependency.
5
- // See bin/sdtk-spec.js for the rationale behind these shims.
6
- require("sdtk-wiki-kit/bin/sdtk-wiki.js");
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+
4
+ // Bin shim — re-exports the sdtk-wiki CLI from the sdtk-wiki-kit dependency.
5
+ // See bin/sdtk-spec.js for the rationale behind these shims.
6
+ require("sdtk-wiki-kit/bin/sdtk-wiki.js");
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sdtk-kit",
3
- "version": "1.1.0",
3
+ "version": "1.2.0",
4
4
  "description": "Install all five SDTK toolkits in one command. Meta-package for sdtk-spec-kit, sdtk-code-kit, sdtk-ops-kit, sdtk-design-kit, and sdtk-wiki-kit.",
5
5
  "type": "commonjs",
6
6
  "bin": {
@@ -22,7 +22,7 @@
22
22
  },
23
23
  "dependencies": {
24
24
  "sdtk-spec-kit": "^0.4.7",
25
- "sdtk-code-kit": "^0.2.0",
25
+ "sdtk-code-kit": "^0.3.0",
26
26
  "sdtk-ops-kit": "^0.2.4",
27
27
  "sdtk-design-kit": "^0.3.0",
28
28
  "sdtk-wiki-kit": "^0.2.0"
@@ -1,40 +1,40 @@
1
- #!/usr/bin/env node
2
- "use strict";
3
-
4
- // Skip banner in CI environments and headless installs.
5
- // This avoids noisy output in automated pipelines that install sdtk-kit
6
- // as a transitive dependency.
7
- const isCI =
8
- process.env.CI === "true" ||
9
- process.env.NODE_ENV === "test" ||
10
- process.env.npm_config_loglevel === "silent" ||
11
- process.env.npm_config_loglevel === "error";
12
-
13
- if (isCI) {
14
- process.exit(0);
15
- }
16
-
17
- const lines = [
18
- "",
19
- " ╔══════════════════════════════════════════════════════╗",
20
- " ║ SDTK — All Five Toolkits Installed ║",
21
- " ╚══════════════════════════════════════════════════════╝",
22
- "",
23
- " You now have all five SDTK CLI tools available:",
24
- "",
25
- " sdtk-spec — Spec-first SDLC: PM → BA → ARCH → DEV → QA",
26
- " sdtk-design — MVP design: idea → prototype → handoff",
27
- " sdtk-code — Governed coding: handoff → PR with review gates",
28
- " sdtk-ops — Operations: deploy → smoke → sign-off",
29
- " sdtk-wiki — Local second brain: your project memory",
30
- "",
31
- " Start with the SPEC toolkit:",
32
- "",
33
- " sdtk-spec init --runtime claude (or --runtime codex)",
34
- " sdtk-spec generate --feature-key <YOUR_FEATURE>",
35
- "",
36
- " Docs: https://sdtk.dev",
37
- "",
38
- ];
39
-
40
- process.stdout.write(lines.join("\n") + "\n");
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+
4
+ // Skip banner in CI environments and headless installs.
5
+ // This avoids noisy output in automated pipelines that install sdtk-kit
6
+ // as a transitive dependency.
7
+ const isCI =
8
+ process.env.CI === "true" ||
9
+ process.env.NODE_ENV === "test" ||
10
+ process.env.npm_config_loglevel === "silent" ||
11
+ process.env.npm_config_loglevel === "error";
12
+
13
+ if (isCI) {
14
+ process.exit(0);
15
+ }
16
+
17
+ const lines = [
18
+ "",
19
+ " ╔══════════════════════════════════════════════════════╗",
20
+ " ║ SDTK — All Five Toolkits Installed ║",
21
+ " ╚══════════════════════════════════════════════════════╝",
22
+ "",
23
+ " You now have all five SDTK CLI tools available:",
24
+ "",
25
+ " sdtk-spec — Spec-first SDLC: PM → BA → ARCH → DEV → QA",
26
+ " sdtk-design — MVP design: idea → prototype → handoff",
27
+ " sdtk-code — Governed coding: handoff → PR with review gates",
28
+ " sdtk-ops — Operations: deploy → smoke → sign-off",
29
+ " sdtk-wiki — Local second brain: your project memory",
30
+ "",
31
+ " Start with the SPEC toolkit:",
32
+ "",
33
+ " sdtk-spec init --runtime claude (or --runtime codex)",
34
+ " sdtk-spec generate --feature-key <YOUR_FEATURE>",
35
+ "",
36
+ " Docs: https://sdtk.dev",
37
+ "",
38
+ ];
39
+
40
+ process.stdout.write(lines.join("\n") + "\n");