sdtk-kit 0.3.9 → 1.0.1

package/assets/toolkit/toolkit/scripts/uninstall-claude-skills.ps1

@@ -1,139 +0,0 @@
-param(
-  [string]$ProjectPath,
-  [ValidateSet('project', 'user')]
-  [string]$Scope = 'project',
-  [string]$SkillName,
-  [switch]$All,
-  [switch]$BackupExisting,
-  [string]$BackupPath
-)
-
-$ErrorActionPreference = 'Stop'
-Set-StrictMode -Version Latest
-
-function Backup-Directory {
-  param(
-    [Parameter(Mandatory = $true)][string]$SourcePath,
-    [Parameter(Mandatory = $true)][string]$BackupRoot,
-    [Parameter(Mandatory = $true)][string]$Name
-  )
-
-  if (-not (Test-Path -LiteralPath $SourcePath)) {
-    return $null
-  }
-
-  New-Item -ItemType Directory -Force -Path $BackupRoot | Out-Null
-  $dest = Join-Path $BackupRoot $Name
-  if (Test-Path -LiteralPath $dest) {
-    Remove-Item -LiteralPath $dest -Recurse -Force
-  }
-  Copy-Item -LiteralPath $SourcePath -Destination $dest -Recurse -Force
-  return $dest
-}
-
-if ($All -and $SkillName) {
-  throw "Use either -All or -SkillName, not both."
-}
-
-$toolkitRoot = Resolve-Path (Join-Path $PSScriptRoot '..')
-$skillsSrc = Join-Path $toolkitRoot 'skills-claude'
-if (-not (Test-Path -LiteralPath $skillsSrc)) {
-  throw "Missing toolkit Claude skills source directory: $skillsSrc"
-}
-
-$managedSkillNames = Get-ChildItem -LiteralPath $skillsSrc -Directory | Select-Object -ExpandProperty Name
-if (-not $managedSkillNames -or $managedSkillNames.Count -eq 0) {
-  throw "No managed Claude skills found in: $skillsSrc"
-}
-
-$targetNames = @()
-if ($SkillName) {
-  if ($managedSkillNames -notcontains $SkillName) {
-    throw "Skill '$SkillName' is not in managed Claude skills list. Known skills: $($managedSkillNames -join ', ')"
-  }
-  $targetNames = @($SkillName)
-} elseif ($All) {
-  $targetNames = @($managedSkillNames)
-} else {
-  $targetNames = @($managedSkillNames)
-}
-
-# Resolve destination based on scope
-if ($Scope -eq 'user') {
-  $skillsDest = Join-Path $HOME '.claude/skills'
-} else {
-  if (-not $ProjectPath) {
-    $ProjectPath = (Resolve-Path (Join-Path $toolkitRoot '..')).Path
-  }
-  $projectRoot = Resolve-Path -LiteralPath $ProjectPath
-  $skillsDest = Join-Path $projectRoot '.claude/skills'
-}
-
-if (-not (Test-Path -LiteralPath $skillsDest)) {
-  Write-Host "Claude skills directory not found: $skillsDest"
-  exit 0
-}
-
-$backupRootResolved = $null
-if ($BackupExisting) {
-  if (-not $BackupPath -or $BackupPath.Trim().Length -eq 0) {
-    $timestamp = Get-Date -Format 'yyyyMMdd-HHmmss'
-    $parentDir = if ($Scope -eq 'user') { Join-Path $HOME '.claude' } else { $projectRoot }
-    $BackupPath = Join-Path $parentDir (Join-Path 'skills-backups' ("uninstall-" + $timestamp))
-  }
-  New-Item -ItemType Directory -Force -Path $BackupPath | Out-Null
-  $backupRootResolved = (Resolve-Path -LiteralPath $BackupPath).Path
-  Write-Host "Backup mode enabled: $backupRootResolved"
-}
-
-$removed = New-Object System.Collections.Generic.List[string]
-$missing = New-Object System.Collections.Generic.List[string]
-
-foreach ($name in $targetNames) {
-  $dest = Join-Path $skillsDest $name
-  if (-not (Test-Path -LiteralPath $dest)) {
-    $missing.Add($name) | Out-Null
-    Write-Warning "Skill not installed, skipping: $name"
-    continue
-  }
-
-  if ($BackupExisting) {
-    $backupDest = Backup-Directory -SourcePath $dest -BackupRoot $backupRootResolved -Name $name
-    if ($backupDest) {
-      Write-Host "Backed up: $name -> $backupDest"
-    }
-  }
-
-  Remove-Item -LiteralPath $dest -Recurse -Force
-  $removed.Add($name) | Out-Null
-  Write-Host "Uninstalled: $name"
-}
-
-# Also remove references directory if uninstalling all
-if ($All -or (-not $SkillName)) {
-  $refDir = Join-Path $skillsDest 'references'
-  if (Test-Path -LiteralPath $refDir) {
-    if ($BackupExisting) {
-      Backup-Directory -SourcePath $refDir -BackupRoot $backupRootResolved -Name 'references' | Out-Null
-      Write-Host "Backed up: references -> $backupRootResolved/references"
-    }
-    Remove-Item -LiteralPath $refDir -Recurse -Force
-    Write-Host "Removed references directory."
-  }
-}
-
-Write-Host ""
-Write-Host "Uninstall summary:"
-Write-Host "- Scope: $Scope"
-Write-Host "- Destination: $skillsDest"
-Write-Host "- Removed: $($removed.Count)"
-if ($removed.Count -gt 0) {
-  $removed | ForEach-Object { Write-Host "  - $_" }
-}
-Write-Host "- Missing/Skipped: $($missing.Count)"
-if ($missing.Count -gt 0) {
-  $missing | ForEach-Object { Write-Host "  - $_" }
-}
-if ($backupRootResolved) {
-  Write-Host "- Backup directory: $backupRootResolved"
-}

package/assets/toolkit/toolkit/scripts/uninstall-codex-skills.ps1

@@ -1,116 +0,0 @@
-param(
-  [string]$SkillName,
-  [switch]$All,
-  [switch]$BackupExisting,
-  [string]$BackupPath
-)
-
-$ErrorActionPreference = 'Stop'
-Set-StrictMode -Version Latest
-
-function Backup-Directory {
-  param(
-    [Parameter(Mandatory = $true)][string]$SourcePath,
-    [Parameter(Mandatory = $true)][string]$BackupRoot,
-    [Parameter(Mandatory = $true)][string]$Name
-  )
-
-  if (-not (Test-Path -LiteralPath $SourcePath)) {
-    return $null
-  }
-
-  New-Item -ItemType Directory -Force -Path $BackupRoot | Out-Null
-  $dest = Join-Path $BackupRoot $Name
-  if (Test-Path -LiteralPath $dest) {
-    Remove-Item -LiteralPath $dest -Recurse -Force
-  }
-  Copy-Item -LiteralPath $SourcePath -Destination $dest -Recurse -Force
-  return $dest
-}
-
-if ($All -and $SkillName) {
-  throw "Use either -All or -SkillName, not both."
-}
-
-$repoRoot = Resolve-Path (Join-Path $PSScriptRoot '..')
-$skillsSrc = Join-Path $repoRoot 'skills'
-if (-not (Test-Path -LiteralPath $skillsSrc)) {
-  throw "Missing toolkit skills source directory: $skillsSrc"
-}
-
-$managedSkillNames = Get-ChildItem -LiteralPath $skillsSrc -Directory | Select-Object -ExpandProperty Name
-if (-not $managedSkillNames -or $managedSkillNames.Count -eq 0) {
-  throw "No managed skills found in: $skillsSrc"
-}
-
-$targetNames = @()
-if ($SkillName) {
-  if ($managedSkillNames -notcontains $SkillName) {
-    throw "Skill '$SkillName' is not in managed toolkit skills list. Known skills: $($managedSkillNames -join ', ')"
-  }
-  $targetNames = @($SkillName)
-} elseif ($All) {
-  $targetNames = @($managedSkillNames)
-} else {
-  # Default behavior: uninstall all toolkit-managed skills.
-  $targetNames = @($managedSkillNames)
-}
-
-$codexHome = $env:CODEX_HOME
-if (-not $codexHome) {
-  $codexHome = Join-Path $HOME '.codex'
-}
-
-$skillsDest = Join-Path $codexHome 'skills'
-if (-not (Test-Path -LiteralPath $skillsDest)) {
-  Write-Host "Codex skills directory not found: $skillsDest"
-  exit 0
-}
-
-$backupRootResolved = $null
-if ($BackupExisting) {
-  if (-not $BackupPath -or $BackupPath.Trim().Length -eq 0) {
-    $timestamp = Get-Date -Format 'yyyyMMdd-HHmmss'
-    $BackupPath = Join-Path $codexHome (Join-Path 'skills-backups' ("uninstall-" + $timestamp))
-  }
-  New-Item -ItemType Directory -Force -Path $BackupPath | Out-Null
-  $backupRootResolved = (Resolve-Path -LiteralPath $BackupPath).Path
-  Write-Host "Backup mode enabled: $backupRootResolved"
-}
-
-$removed = New-Object System.Collections.Generic.List[string]
-$missing = New-Object System.Collections.Generic.List[string]
-
-foreach ($name in $targetNames) {
-  $dest = Join-Path $skillsDest $name
-  if (-not (Test-Path -LiteralPath $dest)) {
-    $missing.Add($name) | Out-Null
-    Write-Warning "Skill not installed, skipping: $name"
-    continue
-  }
-
-  if ($BackupExisting) {
-    $backupDest = Backup-Directory -SourcePath $dest -BackupRoot $backupRootResolved -Name $name
-    if ($backupDest) {
-      Write-Host "Backed up: $name -> $backupDest"
-    }
-  }
-
-  Remove-Item -LiteralPath $dest -Recurse -Force
-  $removed.Add($name) | Out-Null
-  Write-Host "Uninstalled: $name"
-}
-
-Write-Host ""
-Write-Host "Uninstall summary:"
-Write-Host "- Removed: $($removed.Count)"
-if ($removed.Count -gt 0) {
-  $removed | ForEach-Object { Write-Host "  - $_" }
-}
-Write-Host "- Missing/Skipped: $($missing.Count)"
-if ($missing.Count -gt 0) {
-  $missing | ForEach-Object { Write-Host "  - $_" }
-}
-if ($backupRootResolved) {
-  Write-Host "- Backup directory: $backupRootResolved"
-}

package/assets/toolkit/toolkit/sdtk.config.json

@@ -1,28 +0,0 @@
-{
-  "docs": {
-    "artifactsLanguage": "EN",
-    "guidanceLanguage": "VI",
-    "preserveOriginalInput": true,
-    "appendixIncludeEnglishTranslation": true,
-    "aiPeerReviewAllowed": true
-  },
-  "orchestration": {
-    "apiDesignDetailMode": "auto",
-    "testCaseSpecMode": "auto"
-  },
-  "stack": {
-    "backend": "Set your backend stack (example: Python Django REST Framework)",
-    "frontend": "Set your frontend stack (example: React + Vite)",
-    "mobile": "N/A",
-    "database": "Set your database (example: PostgreSQL 15)",
-    "auth": "Set your auth strategy (example: JWT/OAuth2)"
-  },
-  "commands": {
-    "backendTests": "UPDATE_ME: set backend test command",
-    "backendTypecheck": "UPDATE_ME: set backend typecheck command",
-    "backendLint": "UPDATE_ME: set backend lint command",
-    "frontendTests": "UPDATE_ME: set frontend test command",
-    "frontendLint": "UPDATE_ME: set frontend lint command",
-    "e2eTests": "UPDATE_ME: set e2e test command"
-  }
-}

package/assets/toolkit/toolkit/sdtk.config.profiles.example.json

@@ -1,50 +0,0 @@
-{
-  "profiles": {
-    "django-react": {
-      "orchestration": {
-        "apiDesignDetailMode": "auto",
-        "testCaseSpecMode": "auto"
-      },
-      "stack": {
-        "backend": "Python 3.11 + Django 4.x + Django REST Framework",
-        "frontend": "React 18 + Vite",
-        "mobile": "N/A",
-        "database": "PostgreSQL 15",
-        "auth": "JWT"
-      },
-      "commands": {
-        "backendTests": "python -m pytest",
-        "backendTypecheck": "python -m mypy src/backend",
-        "backendLint": "python -m ruff check src/backend",
-        "frontendTests": "npm run test",
-        "frontendLint": "npm run lint",
-        "e2eTests": "npm run e2e"
-      }
-    },
-    "node-nextjs": {
-      "orchestration": {
-        "apiDesignDetailMode": "auto",
-        "testCaseSpecMode": "auto"
-      },
-      "stack": {
-        "backend": "Node.js 20 + Express/Fastify",
-        "frontend": "Next.js 14",
-        "mobile": "N/A",
-        "database": "PostgreSQL 15",
-        "auth": "OAuth2 + JWT"
-      },
-      "commands": {
-        "backendTests": "npm run test:api",
-        "backendTypecheck": "npm run typecheck:api",
-        "backendLint": "npm run lint:api",
-        "frontendTests": "npm run test:web",
-        "frontendLint": "npm run lint:web",
-        "e2eTests": "npm run test:e2e"
-      }
-    }
-  },
-  "notes": [
-    "Copy one profile into sdtk.config.json and adjust for your project.",
-    "Do not keep UPDATE_ME placeholders before running real delivery gates."
-  ]
-}

package/assets/toolkit/toolkit/skills/sdtk-api-design-spec/SKILL.md

@@ -1,84 +0,0 @@
----
-name: sdtk-api-design-spec
-description: Generate detailed API design markdown (`[FEATURE_KEY]_API_DESIGN_DETAIL.md`) from OpenAPI YAML and API flow list using Excel-style structure rules. Use when you need field-level request/response tables + per-endpoint process flow images for implementation/review handoff.
----
-
-# SDTK API Design Detail Spec
-
-## Critical Constraints
-- I do not drift from the source YAML or flow list.
-- I do not leave broken flow image embeds or missing assumptions in the API design detail.
-
-## Outputs
-- `docs/api/[FEATURE_KEY]_API_DESIGN_DETAIL.md`
-- Supporting generated assets:
-  - `docs/api/flows/*.puml`
-  - `docs/api/images/*.svg`
-
-## Required Inputs
-- Feature key (`FEATURE_KEY`)
-- API contract YAML:
-  - Preferred: `docs/api/[FeaturePascal]_API.yaml`
-  - Fallback: a specified YAML file path
-- API flow list:
-  - Preferred: `docs/api/[feature_snake]_api_flow_list.txt`
-  - Fallback: a specified flow list path
-
-## Core Rules
-- Apply `./references/API_DESIGN_FLOWCHART_CREATION_RULES.md` first.
-- Keep endpoint contracts consistent with source YAML.
-- Keep process flow source synchronized with flow list (`*_api_flow_list.txt`).
-- Keep one visible flowchart per API section (embed image), avoid duplicate preview rendering.
-- Keep `Process Flow` sections implementation-readable:
-  - include YAML-derived flow summary / notes / login bullets
-  - keep error sections aligned with actual flow exits, not `None`
-
-## Generation Procedure
-1. Resolve input files (`yaml`, `flow_list`, `output`).
-2. Parse YAML endpoints (method, path, request schema, success/error schema).
-3. Parse flow blocks from flow list (`@startuml ... @enduml`) and map by normalized `METHOD + path`.
-4. Generate detailed markdown sections per API:
-   - Flow summary / notes / login bullets from YAML `description`
-   - Process flow source block (`text` fenced block)
-   - Embedded flowchart image
-   - Path parameter table
-   - Request table (hierarchy levels + type + format + required)
-   - Success response table
-   - Error response table (explicit schema if defined, otherwise shared envelope + inferred business statuses from flow)
-5. Generate/update `.puml` per API under `docs/api/flows`.
-6. Render `.svg` images under `docs/api/images`.
-7. Validate:
-   - every API section has one embedded image
-   - every embed path exists
-   - no render error image output
-   - markdown tables keep `No` sequential numbering
-
-## Script
-- `scripts/generate_api_design_detail.py`
-
-### Typical command
-```powershell
-python "toolkit/skills/sdtk-api-design-spec/scripts/generate_api_design_detail.py" `
-  --feature-key SCHEDULE_WHITEBOARD `
-  --yaml "docs/api/ScheduleWhiteboard_API.yaml" `
-  --flow-list "docs/api/schedule_whiteboard_api_flow_list.txt" `
-  --output "docs/api/SCHEDULE_WHITEBOARD_API_DESIGN_DETAIL.md"
-```
-
-### Optional subset generation
-```powershell
-python "toolkit/skills/sdtk-api-design-spec/scripts/generate_api_design_detail.py" `
-  --feature-key SCHEDULE_WHITEBOARD `
-  --yaml "docs/api/ScheduleWhiteboard_API.yaml" `
-  --flow-list "docs/api/schedule_whiteboard_api_flow_list.txt" `
-  --output "docs/api/SCHEDULE_WHITEBOARD_API_DESIGN_DETAIL.md" `
-  --include "POST /api/whiteboard/assignment/{company_uuid}" `
-  --include "POST /api/whiteboard/assignment/edit/{company_uuid}/{sagyo_assign_uuid}" `
-  --include "POST /api/whiteboard/assignment/delete/{company_uuid}/{sagyo_assign_uuid}"
-```
-
-## Orchestrator Integration (Hybrid)
-- `apiDesignDetailMode` in `sdtk.config.json` controls orchestration behavior:
-  - `auto` (default): generate API design detail when ARCH has API scope and YAML/flow sources are available.
-  - `on`: always generate API design detail for API scope (fail if required sources are missing).
-  - `off`: skip unless user explicitly requests.

package/assets/toolkit/toolkit/skills/sdtk-api-design-spec/references/API_DESIGN_CREATION_RULES.md

@@ -1,22 +0,0 @@
-# API DESIGN CREATION RULES (Compatibility Note)
-
-This file is kept only for backward compatibility.
-
-Do not use this file as the primary source of truth anymore.
-The active rule source for API design detail and API flowchart behavior is now:
-- `API_DESIGN_FLOWCHART_CREATION_RULES_FINAL.md` (root)
-- `templates/docs/api/API_DESIGN_FLOWCHART_CREATION_RULES.md` (toolkit)
-
-Even in compatibility mode, generated API design detail docs must still include:
-- a top-level `## Assumptions` section
-- this table format: `| # | Assumption | Verified | Risk if wrong |`
-- explicit unresolved assumptions when downstream review depends on them
-
-Use the active rule file for:
-- API design detail markdown structure
-- flowchart integration and synchronization rules
-- error section rules
-- flow summary / notes / login rules
-- assumptions-section requirements
-
-This compatibility note should remain only until all references are migrated.