safeword 0.6.3 → 0.6.5

package/dist/sync-4XBMKLXS.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/sync.ts"],"sourcesContent":["/**\n * Sync command - Keep linting plugins in sync with project dependencies\n *\n * Detects frameworks in package.json and ensures the corresponding ESLint plugins\n * are installed. Designed to be called from Husky pre-commit hook.\n *\n * Behavior:\n * - Fast exit when nothing needs to change\n * - Installs missing plugins\n * - Optionally stages modified files (--stage flag for pre-commit)\n * - Clear error message if installation fails\n */\n\nimport { join } from 'node:path';\nimport { execSync } from 'node:child_process';\nimport { exists, readJson } from '../utils/fs.js';\nimport { detectProjectType, type PackageJson, type ProjectType } from '../utils/project-detector.js';\n\nexport interface SyncOptions {\n  quiet?: boolean;\n  stage?: boolean;\n}\n\n/**\n * Maps project type flags to their required ESLint plugin packages\n */\nfunction getRequiredPlugins(projectType: ProjectType): string[] {\n  const plugins: string[] = [\n    // Always required (base plugins)\n    'eslint',\n    '@eslint/js',\n    'eslint-plugin-import-x',\n    'eslint-plugin-sonarjs',\n    '@microsoft/eslint-plugin-sdl',\n    'eslint-config-prettier',\n    'eslint-plugin-boundaries',\n    'eslint-plugin-playwright',\n  ];\n\n  // Framework plugins (detected at runtime by dynamic ESLint config)\n  if (projectType.typescript) {\n    plugins.push('typescript-eslint');\n  }\n  if (projectType.react || projectType.nextjs) {\n    plugins.push('eslint-plugin-react', 'eslint-plugin-react-hooks', 'eslint-plugin-jsx-a11y');\n  }\n  if (projectType.nextjs) {\n    plugins.push('@next/eslint-plugin-next');\n  }\n  if (projectType.astro) {\n    plugins.push('eslint-plugin-astro');\n  }\n  if (projectType.vue) {\n    plugins.push('eslint-plugin-vue');\n  }\n  if (projectType.svelte) {\n    plugins.push('eslint-plugin-svelte');\n  }\n  if (projectType.electron) {\n    plugins.push('@electron-toolkit/eslint-config');\n  }\n  if (projectType.vitest) {\n    plugins.push('@vitest/eslint-plugin');\n  }\n\n  return plugins;\n}\n\n/**\n * Check which packages are missing from devDependencies\n */\nfunction getMissingPackages(required: string[], installed: Record<string, string>): string[] {\n  return required.filter(pkg => !(pkg in installed));\n}\n\n/**\n * Sync linting configuration with current project dependencies\n */\nexport async function sync(options: SyncOptions = {}): Promise<void> {\n  const cwd = process.cwd();\n  const safewordDir = join(cwd, '.safeword');\n  const packageJsonPath = join(cwd, 'package.json');\n\n  // Must be in a safeword project\n  if (!exists(safewordDir)) {\n    if (!options.quiet) {\n      console.error('Not a safeword project. Run `safeword setup` first.');\n    }\n    process.exit(1);\n  }\n\n  if (!exists(packageJsonPath)) {\n    if (!options.quiet) {\n      console.error('No package.json found.');\n    }\n    process.exit(1);\n  }\n\n  const packageJson = readJson<PackageJson>(packageJsonPath);\n  if (!packageJson) {\n    process.exit(1);\n  }\n\n  // Detect current project type\n  const projectType = detectProjectType(packageJson);\n  const devDeps = packageJson.devDependencies || {};\n\n  // Check for missing plugins\n  const requiredPlugins = getRequiredPlugins(projectType);\n  const missingPlugins = getMissingPackages(requiredPlugins, devDeps);\n\n  // Fast exit if nothing to install\n  if (missingPlugins.length === 0) {\n    return;\n  }\n\n  // Install missing plugins\n  if (!options.quiet) {\n    console.log(`Installing missing ESLint plugins: ${missingPlugins.join(', ')}`);\n  }\n\n  try {\n    execSync(`npm install -D ${missingPlugins.join(' ')}`, {\n      cwd,\n      stdio: options.quiet ? 'pipe' : 'inherit',\n    });\n  } catch (error) {\n    // Clear error message for network/install failures\n    const pluginList = missingPlugins.join(' ');\n    console.error(`\\n✗ Failed to install ESLint plugins\\n`);\n    console.error(`Your project needs: ${pluginList}`);\n    console.error(`\\nRun manually when online:`);\n    console.error(`  npm install -D ${pluginList}\\n`);\n    process.exit(1);\n  }\n\n  // Stage modified files if --stage flag is set (for pre-commit hook)\n  if (options.stage) {\n    try {\n      execSync('git add package.json package-lock.json', {\n        cwd,\n        stdio: 'pipe',\n      });\n    } catch {\n      // Not in a git repo or git add failed - ignore\n    }\n  }\n\n  if (!options.quiet) {\n    console.log(`✓ Installed ${missingPlugins.length} ESLint plugin(s)`);\n  }\n}\n"],"mappings":";;;;;;;;;AAaA,SAAS,YAAY;AACrB,SAAS,gBAAgB;AAYzB,SAAS,mBAAmB,aAAoC;AAC9D,QAAM,UAAoB;AAAA;AAAA,IAExB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAGA,MAAI,YAAY,YAAY;AAC1B,YAAQ,KAAK,mBAAmB;AAAA,EAClC;AACA,MAAI,YAAY,SAAS,YAAY,QAAQ;AAC3C,YAAQ,KAAK,uBAAuB,6BAA6B,wBAAwB;AAAA,EAC3F;AACA,MAAI,YAAY,QAAQ;AACtB,YAAQ,KAAK,0BAA0B;AAAA,EACzC;AACA,MAAI,YAAY,OAAO;AACrB,YAAQ,KAAK,qBAAqB;AAAA,EACpC;AACA,MAAI,YAAY,KAAK;AACnB,YAAQ,KAAK,mBAAmB;AAAA,EAClC;AACA,MAAI,YAAY,QAAQ;AACtB,YAAQ,KAAK,sBAAsB;AAAA,EACrC;AACA,MAAI,YAAY,UAAU;AACxB,YAAQ,KAAK,iCAAiC;AAAA,EAChD;AACA,MAAI,YAAY,QAAQ;AACtB,YAAQ,KAAK,uBAAuB;AAAA,EACtC;AAEA,SAAO;AACT;AAKA,SAAS,mBAAmB,UAAoB,WAA6C;AAC3F,SAAO,SAAS,OAAO,SAAO,EAAE,OAAO,UAAU;AACnD;AAKA,eAAsB,KAAK,UAAuB,CAAC,GAAkB;AACnE,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,cAAc,KAAK,KAAK,WAAW;AACzC,QAAM,kBAAkB,KAAK,KAAK,cAAc;AAGhD,MAAI,CAAC,OAAO,WAAW,GAAG;AACxB,QAAI,CAAC,QAAQ,OAAO;AAClB,cAAQ,MAAM,qDAAqD;AAAA,IACrE;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI,CAAC,OAAO,eAAe,GAAG;AAC5B,QAAI,CAAC,QAAQ,OAAO;AAClB,cAAQ,MAAM,wBAAwB;AAAA,IACxC;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,cAAc,SAAsB,eAAe;AACzD,MAAI,CAAC,aAAa;AAChB,YAAQ,KAAK,CAAC;AAAA,EAChB;AAGA,QAAM,cAAc,kBAAkB,WAAW;AACjD,QAAM,UAAU,YAAY,mBAAmB,CAAC;AAGhD,QAAM,kBAAkB,mBAAmB,WAAW;AACtD,QAAM,iBAAiB,mBAAmB,iBAAiB,OAAO;AAGlE,MAAI,eAAe,WAAW,GAAG;AAC/B;AAAA,EACF;AAGA,MAAI,CAAC,QAAQ,OAAO;AAClB,YAAQ,IAAI,sCAAsC,eAAe,KAAK,IAAI,CAAC,EAAE;AAAA,EAC/E;AAEA,MAAI;AACF,aAAS,kBAAkB,eAAe,KAAK,GAAG,CAAC,IAAI;AAAA,MACrD;AAAA,MACA,OAAO,QAAQ,QAAQ,SAAS;AAAA,IAClC,CAAC;AAAA,EACH,SAAS,OAAO;AAEd,UAAM,aAAa,eAAe,KAAK,GAAG;AAC1C,YAAQ,MAAM;AAAA;AAAA,CAAwC;AACtD,YAAQ,MAAM,uBAAuB,UAAU,EAAE;AACjD,YAAQ,MAAM;AAAA,0BAA6B;AAC3C,YAAQ,MAAM,oBAAoB,UAAU;AAAA,CAAI;AAChD,YAAQ,KAAK,CAAC;AAAA,EAChB;AAGA,MAAI,QAAQ,OAAO;AACjB,QAAI;AACF,eAAS,0CAA0C;AAAA,QACjD;AAAA,QACA,OAAO;AAAA,MACT,CAAC;AAAA,IACH,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,MAAI,CAAC,QAAQ,OAAO;AAClB,YAAQ,IAAI,oBAAe,eAAe,MAAM,mBAAmB;AAAA,EACrE;AACF;","names":[]}

package/dist/upgrade-P3WX3ODU.js

@@ -1,153 +0,0 @@
-import {
-  isGitRepo
-} from "./chunk-75FKNZUM.js";
-import {
-  compareVersions
-} from "./chunk-W66Z3C5H.js";
-import {
-  VERSION
-} from "./chunk-ORQHKDT2.js";
-import {
-  SETTINGS_HOOKS,
-  ensureAgentsMdLink,
-  filterOutSafewordHooks
-} from "./chunk-IWWBZVHT.js";
-import {
-  error,
-  header,
-  info,
-  listItem,
-  success
-} from "./chunk-FRPJITGG.js";
-import {
-  copyDir,
-  copyFile,
-  ensureDir,
-  exists,
-  getTemplatesDir,
-  makeScriptsExecutable,
-  readFileSafe,
-  updateJson,
-  writeFile
-} from "./chunk-ARIAOK2F.js";
-
-// src/commands/upgrade.ts
-import { join } from "path";
-import { execSync } from "child_process";
-async function upgrade() {
-  const cwd = process.cwd();
-  const safewordDir = join(cwd, ".safeword");
-  if (!exists(safewordDir)) {
-    error("Not configured. Run `safeword setup` first.");
-    process.exit(1);
-  }
-  const versionPath = join(safewordDir, "version");
-  const projectVersion = readFileSafe(versionPath)?.trim() ?? "0.0.0";
-  if (compareVersions(VERSION, projectVersion) < 0) {
-    error(`CLI v${VERSION} is older than project v${projectVersion}.`);
-    error("Update the CLI first: npm install -g safeword");
-    process.exit(1);
-  }
-  header("Safeword Upgrade");
-  info(`Upgrading from v${projectVersion} to v${VERSION}`);
-  const updated = [];
-  const unchanged = [];
-  try {
-    const templatesDir = getTemplatesDir();
-    info("\nUpdating .safeword directory...");
-    copyFile(join(templatesDir, "SAFEWORD.md"), join(safewordDir, "SAFEWORD.md"));
-    writeFile(join(safewordDir, "version"), VERSION);
-    updated.push(".safeword/SAFEWORD.md");
-    updated.push(".safeword/version");
-    copyDir(join(templatesDir, "guides"), join(safewordDir, "guides"));
-    copyDir(join(templatesDir, "doc-templates"), join(safewordDir, "templates"));
-    copyDir(join(templatesDir, "prompts"), join(safewordDir, "prompts"));
-    copyDir(join(templatesDir, "lib"), join(safewordDir, "lib"));
-    makeScriptsExecutable(join(safewordDir, "lib"));
-    copyDir(join(templatesDir, "hooks"), join(safewordDir, "hooks"));
-    makeScriptsExecutable(join(safewordDir, "hooks"));
-    updated.push(".safeword/guides/");
-    updated.push(".safeword/templates/");
-    updated.push(".safeword/prompts/");
-    updated.push(".safeword/hooks/");
-    success("Updated .safeword directory");
-    info("\nVerifying AGENTS.md...");
-    const agentsMdResult = ensureAgentsMdLink(cwd);
-    if (agentsMdResult === "created") {
-      updated.push("AGENTS.md");
-      success("Created AGENTS.md");
-    } else if (agentsMdResult === "modified") {
-      updated.push("AGENTS.md");
-      success("Restored link to AGENTS.md");
-    } else {
-      unchanged.push("AGENTS.md");
-      info("AGENTS.md link is present");
-    }
-    info("\nUpdating Claude Code hooks...");
-    const claudeDir = join(cwd, ".claude");
-    const settingsPath = join(claudeDir, "settings.json");
-    ensureDir(claudeDir);
-    updateJson(settingsPath, (existing) => {
-      const hooks = existing?.hooks ?? {};
-      for (const [event, newHooks] of Object.entries(SETTINGS_HOOKS)) {
-        const existingHooks = hooks[event] ?? [];
-        const nonSafewordHooks = filterOutSafewordHooks(existingHooks);
-        hooks[event] = [...nonSafewordHooks, ...newHooks];
-      }
-      return { ...existing, hooks };
-    });
-    updated.push(".claude/settings.json");
-    success("Updated hooks in .claude/settings.json");
-    info("\nUpdating skills and commands...");
-    copyDir(join(templatesDir, "skills"), join(claudeDir, "skills"));
-    copyDir(join(templatesDir, "commands"), join(claudeDir, "commands"));
-    updated.push(".claude/skills/");
-    updated.push(".claude/commands/");
-    success("Updated skills and commands");
-    if (isGitRepo(cwd)) {
-      const huskyDir = join(cwd, ".husky");
-      if (exists(huskyDir)) {
-        info("\nUpdating Husky pre-commit hook...");
-        const huskyPreCommit = join(huskyDir, "pre-commit");
-        writeFile(huskyPreCommit, "npx lint-staged\n");
-        updated.push(".husky/pre-commit");
-        success("Updated Husky pre-commit hook");
-      } else {
-        info("\nInitializing Husky...");
-        try {
-          execSync("npx husky init", { cwd, stdio: "pipe" });
-          const huskyPreCommit = join(cwd, ".husky", "pre-commit");
-          writeFile(huskyPreCommit, "npx lint-staged\n");
-          updated.push(".husky/pre-commit");
-          success("Initialized Husky with lint-staged");
-        } catch {
-          info("Husky not initialized (run: npx husky init)");
-        }
-      }
-    }
-    header("Upgrade Complete");
-    info(`
-Version: v${projectVersion} \u2192 v${VERSION}`);
-    if (updated.length > 0) {
-      info("\nUpdated:");
-      for (const file of updated) {
-        listItem(file);
-      }
-    }
-    if (unchanged.length > 0) {
-      info("\nUnchanged:");
-      for (const file of unchanged) {
-        listItem(file);
-      }
-    }
-    success(`
-Safeword upgraded to v${VERSION}`);
-  } catch (err) {
-    error(`Upgrade failed: ${err instanceof Error ? err.message : "Unknown error"}`);
-    process.exit(1);
-  }
-}
-export {
-  upgrade
-};
-//# sourceMappingURL=upgrade-P3WX3ODU.js.map

package/dist/upgrade-P3WX3ODU.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/upgrade.ts"],"sourcesContent":["/**\n * Upgrade command - Update safeword configuration to latest version\n */\n\nimport { join } from 'node:path';\nimport { VERSION } from '../version.js';\nimport {\n  exists,\n  ensureDir,\n  writeFile,\n  readFileSafe,\n  updateJson,\n  copyDir,\n  copyFile,\n  getTemplatesDir,\n  makeScriptsExecutable,\n} from '../utils/fs.js';\nimport { info, success, error, header, listItem } from '../utils/output.js';\nimport { isGitRepo } from '../utils/git.js';\nimport { execSync } from 'node:child_process';\nimport { compareVersions } from '../utils/version.js';\nimport { filterOutSafewordHooks } from '../utils/hooks.js';\nimport { ensureAgentsMdLink } from '../utils/agents-md.js';\nimport { SETTINGS_HOOKS } from '../templates/index.js';\n\nexport async function upgrade(): Promise<void> {\n  const cwd = process.cwd();\n  const safewordDir = join(cwd, '.safeword');\n\n  // Check if configured\n  if (!exists(safewordDir)) {\n    error('Not configured. Run `safeword setup` first.');\n    process.exit(1);\n  }\n\n  // Read project version\n  const versionPath = join(safewordDir, 'version');\n  const projectVersion = readFileSafe(versionPath)?.trim() ?? '0.0.0';\n\n  // Check for downgrade\n  if (compareVersions(VERSION, projectVersion) < 0) {\n    error(`CLI v${VERSION} is older than project v${projectVersion}.`);\n    error('Update the CLI first: npm install -g safeword');\n    process.exit(1);\n  }\n\n  header('Safeword Upgrade');\n  info(`Upgrading from v${projectVersion} to v${VERSION}`);\n\n  const updated: string[] = [];\n  const unchanged: string[] = [];\n\n  try {\n    const templatesDir = getTemplatesDir();\n\n    // 1. Update .safeword directory\n    info('\\nUpdating .safeword directory...');\n\n    // Update core files from templates\n    copyFile(join(templatesDir, 'SAFEWORD.md'), join(safewordDir, 'SAFEWORD.md'));\n    writeFile(join(safewordDir, 'version'), VERSION);\n    updated.push('.safeword/SAFEWORD.md');\n    updated.push('.safeword/version');\n\n    // Update guides, templates, prompts from templates\n    copyDir(join(templatesDir, 'guides'), join(safewordDir, 'guides'));\n    copyDir(join(templatesDir, 'doc-templates'), join(safewordDir, 'templates'));\n    copyDir(join(templatesDir, 'prompts'), join(safewordDir, 'prompts'));\n\n    // Update lib scripts and make executable\n    copyDir(join(templatesDir, 'lib'), join(safewordDir, 'lib'));\n    makeScriptsExecutable(join(safewordDir, 'lib'));\n\n    // Update hook scripts and make executable\n    copyDir(join(templatesDir, 'hooks'), join(safewordDir, 'hooks'));\n    makeScriptsExecutable(join(safewordDir, 'hooks'));\n\n    updated.push('.safeword/guides/');\n    updated.push('.safeword/templates/');\n    updated.push('.safeword/prompts/');\n    updated.push('.safeword/hooks/');\n    success('Updated .safeword directory');\n\n    // 2. Verify AGENTS.md link\n    info('\\nVerifying AGENTS.md...');\n    const agentsMdResult = ensureAgentsMdLink(cwd);\n    if (agentsMdResult === 'created') {\n      updated.push('AGENTS.md');\n      success('Created AGENTS.md');\n    } else if (agentsMdResult === 'modified') {\n      updated.push('AGENTS.md');\n      success('Restored link to AGENTS.md');\n    } else {\n      unchanged.push('AGENTS.md');\n      info('AGENTS.md link is present');\n    }\n\n    // 3. Update Claude Code hooks\n    info('\\nUpdating Claude Code hooks...');\n\n    const claudeDir = join(cwd, '.claude');\n    const settingsPath = join(claudeDir, 'settings.json');\n\n    ensureDir(claudeDir);\n\n    updateJson<{ hooks?: Record<string, unknown[]> }>(settingsPath, existing => {\n      const hooks = existing?.hooks ?? {};\n\n      // Merge hooks, preserving existing non-safeword hooks\n      for (const [event, newHooks] of Object.entries(SETTINGS_HOOKS)) {\n        const existingHooks = (hooks[event] as unknown[]) ?? [];\n        const nonSafewordHooks = filterOutSafewordHooks(existingHooks);\n        hooks[event] = [...nonSafewordHooks, ...newHooks];\n      }\n\n      return { ...existing, hooks };\n    });\n\n    updated.push('.claude/settings.json');\n    success('Updated hooks in .claude/settings.json');\n\n    // 4. Update skills and commands\n    info('\\nUpdating skills and commands...');\n\n    copyDir(join(templatesDir, 'skills'), join(claudeDir, 'skills'));\n    copyDir(join(templatesDir, 'commands'), join(claudeDir, 'commands'));\n\n    updated.push('.claude/skills/');\n    updated.push('.claude/commands/');\n    success('Updated skills and commands');\n\n    // 5. Update Husky hooks if repo exists\n    if (isGitRepo(cwd)) {\n      const huskyDir = join(cwd, '.husky');\n      if (exists(huskyDir)) {\n        info('\\nUpdating Husky pre-commit hook...');\n        const huskyPreCommit = join(huskyDir, 'pre-commit');\n        writeFile(huskyPreCommit, 'npx lint-staged\\n');\n        updated.push('.husky/pre-commit');\n        success('Updated Husky pre-commit hook');\n      } else {\n        // Initialize Husky if not present\n        info('\\nInitializing Husky...');\n        try {\n          execSync('npx husky init', { cwd, stdio: 'pipe' });\n          const huskyPreCommit = join(cwd, '.husky', 'pre-commit');\n          writeFile(huskyPreCommit, 'npx lint-staged\\n');\n          updated.push('.husky/pre-commit');\n          success('Initialized Husky with lint-staged');\n        } catch {\n          info('Husky not initialized (run: npx husky init)');\n        }\n      }\n    }\n\n    // Print summary\n    header('Upgrade Complete');\n\n    info(`\\nVersion: v${projectVersion} → v${VERSION}`);\n\n    if (updated.length > 0) {\n      info('\\nUpdated:');\n      for (const file of updated) {\n        listItem(file);\n      }\n    }\n\n    if (unchanged.length > 0) {\n      info('\\nUnchanged:');\n      for (const file of unchanged) {\n        listItem(file);\n      }\n    }\n\n    success(`\\nSafeword upgraded to v${VERSION}`);\n  } catch (err) {\n    error(`Upgrade failed: ${err instanceof Error ? err.message : 'Unknown error'}`);\n    process.exit(1);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,SAAS,YAAY;AAerB,SAAS,gBAAgB;AAMzB,eAAsB,UAAyB;AAC7C,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,cAAc,KAAK,KAAK,WAAW;AAGzC,MAAI,CAAC,OAAO,WAAW,GAAG;AACxB,UAAM,6CAA6C;AACnD,YAAQ,KAAK,CAAC;AAAA,EAChB;AAGA,QAAM,cAAc,KAAK,aAAa,SAAS;AAC/C,QAAM,iBAAiB,aAAa,WAAW,GAAG,KAAK,KAAK;AAG5D,MAAI,gBAAgB,SAAS,cAAc,IAAI,GAAG;AAChD,UAAM,QAAQ,OAAO,2BAA2B,cAAc,GAAG;AACjE,UAAM,+CAA+C;AACrD,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,SAAO,kBAAkB;AACzB,OAAK,mBAAmB,cAAc,QAAQ,OAAO,EAAE;AAEvD,QAAM,UAAoB,CAAC;AAC3B,QAAM,YAAsB,CAAC;AAE7B,MAAI;AACF,UAAM,eAAe,gBAAgB;AAGrC,SAAK,mCAAmC;AAGxC,aAAS,KAAK,cAAc,aAAa,GAAG,KAAK,aAAa,aAAa,CAAC;AAC5E,cAAU,KAAK,aAAa,SAAS,GAAG,OAAO;AAC/C,YAAQ,KAAK,uBAAuB;AACpC,YAAQ,KAAK,mBAAmB;AAGhC,YAAQ,KAAK,cAAc,QAAQ,GAAG,KAAK,aAAa,QAAQ,CAAC;AACjE,YAAQ,KAAK,cAAc,eAAe,GAAG,KAAK,aAAa,WAAW,CAAC;AAC3E,YAAQ,KAAK,cAAc,SAAS,GAAG,KAAK,aAAa,SAAS,CAAC;AAGnE,YAAQ,KAAK,cAAc,KAAK,GAAG,KAAK,aAAa,KAAK,CAAC;AAC3D,0BAAsB,KAAK,aAAa,KAAK,CAAC;AAG9C,YAAQ,KAAK,cAAc,OAAO,GAAG,KAAK,aAAa,OAAO,CAAC;AAC/D,0BAAsB,KAAK,aAAa,OAAO,CAAC;AAEhD,YAAQ,KAAK,mBAAmB;AAChC,YAAQ,KAAK,sBAAsB;AACnC,YAAQ,KAAK,oBAAoB;AACjC,YAAQ,KAAK,kBAAkB;AAC/B,YAAQ,6BAA6B;AAGrC,SAAK,0BAA0B;AAC/B,UAAM,iBAAiB,mBAAmB,GAAG;AAC7C,QAAI,mBAAmB,WAAW;AAChC,cAAQ,KAAK,WAAW;AACxB,cAAQ,mBAAmB;AAAA,IAC7B,WAAW,mBAAmB,YAAY;AACxC,cAAQ,KAAK,WAAW;AACxB,cAAQ,4BAA4B;AAAA,IACtC,OAAO;AACL,gBAAU,KAAK,WAAW;AAC1B,WAAK,2BAA2B;AAAA,IAClC;AAGA,SAAK,iCAAiC;AAEtC,UAAM,YAAY,KAAK,KAAK,SAAS;AACrC,UAAM,eAAe,KAAK,WAAW,eAAe;AAEpD,cAAU,SAAS;AAEnB,eAAkD,cAAc,cAAY;AAC1E,YAAM,QAAQ,UAAU,SAAS,CAAC;AAGlC,iBAAW,CAAC,OAAO,QAAQ,KAAK,OAAO,QAAQ,cAAc,GAAG;AAC9D,cAAM,gBAAiB,MAAM,KAAK,KAAmB,CAAC;AACtD,cAAM,mBAAmB,uBAAuB,aAAa;AAC7D,cAAM,KAAK,IAAI,CAAC,GAAG,kBAAkB,GAAG,QAAQ;AAAA,MAClD;AAEA,aAAO,EAAE,GAAG,UAAU,MAAM;AAAA,IAC9B,CAAC;AAED,YAAQ,KAAK,uBAAuB;AACpC,YAAQ,wCAAwC;AAGhD,SAAK,mCAAmC;AAExC,YAAQ,KAAK,cAAc,QAAQ,GAAG,KAAK,WAAW,QAAQ,CAAC;AAC/D,YAAQ,KAAK,cAAc,UAAU,GAAG,KAAK,WAAW,UAAU,CAAC;AAEnE,YAAQ,KAAK,iBAAiB;AAC9B,YAAQ,KAAK,mBAAmB;AAChC,YAAQ,6BAA6B;AAGrC,QAAI,UAAU,GAAG,GAAG;AAClB,YAAM,WAAW,KAAK,KAAK,QAAQ;AACnC,UAAI,OAAO,QAAQ,GAAG;AACpB,aAAK,qCAAqC;AAC1C,cAAM,iBAAiB,KAAK,UAAU,YAAY;AAClD,kBAAU,gBAAgB,mBAAmB;AAC7C,gBAAQ,KAAK,mBAAmB;AAChC,gBAAQ,+BAA+B;AAAA,MACzC,OAAO;AAEL,aAAK,yBAAyB;AAC9B,YAAI;AACF,mBAAS,kBAAkB,EAAE,KAAK,OAAO,OAAO,CAAC;AACjD,gBAAM,iBAAiB,KAAK,KAAK,UAAU,YAAY;AACvD,oBAAU,gBAAgB,mBAAmB;AAC7C,kBAAQ,KAAK,mBAAmB;AAChC,kBAAQ,oCAAoC;AAAA,QAC9C,QAAQ;AACN,eAAK,6CAA6C;AAAA,QACpD;AAAA,MACF;AAAA,IACF;AAGA,WAAO,kBAAkB;AAEzB,SAAK;AAAA,YAAe,cAAc,YAAO,OAAO,EAAE;AAElD,QAAI,QAAQ,SAAS,GAAG;AACtB,WAAK,YAAY;AACjB,iBAAW,QAAQ,SAAS;AAC1B,iBAAS,IAAI;AAAA,MACf;AAAA,IACF;AAEA,QAAI,UAAU,SAAS,GAAG;AACxB,WAAK,cAAc;AACnB,iBAAW,QAAQ,WAAW;AAC5B,iBAAS,IAAI;AAAA,MACf;AAAA,IACF;AAEA,YAAQ;AAAA,wBAA2B,OAAO,EAAE;AAAA,EAC9C,SAAS,KAAK;AACZ,UAAM,mBAAmB,eAAe,QAAQ,IAAI,UAAU,eAAe,EAAE;AAC/E,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}

package/templates/guides/llm-prompting.md

@@ -1,102 +0,0 @@
-# LLM Prompting Best Practices
-
-This guide covers two related topics:
-
-**Part 1: Prompting LLMs** - How to structure prompts when actively using an LLM (API calls, chat interactions)
-
-**Part 2: Writing Instructions for LLMs** - How to write documentation that LLMs will read and follow (SAFEWORD.md, CLAUDE.md, testing guides, coding standards)
-
----
-
-## Part 1: Prompting LLMs
-
-### Prompt Engineering Principles
-
-**Concrete Examples Over Abstract Rules:**
-
-- ✅ Good: Show "❌ BAD" vs "✅ GOOD" code examples
-- ❌ Bad: "Follow best practices" (too vague)
-
-**"Why" Over "What":**
-
-- Explain architectural trade-offs and reasoning
-- Include specific numbers (90% cost reduction, 3x faster)
-- Document gotchas with explanations
-
-**Structured Outputs:**
-
-- Use JSON mode for predictable LLM responses
-- Define explicit schemas with validation
-- Return structured data, not prose
-
-```typescript
-// ❌ BAD - Prose output
-"The user wants to create a campaign named 'Shadows' with 4 players"
-
-// ✅ GOOD - Structured JSON
-{ "intent": "create_campaign", "name": "Shadows", "playerCount": 4 }
-```
-
-### Cost Optimization
-
-**Prompt Caching (Critical for AI Agents):**
-
-- Static rules → System prompt with cache_control: ephemeral (caches for ~5 min, auto-expires)
-- Dynamic data (character state, user input) → User message (no caching)
-- Example: 468-line prompt costs $0.10 without caching, $0.01 with (90% reduction)
-- Cache invalidation: ANY change to cached blocks breaks ALL caches
-- Rule: Change system prompts sparingly; accept one-time cache rebuild cost
-
-**Message Architecture:**
-
-```typescript
-// ✅ GOOD - Cacheable system prompt
-systemPrompt: [
-  { text: STATIC_RULES, cache_control: { type: 'ephemeral' } },
-  { text: STATIC_EXAMPLES, cache_control: { type: 'ephemeral' } },
-];
-userMessage: `Character: ${dynamicState}\nAction: ${userInput}`;
-
-// ❌ BAD - Uncacheable (character state in system prompt)
-systemPrompt: `Rules + Character: ${dynamicState}`;
-```
-
-### Testing AI Outputs
-
-**LLM-as-Judge Pattern:**
-
-- Use LLM to evaluate nuanced qualities (narrative tone, reasoning quality)
-- Avoid brittle keyword matching for creative outputs
-- Define rubrics: EXCELLENT / ACCEPTABLE / POOR with criteria
-- Example: "Does the GM's response show collaborative tone?" vs checking for specific words
-
-**Evaluation Framework:**
-
-- Unit tests: Pure functions (parsing, validation)
-- Integration tests: Agent + real LLM calls (schema compliance)
-- LLM Evals: Judgment quality (position/effect reasoning, atmosphere)
-- Cost awareness: 30 scenarios ≈ $0.15-0.30 per run with caching
-
----
-
-## Part 2: Writing Instructions for LLMs
-
-**Comprehensive framework:** See @.safeword/guides/llm-instruction-design.md
-
-**Quick summary:** When creating documentation that LLMs will read and follow (SAFEWORD.md, CLAUDE.md, testing guides, coding standards), apply 13 core principles:
-
-1. **MECE Principle** - Decision trees must be mutually exclusive and collectively exhaustive
-2. **Explicit Over Implicit** - Define all terms, never assume LLMs know what you mean
-3. **No Contradictions** - Different sections must align, LLMs don't reconcile conflicts
-4. **Concrete Examples Over Abstract Rules** - Show, don't just tell (2-3 examples per rule)
-5. **Edge Cases Must Be Explicit** - What seems obvious to humans often isn't to LLMs
-6. **Actionable Over Vague** - Replace subjective terms with optimization rules + red flags
-7. **Decision Trees: Sequential Over Parallel** - Ordered steps that stop at first match
-8. **Tie-Breaking Rules** - Tell LLMs how to choose when multiple options apply
-9. **Lookup Tables for Complex Decisions** - Provide reference tables for complex logic
-10. **Avoid Caveats in Tables** - Keep patterns clean, parentheticals break LLM pattern matching
-11. **Percentages: Context or None** - Include adjustment guidance or use principles instead
-12. **Specificity in Questions** - Use precise technical terms, not general descriptions
-13. **Re-evaluation Paths** - Provide concrete next steps when LLMs hit dead ends
-
-**Also includes:** Anti-patterns to avoid, quality checklist, research-backed principles, and before/after examples.