@montytools/cli 0.1.3 → 0.1.5

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 (changed && silent) console.log(`skills: refreshed (v${CLI_VERSION})`);
+    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: 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 */
   }
@@ -304,6 +339,27 @@ async function create() {
     console.log(`config: WARNING — could not reach ${host}/api/config; copy .env.example to .env.local manually`);
   }
 
+  // Build tracking: the /new screen minted an id; recording it here lets
+  // `monty deploy` resolve it and flips the UI into "agent is working" mode.
+  const buildId = flag("build");
+  if (buildId && /^[a-z0-9]{10,64}$/i.test(buildId)) {
+    mkdirSync(join(target, ".monty"), { recursive: true });
+    writeFileSync(join(target, ".monty", "build"), buildId + "\n");
+    const cfg = loadConfig();
+    if (cfg?.key) {
+      try {
+        await fetch(`${cfg.host ?? DEFAULT_HOST}/api/build`, {
+          method: "POST",
+          headers: { authorization: `Bearer ${cfg.key}`, "content-type": "application/json" },
+          body: JSON.stringify({ buildId, slug }),
+        });
+        console.log("build: workspace notified — the New app screen is following along");
+      } catch {
+        /* progress signal only — never block create */
+      }
+    }
+  }
+
   installSkills({ appDir: target });
   console.log(`created: ${target}`);
   console.log(`next: cd ${target} && pnpm install && monty dev`);
@@ -463,6 +519,10 @@ async function deploy() {
   // 3) Multipart POST to the host.
   const dist = join(appDir, "dist");
   const files = walk(dist);
+  const buildFile = join(appDir, ".monty", "build");
+  if (existsSync(buildFile)) {
+    meta.buildId = readFileSync(buildFile, "utf8").trim();
+  }
   const form = new FormData();
   form.set("monty", JSON.stringify(meta));
   let total = 0;
@@ -588,7 +648,7 @@ switch (command) {
   default:
     console.log("usage: monty <login|create|current|select|apps|dev|add|components|docs|deploy|skills>");
     console.log("  login       [--host <url>] [--key <mk_...>]  sign in (opens your browser to authorize)");
-    console.log("  create      <slug> [--name N] [--icon I]   stamp a new app into ~/Monty/<slug>");
+    console.log("  create      <slug> [--name N] [--icon I] [--build ID]  stamp a new app into ~/Monty/<slug>");
     console.log("  dev         [--port 5173]                  run the app locally (sandboxed data)");
     console.log("  add         <name...>                      install curated UI components (see `monty components`)");
     console.log("  components  [query]                        list the curated component catalog");

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.5",
   "type": "module",
   "bin": {
     "monty": "./bin/monty.mjs"

package/skills/monty-build/SKILL.md

@@ -17,6 +17,8 @@ the territory.
    tells you where you are; `cd "$(monty select <slug>)"` jumps to an app;
    `monty apps` lists local ones. Never mkdir app folders by hand.
 2. **The loop:** `monty create <slug> --name "Name" --icon <lucide-icon>` →
+   (if the prompt includes a `build id`, pass it: `--build <id>` — the
+   workspace's New app screen tracks your progress live) →
    edit `monty.config.ts` (zod tables) + `src/routes/` → verify with
    `monty dev` (localhost:5173, already authenticated, sandboxed data) →
    `monty deploy`. You are done when deploy prints the URL.