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.
@@ -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
- - supports user scope only
173
- - default scope is user
174
- - uses collision-avoiding `sdtk-ops-*` skill directory names
175
- - project scope remains blocked by Gate C0
176
-
177
- ## 7. Documentation Map
178
-
179
- Use these documents by role:
180
-
181
- - Canonical end-user install and usage guide:
182
- - `products/sdtk-ops/governance/SDTKOPS_TOOLKIT_USAGE_GUIDE.md`
183
- - Install-truth and smoke appendix:
184
- - `products/sdtk-ops/governance/installation-runbook.md`
185
- - Workflow-entry and reference stub:
186
- - `products/sdtk-ops/governance/usage-guide.md`
187
- - Package landing page:
188
- - `products/sdtk-ops/distribution/sdtk-ops-kit/README.md`
189
- - Runtime routing inventory:
190
- - `products/sdtk-ops/toolkit/AGENTS.md`
191
- - Release docs:
192
- - `products/sdtk-ops/governance/release-packaging.md`
193
- - `products/sdtk-ops/governance/release-evidence.md`
194
-
195
- ## 8. Scope
196
-
197
- `SDTK-OPS` v1 contains 15 core skills and stays cloud-agnostic.
198
-
199
- Not part of the current supported wave:
200
- - provider-specific packs such as AWS, GCP, or Azure variants
201
- - a workflow-first CLI command suite such as `sdtk-ops deploy`
202
- - cloud, Kubernetes, or production-topology guarantees beyond the current validated local Docker proof
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.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"
@@ -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 init --runtime codex --runtime-scope project --project-path ./my-project",
58
- " sdtk-ops runtime install --runtime claude --scope project --project-path ./my-project",
59
- " sdtk-ops runtime install --runtime codex --scope project --project-path ./my-project",
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",
@@ -0,0 +1,11 @@
1
+ "use strict";
2
+
3
+ const { executeUpdate } = require("../lib/update");
4
+
5
+ async function cmdUpdate(args) {
6
+ return executeUpdate(args);
7
+ }
8
+
9
+ module.exports = {
10
+ cmdUpdate,
11
+ };
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 { ValidationError } = require("./lib/errors");
7
-
8
- const COMMANDS = new Set(["help", "version", "init", "runtime"]);
9
-
10
- function getVersion() {
11
- const pkg = require("../package.json");
12
- return pkg.version;
13
- }
14
-
15
- function parseCommand(argv) {
16
- if (!argv || argv.length === 0) {
17
- return { command: "help", args: [] };
18
- }
19
-
20
- const [first, ...rest] = argv;
21
- if (first === "-h" || first === "--help") {
22
- return { command: "help", args: [] };
23
- }
24
- if (first === "-v" || first === "--version") {
25
- return { command: "version", args: [] };
26
- }
27
-
28
- return { command: first, args: rest };
29
- }
30
-
31
- async function run(argv) {
32
- const { command, args } = parseCommand(argv);
33
-
34
- if (command === "generate") {
35
- throw new ValidationError(
36
- '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.'
37
- );
38
- }
39
-
40
- if (!COMMANDS.has(command)) {
41
- throw new ValidationError(
42
- `Unknown command: "${command}". Run "sdtk-ops --help" for available commands.`
43
- );
44
- }
45
-
46
- switch (command) {
47
- case "help":
48
- return cmdHelp();
49
- case "version":
50
- console.log(`sdtk-ops-kit ${getVersion()}`);
51
- return 0;
52
- case "init":
53
- return cmdInit(args);
54
- case "runtime":
55
- return cmdRuntime(args);
56
- default:
57
- throw new ValidationError(`Unsupported command: "${command}".`);
58
- }
59
- }
60
-
61
- module.exports = {
62
- getVersion,
63
- parseCommand,
64
- run,
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
+ };