create-nola-lang 0.1.2 → 0.1.4

package/README.md

@@ -3,7 +3,7 @@
 Scaffolds a new [Nola](https://github.com/nola-lang/nola) project:
 
 ```bash
-npm create nola-lang my-app
+npm create nola my-app          # or: npm create nola-lang my-app
 cd my-app
 npm install
 npm start        # runs offline via a committed replay ledger - no API key needed
@@ -11,5 +11,6 @@ npm start        # runs offline via a committed replay ledger - no API key neede
 
 You get a typed extraction example (`src/person.tsi` + a plain-TS consumer),
 `nola.config.ts`, tsconfig, and a recorded replay ledger so the first run
-works without any API key. `nola init` (from the `nola-lang` package) lays
+works without any API key. `npm create nola` is a short alias of this package
+(`create-nola`); `nola init` (from the `nola-lang` package) lays
 down the same starter.

package/dist/agents.d.ts

@@ -6,6 +6,22 @@ export declare const AGENT_OPTIONS: {
     label: string;
     hint: string;
 }[];
+/**
+ * Adapters that inject context inline embed SKILL.md's BODY verbatim, so no
+ * adapter restates the language rules in its own words and the four can
+ * never drift from each other (spec §2).
+ */
+export interface SkillSource {
+    /** the frontmatter block of SKILL.md, without the --- fences */
+    frontmatter: string;
+    /** the first heading up to (not including) `## References` */
+    body: string;
+    /** the whole file, verbatim — what the claude adapter copies */
+    full: string;
+}
+export declare function readSkillSource(): Promise<SkillSource>;
+/** The `## Nola` section for AGENTS.md — also the paste snippet when skipped. */
+export declare function agentsSection(s: SkillSource, version: string): string;
 /** Agents whose tooling is already present in the project. */
 export declare function detectAgents(targetDir: string): AgentId[];
 /** The interactive preselection: detected agents + the cross-agent baseline. */
@@ -17,7 +33,16 @@ export interface AgentSetupResult {
     wrote: string[];
     /** human-readable notes about files left untouched */
     skipped: string[];
+    /** true when something was left stale — the caller can suggest --force */
+    stale: boolean;
+}
+export interface WriteAgentSkillsOptions {
+    /** replace files stamped by another version (never touches unstamped files) */
+    force?: boolean;
 }
-/** Write the selected adapters; never rewrites an existing file. */
-export declare function writeAgentSkills(targetDir: string, agents: AgentId[]): Promise<AgentSetupResult>;
+/**
+ * Write the selected adapters as self-contained, version-stamped content.
+ * Existing files are classified, never blindly overwritten (spec §3).
+ */
+export declare function writeAgentSkills(targetDir: string, agents: AgentId[], opts?: WriteAgentSkillsOptions): Promise<AgentSetupResult>;
 //# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAEpE,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EAAiD,CAAC;AAE1F,wEAAwE;AACxE,eAAO,MAAM,aAAa,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAK1E,CAAC;AAkEF,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAOzD;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAE1D;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAUxD;AAED,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,sDAAsD;IACtD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,oEAAoE;AACpE,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsBtG"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAEpE,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EAAiD,CAAC;AAE1F,wEAAwE;AACxE,eAAO,MAAM,aAAa,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAK1E,CAAC;AAiBF;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CAQ5D;AA6BD,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE;AAMD,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAOzD;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAE1D;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAaxD;AAED,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,sDAAsD;IACtD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0EAA0E;IAC1E,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAyCD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EAAE,EACjB,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,gBAAgB,CAAC,CAsD3B"}

package/dist/agents.js

@@ -1,70 +1,68 @@
 import { existsSync } from "node:fs";
-import { mkdir, writeFile } from "node:fs/promises";
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ownVersion } from "./scaffold.js";
 export const AGENT_IDS = ["claude", "cursor", "copilot", "agents-md"];
 /** Shared option list for every "Set up coding agents?" multiselect. */
 export const AGENT_OPTIONS = [
-    { value: "agents-md", label: "AGENTS.md", hint: "cross-agent pointer file (Codex, Gemini CLI, …)" },
-    { value: "claude", label: "Claude Code", hint: ".claude/skills/nola/SKILL.md" },
+    { value: "agents-md", label: "AGENTS.md", hint: "cross-agent instructions (Codex, Gemini CLI, …)" },
+    { value: "claude", label: "Claude Code", hint: ".claude/skills/nola/ (full skill + references)" },
     { value: "cursor", label: "Cursor", hint: ".cursor/rules/nola.mdc" },
     { value: "copilot", label: "GitHub Copilot", hint: ".github/instructions/nola.instructions.md" },
 ];
 /**
- * Adapters are POINTERS into the installed package, never copies — the
- * content an agent reads then always version-matches the installed compiler
- * (spec 2026-08-14-agent-skill-distribution-design.md §1).
+ * The canonical skill content, resolved relative to this module — `src/` in
+ * this checkout, `dist/` in the published tarball, both one level under the
+ * package root (the same trick TEMPLATES_DIR uses in scaffold.ts).
  */
-const POINTER_BODY = `Read \`node_modules/nola-lang/skills/nola/SKILL.md\` and the files under
-\`node_modules/nola-lang/skills/nola/references/\` before writing or editing
-\`.tsi\` files. If that path is missing, run \`npm install\` first.
-`;
-/**
- * Clause-free variant of POINTER_BODY: just the paths + the npm-install
- * fallback. For adapters whose own lead-in sentence already states the
- * "before writing or editing .tsi files" clause, so it isn't said twice.
- */
-const POINTER_PATHS = `\`node_modules/nola-lang/skills/nola/SKILL.md\` and the files under
-\`node_modules/nola-lang/skills/nola/references/\`. If that path is missing, run
-\`npm install\` first.
-`;
-const CLAUDE_SKILL = `---
-name: nola
-description: Writing Nola .tsi files — a TypeScript superset with infer
-  functions and ask extractors. Use when creating or editing .tsi files or
-  nola.config.ts.
----
-
-This project uses Nola. Before writing or editing \`.tsi\` files, read the
-version-matched skill content installed with the language:
-${POINTER_PATHS}`;
-const AGENTS_SECTION = `## Nola
-
-This project uses Nola (\`.tsi\` files — a TypeScript superset; not valid
-TS). Before writing or editing \`.tsi\` files or \`nola.config.ts\`, read the
-version-matched skill content installed with the language:
-
-${POINTER_PATHS}`;
-const AGENTS_MD = `# AGENTS.md
-
-${AGENTS_SECTION}`;
-const CURSOR_RULE = `---
-description: Nola (.tsi) language rules
-globs: ["**/*.tsi", "nola.config.ts"]
-alwaysApply: false
----
-
-${POINTER_BODY}`;
-const COPILOT_INSTRUCTIONS = `---
-applyTo: "**/*.tsi"
----
-
-${POINTER_BODY}`;
-const ADAPTERS = {
-    claude: { path: ".claude/skills/nola/SKILL.md", content: CLAUDE_SKILL },
-    cursor: { path: ".cursor/rules/nola.mdc", content: CURSOR_RULE },
-    copilot: { path: ".github/instructions/nola.instructions.md", content: COPILOT_INSTRUCTIONS },
-    "agents-md": { path: "AGENTS.md", content: AGENTS_MD },
-};
+const SKILLS_DIR = fileURLToPath(new URL("../skills/nola/", import.meta.url));
+/** Marks a generated file so staleness is detectable (spec §3). */
+const STAMP_RE = /^<!-- nola-skill v(\S+)/m;
+const stamp = (version) => `<!-- nola-skill v${version} — regenerate with: nola skill install --force -->`;
+/** Pointer-era adapters (0.1.0–0.1.3) named this path; they are superseded. */
+const LEGACY_MARKER = "node_modules/nola-lang/skills/nola";
+export async function readSkillSource() {
+    const full = (await readFile(join(SKILLS_DIR, "SKILL.md"), "utf8")).replaceAll("\r\n", "\n");
+    const fm = /^---\n([\s\S]*?)\n---\n/.exec(full);
+    if (!fm)
+        throw new Error("SKILL.md is missing its frontmatter block");
+    const afterFm = full.slice(fm[0].length);
+    const refsAt = afterFm.indexOf("\n## References");
+    const body = (refsAt === -1 ? afterFm : afterFm.slice(0, refsAt)).trim();
+    return { frontmatter: fm[1], body, full };
+}
+/** Points at the project-local copy — never node_modules (spec §1). */
+const LOCAL_REFERENCES = [
+    "Deeper references, when this repo has them:",
+    "`.claude/skills/nola/references/` — syntax.md, patterns.md, config.md,",
+    "pitfalls.md.",
+].join("\n");
+function cursorRule(s, version) {
+    return [
+        "---",
+        "description: Nola (.tsi) language rules",
+        'globs: ["**/*.tsi", "nola.config.ts"]',
+        "alwaysApply: false",
+        "---",
+        stamp(version),
+        "",
+        s.body,
+        "",
+        LOCAL_REFERENCES,
+        "",
+    ].join("\n");
+}
+function copilotInstructions(s, version) {
+    return ["---", 'applyTo: "**/*.tsi"', "---", stamp(version), "", s.body, "", LOCAL_REFERENCES, ""].join("\n");
+}
+/** The `## Nola` section for AGENTS.md — also the paste snippet when skipped. */
+export function agentsSection(s, version) {
+    return ["## Nola", "", stamp(version), "", s.body, "", LOCAL_REFERENCES, ""].join("\n");
+}
+function agentsMd(s, version) {
+    return `# AGENTS.md\n\n${agentsSection(s, version)}`;
+}
 /** Agents whose tooling is already present in the project. */
 export function detectAgents(targetDir) {
     const root = resolve(targetDir);
@@ -87,7 +85,10 @@ export function parseAgentsFlag(value) {
         return [...AGENT_IDS];
     if (value === "none")
         return [];
-    const ids = value.split(",").map((s) => s.trim()).filter(Boolean);
+    const ids = value
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
     for (const id of ids) {
         if (!AGENT_IDS.includes(id)) {
             throw new Error(`invalid --agents "${value}" (valid: ${AGENT_IDS.join(", ")} — or all, none)`);
@@ -95,27 +96,95 @@ export function parseAgentsFlag(value) {
     }
     return [...new Set(ids)];
 }
-/** Write the selected adapters; never rewrites an existing file. */
-export async function writeAgentSkills(targetDir, agents) {
+/** Classify an existing target per spec §3. */
+function disposition(path, existing, version, force) {
+    const found = STAMP_RE.exec(existing);
+    // Legacy pointers are checked FIRST and independently of the stamp: the
+    // 0.1.0–0.1.3 adapters predate stamping, so they carry none at all.
+    const legacy = existing.includes(LEGACY_MARKER);
+    if (!legacy) {
+        if (!found) {
+            return {
+                write: false,
+                note: `${path} already exists and was not generated by nola — left untouched`,
+                stale: false,
+            };
+        }
+        if (found[1] === version)
+            return { write: false, note: `${path} is up to date (v${version})`, stale: false };
+    }
+    if (force)
+        return { write: true };
+    const what = legacy
+        ? `${path} uses the superseded pointer form`
+        : `${path} is stale (v${found?.[1]} → v${version})`;
+    return { write: false, note: `${what} — re-run with --force to replace it`, stale: true };
+}
+/** Copy the canonical skill dir verbatim (stamp aside) into .claude/skills/nola/. */
+async function writeClaudeSkill(root, s, version) {
+    const dir = join(root, ".claude", "skills", "nola");
+    await mkdir(join(dir, "references"), { recursive: true });
+    const stamped = s.full.replace(/^(---\n[\s\S]*?\n---\n)/, `$1${stamp(version)}\n`);
+    await writeFile(join(dir, "SKILL.md"), stamped);
+    const wrote = [".claude/skills/nola/SKILL.md"];
+    for (const name of (await readdir(join(SKILLS_DIR, "references"))).sort()) {
+        await writeFile(join(dir, "references", name), await readFile(join(SKILLS_DIR, "references", name), "utf8"));
+        wrote.push(`.claude/skills/nola/references/${name}`);
+    }
+    return wrote;
+}
+/**
+ * Write the selected adapters as self-contained, version-stamped content.
+ * Existing files are classified, never blindly overwritten (spec §3).
+ */
+export async function writeAgentSkills(targetDir, agents, opts = {}) {
     const root = resolve(targetDir);
+    const version = await ownVersion();
+    const source = await readSkillSource();
+    const force = opts.force === true;
     const wrote = [];
     const skipped = [];
+    let stale = false;
+    const flat = {
+        cursor: { path: ".cursor/rules/nola.mdc", content: cursorRule(source, version) },
+        copilot: { path: ".github/instructions/nola.instructions.md", content: copilotInstructions(source, version) },
+        "agents-md": { path: "AGENTS.md", content: agentsMd(source, version) },
+    };
     for (const id of AGENT_IDS) {
         if (!agents.includes(id))
             continue;
-        const { path, content } = ADAPTERS[id];
+        if (id === "claude") {
+            const marker = join(root, ".claude", "skills", "nola", "SKILL.md");
+            if (existsSync(marker)) {
+                const d = disposition(".claude/skills/nola/SKILL.md", await readFile(marker, "utf8"), version, force);
+                if (!d.write) {
+                    skipped.push(d.note);
+                    stale ||= d.stale;
+                    continue;
+                }
+            }
+            wrote.push(...(await writeClaudeSkill(root, source, version)));
+            continue;
+        }
+        const { path, content } = flat[id];
         const abs = join(root, ...path.split("/"));
         if (existsSync(abs)) {
-            // AGENTS.md commonly pre-exists; hand the section over for manual paste.
-            skipped.push(id === "agents-md"
-                ? `AGENTS.md already exists — left untouched. Add this section manually:\n\n${AGENTS_SECTION}`
-                : `${path} already exists — left untouched`);
-            continue;
+            // AGENTS.md is a user file: never modified, --force included.
+            if (id === "agents-md") {
+                skipped.push(`AGENTS.md already exists — left untouched. Add this section manually:\n\n${agentsSection(source, version)}`);
+                continue;
+            }
+            const d = disposition(path, await readFile(abs, "utf8"), version, force);
+            if (!d.write) {
+                skipped.push(d.note);
+                stale ||= d.stale;
+                continue;
+            }
         }
         await mkdir(dirname(abs), { recursive: true });
         await writeFile(abs, content);
         wrote.push(path);
     }
-    return { wrote, skipped };
+    return { wrote, skipped, stale };
 }
 //# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"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"}

package/dist/{chunk-QTJ64H2Y.js → chunk-VZM5EYBG.js}

@@ -224,61 +224,60 @@ async function addNola(targetDir, opts = {}) {
 
 // src/agents.ts
 import { existsSync as existsSync4 } from "node:fs";
-import { mkdir as mkdir2, writeFile as writeFile3 } from "node:fs/promises";
+import { mkdir as mkdir2, readdir as readdir3, readFile as readFile4, writeFile as writeFile3 } from "node:fs/promises";
 import { dirname, join as join4, resolve as resolve3 } from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 var AGENT_IDS = ["claude", "cursor", "copilot", "agents-md"];
 var AGENT_OPTIONS = [
-  { value: "agents-md", label: "AGENTS.md", hint: "cross-agent pointer file (Codex, Gemini CLI, \u2026)" },
-  { value: "claude", label: "Claude Code", hint: ".claude/skills/nola/SKILL.md" },
+  { value: "agents-md", label: "AGENTS.md", hint: "cross-agent instructions (Codex, Gemini CLI, \u2026)" },
+  { value: "claude", label: "Claude Code", hint: ".claude/skills/nola/ (full skill + references)" },
   { value: "cursor", label: "Cursor", hint: ".cursor/rules/nola.mdc" },
   { value: "copilot", label: "GitHub Copilot", hint: ".github/instructions/nola.instructions.md" }
 ];
-var POINTER_BODY = `Read \`node_modules/nola-lang/skills/nola/SKILL.md\` and the files under
-\`node_modules/nola-lang/skills/nola/references/\` before writing or editing
-\`.tsi\` files. If that path is missing, run \`npm install\` first.
-`;
-var POINTER_PATHS = `\`node_modules/nola-lang/skills/nola/SKILL.md\` and the files under
-\`node_modules/nola-lang/skills/nola/references/\`. If that path is missing, run
-\`npm install\` first.
-`;
-var CLAUDE_SKILL = `---
-name: nola
-description: Writing Nola .tsi files \u2014 a TypeScript superset with infer
-  functions and ask extractors. Use when creating or editing .tsi files or
-  nola.config.ts.
----
-
-This project uses Nola. Before writing or editing \`.tsi\` files, read the
-version-matched skill content installed with the language:
-${POINTER_PATHS}`;
-var AGENTS_SECTION = `## Nola
-
-This project uses Nola (\`.tsi\` files \u2014 a TypeScript superset; not valid
-TS). Before writing or editing \`.tsi\` files or \`nola.config.ts\`, read the
-version-matched skill content installed with the language:
-
-${POINTER_PATHS}`;
-var AGENTS_MD = `# AGENTS.md
-
-${AGENTS_SECTION}`;
-var CURSOR_RULE = `---
-description: Nola (.tsi) language rules
-globs: ["**/*.tsi", "nola.config.ts"]
-alwaysApply: false
----
-
-${POINTER_BODY}`;
-var COPILOT_INSTRUCTIONS = `---
-applyTo: "**/*.tsi"
----
+var SKILLS_DIR = fileURLToPath3(new URL("../skills/nola/", import.meta.url));
+var STAMP_RE = /^<!-- nola-skill v(\S+)/m;
+var stamp = (version) => `<!-- nola-skill v${version} \u2014 regenerate with: nola skill install --force -->`;
+var LEGACY_MARKER = "node_modules/nola-lang/skills/nola";
+async function readSkillSource() {
+  const full = (await readFile4(join4(SKILLS_DIR, "SKILL.md"), "utf8")).replaceAll("\r\n", "\n");
+  const fm = /^---\n([\s\S]*?)\n---\n/.exec(full);
+  if (!fm) throw new Error("SKILL.md is missing its frontmatter block");
+  const afterFm = full.slice(fm[0].length);
+  const refsAt = afterFm.indexOf("\n## References");
+  const body = (refsAt === -1 ? afterFm : afterFm.slice(0, refsAt)).trim();
+  return { frontmatter: fm[1], body, full };
+}
+var LOCAL_REFERENCES = [
+  "Deeper references, when this repo has them:",
+  "`.claude/skills/nola/references/` \u2014 syntax.md, patterns.md, config.md,",
+  "pitfalls.md."
+].join("\n");
+function cursorRule(s, version) {
+  return [
+    "---",
+    "description: Nola (.tsi) language rules",
+    'globs: ["**/*.tsi", "nola.config.ts"]',
+    "alwaysApply: false",
+    "---",
+    stamp(version),
+    "",
+    s.body,
+    "",
+    LOCAL_REFERENCES,
+    ""
+  ].join("\n");
+}
+function copilotInstructions(s, version) {
+  return ["---", 'applyTo: "**/*.tsi"', "---", stamp(version), "", s.body, "", LOCAL_REFERENCES, ""].join("\n");
+}
+function agentsSection(s, version) {
+  return ["## Nola", "", stamp(version), "", s.body, "", LOCAL_REFERENCES, ""].join("\n");
+}
+function agentsMd(s, version) {
+  return `# AGENTS.md
 
-${POINTER_BODY}`;
-var ADAPTERS = {
-  claude: { path: ".claude/skills/nola/SKILL.md", content: CLAUDE_SKILL },
-  cursor: { path: ".cursor/rules/nola.mdc", content: CURSOR_RULE },
-  copilot: { path: ".github/instructions/nola.instructions.md", content: COPILOT_INSTRUCTIONS },
-  "agents-md": { path: "AGENTS.md", content: AGENTS_MD }
-};
+${agentsSection(s, version)}`;
+}
 function detectAgents(targetDir) {
   const root = resolve3(targetDir);
   const found = [];
@@ -301,27 +300,87 @@ function parseAgentsFlag(value) {
   }
   return [...new Set(ids)];
 }
-async function writeAgentSkills(targetDir, agents) {
+function disposition(path, existing, version, force) {
+  const found = STAMP_RE.exec(existing);
+  const legacy = existing.includes(LEGACY_MARKER);
+  if (!legacy) {
+    if (!found) {
+      return {
+        write: false,
+        note: `${path} already exists and was not generated by nola \u2014 left untouched`,
+        stale: false
+      };
+    }
+    if (found[1] === version) return { write: false, note: `${path} is up to date (v${version})`, stale: false };
+  }
+  if (force) return { write: true };
+  const what = legacy ? `${path} uses the superseded pointer form` : `${path} is stale (v${found?.[1]} \u2192 v${version})`;
+  return { write: false, note: `${what} \u2014 re-run with --force to replace it`, stale: true };
+}
+async function writeClaudeSkill(root, s, version) {
+  const dir = join4(root, ".claude", "skills", "nola");
+  await mkdir2(join4(dir, "references"), { recursive: true });
+  const stamped = s.full.replace(/^(---\n[\s\S]*?\n---\n)/, `$1${stamp(version)}
+`);
+  await writeFile3(join4(dir, "SKILL.md"), stamped);
+  const wrote = [".claude/skills/nola/SKILL.md"];
+  for (const name of (await readdir3(join4(SKILLS_DIR, "references"))).sort()) {
+    await writeFile3(join4(dir, "references", name), await readFile4(join4(SKILLS_DIR, "references", name), "utf8"));
+    wrote.push(`.claude/skills/nola/references/${name}`);
+  }
+  return wrote;
+}
+async function writeAgentSkills(targetDir, agents, opts = {}) {
   const root = resolve3(targetDir);
+  const version = await ownVersion();
+  const source = await readSkillSource();
+  const force = opts.force === true;
   const wrote = [];
   const skipped = [];
+  let stale = false;
+  const flat = {
+    cursor: { path: ".cursor/rules/nola.mdc", content: cursorRule(source, version) },
+    copilot: { path: ".github/instructions/nola.instructions.md", content: copilotInstructions(source, version) },
+    "agents-md": { path: "AGENTS.md", content: agentsMd(source, version) }
+  };
   for (const id of AGENT_IDS) {
     if (!agents.includes(id)) continue;
-    const { path, content } = ADAPTERS[id];
+    if (id === "claude") {
+      const marker = join4(root, ".claude", "skills", "nola", "SKILL.md");
+      if (existsSync4(marker)) {
+        const d = disposition(".claude/skills/nola/SKILL.md", await readFile4(marker, "utf8"), version, force);
+        if (!d.write) {
+          skipped.push(d.note);
+          stale ||= d.stale;
+          continue;
+        }
+      }
+      wrote.push(...await writeClaudeSkill(root, source, version));
+      continue;
+    }
+    const { path, content } = flat[id];
     const abs = join4(root, ...path.split("/"));
     if (existsSync4(abs)) {
-      skipped.push(
-        id === "agents-md" ? `AGENTS.md already exists \u2014 left untouched. Add this section manually:
+      if (id === "agents-md") {
+        skipped.push(
+          `AGENTS.md already exists \u2014 left untouched. Add this section manually:
 
-${AGENTS_SECTION}` : `${path} already exists \u2014 left untouched`
-      );
-      continue;
+${agentsSection(source, version)}`
+        );
+        continue;
+      }
+      const d = disposition(path, await readFile4(abs, "utf8"), version, force);
+      if (!d.write) {
+        skipped.push(d.note);
+        stale ||= d.stale;
+        continue;
+      }
     }
     await mkdir2(dirname(abs), { recursive: true });
     await writeFile3(abs, content);
     wrote.push(path);
   }
-  return { wrote, skipped };
+  return { wrote, skipped, stale };
 }
 
 // src/ide.ts
@@ -375,8 +434,19 @@ async function writeVscodeSetup(targetDir) {
 
 // src/flow.ts
 import { existsSync as existsSync6 } from "node:fs";
-import { readdir as readdir3, readFile as readFile4 } from "node:fs/promises";
+import { readdir as readdir4, readFile as readFile5 } from "node:fs/promises";
 import { basename as basename2, join as join6, resolve as resolve5 } from "node:path";
+
+// src/package-manager.ts
+function detectPackageManager(userAgent = process.env.npm_config_user_agent) {
+  const name = userAgent?.split("/")[0]?.trim();
+  return name === "pnpm" || name === "yarn" || name === "bun" ? name : "npm";
+}
+function packageManagerCommands(pm) {
+  return { install: `${pm} install`, start: `${pm} start`, run: `${pm} run` };
+}
+
+// src/flow.ts
 var DEFAULT_DIR = "nola-app";
 var DEFAULT_TEMPLATE = "starter";
 function templateOption(t) {
@@ -427,7 +497,7 @@ async function resolveScaffoldOptions(input, prompter) {
       if (existsSync6(cwdManifest)) {
         let pkgName = "this project";
         try {
-          const parsed = JSON.parse(await readFile4(cwdManifest, "utf8"));
+          const parsed = JSON.parse(await readFile5(cwdManifest, "utf8"));
           if (parsed.name) pkgName = `"${parsed.name}"`;
         } catch {
         }
@@ -453,7 +523,7 @@ async function resolveScaffoldOptions(input, prompter) {
   }
   let force = false;
   const absRoot = resolve5(dir);
-  if (existsSync6(absRoot) && (await readdir3(absRoot)).length > 0) {
+  if (existsSync6(absRoot) && (await readdir4(absRoot)).length > 0) {
     if (!input.interactive) throw new Error(`target directory ${absRoot} is not empty`);
     if (existsSync6(join6(absRoot, "package.json"))) {
       const choice = await prompter.select(`Target directory "${dir}" is not empty and has a package.json.`, [
@@ -511,9 +581,11 @@ function plainPrompter() {
     outro: (m) => console.log(m)
   };
 }
-function nextSteps(outcome, fileCount, name) {
-  const keyless = outcome.template === "empty" ? "npm start        # set OPENAI_API_KEY first" : "npm start        # runs offline \u2014 no API key needed";
-  const lines = outcome.dir === "." ? ["npm install", keyless] : [`cd ${outcome.dir}`, "npm install", keyless];
+function nextSteps(outcome, fileCount, name, pm) {
+  const cmd = packageManagerCommands(pm);
+  const start = cmd.start.padEnd(16);
+  const keyless = outcome.template === "empty" ? `${start} # set OPENAI_API_KEY first` : `${start} # runs offline \u2014 no API key needed`;
+  const lines = outcome.dir === "." ? [cmd.install, keyless] : [`cd ${outcome.dir}`, cmd.install, keyless];
   return `Scaffolded ${name} (${fileCount} files).
 
 Next steps:
@@ -531,6 +603,7 @@ async function runFlow(args, opts = {}) {
     }
   }
   if (interactive) prompter.intro?.(opts.intro ?? `create-nola-lang v${await ownVersion()}`);
+  const pm = opts.packageManager ?? detectPackageManager();
   const input = {
     dir: args.dir,
     template: args.template,
@@ -557,7 +630,7 @@ async function runFlow(args, opts = {}) {
         return 0;
       }
       const lines = [
-        "npm install",
+        packageManagerCommands(pm).install,
         'optional start script:  "start": "nola run src/main.ts"',
         'tsconfig tip: directory-style include (e.g. ["src"]) lets the editor see .tsi files'
       ];
@@ -586,7 +659,8 @@ Next steps:
       const message = nextSteps(
         outcome,
         files.length + ideWrote.length + agWrote.length,
-        basename2(resolve5(outcome.dir))
+        basename2(resolve5(outcome.dir)),
+        pm
       );
       if (prompter.outro) prompter.outro(message);
       else console.log(message);

package/dist/flow.d.ts

@@ -1,4 +1,5 @@
 import { type AgentId } from "./agents.js";
+import { type PackageManager } from "./package-manager.js";
 export interface PrompterOption {
     value: string;
     label: string;
@@ -58,6 +59,8 @@ export interface RunFlowOptions {
     interactive?: boolean;
     /** bare-run detection root; default "." — tests pass a tmp dir */
     cwd?: string;
+    /** the manager that invoked us; default: detected from npm_config_user_agent */
+    packageManager?: PackageManager;
 }
 /** The shared entry for both `npm create nola-lang` and `nola init`. */
 export declare function runFlow(args: RunFlowArgs, opts?: RunFlowOptions): Promise<number>;