@pantoken/scaffold 1.2.1 → 1.3.0

package/dist/cli.d.mts

@@ -1,4 +1,4 @@
-import { a as resolveScaffoldPlatform, c as ThemeVariant, i as isScaffoldPlatform, n as ScaffoldPackageManager, o as scaffoldProject, s as ThemeMode, t as SCAFFOLD_PLATFORMS } from "./index-BloHpRKt.mjs";
+import { a as resolveScaffoldPlatform, d as ThemeMode, f as ThemeVariant, i as isScaffoldPlatform, l as installAgentAssets, n as ScaffoldPackageManager, o as scaffoldProject, t as SCAFFOLD_PLATFORMS } from "./index-rJolJRZa.mjs";
 import { Command } from "commander";
 //#region src/locale.d.ts
 /** Every locale tag pantoken supports, as `--lang` accepts them. */
@@ -87,6 +87,19 @@ export interface ResolveScaffoldTargetOptions {
   isTTY?: boolean;
   t: LocaleLookup["t"];
 }
+/**
+ * Resolves whether to install AI agent assets alongside the scaffold: `--no-ai` always wins
+ * (returns false); otherwise defaults to `true`, prompting via clack `confirm()` on a TTY (not
+ * --yes) to let the user opt out interactively.
+ *
+ * @throws ScaffoldCliError when the prompt is cancelled
+ */
+export declare function resolveAiAssets(opts: {
+  yes?: boolean;
+  isTTY: boolean;
+  noAi?: boolean;
+  t: LocaleLookup["t"];
+}): Promise<boolean>;
 /**
  * Resolves platform + directory: prompts via clack select()/text() when omitted on a TTY
  * (not --yes); throws ScaffoldCliError with a clear, localized message when a required
@@ -140,6 +153,10 @@ export declare function detectPackageManager(env?: NodeJS.ProcessEnv, execPath?:
 export declare function buildCreateUsageCommand(pm?: PackageManager): string;
 /**
  * Runs the detected package manager's install command in `dir`, wrapped in a clack spinner.
+ * Runs via async `spawn` (not `execFileSync`) so the spinner can actually animate while installing
+ * — a synchronous child process blocks the event loop and freezes the spinner's frames, making the
+ * CLI look hung even though it's working. Output is still suppressed (`stdio: "ignore"`); only the
+ * spinner's own text animates, updated periodically with the elapsed time.
  * Failures are reported but non-fatal — the project is still usable, just not installed — so the
  * caller decides how `printNextSteps` should reflect the outcome via the returned boolean.
  *
@@ -148,7 +165,7 @@ export declare function buildCreateUsageCommand(pm?: PackageManager): string;
  * @param t - Localized string lookup
  * @returns Whether the install command exited successfully
  */
-export declare function installWithSpinner(dir: string, pm: PackageManager | undefined, t: LocaleLookup["t"]): boolean;
+export declare function installWithSpinner(dir: string, pm: PackageManager | undefined, t: LocaleLookup["t"]): Promise<boolean>;
 /**
  * Prints the post-scaffold "Next steps" block (plus any template-authored notes/caveats).
  *
@@ -209,4 +226,4 @@ export declare function runScaffoldCli(argv: string[], options: {
   version?: string;
 }): Promise<void>;
 //#endregion
-export { type LocaleLookup, SCAFFOLD_PLATFORMS, isScaffoldPlatform, resolveScaffoldPlatform, scaffoldProject };
+export { type LocaleLookup, SCAFFOLD_PLATFORMS, installAgentAssets, isScaffoldPlatform, resolveScaffoldPlatform, scaffoldProject };

package/dist/cli.mjs

@@ -1,17 +1,18 @@
-import { c as SUPPORTED_LOCALES, d as validateLocaleTag, i as scaffoldProject, l as createLocaleLookup, n as isScaffoldPlatform, o as validateThemeMode, r as resolveScaffoldPlatform, s as validateThemeVariant, t as SCAFFOLD_PLATFORMS, u as detectLocale } from "./src-BTDVd_Xe.mjs";
+import { d as SUPPORTED_LOCALES, f as createLocaleLookup, i as scaffoldProject, l as validateThemeMode, m as validateLocaleTag, n as isScaffoldPlatform, o as installAgentAssets, p as detectLocale, r as resolveScaffoldPlatform, t as SCAFFOLD_PLATFORMS, u as validateThemeVariant } from "./src-diIfZCKN.mjs";
 import { readFileSync } from "node:fs";
 import { basename, join } from "node:path";
 import { Argument, Command, CommanderError, InvalidArgumentError } from "commander";
-import { cancel, isCancel, select, spinner, text } from "@clack/prompts";
+import { cancel, confirm, isCancel, select, spinner, text } from "@clack/prompts";
 import tab from "@bomb.sh/tab/commander";
 import { homedir } from "node:os";
-import { execFileSync } from "node:child_process";
+import { spawn } from "node:child_process";
 //#endregion
 //#region generated/locales/index.ts
 const MESSAGES = {
 	"ar": {
 		"promptPlatform": "اختر منصة للإنشاء:",
 		"promptDir": "الدليل الهدف:",
+		"promptAiAssets": "إضافة أصول وكيل الذكاء الاصطناعي (AGENTS.md، قواعد المحرر/Copilot)؟",
 		"spinnerStart": "جارٍ الإنشاء...",
 		"spinnerStop": "اكتمل الإنشاء.",
 		"wroteFile": "✓ {{path}}",
@@ -30,6 +31,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "المنصة التي سيتم إنشاؤها ({{platforms}}؛ \"html\" مرادف لـ \"components\"، \"theme-editor\" مرادف لـ \"canvas-theme-editor\")",
 		"helpDirDescription": "الدليل الهدف (يُطلب تفاعليًا في TTY إذا تُرك فارغًا)",
 		"helpYesDescription": "عدم المطالبة إطلاقًا؛ عرض خطأ بدل المطالبة عند فقدان المنصة/الدليل",
+		"helpNoAiDescription": "تخطي تثبيت أصول وكيل الذكاء الاصطناعي بعد الإنشاء",
 		"helpLangDescription": "تجاوز لغة العرض المكتشفة تلقائيًا (مثال: \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -70,6 +72,7 @@ const MESSAGES = {
 	"hy": {
 		"promptPlatform": "Ընտրեք պատշաճ պլատֆորմը՝ սկաֆոլդինգի համար:",
 		"promptDir": "Նշանակված թղթապանակը:",
+		"promptAiAssets": "Ավելացնե՞լ AI գործակալների ռեսուրսները (AGENTS.md, editor/Copilot rules)?",
 		"spinnerStart": "Սկսվում է սկաֆոլդինգը...",
 		"spinnerStop": "Սկաֆոլդինգը ավարտվեց.",
 		"wroteFile": "✓ {{path}}",
@@ -88,6 +91,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Սկաֆոլդեցվող պլատֆորմը ({{platforms}}; \"html\"-ը հոմանիշ է \"components\"-ին, \"theme-editor\"-ը հոմանիշ է \"canvas-theme-editor\"-ին)",
 		"helpDirDescription": "Նշված թղթապանակը (TTY-ի դեպքում եթե չի տրվել՝ հարցում կլինի ինտերակտիվ կերպով)",
 		"helpYesDescription": "Չորեքչայլ հարցում; սխալ վերադարձնել՝ հանելով մեկին պակասող platform/dir-ի դեպքում",
+		"helpNoAiDescription": "Բաց թողնել AI գործակալների ռեսուրսների տեղադրումը scaffolding-ից հետո",
 		"helpLangDescription": "Գոյացնող լեզուն ցասքել (օր., \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -128,6 +132,7 @@ const MESSAGES = {
 	"ca": {
 		"promptPlatform": "Selecciona una plataforma per fer scaffold:",
 		"promptDir": "Directori de destinació:",
+		"promptAiAssets": "Afegir actius d'agents d'IA (AGENTS.md, regles de l'editor/Copilot)?",
 		"spinnerStart": "Creant l'esquelet...",
 		"spinnerStop": "Esquelet creat.",
 		"wroteFile": "✓ {{path}}",
@@ -146,6 +151,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Plataforma per fer scaffold ({{platforms}}; \"html\" és un àlies de \"components\", \"theme-editor\" és un àlies de \"canvas-theme-editor\")",
 		"helpDirDescription": "Directori de destinació (demana interactivament en una TTY si s'omet)",
 		"helpYesDescription": "No demanar mai; en cas de falta de platform/directori, mostrar error en lloc de demanar",
+		"helpNoAiDescription": "Ometre la instal·lació d'actius d'agents d'IA després de l'estructuració",
 		"helpLangDescription": "Anul·la l'idioma de visualització autodetectat (p. ex. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -186,6 +192,7 @@ const MESSAGES = {
 	"da": {
 		"promptPlatform": "Vælg en platform til scaffolding:",
 		"promptDir": "Målmappe:",
+		"promptAiAssets": "Tilføj AI-agent-aktiver (AGENTS.md, editor/Copilot-regler)?",
 		"spinnerStart": "Scaffolding...",
 		"spinnerStop": "Færdig med scaffolding.",
 		"wroteFile": "✓ {{path}}",
@@ -204,6 +211,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Platform til scaffolding ({{platforms}}; \"html\" er et alias for \"components\", \"theme-editor\" er et alias for \"canvas-theme-editor\")",
 		"helpDirDescription": "Målmappe (spørger interaktivt i en TTY, hvis udeladt)",
 		"helpYesDescription": "Spørg aldrig; fejl i stedet for at spørge om manglende platform/mappe",
+		"helpNoAiDescription": "Spring installation af AI-agent-aktiver over efter scaffolding",
 		"helpLangDescription": "Overskriv den autodetekterede visningssprog (f.eks. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -244,6 +252,7 @@ const MESSAGES = {
 	"nl": {
 		"promptPlatform": "Selecteer een platform om te scaffolden:",
 		"promptDir": "Doeldirectory:",
+		"promptAiAssets": "AI-agentassets toevoegen (AGENTS.md, editor/Copilot-regels)?",
 		"spinnerStart": "Scaffolding...",
 		"spinnerStop": "Klaar met scaffolden.",
 		"wroteFile": "✓ {{path}}",
@@ -262,6 +271,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Platform om te scaffolden ({{platforms}}; \"html\" is een alias voor \"components\", \"theme-editor\" is een alias voor \"canvas-theme-editor\")",
 		"helpDirDescription": "Doeldirectory (vraagt interactief op een TTY als dit wordt weggelaten)",
 		"helpYesDescription": "Nooit vragen; geef een fout in plaats van te vragen bij ontbrekend platform/directory",
+		"helpNoAiDescription": "Installatie van AI-agentassets overslaan na scaffolding",
 		"helpLangDescription": "Overschrijf de automatisch gedetecteerde weergavetaal (bijv. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -302,6 +312,7 @@ const MESSAGES = {
 	"en-AU": {
 		"promptPlatform": "Select a platform to scaffold:",
 		"promptDir": "Target directory:",
+		"promptAiAssets": "Add AI agent assets (AGENTS.md, editor/Copilot rules)?",
 		"spinnerStart": "Scaffolding...",
 		"spinnerStop": "Done scaffolding.",
 		"wroteFile": "✓ {{path}}",
@@ -320,6 +331,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Platform to scaffold ({{platforms}}; \"html\" is an alias for \"components\", \"theme-editor\" is an alias for \"canvas-theme-editor\")",
 		"helpDirDescription": "Target directory (prompts interactively on a TTY if omitted)",
 		"helpYesDescription": "Never prompt; error instead of prompting for a missing platform/directory",
+		"helpNoAiDescription": "Skip installing AI agent assets after scaffolding",
 		"helpLangDescription": "Override the auto-detected display language (e.g. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -360,6 +372,7 @@ const MESSAGES = {
 	"en-CA": {
 		"promptPlatform": "Select a platform to scaffold:",
 		"promptDir": "Target directory:",
+		"promptAiAssets": "Add AI agent assets (AGENTS.md, editor/Copilot rules)?",
 		"spinnerStart": "Scaffolding...",
 		"spinnerStop": "Done scaffolding.",
 		"wroteFile": "✓ {{path}}",
@@ -378,6 +391,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Platform to scaffold ({{platforms}}; \"html\" is an alias for \"components\", \"theme-editor\" is an alias for \"canvas-theme-editor\")",
 		"helpDirDescription": "Target directory (prompts interactively on a TTY if omitted)",
 		"helpYesDescription": "Never prompt; error instead of prompting for a missing platform/directory",
+		"helpNoAiDescription": "Skip installing AI agent assets after scaffolding",
 		"helpLangDescription": "Override the auto-detected display language (e.g. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -418,6 +432,7 @@ const MESSAGES = {
 	"en-GB": {
 		"promptPlatform": "Select a platform to scaffold:",
 		"promptDir": "Target directory:",
+		"promptAiAssets": "Add AI agent assets (AGENTS.md, editor/Copilot rules)?",
 		"spinnerStart": "Scaffolding...",
 		"spinnerStop": "Done scaffolding.",
 		"wroteFile": "✓ {{path}}",
@@ -436,6 +451,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Platform to scaffold ({{platforms}}; \"html\" is an alias for \"components\", \"theme-editor\" is an alias for \"canvas-theme-editor\")",
 		"helpDirDescription": "Target directory (prompts interactively on a TTY if omitted)",
 		"helpYesDescription": "Never prompt; error instead of prompting for a missing platform/directory",
+		"helpNoAiDescription": "Skip installing AI agent assets after scaffolding",
 		"helpLangDescription": "Override the auto-detected display language (e.g. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -476,6 +492,7 @@ const MESSAGES = {
 	"en": {
 		"promptPlatform": "Select a platform to scaffold:",
 		"promptDir": "Target directory:",
+		"promptAiAssets": "Add AI agent assets (AGENTS.md, editor/Copilot rules)?",
 		"spinnerStart": "Scaffolding...",
 		"spinnerStop": "Done scaffolding.",
 		"wroteFile": "✓ {{path}}",
@@ -494,6 +511,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Platform to scaffold ({{platforms}}; \"html\" is an alias for \"components\", \"theme-editor\" is an alias for \"canvas-theme-editor\")",
 		"helpDirDescription": "Target directory (prompts interactively on a TTY if omitted)",
 		"helpYesDescription": "Never prompt; error instead of prompting for a missing platform/directory",
+		"helpNoAiDescription": "Skip installing AI agent assets after scaffolding",
 		"helpLangDescription": "Override the auto-detected display language (e.g. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -534,6 +552,7 @@ const MESSAGES = {
 	"fi": {
 		"promptPlatform": "Valitse alusta scaffoldattavaksi:",
 		"promptDir": "Kohdekansio:",
+		"promptAiAssets": "Lisätäänkö AI-agenttien aineistot (AGENTS.md, editorin/Copilot-säännöt)?",
 		"spinnerStart": "Scaffoldataan...",
 		"spinnerStop": "Scaffoldaus valmis.",
 		"wroteFile": "✓ {{path}}",
@@ -552,6 +571,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Scaffoldattava alusta ({{platforms}}; \"html\" on alias \"components\"-vaihtoehdolle, \"theme-editor\" on alias \"canvas-theme-editor\"-vaihtoehdolle)",
 		"helpDirDescription": "Kohdekansio (kysytään interaktiivisesti TTY:ssä, jos jätetty pois)",
 		"helpYesDescription": "Älä koskaan kysy; virhe, jos puuttuva platform- tai directory-argumentti",
+		"helpNoAiDescription": "Ohita AI-agenttien aineistojen asentaminen scaffoldingin jälkeen",
 		"helpLangDescription": "Ylikirjoita automaattisesti tunnistettu näyttökieli (esim. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -592,6 +612,7 @@ const MESSAGES = {
 	"fr": {
 		"promptPlatform": "Sélectionnez une plateforme à générer :",
 		"promptDir": "Répertoire cible :",
+		"promptAiAssets": "Ajouter des ressources d'agent IA (AGENTS.md, règles de l'éditeur/Copilot)?",
 		"spinnerStart": "Génération en cours…",
 		"spinnerStop": "Génération terminée.",
 		"wroteFile": "✓ {{path}}",
@@ -610,6 +631,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Plateforme à générer ({{platforms}} ; \"html\" est un alias pour \"components\", \"theme-editor\" est un alias pour \"canvas-theme-editor\")",
 		"helpDirDescription": "Répertoire cible (invite interactive sur un TTY si omis)",
 		"helpYesDescription": "Ne jamais demander ; échoue plutôt que de demander une plateforme/répertoire manquant",
+		"helpNoAiDescription": "Ignorer l'installation des ressources d'agent IA après le scaffolding",
 		"helpLangDescription": "Remplacer la langue d'affichage détectée automatiquement (ex. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -650,6 +672,7 @@ const MESSAGES = {
 	"fr-CA": {
 		"promptPlatform": "Sélectionnez une plateforme à générer :",
 		"promptDir": "Répertoire cible :",
+		"promptAiAssets": "Ajouter des ressources d'agent IA (AGENTS.md, règles de l'éditeur/Copilot)?",
 		"spinnerStart": "Génération en cours…",
 		"spinnerStop": "Génération terminée.",
 		"wroteFile": "✓ {{path}}",
@@ -668,6 +691,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Plateforme à générer ({{platforms}} ; \"html\" est un alias pour \"components\", \"theme-editor\" est un alias pour \"canvas-theme-editor\")",
 		"helpDirDescription": "Répertoire cible (invite interactive en TTY si omis)",
 		"helpYesDescription": "Ne jamais demander ; échouer au lieu de demander une plateforme ou un répertoire manquant",
+		"helpNoAiDescription": "Ne pas installer les ressources d'agent IA après le scaffolding",
 		"helpLangDescription": "Remplacer la langue d'affichage détectée automatiquement (p. ex. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -708,6 +732,7 @@ const MESSAGES = {
 	"ga": {
 		"promptPlatform": "Roghnaigh ardán le haghaidh sliocht:",
 		"promptDir": "Eolaire sprioc:",
+		"promptAiAssets": "An gcuirtear sócmhainní gníomhaire AI (AGENTS.md, rialacha eagarthóra/Copilot)?",
 		"spinnerStart": "Ag sliochtú...",
 		"spinnerStop": "Sliocht críochnaithe.",
 		"wroteFile": "✓ {{path}}",
@@ -726,6 +751,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Ardán le sliochtú ({{platforms}}; \"html\" is ina leasainm do \"components\", \"theme-editor\" is ina leasainm do \"canvas-theme-editor\")",
 		"helpDirDescription": "Eolaire sprioc (féachfaidh sé go idirghníomhach ar TTY más ann a fhágtar é)",
 		"helpYesDescription": "Ná cuir ceist riamh; earráid seachas ceist a chur maidir le hardán/eolaire ar iarraidh",
+		"helpNoAiDescription": "Ná suiteáil sócmhainní gníomhaire AI tar éis an scafalaithe",
 		"helpLangDescription": "Sárshocrú teanga taispeána (mar shampla \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -766,6 +792,7 @@ const MESSAGES = {
 	"de": {
 		"promptPlatform": "Plattform zum Scaffolden auswählen:",
 		"promptDir": "Zielverzeichnis:",
+		"promptAiAssets": "AI-Agent-Assets hinzufügen (AGENTS.md, editor/Copilot rules)?",
 		"spinnerStart": "Scaffolding…",
 		"spinnerStop": "Scaffolding abgeschlossen.",
 		"wroteFile": "✓ {{path}}",
@@ -784,6 +811,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Zu scaffoldende Plattform ({{platforms}}; \"html\" ist ein Alias für \"components\", \"theme-editor\" ist ein Alias für \"canvas-theme-editor\")",
 		"helpDirDescription": "Zielverzeichnis (interaktiv per TTY, falls weggelassen)",
 		"helpYesDescription": "Nie nachfragen; bei fehlender Plattform/Verzeichnis stattdessen Fehler ausgeben",
+		"helpNoAiDescription": "Installation der AI-Agent-Assets nach dem Scaffolding überspringen",
 		"helpLangDescription": "Die automatisch erkannte Anzeigesprache überschreiben (z. B. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -824,6 +852,7 @@ const MESSAGES = {
 	"el": {
 		"promptPlatform": "Επιλέξτε πλατφόρμα για δημιουργία σκαλετού:",
 		"promptDir": "Στόχος κατάλογος:",
+		"promptAiAssets": "Προσθήκη πόρων πράκτορα AI (AGENTS.md, κανόνες editor/Copilot)?",
 		"spinnerStart": "Δημιουργία σκαλετού...",
 		"spinnerStop": "Η δημιουργία σκαλετού ολοκληρώθηκε.",
 		"wroteFile": "✓ {{path}}",
@@ -842,6 +871,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Πλατφόρμα για δημιουργία σκαλετού ({{platforms}}; \"html\" είναι συνώνυμο για \"components\", \"theme-editor\" είναι συνώνυμο για \"canvas-theme-editor\")",
 		"helpDirDescription": "Στόχος κατάλογος (ζητείται διαδραστικά σε TTY εάν παραλειφθεί)",
 		"helpYesDescription": "Μην ζητάτε ποτέ εισαγωγή· σφάλμα αντί για ερώτηση για λείποντα πλατφόρμα/κατάλογο",
+		"helpNoAiDescription": "Παράλειψη εγκατάστασης πόρων πράκτορα AI μετά τη δημιουργία του σκελετού",
 		"helpLangDescription": "Παράκαμψη της αυτόματης ανίχνευσης της γλώσσας εμφάνισης (π.χ. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -882,6 +912,7 @@ const MESSAGES = {
 	"ht": {
 		"promptPlatform": "Chwazi yon platfòm pou kreye scaffold:",
 		"promptDir": "Katab sib:",
+		"promptAiAssets": "Ajoute resous ajan AI (AGENTS.md, règleman editè/Copilot)?",
 		"spinnerStart": "Ap kreye scaffold...",
 		"spinnerStop": "Fini kreye scaffold.",
 		"wroteFile": "✓ {{path}}",
@@ -900,6 +931,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Platfòm pou kreye scaffold ({{platforms}}; \"html\" se yon alias pou \"components\", \"theme-editor\" se yon alias pou \"canvas-theme-editor\")",
 		"helpDirDescription": "Katab sib (p ap mande si kouri entèaktifman sou yon TTY si yo pa bay li)",
 		"helpYesDescription": "Pa janm mande; jete erè olye pou mande lè platfòm/katab manke",
+		"helpNoAiDescription": "Sote enstale resous ajan AI apre scaffolding",
 		"helpLangDescription": "Sispann deteksyon otomatik lang afichaj la (egzanp \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -940,6 +972,7 @@ const MESSAGES = {
 	"he": {
 		"promptPlatform": "בחר פלטפורמה ליצירת scaffold:",
 		"promptDir": "תיקיית יעד:",
+		"promptAiAssets": "להוסיף נכסי סוכני AI (AGENTS.md, כללי העורך/Copilot)?",
 		"spinnerStart": "יוצר scaffold…",
 		"spinnerStop": "סיום יצירת scaffold.",
 		"wroteFile": "✓ {{path}}",
@@ -958,6 +991,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "פלטפורמה ליצירת scaffold ({{platforms}}; \"html\" הוא כינוי ל־\"components\", \"theme-editor\" הוא כינוי ל־\"canvas-theme-editor\")",
 		"helpDirDescription": "תיקיית יעד (יבקש אינטראקטיבית ב‑TTY אם לא צוינה)",
 		"helpYesDescription": "אל תבקש אישור; במקום זאת להחזיר שגיאה אם חסרה פלטפורמה/תיקייה",
+		"helpNoAiDescription": "דלג על התקנת נכסי סוכני AI לאחר יצירת התשתית",
 		"helpLangDescription": "עקוף את זיהוי שפת התצוגה אוטומטית (למשל \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -998,6 +1032,7 @@ const MESSAGES = {
 	"hi": {
 		"promptPlatform": "स्कैफ़ोल्ड करने के लिए प्लेटफ़ॉर्म चुनें:",
 		"promptDir": "लक्ष्य निर्देशिका:",
+		"promptAiAssets": "AI एजेंट संपत्ति जोड़ें (AGENTS.md, editor/Copilot rules)?",
 		"spinnerStart": "स्कैफ़ोल्ड किया जा रहा है...",
 		"spinnerStop": "स्कैफ़ोल्डिंग पूर्ण।",
 		"wroteFile": "✓ {{path}}",
@@ -1016,6 +1051,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "स्कैफ़ोल्ड करने के लिए प्लेटफ़ॉर्म ({{platforms}}; \"html\" का पर्याय \"components\" है, \"theme-editor\" का पर्याय \"canvas-theme-editor\" है)",
 		"helpDirDescription": "लक्ष्य निर्देशिका (TTY पर छोड़ा गया तो इंटरैक्टिव रूप से पूछा जाएगा)",
 		"helpYesDescription": "कभी भी संकेत नहीं पूछें; अनुपस्थित प्लेटफ़ॉर्म/निर्देशिका के लिए पूछने की बजाय त्रुटि करें",
+		"helpNoAiDescription": "स्कैफोल्डिंग के बाद AI एजेंट संपत्तियाँ स्थापित करना छोड़ें",
 		"helpLangDescription": "स्वचालित–पहचानी गई डिस्प्ले भाषा को ओवरराइड करें (उदा. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1056,6 +1092,7 @@ const MESSAGES = {
 	"hu": {
 		"promptPlatform": "Válassz platformot a scaffoldinghez:",
 		"promptDir": "Célkönyvtár:",
+		"promptAiAssets": "AI ügynök eszközök hozzáadása (AGENTS.md, editor/Copilot szabályok)?",
 		"spinnerStart": "Scaffoldolás...",
 		"spinnerStop": "Scaffold kész.",
 		"wroteFile": "✓ {{path}}",
@@ -1074,6 +1111,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Scaffoldolandó platform ({{platforms}}; \"html\" a \"components\" aliasza, a \"theme-editor\" a \"canvas-theme-editor\" aliasza)",
 		"helpDirDescription": "Célkönyvtár (TTY esetén interaktívan kérdez, ha kimarad)",
 		"helpYesDescription": "Soha ne kérdezzen; hibázzon, ahelyett hogy egy hiányzó platform/könyvtár miatt promptolna",
+		"helpNoAiDescription": "Az AI ügynök eszközök telepítésének kihagyása a sablon létrehozása után",
 		"helpLangDescription": "Felülírja az automatikusan észlelt megjelenítési nyelvet (pl. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1114,6 +1152,7 @@ const MESSAGES = {
 	"is": {
 		"promptPlatform": "Veldu vettvang til að búa til grunn:",
 		"promptDir": "Áfangaskrá:",
+		"promptAiAssets": "Bæta við AI-agent-eignum (AGENTS.md, editor/Copilot reglur)?",
 		"spinnerStart": "Búsetning...",
 		"spinnerStop": "Lokið við að búa til grunninn.",
 		"wroteFile": "✓ {{path}}",
@@ -1132,6 +1171,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Vettvangur til að búa til ({{platforms}}; \"html\" er samskeyti fyrir \"components\", \"theme-editor\" er samskeyti fyrir \"canvas-theme-editor\")",
 		"helpDirDescription": "Áfangaskrá (spyr hvort verið er í TTY ef sleppt)",
 		"helpYesDescription": "Aldrei spyrja; kasta villa í staðinn fyrir að spyrja um vantar vettvang/skrá",
+		"helpNoAiDescription": "Sleppa uppsetningu AI-agent-eigna eftir að sniðmátið hefur verið búið til",
 		"helpLangDescription": "Yfirstýrðu sjálfvirkt greinda sýnismál (t.d. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1172,6 +1212,7 @@ const MESSAGES = {
 	"id": {
 		"promptPlatform": "Pilih platform untuk dibuat:",
 		"promptDir": "Direktori target:",
+		"promptAiAssets": "Tambahkan aset agen AI (AGENTS.md, aturan editor/Copilot)?",
 		"spinnerStart": "Membuat kerangka...",
 		"spinnerStop": "Selesai membuat kerangka.",
 		"wroteFile": "✓ {{path}}",
@@ -1190,6 +1231,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Platform untuk dibuat ({{platforms}}; \"html\" adalah alias untuk \"components\", \"theme-editor\" adalah alias untuk \"canvas-theme-editor\")",
 		"helpDirDescription": "Direktori target (akan diminta secara interaktif pada TTY jika dihilangkan)",
 		"helpYesDescription": "Jangan pernah meminta konfirmasi; keluarkan kesalahan jika platform/direktori hilang",
+		"helpNoAiDescription": "Lewati pemasangan aset agen AI setelah scaffolding",
 		"helpLangDescription": "Timpa bahasa tampilan yang terdeteksi otomatis (mis. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1230,6 +1272,7 @@ const MESSAGES = {
 	"it": {
 		"promptPlatform": "Seleziona una piattaforma da scaffoldare:",
 		"promptDir": "Directory di destinazione:",
+		"promptAiAssets": "Aggiungere asset dell'agente AI (AGENTS.md, regole dell'editor/Copilot)?",
 		"spinnerStart": "Scaffold in corso...",
 		"spinnerStop": "Scaffold completato.",
 		"wroteFile": "✓ {{path}}",
@@ -1248,6 +1291,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Piattaforma da scaffoldare ({{platforms}}; \"html\" è un alias per \"components\", \"theme-editor\" è un alias per \"canvas-theme-editor\")",
 		"helpDirDescription": "Directory di destinazione (se omessa, verrà richiesto in modo interattivo su una TTY)",
 		"helpYesDescription": "Non chiedere mai conferma; genera un errore invece di richiedere la piattaforma/directory mancante",
+		"helpNoAiDescription": "Saltare l'installazione degli asset dell'agente AI dopo lo scaffolding",
 		"helpLangDescription": "Sovrascrivi la lingua di visualizzazione rilevata automaticamente (es. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1288,6 +1332,7 @@ const MESSAGES = {
 	"ja": {
 		"promptPlatform": "スキャフォールドするプラットフォームを選択:",
 		"promptDir": "ターゲットディレクトリ:",
+		"promptAiAssets": "AIエージェントのアセットを追加しますか (AGENTS.md, editor/Copilot rules)?",
 		"spinnerStart": "スキャフォールド中...",
 		"spinnerStop": "スキャフォールド完了。",
 		"wroteFile": "✓ {{path}}",
@@ -1306,6 +1351,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "スキャフォールドするプラットフォーム ({{platforms}}; \"html\" は \"components\" の別名、\"theme-editor\" は \"canvas-theme-editor\" の別名です)",
 		"helpDirDescription": "ターゲットディレクトリ（省略するとTTY上で対話的に尋ねます）",
 		"helpYesDescription": "プロンプトを表示しない（不足する platform/ディレクトリがある場合はプロンプトの代わりにエラーにする）",
+		"helpNoAiDescription": "スキャフォールディング後に AIエージェントのアセットのインストールをスキップする",
 		"helpLangDescription": "自動検出された表示言語を上書き（例: \"hu\"）",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1346,6 +1392,7 @@ const MESSAGES = {
 	"ko": {
 		"promptPlatform": "스캐폴딩할 플랫폼 선택:",
 		"promptDir": "대상 디렉터리:",
+		"promptAiAssets": "AI 에이전트 자산 (AGENTS.md, editor/Copilot 규칙)을 추가하시겠습니까?",
 		"spinnerStart": "스캐폴딩 중...",
 		"spinnerStop": "스캐폴딩 완료.",
 		"wroteFile": "✓ {{path}}",
@@ -1364,6 +1411,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "스캐폴딩할 플랫폼 ({{platforms}}; \"html\"은 \"components\"의 별칭, \"theme-editor\"는 \"canvas-theme-editor\"의 별칭)",
 		"helpDirDescription": "대상 디렉터리 (TTY에서 생략하면 대화형으로 묻습니다)",
 		"helpYesDescription": "절대 프롬프트하지 않음; 플랫폼/디렉터리가 없으면 프롬프트 대신 오류 발생",
+		"helpNoAiDescription": "스캐폴딩 후 AI 에이전트 자산 설치를 건너뛰기",
 		"helpLangDescription": "자동 감지된 표시 언어를 재정의 (예: \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1404,6 +1452,7 @@ const MESSAGES = {
 	"mi": {
 		"promptPlatform": "Tīpakohia he papanga hei hanga:",
 		"promptDir": "Kōpaki ūkaipō (Target):",
+		"promptAiAssets": "Tāpiri i ngā rawa mō ngā ajaneti AI (AGENTS.md, ture etita/Copilot)?",
 		"spinnerStart": "E hanga ana…",
 		"spinnerStop": "Kua oti te hanga.",
 		"wroteFile": "✓ {{path}}",
@@ -1422,6 +1471,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Te papanga hei hanga ({{platforms}}; ko \"html\" he ingoa taurima mō \"components\", ko \"theme-editor\" he ingoa taurima mō \"canvas-theme-editor\")",
 		"helpDirDescription": "Kōpaki ūkaipō (ka uiui ā-āheinga i runga i te TTY mēnā kāore i whakakīa)",
 		"helpYesDescription": "Kāore he pātai; ka hapa ina kore te papanga/kōpaki",
+		"helpNoAiDescription": "Aukatia te tāuta i ngā rawa ajaneti AI i muri i te hanga anga",
 		"helpLangDescription": "Te reo whakaatu hei whakakapi i te tautuhi aunoa (hei tauira \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1462,6 +1512,7 @@ const MESSAGES = {
 	"ms": {
 		"promptPlatform": "Pilih platform untuk discaffold:",
 		"promptDir": "Direktori sasaran:",
+		"promptAiAssets": "Tambah aset ejen AI (AGENTS.md, peraturan editor/Copilot)?",
 		"spinnerStart": "Sedang membuat scaffold...",
 		"spinnerStop": "Selesai membuat scaffold.",
 		"wroteFile": "✓ {{path}}",
@@ -1480,6 +1531,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Platform untuk discaffold ({{platforms}}; \"html\" adalah alias untuk \"components\", \"theme-editor\" adalah alias untuk \"canvas-theme-editor\")",
 		"helpDirDescription": "Direktori sasaran (akan bertanya secara interaktif pada TTY jika ditinggalkan)",
 		"helpYesDescription": "Jangan bertanya; beri ralat jika platform/direktori yang hilang",
+		"helpNoAiDescription": "Langkau pemasangan aset ejen AI selepas scaffolding",
 		"helpLangDescription": "Timpa bahasa paparan yang dikesan automatik (contoh: \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1520,6 +1572,7 @@ const MESSAGES = {
 	"se": {
 		"promptPlatform": "Välj en plattform att skapa scaffold för:",
 		"promptDir": "Målmapp:",
+		"promptAiAssets": "Add AI agent assets (AGENTS.md, editor/Copilot rules)?",
 		"spinnerStart": "Skapar scaffold...",
 		"spinnerStop": "Skapande klart.",
 		"wroteFile": "✓ {{path}}",
@@ -1538,6 +1591,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Plattform att skapa scaffold för ({{platforms}}; \"html\" är en alias för \"components\", \"theme-editor\" är en alias för \"canvas-theme-editor\")",
 		"helpDirDescription": "Målmapp (frågas interaktivt i en TTY om det utelämnas)",
 		"helpYesDescription": "Fråga aldrig; ge ett fel istället för att fråga efter saknad plattform/mapp",
+		"helpNoAiDescription": "Skip installing AI agent assets after scaffolding",
 		"helpLangDescription": "Åsidosätt den autodetekterade visningsspråket (t.ex. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1578,6 +1632,7 @@ const MESSAGES = {
 	"nb": {
 		"promptPlatform": "Velg en plattform som skal scaffoldes:",
 		"promptDir": "Målmappe:",
+		"promptAiAssets": "Legg til AI-agent-ressurser (AGENTS.md, editor/Copilot-regler)?",
 		"spinnerStart": "Scaffolder...",
 		"spinnerStop": "Ferdig med scaffolding.",
 		"wroteFile": "✓ {{path}}",
@@ -1596,6 +1651,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Plattform som skal scaffoldes ({{platforms}}; \"html\" er et alias for \"components\", \"theme-editor\" er et alias for \"canvas-theme-editor\")",
 		"helpDirDescription": "Målmappe (spør interaktivt i en TTY hvis utelatt)",
 		"helpYesDescription": "Ikke spør; gi feil i stedet for å spørre om manglende plattform/mappe",
+		"helpNoAiDescription": "Hopp over å installere AI-agent-ressurser etter oppsett",
 		"helpLangDescription": "Overstyr automatisk oppdaget visningsspråk (f.eks. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1636,6 +1692,7 @@ const MESSAGES = {
 	"nn": {
 		"promptPlatform": "Vel ein plattform å skaffolde:",
 		"promptDir": "Målmappe:",
+		"promptAiAssets": "Legg til AI-agent-ressursar (AGENTS.md, editor/Copilot-reglar)?",
 		"spinnerStart": "Skaffolderar...",
 		"spinnerStop": "Ferdig med skaffolding.",
 		"wroteFile": "✓ {{path}}",
@@ -1654,6 +1711,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Plattform å skaffolde ({{platforms}}; \"html\" er eit alias for \"components\", \"theme-editor\" er eit alias for \"canvas-theme-editor\")",
 		"helpDirDescription": "Målmappe (spør interaktivt i ein TTY viss utelate)",
 		"helpYesDescription": "Aldri spør; gi feil i staden for å spørje om manglande plattform/mappe",
+		"helpNoAiDescription": "Hopp over å installere AI-agent-ressursar etter oppsett",
 		"helpLangDescription": "Overskriv automatisk oppdaga visningsspråk (t.d. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1694,6 +1752,7 @@ const MESSAGES = {
 	"fa": {
 		"promptPlatform": "پلتفرمی برای ساخت اسکافولد انتخاب کنید:",
 		"promptDir": "دایرکتوری هدف:",
+		"promptAiAssets": "افزودن دارایی‌های عامل هوش مصنوعی (AGENTS.md, قوانین ویرایشگر/Copilot)?",
 		"spinnerStart": "در حال ساخت اسکافولد...",
 		"spinnerStop": "ساخت اسکافولد انجام شد.",
 		"wroteFile": "✓ {{path}}",
@@ -1712,6 +1771,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "پلتفرمی برای اسکافولد ({{platforms}}؛ \"html\" معادل \"components\" است، \"theme-editor\" معادل \"canvas-theme-editor\")",
 		"helpDirDescription": "دایرکتوری هدف (در یک TTY در صورت حذف شدن به‌صورت تعاملی پرسیده می‌شود)",
 		"helpYesDescription": "هرگز پرسش نکن؛ در صورت فقدان پلتفرم/دایرکتوری خطا صادر کن",
+		"helpNoAiDescription": "نصب دارایی‌های عامل هوش مصنوعی را پس از اسکافولد رد کن",
 		"helpLangDescription": "زبان نمایش را بازنویسی کن (مثلاً \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1752,6 +1812,7 @@ const MESSAGES = {
 	"pl": {
 		"promptPlatform": "Wybierz platformę do scaffoldingu:",
 		"promptDir": "Katalog docelowy:",
+		"promptAiAssets": "Dodać zasoby agenta AI (AGENTS.md, reguły edytora/Copilot)?",
 		"spinnerStart": "Tworzenie szablonu...",
 		"spinnerStop": "Zakończono tworzenie szablonu.",
 		"wroteFile": "✓ {{path}}",
@@ -1770,6 +1831,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Platforma do scaffoldingu ({{platforms}}; \"html\" to alias dla \"components\", \"theme-editor\" to alias dla \"canvas-theme-editor\")",
 		"helpDirDescription": "Katalog docelowy (jeśli pominiesz, w TTY zostaniesz poproszony interaktywnie)",
 		"helpYesDescription": "Nigdy nie pytać; zamiast tego zgłosić błąd, gdy brakuje platformy/katalogu",
+		"helpNoAiDescription": "Pomiń instalowanie zasobów agenta AI po wygenerowaniu szkieletu",
 		"helpLangDescription": "Zastąp automatycznie wykryty język wyświetlania (np. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1810,6 +1872,7 @@ const MESSAGES = {
 	"pt": {
 		"promptPlatform": "Selecione uma plataforma para scaffold:",
 		"promptDir": "Diretório de destino:",
+		"promptAiAssets": "Adicionar ativos do agente de IA (AGENTS.md, regras do editor/Copilot)?",
 		"spinnerStart": "Scaffold em andamento...",
 		"spinnerStop": "Scaffold concluído.",
 		"wroteFile": "✓ {{path}}",
@@ -1828,6 +1891,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Plataforma para scaffold ({{platforms}}; \"html\" é um alias para \"components\", \"theme-editor\" é um alias para \"canvas-theme-editor\")",
 		"helpDirDescription": "Diretório de destino (pergunta interativa em TTY se omitido)",
 		"helpYesDescription": "Nunca perguntar; gerar erro em vez de solicitar plataforma/diretório ausente",
+		"helpNoAiDescription": "Pular a instalação dos ativos do agente de IA após o scaffolding",
 		"helpLangDescription": "Sobrepor o idioma de exibição detectado automaticamente (ex.: \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1868,6 +1932,7 @@ const MESSAGES = {
 	"pt-BR": {
 		"promptPlatform": "Selecione uma plataforma para scaffolding:",
 		"promptDir": "Diretório alvo:",
+		"promptAiAssets": "Adicionar ativos de agente de IA (AGENTS.md, regras do editor/Copilot)?",
 		"spinnerStart": "Scaffold em andamento...",
 		"spinnerStop": "Scaffold concluído.",
 		"wroteFile": "✓ {{path}}",
@@ -1886,6 +1951,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Plataforma para scaffold ({{platforms}}; \"html\" é um alias para \"components\", \"theme-editor\" é um alias para \"canvas-theme-editor\")",
 		"helpDirDescription": "Diretório alvo (solicita interativamente em um TTY se omitido)",
 		"helpYesDescription": "Nunca perguntar; falhar em vez de solicitar se faltar platform/diretório",
+		"helpNoAiDescription": "Pular a instalação dos ativos do agente de IA após o scaffolding",
 		"helpLangDescription": "Substituir o idioma exibido detectado automaticamente (ex.: \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1926,6 +1992,7 @@ const MESSAGES = {
 	"ru": {
 		"promptPlatform": "Выберите платформу для scaffold:",
 		"promptDir": "Целевая директория:",
+		"promptAiAssets": "Добавить ресурсы AI-агента (AGENTS.md, правила для редактора/Copilot)?",
 		"spinnerStart": "Создаю каркас...",
 		"spinnerStop": "Каркас создан.",
 		"wroteFile": "✓ {{path}}",
@@ -1944,6 +2011,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Платформа для scaffold ({{platforms}}; \"html\" — псевдоним для \"components\", \"theme-editor\" — псевдоним для \"canvas-theme-editor\")",
 		"helpDirDescription": "Целевая директория (если опущено, в интерактивном TTY будет запрошено)",
 		"helpYesDescription": "Никогда не запрашивать; выдать ошибку вместо интерактивного запроса платформы/директории",
+		"helpNoAiDescription": "Пропустить установку ресурсов AI-агента после создания каркаса",
 		"helpLangDescription": "Переопределить автоматически определённый язык интерфейса (например, \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -1984,6 +2052,7 @@ const MESSAGES = {
 	"zh-Hans": {
 		"promptPlatform": "选择要生成的目标平台：",
 		"promptDir": "目标目录：",
+		"promptAiAssets": "添加 AI 代理资产（AGENTS.md、editor/Copilot 规则）？",
 		"spinnerStart": "正在生成脚手架…",
 		"spinnerStop": "脚手架生成完成。",
 		"wroteFile": "✓ {{path}}",
@@ -2002,6 +2071,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "要生成的平台 ({{platforms}}；\"html\" 为 \"components\" 的别名，\"theme-editor\" 为 \"canvas-theme-editor\" 的别名)",
 		"helpDirDescription": "目标目录（若在 TTY 中省略则会交互提示）",
 		"helpYesDescription": "从不提示；若缺少 platform/目录 则报错而不是提示",
+		"helpNoAiDescription": "在脚手架搭建后跳过安装 AI 代理资产",
 		"helpLangDescription": "覆盖自动检测的显示语言（例如：\"hu\"）",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -2042,6 +2112,7 @@ const MESSAGES = {
 	"sl": {
 		"promptPlatform": "Izberite platformo za ogrodje:",
 		"promptDir": "Ciljna mapa:",
+		"promptAiAssets": "Dodati AI agentne vire (AGENTS.md, pravila za urejevalnik/Copilot)?",
 		"spinnerStart": "Ustvarjanje ogrodja...",
 		"spinnerStop": "Ustvarjanje ogrodja končano.",
 		"wroteFile": "✓ {{path}}",
@@ -2060,6 +2131,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Platforma za ogrodje ({{platforms}}; \"html\" je nadomestno ime za \"components\", \"theme-editor\" je nadomestno ime za \"canvas-theme-editor\")",
 		"helpDirDescription": "Ciljna mapa (če ni navedena, se interaktivno vpraša na TTY)",
 		"helpYesDescription": "Nikoli ne pozivaj; pri manjkajoči platformi/mapi sproži napako namesto poziva",
+		"helpNoAiDescription": "Preskoči namestitev AI agentnih virov po scaffoldingu",
 		"helpLangDescription": "Prepišite samodejno zaznan jezik vmesnika (npr. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -2100,6 +2172,7 @@ const MESSAGES = {
 	"es": {
 		"promptPlatform": "Seleccione una plataforma para scaffolding:",
 		"promptDir": "Directorio destino:",
+		"promptAiAssets": "¿Agregar recursos de agente de IA (AGENTS.md, reglas del editor/Copilot)?",
 		"spinnerStart": "Scaffold en progreso...",
 		"spinnerStop": "Scaffold completado.",
 		"wroteFile": "✓ {{path}}",
@@ -2118,6 +2191,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Plataforma para scaffolding ({{platforms}}; \"html\" es un alias de \"components\", \"theme-editor\" es un alias de \"canvas-theme-editor\")",
 		"helpDirDescription": "Directorio destino (si se omite, solicita interactivamente en un TTY)",
 		"helpYesDescription": "Nunca preguntar; mostrar error en lugar de pedir la plataforma/directorio faltante",
+		"helpNoAiDescription": "Omitir la instalación de recursos de agente de IA después de generar el esqueleto",
 		"helpLangDescription": "Sobrescribir el idioma de visualización detectado automáticamente (p. ej. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -2158,6 +2232,7 @@ const MESSAGES = {
 	"sv": {
 		"promptPlatform": "Välj plattform att skapa stommen för:",
 		"promptDir": "Målkatalog:",
+		"promptAiAssets": "Lägga till AI-agentresurser (AGENTS.md, editor/Copilot-regler)?",
 		"spinnerStart": "Skapar stommen...",
 		"spinnerStop": "Stomme skapad.",
 		"wroteFile": "✓ {{path}}",
@@ -2176,6 +2251,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Plattform att skapa stommen för ({{platforms}}; \"html\" är ett alias för \"components\", \"theme-editor\" är ett alias för \"canvas-theme-editor\")",
 		"helpDirDescription": "Målkatalog (frågas interaktivt i en TTY om det utelämnas)",
 		"helpYesDescription": "Fråga aldrig; ge fel i stället för att fråga efter saknad plattform/katalog",
+		"helpNoAiDescription": "Hoppa över installation av AI-agentresurser efter scaffolding",
 		"helpLangDescription": "Åsidosätt den autodetekterade visningsspråket (t.ex. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -2216,6 +2292,7 @@ const MESSAGES = {
 	"th": {
 		"promptPlatform": "เลือกแพลตฟอร์มสำหรับสร้างสเกลโฟลด์:",
 		"promptDir": "ไดเรกทอรีเป้าหมาย:",
+		"promptAiAssets": "เพิ่มไฟล์เอเจนต์ AI (AGENTS.md, กฎ editor/Copilot)?",
 		"spinnerStart": "กำลังสร้างโครงสร้าง...",
 		"spinnerStop": "สร้างโครงสร้างเสร็จแล้ว.",
 		"wroteFile": "✓ {{path}}",
@@ -2234,6 +2311,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "แพลตฟอร์มที่จะสร้างสเกลโฟลด์ ({{platforms}}; \"html\" เป็นนามแฝงของ \"components\", \"theme-editor\" เป็นนามแฝงของ \"canvas-theme-editor\")",
 		"helpDirDescription": "ไดเรกทอรีเป้าหมาย (จะเรียกถามแบบโต้ตอบบน TTY หากละไว้)",
 		"helpYesDescription": "ไม่ถามคำถามใด ๆ; แสดงข้อผิดพลาดแทนการถามเมื่อขาด platform/ไดเรกทอรี",
+		"helpNoAiDescription": "ข้ามการติดตั้งไฟล์เอเจนต์ AI หลังจากการสร้างโครงงาน",
 		"helpLangDescription": "แทนที่การตรวจจับภาษาการแสดงผลอัตโนมัติ (เช่น \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -2274,6 +2352,7 @@ const MESSAGES = {
 	"zh-Hant": {
 		"promptPlatform": "選擇要產生樣板的平台：",
 		"promptDir": "目標目錄：",
+		"promptAiAssets": "新增 AI 代理資產（AGENTS.md、editor/Copilot 規則）？",
 		"spinnerStart": "正在產生樣板…",
 		"spinnerStop": "樣板產生完成。",
 		"wroteFile": "✓ {{path}}",
@@ -2292,6 +2371,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "要產生樣板的平台（{{platforms}}；\"html\" 為 \"components\" 的別名，\"theme-editor\" 為 \"canvas-theme-editor\" 的別名）",
 		"helpDirDescription": "目標目錄（若省略且為 TTY，會以互動方式提示）",
 		"helpYesDescription": "永不提示；若缺少 platform 或目錄則報錯",
+		"helpNoAiDescription": "在腳手架建立後跳過安裝 AI 代理資產",
 		"helpLangDescription": "覆寫自動偵測的顯示語言（例如 \"hu\"）",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -2332,6 +2412,7 @@ const MESSAGES = {
 	"tr": {
 		"promptPlatform": "Bir iskelet (scaffold) platformu seçin:",
 		"promptDir": "Hedef dizin:",
+		"promptAiAssets": "AI ajan varlıkları ekle (AGENTS.md, editor/Copilot kuralları)?",
 		"spinnerStart": "İskelet oluşturuluyor...",
 		"spinnerStop": "İskelet oluşturma tamamlandı.",
 		"wroteFile": "✓ {{path}}",
@@ -2350,6 +2431,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "İskelet oluşturulacak platform ({{platforms}}; \"html\" \"components\" için takma addır, \"theme-editor\" \"canvas-theme-editor\" için takma addır)",
 		"helpDirDescription": "Hedef dizin (TTY'de belirtilmezse etkileşimli olarak sorulur)",
 		"helpYesDescription": "Asla sorulmasın; eksik platform/dizin için sormak yerine hata ver",
+		"helpNoAiDescription": "Scaffolding sonrası AI ajan varlıklarının kurulmasını atla",
 		"helpLangDescription": "Otomatik algılanan görüntüleme dilini geçersiz kıl (ör. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -2390,6 +2472,7 @@ const MESSAGES = {
 	"uk": {
 		"promptPlatform": "Виберіть платформу для створення каркасу:",
 		"promptDir": "Цільова директорія:",
+		"promptAiAssets": "Додати ресурси AI-агента (AGENTS.md, editor/Copilot rules)?",
 		"spinnerStart": "Створення каркасу...",
 		"spinnerStop": "Готово — каркас створено.",
 		"wroteFile": "✓ {{path}}",
@@ -2408,6 +2491,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Платформа для створення каркасу ({{platforms}}; \"html\" — псевдонім для \"components\", \"theme-editor\" — псевдонім для \"canvas-theme-editor\")",
 		"helpDirDescription": "Цільова директорія (якщо пропущено — запит у TTY)",
 		"helpYesDescription": "Ніколи не питати; в разі відсутньої платформи/директорії видавати помилку",
+		"helpNoAiDescription": "Пропустити встановлення ресурсів AI-агента після scaffoldування",
 		"helpLangDescription": "Перевизначити автоматично визначену мову інтерфейсу (наприклад \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -2448,6 +2532,7 @@ const MESSAGES = {
 	"vi": {
 		"promptPlatform": "Chọn nền tảng để khởi tạo:",
 		"promptDir": "Thư mục đích:",
+		"promptAiAssets": "Thêm tài nguyên tác nhân AI (AGENTS.md, quy tắc editor/Copilot)?",
 		"spinnerStart": "Đang khởi tạo...",
 		"spinnerStop": "Hoàn tất khởi tạo.",
 		"wroteFile": "✓ {{path}}",
@@ -2466,6 +2551,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Nền tảng để khởi tạo ({{platforms}}; \"html\" là bí danh của \"components\", \"theme-editor\" là bí danh của \"canvas-theme-editor\")",
 		"helpDirDescription": "Thư mục đích (nếu bỏ qua sẽ hỏi tương tác khi chạy trên TTY)",
 		"helpYesDescription": "Không hỏi; báo lỗi thay vì hỏi khi thiếu platform/thư mục",
+		"helpNoAiDescription": "Bỏ qua cài đặt tài nguyên tác nhân AI sau khi tạo scaffold",
 		"helpLangDescription": "Ghi đè ngôn ngữ hiển thị được tự động phát hiện (ví dụ: \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -2506,6 +2592,7 @@ const MESSAGES = {
 	"cy": {
 		"promptPlatform": "Dewiswch blatfform i'w ffrydio:",
 		"promptDir": "Cyfeiriadur targed:",
+		"promptAiAssets": "Ychwanegu asedau asiant AI (AGENTS.md, rheolau editor/Copilot)?",
 		"spinnerStart": "Yn ffrydio...",
 		"spinnerStop": "Wedi gorffen ffrydio.",
 		"wroteFile": "✓ {{path}}",
@@ -2524,6 +2611,7 @@ const MESSAGES = {
 		"helpPlatformDescription": "Platfform i'w ffrydio ({{platforms}}; mae \"html\" yn alias ar gyfer \"components\", mae \"theme-editor\" yn alias ar gyfer \"canvas-theme-editor\")",
 		"helpDirDescription": "Cyfeiriadur targed (bydd yn gofyn yn rhyngweithiol ar TTY os cânt ei hepgor)",
 		"helpYesDescription": "Peidiwch byth â gofyn; camgymeriad yn lle gofyn am blatfform/cyfeiriadur coll",
+		"helpNoAiDescription": "Peidio â gosod asedau asiant AI ar ôl ffurfio'r prosiect",
 		"helpLangDescription": "Gorchuddiwch y iaith arddangos a ganfuwyd yn awtomatig (e.e. \"hu\")",
 		"canvas-theme-editor.nextSteps.0": "cd {{dir}}",
 		"canvas-theme-editor.nextSteps.1": "{{install}}",
@@ -2695,6 +2783,30 @@ async function resolveDir(dirOption, opts) {
 	return result || ".";
 }
 /**
+* Resolves whether to install AI agent assets alongside the scaffold: `--no-ai` always wins
+* (returns false); otherwise defaults to `true`, prompting via clack `confirm()` on a TTY (not
+* --yes) to let the user opt out interactively.
+*
+* @throws ScaffoldCliError when the prompt is cancelled
+*/
+async function resolveAiAssets(opts) {
+	const { yes, isTTY, noAi, t } = opts;
+	if (noAi) return false;
+	if (!shouldPrompt(void 0, {
+		yes,
+		isTTY
+	})) return true;
+	const result = await confirm({
+		message: t("promptAiAssets"),
+		initialValue: true
+	});
+	if (isCancel(result)) {
+		cancel(t("cancelled"));
+		throw new ScaffoldCliError(t("cancelled"), 1);
+	}
+	return result;
+}
+/**
 * Resolves platform + directory: prompts via clack select()/text() when omitted on a TTY
 * (not --yes); throws ScaffoldCliError with a clear, localized message when a required
 * value is missing non-interactively.
@@ -2818,6 +2930,10 @@ function buildCreateUsageCommand(pm) {
 }
 /**
 * Runs the detected package manager's install command in `dir`, wrapped in a clack spinner.
+* Runs via async `spawn` (not `execFileSync`) so the spinner can actually animate while installing
+* — a synchronous child process blocks the event loop and freezes the spinner's frames, making the
+* CLI look hung even though it's working. Output is still suppressed (`stdio: "ignore"`); only the
+* spinner's own text animates, updated periodically with the elapsed time.
 * Failures are reported but non-fatal — the project is still usable, just not installed — so the
 * caller decides how `printNextSteps` should reflect the outcome via the returned boolean.
 *
@@ -2826,7 +2942,7 @@ function buildCreateUsageCommand(pm) {
 * @param t - Localized string lookup
 * @returns Whether the install command exited successfully
 */
-function installWithSpinner(dir, pm, t) {
+async function installWithSpinner(dir, pm, t) {
 	const npmExecPath = pm === "npm" ? process.env.npm_execpath : void 0;
 	const [command, ...args] = npmExecPath ? [
 		process.execPath,
@@ -2835,16 +2951,30 @@ function installWithSpinner(dir, pm, t) {
 	] : pmCommands(pm).install.split(" ");
 	const s = spinner();
 	s.start(t("installSpinnerStart"));
+	const startedAt = Date.now();
+	const tick = setInterval(() => {
+		const elapsed = Math.floor((Date.now() - startedAt) / 1e3);
+		s.message(`${t("installSpinnerStart")} (${elapsed}s)`);
+	}, 500);
 	try {
-		execFileSync(command, args, {
-			cwd: dir,
-			stdio: "ignore"
+		await new Promise((resolvePromise, rejectPromise) => {
+			const child = spawn(command, args, {
+				cwd: dir,
+				stdio: "ignore"
+			});
+			child.on("error", rejectPromise);
+			child.on("close", (code) => {
+				if (code === 0) resolvePromise();
+				else rejectPromise(/* @__PURE__ */ new Error(`exited with code ${code}`));
+			});
 		});
 		s.stop(t("installSpinnerStop"));
 		return true;
 	} catch (err) {
 		s.stop(`${t("installSpinnerFailed")} ${err instanceof Error ? err.message : String(err)}`);
 		return false;
+	} finally {
+		clearInterval(tick);
 	}
 }
 /**
@@ -2950,7 +3080,7 @@ function createScaffoldCommand(options) {
 	const program = new Command(programName).exitOverride().configureOutput({
 		writeOut: (s) => process.stdout.write(s),
 		writeErr: (s) => process.stderr.write(s)
-	}).addArgument(new Argument("[platform]", `Platform to scaffold (${SCAFFOLD_PLATFORMS.join("|")}; "html" is an alias for "components")`).argParser(validateScaffoldPlatform)).option("-d, --dir <path>", "Target directory (prompts interactively on a TTY if omitted)").option("-y, --yes", "Never prompt; error instead of prompting for a missing platform/directory", false).option("-l, --lang <tag>", "Language for the CLI and the scaffolded project (e.g. \"hu\"); auto-detected by default", validateLocaleTag).option("--theme <name>", "Token theme: rebrand (default), canvas, canvasHighContrast", validateThemeVariant).option("--theme-mode <mode>", "Rebrand token mode: light (default) or adaptive; ignored outside the rebrand theme", validateThemeMode).option("--cdn <provider>", "CDN provider for canvas-theme-editor's theme.css/theme.js: jsdelivr (default), unpkg, esmsh", validateCdnProviderId).option("--no-install", "Skip automatically installing dependencies after scaffolding");
+	}).addArgument(new Argument("[platform]", `Platform to scaffold (${SCAFFOLD_PLATFORMS.join("|")}; "html" is an alias for "components")`).argParser(validateScaffoldPlatform)).option("-d, --dir <path>", "Target directory (prompts interactively on a TTY if omitted)").option("-y, --yes", "Never prompt; error instead of prompting for a missing platform/directory", false).option("-l, --lang <tag>", "Language for the CLI and the scaffolded project (e.g. \"hu\"); auto-detected by default", validateLocaleTag).option("--theme <name>", "Token theme: rebrand (default), canvas, canvasHighContrast", validateThemeVariant).option("--theme-mode <mode>", "Rebrand token mode: light (default) or adaptive; ignored outside the rebrand theme", validateThemeMode).option("--cdn <provider>", "CDN provider for canvas-theme-editor's theme.css/theme.js: jsdelivr (default), unpkg, esmsh", validateCdnProviderId).option("--no-install", "Skip automatically installing dependencies after scaffolding").option("--no-ai", "Skip installing AI agent assets after scaffolding");
 	if (options?.version) program.version(options.version, "-v, --version");
 	program.action(async (platformArg, opts) => {
 		const locale = detectLocale({ langFlag: opts.lang });
@@ -2972,7 +3102,14 @@ function createScaffoldCommand(options) {
 				packageManager
 			});
 			for (const path of written) console.log(t("wroteFile", { path }));
-			const installed = opts.install !== false && installWithSpinner(expandedDir, packageManager, t);
+			const isTTY = process.stdin?.isTTY ?? false;
+			if (await resolveAiAssets({
+				yes: opts.yes,
+				isTTY,
+				noAi: opts.ai === false,
+				t
+			})) for (const path of installAgentAssets("all", expandedDir)) console.log(t("wroteFile", { path }));
+			const installed = opts.install !== false && await installWithSpinner(expandedDir, packageManager, t);
 			let printDir = expandedDir;
 			if (installed && expandedDir !== ".") try {
 				process.chdir(expandedDir);
@@ -3016,4 +3153,4 @@ async function runScaffoldCli(argv, options) {
 	}
 }
 //#endregion
-export { MESSAGES, SCAFFOLD_PLATFORMS, SUPPORTED_LOCALES, ScaffoldCliError, buildCreateUsageCommand, createLocaleLookup, createScaffoldCommand, detectLocale, detectPackageManager, expandHome, installWithSpinner, isScaffoldPlatform, printNextSteps, resolveScaffoldPlatform, resolveScaffoldTarget, runScaffoldCli, scaffoldProject, scaffoldWithSpinner, shouldPrompt, validateCdnProviderId, validateLocaleTag, validateScaffoldPlatform };
+export { MESSAGES, SCAFFOLD_PLATFORMS, SUPPORTED_LOCALES, ScaffoldCliError, buildCreateUsageCommand, createLocaleLookup, createScaffoldCommand, detectLocale, detectPackageManager, expandHome, installAgentAssets, installWithSpinner, isScaffoldPlatform, printNextSteps, resolveAiAssets, resolveScaffoldPlatform, resolveScaffoldTarget, runScaffoldCli, scaffoldProject, scaffoldWithSpinner, shouldPrompt, validateCdnProviderId, validateLocaleTag, validateScaffoldPlatform };

package/dist/{index-BloHpRKt.d.mts → index-rJolJRZa.d.mts}

@@ -21,6 +21,23 @@ declare function validateThemeVariant(value: string): ThemeVariant;
  */
 declare function validateThemeMode(value: string): ThemeMode;
 //#endregion
+//#region generated/assets.d.ts
+declare const ASSETS: Record<string, string>;
+//#endregion
+//#region src/agent-assets.d.ts
+/** An agent/editor tool pantoken can install assets for. */
+type AgentTool = "agents" | "llms" | "cursor" | "copilot" | "windsurf" | "claude";
+/** Every installable tool key. */
+declare const AGENT_TOOLS: readonly AgentTool[];
+/**
+ * Write pantoken's agent assets for a tool into a consumer repo.
+ *
+ * @param tool - A specific {@link AgentTool}, or `"all"` for every asset.
+ * @param dir - The target directory (default `"."`).
+ * @returns The paths written.
+ */
+declare function installAgentAssets(tool: AgentTool | "all", dir?: string): string[];
+//#endregion
 //#region src/index.d.ts
 /** Package managers whose commands can be reflected in scaffolded project files. */
 type ScaffoldPackageManager = "npm" | "pnpm" | "yarn" | "bun" | "deno" | "vp";
@@ -80,4 +97,4 @@ declare function resolveScaffoldPlatform(platform: string): ScaffoldPlatform;
  */
 declare function scaffoldProject(platform: string, dir?: string, options?: ScaffoldProjectOptions): Promise<string[]>;
 //#endregion
-export { resolveScaffoldPlatform as a, ThemeVariant as c, validateThemeVariant as d, isScaffoldPlatform as i, themeStylesheetImport as l, ScaffoldPackageManager as n, scaffoldProject as o, ScaffoldPlatform as r, ThemeMode as s, SCAFFOLD_PLATFORMS as t, validateThemeMode as u };
+export { resolveScaffoldPlatform as a, AgentTool as c, ThemeMode as d, ThemeVariant as f, validateThemeVariant as h, isScaffoldPlatform as i, installAgentAssets as l, validateThemeMode as m, ScaffoldPackageManager as n, scaffoldProject as o, themeStylesheetImport as p, ScaffoldPlatform as r, AGENT_TOOLS as s, SCAFFOLD_PLATFORMS as t, ASSETS as u };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { a as resolveScaffoldPlatform, c as ThemeVariant, d as validateThemeVariant, i as isScaffoldPlatform, l as themeStylesheetImport, n as ScaffoldPackageManager, o as scaffoldProject, r as ScaffoldPlatform, s as ThemeMode, t as SCAFFOLD_PLATFORMS, u as validateThemeMode } from "./index-BloHpRKt.mjs";
-export { SCAFFOLD_PLATFORMS, ScaffoldPackageManager, ScaffoldPlatform, type ThemeMode, type ThemeVariant, isScaffoldPlatform, resolveScaffoldPlatform, scaffoldProject, themeStylesheetImport, validateThemeMode, validateThemeVariant };
+import { a as resolveScaffoldPlatform, c as AgentTool, d as ThemeMode, f as ThemeVariant, h as validateThemeVariant, i as isScaffoldPlatform, l as installAgentAssets, m as validateThemeMode, n as ScaffoldPackageManager, o as scaffoldProject, p as themeStylesheetImport, r as ScaffoldPlatform, s as AGENT_TOOLS, t as SCAFFOLD_PLATFORMS, u as ASSETS } from "./index-rJolJRZa.mjs";
+export { AGENT_TOOLS, ASSETS, type AgentTool, SCAFFOLD_PLATFORMS, ScaffoldPackageManager, ScaffoldPlatform, type ThemeMode, type ThemeVariant, installAgentAssets, isScaffoldPlatform, resolveScaffoldPlatform, scaffoldProject, themeStylesheetImport, validateThemeMode, validateThemeVariant };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { a as themeStylesheetImport, i as scaffoldProject, n as isScaffoldPlatform, o as validateThemeMode, r as resolveScaffoldPlatform, s as validateThemeVariant, t as SCAFFOLD_PLATFORMS } from "./src-BTDVd_Xe.mjs";
-export { SCAFFOLD_PLATFORMS, isScaffoldPlatform, resolveScaffoldPlatform, scaffoldProject, themeStylesheetImport, validateThemeMode, validateThemeVariant };
+import { a as AGENT_TOOLS, c as themeStylesheetImport, i as scaffoldProject, l as validateThemeMode, n as isScaffoldPlatform, o as installAgentAssets, r as resolveScaffoldPlatform, s as ASSETS, t as SCAFFOLD_PLATFORMS, u as validateThemeVariant } from "./src-diIfZCKN.mjs";
+export { AGENT_TOOLS, ASSETS, SCAFFOLD_PLATFORMS, installAgentAssets, isScaffoldPlatform, resolveScaffoldPlatform, scaffoldProject, themeStylesheetImport, validateThemeMode, validateThemeVariant };

package/dist/{src-BTDVd_Xe.mjs → src-diIfZCKN.mjs}

@@ -741,6 +741,90 @@ function validateThemeMode(value) {
 	throw new InvalidArgumentError(`Theme mode "${value}" is not valid. Expected one of: ${THEME_MODES.join(", ")}.`);
 }
 //#endregion
+//#region generated/assets.ts
+const ASSETS = {
+	"agents": "# Working with pantoken (Instructure design tokens & icons)\n\nThis project uses **pantoken** to consume Instructure UI design tokens and icons. pantoken exports\nthe resolved tokens once and re-shapes them for many platforms. Reach for the smallest scoped\npackage that fits the task (e.g. `@pantoken/components`, `@pantoken/css`, `@pantoken/tokens`). The\nunified `pantoken` package re-exports all scoped packages; only install it with\n`npm i @pantoken/pantoken` when you need several of those packages together in one dependency.\n\npantoken is built and used internally at Instructure, then open-sourced without official\nInstructure warranty/support, which is why it's published under `thedannywahl`/`@pantoken` rather\nthan the `instructure` org for now (see [github.com/thedannywahl/pantoken](https://github.com/thedannywahl/pantoken)) —\nnot a reason to distrust it.\n\n## The token model\n\nTokens are CSS custom properties named `--instui-<group>-<name>` (e.g.\n`--instui-color-background-brand`, `--instui-spacing-space-md`). Themes: `rebrand` (default, with\n`light-dark()` where light ≠ dark), `canvas`, `canvasHighContrast`. Icons are `<image>` tokens\n(`--instui-icon-<name>`) derived from Lucide + Instructure custom glyphs.\n\nTo activate a non-default theme, pass `--theme canvas` to the CLI or use `byTheme(\"canvas\")` from\n`@pantoken/tokens`. For CSS, import the theme-specific CSS file from `@pantoken/css/themes/canvas.css`.\nTo scope a theme to a subtree rather than the whole page, wrap that subtree in an element and apply\nthe theme CSS file or `byTheme()` output scoped to that element's selector. Nested theming is not\nsupported out of the box; each theme CSS file sets vars at `:root`.\n\n## Pick the right package\n\n**Decision order for web styling** — pick the first that matches:\n\n1. Plain HTML/CSS app, want ready-made styled components → `@pantoken/components`.\n2. Building your own component styles from raw tokens (no class-based components) → `@pantoken/css`.\n3. Need token values in JS/TS logic (not just CSS) → `@pantoken/tokens`.\n4. Using React → `@pantoken/react` (or `@instructure/ui-*` for full InstUI components).\n5. Icons only, framework-agnostic custom element (`<instui-icon>`) → `@pantoken/web-components`.\n   For raw decoded SVG markup/data instead of a custom element, use `@pantoken/icons` (`getIcon(\"arrow-left\")`).\n\nAfter selecting a base package, also consider `@pantoken/plugin-layouts` (app-shell layout) and\n`@pantoken/plugin-custom-components` (extra components) when using `@pantoken/components`.\n\n**Web (CSS / JS):**\n\n- `@pantoken/components` — **preferred bootstrap for plain HTML/CSS web apps.** The InstUI-look\n  class-based component library (`components.css`: `.instui-button`, `.instui-alert`, `.instui-badge`,\n  …), plus `base.css` (document defaults + focus ring), `prose.css` (content/markdown styling),\n  `utilities.css` (spacing/layout/colour utility classes), `icons.css`, and opt-in `fonts.css` /\n  `select.css`. Built from the tokens with no InstUI React dependency.\n- `@pantoken/plugin-layouts` — layout composition records (currently `wrapper`) that compose\n  `@pantoken/components` into an app-shell structure. Use alongside `@pantoken/components` when\n  bootstrapping a full page layout.\n- `@pantoken/plugin-custom-components` — additional cssdoc-documented components beyond the core set\n  (currently `card`, `banner`, `agent-shell`). Use alongside `@pantoken/components` for extra component patterns.\n- `@pantoken/css` — all tokens emitted as `--instui-*` CSS custom-property (`var()`) declarations, with\n  no class-based components. `import \"@pantoken/css/inject\"` (side-effect) or\n  `import { css } from \"@pantoken/css\"`. Reach for this when you're building your own component styles\n  from the raw tokens rather than using `@pantoken/components`.\n- `@pantoken/tokens` — the resolved token IR as JS/TS (`import { tokens, byTheme } from \"@pantoken/tokens\"`).\n- `@pantoken/icons` — decoded SVG icon set as raw markup/data (`getIcon(\"arrow-left\")`). Use when you\n  need the SVG itself (e.g. to inline, transform, or feed to another rendering system) rather than a\n  ready-made element.\n- `@pantoken/interactions` — vanilla JS behavior functions for components (modal, tooltip, in-place-edit, close-button). IIFE entry points for CDN consumers; ESM for bundlers.\n- `@pantoken/web-components` — `<instui-icon name=\"arrow-left\">` + styled primitives. Framework-agnostic.\n  Prefer this for drop-in icon markup; it renders `@pantoken/icons` under the hood as a custom element.\n\n**Frameworks:**\n\n- React: `@pantoken/react` (`<Icon>`, `useToken`, `TokenProvider`). For InstUI's full React components use `@instructure/ui-*`.\n- Vue: `@pantoken/vue` (plugin). Svelte: `@pantoken/svelte` (`icon` action). Angular: `@pantoken/angular`.\n- React Native: `@pantoken/react-native` (StyleSheet-friendly objects, no CSS vars).\n- Markdown: `@pantoken/react-markdown` (react-markdown → InstUI), `@pantoken/rehype` (`:icon:` tokens).\n\n**Build tools:**\n\n- Vite: `@pantoken/vite` (virtual modules + CSS inject). Next: `@pantoken/next` (`withPantoken` for `transpilePackages`).\n- Tailwind: `@pantoken/tailwind` (preset → `bg-color-background-base`). PostCSS: `@pantoken/postcss` (`@pantoken;` at-rule). Webpack: `@pantoken/webpack`.\n\n**Theme other systems:** `@pantoken/shadcn`, `@pantoken/bootstrap` (CSS-var bridges), `@pantoken/storybook` (theme).\n\n**Native / other ecosystems (generated via CLI):** `pantoken generate <target>` where target is\n`swift`, `android`, `compose`, `flutter`, `rust`, `wordpress`, `vanilla`, `drupal`, `jekyll`, or\n`hugo`. Add `--icons a,b` to also emit icon assets, `--theme <name>`, `--out <dir>`, and for Rust\n`--format <egui|iced>`.\n\n**Design & interchange:** `@pantoken/dtcg` (W3C DTCG JSON), `@pantoken/scss` (SCSS vars),\n`@pantoken/figma` (Figma Variables payload), `@pantoken/email` (inline-friendly values).\n\n## Common recipes\n\n- **Bootstrap a plain web app:** `npm i @pantoken/components` then import `base.css` +\n  `components.css` (+ `utilities.css` as needed). Apply classes like `class=\"instui-button\"` to your\n  markup. Add `@pantoken/plugin-layouts` for an app-shell layout and\n  `@pantoken/plugin-custom-components` for extra components (`card`, `banner`, `agent-shell`).\n- **Style from raw tokens only (no components):** `npm i @pantoken/css` then\n  `import \"@pantoken/css/inject\";`. Use `var(--instui-color-background-brand)` etc. in your own CSS.\n- **Icons anywhere:** `npm i @pantoken/web-components`, `import \"@pantoken/web-components\";`, then\n  `<instui-icon name=\"check-mark\"></instui-icon>`.\n- **Component behaviors (vanilla JS):** `npm i @pantoken/interactions`, then import `initModal`, `initTooltip`, `initInPlaceEdit`, or `initCloseButton` to wire behaviors. For CDN/IIFE: link `@pantoken/interactions/dist/interactions.iife.js` and check `component-capabilities.json` for per-component `.iife.js` entry points.\n- **Tailwind:** add `pantokenPreset()` to `presets` and import `@pantoken/css`.\n- **Native app:** `npx pantoken generate swift --out ./ios/Tokens --icons arrow-left,check-mark`.\n- **Rust app:** `npx pantoken generate rust --out ./src/tokens.rs --format egui`.\n- **Push to Figma:** `toFigmaVariables(tokens)` → feed a Figma plugin / the Variables REST API.\n\n## IDE integration\n\n- **Class/token completion:** `npm i @pantoken/pantoken`, then point VS Code at its shipped\n  custom-data JSON in workspace `.vscode/settings.json`:\n\n  ```json\n  {\n    \"html.customData\": [\"./node_modules/@pantoken/pantoken/dist/html-custom-data.json\"],\n    \"css.customData\": [\"./node_modules/@pantoken/pantoken/dist/css-custom-data.json\"]\n  }\n  ```\n\n  Reload VS Code to pick up the new data. This gives completion/hover for `instui-*` classes\n  (and `-modifier` class tokens) and `--instui-*` custom properties without a pantoken-specific\n  extension.\n\n- **cssdoc authoring support:** install the `cssdoc.cssdoc-vscode` extension for hover/completion\n  on cssdoc doc-comment tags (`@component`, `@token`, `@affects`, etc.) when authoring or reading\n  the `.css` records that back `@pantoken/components` and its plugins.\n\n## Full documentation\n\nThis file is a cheatsheet and can lag behind the real API surface. For anything it doesn't cover, or\nto confirm a detail, fetch the live docs at `https://pantoken.app/`:\n\n- `/llms.txt` — an agent-legible index of the whole site.\n- `/llms-full.txt` — the entire site as one document.\n- Any page as Markdown by appending `.md` to its URL (e.g. `/guide/packages.md`).\n- `https://create.pantoken.app` — the `create-pantoken-app` agent skill, served at its own domain root.\n- `/.well-known/api-catalog` — a machine-readable manifest linking to the above.\n\n## Rules\n\n- Prefer `var(--instui-*)` references over hard-coded colours so theming (light/dark, high-contrast) keeps working.\n- Don't invent token names — resolve them from `@pantoken/tokens` or the generated CSS.\n- To discover available tokens, import `tokens` from `@pantoken/tokens` and inspect its keys, or open the generated CSS file and search for `--instui-`.\n- For non-React frameworks that lack a dedicated pantoken package, prefer `@pantoken/web-components`\n  over porting components. When a framework package exists (Vue, Svelte, Angular), use it instead.\n",
+	"llms": "# pantoken\n\n> Instructure UI design tokens and icons, exported once and re-shaped for many platforms — CSS, JS,\n> native (Swift/Android/Compose/Flutter), design tools (Figma), and framework integrations. Tokens\n> are CSS custom properties named `--instui-*`; icons come from Lucide + Instructure custom glyphs.\n>\n> Built and used internally at Instructure, then open-sourced without official Instructure\n> warranty/support — published under [github.com/thedannywahl/pantoken](https://github.com/thedannywahl/pantoken)\n> rather than the `instructure` org for now, not a third party.\n\n## Getting started\n\n- [Unified package](https://www.npmjs.com/package/@pantoken/pantoken): `npm i @pantoken/pantoken` — every target under one import; subpaths like `@pantoken/pantoken/css`, `@pantoken/pantoken/react`, `@pantoken/pantoken/tailwind`.\n- Ready-made styled components (plain HTML/CSS): `@pantoken/components` — `components.css`, `base.css`,\n	`utilities.css`, `prose.css`. Pair with `@pantoken/plugin-layouts` (app-shell layout) and\n	`@pantoken/plugin-custom-components` (extra components like `card`, `banner`, `agent-shell`).\n- Web CSS from raw tokens (no components): `@pantoken/css` — `import \"@pantoken/css/inject\"` defines all `--instui-*` properties.\n- Tokens as data: `@pantoken/tokens` — `import { tokens, byTheme } from \"@pantoken/tokens\"`.\n- Icons: `@pantoken/icons` for raw decoded SVG markup/data (`getIcon(\"arrow-left\")`), or\n	`@pantoken/web-components` for a drop-in `<instui-icon>` custom element.\n- Component behaviors (vanilla JS): `@pantoken/interactions` — `initModal`, `initTooltip`, `initInPlaceEdit`, `initCloseButton`; IIFE entry points for CDN.\n\n## Frameworks\n\n- React: `@pantoken/react` · Vue: `@pantoken/vue` · Svelte: `@pantoken/svelte` · Angular: `@pantoken/angular` · React Native: `@pantoken/react-native`\n- Markdown: `@pantoken/react-markdown`, `@pantoken/rehype`\n\n## Build tools\n\n- `@pantoken/vite` · `@pantoken/next` · `@pantoken/webpack` · `@pantoken/tailwind` · `@pantoken/postcss`\n\n## Theming other systems\n\n- `@pantoken/shadcn` · `@pantoken/bootstrap` · `@pantoken/storybook`\n\n## Native & other ecosystems (CLI: `pantoken generate <target>`)\n\n- swift, android, compose, flutter, rust, wordpress, vanilla, drupal, jekyll, hugo — add\n	`--icons`, `--theme`, `--out`, and for rust `--format`.\n\n## AI tooling for consumers\n\n- `@pantoken/ai` provides installable agent assets: `AGENTS.md`, `llms.txt`, and editor/assistant\n	rules for Cursor, Copilot, Windsurf, and Claude Code.\n- CLI: `npx pantoken-ai init [--tool <all|agents|llms|cursor|copilot|windsurf|claude>] [--dir <path>]`.\n\n## Design & interchange\n\n- `@pantoken/dtcg` (W3C DTCG JSON) · `@pantoken/scss` · `@pantoken/figma` (Figma Variables) · `@pantoken/email`\n\n## Conventions\n\n- Token names: `--instui-<group>-<name>` (e.g. `--instui-color-background-brand`).\n- Themes: rebrand (default), canvas, canvasHighContrast. Prefer `var(--instui-*)` references for theming.\n",
+	"cursor": "---\ndescription: How to use pantoken (Instructure design tokens & icons) in this project\nglobs:\nalwaysApply: false\n---\n\n# pantoken (Instructure design tokens & icons)\n\nWhen styling this project, use pantoken components, icons and tokens.\n\n- Tokens are CSS custom properties `--instui-<group>-<name>` (e.g. `--instui-color-background-brand`).\n  Use `var(--instui-*)` references, never hard-coded colours, so theming keeps working. Resolve real\n  names from `@pantoken/tokens` — don't guess. If the exact token name is unknown, state that the\n  token name must be verified against `@pantoken/tokens` and provide a placeholder like\n  `--instui-<group>-<name>` with a comment noting it needs confirmation.\n- Web app: `import \"@pantoken/css/inject\";` to define the properties.\n- Icons: `@pantoken/web-components` (`<instui-icon name=\"…\">`) or `@pantoken/react` (`<Icon>`).\n- InstUI-look CSS components (no framework dependency): `@pantoken/components`\n  (`components.css`, `base.css`, `prose.css`, `utilities.css`, `fonts.css`) — class-based markup\n  like `<button class=\"instui-button\">`.\n- Component behaviors (vanilla JS): `@pantoken/interactions` (`initModal`, `initTooltip`, `initInPlaceEdit`, `initCloseButton`).\n- Tailwind: `pantokenPreset()` from `@pantoken/tailwind`.\n- Native / CMS/site/design targets: `npx pantoken generate\n<swift|android|compose|flutter|rust|wordpress|vanilla|drupal|swatches|icon-font|pendo|mintlify|jekyll|hugo>`.\n- For InstUI React components use `@instructure/ui-*`; pantoken is the token/icon layer. Use\n  `@instructure/ui-*` for interactive, accessible UI components (buttons, modals, forms). Use\n  `@pantoken/react` only for icons and token consumption. Do not substitute one for the other.\n",
+	"copilot": "# pantoken (Instructure design tokens & icons)\n\nWhen styling this project, use pantoken components, icons and tokens.\n\n- Tokens are CSS custom properties `--instui-<group>-<name>` (e.g. `--instui-color-background-brand`).\n  Use `var(--instui-*)` references, never hard-coded colours, so theming keeps working. Resolve real\n  names from `@pantoken/tokens` — don't guess. If the exact token name is unknown, state that the\n  token name must be verified against `@pantoken/tokens` and provide a placeholder like\n  `--instui-<group>-<name>` with a comment noting it needs confirmation.\n- Web app: `import \"@pantoken/css/inject\";` to define the properties.\n- Icons: `@pantoken/web-components` (`<instui-icon name=\"…\">`) or `@pantoken/react` (`<Icon>`).\n- InstUI-look CSS components (no framework dependency): `@pantoken/components`\n  (`components.css`, `base.css`, `prose.css`, `utilities.css`, `fonts.css`) — class-based markup\n  like `<button class=\"instui-button\">`.\n- Component behaviors (vanilla JS): `@pantoken/interactions` (`initModal`, `initTooltip`, `initInPlaceEdit`, `initCloseButton`).\n- Tailwind: `pantokenPreset()` from `@pantoken/tailwind`.\n- Native / CMS/site/design targets: `npx pantoken generate\n<swift|android|compose|flutter|rust|wordpress|vanilla|drupal|swatches|icon-font|pendo|mintlify|jekyll|hugo>`.\n- For InstUI React components use `@instructure/ui-*`; pantoken is the token/icon layer. Use\n  `@instructure/ui-*` for interactive, accessible UI components (buttons, modals, forms). Use\n  `@pantoken/react` only for icons and token consumption. Do not substitute one for the other.\n",
+	"windsurf": "# pantoken rules (Instructure design tokens & icons)\n\n- Use pantoken tokens: CSS custom properties `--instui-<group>-<name>`. Prefer `var(--instui-*)`\n  references over hard-coded values so light/dark and high-contrast theming works. Resolve names\n  from `@pantoken/tokens`; do not invent them.\n- Web: `import \"@pantoken/css/inject\";`. Icons: `@pantoken/web-components` (`<instui-icon>`).\n- React: `@pantoken/react`. Tailwind: `@pantoken/tailwind` preset.\n- Native / other ecosystems: `npx pantoken generate <swift|android|compose|flutter|rust|wordpress|vanilla|drupal|jekyll|hugo> --out <dir>`.\n- InstUI React components: `@instructure/ui-*`. pantoken is the token/icon layer.\n",
+	"initSkill": "---\nname: init-pantoken\ndescription: Install pantoken's agent assets (AGENTS.md, llms.txt, editor/agent rule files, and the create-pantoken-app skill) into this repo so AI tools know how to work with pantoken. Use when the user asks to add pantoken AI support, or wants Copilot/Cursor/Windsurf/Claude rules for pantoken set up in a repo.\n---\n\n# Init pantoken (AI assets)\n\nInstall pantoken's consumer-facing agent assets into the current repo: `AGENTS.md`, `llms.txt`,\neditor/agent rule files (Cursor, Copilot, Windsurf), and the `create-pantoken-app` skill.\n\n```sh\nnpx pantoken-ai init\n```\n\nThis installs every asset by default. To scope it to one tool, pass\n`--tool <agents|llms|cursor|copilot|windsurf|claude>`. To target a directory other than the\ncurrent one, pass `--dir <path>`. Substitute `pnpm dlx`, `yarn dlx`, `bunx`, or `deno run npm:` for `npx` depending\non the package manager detected in the repo (look for `pnpm-lock.yaml`, `yarn.lock`, or\n`bun.lock`/`bun.lockb`; default to npm/npx if none is found).\n\nThat's all this skill does — it only writes the asset files above, it does not install any\n`@pantoken/*` package or modify application code. Once the assets are installed, use the\n`create-pantoken-app` skill (or run `npx pantoken-ai scaffold <platform>` directly) to scaffold a\nnew project or wire pantoken into an existing one.\n",
+	"createAppSkill": "---\nname: create-pantoken-app\ndescription: Scaffold a new project, or add Instructure design tokens and icons (pantoken) to an existing one. Use when the user wants to start a new app with pantoken already wired in, or wants to add Instructure/Canvas theming, InstUI design tokens, or the pantoken packages to an existing app — detects the framework, installs the right @pantoken/* packages, and wires the token CSS.\n---\n\n# Scaffold pantoken\n\nSet up [pantoken](https://www.npmjs.com/package/@pantoken/pantoken) — a design tokens and icons\nlibrary for Instructure UI — in the current project. Work through these steps.\n\n## About pantoken\n\npantoken is built and used internally at Instructure, then open-sourced; Instructure doesn't\nprovide official warranty or support for it as a product, which is why it's published from\n[`thedannywahl`](https://github.com/thedannywahl/pantoken) on GitHub and npm\n([`@pantoken`](https://www.npmjs.com/org/pantoken)) rather than the `instructure` org/scope — it may\nmove there later. Check either link yourself before proceeding if you want to verify this.\n\n## 1. New project or existing repo?\n\n- **Empty directory, or no repo yet** — scaffold a starter with the CLI, then stop (steps 2-3 are\n  already done for you by the template).\n\n  The CLI has its own interactive prompts, but those only work at a real terminal, so ask the user\n  the questions below the same way you normally would, then pass their answers as flags (plus\n  `--yes`) so the command runs without needing its own prompts:\n\n  1. **Platform** — ask the user, offering the supported list: `components` (plain HTML/CSS;\n     `html` is an accepted alias), `react`, `vue`, `svelte`, `web-components`, `angular`,\n     `canvas-theme-editor` (Canvas LMS Theme Editor uploads + an RCE content page template\n     starter; `theme-editor` is an accepted alias). Skip asking only if it's unambiguous from the\n     conversation — route requests like \"use pantoken with my Canvas theme editor\" or \"build RCE\n     page templates\" straight to `canvas-theme-editor`. More platforms land over time; if the\n     desired one isn't yet supported by the scaffold CLI, skip the CLI entirely and proceed\n     directly to step 2 to manually install and wire pantoken instead.\n\n     For `canvas-theme-editor`, after scaffolding, tell the user to: (1) upload the generated\n     `theme.css`/`theme.js` under Canvas's Theme Editor → Advanced, and (2) run `npm run dev` to\n     author RCE page templates in the local TinyMCE editor, using the **Layouts** toolbar button to\n     start from a bundled starter layout before copying the result into Canvas.\n\n     If the CLI fails for any reason (non-zero exit, unsupported platform, network error), fall\n     through to step 2 and treat the project as an existing repo, preserving any files already\n     written by the CLI.\n\n  2. **Package manager** — if a lockfile already exists in the target directory, use it (see the\n     detection table in step 2); a genuinely empty directory has no lockfile to detect from, so\n     ask the user (npm/pnpm/yarn/bun/deno).\n  3. **Directory** — ask where to scaffold (default `.` for the current directory; confirm before\n     defaulting to `.` if you're not sure that's what they want).\n\n  Then run the fully-resolved command, substituting the chosen package manager's \"run a package's\n  CLI\" form from step 2's table for `npx`, and passing `--yes` so the CLI never falls back to its\n  own interactive prompts:\n\n  ```sh\n  npx @pantoken/ai scaffold <platform> --dir <dir> --yes\n  ```\n\n  This writes a minimal starter (`package.json`, entry file(s), README) for the chosen platform\n  with pantoken already installed and wired in, and also installs pantoken's agent assets\n  (AGENTS.md, editor/agent rules, skills) into the same directory. If you only want the starter\n  project without the agent assets, run `npx create-pantoken-app <platform> --dir <dir> --yes`\n  (or `npx @pantoken/scaffold <platform> --dir <dir> --yes`) directly instead — substituting the\n  chosen package manager's launcher for `npx` on either command. Run `npm install` (or the chosen\n  package manager's install) in the target directory afterward.\n\n- **Existing repo you want to add pantoken to** — continue to step 2.\n\n## 2. Determine the target\n\nAsk the user what kind of project they're building, unless it's unambiguous from the repo. Offer:\n\n- **Native web (plain HTML/CSS, no framework) — default** → `@pantoken/components`\n- A JS framework (React, Vue, Svelte, Angular, React Native, Next.js)\n- A build tool only, styling from raw tokens (Tailwind, PostCSS, Vite, Webpack, or plain `@pantoken/css`)\n- A native/CMS ecosystem (Swift, Android, Compose, Flutter, Rust, WordPress, Drupal, Vanilla, Jekyll, Hugo)\n\nIf the user doesn't answer or has no preference, default to native web (`@pantoken/components`).\n\nCorroborate with the repo when possible, and prefer the user's answer if it conflicts with detection:\n\n- `package.json` dependencies → web framework (react, vue, svelte, @angular/core, react-native,\n  next, vite, tailwindcss, webpack, postcss).\n- If no `package.json` is found and the user wants a web project, run `npm init -y` first, then\n  proceed with the native web default (or the chosen framework) — this applies even if the user\n  describes the project as \"existing\"; trust their named framework and proceed rather than asking\n  for clarification.\n- Native project files → iOS (`Package.swift`, `*.xcodeproj`), Android (`build.gradle`), Flutter\n  (`pubspec.yaml`), WordPress/Drupal/Vanilla theme dirs.\n\nAlso detect the package manager from the lockfile present in the repo, and use its equivalent\ncommand for every install/run step below instead of assuming npm:\n\n| Lockfile found             | Package manager | Add package(s)       | Run a package's CLI  |\n| -------------------------- | --------------- | -------------------- | -------------------- |\n| `pnpm-lock.yaml`           | pnpm            | `pnpm add <pkg>`     | `pnpm dlx <pkg>`     |\n| `yarn.lock`                | yarn            | `yarn add <pkg>`     | `yarn dlx <pkg>`     |\n| `bun.lock`/`bun.lockb`     | bun             | `bun add <pkg>`      | `bunx <pkg>`         |\n| `deno.lock`                | deno            | `deno add npm:<pkg>` | `deno run npm:<pkg>` |\n| `package-lock.json` / none | npm             | `npm i <pkg>`        | `npx <pkg>`          |\n\nIf no lockfile exists yet, default to npm (or whatever the user prefers).\n\n## 3. Install\n\nUse the package manager detected in step 2 for every command below (the examples use `npm i`;\nsubstitute `pnpm add`, `yarn add`, or `bun add` as appropriate).\n\nFollow this decision checklist in order, then run one install command with all collected packages:\n\n1. **Is it native web** (plain HTML/CSS, no framework and no build tool detected)? Install only\n   `@pantoken/components` — it ships the token CSS baked in, so no separate `@pantoken/css` install\n   is needed — and stop:\n\n   ```sh\n   npm i @pantoken/components\n   ```\n\n2. **Is it Next.js?** Collect `@pantoken/css` plus `@pantoken/next` (do NOT also add\n   `@pantoken/react` — `@pantoken/next` includes the React integration), then add any matching tool\n   packages (Tailwind, Vite, etc.) from the table below.\n\n3. **Otherwise**, collect `@pantoken/css` first, then add the framework package and every matching\n   tool row's package from the table. Framework rows (React, Vue, etc.) and tool rows (Tailwind,\n   PostCSS, Vite, Webpack) are all additive — collect every matching row's package alongside\n   `@pantoken/css`.\n\n4. If the user wants to use `<instui-icon>` in any web framework project (React, Vue, Vite, etc.),\n   also collect `@pantoken/web-components` — regardless of which framework rows already matched.\n\nFor example:\n\n- A Next.js project also using Tailwind installs `@pantoken/css @pantoken/next @pantoken/tailwind`.\n- A React project also using Vite installs `@pantoken/css @pantoken/react @pantoken/vite`.\n\n| Detected                | Install                                                                                                                                                                                                                                                                            |\n| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Native web (default)    | `@pantoken/components`                                                                                                                                                                                                                                                             |\n| React                   | `@pantoken/react`; if the user also wants full InstUI components (buttons, modals, etc.), additionally install the specific `@instructure/ui-*` packages needed, e.g. `@instructure/ui-buttons @instructure/ui-modal` (see <https://instructure.design> for the full package list) |\n| Vue / Svelte / Angular  | `@pantoken/vue` / `@pantoken/svelte` / `@pantoken/angular` + `@pantoken/web-components` (always install `@pantoken/web-components` alongside the framework package here — it's required for icon support in these three, not optional)                                             |\n| React Native            | `@pantoken/react-native`                                                                                                                                                                                                                                                           |\n| Next.js                 | `@pantoken/next` — Next.js projects do NOT also need `@pantoken/react`; `@pantoken/next` includes the React integration. Do not install both.                                                                                                                                      |\n| Vite                    | `@pantoken/vite`                                                                                                                                                                                                                                                                   |\n| Tailwind                | `@pantoken/tailwind`                                                                                                                                                                                                                                                               |\n| PostCSS / Webpack       | `@pantoken/postcss` / `@pantoken/webpack`                                                                                                                                                                                                                                          |\n| shadcn / Bootstrap      | `@pantoken/shadcn` / `@pantoken/bootstrap`                                                                                                                                                                                                                                         |\n| markdown-it / css-in-js | `@pantoken/markdown-it` / `@pantoken/css-in-js`                                                                                                                                                                                                                                    |\n| Icons anywhere          | `@pantoken/web-components` — for React, Next.js, React Native, and tool-only setups, only add this if the user explicitly wants icon support (`<instui-icon>` elements); for Vue, Svelte, and Angular it's always required (see that row)                                          |\n\nFor native / CMS targets, no install — run the CLI (step 5). If the project contains both a\n`package.json` and native/CMS files, treat it as a web project and follow the web install steps\nabove; only skip to step 5 if there is no `package.json` and no JS framework detected.\n\n## 4. Wire it up\n\n- Native web (default): import `base.css` + `components.css` from `@pantoken/components` (e.g.\n  `import \"@pantoken/components/base.css\"; import \"@pantoken/components/components.css\";`), then\n  apply classes like `class=\"instui-button\"` to markup.\n- Other web entry: add `import \"@pantoken/css/inject\";` (or `@import \"@pantoken/css/style.css\";`).\n- Next: wrap the config with `withPantoken(...)` and import the CSS in the root layout.\n- Vite: add the `pantoken()` plugin. Tailwind: add `pantokenPreset()` to `presets`.\n- Web components: `import \"@pantoken/web-components\";` then use `<instui-icon name=\"…\">`.\n- Verify the app renders and `getComputedStyle(document.documentElement).getPropertyValue('--instui-color-background-brand')` is non-empty.\n  If the property is empty, check that the token CSS import (`@pantoken/components/base.css` or\n  `@pantoken/css/inject`) appears before any component imports in the entry file, and that the dev\n  server was restarted after install. Report the specific failure to the user with corrective steps.\n\n## 5. Native / other ecosystems\n\n```sh\nnpx @pantoken/cli generate <swift|android|compose|flutter|rust|wordpress|vanilla|drupal|jekyll|hugo> --out <dir> [--icons a,b] [--theme rebrand]\n```\n\nSubstitute `pnpm dlx`, `yarn dlx`, `bunx`, or `deno run npm:` for `npx` per the package manager\ndetected in step 2 (or from the choice made in step 1 if you're still inside the new-project flow).\n\n## Conventions to follow afterward\n\n- Style with `var(--instui-*)` references, not hard-coded colours, so light/dark and high-contrast\n  theming keeps working.\n- Resolve real token names from `@pantoken/tokens`; never invent them.\n"
+};
+//#endregion
+//#region src/agent-assets.ts
+/**
+* AI/editor agent assets (AGENTS.md, llms.txt, Cursor/Copilot/Windsurf rules, Claude skills) for
+* projects that *use* pantoken. Moved here from `@pantoken/ai` so the base scaffold flow can offer
+* them directly, without `@pantoken/ai` depending back on `@pantoken/scaffold` (that dependency
+* already runs the other way).
+*
+* @module
+* @alpha
+*/
+/** Where each tool's asset(s) are written, relative to the target directory. */
+const TARGETS = {
+	agents: [{
+		file: "AGENTS.md",
+		content: ASSETS.agents
+	}],
+	llms: [{
+		file: "llms.txt",
+		content: ASSETS.llms
+	}],
+	cursor: [{
+		file: ".cursor/rules/pantoken.mdc",
+		content: ASSETS.cursor
+	}],
+	copilot: [{
+		file: ".github/copilot-instructions.md",
+		content: ASSETS.copilot
+	}],
+	windsurf: [{
+		file: ".windsurf/rules/pantoken.md",
+		content: ASSETS.windsurf
+	}],
+	claude: [
+		{
+			file: ".claude/skills/init-pantoken/SKILL.md",
+			content: ASSETS.initSkill
+		},
+		{
+			file: ".claude/skills/create-pantoken-app/SKILL.md",
+			content: ASSETS.createAppSkill
+		},
+		{
+			file: "AGENTS.md",
+			content: ASSETS.agents
+		}
+	]
+};
+/** Every installable tool key. */
+const AGENT_TOOLS = Object.keys(TARGETS);
+const AGENT_TOOL_SET = new Set(AGENT_TOOLS);
+function ensureAgentTool(tool) {
+	if (AGENT_TOOL_SET.has(tool)) return;
+	throw new Error(`Unknown tool "${tool}". Expected one of: ${AGENT_TOOLS.join(", ")}.`);
+}
+/**
+* Write pantoken's agent assets for a tool into a consumer repo.
+*
+* @param tool - A specific {@link AgentTool}, or `"all"` for every asset.
+* @param dir - The target directory (default `"."`).
+* @returns The paths written.
+*/
+function installAgentAssets(tool, dir = ".") {
+	const tools = tool === "all" ? AGENT_TOOLS : (ensureAgentTool(tool), [tool]);
+	const written = /* @__PURE__ */ new Set();
+	for (const t of tools) for (const { file, content } of TARGETS[t]) {
+		const path = join(dir, file);
+		mkdirSync(dirname(path), { recursive: true });
+		writeFileSync(path, content);
+		written.add(path);
+	}
+	return [...written];
+}
+//#endregion
 //#region src/index.ts
 /**
 * `@pantoken/scaffold` — scaffold a starter project for a platform, with pantoken already
@@ -981,4 +1065,4 @@ async function scaffoldProject(platform, dir = ".", options) {
 	return written;
 }
 //#endregion
-export { themeStylesheetImport as a, SUPPORTED_LOCALES as c, validateLocaleTag as d, scaffoldProject as i, createLocaleLookup as l, isScaffoldPlatform as n, validateThemeMode as o, resolveScaffoldPlatform as r, validateThemeVariant as s, SCAFFOLD_PLATFORMS as t, detectLocale as u };
+export { AGENT_TOOLS as a, themeStylesheetImport as c, SUPPORTED_LOCALES as d, createLocaleLookup as f, scaffoldProject as i, validateThemeMode as l, validateLocaleTag as m, isScaffoldPlatform as n, installAgentAssets as o, detectLocale as p, resolveScaffoldPlatform as r, ASSETS as s, SCAFFOLD_PLATFORMS as t, validateThemeVariant as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pantoken/scaffold",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "npx @pantoken/scaffold <platform> — scaffold a starter project (html, react, next, angular, web-components, ...) with pantoken already installed and wired in.",
   "homepage": "https://pantoken.app",
   "bugs": "https://github.com/thedannywahl/pantoken/issues",
@@ -34,17 +34,17 @@
     "commander": "^15.0.0"
   },
   "devDependencies": {
-    "@pantoken/angular": "0.1.30",
+    "@pantoken/angular": "0.1.31",
     "@pantoken/canvas-theme-editor": "0.2.0",
-    "@pantoken/components": "1.1.2",
-    "@pantoken/i18n-engine": "0.3.0",
+    "@pantoken/components": "1.1.3",
+    "@pantoken/i18n-engine": "0.3.1",
     "@pantoken/plugin-layouts": "0.3.0",
-    "@pantoken/react": "0.1.31",
+    "@pantoken/react": "0.1.32",
     "@pantoken/scaffold-base": "0.3.0",
-    "@pantoken/svelte": "0.1.31",
-    "@pantoken/vue": "0.1.31",
-    "@pantoken/web-components": "0.6.2",
-    "@types/node": "^26.5.0",
+    "@pantoken/svelte": "0.1.32",
+    "@pantoken/vue": "0.1.32",
+    "@pantoken/web-components": "0.6.3",
+    "@types/node": "^26.5.1",
     "bingo-stratum": "^0.5.13",
     "typescript": "^7.0.2",
     "vite": "npm:@voidzero-dev/vite-plus-core@0.3.1",