create-nola-lang 0.1.6 → 0.1.8

package/dist/agents.d.ts

@@ -1,7 +1,14 @@
-export type AgentId = "claude" | "cursor" | "copilot" | "agents-md";
+export type AgentId = "claude" | "universal" | "agents-md";
 export declare const AGENT_IDS: readonly AgentId[];
 /** `nola skill install`'s agents multiselect (the scaffold asks its own gated list, see flow.ts). */
 export declare const SKILL_AGENTS_QUESTION = "Set up coding agents? (Space toggles, Enter confirms)";
+/**
+ * Where each skill target writes the canonical directory (project-relative
+ * posix). Claude Code reads only `.claude/skills/`; `.agents/skills/` is the
+ * open Agent Skills location — "universal" in the skills CLI's vocabulary —
+ * that Cursor, Copilot, Codex, Gemini CLI and most other agents read.
+ */
+export declare const SKILL_DIRS: Readonly<Record<Exclude<AgentId, "agents-md">, string>>;
 /** Shared option list for every agents multiselect. */
 export declare const AGENT_OPTIONS: {
     value: AgentId;
@@ -9,30 +16,29 @@ export declare const AGENT_OPTIONS: {
     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).
+ * The AGENTS.md section embeds SKILL.md's BODY verbatim, so it can never
+ * drift from the skill directory (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 */
+    /** the whole file, verbatim — what the skill directories copy */
     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 + Claude Code (the wizard's default agent — deduped when detected). */
-export declare function defaultAgents(targetDir: string): AgentId[];
+/** The interactive preselection: both skill copies, so a plain Enter covers every skills-aware agent. */
+export declare function defaultAgents(_targetDir: string): AgentId[];
 /** "all" | "none" | comma list of ids; unknown ids throw listing valid values. */
 export declare function parseAgentsFlag(value: string): AgentId[];
 export interface AgentSetupResult {
     /** project-relative posix paths written */
     wrote: string[];
+    /** superseded stamped adapters deleted under --force (project-relative posix paths) */
+    removed: string[];
     /** human-readable notes about files left untouched */
     skipped: string[];
     /** true when something was left stale — the caller can suggest --force */
@@ -43,7 +49,7 @@ export interface WriteAgentSkillsOptions {
     force?: boolean;
 }
 /**
- * Write the selected adapters as self-contained, version-stamped content.
+ * Write the selected targets 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>;

package/dist/agents.js

@@ -1,17 +1,30 @@
 import { existsSync } from "node:fs";
-import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { mkdir, readdir, readFile, rm, 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"];
+export const AGENT_IDS = ["claude", "universal", "agents-md"];
 /** `nola skill install`'s agents multiselect (the scaffold asks its own gated list, see flow.ts). */
 export const SKILL_AGENTS_QUESTION = "Set up coding agents? (Space toggles, Enter confirms)";
+/**
+ * Where each skill target writes the canonical directory (project-relative
+ * posix). Claude Code reads only `.claude/skills/`; `.agents/skills/` is the
+ * open Agent Skills location — "universal" in the skills CLI's vocabulary —
+ * that Cursor, Copilot, Codex, Gemini CLI and most other agents read.
+ */
+export const SKILL_DIRS = {
+    claude: ".claude/skills/nola",
+    universal: ".agents/skills/nola",
+};
 /** Shared option list for every agents multiselect. */
 export const AGENT_OPTIONS = [
-    { 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" },
+    { value: "claude", label: "Claude Code", hint: ".claude/skills/nola/ (the only directory Claude Code reads)" },
+    {
+        value: "universal",
+        label: "Cursor, Copilot, Codex, Gemini CLI, …",
+        hint: ".agents/skills/nola/ (the open Agent Skills location)",
+    },
+    { value: "agents-md", label: "AGENTS.md", hint: "the skill body inline, for agents that read only AGENTS.md" },
 ];
 /**
  * The canonical skill content, resolved relative to this module — `src/` in
@@ -22,6 +35,11 @@ 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 -->`;
+/**
+ * Adapters written by 0.1.0–0.1.7 that the `.agents/skills` layout replaced
+ * (spec revision 2026-09-15). Stamped ones are ours to remove under --force.
+ */
+const LEGACY_ADAPTERS = [".cursor/rules/nola.mdc", ".github/instructions/nola.instructions.md"];
 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);
@@ -32,30 +50,12 @@ export async function readSkillSource() {
     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). */
+/** Points at the project-local copies — 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.",
+    "`.agents/skills/nola/references/` or `.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");
@@ -63,21 +63,9 @@ export function agentsSection(s, version) {
 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);
-    const found = [];
-    if (existsSync(join(root, ".claude")) || existsSync(join(root, "CLAUDE.md")))
-        found.push("claude");
-    if (existsSync(join(root, ".cursor")))
-        found.push("cursor");
-    if (existsSync(join(root, ".github")))
-        found.push("copilot");
-    return found;
-}
-/** The interactive preselection: detected agents + Claude Code (the wizard's default agent — deduped when detected). */
-export function defaultAgents(targetDir) {
-    return [...new Set([...detectAgents(targetDir), "claude"])];
+/** The interactive preselection: both skill copies, so a plain Enter covers every skills-aware agent. */
+export function defaultAgents(_targetDir) {
+    return ["claude", "universal"];
 }
 /** "all" | "none" | comma list of ids; unknown ids throw listing valid values. */
 export function parseAgentsFlag(value) {
@@ -116,21 +104,21 @@ function disposition(path, existing, version, force) {
         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");
+/** Copy the canonical skill dir verbatim (stamp aside) into `<root>/<base>/`. */
+async function writeSkillDir(root, base, s, version) {
+    const dir = join(root, ...base.split("/"));
     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"];
+    const wrote = [`${base}/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}`);
+        wrote.push(`${base}/references/${name}`);
     }
     return wrote;
 }
 /**
- * Write the selected adapters as self-contained, version-stamped content.
+ * Write the selected targets as self-contained, version-stamped content.
  * Existing files are classified, never blindly overwritten (spec §3).
  */
 export async function writeAgentSkills(targetDir, agents, opts = {}) {
@@ -139,48 +127,52 @@ export async function writeAgentSkills(targetDir, agents, opts = {}) {
     const source = await readSkillSource();
     const force = opts.force === true;
     const wrote = [];
+    const removed = [];
     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) {
+    for (const id of ["claude", "universal"]) {
         if (!agents.includes(id))
             continue;
-        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 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);
+        const base = SKILL_DIRS[id];
+        const marker = join(root, ...base.split("/"), "SKILL.md");
+        if (existsSync(marker)) {
+            const d = disposition(`${base}/SKILL.md`, await readFile(marker, "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);
+        wrote.push(...(await writeSkillDir(root, base, source, version)));
+    }
+    if (agents.includes("universal")) {
+        // Stamped legacy adapters are ours: superseded by .agents/skills, removed under --force.
+        for (const path of LEGACY_ADAPTERS) {
+            const abs = join(root, ...path.split("/"));
+            if (!existsSync(abs) || !STAMP_RE.test(await readFile(abs, "utf8")))
+                continue;
+            if (force) {
+                await rm(abs);
+                removed.push(path);
+            }
+            else {
+                skipped.push(`${path} is superseded by .agents/skills/nola — re-run with --force to remove it`);
+                stale = true;
+            }
+        }
+    }
+    if (agents.includes("agents-md")) {
+        const abs = join(root, "AGENTS.md");
+        if (existsSync(abs)) {
+            // AGENTS.md is a user file: never modified, --force included.
+            skipped.push(`AGENTS.md already exists — left untouched. Add this section manually:\n\n${agentsSection(source, version)}`);
+        }
+        else {
+            await mkdir(dirname(abs), { recursive: true });
+            await writeFile(abs, agentsMd(source, version));
+            wrote.push("AGENTS.md");
+        }
     }
-    return { wrote, skipped, stale };
+    return { wrote, removed, skipped, stale };
 }
 //# sourceMappingURL=agents.js.map

package/dist/{chunk-34XSPT6F.js → chunk-GUYF4NM5.js}

@@ -345,20 +345,28 @@ async function addNola(targetDir, opts = {}) {
 
 // src/agents.ts
 import { existsSync as existsSync5 } from "node:fs";
-import { mkdir as mkdir3, readdir as readdir3, readFile as readFile5, writeFile as writeFile3 } from "node:fs/promises";
+import { mkdir as mkdir3, readdir as readdir3, readFile as readFile5, rm as rm3, writeFile as writeFile3 } from "node:fs/promises";
 import { dirname as dirname2, join as join5, resolve as resolve3 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
-var AGENT_IDS = ["claude", "cursor", "copilot", "agents-md"];
+var AGENT_IDS = ["claude", "universal", "agents-md"];
 var SKILL_AGENTS_QUESTION = "Set up coding agents? (Space toggles, Enter confirms)";
+var SKILL_DIRS = {
+  claude: ".claude/skills/nola",
+  universal: ".agents/skills/nola"
+};
 var AGENT_OPTIONS = [
-  { 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" }
+  { value: "claude", label: "Claude Code", hint: ".claude/skills/nola/ (the only directory Claude Code reads)" },
+  {
+    value: "universal",
+    label: "Cursor, Copilot, Codex, Gemini CLI, \u2026",
+    hint: ".agents/skills/nola/ (the open Agent Skills location)"
+  },
+  { value: "agents-md", label: "AGENTS.md", hint: "the skill body inline, for agents that read only AGENTS.md" }
 ];
 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_ADAPTERS = [".cursor/rules/nola.mdc", ".github/instructions/nola.instructions.md"];
 async function readSkillSource() {
   const full = (await readFile5(join5(SKILLS_DIR, "SKILL.md"), "utf8")).replaceAll("\r\n", "\n");
   const fm = /^---\n([\s\S]*?)\n---\n/.exec(full);
@@ -370,27 +378,9 @@ async function readSkillSource() {
 }
 var LOCAL_REFERENCES = [
   "Deeper references, when this repo has them:",
-  "`.claude/skills/nola/references/` \u2014 syntax.md, patterns.md, config.md,",
-  "pitfalls.md."
+  "`.agents/skills/nola/references/` or `.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");
 }
@@ -399,16 +389,8 @@ function agentsMd(s, version) {
 
 ${agentsSection(s, version)}`;
 }
-function detectAgents(targetDir) {
-  const root = resolve3(targetDir);
-  const found = [];
-  if (existsSync5(join5(root, ".claude")) || existsSync5(join5(root, "CLAUDE.md"))) found.push("claude");
-  if (existsSync5(join5(root, ".cursor"))) found.push("cursor");
-  if (existsSync5(join5(root, ".github"))) found.push("copilot");
-  return found;
-}
-function defaultAgents(targetDir) {
-  return [.../* @__PURE__ */ new Set([...detectAgents(targetDir), "claude"])];
+function defaultAgents(_targetDir) {
+  return ["claude", "universal"];
 }
 function parseAgentsFlag(value) {
   if (value === "all") return [...AGENT_IDS];
@@ -438,16 +420,16 @@ function disposition(path, existing, version, force) {
     stale: true
   };
 }
-async function writeClaudeSkill(root, s, version) {
-  const dir = join5(root, ".claude", "skills", "nola");
+async function writeSkillDir(root, base, s, version) {
+  const dir = join5(root, ...base.split("/"));
   await mkdir3(join5(dir, "references"), { recursive: true });
   const stamped = s.full.replace(/^(---\n[\s\S]*?\n---\n)/, `$1${stamp(version)}
 `);
   await writeFile3(join5(dir, "SKILL.md"), stamped);
-  const wrote = [".claude/skills/nola/SKILL.md"];
+  const wrote = [`${base}/SKILL.md`];
   for (const name of (await readdir3(join5(SKILLS_DIR, "references"))).sort()) {
     await writeFile3(join5(dir, "references", name), await readFile5(join5(SKILLS_DIR, "references", name), "utf8"));
-    wrote.push(`.claude/skills/nola/references/${name}`);
+    wrote.push(`${base}/references/${name}`);
   }
   return wrote;
 }
@@ -457,51 +439,51 @@ async function writeAgentSkills(targetDir, agents, opts = {}) {
   const source = await readSkillSource();
   const force = opts.force === true;
   const wrote = [];
+  const removed = [];
   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 id2 of AGENT_IDS) {
+  for (const id2 of ["claude", "universal"]) {
     if (!agents.includes(id2)) continue;
-    if (id2 === "claude") {
-      const marker = join5(root, ".claude", "skills", "nola", "SKILL.md");
-      if (existsSync5(marker)) {
-        const d = disposition(".claude/skills/nola/SKILL.md", await readFile5(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[id2];
-    const abs = join5(root, ...path.split("/"));
-    if (existsSync5(abs)) {
-      if (id2 === "agents-md") {
-        skipped.push(
-          `AGENTS.md already exists \u2014 left untouched. Add this section manually:
-
-${agentsSection(source, version)}`
-        );
-        continue;
-      }
-      const d = disposition(path, await readFile5(abs, "utf8"), version, force);
+    const base = SKILL_DIRS[id2];
+    const marker = join5(root, ...base.split("/"), "SKILL.md");
+    if (existsSync5(marker)) {
+      const d = disposition(`${base}/SKILL.md`, await readFile5(marker, "utf8"), version, force);
       if (!d.write) {
         skipped.push(d.note);
         stale ||= d.stale;
         continue;
       }
     }
-    await mkdir3(dirname2(abs), { recursive: true });
-    await writeFile3(abs, content);
-    wrote.push(path);
+    wrote.push(...await writeSkillDir(root, base, source, version));
+  }
+  if (agents.includes("universal")) {
+    for (const path of LEGACY_ADAPTERS) {
+      const abs = join5(root, ...path.split("/"));
+      if (!existsSync5(abs) || !STAMP_RE.test(await readFile5(abs, "utf8"))) continue;
+      if (force) {
+        await rm3(abs);
+        removed.push(path);
+      } else {
+        skipped.push(`${path} is superseded by .agents/skills/nola \u2014 re-run with --force to remove it`);
+        stale = true;
+      }
+    }
+  }
+  if (agents.includes("agents-md")) {
+    const abs = join5(root, "AGENTS.md");
+    if (existsSync5(abs)) {
+      skipped.push(
+        `AGENTS.md already exists \u2014 left untouched. Add this section manually:
+
+${agentsSection(source, version)}`
+      );
+    } else {
+      await mkdir3(dirname2(abs), { recursive: true });
+      await writeFile3(abs, agentsMd(source, version));
+      wrote.push("AGENTS.md");
+    }
   }
-  return { wrote, skipped, stale };
+  return { wrote, removed, skipped, stale };
 }
 
 // src/api.ts
@@ -1842,7 +1824,7 @@ async function runFlow(args, opts = {}) {
       const result = await addNola(outcome.dir, { provider: outcome.provider });
       const trial = grant ? await applyTrial(outcome.dir, { apiKey: grant.apiKey, hasConfig: !result.wrote.includes("nola.config.ts") }) : { wrote: [], skipped: [] };
       const ide = outcome.ide === "vscode" ? await writeVscodeSetup(outcome.dir) : { wrote: [], skipped: [] };
-      const ag = outcome.agents.length > 0 ? await writeAgentSkills(outcome.dir, outcome.agents) : { wrote: [], skipped: [] };
+      const ag = outcome.agents.length > 0 ? await writeAgentSkills(outcome.dir, outcome.agents) : { wrote: [], removed: [], skipped: [] };
       for (const note of [...result.skipped, ...trial.skipped, ...ide.skipped, ...ag.skipped]) prompter.note(note);
       const trialWrote = trial.wrote.filter((f) => !result.wrote.includes(f));
       const written = [...result.wrote, ...result.added, ...trialWrote, ...ide.wrote, ...ag.wrote];
@@ -1931,7 +1913,6 @@ export {
   AGENT_IDS,
   SKILL_AGENTS_QUESTION,
   AGENT_OPTIONS,
-  detectAgents,
   defaultAgents,
   parseAgentsFlag,
   writeAgentSkills,

package/dist/flow.js

@@ -50,7 +50,7 @@ function templateOption(t) {
 }
 /**
  * The setup step: a yes/no gate (default yes), then editor + coding agents in
- * one grouped checkbox list, VS Code and Claude Code preselected — so the
+ * one grouped checkbox list, VS Code and both skill copies preselected — so the
  * defaults are two Enters and the whole no is one. `--ide` / `--agents` each
  * fill their half — a group a flag already answered is not shown and the gate
  * narrows to the half that remains; a no leaves the asked halves at none.
@@ -518,7 +518,9 @@ export async function runFlow(args, opts = {}) {
                 : { wrote: [], skipped: [] };
             // An explicit editor choice is honored even when Nola itself was already set up.
             const ide = outcome.ide === "vscode" ? await writeVscodeSetup(outcome.dir) : { wrote: [], skipped: [] };
-            const ag = outcome.agents.length > 0 ? await writeAgentSkills(outcome.dir, outcome.agents) : { wrote: [], skipped: [] };
+            const ag = outcome.agents.length > 0
+                ? await writeAgentSkills(outcome.dir, outcome.agents)
+                : { wrote: [], removed: [], skipped: [] };
             for (const note of [...result.skipped, ...trial.skipped, ...ide.skipped, ...ag.skipped])
                 prompter.note(note);
             // applyTrial re-writes the config addNola just wrote — list it once.

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export type { AddOptions, AddResult } from "./add.js";
 export { addNola } from "./add.js";
 export type { AgentId, AgentSetupResult } from "./agents.js";
-export { AGENT_IDS, AGENT_OPTIONS, defaultAgents, detectAgents, parseAgentsFlag, writeAgentSkills } from "./agents.js";
+export { AGENT_IDS, AGENT_OPTIONS, defaultAgents, parseAgentsFlag, writeAgentSkills } from "./agents.js";
 export type { ClientInit, KeyGrant, NolaAccountKind, NolaAuthConfig, NolaBillingSession, NolaCapabilities, NolaClaim, NolaConsoleCreatedKey, NolaConsoleMe, NolaTrialResponse, } from "./api.js";
 export { claimSession, createBillingSession, createConsoleKey, DEFAULT_API_URL, fetchCapabilities, fetchMe, isSessionRejected, NolaApiError, nolaApiUrl, requestTrial, sessionIdOf, } from "./api.js";
 export type { AuthOptions, SignInOptions, TokenSet } from "./auth.js";

package/dist/index.js

@@ -39,7 +39,6 @@ import {
   defaultAgents,
   defineCommand,
   deleteSession,
-  detectAgents,
   devExamplesDir,
   dispatch,
   ensureEnvIgnored,
@@ -86,7 +85,7 @@ import {
   writeEnvKey,
   writeSession,
   writeVscodeSetup
-} from "./chunk-34XSPT6F.js";
+} from "./chunk-GUYF4NM5.js";
 import {
   clackPrompter
 } from "./chunk-7IQIRMK6.js";
@@ -109,7 +108,7 @@ async function runSkillInstall(args, opts = {}) {
   if (args.agents !== void 0) {
     agents = parseAgentsFlag(args.agents);
   } else if (!interactive) {
-    prompter.note("non-interactive: pass --agents (claude, cursor, copilot, agents-md \u2014 or all, none)");
+    prompter.note(`non-interactive: pass --agents (${AGENT_IDS.join(", ")} \u2014 or all, none)`);
     return 1;
   } else {
     const choice = await prompter.multiselect(SKILL_AGENTS_QUESTION, AGENT_OPTIONS, defaultAgents(dir));
@@ -125,6 +124,7 @@ async function runSkillInstall(args, opts = {}) {
   }
   const result = await writeAgentSkills(dir, agents, { force: args.force });
   for (const note of result.skipped) prompter.note(note);
+  if (result.removed.length > 0) prompter.note(`Removed superseded: ${result.removed.join(", ")}`);
   let message = "Nothing new to write.";
   if (result.wrote.length > 0) message = `Installed agent skill files: ${result.wrote.join(", ")}`;
   else if (result.stale) message = "Nothing written \u2014 re-run with --force to replace outdated files.";
@@ -173,7 +173,6 @@ export {
   defaultAgents,
   defineCommand,
   deleteSession,
-  detectAgents,
   devExamplesDir,
   dispatch,
   ensureEnvIgnored,

package/dist/main.js

@@ -3,7 +3,7 @@ import {
   CREATE_COMMAND,
   dispatch,
   ownVersion
-} from "./chunk-34XSPT6F.js";
+} from "./chunk-GUYF4NM5.js";
 import "./chunk-FPS2V3S4.js";
 
 // src/main.ts

package/dist/skill-install.js

@@ -1,4 +1,4 @@
-import { AGENT_OPTIONS, defaultAgents, parseAgentsFlag, SKILL_AGENTS_QUESTION, writeAgentSkills } from "./agents.js";
+import { AGENT_IDS, AGENT_OPTIONS, defaultAgents, parseAgentsFlag, SKILL_AGENTS_QUESTION, writeAgentSkills, } from "./agents.js";
 import { plainPrompter } from "./flow.js";
 /** The `nola skill install` entry — same delegation shape as `nola init` → runFlow. */
 export async function runSkillInstall(args, opts = {}) {
@@ -19,7 +19,7 @@ export async function runSkillInstall(args, opts = {}) {
         agents = parseAgentsFlag(args.agents);
     }
     else if (!interactive) {
-        prompter.note("non-interactive: pass --agents (claude, cursor, copilot, agents-md — or all, none)");
+        prompter.note(`non-interactive: pass --agents (${AGENT_IDS.join(", ")} — or all, none)`);
         return 1;
     }
     else {
@@ -37,6 +37,8 @@ export async function runSkillInstall(args, opts = {}) {
     const result = await writeAgentSkills(dir, agents, { force: args.force });
     for (const note of result.skipped)
         prompter.note(note);
+    if (result.removed.length > 0)
+        prompter.note(`Removed superseded: ${result.removed.join(", ")}`);
     let message = "Nothing new to write.";
     if (result.wrote.length > 0)
         message = `Installed agent skill files: ${result.wrote.join(", ")}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nola-lang",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Scaffold a new Nola project (npm create nola, or npm create nola-lang)",
   "keywords": [
     "nola",
@@ -38,6 +38,7 @@
   "files": [
     "dist",
     "!dist/.tsbuildinfo",
+    "!dist/**/*.map",
     "templates",
     "skills"
   ],

package/skills/nola/SKILL.md

@@ -61,9 +61,25 @@ infer function extractPerson(.text: string) {
   `import { f } from "./x.tsi"`. Imports of plain TS use NodeNext style:
   `import { g } from "./y.js"` (the `.js` extension, even though the source
   file is `.ts`).
-- An extractor's `<T>` should be a named, structurally simple type
-  (object/array/primitive fields). `Date` works (revived to a real `Date`);
-  `Map`/`Set` and other ambient lib types do not.
+- Every `export type` / `export interface` in a `.tsi` is ALSO a runtime
+  value (`User.toJsonSchema()`, `User.validate(v)`, `User.parse(v)`,
+  `User["~standard"]` — Standard Schema AND Standard JSON Schema, so
+  `jsonSchema.input({ target: "openapi-3.0" })` works). Never declare a
+  `const`/`function`/`class`/`enum`
+  with an exported type's name (NOLA2011). `./x.tsi` with no `x.tsi` on disk
+  is the VIEW of `x.ts`: the same module plus those values — import plain-TS
+  types that way when you need their schema. Keep one basename per module.
+- An extractor's `<T>` should be a named, JSON-shaped type. The schema comes
+  from the RESOLVED type, so unions (a `kind` key makes them discriminated),
+  `Partial<T>`, `extends`, `Record<string, T>` and types from packages all
+  work; `Date` is revived to a real `Date`. `Map`/`Set`/`Promise`, functions
+  and a generic used without arguments do not derive. A failed reply is
+  corrected with EVERY validation issue at once.
+- Constrain a member with JSDoc tags named like JSON Schema keywords —
+  `/** @format email */`, `/** @integer @minimum 13 */`, `/** @minItems 1 */`,
+  `@pattern`, `@minLength`, `@uniqueItems`, … — the model sees them and
+  `validate` enforces them. A tag on the wrong kind of type is NOLA2012.
+  See `references/syntax.md` → "Types as values".
 - Raw extract/call intents are resolved with `ask`, never bare `await`
   (that throws NOLA3010). Infer-function RETURN values may be awaited.