@montytools/cli 0.1.3 → 0.1.4

package/bin/monty.mjs

@@ -132,37 +132,72 @@ function openInBrowser(url) {
 
 
 // ── agent skills ─────────────────────────────────────────────────────────────
-// The build skill ships inside this package and is stamped wherever agents
-// look for it: ~/.claude/skills (user) and <app>/.claude + <app>/.agents
-// (project — self-propagating contract, refreshed whenever the CLI runs).
+// The build skill ships inside this package. Primary installer is the
+// cross-agent standard `npx skills add` (same as InsForge) which fans out to
+// every agent's folder — Claude Code, Codex (.agents/skills), Cursor, etc.
+// Manual copy is the offline fallback. A version marker gates the work so
+// ordinary commands stay fast.
 const CLI_ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
 const CLI_VERSION = JSON.parse(readFileSync(join(CLI_ROOT, "package.json"), "utf8")).version;
 const SKILLS_SRC = join(CLI_ROOT, "skills");
+const GLOBAL_SKILLS_MARKER = join(CONFIG_DIR, "skills-version");
+// InsForge's agent list — enumerate rather than '*' so we only touch real agents.
+const SKILL_AGENTS = ["antigravity", "augment", "claude-code", "cline", "codex", "cursor", "gemini-cli", "github-copilot", "kilo", "qoder", "qwen-code", "roo", "trae", "windsurf"]
+  .flatMap((a) => ["-a", a]);
 
-function installSkillsInto(dir, { silent = true } = {}) {
-  if (!existsSync(SKILLS_SRC)) return false;
-  let changed = false;
+function readMarker(path) {
+  try {
+    return readFileSync(path, "utf8").trim();
+  } catch {
+    return null;
+  }
+}
+
+function skillsCliAdd({ global = false, cwd = undefined } = {}) {
+  const args = ["-y", "skills", "add", SKILLS_SRC, "-y", "--copy", ...(global ? ["-g"] : []), ...SKILL_AGENTS];
+  const res = spawnSync("npx", args, { cwd, stdio: "ignore", timeout: 120_000 });
+  return res.status === 0;
+}
+
+// Fallbacks for offline/npx-less environments: cover the two standard folders.
+function installSkillsInto(dir) {
+  if (!existsSync(SKILLS_SRC)) return;
   for (const name of readdirSync(SKILLS_SRC)) {
-    const dest = join(dir, name);
-    const versionFile = join(dest, "VERSION");
-    const installed = existsSync(versionFile) ? readFileSync(versionFile, "utf8").trim() : null;
-    if (installed === CLI_VERSION) continue;
-    cpSync(join(SKILLS_SRC, name), dest, { recursive: true });
-    writeFileSync(versionFile, CLI_VERSION + "\n");
-    changed = true;
-  }
-  if (changed && !silent) console.log(`skills: installed -> ${dir} (v${CLI_VERSION})`);
-  return changed;
+    cpSync(join(SKILLS_SRC, name), join(dir, name), { recursive: true });
+  }
 }
 
-function installSkills({ appDir = null, silent = true } = {}) {
+function manualInstall(appDir) {
+  if (appDir) {
+    installSkillsInto(join(appDir, ".claude", "skills"));
+    installSkillsInto(join(appDir, ".agents", "skills"));
+  } else {
+    installSkillsInto(join(homedir(), ".claude", "skills"));
+    installSkillsInto(join(homedir(), ".agents", "skills"));
+  }
+}
+
+function installSkills({ appDir = null, silent = true, force = false } = {}) {
   if (process.env.MONTY_NO_SKILLS) return;
   try {
-    let changed = installSkillsInto(join(homedir(), ".claude", "skills"), { silent });
-    for (const base of appDir ? [join(appDir, ".claude", "skills"), join(appDir, ".agents", "skills")] : []) {
-      changed = installSkillsInto(base, { silent }) || changed;
+    let changed = false;
+    if (force || readMarker(GLOBAL_SKILLS_MARKER) !== CLI_VERSION) {
+      if (!skillsCliAdd({ global: true })) manualInstall(null);
+      mkdirSync(CONFIG_DIR, { recursive: true });
+      writeFileSync(GLOBAL_SKILLS_MARKER, CLI_VERSION + "\n");
+      changed = true;
+    }
+    if (appDir) {
+      const marker = join(appDir, ".agents", "skills", "monty-build", "VERSION");
+      if (force || readMarker(marker) !== CLI_VERSION) {
+        if (!skillsCliAdd({ cwd: appDir })) manualInstall(appDir);
+        mkdirSync(dirname(marker), { recursive: true });
+        writeFileSync(marker, CLI_VERSION + "\n");
+        changed = true;
+      }
     }
-    if (changed && silent) console.log(`skills: refreshed (v${CLI_VERSION})`);
+    if (changed && !silent) console.log(`skills: installed for all agents (v${CLI_VERSION})`);
+    else if (changed) console.log(`skills: refreshed (v${CLI_VERSION})`);
   } catch {
     /* skills are best-effort — never block a command */
   }

package/bin/postinstall.mjs

@@ -19,6 +19,24 @@ try {
     writeFileSync(join(target, name, "VERSION"), version + "\n");
   }
   console.log(`monty: agent skill installed (~/.claude/skills, v${version})`);
+  // Codex: managed block in ~/.codex/AGENTS.md when Codex is present.
+  const codexDir = join(homedir(), ".codex");
+  const skillFile = join(src, "monty-build", "SKILL.md");
+  if (existsSync(codexDir) && existsSync(skillFile)) {
+    const body = readFileSync(skillFile, "utf8").replace(/^---[\s\S]*?---\n/, "").trim();
+    const START = "<!-- monty-build:start";
+    const END = "<!-- monty-build:end -->";
+    const block = `${START} v${version} -->\n${body}\n${END}`;
+    const file = join(codexDir, "AGENTS.md");
+    let cur = existsSync(file) ? readFileSync(file, "utf8") : "";
+    if (!cur.includes(`${START} v${version} -->`)) {
+      const re = new RegExp(`${START}[\\s\\S]*?${END}`);
+      cur = re.test(cur) ? cur.replace(re, block) : (cur ? cur.trimEnd() + "\n\n" : "") + block + "\n";
+      writeFileSync(file, cur);
+      console.log(`monty: agent contract added to ~/.codex/AGENTS.md (v${version})`);
+    }
+  }
+
 } catch {
   /* silent — skills are a convenience, not a dependency */
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@montytools/cli",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "bin": {
     "monty": "./bin/monty.mjs"