create-nola-lang 0.1.7 → 0.1.9

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-KCGD4VJM.js}

@@ -151,7 +151,13 @@ var TEMPLATES = [
   { name: "extract-invoice", label: "same-file type references, optional fields", source: "example" },
   { name: "classify-message", label: "closed label sets: union alias, string enum, inline union", source: "example" },
   { name: "chain-of-thought", label: "two asks sharing accumulating context", source: "example" },
-  { name: "research-notes", label: "TS control flow orchestrating nola functions", source: "example" }
+  { name: "research-notes", label: "TS control flow orchestrating nola functions", source: "example" },
+  {
+    name: "triage-ticket",
+    label: "ticket triage: literal unions and booleans as typed questions; no provider question",
+    source: "example",
+    provider: { label: "typesafe.ai", envVar: "TYPESAFE_API_KEY" }
+  }
 ];
 function templateByName(name) {
   return TEMPLATES.find((t) => t.name === name);
@@ -345,20 +351,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 +384,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 +395,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 +426,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 +445,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
@@ -1483,7 +1471,8 @@ var EDITOR_OPTIONS = [
   { value: "vscode", label: "VS Code", hint: ".vscode/ with a debug launch config + extension recommendation" }
 ];
 function templateOption(t) {
-  return { value: t.name, label: t.source === "example" ? `example: ${t.name}` : t.name, hint: t.label };
+  const vendor = t.provider ? ` (${t.provider.label})` : "";
+  return { value: t.name, label: t.source === "example" ? `example: ${t.name}${vendor}` : `${t.name}${vendor}`, hint: t.label };
 }
 async function resolveSetup(input, prompter, dir) {
   const ide = input.ide === "vscode" || input.ide === "none" ? input.ide : void 0;
@@ -1537,10 +1526,10 @@ function flaggedProvider(input) {
   }
   return input.provider;
 }
-async function resolveProvider(input, prompter) {
+async function resolveProvider(input, prompter, pinned = false) {
   const flagged = flaggedProvider(input);
   if (flagged !== void 0) return flagged;
-  if (!input.interactive) return "none";
+  if (pinned || !input.interactive) return "none";
   const path = input.keyPath ?? { kind: "trial" };
   while (true) {
     const choice = await prompter.select(PROVIDER_QUESTION, providerOptions(path));
@@ -1550,8 +1539,8 @@ async function resolveProvider(input, prompter) {
     return choice;
   }
 }
-async function resolveExtras(input, prompter, dir) {
-  const provider = await resolveProvider(input, prompter);
+async function resolveExtras(input, prompter, dir, pinnedProvider = false) {
+  const provider = await resolveProvider(input, prompter, pinnedProvider);
   if (provider === null) return null;
   const setup = await resolveSetup(input, prompter, dir);
   return setup === null ? null : { provider, ...setup };
@@ -1648,7 +1637,7 @@ async function resolveScaffoldOptions(input, prompter) {
       template = choice;
     }
   }
-  const extras = await resolveExtras(input, prompter, dir);
+  const extras = await resolveExtras(input, prompter, dir, templateByName(template)?.provider !== void 0);
   if (extras === null) return { kind: "cancelled" };
   return { kind: "scaffold", dir, template, force, ...extras };
 }
@@ -1697,7 +1686,7 @@ function commented(command, note) {
 }
 function nextSteps(outcome, fileCount, name, pm, installed = false, grant = null) {
   const cmd = packageManagerCommands(pm);
-  const vendorEnv = providerById(outcome.provider)?.envVar;
+  const vendorEnv = providerById(outcome.provider)?.envVar ?? (outcome.provider === "none" ? templateByName(outcome.template)?.provider?.envVar : void 0);
   const startNote = grant ? grant.source === "trial" ? "25 free Nola runs \u2014 key in .env" : "key in .env (run `npx nola-lang account` to check the balance)" : vendorEnv ? `set ${vendorEnv} in .env first` : outcome.template === "empty" ? "set OPENAI_API_KEY first" : "runs offline \u2014 no API key needed";
   const lines = [
     ...outcome.dir === "." ? [] : [`cd ${outcome.dir}`],
@@ -1842,7 +1831,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 +1920,6 @@ export {
   AGENT_IDS,
   SKILL_AGENTS_QUESTION,
   AGENT_OPTIONS,
-  detectAgents,
   defaultAgents,
   parseAgentsFlag,
   writeAgentSkills,

package/dist/flow.js

@@ -46,11 +46,13 @@ const EDITOR_OPTIONS = [
     { value: "vscode", label: "VS Code", hint: ".vscode/ with a debug launch config + extension recommendation" },
 ];
 function templateOption(t) {
-    return { value: t.name, label: t.source === "example" ? `example: ${t.name}` : t.name, hint: t.label };
+    // a pinned template names its vendor in the row itself: `example: triage-ticket (typesafe.ai)`
+    const vendor = t.provider ? ` (${t.provider.label})` : "";
+    return { value: t.name, label: t.source === "example" ? `example: ${t.name}${vendor}` : `${t.name}${vendor}`, hint: t.label };
 }
 /**
  * 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.
@@ -133,11 +135,13 @@ function flaggedProvider(input) {
  * one Enter away, Ctrl+C cancels). The key itself is minted later, on the
  * stored session, after every question — nothing is consumed by a cancel.
  */
-async function resolveProvider(input, prompter) {
+async function resolveProvider(input, prompter, pinned = false) {
     const flagged = flaggedProvider(input);
     if (flagged !== undefined)
         return flagged;
-    if (!input.interactive)
+    // A template whose own config names its vendor (triage-ticket → typesafe())
+    // is not asked: "none" keeps that config, and the outro names its env var.
+    if (pinned || !input.interactive)
         return "none";
     const path = input.keyPath ?? { kind: "trial" };
     while (true) {
@@ -152,8 +156,8 @@ async function resolveProvider(input, prompter) {
     }
 }
 /** The provider and setup (editor + agents) questions, in that order, shared by every outcome site; null = cancelled. */
-async function resolveExtras(input, prompter, dir) {
-    const provider = await resolveProvider(input, prompter);
+async function resolveExtras(input, prompter, dir, pinnedProvider = false) {
+    const provider = await resolveProvider(input, prompter, pinnedProvider);
     if (provider === null)
         return null;
     const setup = await resolveSetup(input, prompter, dir);
@@ -263,7 +267,7 @@ export async function resolveScaffoldOptions(input, prompter) {
             template = choice;
         }
     }
-    const extras = await resolveExtras(input, prompter, dir);
+    const extras = await resolveExtras(input, prompter, dir, templateByName(template)?.provider !== undefined);
     if (extras === null)
         return { kind: "cancelled" };
     return { kind: "scaffold", dir, template, force, ...extras };
@@ -320,7 +324,9 @@ function commented(command, note) {
 }
 function nextSteps(outcome, fileCount, name, pm, installed = false, grant = null) {
     const cmd = packageManagerCommands(pm);
-    const vendorEnv = providerById(outcome.provider)?.envVar;
+    // a chosen vendor's env var, else the one the template's own config reads (a pinned template under "none")
+    const vendorEnv = providerById(outcome.provider)?.envVar ??
+        (outcome.provider === "none" ? templateByName(outcome.template)?.provider?.envVar : undefined);
     const startNote = grant
         ? grant.source === "trial"
             ? "25 free Nola runs — key in .env"
@@ -518,7 +524,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";