sdtk-ops-kit 0.2.2 → 0.2.3
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/README.md +192 -160
- package/assets/manifest/toolkit-bundle.manifest.json +5 -5
- package/assets/manifest/toolkit-bundle.sha256.txt +2 -2
- package/assets/toolkit/toolkit/AGENTS.md +2 -2
- package/assets/toolkit/toolkit/SDTKOPS_TOOLKIT.md +203 -202
- package/package.json +1 -1
- package/src/commands/help.js +41 -27
- package/src/commands/update.js +11 -0
- package/src/index.js +68 -65
- package/src/lib/update.js +337 -0
|
@@ -1,202 +1,203 @@
|
|
|
1
|
-
# Software Development Toolkit - Operations (SDTK-OPS)
|
|
2
|
-
|
|
3
|
-
## Document Role
|
|
4
|
-
This file is the architecture and product-boundary document for `SDTK-OPS`.
|
|
5
|
-
|
|
6
|
-
Use this file to understand:
|
|
7
|
-
- how `SDTK-OPS` fits inside the `SDTK-SPEC -> SDTK-CODE -> SDTK-OPS` family
|
|
8
|
-
- what the current skill-driven entry model owns
|
|
9
|
-
- which journeys are canonical in the current wave
|
|
10
|
-
- what stays outside `SDTK-OPS` scope
|
|
11
|
-
|
|
12
|
-
Do not use this file as the primary install or onboarding guide.
|
|
13
|
-
|
|
14
|
-
Canonical end-user guide:
|
|
15
|
-
- `products/sdtk-ops/governance/SDTKOPS_TOOLKIT_USAGE_GUIDE.md`
|
|
16
|
-
|
|
17
|
-
## 1. Overview
|
|
18
|
-
|
|
19
|
-
`SDTK-OPS` is the operations-process product in the `SDTK-SPEC -> SDTK-CODE -> SDTK-OPS` family.
|
|
20
|
-
|
|
21
|
-
It is not a workflow-first CLI like `SDTK-CODE`.
|
|
22
|
-
|
|
23
|
-
The truthful current CLI surface is:
|
|
24
|
-
- `sdtk-ops help`
|
|
25
|
-
- `sdtk-ops init`
|
|
26
|
-
- `sdtk-ops runtime install`
|
|
27
|
-
- `sdtk-ops runtime status`
|
|
28
|
-
- `sdtk-ops runtime uninstall`
|
|
29
|
-
|
|
30
|
-
The current public package is:
|
|
31
|
-
- `sdtk-ops-kit`
|
|
32
|
-
- CLI command: `sdtk-ops`
|
|
33
|
-
- Latest published version lookup: `npm view sdtk-ops-kit version`
|
|
34
|
-
|
|
35
|
-
The truthful current operational surface after `init` is skill-driven:
|
|
36
|
-
- the 15 `ops-*` skills remain the real operating surface
|
|
37
|
-
- `ops-discover` remains a skill, not a CLI command
|
|
38
|
-
- `ops-verify` remains the required closing skill for every canonical journey
|
|
39
|
-
- `generate` remains unsupported and deferred
|
|
40
|
-
|
|
41
|
-
## 2. Boundary With SDTK-SPEC And SDTK-CODE
|
|
42
|
-
|
|
43
|
-
`SDTK-SPEC` is upstream and remains the docs-first specification and handoff system.
|
|
44
|
-
|
|
45
|
-
`SDTK-SPEC` owns:
|
|
46
|
-
- specification and handoff generation
|
|
47
|
-
- PM, BA, ARCH, DEV, and QA orchestration
|
|
48
|
-
- upstream workflow contracts and design artifacts
|
|
49
|
-
|
|
50
|
-
`SDTK-CODE` owns:
|
|
51
|
-
- coding-process execution after handoff
|
|
52
|
-
- workflow-first build, verify, and closeout discipline
|
|
53
|
-
- implementation evidence for the coded slice
|
|
54
|
-
|
|
55
|
-
`SDTK-OPS` owns:
|
|
56
|
-
- operational planning and deployment discipline
|
|
57
|
-
- environment/runtime validation
|
|
58
|
-
- monitoring, incident response, and backup or recovery execution
|
|
59
|
-
- infrastructure security, compliance, and cost work when those are the active concern
|
|
60
|
-
|
|
61
|
-
`SDTK-OPS` does not own:
|
|
62
|
-
- upstream requirements or architecture generation
|
|
63
|
-
- coding workflow execution
|
|
64
|
-
- provider-specific platform packs in the current wave
|
|
65
|
-
- broader launch marketing claims beyond the current public package
|
|
66
|
-
|
|
67
|
-
## 3. DEV-Run Intake Contract
|
|
68
|
-
|
|
69
|
-
`DEV-Run` is executed via `SDTK-OPS`.
|
|
70
|
-
|
|
71
|
-
When `DEV-Run` begins from coded scope, the only canonical `CODE -> OPS` bridge artifact is:
|
|
72
|
-
- `docs/dev/OPS_HANDOFF_[FEATURE_KEY].json`
|
|
73
|
-
|
|
74
|
-
`SDTK-OPS` reads that frozen contract as input.
|
|
75
|
-
It does not redefine the schema, rename fields, move the file, or silently normalize producer output into a different contract.
|
|
76
|
-
|
|
77
|
-
Ready-path intake rules:
|
|
78
|
-
- inspect `handoff_status` first
|
|
79
|
-
- if `handoff_status` is `READY_FOR_SDTK_OPS`, start with `suggested_next_ops_path.start_with` unless fresh evidence requires a bounded reroute
|
|
80
|
-
- treat `suggested_next_ops_path.suggested_chain` as the default first routing sequence
|
|
81
|
-
- close with `suggested_next_ops_path.close_with`, which should normally be `ops-verify`
|
|
82
|
-
|
|
83
|
-
Blocked-path intake rules:
|
|
84
|
-
- if `handoff_status` is `BLOCKED_FOR_SDTK_OPS`, the handoff is still inspectable
|
|
85
|
-
- inspect `open_blockers`, `code_evidence_refs`, and the prerequisite fields before choosing any action
|
|
86
|
-
- do not treat blocked handoff state as normal ready-path execution
|
|
87
|
-
- use `ops-discover` to select bounded triage or clarification only when blocker text supports that path
|
|
88
|
-
|
|
89
|
-
Bounded OPS evidence expectations in this wave:
|
|
90
|
-
- record the consumed handoff path and `handoff_status`
|
|
91
|
-
- record the selected first OPS step and whether it followed or overrode `suggested_next_ops_path`
|
|
92
|
-
- record checked prerequisites, assumptions, dependencies, observability requirements, and rollback or recovery expectations
|
|
93
|
-
- record journey-specific operational evidence for the scoped OPS work
|
|
94
|
-
- record final `ops-verify` closeout evidence
|
|
95
|
-
|
|
96
|
-
This wave does not define a final OPS evidence schema and does not implement QA bridge logic.
|
|
97
|
-
|
|
98
|
-
## 4. Entry And Routing Model
|
|
99
|
-
|
|
100
|
-
After `sdtk-ops init`, choose a journey directly when the goal is clear.
|
|
101
|
-
|
|
102
|
-
If the correct path is unclear:
|
|
103
|
-
- start with `ops-discover`
|
|
104
|
-
|
|
105
|
-
Always:
|
|
106
|
-
- close every canonical journey with `ops-verify`
|
|
107
|
-
- keep `generate` out of the documented command path
|
|
108
|
-
|
|
109
|
-
| Journey | Start With | Suggested Chain | Close With |
|
|
110
|
-
|---------|------------|-----------------|------------|
|
|
111
|
-
| Deployment | `ops-plan` | `ops-plan` -> `ops-infra-plan` -> `ops-container` -> `ops-ci-cd` -> `ops-deploy` -> `ops-monitor` | `ops-verify` |
|
|
112
|
-
| Incident | `ops-incident` | `ops-incident` -> `ops-debug` -> `ops-deploy` if a change or rollback is required -> `ops-monitor` | `ops-verify` |
|
|
113
|
-
| Monitoring | `ops-plan` | `ops-plan` -> `ops-monitor` | `ops-verify` |
|
|
114
|
-
| Backup or recovery | `ops-plan` | `ops-plan` -> `ops-backup` | `ops-verify` |
|
|
115
|
-
|
|
116
|
-
Other valid but non-primary routed skills in this wave:
|
|
117
|
-
- `ops-security-infra`
|
|
118
|
-
- `ops-compliance`
|
|
119
|
-
- `ops-cost`
|
|
120
|
-
- `ops-parallel`
|
|
121
|
-
|
|
122
|
-
## 5. Skill Catalog
|
|
123
|
-
|
|
124
|
-
### 5.1 Core Process
|
|
125
|
-
|
|
126
|
-
| Skill | Purpose |
|
|
127
|
-
|-------|---------|
|
|
128
|
-
| `ops-verify` | verify commands, state, and evidence before declaring work complete |
|
|
129
|
-
| `ops-debug` | diagnose operational failures systematically and trace root cause |
|
|
130
|
-
| `ops-plan` | write reviewable operational plans with rollback and verification steps |
|
|
131
|
-
| `ops-parallel` | split truly independent operations tasks into parallel workstreams |
|
|
132
|
-
|
|
133
|
-
### 5.2 Deployment
|
|
134
|
-
|
|
135
|
-
| Skill | Purpose |
|
|
136
|
-
|-------|---------|
|
|
137
|
-
| `ops-infra-plan` | design infrastructure architecture and provisioning order before apply |
|
|
138
|
-
| `ops-deploy` | execute deployments with health gates, rollout strategy, and rollback discipline |
|
|
139
|
-
| `ops-container` | define secure image build and container orchestration patterns |
|
|
140
|
-
| `ops-ci-cd` | build and manage pipelines, promotion flow, artifact handling, and secret controls |
|
|
141
|
-
|
|
142
|
-
### 5.3 Operations
|
|
143
|
-
|
|
144
|
-
| Skill | Purpose |
|
|
145
|
-
|-------|---------|
|
|
146
|
-
| `ops-monitor` | define SLOs, alerts, dashboards, logs, and traces |
|
|
147
|
-
| `ops-incident` | coordinate incident response, stabilization, and post-mortem follow-up |
|
|
148
|
-
| `ops-backup` | design backup, restore, and disaster recovery procedures |
|
|
149
|
-
| `ops-cost` | review spend, identify waste, and plan safe right-sizing |
|
|
150
|
-
|
|
151
|
-
### 5.4 Security And Compliance
|
|
152
|
-
|
|
153
|
-
| Skill | Purpose |
|
|
154
|
-
|-------|---------|
|
|
155
|
-
| `ops-security-infra` | harden infrastructure, secrets, network policy, and security scanning |
|
|
156
|
-
| `ops-compliance` | automate audit readiness, evidence collection, retention, and policy enforcement |
|
|
157
|
-
|
|
158
|
-
### 5.5 Discovery
|
|
159
|
-
|
|
160
|
-
| Skill | Purpose |
|
|
161
|
-
|-------|---------|
|
|
162
|
-
| `ops-discover` | choose the correct SDTK-OPS entry point and sequencing |
|
|
163
|
-
|
|
164
|
-
## 6. Runtime Truth
|
|
165
|
-
|
|
166
|
-
### Claude
|
|
167
|
-
- supports project and user scope
|
|
168
|
-
- default scope is project
|
|
169
|
-
- uses the `ops-*` runtime payload after install
|
|
170
|
-
|
|
171
|
-
### Codex
|
|
172
|
-
-
|
|
173
|
-
- default scope is user
|
|
174
|
-
- uses collision-avoiding `sdtk-ops-*` skill directory names
|
|
175
|
-
- project
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
-
|
|
184
|
-
|
|
185
|
-
-
|
|
186
|
-
|
|
187
|
-
-
|
|
188
|
-
|
|
189
|
-
-
|
|
190
|
-
|
|
191
|
-
-
|
|
192
|
-
|
|
193
|
-
- `products/sdtk-ops/governance/release-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
-
|
|
202
|
-
-
|
|
1
|
+
# Software Development Toolkit - Operations (SDTK-OPS)
|
|
2
|
+
|
|
3
|
+
## Document Role
|
|
4
|
+
This file is the architecture and product-boundary document for `SDTK-OPS`.
|
|
5
|
+
|
|
6
|
+
Use this file to understand:
|
|
7
|
+
- how `SDTK-OPS` fits inside the `SDTK-SPEC -> SDTK-CODE -> SDTK-OPS` family
|
|
8
|
+
- what the current skill-driven entry model owns
|
|
9
|
+
- which journeys are canonical in the current wave
|
|
10
|
+
- what stays outside `SDTK-OPS` scope
|
|
11
|
+
|
|
12
|
+
Do not use this file as the primary install or onboarding guide.
|
|
13
|
+
|
|
14
|
+
Canonical end-user guide:
|
|
15
|
+
- `products/sdtk-ops/governance/SDTKOPS_TOOLKIT_USAGE_GUIDE.md`
|
|
16
|
+
|
|
17
|
+
## 1. Overview
|
|
18
|
+
|
|
19
|
+
`SDTK-OPS` is the operations-process product in the `SDTK-SPEC -> SDTK-CODE -> SDTK-OPS` family.
|
|
20
|
+
|
|
21
|
+
It is not a workflow-first CLI like `SDTK-CODE`.
|
|
22
|
+
|
|
23
|
+
The truthful current CLI surface is:
|
|
24
|
+
- `sdtk-ops help`
|
|
25
|
+
- `sdtk-ops init`
|
|
26
|
+
- `sdtk-ops runtime install`
|
|
27
|
+
- `sdtk-ops runtime status`
|
|
28
|
+
- `sdtk-ops runtime uninstall`
|
|
29
|
+
|
|
30
|
+
The current public package is:
|
|
31
|
+
- `sdtk-ops-kit`
|
|
32
|
+
- CLI command: `sdtk-ops`
|
|
33
|
+
- Latest published version lookup: `npm view sdtk-ops-kit version`
|
|
34
|
+
|
|
35
|
+
The truthful current operational surface after `init` is skill-driven:
|
|
36
|
+
- the 15 `ops-*` skills remain the real operating surface
|
|
37
|
+
- `ops-discover` remains a skill, not a CLI command
|
|
38
|
+
- `ops-verify` remains the required closing skill for every canonical journey
|
|
39
|
+
- `generate` remains unsupported and deferred
|
|
40
|
+
|
|
41
|
+
## 2. Boundary With SDTK-SPEC And SDTK-CODE
|
|
42
|
+
|
|
43
|
+
`SDTK-SPEC` is upstream and remains the docs-first specification and handoff system.
|
|
44
|
+
|
|
45
|
+
`SDTK-SPEC` owns:
|
|
46
|
+
- specification and handoff generation
|
|
47
|
+
- PM, BA, ARCH, DEV, and QA orchestration
|
|
48
|
+
- upstream workflow contracts and design artifacts
|
|
49
|
+
|
|
50
|
+
`SDTK-CODE` owns:
|
|
51
|
+
- coding-process execution after handoff
|
|
52
|
+
- workflow-first build, verify, and closeout discipline
|
|
53
|
+
- implementation evidence for the coded slice
|
|
54
|
+
|
|
55
|
+
`SDTK-OPS` owns:
|
|
56
|
+
- operational planning and deployment discipline
|
|
57
|
+
- environment/runtime validation
|
|
58
|
+
- monitoring, incident response, and backup or recovery execution
|
|
59
|
+
- infrastructure security, compliance, and cost work when those are the active concern
|
|
60
|
+
|
|
61
|
+
`SDTK-OPS` does not own:
|
|
62
|
+
- upstream requirements or architecture generation
|
|
63
|
+
- coding workflow execution
|
|
64
|
+
- provider-specific platform packs in the current wave
|
|
65
|
+
- broader launch marketing claims beyond the current public package
|
|
66
|
+
|
|
67
|
+
## 3. DEV-Run Intake Contract
|
|
68
|
+
|
|
69
|
+
`DEV-Run` is executed via `SDTK-OPS`.
|
|
70
|
+
|
|
71
|
+
When `DEV-Run` begins from coded scope, the only canonical `CODE -> OPS` bridge artifact is:
|
|
72
|
+
- `docs/dev/OPS_HANDOFF_[FEATURE_KEY].json`
|
|
73
|
+
|
|
74
|
+
`SDTK-OPS` reads that frozen contract as input.
|
|
75
|
+
It does not redefine the schema, rename fields, move the file, or silently normalize producer output into a different contract.
|
|
76
|
+
|
|
77
|
+
Ready-path intake rules:
|
|
78
|
+
- inspect `handoff_status` first
|
|
79
|
+
- if `handoff_status` is `READY_FOR_SDTK_OPS`, start with `suggested_next_ops_path.start_with` unless fresh evidence requires a bounded reroute
|
|
80
|
+
- treat `suggested_next_ops_path.suggested_chain` as the default first routing sequence
|
|
81
|
+
- close with `suggested_next_ops_path.close_with`, which should normally be `ops-verify`
|
|
82
|
+
|
|
83
|
+
Blocked-path intake rules:
|
|
84
|
+
- if `handoff_status` is `BLOCKED_FOR_SDTK_OPS`, the handoff is still inspectable
|
|
85
|
+
- inspect `open_blockers`, `code_evidence_refs`, and the prerequisite fields before choosing any action
|
|
86
|
+
- do not treat blocked handoff state as normal ready-path execution
|
|
87
|
+
- use `ops-discover` to select bounded triage or clarification only when blocker text supports that path
|
|
88
|
+
|
|
89
|
+
Bounded OPS evidence expectations in this wave:
|
|
90
|
+
- record the consumed handoff path and `handoff_status`
|
|
91
|
+
- record the selected first OPS step and whether it followed or overrode `suggested_next_ops_path`
|
|
92
|
+
- record checked prerequisites, assumptions, dependencies, observability requirements, and rollback or recovery expectations
|
|
93
|
+
- record journey-specific operational evidence for the scoped OPS work
|
|
94
|
+
- record final `ops-verify` closeout evidence
|
|
95
|
+
|
|
96
|
+
This wave does not define a final OPS evidence schema and does not implement QA bridge logic.
|
|
97
|
+
|
|
98
|
+
## 4. Entry And Routing Model
|
|
99
|
+
|
|
100
|
+
After `sdtk-ops init`, choose a journey directly when the goal is clear.
|
|
101
|
+
|
|
102
|
+
If the correct path is unclear:
|
|
103
|
+
- start with `ops-discover`
|
|
104
|
+
|
|
105
|
+
Always:
|
|
106
|
+
- close every canonical journey with `ops-verify`
|
|
107
|
+
- keep `generate` out of the documented command path
|
|
108
|
+
|
|
109
|
+
| Journey | Start With | Suggested Chain | Close With |
|
|
110
|
+
|---------|------------|-----------------|------------|
|
|
111
|
+
| Deployment | `ops-plan` | `ops-plan` -> `ops-infra-plan` -> `ops-container` -> `ops-ci-cd` -> `ops-deploy` -> `ops-monitor` | `ops-verify` |
|
|
112
|
+
| Incident | `ops-incident` | `ops-incident` -> `ops-debug` -> `ops-deploy` if a change or rollback is required -> `ops-monitor` | `ops-verify` |
|
|
113
|
+
| Monitoring | `ops-plan` | `ops-plan` -> `ops-monitor` | `ops-verify` |
|
|
114
|
+
| Backup or recovery | `ops-plan` | `ops-plan` -> `ops-backup` | `ops-verify` |
|
|
115
|
+
|
|
116
|
+
Other valid but non-primary routed skills in this wave:
|
|
117
|
+
- `ops-security-infra`
|
|
118
|
+
- `ops-compliance`
|
|
119
|
+
- `ops-cost`
|
|
120
|
+
- `ops-parallel`
|
|
121
|
+
|
|
122
|
+
## 5. Skill Catalog
|
|
123
|
+
|
|
124
|
+
### 5.1 Core Process
|
|
125
|
+
|
|
126
|
+
| Skill | Purpose |
|
|
127
|
+
|-------|---------|
|
|
128
|
+
| `ops-verify` | verify commands, state, and evidence before declaring work complete |
|
|
129
|
+
| `ops-debug` | diagnose operational failures systematically and trace root cause |
|
|
130
|
+
| `ops-plan` | write reviewable operational plans with rollback and verification steps |
|
|
131
|
+
| `ops-parallel` | split truly independent operations tasks into parallel workstreams |
|
|
132
|
+
|
|
133
|
+
### 5.2 Deployment
|
|
134
|
+
|
|
135
|
+
| Skill | Purpose |
|
|
136
|
+
|-------|---------|
|
|
137
|
+
| `ops-infra-plan` | design infrastructure architecture and provisioning order before apply |
|
|
138
|
+
| `ops-deploy` | execute deployments with health gates, rollout strategy, and rollback discipline |
|
|
139
|
+
| `ops-container` | define secure image build and container orchestration patterns |
|
|
140
|
+
| `ops-ci-cd` | build and manage pipelines, promotion flow, artifact handling, and secret controls |
|
|
141
|
+
|
|
142
|
+
### 5.3 Operations
|
|
143
|
+
|
|
144
|
+
| Skill | Purpose |
|
|
145
|
+
|-------|---------|
|
|
146
|
+
| `ops-monitor` | define SLOs, alerts, dashboards, logs, and traces |
|
|
147
|
+
| `ops-incident` | coordinate incident response, stabilization, and post-mortem follow-up |
|
|
148
|
+
| `ops-backup` | design backup, restore, and disaster recovery procedures |
|
|
149
|
+
| `ops-cost` | review spend, identify waste, and plan safe right-sizing |
|
|
150
|
+
|
|
151
|
+
### 5.4 Security And Compliance
|
|
152
|
+
|
|
153
|
+
| Skill | Purpose |
|
|
154
|
+
|-------|---------|
|
|
155
|
+
| `ops-security-infra` | harden infrastructure, secrets, network policy, and security scanning |
|
|
156
|
+
| `ops-compliance` | automate audit readiness, evidence collection, retention, and policy enforcement |
|
|
157
|
+
|
|
158
|
+
### 5.5 Discovery
|
|
159
|
+
|
|
160
|
+
| Skill | Purpose |
|
|
161
|
+
|-------|---------|
|
|
162
|
+
| `ops-discover` | choose the correct SDTK-OPS entry point and sequencing |
|
|
163
|
+
|
|
164
|
+
## 6. Runtime Truth
|
|
165
|
+
|
|
166
|
+
### Claude
|
|
167
|
+
- supports project and user scope
|
|
168
|
+
- default scope is project
|
|
169
|
+
- uses the `ops-*` runtime payload after install
|
|
170
|
+
|
|
171
|
+
### Codex
|
|
172
|
+
- defaults to user scope
|
|
173
|
+
- default scope is user
|
|
174
|
+
- uses collision-avoiding `sdtk-ops-*` skill directory names
|
|
175
|
+
- supports project-local installs only through the explicit local `CODEX_HOME=<project>/.codex` contract
|
|
176
|
+
- native `.codex/skills` auto-discovery is not claimed
|
|
177
|
+
|
|
178
|
+
## 7. Documentation Map
|
|
179
|
+
|
|
180
|
+
Use these documents by role:
|
|
181
|
+
|
|
182
|
+
- Canonical end-user install and usage guide:
|
|
183
|
+
- `products/sdtk-ops/governance/SDTKOPS_TOOLKIT_USAGE_GUIDE.md`
|
|
184
|
+
- Install-truth and smoke appendix:
|
|
185
|
+
- `products/sdtk-ops/governance/installation-runbook.md`
|
|
186
|
+
- Workflow-entry and reference stub:
|
|
187
|
+
- `products/sdtk-ops/governance/usage-guide.md`
|
|
188
|
+
- Package landing page:
|
|
189
|
+
- `products/sdtk-ops/distribution/sdtk-ops-kit/README.md`
|
|
190
|
+
- Runtime routing inventory:
|
|
191
|
+
- `products/sdtk-ops/toolkit/AGENTS.md`
|
|
192
|
+
- Release docs:
|
|
193
|
+
- `products/sdtk-ops/governance/release-packaging.md`
|
|
194
|
+
- `products/sdtk-ops/governance/release-evidence.md`
|
|
195
|
+
|
|
196
|
+
## 8. Scope
|
|
197
|
+
|
|
198
|
+
`SDTK-OPS` v1 contains 15 core skills and stays cloud-agnostic.
|
|
199
|
+
|
|
200
|
+
Not part of the current supported wave:
|
|
201
|
+
- provider-specific packs such as AWS, GCP, or Azure variants
|
|
202
|
+
- a workflow-first CLI command suite such as `sdtk-ops deploy`
|
|
203
|
+
- cloud, Kubernetes, or production-topology guarantees beyond the current validated local Docker proof
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "sdtk-ops-kit",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.3",
|
|
4
4
|
"description": "Skill-driven operations toolkit for deployment, verification, monitoring, incident response, backup, security, compliance, and cost discipline.",
|
|
5
5
|
"bin": {
|
|
6
6
|
"sdtk-ops": "./bin/sdtk-ops.js"
|
package/src/commands/help.js
CHANGED
|
@@ -10,37 +10,48 @@ function cmdHelp() {
|
|
|
10
10
|
"Commands:",
|
|
11
11
|
" init Initialize SDTK-OPS files in a project",
|
|
12
12
|
" runtime Manage runtime asset installation (install, uninstall, status)",
|
|
13
|
+
" update Refresh the npm package and optionally re-apply managed project/runtime assets",
|
|
13
14
|
" help Show this help message",
|
|
14
15
|
"",
|
|
15
|
-
"Current supported surface:",
|
|
16
|
-
" Supported now: help, init, runtime install|status|uninstall",
|
|
17
|
-
" Not supported: generate",
|
|
18
|
-
" Package scope: public npm package",
|
|
19
|
-
"",
|
|
20
|
-
"DEV-Run intake:",
|
|
21
|
-
" Canonical intake artifact: docs/dev/OPS_HANDOFF_[FEATURE_KEY].json",
|
|
22
|
-
" READY_FOR_SDTK_OPS: start from suggested_next_ops_path or confirm it with ops-discover.",
|
|
23
|
-
" BLOCKED_FOR_SDTK_OPS: inspect blockers and evidence refs, but do not treat it as normal ready-path execution.",
|
|
24
|
-
" SDTK-OPS consumes the frozen handoff contract and does not redefine the schema.",
|
|
25
|
-
"",
|
|
26
|
-
"Workflow entry:",
|
|
27
|
-
" After init, choose a journey directly if the goal is clear.",
|
|
28
|
-
" Canonical journeys: deployment, incident, monitoring, backup/recovery.",
|
|
29
|
-
" If the correct path is unclear, start with the ops-discover skill.",
|
|
30
|
-
" ops-parallel remains valid only for independent slices; if collab/subagent dispatch is unavailable in the active runtime, keep the same split but execute sequentially.",
|
|
31
|
-
" Close every journey with ops-verify before declaring work complete.",
|
|
32
|
-
"",
|
|
33
|
-
"Runtime support:",
|
|
34
|
-
" Claude: project + user scope",
|
|
35
|
-
" Codex: default user scope plus bounded project scope via <project>/.codex",
|
|
36
|
-
" Codex project scope requires the explicit local CODEX_HOME=<project>/.codex contract",
|
|
37
|
-
" Native .codex/skills auto-discovery is not claimed",
|
|
16
|
+
"Current supported surface:",
|
|
17
|
+
" Supported now: help, init, runtime install|status|uninstall",
|
|
18
|
+
" Not supported: generate",
|
|
19
|
+
" Package scope: public npm package",
|
|
20
|
+
"",
|
|
21
|
+
"DEV-Run intake:",
|
|
22
|
+
" Canonical intake artifact: docs/dev/OPS_HANDOFF_[FEATURE_KEY].json",
|
|
23
|
+
" READY_FOR_SDTK_OPS: start from suggested_next_ops_path or confirm it with ops-discover.",
|
|
24
|
+
" BLOCKED_FOR_SDTK_OPS: inspect blockers and evidence refs, but do not treat it as normal ready-path execution.",
|
|
25
|
+
" SDTK-OPS consumes the frozen handoff contract and does not redefine the schema.",
|
|
26
|
+
"",
|
|
27
|
+
"Workflow entry:",
|
|
28
|
+
" After init, choose a journey directly if the goal is clear.",
|
|
29
|
+
" Canonical journeys: deployment, incident, monitoring, backup/recovery.",
|
|
30
|
+
" If the correct path is unclear, start with the ops-discover skill.",
|
|
31
|
+
" ops-parallel remains valid only for independent slices; if collab/subagent dispatch is unavailable in the active runtime, keep the same split but execute sequentially.",
|
|
32
|
+
" Close every journey with ops-verify before declaring work complete.",
|
|
33
|
+
"",
|
|
34
|
+
"Runtime support:",
|
|
35
|
+
" Claude: project + user scope",
|
|
36
|
+
" Codex: default user scope plus bounded project scope via <project>/.codex",
|
|
37
|
+
" Codex project scope requires the explicit local CODEX_HOME=<project>/.codex contract",
|
|
38
|
+
" Native .codex/skills auto-discovery is not claimed",
|
|
38
39
|
"",
|
|
39
40
|
"Runtime commands:",
|
|
40
41
|
" sdtk-ops runtime install --runtime <codex|claude> [--scope <project|user>] [--project-path <path>]",
|
|
41
42
|
" sdtk-ops runtime uninstall --runtime <codex|claude> [--scope <project|user>] [--all] [--project-path <path>]",
|
|
42
43
|
" sdtk-ops runtime status --runtime <codex|claude> [--project-path <path>]",
|
|
43
44
|
"",
|
|
45
|
+
"Update options:",
|
|
46
|
+
" --version <latest|x.y.z> Target published npm package version (default: latest)",
|
|
47
|
+
" --runtime <codex|claude> Optional runtime refresh target after npm update",
|
|
48
|
+
" --scope <project|user> Runtime asset scope when --runtime is provided",
|
|
49
|
+
" --project-path <path> Target project directory for managed file refresh (default: cwd)",
|
|
50
|
+
" --check-only Print the planned npm/init/runtime refresh steps without making changes",
|
|
51
|
+
" --skip-project-files Skip sdtk-ops init --force during update",
|
|
52
|
+
" --skip-runtime-assets Skip sdtk-ops runtime install --force during update",
|
|
53
|
+
" --verbose Show detailed command output",
|
|
54
|
+
"",
|
|
44
55
|
"Uninstall behavior:",
|
|
45
56
|
" runtime uninstall removes only SDTK-OPS-managed skill folders for the selected runtime/scope.",
|
|
46
57
|
" It does not delete parent runtime roots such as .claude/, .claude/skills/, $CODEX_HOME/, or $CODEX_HOME/skills/.",
|
|
@@ -53,10 +64,13 @@ function cmdHelp() {
|
|
|
53
64
|
"Examples:",
|
|
54
65
|
" sdtk-ops --help",
|
|
55
66
|
" sdtk-ops --version",
|
|
56
|
-
" sdtk-ops init --runtime claude --project-path ./my-project",
|
|
57
|
-
" sdtk-ops
|
|
58
|
-
" sdtk-ops
|
|
59
|
-
" sdtk-ops
|
|
67
|
+
" sdtk-ops init --runtime claude --project-path ./my-project",
|
|
68
|
+
" sdtk-ops update --check-only",
|
|
69
|
+
" sdtk-ops update --runtime claude --project-path ./my-project",
|
|
70
|
+
" sdtk-ops update --version 1.2.3 --runtime codex --scope user --skip-project-files",
|
|
71
|
+
" sdtk-ops init --runtime codex --runtime-scope project --project-path ./my-project",
|
|
72
|
+
" sdtk-ops runtime install --runtime claude --scope project --project-path ./my-project",
|
|
73
|
+
" sdtk-ops runtime install --runtime codex --scope project --project-path ./my-project",
|
|
60
74
|
" # Journey routing after init:",
|
|
61
75
|
" # deployment -> ops-plan -> ops-infra-plan -> ops-container -> ops-ci-cd -> ops-deploy -> ops-monitor -> ops-verify",
|
|
62
76
|
" # incident -> ops-incident -> ops-debug -> ops-monitor -> ops-verify",
|
package/src/index.js
CHANGED
|
@@ -1,65 +1,68 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
const { cmdHelp } = require("./commands/help");
|
|
4
|
-
const { cmdInit } = require("./commands/init");
|
|
5
|
-
const { cmdRuntime } = require("./commands/runtime");
|
|
6
|
-
const {
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
1
|
+
"use strict";
|
|
2
|
+
|
|
3
|
+
const { cmdHelp } = require("./commands/help");
|
|
4
|
+
const { cmdInit } = require("./commands/init");
|
|
5
|
+
const { cmdRuntime } = require("./commands/runtime");
|
|
6
|
+
const { cmdUpdate } = require("./commands/update");
|
|
7
|
+
const { ValidationError } = require("./lib/errors");
|
|
8
|
+
|
|
9
|
+
const COMMANDS = new Set(["help", "version", "init", "runtime", "update"]);
|
|
10
|
+
|
|
11
|
+
function getVersion() {
|
|
12
|
+
const pkg = require("../package.json");
|
|
13
|
+
return pkg.version;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
function parseCommand(argv) {
|
|
17
|
+
if (!argv || argv.length === 0) {
|
|
18
|
+
return { command: "help", args: [] };
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
const [first, ...rest] = argv;
|
|
22
|
+
if (first === "-h" || first === "--help") {
|
|
23
|
+
return { command: "help", args: [] };
|
|
24
|
+
}
|
|
25
|
+
if (first === "-v" || first === "--version") {
|
|
26
|
+
return { command: "version", args: [] };
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
return { command: first, args: rest };
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
async function run(argv) {
|
|
33
|
+
const { command, args } = parseCommand(argv);
|
|
34
|
+
|
|
35
|
+
if (command === "generate") {
|
|
36
|
+
throw new ValidationError(
|
|
37
|
+
'The "generate" command is not part of the supported SDTK-OPS workflow-entry surface. Supported commands: help, init, runtime. If the correct journey is unclear, start with the "ops-discover" skill.'
|
|
38
|
+
);
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
if (!COMMANDS.has(command)) {
|
|
42
|
+
throw new ValidationError(
|
|
43
|
+
`Unknown command: "${command}". Run "sdtk-ops --help" for available commands.`
|
|
44
|
+
);
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
switch (command) {
|
|
48
|
+
case "help":
|
|
49
|
+
return cmdHelp();
|
|
50
|
+
case "version":
|
|
51
|
+
console.log(`sdtk-ops-kit ${getVersion()}`);
|
|
52
|
+
return 0;
|
|
53
|
+
case "init":
|
|
54
|
+
return cmdInit(args);
|
|
55
|
+
case "runtime":
|
|
56
|
+
return cmdRuntime(args);
|
|
57
|
+
case "update":
|
|
58
|
+
return cmdUpdate(args);
|
|
59
|
+
default:
|
|
60
|
+
throw new ValidationError(`Unsupported command: "${command}".`);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
module.exports = {
|
|
65
|
+
getVersion,
|
|
66
|
+
parseCommand,
|
|
67
|
+
run,
|
|
68
|
+
};
|