sdtk-kit 0.3.3 → 0.3.5

package/src/commands/runtime.js

@@ -0,0 +1,217 @@
+"use strict";
+
+const path = require("path");
+const fs = require("fs");
+const { parseFlags, requireFlag, validateChoice } = require("../lib/args");
+const { verify, resolvePayloadFile } = require("../lib/toolkit-payload");
+const { runScript } = require("../lib/powershell");
+const { ValidationError } = require("../lib/errors");
+const {
+  VALID_SCOPES,
+  defaultScope,
+  isProjectScopeSupported,
+  resolveSkillsDir,
+  managedSkillNames,
+} = require("../lib/scope");
+
+const FLAG_DEFS = {
+  runtime: { type: "string" },
+  scope: { type: "string" },
+  "project-path": { type: "string" },
+  force: { type: "boolean" },
+  all: { type: "boolean" },
+  verbose: { type: "boolean" },
+};
+
+const VALID_RUNTIMES = ["codex", "claude"];
+const SUBCOMMANDS = ["install", "uninstall", "status"];
+
+function validateScopeForRuntime(runtime, scope) {
+  if (scope === "project" && !isProjectScopeSupported(runtime)) {
+    throw new ValidationError(
+      `Codex does not support project-local skills. Use --scope user instead.`
+    );
+  }
+}
+
+async function cmdRuntimeInstall(flags) {
+  const runtime = requireFlag(flags, "runtime", "runtime");
+  validateChoice(runtime, VALID_RUNTIMES, "runtime");
+
+  const scope = flags.scope || defaultScope(runtime);
+  validateChoice(scope, VALID_SCOPES, "scope");
+  validateScopeForRuntime(runtime, scope);
+
+  const projectPath = flags["project-path"]
+    ? path.resolve(flags["project-path"])
+    : process.cwd();
+
+  verify();
+
+  const scriptName =
+    runtime === "claude"
+      ? "toolkit/scripts/install-claude-skills.ps1"
+      : "toolkit/scripts/install-codex-skills.ps1";
+  const script = resolvePayloadFile(scriptName);
+
+  const params = { Scope: scope };
+  if (runtime === "claude") {
+    params.ProjectPath = projectPath;
+  }
+  if (flags.force) params.Force = true;
+
+  console.log(`Installing ${runtime} runtime assets...`);
+  console.log(`  Runtime: ${runtime}`);
+  console.log(`  Scope:   ${scope}`);
+  if (scope === "project") {
+    console.log(`  Project: ${projectPath}`);
+  }
+  console.log("");
+
+  const result = await runScript(script, params, {
+    silent: !flags.verbose,
+  });
+
+  if (result.exitCode !== 0) {
+    if (result.stderr) console.error(result.stderr);
+    throw new ValidationError(
+      `Runtime install failed (exit code ${result.exitCode}).`
+    );
+  }
+
+  console.log("");
+  console.log(`${runtime} runtime assets installed successfully.`);
+  return 0;
+}
+
+async function cmdRuntimeUninstall(flags) {
+  const runtime = requireFlag(flags, "runtime", "runtime");
+  validateChoice(runtime, VALID_RUNTIMES, "runtime");
+
+  const scope = flags.scope || defaultScope(runtime);
+  validateChoice(scope, VALID_SCOPES, "scope");
+  validateScopeForRuntime(runtime, scope);
+
+  const projectPath = flags["project-path"]
+    ? path.resolve(flags["project-path"])
+    : process.cwd();
+
+  verify();
+
+  const scriptName =
+    runtime === "claude"
+      ? "toolkit/scripts/uninstall-claude-skills.ps1"
+      : "toolkit/scripts/uninstall-codex-skills.ps1";
+  const script = resolvePayloadFile(scriptName);
+
+  const params = {};
+  if (runtime === "claude") {
+    params.Scope = scope;
+    params.ProjectPath = projectPath;
+  }
+  if (flags.all) params.All = true;
+
+  console.log(`Uninstalling ${runtime} runtime assets...`);
+  console.log(`  Runtime: ${runtime}`);
+  console.log(`  Scope:   ${scope}`);
+  console.log("");
+
+  const result = await runScript(script, params, {
+    silent: !flags.verbose,
+  });
+
+  if (result.exitCode !== 0) {
+    if (result.stderr) console.error(result.stderr);
+    throw new ValidationError(
+      `Runtime uninstall failed (exit code ${result.exitCode}).`
+    );
+  }
+
+  console.log("");
+  console.log(`${runtime} runtime assets uninstalled successfully.`);
+  return 0;
+}
+
+function cmdRuntimeStatus(flags) {
+  const runtime = requireFlag(flags, "runtime", "runtime");
+  validateChoice(runtime, VALID_RUNTIMES, "runtime");
+
+  const projectPath = flags["project-path"]
+    ? path.resolve(flags["project-path"])
+    : process.cwd();
+
+  console.log(`Runtime: ${runtime}`);
+  console.log("");
+
+  // Check both scopes
+  const scopes = runtime === "claude" ? ["project", "user"] : ["user"];
+
+  for (const scope of scopes) {
+    const skillsDir = resolveSkillsDir(runtime, scope, projectPath);
+    const exists = fs.existsSync(skillsDir);
+    let skillCount = 0;
+
+    const managed = managedSkillNames(runtime);
+    let installedNames = [];
+
+    if (exists) {
+      try {
+        const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+        installedNames = entries
+          .filter((e) => e.isDirectory() && managed.includes(e.name))
+          .map((e) => e.name);
+        skillCount = installedNames.length;
+      } catch {
+        // Directory not readable
+      }
+    }
+
+    const allInstalled = skillCount === managed.length;
+
+    console.log(`  Scope: ${scope}`);
+    console.log(`    Path:   ${skillsDir}`);
+    const statusLabel = !exists
+      ? "not installed"
+      : allInstalled
+        ? `installed (${skillCount}/${managed.length} SDTK skills)`
+        : `partial (${skillCount}/${managed.length} SDTK skills)`;
+    console.log(`    Status: ${statusLabel}`);
+    if (exists && skillCount < managed.length) {
+      const missing = managed.filter((n) => !installedNames.includes(n));
+      console.log(`    Missing: ${missing.join(", ")}`);
+    }
+    console.log("");
+  }
+
+  return 0;
+}
+
+async function cmdRuntime(args) {
+  const { flags, positional } = parseFlags(args, FLAG_DEFS);
+
+  const subcommand = positional[0];
+  if (!subcommand) {
+    throw new ValidationError(
+      `Missing subcommand. Usage: sdtk runtime <${SUBCOMMANDS.join("|")}> [options]`
+    );
+  }
+
+  if (!SUBCOMMANDS.includes(subcommand)) {
+    throw new ValidationError(
+      `Unknown subcommand: "${subcommand}". Must be one of: ${SUBCOMMANDS.join(", ")}`
+    );
+  }
+
+  switch (subcommand) {
+    case "install":
+      return cmdRuntimeInstall(flags);
+    case "uninstall":
+      return cmdRuntimeUninstall(flags);
+    case "status":
+      return cmdRuntimeStatus(flags);
+  }
+}
+
+module.exports = {
+  cmdRuntime,
+};

package/src/index.js

@@ -4,6 +4,7 @@ const { cmdHelp } = require("./commands/help");
 const { cmdInit } = require("./commands/init");
 const { cmdAuth } = require("./commands/auth");
 const { cmdGenerate } = require("./commands/generate");
+const { cmdRuntime } = require("./commands/runtime");
 const { ValidationError, CliError } = require("./lib/errors");
 
 function getVersion() {
@@ -25,7 +26,7 @@ function parseCommand(argv) {
   return { command: first, args: rest };
 }
 
-const COMMANDS = new Set(["help", "version", "init", "auth", "generate"]);
+const COMMANDS = new Set(["help", "version", "init", "auth", "generate", "runtime"]);
 
 async function run(argv) {
   const { command, args } = parseCommand(argv);
@@ -48,6 +49,8 @@ async function run(argv) {
       return cmdAuth(args);
     case "generate":
       return cmdGenerate(args);
+    case "runtime":
+      return cmdRuntime(args);
   }
 }
 

package/src/lib/scope.js

@@ -0,0 +1,68 @@
+"use strict";
+
+const path = require("path");
+const os = require("os");
+
+const VALID_SCOPES = ["project", "user"];
+
+/**
+ * Returns the default scope for a given runtime.
+ * Claude defaults to project-local, Codex defaults to user/global.
+ */
+function defaultScope(runtime) {
+  return runtime === "claude" ? "project" : "user";
+}
+
+/**
+ * Returns true if the given runtime supports project-local scope.
+ * Gate C0: Codex does not support project-local skills.
+ */
+function isProjectScopeSupported(runtime) {
+  return runtime === "claude";
+}
+
+/**
+ * Resolves the skills directory for a given runtime, scope, and project path.
+ */
+function resolveSkillsDir(runtime, scope, projectPath) {
+  if (runtime === "claude") {
+    if (scope === "user") {
+      return path.join(os.homedir(), ".claude", "skills");
+    }
+    return path.join(projectPath || process.cwd(), ".claude", "skills");
+  }
+
+  // Codex: always user/global scope
+  const codexHome = process.env.CODEX_HOME || path.join(os.homedir(), ".codex");
+  return path.join(codexHome, "skills");
+}
+
+/**
+ * SDTK-managed skill directory names per runtime.
+ * Used by runtime status to distinguish SDTK skills from unrelated user skills.
+ */
+const MANAGED_CODEX_SKILLS = [
+  "sdtk-api-design-spec", "sdtk-api-doc", "sdtk-arch", "sdtk-ba",
+  "sdtk-design-layout", "sdtk-dev", "sdtk-dev-backend", "sdtk-dev-frontend",
+  "sdtk-orchestrator", "sdtk-pm", "sdtk-qa", "sdtk-screen-design-spec",
+  "sdtk-test-case-spec",
+];
+
+const MANAGED_CLAUDE_SKILLS = [
+  "api-design-spec", "api-doc", "arch", "ba",
+  "design-layout", "dev", "dev-backend", "dev-frontend",
+  "orchestrator", "pm", "qa", "screen-design-spec",
+  "test-case-spec",
+];
+
+function managedSkillNames(runtime) {
+  return runtime === "claude" ? MANAGED_CLAUDE_SKILLS : MANAGED_CODEX_SKILLS;
+}
+
+module.exports = {
+  VALID_SCOPES,
+  defaultScope,
+  isProjectScopeSupported,
+  resolveSkillsDir,
+  managedSkillNames,
+};