cadence-skill-installer 0.2.34 → 0.2.36

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cadence-skill-installer",
-  "version": "0.2.34",
+  "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/SKILL.md

@@ -94,13 +94,13 @@ description: Structured project operating system for end-to-end greenfield or br
 2. In subsequent conversations, if the workflow route is `ideator`, do not rerun prerequisite gate or project mode intake.
 3. If the user asks to define the project or provides a brief while route is `ideator`, invoke `skills/ideator/SKILL.md`.
 4. If route is `ideator` and the user has not provided ideation input yet, ask one kickoff ideation question in-thread and continue.
-5. When route advances from `ideator` to `researcher`, force a handoff and end with this exact line: `Start a new chat with a new agent and say "plan my project".`
+5. When route advances from `ideator` to `researcher`, force a handoff and end with this exact line: `Start a new chat with a new agent and say "research my project".`
 
 ## Brownfield Flow
 1. When scaffold, prerequisite, and project mode intake complete in this same conversation for a brownfield project and route advances to `brownfield-documenter`, force a subskill handoff and end with this exact line: `Start a new chat and say "document my existing project".`
 2. In subsequent conversations, if workflow route is `brownfield-documenter`, invoke `skills/brownfield-documenter/SKILL.md`.
 3. Do not route brownfield projects to `skills/ideator/SKILL.md` unless the user explicitly asks to run net-new ideation discovery.
-4. When route advances from `brownfield-documenter` to `researcher`, force a handoff and end with this exact line: `Start a new chat with a new agent and say "plan my project".`
+4. When route advances from `brownfield-documenter` to `researcher`, force a handoff and end with this exact line: `Start a new chat with a new agent and say "research my project".`
 
 ## Research Flow
 1. If the workflow route is `researcher`, invoke `skills/researcher/SKILL.md`.

package/skill/skills/brownfield-documenter/SKILL.md

@@ -55,7 +55,7 @@ description: Perform deep evidence-based analysis of an existing codebase and pe
 12. Mention that granular research queries are available via:
    - `python3 "$CADENCE_SCRIPTS_DIR/query-ideation-research.py" --project-root "$PROJECT_ROOT"`
 13. End successful completion replies with this exact line:
-   - `Start a new chat with a new agent and say "plan my project".`
+   - `Start a new chat with a new agent and say "research my project".`
 14. At end of this successful skill conversation, run `cd "$PROJECT_ROOT" && python3 "$CADENCE_SCRIPTS_DIR/finalize-skill-checkpoint.py" --scope brownfield-documenter --checkpoint documentation-captured --paths .`.
 15. If `finalize-skill-checkpoint.py` returns `status=no_changes`, continue without failure.
 16. If `finalize-skill-checkpoint.py` reports an error, stop and surface it verbatim.

package/skill/skills/brownfield-documenter/agents/openai.yaml

@@ -10,7 +10,7 @@ interface:
     analysis, then persist with scripts/run-brownfield-documentation.py --project-root "$PROJECT_ROOT" complete --stdin.
     Require a research_agenda with at least one topic, verify with scripts/get-ideation.py, and mention
     scripts/query-ideation-research.py for granular queries.
-    End success with: Start a new chat with a new agent and say "plan my project".
+    End success with: Start a new chat with a new agent and say "research my project".
     Finalize from PROJECT_ROOT with scripts/finalize-skill-checkpoint.py --scope brownfield-documenter
     --checkpoint documentation-captured --paths . (allow status=no_changes; surface failures verbatim).
     Keep replies concise and hide internal traces unless asked.

package/skill/skills/ideator/SKILL.md

@@ -81,7 +81,7 @@ description: Guide users from a rough concept to a fully defined project idea th
 17. Verify persistence by running `cd "$PROJECT_ROOT" && python3 "$CADENCE_SCRIPTS_DIR/get-ideation.py"`.
 18. Mention that granular research queries are available via `cd "$PROJECT_ROOT" && python3 "$CADENCE_SCRIPTS_DIR/query-ideation-research.py"`.
 19. Mention that research execution runs in a separate `researcher` phase.
-20. End successful ideation completion replies with this exact line: `Start a new chat with a new agent and say "plan my project".`
+20. End successful ideation completion replies with this exact line: `Start a new chat with a new agent and say "research my project".`
 21. At end of this successful skill conversation, run `cd "$PROJECT_ROOT" && python3 "$CADENCE_SCRIPTS_DIR/finalize-skill-checkpoint.py" --scope ideator --checkpoint ideation-completed --paths .`.
 22. If `finalize-skill-checkpoint.py` returns `status=no_changes`, continue without failure.
 23. If `finalize-skill-checkpoint.py` reports an error, stop and surface it verbatim.

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

@@ -10,7 +10,7 @@ interface:
     Ask one question at a time, build an execution-ready ideation object and complete research_agenda,
     then from PROJECT_ROOT rerun route assertion, run scripts/prepare-ideation-research.py,
     and persist with scripts/inject-ideation.py.
-    End successful completion with: Start a new chat with a new agent and say "plan my project".
+    End successful completion with: Start a new chat with a new agent and say "research my project".
     Finalize from PROJECT_ROOT with scripts/finalize-skill-checkpoint.py --scope ideator
     --checkpoint ideation-completed --paths . (allow status=no_changes; treat failures as blocking).
     Keep replies focused on ideation outcomes and hide internal traces unless asked.

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.