cadence-skill-installer 0.2.35 → 0.2.36

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cadence-skill-installer",
-  "version": "0.2.35",
+  "version": "0.2.36",
   "description": "Install the Cadence skill into supported AI tool skill directories.",
   "repository": "https://github.com/snowdamiz/cadence",
   "private": false,

package/scripts/install-cadence-skill.mjs

@@ -8,6 +8,9 @@ import { fileURLToPath } from "node:url";
 import { stdin as input, stdout as output } from "node:process";
 
 const CADENCE_SKILL_NAME = "cadence";
+const SCRIPT_PATH = fileURLToPath(import.meta.url);
+const SCRIPT_DIR = path.dirname(SCRIPT_PATH);
+const PACKAGE_JSON_PATH = path.resolve(SCRIPT_DIR, "..", "package.json");
 
 const TOOL_TARGETS = [
   { key: "codex", label: "Codex", relPath: [".codex", "skills", CADENCE_SKILL_NAME] },
@@ -87,10 +90,12 @@ function colorizeAsciiBanner() {
   });
 }
 
-function printHelp(binName) {
+function printHelp(binName, installerVersion) {
   const validTools = TOOL_TARGETS.map((tool) => tool.key).join(",");
   output.write(
     [
+      `Cadence Skill Installer v${installerVersion}`,
+      "",
       `Usage: ${binName} [options]`,
       "",
       "Options:",
@@ -148,10 +153,21 @@ function parseArgs(argv) {
   return parsed;
 }
 
+async function readInstallerVersion() {
+  try {
+    const raw = await fs.readFile(PACKAGE_JSON_PATH, "utf8");
+    const pkg = JSON.parse(raw);
+    if (typeof pkg.version === "string" && pkg.version.trim()) {
+      return pkg.version.trim();
+    }
+  } catch {
+    // Use fallback when package metadata is unavailable.
+  }
+  return "unknown";
+}
+
 function resolveSourceDir() {
-  const scriptPath = fileURLToPath(import.meta.url);
-  const scriptDir = path.dirname(scriptPath);
-  return path.resolve(scriptDir, "..", "skill");
+  return path.resolve(SCRIPT_DIR, "..", "skill");
 }
 
 async function ensureSourceDir(sourceDir) {
@@ -510,18 +526,19 @@ async function confirmInstall(parsed, selectedTargets) {
 
 async function main() {
   const binName = path.basename(process.argv[1] || "cadence-install");
+  const installerVersion = await readInstallerVersion();
   let parsed;
   try {
     parsed = parseArgs(process.argv.slice(2));
   } catch (error) {
     output.write(`Error: ${error.message}\n\n`);
-    printHelp(binName);
+    printHelp(binName, installerVersion);
     process.exitCode = 1;
     return;
   }
 
   if (parsed.help) {
-    printHelp(binName);
+    printHelp(binName, installerVersion);
     return;
   }
 
@@ -553,13 +570,19 @@ async function main() {
     return;
   }
 
+  output.write(
+    style(`\nInstalling Cadence skill version ${installerVersion}...\n`, ANSI.bold, ANSI.brightCyan)
+  );
+
   for (const target of selectedTargetsWithState) {
     await copySkillContents(sourceDir, target.targetDir);
     const action = target.installState?.exists ? "Updated" : "Installed";
     output.write(`${style(action, ANSI.bold, ANSI.brightGreen)} ${style(target.label, ANSI.bold, ANSI.white)}: ${style(target.targetDir, ANSI.periwinkle)}\n`);
   }
 
-  output.write(style("\nCadence skill installation complete.\n", ANSI.bold, ANSI.brightGreen));
+  output.write(
+    style(`\nCadence skill installation complete (version ${installerVersion}).\n`, ANSI.bold, ANSI.brightGreen)
+  );
 }
 
 main().catch((error) => {

package/skill/skills/scaffold/SKILL.md

@@ -5,7 +5,7 @@ description: Initialize Cadence project scaffolding for first-time setup. Use wh
 
 # Scaffold
 
-1. Resolve project root by running `python3 ../../scripts/resolve-project-root.py` and store stdout in `PROJECT_ROOT`.
+1. Resolve project root by running `python3 ../../scripts/resolve-project-root.py --project-root "$PWD"` and store stdout in `PROJECT_ROOT`.
    - Never manually edit `.cadence/cadence.json`; all Cadence state writes must go through Cadence scripts.
 2. Run `python3 ../../scripts/run-scaffold-gate.py --project-root "$PROJECT_ROOT"` (resolve this relative path from this sub-skill directory) and parse the JSON response.
 3. `run-scaffold-gate.py` performs workflow route assertion internally; if it errors, stop and surface the exact error to the user.
@@ -25,12 +25,15 @@ description: Initialize Cadence project scaffolding for first-time setup. Use wh
    - Keep local-only mode (`state.repo-enabled=false`) and continue until the user configures a GitHub repo later.
 8. Ask the user: `Do you want .cadence tracked in git history? (yes/no)`.
 9. If the user answers yes:
-   - Run `cd "$PROJECT_ROOT" && python3 "$CADENCE_SCRIPTS_DIR/configure-cadence-gitignore.py" --mode track`.
-   - At end of this skill conversation, run `cd "$PROJECT_ROOT" && python3 "$CADENCE_SCRIPTS_DIR/finalize-skill-checkpoint.py" --scope scaffold --checkpoint cadence-tracked --paths .`.
+   - Run `python3 "$CADENCE_SCRIPTS_DIR/configure-cadence-gitignore.py" --mode track --gitignore-path "$PROJECT_ROOT/.gitignore"`.
+   - At end of this skill conversation, run `python3 "$CADENCE_SCRIPTS_DIR/finalize-skill-checkpoint.py" --scope scaffold --checkpoint cadence-tracked --paths . --project-root "$PROJECT_ROOT"`.
 10. If the user answers no:
-   - Run `cd "$PROJECT_ROOT" && python3 "$CADENCE_SCRIPTS_DIR/configure-cadence-gitignore.py" --mode ignore`.
-   - At end of this skill conversation, run `cd "$PROJECT_ROOT" && python3 "$CADENCE_SCRIPTS_DIR/finalize-skill-checkpoint.py" --scope scaffold --checkpoint cadence-ignored --paths .`.
-11. If `finalize-skill-checkpoint.py` returns `status=no_changes`, continue without failure.
-12. If `finalize-skill-checkpoint.py` reports an error, stop and surface it verbatim.
-13. Execute scaffold actions serially. Do not run this flow in parallel with other setup gates.
-14. In user-facing replies, summarize only the result. Do not expose internal command lines, skill chains, or execution traces unless explicitly requested.
+   - Run `python3 "$CADENCE_SCRIPTS_DIR/configure-cadence-gitignore.py" --mode ignore --gitignore-path "$PROJECT_ROOT/.gitignore"`.
+   - At end of this skill conversation, run `python3 "$CADENCE_SCRIPTS_DIR/finalize-skill-checkpoint.py" --scope scaffold --checkpoint cadence-ignored --paths . --project-root "$PROJECT_ROOT"`.
+11. Argument contract guardrail:
+   - `configure-cadence-gitignore.py` accepts `--mode` and optional `--gitignore-path`; do not pass `--project-root`.
+   - `finalize-skill-checkpoint.py` supports `--project-root`; always pass it explicitly.
+12. If `finalize-skill-checkpoint.py` returns `status=no_changes`, continue without failure.
+13. If `finalize-skill-checkpoint.py` reports an error, stop and surface it verbatim.
+14. Execute scaffold actions serially. Do not run this flow in parallel with other setup gates.
+15. In user-facing replies, summarize only the result. Do not expose internal command lines, skill chains, or execution traces unless explicitly requested.

package/skill/skills/scaffold/agents/openai.yaml

@@ -3,14 +3,16 @@ interface:
   short_description: "Initialize Cadence project scaffolding for first-time setup"
   default_prompt: >-
     Follow skills/scaffold/SKILL.md for exact scaffold and policy behavior.
-    Resolve PROJECT_ROOT with scripts/resolve-project-root.py, run
+    Resolve PROJECT_ROOT with scripts/resolve-project-root.py --project-root "$PWD", run
     scripts/run-scaffold-gate.py --project-root "$PROJECT_ROOT", then run
     scripts/run-skill-entry-gate.py --project-root "$PROJECT_ROOT" --require-cadence and use its JSON output for
     CADENCE_SCRIPTS_DIR (cadence_scripts_dir) and push/local-only mode (repo_enabled).
+    For .cadence policy updates, run scripts/configure-cadence-gitignore.py with --mode and
+    --gitignore-path "$PROJECT_ROOT/.gitignore" only (do not pass --project-root).
     Never edit .cadence/cadence.json manually.
     Only rerun repo-status after remote setup to confirm repo_enabled=true; do not run an extra write pass
     just to persist false in local-only mode.
-    Finalize from PROJECT_ROOT with scripts/finalize-skill-checkpoint.py --paths . and the scope/checkpoint
+    Finalize with scripts/finalize-skill-checkpoint.py --paths . --project-root "$PROJECT_ROOT" and the scope/checkpoint
     that matches the selected policy (scaffold/cadence-tracked or scaffold/cadence-ignored), allowing
     status=no_changes and treating failures as blocking.
     Keep replies outcome-focused and hide internal traces unless asked.