sdtk-ops-kit 0.2.1 → 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.
Files changed (43) hide show
  1. package/README.md +95 -8
  2. package/assets/manifest/toolkit-bundle.manifest.json +66 -66
  3. package/assets/manifest/toolkit-bundle.sha256.txt +32 -32
  4. package/assets/toolkit/toolkit/AGENTS.md +30 -2
  5. package/assets/toolkit/toolkit/SDTKOPS_TOOLKIT.md +203 -166
  6. package/assets/toolkit/toolkit/install.ps1 +1 -8
  7. package/assets/toolkit/toolkit/scripts/install-codex-skills.ps1 +30 -7
  8. package/assets/toolkit/toolkit/scripts/uninstall-codex-skills.ps1 +31 -2
  9. package/assets/toolkit/toolkit/sdtk-spec.config.profiles.example.json +12 -12
  10. package/assets/toolkit/toolkit/skills/ops-backup/SKILL.md +0 -2
  11. package/assets/toolkit/toolkit/skills/ops-backup/references/backup-script-patterns.md +0 -2
  12. package/assets/toolkit/toolkit/skills/ops-ci-cd/SKILL.md +0 -2
  13. package/assets/toolkit/toolkit/skills/ops-ci-cd/references/pipeline-examples.md +0 -2
  14. package/assets/toolkit/toolkit/skills/ops-container/SKILL.md +0 -2
  15. package/assets/toolkit/toolkit/skills/ops-container/references/k8s-manifest-patterns.md +0 -2
  16. package/assets/toolkit/toolkit/skills/ops-cost/SKILL.md +0 -2
  17. package/assets/toolkit/toolkit/skills/ops-debug/SKILL.md +0 -1
  18. package/assets/toolkit/toolkit/skills/ops-debug/references/root-cause-tracing.md +0 -1
  19. package/assets/toolkit/toolkit/skills/ops-deploy/SKILL.md +0 -2
  20. package/assets/toolkit/toolkit/skills/ops-discover/SKILL.md +21 -0
  21. package/assets/toolkit/toolkit/skills/ops-incident/SKILL.md +0 -2
  22. package/assets/toolkit/toolkit/skills/ops-incident/references/communication-templates.md +0 -2
  23. package/assets/toolkit/toolkit/skills/ops-incident/references/postmortem-template.md +0 -2
  24. package/assets/toolkit/toolkit/skills/ops-incident/references/runbook-template.md +0 -2
  25. package/assets/toolkit/toolkit/skills/ops-infra-plan/SKILL.md +1 -3
  26. package/assets/toolkit/toolkit/skills/ops-infra-plan/references/iac-patterns.md +0 -2
  27. package/assets/toolkit/toolkit/skills/ops-monitor/SKILL.md +0 -2
  28. package/assets/toolkit/toolkit/skills/ops-monitor/references/alert-rules.md +0 -2
  29. package/assets/toolkit/toolkit/skills/ops-monitor/references/slo-templates.md +0 -2
  30. package/assets/toolkit/toolkit/skills/ops-parallel/SKILL.md +22 -5
  31. package/assets/toolkit/toolkit/skills/ops-plan/SKILL.md +33 -1
  32. package/assets/toolkit/toolkit/skills/ops-security-infra/SKILL.md +1 -3
  33. package/assets/toolkit/toolkit/skills/ops-security-infra/references/cicd-security-pipeline.md +0 -2
  34. package/assets/toolkit/toolkit/skills/ops-security-infra/references/security-headers.md +0 -2
  35. package/assets/toolkit/toolkit/skills/ops-verify/SKILL.md +16 -1
  36. package/package.json +1 -1
  37. package/src/commands/help.js +88 -53
  38. package/src/commands/init.js +10 -1
  39. package/src/commands/runtime.js +29 -7
  40. package/src/commands/update.js +11 -0
  41. package/src/index.js +68 -65
  42. package/src/lib/scope.js +19 -2
  43. package/src/lib/update.js +337 -0
package/README.md CHANGED
@@ -6,13 +6,12 @@
6
6
 
7
7
  - Package: `sdtk-ops-kit`
8
8
  - CLI: `sdtk-ops`
9
- - Current public version: `0.2.1`
10
- - Patch note: `0.2.1` corrects stale help-surface wording that shipped in `0.2.0`
9
+ - Latest published version lookup: `npm view sdtk-ops-kit version`
11
10
 
12
11
  ## Install
13
12
 
14
13
  ```bash
15
- npm install -g sdtk-ops-kit@0.2.1
14
+ npm install -g sdtk-ops-kit
16
15
  ```
17
16
 
18
17
  Then verify the installed command:
@@ -22,6 +21,43 @@ sdtk-ops --version
22
21
  sdtk-ops --help
23
22
  ```
24
23
 
24
+ If you need the exact latest published version number, run:
25
+
26
+ ```bash
27
+ npm view sdtk-ops-kit version
28
+ ```
29
+
30
+ ## Update Existing Installation
31
+
32
+ Use the public `update` command when `sdtk-ops-kit` is already installed and you want the newest published package line.
33
+
34
+ ```bash
35
+ sdtk-ops update --check-only
36
+ sdtk-ops update --runtime claude --project-path ./my-project
37
+ ```
38
+
39
+ Codex user-scope variant:
40
+
41
+ ```bash
42
+ sdtk-ops update --runtime codex --scope user --project-path ./my-project
43
+ ```
44
+
45
+ Project-local Codex refresh is also supported, but only when you intentionally launch the runtime with the explicit local `CODEX_HOME=<project>/.codex` contract. Native `.codex/skills` auto-discovery is still not claimed.
46
+
47
+ Then verify:
48
+
49
+ ```bash
50
+ sdtk-ops --version
51
+ sdtk-ops runtime status --runtime claude --project-path ./my-project
52
+ ```
53
+
54
+ Important truth:
55
+ - `sdtk-ops update` still uses `npm install -g sdtk-ops-kit@<target>` as the package refresh mechanism
56
+ - `update --check-only` is non-destructive and prints the planned commands only
57
+ - `init --force` refreshes managed project files
58
+ - `runtime install --force` refreshes managed runtime assets
59
+ - existing ops evidence is not rewritten automatically
60
+
25
61
  ## Supported Command Surface
26
62
 
27
63
  `SDTK-OPS` keeps a deliberately small CLI surface.
@@ -30,6 +66,7 @@ sdtk-ops --help
30
66
  |---|---|
31
67
  | `sdtk-ops help` | Show the supported command surface and routing guidance |
32
68
  | `sdtk-ops init` | Copy shared project files and prepare runtime installation |
69
+ | `sdtk-ops update` | Refresh the installed package line and optionally rerun bounded managed-file/runtime refresh steps |
33
70
  | `sdtk-ops runtime install` | Install runtime assets for Claude or Codex |
34
71
  | `sdtk-ops runtime status` | Check installed runtime assets |
35
72
  | `sdtk-ops runtime uninstall` | Remove runtime assets cleanly |
@@ -43,13 +80,34 @@ Not supported:
43
80
  | Runtime | Project Scope | User Scope | Notes |
44
81
  |---|:---:|:---:|---|
45
82
  | Claude | Yes | Yes | Default scope is project |
46
- | Codex | No | Yes | Gate C0 blocks project-local install |
83
+ | Codex | Yes | Yes | Default scope is user; project-local installs require the explicit local `CODEX_HOME=<project>/.codex` contract |
47
84
 
48
85
  Important truth:
49
86
  - Claude supports `project` and `user` scope.
50
- - Codex supports `user` scope only.
87
+ - Codex defaults to `user` scope and supports `project` scope only through the explicit local `CODEX_HOME=<project>/.codex` contract.
51
88
  - Codex installs collision-avoiding `sdtk-ops-*` skill names.
52
89
 
90
+ ## Remove Runtime Assets vs Remove the Package
91
+
92
+ `runtime uninstall` removes only the SDTK-OPS-managed skill folders for the selected runtime and scope.
93
+ It does not delete `.claude/`, `.claude/skills/`, `$CODEX_HOME/`, or `$CODEX_HOME/skills/`, because those roots may contain non-SDTK user assets.
94
+
95
+ Use runtime cleanup first:
96
+
97
+ ```bash
98
+ sdtk-ops runtime uninstall --runtime claude --scope project --project-path ./my-project
99
+ sdtk-ops runtime uninstall --runtime claude --scope user
100
+ sdtk-ops runtime uninstall --runtime codex --all
101
+ ```
102
+
103
+ Use npm uninstall separately when you also want to remove the globally installed CLI package:
104
+
105
+ ```bash
106
+ npm uninstall -g sdtk-ops-kit
107
+ ```
108
+
109
+ That npm command removes the package only. It does not remove runtime assets already copied into Claude or Codex skill directories.
110
+
53
111
  ## Quick Start
54
112
 
55
113
  ### 1. Initialize a project
@@ -83,13 +141,13 @@ Codex user scope:
83
141
  sdtk-ops runtime install --runtime codex --scope user
84
142
  ```
85
143
 
86
- Gate C0:
144
+ Codex project-local scope, only when you intentionally launch with `CODEX_HOME=<project>/.codex`:
87
145
 
88
146
  ```bash
89
- sdtk-ops runtime install --runtime codex --scope project
147
+ sdtk-ops runtime install --runtime codex --scope project --project-path ./my-project
90
148
  ```
91
149
 
92
- The Codex project-scope command must fail. That rejection is the correct product behavior.
150
+ Project-local Codex installs remain bounded explicit-local support. Native `.codex/skills` auto-discovery is not claimed.
93
151
 
94
152
  ### 3. Choose the right skill journey
95
153
 
@@ -103,6 +161,35 @@ Canonical journeys:
103
161
 
104
162
  Always close work with `ops-verify`.
105
163
 
164
+ ## DEV-Run Intake Contract
165
+
166
+ When operationalization begins from `SDTK-CODE`, the only canonical intake artifact is:
167
+
168
+ - `docs/dev/OPS_HANDOFF_[FEATURE_KEY].json`
169
+
170
+ `SDTK-OPS` consumes that frozen contract as input.
171
+ It does not redefine the schema, rename fields, or move the canonical handoff path.
172
+
173
+ Ready-path intake:
174
+ - inspect `handoff_status`
175
+ - if status is `READY_FOR_SDTK_OPS`, start from `suggested_next_ops_path.start_with`
176
+ - treat `suggested_next_ops_path.suggested_chain` as the default route unless fresh evidence requires a bounded reroute
177
+ - close accepted work with `suggested_next_ops_path.close_with`, normally `ops-verify`
178
+
179
+ Blocked-path intake:
180
+ - if status is `BLOCKED_FOR_SDTK_OPS`, the handoff is still inspectable
181
+ - inspect `open_blockers`, `code_evidence_refs`, and the prerequisite fields before choosing the next step
182
+ - do not treat blocked handoff state as normal ready-path execution
183
+
184
+ Minimum OPS evidence expectations for this wave:
185
+ - record the consumed handoff path and `handoff_status`
186
+ - record whether the chosen first OPS step followed or overrode `suggested_next_ops_path`, and why
187
+ - record checked prerequisites, assumptions, dependencies, observability requirements, and rollback or recovery expectations
188
+ - record journey-specific operational evidence
189
+ - record final `ops-verify` closeout evidence
190
+
191
+ This wave does not define a final OPS evidence schema and does not implement QA bridge logic.
192
+
106
193
  ## Product Boundary
107
194
 
108
195
  `SDTK-OPS` is the downstream operations product in the `SDTK-SPEC -> SDTK-CODE -> SDTK-OPS` family.
@@ -1,17 +1,17 @@
1
1
  {
2
- "version": "0.2.1",
3
- "sourceCommit": "97ca3bf78f08840f29c6a3f0353c9d38793d31e5",
2
+ "version": "0.2.3",
3
+ "sourceCommit": "5b21b7376fcf11a9138f486921de5e07e0c88ac7",
4
4
  "fileCount": 36,
5
5
  "files": [
6
6
  {
7
7
  "path": "toolkit/AGENTS.md",
8
- "sha256": "be7565adbd8d38dd90bc350eaecbd058cc8acb2a549b7e648d469b1f57916bbc",
9
- "size": 4146
8
+ "sha256": "a1a8d03564680cde44ef34e1878f3c8fb6ad7ce79e79b7ba7274fdb072321f30",
9
+ "size": 5925
10
10
  },
11
11
  {
12
12
  "path": "toolkit/install.ps1",
13
- "sha256": "bcb77479f810e8449ea6e68fc775ea92758d2501e2bc29428d0c980fd996d5c6",
14
- "size": 3210
13
+ "sha256": "ac041e80d0771b13fc1dc94c6a572debaddba223ff4d029695a6953f35ebaa92",
14
+ "size": 3015
15
15
  },
16
16
  {
17
17
  "path": "toolkit/scripts/install-claude-skills.ps1",
@@ -20,8 +20,8 @@
20
20
  },
21
21
  {
22
22
  "path": "toolkit/scripts/install-codex-skills.ps1",
23
- "sha256": "ebd12d2fef1f3080a3a9d173d6a4dac4358b69d506fd7a37e347bb11a9936d9c",
24
- "size": 3980
23
+ "sha256": "68eb662bc9b8906882d32f6cd1247238f6ae663137a489f18054a75724cd1e81",
24
+ "size": 4761
25
25
  },
26
26
  {
27
27
  "path": "toolkit/scripts/uninstall-claude-skills.ps1",
@@ -30,13 +30,13 @@
30
30
  },
31
31
  {
32
32
  "path": "toolkit/scripts/uninstall-codex-skills.ps1",
33
- "sha256": "290301c13e3e39adec2f76b2611383037544a4f05f4a030907429295ff8e9dc8",
34
- "size": 1517
33
+ "sha256": "fdb9631a80ecfb0d986a52a2833e88bf15c5303ab654d35bad6d64cca43046e8",
34
+ "size": 2428
35
35
  },
36
36
  {
37
37
  "path": "toolkit/SDTKOPS_TOOLKIT.md",
38
- "sha256": "8c971775d71d70aab59e5b36e0fdb631922ce79ef139fbf77ff27258ce3fac7a",
39
- "size": 5921
38
+ "sha256": "bed302b782f0c1729c8010877207a67bbc4c3032209186a54bac280d468cf5c8",
39
+ "size": 8171
40
40
  },
41
41
  {
42
42
  "path": "toolkit/sdtk-spec.config.json",
@@ -45,28 +45,28 @@
45
45
  },
46
46
  {
47
47
  "path": "toolkit/sdtk-spec.config.profiles.example.json",
48
- "sha256": "2c1668df46aa57dba06c2c924a60f6c1667a1d4551b4eb70fb18c190356a2180",
49
- "size": 312
48
+ "sha256": "de0310b0c69f77d1c1601b94b0ea72b2c83c92cb8ee94d2f4a1759ceb58f2fd4",
49
+ "size": 315
50
50
  },
51
51
  {
52
52
  "path": "toolkit/skills/ops-backup/references/backup-script-patterns.md",
53
- "sha256": "bcb9252a08b98e7a6a92057153f8f8882b948149b3897bee5e9328cd456de025",
54
- "size": 3173
53
+ "sha256": "1cd81e12cebdb2be528803e2d8afe43959aab1493e55499af529b99ec566a56c",
54
+ "size": 3071
55
55
  },
56
56
  {
57
57
  "path": "toolkit/skills/ops-backup/SKILL.md",
58
- "sha256": "99bee57db26fb09714da32dffff8172da9222e5182039fbc659a08007d4ce205",
59
- "size": 3639
58
+ "sha256": "76e8385190d967bf98b3cafbbf8925d9b9c656ee7a7ed66ff51285b6459ebff1",
59
+ "size": 3537
60
60
  },
61
61
  {
62
62
  "path": "toolkit/skills/ops-ci-cd/references/pipeline-examples.md",
63
- "sha256": "ec5ae90ebceb679554a8ec977ff27327ae608f1d5852170665a8a581cc9faea2",
64
- "size": 2359
63
+ "sha256": "d27e47b0c832656c2835e3d3e32dae7c86419014199439b10fc6823956324716",
64
+ "size": 2257
65
65
  },
66
66
  {
67
67
  "path": "toolkit/skills/ops-ci-cd/SKILL.md",
68
- "sha256": "b0752e0452a85423817f17e2e3321e88fd5186579ae816ccb4b2cd105f45871c",
69
- "size": 2759
68
+ "sha256": "c9bf8e6f602d6201ccd54a78a9a7f850028924b460d60495d144bd5ec473c5e6",
69
+ "size": 2657
70
70
  },
71
71
  {
72
72
  "path": "toolkit/skills/ops-compliance/SKILL.md",
@@ -75,113 +75,113 @@
75
75
  },
76
76
  {
77
77
  "path": "toolkit/skills/ops-container/references/k8s-manifest-patterns.md",
78
- "sha256": "131711d0af5d4dc4227e4b2669a910d05d50c80b4f82a47e0a13699d8e5a9f10",
79
- "size": 2339
78
+ "sha256": "070ebcad0d0cb71cd3815de6e4c78d22517a28f825d65ea3677215e57112d1df",
79
+ "size": 2237
80
80
  },
81
81
  {
82
82
  "path": "toolkit/skills/ops-container/SKILL.md",
83
- "sha256": "7834e362ef5f3d6628acb4653997d9eab379bc7dff372280728fd5aa6abf087a",
84
- "size": 3643
83
+ "sha256": "7eb1113162af029886974d2dba6553fec6ba9b002adc31a18c427a5e471d48a3",
84
+ "size": 3541
85
85
  },
86
86
  {
87
87
  "path": "toolkit/skills/ops-cost/SKILL.md",
88
- "sha256": "e0e791f153b31ee75d012a26b01f4f6be50aed4fe4268bd02c6a76debba52a1d",
89
- "size": 3458
88
+ "sha256": "3000b78ad911d667b056efdc01c639d8e069c1df1b157c6a6721ba2c61cce678",
89
+ "size": 3356
90
90
  },
91
91
  {
92
92
  "path": "toolkit/skills/ops-debug/references/root-cause-tracing.md",
93
- "sha256": "d30c380152237d92f102b8db1849baa3d7a082c4e42e9ba9174d7ef49000672f",
94
- "size": 3965
93
+ "sha256": "d70b59d276edf5c6c8aebb5fc669b8f6d04673fc8e8561cbaf4d7e5fb9f4e2f2",
94
+ "size": 3875
95
95
  },
96
96
  {
97
97
  "path": "toolkit/skills/ops-debug/SKILL.md",
98
- "sha256": "ddedf16d59fae6e54cddae23b5bf24f2878ff23f17d81a88298e021c25401d1c",
99
- "size": 11156
98
+ "sha256": "d5f58322afebcf5c3a110b02de0d2eec4494f9ed9d358b113b6717275c3524af",
99
+ "size": 11066
100
100
  },
101
101
  {
102
102
  "path": "toolkit/skills/ops-deploy/SKILL.md",
103
- "sha256": "a18ec9032e4e2c14e5daa1984cb8260e1d735fc38a44926fe037f0f2b99fcd33",
104
- "size": 4214
103
+ "sha256": "c2cacc94ffba4d7ef84e635c2078e08abb8d52f79afbbb1534661c0e0cf9bda6",
104
+ "size": 4068
105
105
  },
106
106
  {
107
107
  "path": "toolkit/skills/ops-discover/SKILL.md",
108
- "sha256": "4a0c7f482e1666a538038ea9b25314cd0333754c413af7bde7b74d0cddb868c7",
109
- "size": 4453
108
+ "sha256": "6f38c9b2ab972f272fb86e17926585a9a254a1c48c8454459a61315d4bd81d81",
109
+ "size": 5617
110
110
  },
111
111
  {
112
112
  "path": "toolkit/skills/ops-incident/references/communication-templates.md",
113
- "sha256": "396e951ef529f1ae8c4d6db6773f383d35c5e14d666399583640cd2f1811f93b",
114
- "size": 1102
113
+ "sha256": "f6102d127e47861068b285ebbbb2045e4c3dc8cd9af73b3c975f285f2141639e",
114
+ "size": 1000
115
115
  },
116
116
  {
117
117
  "path": "toolkit/skills/ops-incident/references/postmortem-template.md",
118
- "sha256": "5eebfd217bf7ea2bb2d59c9d30ab77d04277d78cf42114f044f6ad998040f926",
119
- "size": 2110
118
+ "sha256": "fda6d9cadc5a3757e5559798a67716a6356809735b076d47d6bd99a993b71b99",
119
+ "size": 2008
120
120
  },
121
121
  {
122
122
  "path": "toolkit/skills/ops-incident/references/runbook-template.md",
123
- "sha256": "b6479d8ef31c2a4fd8242219bb02b87ce8babffa70fc219fe7e5db408471f326",
124
- "size": 1672
123
+ "sha256": "358644dcd477fe32d3368ced5c9da30663ae3d54fdd5e825ae3e56327f7f6f2d",
124
+ "size": 1570
125
125
  },
126
126
  {
127
127
  "path": "toolkit/skills/ops-incident/SKILL.md",
128
- "sha256": "a5fa64bcd10ff0d04ca8cd25e883a3a667034a726162cfaff63252719081a834",
129
- "size": 4230
128
+ "sha256": "df03ad86862020941e69b90ea1f2ccf8cd69762e53f0a539936c16fb433e61c8",
129
+ "size": 4128
130
130
  },
131
131
  {
132
132
  "path": "toolkit/skills/ops-infra-plan/references/iac-patterns.md",
133
- "sha256": "fe767ccec7a8efb84ddfa8097eea9cb92c1e9d7f478ab89632b0516b738b5e20",
134
- "size": 4136
133
+ "sha256": "14f02a1921cb58e2c54c355c0b24ffdf5a9bdb91a7be6921f22da5974787efee",
134
+ "size": 3990
135
135
  },
136
136
  {
137
137
  "path": "toolkit/skills/ops-infra-plan/SKILL.md",
138
- "sha256": "8c1b5583b3ba9761311a950cb7ab24c1abe573903ded68484bcf0811435feb5c",
139
- "size": 4621
138
+ "sha256": "35eec623e41603dae0a1a328c1e6d822d2e1dc79a471f06bab3c1f3e2d552e53",
139
+ "size": 4442
140
140
  },
141
141
  {
142
142
  "path": "toolkit/skills/ops-monitor/references/alert-rules.md",
143
- "sha256": "6deee66c8b0c65219fe907934382b0c9cdba007a971a98af54f703b6360f3c56",
144
- "size": 2607
143
+ "sha256": "28be1bd1babdaa3de9fc58f859060697c31b9249cc684c9c4272a9c3bc159db9",
144
+ "size": 2505
145
145
  },
146
146
  {
147
147
  "path": "toolkit/skills/ops-monitor/references/slo-templates.md",
148
- "sha256": "a1d8fe86ba90287cf21cc204478949002e4d28103496dd46b60a2b5fef55d2b2",
149
- "size": 2205
148
+ "sha256": "af28797b442fb94fa96dc0182881847e50b5fe9e68ecf7a71471502030f4bd27",
149
+ "size": 2103
150
150
  },
151
151
  {
152
152
  "path": "toolkit/skills/ops-monitor/SKILL.md",
153
- "sha256": "83058acaf39ee925d90ba0f04a4e4e2be584fe90de540d4bdedab61d9a3c85dc",
154
- "size": 4394
153
+ "sha256": "2d09968790ed63dd8e0969f59023c0ced71dd182d56475689a2d3bfc3f889002",
154
+ "size": 4292
155
155
  },
156
156
  {
157
157
  "path": "toolkit/skills/ops-parallel/SKILL.md",
158
- "sha256": "c5273d155c67bcade47868b4cd5a1f7e9c66e5bb864616036b1cc22676f25ecf",
159
- "size": 6258
158
+ "sha256": "8c83a7f267b7222cf9765a4328dd6945e30f3629dfca21cd85f7439f501b8ee0",
159
+ "size": 7277
160
160
  },
161
161
  {
162
162
  "path": "toolkit/skills/ops-plan/SKILL.md",
163
- "sha256": "e405117c97e3475dee69133e31759e3ce0926fb6a83929eab55a95509b213c38",
164
- "size": 5730
163
+ "sha256": "db75109542354b70a9502231f6c66803642c013958eedb93a26770f28b9e7fad",
164
+ "size": 7170
165
165
  },
166
166
  {
167
167
  "path": "toolkit/skills/ops-security-infra/references/cicd-security-pipeline.md",
168
- "sha256": "8876ffa8cfc97335fb68063270b2bffdb3cd0630663123008575a8b98ea485a8",
169
- "size": 1275
168
+ "sha256": "1a2d6c5ab225af2abc2591cc897808ebcce16bf0478ed55daea61000aa7652ee",
169
+ "size": 1173
170
170
  },
171
171
  {
172
172
  "path": "toolkit/skills/ops-security-infra/references/security-headers.md",
173
- "sha256": "1e6996cf39c923765c5fa3506932cacf749ca23e130a0d7e4fa1a06d4fe8eada",
174
- "size": 1057
173
+ "sha256": "796ebd48e399aedc59b0a1e9bbbe2363813d3b74be38721bec330cec683ecc69",
174
+ "size": 955
175
175
  },
176
176
  {
177
177
  "path": "toolkit/skills/ops-security-infra/SKILL.md",
178
- "sha256": "bd58371057178ebd8ad61de267bdc485bbea6bf1b1c804f767f3690454255fa6",
179
- "size": 5001
178
+ "sha256": "81d19ee0002c70788295a6a7e93ae8b0ff0e97af5e71c0a3591548e5bbd5bab6",
179
+ "size": 4866
180
180
  },
181
181
  {
182
182
  "path": "toolkit/skills/ops-verify/SKILL.md",
183
- "sha256": "53f10a44c4e7803a85110c10269b51c20b625877827ae177bf779010b0040c69",
184
- "size": 5184
183
+ "sha256": "497bcb22ccb191dbb77d7db46cd96801b56cf9b1ec630c834d3a947b90a6169e",
184
+ "size": 5983
185
185
  }
186
186
  ]
187
187
  }
@@ -1,36 +1,36 @@
1
- be7565adbd8d38dd90bc350eaecbd058cc8acb2a549b7e648d469b1f57916bbc toolkit/AGENTS.md
2
- bcb77479f810e8449ea6e68fc775ea92758d2501e2bc29428d0c980fd996d5c6 toolkit/install.ps1
1
+ a1a8d03564680cde44ef34e1878f3c8fb6ad7ce79e79b7ba7274fdb072321f30 toolkit/AGENTS.md
2
+ ac041e80d0771b13fc1dc94c6a572debaddba223ff4d029695a6953f35ebaa92 toolkit/install.ps1
3
3
  5eae77f4d14b81d56c3c109f563fefafd1967d85093ff1b192293fe438aeabe5 toolkit/scripts/install-claude-skills.ps1
4
- ebd12d2fef1f3080a3a9d173d6a4dac4358b69d506fd7a37e347bb11a9936d9c toolkit/scripts/install-codex-skills.ps1
4
+ 68eb662bc9b8906882d32f6cd1247238f6ae663137a489f18054a75724cd1e81 toolkit/scripts/install-codex-skills.ps1
5
5
  2c629d8316b205c6a7cd0d95959b80801b281ef62e205c10a92e3a2568eb8b41 toolkit/scripts/uninstall-claude-skills.ps1
6
- 290301c13e3e39adec2f76b2611383037544a4f05f4a030907429295ff8e9dc8 toolkit/scripts/uninstall-codex-skills.ps1
7
- 8c971775d71d70aab59e5b36e0fdb631922ce79ef139fbf77ff27258ce3fac7a toolkit/SDTKOPS_TOOLKIT.md
6
+ fdb9631a80ecfb0d986a52a2833e88bf15c5303ab654d35bad6d64cca43046e8 toolkit/scripts/uninstall-codex-skills.ps1
7
+ bed302b782f0c1729c8010877207a67bbc4c3032209186a54bac280d468cf5c8 toolkit/SDTKOPS_TOOLKIT.md
8
8
  8247ddf24502ce285bee213eefc801ce6b0b83afe00efd828468ac9130f53b09 toolkit/sdtk-spec.config.json
9
- 2c1668df46aa57dba06c2c924a60f6c1667a1d4551b4eb70fb18c190356a2180 toolkit/sdtk-spec.config.profiles.example.json
10
- bcb9252a08b98e7a6a92057153f8f8882b948149b3897bee5e9328cd456de025 toolkit/skills/ops-backup/references/backup-script-patterns.md
11
- 99bee57db26fb09714da32dffff8172da9222e5182039fbc659a08007d4ce205 toolkit/skills/ops-backup/SKILL.md
12
- ec5ae90ebceb679554a8ec977ff27327ae608f1d5852170665a8a581cc9faea2 toolkit/skills/ops-ci-cd/references/pipeline-examples.md
13
- b0752e0452a85423817f17e2e3321e88fd5186579ae816ccb4b2cd105f45871c toolkit/skills/ops-ci-cd/SKILL.md
9
+ de0310b0c69f77d1c1601b94b0ea72b2c83c92cb8ee94d2f4a1759ceb58f2fd4 toolkit/sdtk-spec.config.profiles.example.json
10
+ 1cd81e12cebdb2be528803e2d8afe43959aab1493e55499af529b99ec566a56c toolkit/skills/ops-backup/references/backup-script-patterns.md
11
+ 76e8385190d967bf98b3cafbbf8925d9b9c656ee7a7ed66ff51285b6459ebff1 toolkit/skills/ops-backup/SKILL.md
12
+ d27e47b0c832656c2835e3d3e32dae7c86419014199439b10fc6823956324716 toolkit/skills/ops-ci-cd/references/pipeline-examples.md
13
+ c9bf8e6f602d6201ccd54a78a9a7f850028924b460d60495d144bd5ec473c5e6 toolkit/skills/ops-ci-cd/SKILL.md
14
14
  a0bb24484cba68a7201e6b7f614c8b5ada8b2dff540a4e4390661a0ced112e8d toolkit/skills/ops-compliance/SKILL.md
15
- 131711d0af5d4dc4227e4b2669a910d05d50c80b4f82a47e0a13699d8e5a9f10 toolkit/skills/ops-container/references/k8s-manifest-patterns.md
16
- 7834e362ef5f3d6628acb4653997d9eab379bc7dff372280728fd5aa6abf087a toolkit/skills/ops-container/SKILL.md
17
- e0e791f153b31ee75d012a26b01f4f6be50aed4fe4268bd02c6a76debba52a1d toolkit/skills/ops-cost/SKILL.md
18
- d30c380152237d92f102b8db1849baa3d7a082c4e42e9ba9174d7ef49000672f toolkit/skills/ops-debug/references/root-cause-tracing.md
19
- ddedf16d59fae6e54cddae23b5bf24f2878ff23f17d81a88298e021c25401d1c toolkit/skills/ops-debug/SKILL.md
20
- a18ec9032e4e2c14e5daa1984cb8260e1d735fc38a44926fe037f0f2b99fcd33 toolkit/skills/ops-deploy/SKILL.md
21
- 4a0c7f482e1666a538038ea9b25314cd0333754c413af7bde7b74d0cddb868c7 toolkit/skills/ops-discover/SKILL.md
22
- 396e951ef529f1ae8c4d6db6773f383d35c5e14d666399583640cd2f1811f93b toolkit/skills/ops-incident/references/communication-templates.md
23
- 5eebfd217bf7ea2bb2d59c9d30ab77d04277d78cf42114f044f6ad998040f926 toolkit/skills/ops-incident/references/postmortem-template.md
24
- b6479d8ef31c2a4fd8242219bb02b87ce8babffa70fc219fe7e5db408471f326 toolkit/skills/ops-incident/references/runbook-template.md
25
- a5fa64bcd10ff0d04ca8cd25e883a3a667034a726162cfaff63252719081a834 toolkit/skills/ops-incident/SKILL.md
26
- fe767ccec7a8efb84ddfa8097eea9cb92c1e9d7f478ab89632b0516b738b5e20 toolkit/skills/ops-infra-plan/references/iac-patterns.md
27
- 8c1b5583b3ba9761311a950cb7ab24c1abe573903ded68484bcf0811435feb5c toolkit/skills/ops-infra-plan/SKILL.md
28
- 6deee66c8b0c65219fe907934382b0c9cdba007a971a98af54f703b6360f3c56 toolkit/skills/ops-monitor/references/alert-rules.md
29
- a1d8fe86ba90287cf21cc204478949002e4d28103496dd46b60a2b5fef55d2b2 toolkit/skills/ops-monitor/references/slo-templates.md
30
- 83058acaf39ee925d90ba0f04a4e4e2be584fe90de540d4bdedab61d9a3c85dc toolkit/skills/ops-monitor/SKILL.md
31
- c5273d155c67bcade47868b4cd5a1f7e9c66e5bb864616036b1cc22676f25ecf toolkit/skills/ops-parallel/SKILL.md
32
- e405117c97e3475dee69133e31759e3ce0926fb6a83929eab55a95509b213c38 toolkit/skills/ops-plan/SKILL.md
33
- 8876ffa8cfc97335fb68063270b2bffdb3cd0630663123008575a8b98ea485a8 toolkit/skills/ops-security-infra/references/cicd-security-pipeline.md
34
- 1e6996cf39c923765c5fa3506932cacf749ca23e130a0d7e4fa1a06d4fe8eada toolkit/skills/ops-security-infra/references/security-headers.md
35
- bd58371057178ebd8ad61de267bdc485bbea6bf1b1c804f767f3690454255fa6 toolkit/skills/ops-security-infra/SKILL.md
36
- 53f10a44c4e7803a85110c10269b51c20b625877827ae177bf779010b0040c69 toolkit/skills/ops-verify/SKILL.md
15
+ 070ebcad0d0cb71cd3815de6e4c78d22517a28f825d65ea3677215e57112d1df toolkit/skills/ops-container/references/k8s-manifest-patterns.md
16
+ 7eb1113162af029886974d2dba6553fec6ba9b002adc31a18c427a5e471d48a3 toolkit/skills/ops-container/SKILL.md
17
+ 3000b78ad911d667b056efdc01c639d8e069c1df1b157c6a6721ba2c61cce678 toolkit/skills/ops-cost/SKILL.md
18
+ d70b59d276edf5c6c8aebb5fc669b8f6d04673fc8e8561cbaf4d7e5fb9f4e2f2 toolkit/skills/ops-debug/references/root-cause-tracing.md
19
+ d5f58322afebcf5c3a110b02de0d2eec4494f9ed9d358b113b6717275c3524af toolkit/skills/ops-debug/SKILL.md
20
+ c2cacc94ffba4d7ef84e635c2078e08abb8d52f79afbbb1534661c0e0cf9bda6 toolkit/skills/ops-deploy/SKILL.md
21
+ 6f38c9b2ab972f272fb86e17926585a9a254a1c48c8454459a61315d4bd81d81 toolkit/skills/ops-discover/SKILL.md
22
+ f6102d127e47861068b285ebbbb2045e4c3dc8cd9af73b3c975f285f2141639e toolkit/skills/ops-incident/references/communication-templates.md
23
+ fda6d9cadc5a3757e5559798a67716a6356809735b076d47d6bd99a993b71b99 toolkit/skills/ops-incident/references/postmortem-template.md
24
+ 358644dcd477fe32d3368ced5c9da30663ae3d54fdd5e825ae3e56327f7f6f2d toolkit/skills/ops-incident/references/runbook-template.md
25
+ df03ad86862020941e69b90ea1f2ccf8cd69762e53f0a539936c16fb433e61c8 toolkit/skills/ops-incident/SKILL.md
26
+ 14f02a1921cb58e2c54c355c0b24ffdf5a9bdb91a7be6921f22da5974787efee toolkit/skills/ops-infra-plan/references/iac-patterns.md
27
+ 35eec623e41603dae0a1a328c1e6d822d2e1dc79a471f06bab3c1f3e2d552e53 toolkit/skills/ops-infra-plan/SKILL.md
28
+ 28be1bd1babdaa3de9fc58f859060697c31b9249cc684c9c4272a9c3bc159db9 toolkit/skills/ops-monitor/references/alert-rules.md
29
+ af28797b442fb94fa96dc0182881847e50b5fe9e68ecf7a71471502030f4bd27 toolkit/skills/ops-monitor/references/slo-templates.md
30
+ 2d09968790ed63dd8e0969f59023c0ced71dd182d56475689a2d3bfc3f889002 toolkit/skills/ops-monitor/SKILL.md
31
+ 8c83a7f267b7222cf9765a4328dd6945e30f3629dfca21cd85f7439f501b8ee0 toolkit/skills/ops-parallel/SKILL.md
32
+ db75109542354b70a9502231f6c66803642c013958eedb93a26770f28b9e7fad toolkit/skills/ops-plan/SKILL.md
33
+ 1a2d6c5ab225af2abc2591cc897808ebcce16bf0478ed55daea61000aa7652ee toolkit/skills/ops-security-infra/references/cicd-security-pipeline.md
34
+ 796ebd48e399aedc59b0a1e9bbbe2363813d3b74be38721bec330cec683ecc69 toolkit/skills/ops-security-infra/references/security-headers.md
35
+ 81d19ee0002c70788295a6a7e93ae8b0ff0e97af5e71c0a3591548e5bbd5bab6 toolkit/skills/ops-security-infra/SKILL.md
36
+ 497bcb22ccb191dbb77d7db46cd96801b56cf9b1ec630c834d3a947b90a6169e toolkit/skills/ops-verify/SKILL.md
@@ -1,4 +1,4 @@
1
- # SDTK-OPS -- Operations Discipline Toolkit
1
+ # SDTK-OPS -- Operations Discipline Toolkit
2
2
 
3
3
  Purpose: use SDTK-OPS to drive disciplined infrastructure and operations work across planning, deployment, monitoring, incident response, recovery, security hardening, and cost optimization.
4
4
 
@@ -14,11 +14,39 @@ Document role:
14
14
  - If the correct entry point is unclear, start with `ops-discover`.
15
15
  - Use `ops-verify` before marking any operational task complete.
16
16
  - Use `ops-debug` for evidence-first diagnosis before proposing speculative fixes.
17
+ - Use `ops-parallel` only for truly independent slices. If collab or subagent dispatch is unavailable in the active runtime, keep the same slice boundaries but execute them sequentially in one controller session.
17
18
  - Keep guidance cloud-agnostic unless the task explicitly requires a platform-specific example.
18
19
  - Do not drift into application specification or coding workflows. Those belong to SDTK-SPEC or SDTK-CODE.
19
20
  - `ops-discover` is a skill, not a CLI command.
20
21
  - `generate` remains unsupported and deferred in the current SDTK-OPS CLI surface.
21
22
 
23
+ ## DEV-Run Intake
24
+
25
+ When `DEV-Run` begins from `SDTK-CODE`, the only canonical bridge artifact is:
26
+ - `docs/dev/OPS_HANDOFF_[FEATURE_KEY].json`
27
+
28
+ Treat that file as the frozen suite contract input.
29
+ `SDTK-OPS` consumes it, but does not redefine the schema, rename fields, or move the canonical path.
30
+
31
+ Ready-path intake:
32
+ - inspect `handoff_status` first
33
+ - if status is `READY_FOR_SDTK_OPS`, default to `suggested_next_ops_path.start_with`
34
+ - treat `suggested_next_ops_path.suggested_chain` as the default route unless fresh evidence requires a bounded reroute
35
+ - close with `suggested_next_ops_path.close_with`, which should normally be `ops-verify`
36
+
37
+ Blocked-path intake:
38
+ - if status is `BLOCKED_FOR_SDTK_OPS`, the handoff is still inspectable
39
+ - inspect `open_blockers`, `code_evidence_refs`, and prerequisite fields before choosing a next step
40
+ - do not treat a blocked handoff as normal ready-path execution
41
+ - use `ops-discover` only to select bounded triage or clarification, not to silently reinterpret blocked scope as deployment-ready
42
+
43
+ Minimum OPS evidence expectations:
44
+ - record the consumed handoff path and `handoff_status`
45
+ - record whether the chosen first skill followed or overrode `suggested_next_ops_path`, and why
46
+ - record which prerequisites, assumptions, dependencies, observability, and rollback items were checked
47
+ - record journey-specific operational evidence for the scoped OPS work
48
+ - record final `ops-verify` closeout evidence
49
+
22
50
  ## Primary Routing Journeys
23
51
 
24
52
  | Journey | Start With | Suggested Chain | Close With |
@@ -58,7 +86,7 @@ Document role:
58
86
  | Runtime | Project Scope | User Scope | Default Scope | Notes |
59
87
  |---------|:-------------:|:----------:|---------------|-------|
60
88
  | Claude | true | true | project | project-local toolkit supported |
61
- | Codex | false | true | user | Gate C0: no project-local skill runtime |
89
+ | Codex | true | true | user | Project-local skill runtime is supported only through the explicit local `CODEX_HOME=<project>/.codex` contract; native `.codex/skills` auto-discovery is not claimed. |
62
90
 
63
91
  ## Verification Policy
64
92