sdtk-ops-kit 0.2.4 → 0.2.6

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,168 +1,168 @@
1
- param(
2
- [Parameter(Mandatory = $true)]
3
- [ValidateSet('codex', 'claude')]
4
- [string]$Runtime,
5
-
6
- [string]$ProjectPath,
7
-
8
- [ValidateSet('project', 'user', '')]
9
- [string]$Scope = '',
10
-
11
- [switch]$Force,
12
- [switch]$SkipRuntimeAssets,
13
- [switch]$SkipSkills,
14
- [switch]$Quiet
15
- )
16
-
17
- $ErrorActionPreference = 'Stop'
18
- Set-StrictMode -Version Latest
19
-
20
- function Copy-File {
21
- param(
22
- [Parameter(Mandatory = $true)][string]$SourcePath,
23
- [Parameter(Mandatory = $true)][string]$DestinationPath,
24
- [Parameter(Mandatory = $true)][bool]$Overwrite
25
- )
26
-
27
- if (-not (Test-Path -LiteralPath $SourcePath)) {
28
- throw "Missing source file: $SourcePath"
29
- }
30
-
31
- if ((Test-Path -LiteralPath $DestinationPath) -and -not $Overwrite) {
32
- if (-not $Quiet) {
33
- Write-Warning "Already exists (skipping). Use -Force to overwrite: $DestinationPath"
34
- }
35
- return
36
- }
37
-
38
- $parent = Split-Path -Parent $DestinationPath
39
- if ($parent -and -not (Test-Path -LiteralPath $parent)) {
40
- New-Item -ItemType Directory -Force -Path $parent | Out-Null
41
- }
42
-
43
- Copy-Item -LiteralPath $SourcePath -Destination $DestinationPath -Force
44
- }
45
-
46
- function Test-IsMaintainerRoot {
47
- param(
48
- [Parameter(Mandatory = $true)][string]$ProjectRoot,
49
- [Parameter(Mandatory = $true)][string[]]$Markers
50
- )
51
-
52
- foreach ($marker in $Markers) {
53
- if (-not (Test-Path -LiteralPath (Join-Path $ProjectRoot $marker))) {
54
- return $false
55
- }
56
- }
57
-
58
- return $true
59
- }
60
-
61
- function Get-MaintainerRootInstallMessage {
62
- param(
63
- [Parameter(Mandatory = $true)][string]$ProjectRoot
64
- )
65
-
66
- return @(
67
- "Refusing to install managed project files into the SDTK maintainer repo root: $ProjectRoot"
68
- "This install flow would overwrite repo-owned files such as AGENTS.md, CODEX.md, CLAUDE.md, sdtk-spec.config.json, sdtk-spec.config.profiles.example.json."
69
- "Target a consumer project path instead of the SDTK maintainer monorepo root."
70
- "If you only need runtime assets, install them into a separate consumer project path rather than the maintainer repo root."
71
- ) -join "`n"
72
- }
73
-
74
- function Resolve-OrCreateDirectory {
75
- param(
76
- [Parameter(Mandatory = $true)][string]$Path
77
- )
78
-
79
- if (-not (Test-Path -LiteralPath $Path)) {
80
- New-Item -ItemType Directory -Force -Path $Path | Out-Null
81
- }
82
-
83
- return (Resolve-Path -LiteralPath $Path).Path
84
- }
85
-
86
- $toolkitRoot = (Resolve-Path -LiteralPath $PSScriptRoot).Path
87
- if (-not $ProjectPath) {
88
- $ProjectPath = (Get-Location).Path
89
- }
90
- $projectRoot = Resolve-OrCreateDirectory -Path $ProjectPath
91
-
92
- $maintainerRootMarkers = @(
93
- 'governance/ai/core/IMPROVEMENT_BACKLOG.md',
94
- 'products/sdtk-ops/toolkit/install.ps1'
95
- )
96
-
97
- if (Test-IsMaintainerRoot -ProjectRoot $projectRoot -Markers $maintainerRootMarkers) {
98
- throw (Get-MaintainerRootInstallMessage -ProjectRoot $projectRoot)
99
- }
100
-
101
- if (-not $Scope) {
102
- $Scope = if ($Runtime -eq 'claude') { 'project' } else { 'user' }
103
- }
104
-
105
- if ($SkipSkills) {
106
- if (-not $Quiet) {
107
- Write-Warning "-SkipSkills is deprecated. Use -SkipRuntimeAssets instead."
108
- }
109
- $SkipRuntimeAssets = $true
110
- }
111
-
112
- if (-not $Quiet) {
113
- Write-Host "SDTK-OPS installer"
114
- Write-Host " Runtime: $Runtime"
115
- Write-Host " Scope: $Scope"
116
- Write-Host " Project: $projectRoot"
117
- Write-Host ""
118
- }
119
-
120
- $sharedFiles = @(
121
- 'AGENTS.md',
122
- 'sdtk-spec.config.json',
123
- 'sdtk-spec.config.profiles.example.json'
124
- )
125
-
126
- foreach ($fileName in $sharedFiles) {
127
- Copy-File `
128
- -SourcePath (Join-Path $toolkitRoot $fileName) `
129
- -DestinationPath (Join-Path $projectRoot $fileName) `
130
- -Overwrite ([bool]$Force)
131
-
132
- if (-not $Quiet) {
133
- Write-Host " [OK] $fileName"
134
- }
135
- }
136
-
137
- if (-not $SkipRuntimeAssets) {
138
- $scriptPath = if ($Runtime -eq 'claude') {
139
- Join-Path $toolkitRoot 'scripts/install-claude-skills.ps1'
140
- } else {
141
- Join-Path $toolkitRoot 'scripts/install-codex-skills.ps1'
142
- }
143
-
144
- if (-not (Test-Path -LiteralPath $scriptPath)) {
145
- throw "Missing runtime installer: $scriptPath"
146
- }
147
-
148
- if (-not $Quiet) {
149
- Write-Host ""
150
- Write-Host "Installing $Runtime runtime assets..."
151
- }
152
-
153
- $params = @{
154
- Scope = $Scope
155
- ProjectPath = $projectRoot
156
- Quiet = [bool]$Quiet
157
- }
158
- if ($Force) {
159
- $params.Force = $true
160
- }
161
-
162
- & $scriptPath @params
163
- }
164
-
165
- if (-not $Quiet) {
166
- Write-Host ""
167
- Write-Host "SDTK-OPS installation complete."
168
- }
1
+ param(
2
+ [Parameter(Mandatory = $true)]
3
+ [ValidateSet('codex', 'claude')]
4
+ [string]$Runtime,
5
+
6
+ [string]$ProjectPath,
7
+
8
+ [ValidateSet('project', 'user', '')]
9
+ [string]$Scope = '',
10
+
11
+ [switch]$Force,
12
+ [switch]$SkipRuntimeAssets,
13
+ [switch]$SkipSkills,
14
+ [switch]$Quiet
15
+ )
16
+
17
+ $ErrorActionPreference = 'Stop'
18
+ Set-StrictMode -Version Latest
19
+
20
+ function Copy-File {
21
+ param(
22
+ [Parameter(Mandatory = $true)][string]$SourcePath,
23
+ [Parameter(Mandatory = $true)][string]$DestinationPath,
24
+ [Parameter(Mandatory = $true)][bool]$Overwrite
25
+ )
26
+
27
+ if (-not (Test-Path -LiteralPath $SourcePath)) {
28
+ throw "Missing source file: $SourcePath"
29
+ }
30
+
31
+ if ((Test-Path -LiteralPath $DestinationPath) -and -not $Overwrite) {
32
+ if (-not $Quiet) {
33
+ Write-Warning "Already exists (skipping). Use -Force to overwrite: $DestinationPath"
34
+ }
35
+ return
36
+ }
37
+
38
+ $parent = Split-Path -Parent $DestinationPath
39
+ if ($parent -and -not (Test-Path -LiteralPath $parent)) {
40
+ New-Item -ItemType Directory -Force -Path $parent | Out-Null
41
+ }
42
+
43
+ Copy-Item -LiteralPath $SourcePath -Destination $DestinationPath -Force
44
+ }
45
+
46
+ function Test-IsMaintainerRoot {
47
+ param(
48
+ [Parameter(Mandatory = $true)][string]$ProjectRoot,
49
+ [Parameter(Mandatory = $true)][string[]]$Markers
50
+ )
51
+
52
+ foreach ($marker in $Markers) {
53
+ if (-not (Test-Path -LiteralPath (Join-Path $ProjectRoot $marker))) {
54
+ return $false
55
+ }
56
+ }
57
+
58
+ return $true
59
+ }
60
+
61
+ function Get-MaintainerRootInstallMessage {
62
+ param(
63
+ [Parameter(Mandatory = $true)][string]$ProjectRoot
64
+ )
65
+
66
+ return @(
67
+ "Refusing to install managed project files into the SDTK maintainer repo root: $ProjectRoot"
68
+ "This install flow would overwrite repo-owned files such as AGENTS.md, CODEX.md, CLAUDE.md, sdtk-spec.config.json, sdtk-spec.config.profiles.example.json."
69
+ "Target a consumer project path instead of the SDTK maintainer monorepo root."
70
+ "If you only need runtime assets, install them into a separate consumer project path rather than the maintainer repo root."
71
+ ) -join "`n"
72
+ }
73
+
74
+ function Resolve-OrCreateDirectory {
75
+ param(
76
+ [Parameter(Mandatory = $true)][string]$Path
77
+ )
78
+
79
+ if (-not (Test-Path -LiteralPath $Path)) {
80
+ New-Item -ItemType Directory -Force -Path $Path | Out-Null
81
+ }
82
+
83
+ return (Resolve-Path -LiteralPath $Path).Path
84
+ }
85
+
86
+ $toolkitRoot = (Resolve-Path -LiteralPath $PSScriptRoot).Path
87
+ if (-not $ProjectPath) {
88
+ $ProjectPath = (Get-Location).Path
89
+ }
90
+ $projectRoot = Resolve-OrCreateDirectory -Path $ProjectPath
91
+
92
+ $maintainerRootMarkers = @(
93
+ 'governance/ai/core/IMPROVEMENT_BACKLOG.md',
94
+ 'products/sdtk-ops/toolkit/install.ps1'
95
+ )
96
+
97
+ if (Test-IsMaintainerRoot -ProjectRoot $projectRoot -Markers $maintainerRootMarkers) {
98
+ throw (Get-MaintainerRootInstallMessage -ProjectRoot $projectRoot)
99
+ }
100
+
101
+ if (-not $Scope) {
102
+ $Scope = if ($Runtime -eq 'claude') { 'project' } else { 'user' }
103
+ }
104
+
105
+ if ($SkipSkills) {
106
+ if (-not $Quiet) {
107
+ Write-Warning "-SkipSkills is deprecated. Use -SkipRuntimeAssets instead."
108
+ }
109
+ $SkipRuntimeAssets = $true
110
+ }
111
+
112
+ if (-not $Quiet) {
113
+ Write-Host "SDTK-OPS installer"
114
+ Write-Host " Runtime: $Runtime"
115
+ Write-Host " Scope: $Scope"
116
+ Write-Host " Project: $projectRoot"
117
+ Write-Host ""
118
+ }
119
+
120
+ $sharedFiles = @(
121
+ 'AGENTS.md',
122
+ 'sdtk-spec.config.json',
123
+ 'sdtk-spec.config.profiles.example.json'
124
+ )
125
+
126
+ foreach ($fileName in $sharedFiles) {
127
+ Copy-File `
128
+ -SourcePath (Join-Path $toolkitRoot $fileName) `
129
+ -DestinationPath (Join-Path $projectRoot $fileName) `
130
+ -Overwrite ([bool]$Force)
131
+
132
+ if (-not $Quiet) {
133
+ Write-Host " [OK] $fileName"
134
+ }
135
+ }
136
+
137
+ if (-not $SkipRuntimeAssets) {
138
+ $scriptPath = if ($Runtime -eq 'claude') {
139
+ Join-Path $toolkitRoot 'scripts/install-claude-skills.ps1'
140
+ } else {
141
+ Join-Path $toolkitRoot 'scripts/install-codex-skills.ps1'
142
+ }
143
+
144
+ if (-not (Test-Path -LiteralPath $scriptPath)) {
145
+ throw "Missing runtime installer: $scriptPath"
146
+ }
147
+
148
+ if (-not $Quiet) {
149
+ Write-Host ""
150
+ Write-Host "Installing $Runtime runtime assets..."
151
+ }
152
+
153
+ $params = @{
154
+ Scope = $Scope
155
+ ProjectPath = $projectRoot
156
+ Quiet = [bool]$Quiet
157
+ }
158
+ if ($Force) {
159
+ $params.Force = $true
160
+ }
161
+
162
+ & $scriptPath @params
163
+ }
164
+
165
+ if (-not $Quiet) {
166
+ Write-Host ""
167
+ Write-Host "SDTK-OPS installation complete."
168
+ }
@@ -1,6 +1,38 @@
1
1
  {
2
- "toolkit": "SDTK-OPS",
3
- "version": "1.0.0",
4
- "skills_path": "toolkit/skills",
5
- "skill_prefix": "ops-"
2
+ "docs": {
3
+ "artifactsLanguage": "EN",
4
+ "guidanceLanguage": "VI",
5
+ "preserveOriginalInput": true,
6
+ "appendixIncludeEnglishTranslation": true,
7
+ "aiPeerReviewAllowed": true
8
+ },
9
+ "orchestration": {
10
+ "apiDesignDetailMode": "auto",
11
+ "testCaseSpecMode": "auto"
12
+ },
13
+ "stack": {
14
+ "backend": "Set your backend stack (example: Python Django REST Framework)",
15
+ "frontend": "Set your frontend stack (example: React + Vite)",
16
+ "mobile": "N/A",
17
+ "database": "Set your database (example: PostgreSQL 15)",
18
+ "auth": "Set your auth strategy (example: JWT/OAuth2)",
19
+ "detection": {
20
+ "language": null,
21
+ "framework": null,
22
+ "frameworkVersion": null,
23
+ "packageManager": null,
24
+ "confidence": "low",
25
+ "evidence": [],
26
+ "detectedAt": null,
27
+ "method": "static"
28
+ }
29
+ },
30
+ "commands": {
31
+ "backendTests": "UPDATE_ME: set backend test command",
32
+ "backendTypecheck": "UPDATE_ME: set backend typecheck command",
33
+ "backendLint": "UPDATE_ME: set backend lint command",
34
+ "frontendTests": "UPDATE_ME: set frontend test command",
35
+ "frontendLint": "UPDATE_ME: set frontend lint command",
36
+ "e2eTests": "UPDATE_ME: set e2e test command"
37
+ }
6
38
  }
@@ -1,12 +1,50 @@
1
- {
2
- "$comment": "Example profiles config for SDTK-OPS. Copy to sdtk-spec.config.profiles.json and customize for your runtime targets.",
3
- "profiles": {
4
- "default": {
5
- "stack": {
6
- "backend": "UPDATE_ME",
7
- "frontend": "UPDATE_ME",
8
- "database": "UPDATE_ME"
9
- }
10
- }
11
- }
12
- }
1
+ {
2
+ "profiles": {
3
+ "django-react": {
4
+ "orchestration": {
5
+ "apiDesignDetailMode": "auto",
6
+ "testCaseSpecMode": "auto"
7
+ },
8
+ "stack": {
9
+ "backend": "Python 3.11 + Django 4.x + Django REST Framework",
10
+ "frontend": "React 18 + Vite",
11
+ "mobile": "N/A",
12
+ "database": "PostgreSQL 15",
13
+ "auth": "JWT"
14
+ },
15
+ "commands": {
16
+ "backendTests": "python -m pytest",
17
+ "backendTypecheck": "python -m mypy src/backend",
18
+ "backendLint": "python -m ruff check src/backend",
19
+ "frontendTests": "npm run test",
20
+ "frontendLint": "npm run lint",
21
+ "e2eTests": "npm run e2e"
22
+ }
23
+ },
24
+ "node-nextjs": {
25
+ "orchestration": {
26
+ "apiDesignDetailMode": "auto",
27
+ "testCaseSpecMode": "auto"
28
+ },
29
+ "stack": {
30
+ "backend": "Node.js 20 + Express/Fastify",
31
+ "frontend": "Next.js 14",
32
+ "mobile": "N/A",
33
+ "database": "PostgreSQL 15",
34
+ "auth": "OAuth2 + JWT"
35
+ },
36
+ "commands": {
37
+ "backendTests": "npm run test:api",
38
+ "backendTypecheck": "npm run typecheck:api",
39
+ "backendLint": "npm run lint:api",
40
+ "frontendTests": "npm run test:web",
41
+ "frontendLint": "npm run lint:web",
42
+ "e2eTests": "npm run test:e2e"
43
+ }
44
+ }
45
+ },
46
+ "notes": [
47
+ "Copy one profile into sdtk-spec.config.json and adjust for your project.",
48
+ "Do not keep UPDATE_ME placeholders before running real delivery gates."
49
+ ]
50
+ }
package/package.json CHANGED
@@ -1,46 +1,46 @@
1
- {
2
- "name": "sdtk-ops-kit",
3
- "version": "0.2.4",
4
- "description": "Skill-driven operations toolkit for deployment, verification, monitoring, incident response, backup, security, compliance, and cost discipline.",
5
- "bin": {
6
- "sdtk-ops": "./bin/sdtk-ops.js"
7
- },
8
- "main": "src/index.js",
9
- "type": "commonjs",
10
- "repository": {
11
- "type": "git",
12
- "url": "https://github.com/codexsdtk/sdtk-toolkit.git",
13
- "directory": "products/sdtk-ops/distribution/sdtk-ops-kit"
14
- },
15
- "homepage": "https://github.com/codexsdtk/sdtk-toolkit/tree/main/products/sdtk-ops/distribution/sdtk-ops-kit",
16
- "bugs": {
17
- "url": "https://github.com/codexsdtk/sdtk-toolkit/issues"
18
- },
19
- "files": [
20
- "bin/",
21
- "src/",
22
- "assets/"
23
- ],
24
- "scripts": {
25
- "test": "powershell -ExecutionPolicy Bypass -Command \"$ErrorActionPreference = 'Stop'; Set-Location '..\\..\\..\\..'; python -m unittest -v tests.test_sdtk_ops_cli\"",
26
- "build:payload": "powershell -ExecutionPolicy Bypass -Command \"$ErrorActionPreference = 'Stop'; & 'scripts/sync-toolkit-assets.ps1'; & 'scripts/build-toolkit-manifest.ps1'\"",
27
- "verify:payload": "node -e \"require('./src/lib/toolkit-payload').verify()\"",
28
- "pack:smoke": "powershell -ExecutionPolicy Bypass -File scripts/pack-smoke.ps1",
29
- "prepublishOnly": "npm run build:payload && npm run verify:payload"
30
- },
31
- "engines": {
32
- "node": ">=18.13.0"
33
- },
34
- "keywords": [
35
- "sdtk-ops",
36
- "cli",
37
- "toolkit",
38
- "operations",
39
- "claude",
40
- "codex"
41
- ],
42
- "license": "MIT",
43
- "publishConfig": {
44
- "access": "public"
45
- }
46
- }
1
+ {
2
+ "name": "sdtk-ops-kit",
3
+ "version": "0.2.6",
4
+ "description": "Skill-driven operations toolkit for deployment, verification, monitoring, incident response, backup, security, compliance, and cost discipline.",
5
+ "bin": {
6
+ "sdtk-ops": "bin/sdtk-ops.js"
7
+ },
8
+ "main": "src/index.js",
9
+ "type": "commonjs",
10
+ "repository": {
11
+ "type": "git",
12
+ "url": "git+https://github.com/codexsdtk/sdtk-toolkit.git",
13
+ "directory": "products/sdtk-ops/distribution/sdtk-ops-kit"
14
+ },
15
+ "homepage": "https://github.com/codexsdtk/sdtk-toolkit/tree/main/products/sdtk-ops/distribution/sdtk-ops-kit",
16
+ "bugs": {
17
+ "url": "https://github.com/codexsdtk/sdtk-toolkit/issues"
18
+ },
19
+ "files": [
20
+ "bin/",
21
+ "src/",
22
+ "assets/"
23
+ ],
24
+ "scripts": {
25
+ "test": "powershell -ExecutionPolicy Bypass -Command \"$ErrorActionPreference = 'Stop'; Set-Location '..\\..\\..\\..'; python -m unittest -v tests.test_sdtk_ops_cli\"",
26
+ "build:payload": "powershell -ExecutionPolicy Bypass -Command \"$ErrorActionPreference = 'Stop'; & 'scripts/sync-toolkit-assets.ps1'; & 'scripts/build-toolkit-manifest.ps1'\"",
27
+ "verify:payload": "node -e \"require('./src/lib/toolkit-payload').verify()\"",
28
+ "pack:smoke": "powershell -ExecutionPolicy Bypass -File scripts/pack-smoke.ps1",
29
+ "prepublishOnly": "npm run build:payload && npm run verify:payload"
30
+ },
31
+ "engines": {
32
+ "node": ">=18.13.0"
33
+ },
34
+ "keywords": [
35
+ "sdtk-ops",
36
+ "cli",
37
+ "toolkit",
38
+ "operations",
39
+ "claude",
40
+ "codex"
41
+ ],
42
+ "license": "MIT",
43
+ "publishConfig": {
44
+ "access": "public"
45
+ }
46
+ }