sdtk-kit 0.3.9 → 1.0.0

package/src/commands/runtime.js

@@ -1,217 +0,0 @@
-"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

@@ -1,59 +0,0 @@
-"use strict";
-
-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() {
-  const pkg = require("../package.json");
-  return pkg.version;
-}
-
-function parseCommand(argv) {
-  if (!argv || argv.length === 0) {
-    return { command: "help", args: [] };
-  }
-  const [first, ...rest] = argv;
-  if (first === "-h" || first === "--help") {
-    return { command: "help", args: [] };
-  }
-  if (first === "-v" || first === "--version") {
-    return { command: "version", args: [] };
-  }
-  return { command: first, args: rest };
-}
-
-const COMMANDS = new Set(["help", "version", "init", "auth", "generate", "runtime"]);
-
-async function run(argv) {
-  const { command, args } = parseCommand(argv);
-
-  if (!COMMANDS.has(command)) {
-    throw new ValidationError(
-      `Unknown command: "${command}". Run "sdtk --help" for available commands.`
-    );
-  }
-
-  switch (command) {
-    case "help":
-      return cmdHelp();
-    case "version":
-      console.log(`sdtk-kit ${getVersion()}`);
-      return 0;
-    case "init":
-      return cmdInit(args);
-    case "auth":
-      return cmdAuth(args);
-    case "generate":
-      return cmdGenerate(args);
-    case "runtime":
-      return cmdRuntime(args);
-  }
-}
-
-module.exports = {
-  run,
-};

package/src/lib/args.js

@@ -1,116 +0,0 @@
-"use strict";
-
-const { ValidationError } = require("./errors");
-
-/**
- * Parse argv into a structured flags object.
- * Supports: --flag value, --flag=value, --bool-flag (no value).
- *
- * @param {string[]} argv - Raw arguments (after command is stripped).
- * @param {Object<string, {type: 'string'|'boolean', required?: boolean, alias?: string}>} defs - Flag definitions.
- * @returns {{ flags: Object, positional: string[] }}
- */
-function parseFlags(argv, defs) {
-  const flags = {};
-  const positional = [];
-  const aliasMap = {};
-
-  for (const [name, def] of Object.entries(defs)) {
-    if (def.alias) aliasMap[def.alias] = name;
-    if (def.type === "boolean") flags[name] = false;
-    else flags[name] = undefined;
-  }
-
-  let i = 0;
-  while (i < argv.length) {
-    const arg = argv[i];
-
-    if (!arg.startsWith("-")) {
-      positional.push(arg);
-      i++;
-      continue;
-    }
-
-    let key;
-    let inlineValue;
-
-    if (arg.includes("=")) {
-      const eqIdx = arg.indexOf("=");
-      key = arg.slice(0, eqIdx);
-      inlineValue = arg.slice(eqIdx + 1);
-    } else {
-      key = arg;
-    }
-
-    // Normalize: strip leading dashes, resolve alias
-    const stripped = key.replace(/^-{1,2}/, "");
-    const resolved = aliasMap[stripped] || stripped;
-
-    if (!(resolved in defs)) {
-      throw new ValidationError(`Unknown flag: ${key}`);
-    }
-
-    const def = defs[resolved];
-
-    if (def.type === "boolean") {
-      flags[resolved] = true;
-      i++;
-    } else {
-      // string type
-      let value = inlineValue;
-      if (value === undefined) {
-        i++;
-        if (i >= argv.length) {
-          throw new ValidationError(`Flag ${key} requires a value.`);
-        }
-        value = argv[i];
-      }
-      flags[resolved] = value;
-      i++;
-    }
-  }
-
-  return { flags, positional };
-}
-
-/**
- * Require a flag to be present (non-undefined, non-empty for strings).
- */
-function requireFlag(flags, name, label) {
-  const val = flags[name];
-  if (val === undefined || val === null || val === "") {
-    throw new ValidationError(`Missing required flag: --${label || name}`);
-  }
-  return val;
-}
-
-/**
- * Validate a value is one of the allowed choices.
- */
-function validateChoice(value, choices, label) {
-  if (!choices.includes(value)) {
-    throw new ValidationError(
-      `Invalid value for --${label}: "${value}". Must be one of: ${choices.join(", ")}`
-    );
-  }
-  return value;
-}
-
-/**
- * Validate a value matches a regex pattern.
- */
-function validatePattern(value, regex, label, hint) {
-  if (!regex.test(value)) {
-    throw new ValidationError(
-      `Invalid value for --${label}: "${value}". ${hint || `Must match ${regex}`}`
-    );
-  }
-  return value;
-}
-
-module.exports = {
-  parseFlags,
-  requireFlag,
-  validateChoice,
-  validatePattern,
-};

package/src/lib/errors.js

@@ -1,41 +0,0 @@
-"use strict";
-
-class CliError extends Error {
-  constructor(message, exitCode = 4) {
-    super(message);
-    this.name = this.constructor.name;
-    this.exitCode = exitCode;
-  }
-}
-
-class ValidationError extends CliError {
-  constructor(message) {
-    super(message, 1);
-  }
-}
-
-class DependencyError extends CliError {
-  constructor(message) {
-    super(message, 2);
-  }
-}
-
-class IntegrityError extends CliError {
-  constructor(message) {
-    super(message, 3);
-  }
-}
-
-class InternalError extends CliError {
-  constructor(message) {
-    super(message, 4);
-  }
-}
-
-module.exports = {
-  CliError,
-  ValidationError,
-  DependencyError,
-  IntegrityError,
-  InternalError,
-};

package/src/lib/github-access.js

@@ -1,68 +0,0 @@
-"use strict";
-
-const { ValidationError } = require("./errors");
-
-// Entitlement repo: configurable via env var, falls back to default.
-// Set SDTK_ENTITLEMENT_REPO=owner/repo to override.
-const DEFAULT_REPO = "DucTN/sdtk-private";
-
-function getEntitlementRepo() {
-  return process.env.SDTK_ENTITLEMENT_REPO || DEFAULT_REPO;
-}
-
-/**
- * Check if a GitHub token has access to the private distribution repo.
- *
- * @param {string} token - GitHub PAT.
- * @param {string} [repo] - Repo in "owner/name" format. Defaults to SDTK_ENTITLEMENT_REPO env or built-in default.
- * @returns {Promise<{hasAccess: boolean, message: string}>}
- */
-async function checkRepoAccess(token, repo) {
-  const targetRepo = repo || getEntitlementRepo();
-  const url = `https://api.github.com/repos/${targetRepo}`;
-
-  try {
-    const response = await fetch(url, {
-      headers: {
-        Authorization: `Bearer ${token}`,
-        Accept: "application/vnd.github.v3+json",
-        "User-Agent": "sdtk-cli",
-      },
-    });
-
-    if (response.status === 200) {
-      return {
-        hasAccess: true,
-        message: `Access verified for ${targetRepo}.`,
-      };
-    }
-
-    if (response.status === 404 || response.status === 403) {
-      return {
-        hasAccess: false,
-        message: `No access to ${targetRepo}. Check your token permissions.`,
-      };
-    }
-
-    if (response.status === 401) {
-      return {
-        hasAccess: false,
-        message: "Token is invalid or expired.",
-      };
-    }
-
-    return {
-      hasAccess: false,
-      message: `Unexpected response (HTTP ${response.status}) from GitHub API.`,
-    };
-  } catch (err) {
-    throw new ValidationError(
-      `Failed to reach GitHub API: ${err.message}\nCheck your network connection.`
-    );
-  }
-}
-
-module.exports = {
-  checkRepoAccess,
-  getEntitlementRepo,
-};

package/src/lib/powershell.js

@@ -1,85 +0,0 @@
-"use strict";
-
-const { execFile } = require("child_process");
-const { DependencyError } = require("./errors");
-
-/**
- * Find available PowerShell executable.
- * Prefers pwsh (PowerShell Core) over powershell.exe (Windows PowerShell).
- * @returns {string} PowerShell executable name.
- */
-function findPowerShell() {
-  // On Windows, powershell.exe is always available
-  // pwsh (PowerShell Core) is preferred if available
-  if (process.platform === "win32") {
-    return "powershell.exe";
-  }
-  // On non-Windows, pwsh must be installed
-  return "pwsh";
-}
-
-/**
- * Execute a PowerShell script file with arguments.
- *
- * @param {string} scriptPath - Absolute path to the .ps1 file.
- * @param {Object<string, string|boolean>} params - Parameters to pass.
- *   String values become `-ParamName "value"`, boolean true becomes `-ParamName`.
- * @param {Object} [options] - Optional settings.
- * @param {boolean} [options.silent] - If true, suppress stdout output.
- * @returns {Promise<{exitCode: number, stdout: string, stderr: string}>}
- */
-function runScript(scriptPath, params = {}, options = {}) {
-  return new Promise((resolve, reject) => {
-    const psExe = findPowerShell();
-    const args = [
-      "-ExecutionPolicy",
-      "Bypass",
-      "-NoProfile",
-      "-NonInteractive",
-      "-File",
-      scriptPath,
-    ];
-
-    // Build parameters safely using execFile array args
-    for (const [key, value] of Object.entries(params)) {
-      if (value === true) {
-        args.push(`-${key}`);
-      } else if (value === false || value === undefined || value === null) {
-        // Skip false/undefined/null switches
-      } else {
-        args.push(`-${key}`);
-        args.push(String(value));
-      }
-    }
-
-    execFile(psExe, args, { maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
-      if (error && error.code === "ENOENT") {
-        reject(
-          new DependencyError(
-            `PowerShell not found. Ensure PowerShell is installed and available in PATH.\n` +
-              `Tried: ${psExe}`
-          )
-        );
-        return;
-      }
-
-      const exitCode = error ? error.code || 1 : 0;
-      const result = {
-        exitCode: typeof exitCode === "number" ? exitCode : 1,
-        stdout: stdout || "",
-        stderr: stderr || "",
-      };
-
-      if (!options.silent && result.stdout) {
-        process.stdout.write(result.stdout);
-      }
-
-      resolve(result);
-    });
-  });
-}
-
-module.exports = {
-  runScript,
-  findPowerShell,
-};

package/src/lib/scope.js

@@ -1,68 +0,0 @@
-"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,
-};