@a-company/paradigm 5.11.0 → 5.21.0

package/dist/chunk-JASGXLK3.js

@@ -1,679 +0,0 @@
-#!/usr/bin/env node
-import {
-  indexCommand
-} from "./chunk-VL67H5IC.js";
-import {
-  getDefaultPremiseContent
-} from "./chunk-ZGUAAVMA.js";
-import {
-  getDefaultPurposeContent
-} from "./chunk-EDOAWN7J.js";
-import {
-  STACK_PRESETS,
-  detectDiscipline,
-  detectStack,
-  getDisciplineConfig,
-  getStackConfig
-} from "./chunk-UPLDI7CN.js";
-import {
-  detectIDE,
-  loadParadigmFiles,
-  syncToIDE
-} from "./chunk-6N3JTACN.js";
-import {
-  log
-} from "./chunk-4NCFWYGG.js";
-
-// src/commands/init.ts
-import * as fs from "fs";
-import * as path from "path";
-import { fileURLToPath } from "url";
-import chalk from "chalk";
-import ora from "ora";
-function countLines(filePath) {
-  try {
-    const content = fs.readFileSync(filePath, "utf8");
-    return content.split("\n").length;
-  } catch {
-    return 0;
-  }
-}
-function detectProjectType(rootDir) {
-  const stackId = detectStack(rootDir);
-  if (stackId && STACK_PRESETS[stackId]) {
-    return STACK_PRESETS[stackId].name;
-  }
-  const discipline = detectDiscipline(rootDir);
-  if (discipline !== "backend") {
-    return discipline.charAt(0).toUpperCase() + discipline.slice(1);
-  }
-  return void 0;
-}
-function detectExistingIDEFiles(rootDir) {
-  const ides = [];
-  let totalLines = 0;
-  const cursorIDE = { name: "cursor", displayName: "Cursor" };
-  const cursorLegacy = path.join(rootDir, ".cursorrules");
-  const cursorModernDir = path.join(rootDir, ".cursor", "rules");
-  if (fs.existsSync(cursorLegacy)) {
-    const lines = countLines(cursorLegacy);
-    cursorIDE.legacy = { path: ".cursorrules", lines, type: "legacy" };
-    totalLines += lines;
-  }
-  if (fs.existsSync(cursorModernDir)) {
-    const files = fs.readdirSync(cursorModernDir).filter((f) => f.endsWith(".mdc"));
-    if (files.length > 0) {
-      cursorIDE.modern = files.map((f) => {
-        const fullPath = path.join(cursorModernDir, f);
-        const lines = countLines(fullPath);
-        totalLines += lines;
-        return { path: `.cursor/rules/${f}`, lines, type: "modern" };
-      });
-    }
-  }
-  if (cursorIDE.legacy || cursorIDE.modern) {
-    ides.push(cursorIDE);
-  }
-  const copilotIDE = { name: "copilot", displayName: "GitHub Copilot" };
-  const copilotLegacy = path.join(rootDir, ".github", "copilot-instructions.md");
-  const copilotModernDir = path.join(rootDir, ".github", "instructions");
-  if (fs.existsSync(copilotLegacy)) {
-    const lines = countLines(copilotLegacy);
-    copilotIDE.legacy = { path: ".github/copilot-instructions.md", lines, type: "legacy" };
-    totalLines += lines;
-  }
-  if (fs.existsSync(copilotModernDir)) {
-    const files = fs.readdirSync(copilotModernDir).filter((f) => f.endsWith(".md"));
-    if (files.length > 0) {
-      copilotIDE.modern = files.map((f) => {
-        const fullPath = path.join(copilotModernDir, f);
-        const lines = countLines(fullPath);
-        totalLines += lines;
-        return { path: `.github/instructions/${f}`, lines, type: "modern" };
-      });
-    }
-  }
-  if (copilotIDE.legacy || copilotIDE.modern) {
-    ides.push(copilotIDE);
-  }
-  const windsurfPath = path.join(rootDir, ".windsurfrules");
-  if (fs.existsSync(windsurfPath)) {
-    const lines = countLines(windsurfPath);
-    ides.push({
-      name: "windsurf",
-      displayName: "Windsurf",
-      legacy: { path: ".windsurfrules", lines, type: "legacy" }
-    });
-    totalLines += lines;
-  }
-  const claudePath = path.join(rootDir, "CLAUDE.md");
-  if (fs.existsSync(claudePath)) {
-    const lines = countLines(claudePath);
-    ides.push({
-      name: "claude",
-      displayName: "Claude",
-      legacy: { path: "CLAUDE.md", lines, type: "legacy" }
-    });
-    totalLines += lines;
-  }
-  const agentsPath = path.join(rootDir, "AGENTS.md");
-  if (fs.existsSync(agentsPath)) {
-    const lines = countLines(agentsPath);
-    ides.push({
-      name: "agents",
-      displayName: "AGENTS.md",
-      legacy: { path: "AGENTS.md", lines, type: "legacy" }
-    });
-    totalLines += lines;
-  }
-  const discipline = detectDiscipline(rootDir);
-  const stack = detectStack(rootDir);
-  return {
-    ides,
-    hasExisting: ides.length > 0,
-    totalLines,
-    projectType: detectProjectType(rootDir),
-    discipline: discipline !== "backend" ? discipline : void 0,
-    // Only show if non-fallback
-    stack: stack || void 0
-  };
-}
-function generateMigrationPrompt(detection, projectName) {
-  const lines = [];
-  lines.push("# Migrate IDE Instructions to Paradigm Format");
-  lines.push("");
-  lines.push("## Overview");
-  lines.push("");
-  lines.push(`Migrate existing IDE instruction files for **${projectName}** to Paradigm's managed, scoped format.`);
-  lines.push("");
-  lines.push("## Source Files Found");
-  lines.push("");
-  for (const ide of detection.ides) {
-    if (ide.legacy) {
-      lines.push(`- \`${ide.legacy.path}\` (${ide.legacy.lines} lines) - ${ide.displayName} ${ide.legacy.type} format`);
-    }
-    if (ide.modern) {
-      for (const file of ide.modern) {
-        lines.push(`- \`${file.path}\` (${file.lines} lines) - ${ide.displayName} modern format`);
-      }
-    }
-  }
-  lines.push("");
-  if (detection.ides.some((i) => i.name === "cursor")) {
-    lines.push("## Cursor Migration \u2192 `.cursor/rules/*.mdc`");
-    lines.push("");
-    lines.push("Split the existing `.cursorrules` into scoped `.mdc` files with YAML frontmatter:");
-    lines.push("");
-    lines.push("### File Structure");
-    lines.push("");
-    lines.push("```");
-    lines.push(".cursor/rules/");
-    lines.push("\u251C\u2500\u2500 project-core.mdc      # Always applies - project overview, architecture");
-    lines.push("\u251C\u2500\u2500 code-style.mdc        # globs: **/*.{ts,tsx,js,jsx} - naming, formatting");
-    lines.push("\u251C\u2500\u2500 components.mdc        # globs: **/components/**/* - component patterns");
-    lines.push("\u251C\u2500\u2500 api-patterns.mdc      # globs: **/api/**/* - API conventions");
-    lines.push("\u251C\u2500\u2500 testing.mdc           # globs: **/*.test.* - testing guidelines");
-    lines.push("\u2514\u2500\u2500 custom.mdc            # Any project-specific rules");
-    lines.push("```");
-    lines.push("");
-    lines.push("### Frontmatter Format");
-    lines.push("");
-    lines.push("```yaml");
-    lines.push("---");
-    lines.push("description: Brief description of what these rules cover");
-    lines.push('globs: "**/*.ts"           # File pattern (OR use alwaysApply)');
-    lines.push("alwaysApply: true          # Apply to all files (OR use globs)");
-    lines.push("---");
-    lines.push("```");
-    lines.push("");
-  }
-  if (detection.ides.some((i) => i.name === "copilot")) {
-    lines.push("## Copilot Migration \u2192 `.github/instructions/*.instructions.md`");
-    lines.push("");
-    lines.push("Split into scoped instruction files with `applyTo` frontmatter:");
-    lines.push("");
-    lines.push("### File Structure");
-    lines.push("");
-    lines.push("```");
-    lines.push(".github/");
-    lines.push("\u251C\u2500\u2500 copilot-instructions.md              # Always applies - core rules");
-    lines.push("\u2514\u2500\u2500 instructions/");
-    lines.push("    \u251C\u2500\u2500 typescript.instructions.md       # applyTo: **/*.ts");
-    lines.push("    \u251C\u2500\u2500 react.instructions.md            # applyTo: **/*.tsx");
-    lines.push("    \u251C\u2500\u2500 api.instructions.md              # applyTo: **/api/**");
-    lines.push("    \u2514\u2500\u2500 testing.instructions.md          # applyTo: **/*.test.*");
-    lines.push("```");
-    lines.push("");
-    lines.push("### Frontmatter Format");
-    lines.push("");
-    lines.push("```yaml");
-    lines.push("---");
-    lines.push('applyTo: "**/*.ts"');
-    lines.push("---");
-    lines.push("```");
-    lines.push("");
-  }
-  lines.push("## Migration Steps");
-  lines.push("");
-  lines.push("1. **Read each source file** and identify logical sections:");
-  lines.push("   - Project overview / architecture");
-  lines.push("   - Code style / naming conventions");
-  lines.push("   - Language-specific patterns");
-  lines.push("   - Framework-specific rules");
-  lines.push("   - Testing guidelines");
-  lines.push("   - API patterns");
-  lines.push("");
-  lines.push("2. **Create scoped target files** with appropriate frontmatter");
-  lines.push("");
-  lines.push("3. **Backup originals** by renaming to `.bak`:");
-  lines.push("   - `.cursorrules` \u2192 `.cursorrules.bak`");
-  lines.push("   - `.github/copilot-instructions.md` \u2192 `.github/copilot-instructions.md.bak`");
-  lines.push("");
-  lines.push("4. **Verify** the migration by checking that rules apply correctly");
-  lines.push("");
-  lines.push("## Tips");
-  lines.push("");
-  lines.push("- **Prefer specific globs** over `alwaysApply` when possible");
-  lines.push("- **Keep files focused** - one concern per file");
-  lines.push("- **Use descriptive names** that indicate the scope");
-  lines.push("- **Paradigm will generate its own rules** - keep custom rules separate");
-  lines.push("- After migration, run `paradigm sync` to add Paradigm-managed rules");
-  lines.push("");
-  lines.push("---");
-  lines.push("");
-  lines.push("*Generated by `paradigm init --migrate`*");
-  return lines.join("\n");
-}
-function getTemplatesDir() {
-  const __filename = fileURLToPath(import.meta.url);
-  const __dirname = path.dirname(__filename);
-  const possiblePaths = [
-    path.join(__dirname, "..", "..", "templates", "paradigm"),
-    path.join(__dirname, "..", "templates", "paradigm"),
-    path.join(__dirname, "..", "..", "src", "templates", "paradigm")
-  ];
-  for (const p of possiblePaths) {
-    if (fs.existsSync(p)) {
-      return p;
-    }
-  }
-  return path.join(__dirname, "..", "templates", "paradigm");
-}
-var MCP_SERVED_CONTENT = {
-  // Skip entire directories
-  directories: ["prompts"],
-  // Skip specific files (relative to .paradigm/)
-  files: [
-    "echoes.yaml",
-    "docs/commands.md",
-    "docs/queries.md",
-    "specs/disciplines.md",
-    "specs/scan.md",
-    "specs/context-tracking.md"
-  ]
-};
-function shouldSkipPath(relativePath) {
-  for (const dir of MCP_SERVED_CONTENT.directories) {
-    if (relativePath === dir || relativePath.startsWith(dir + "/")) {
-      return true;
-    }
-  }
-  if (MCP_SERVED_CONTENT.files.includes(relativePath)) {
-    return true;
-  }
-  return false;
-}
-function copyDir(src, dest, projectName, relativePath = "") {
-  if (!fs.existsSync(dest)) {
-    fs.mkdirSync(dest, { recursive: true });
-  }
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    const entryRelativePath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
-    if (shouldSkipPath(entryRelativePath)) {
-      continue;
-    }
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath, projectName, entryRelativePath);
-    } else {
-      let content = fs.readFileSync(srcPath, "utf8");
-      content = content.replace(/\{\{PROJECT_NAME\}\}/g, projectName);
-      fs.writeFileSync(destPath, content, "utf8");
-    }
-  }
-}
-function displayDetectionResults(detection, projectName) {
-  console.log(chalk.blue("\n\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510"));
-  console.log(chalk.blue("\u2502") + chalk.white.bold("  Welcome to Paradigm                            ") + chalk.blue("\u2502"));
-  console.log(chalk.blue("\u2502") + chalk.gray("  Let's set up your project                      ") + chalk.blue("\u2502"));
-  console.log(chalk.blue("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n"));
-  console.log(chalk.white("  \u{1F4C1} Project: ") + chalk.cyan(projectName) + (detection.projectType ? chalk.gray(` (${detection.projectType} detected)`) : ""));
-  if (detection.discipline) {
-    console.log(chalk.white("  \u{1F3AF} Discipline: ") + chalk.cyan(detection.discipline) + (detection.stack ? chalk.gray(` \u2192 stack: ${detection.stack}`) : ""));
-  }
-  console.log("");
-  if (detection.hasExisting) {
-    console.log(chalk.white("  \u{1F4C4} Found existing IDE instructions:\n"));
-    for (const ide of detection.ides) {
-      if (ide.legacy) {
-        console.log(chalk.green("     \u2713 ") + chalk.white(ide.legacy.path) + chalk.gray(` (${ide.legacy.lines} lines)`));
-      }
-      if (ide.modern) {
-        for (const file of ide.modern) {
-          console.log(chalk.green("     \u2713 ") + chalk.white(file.path) + chalk.gray(` (${file.lines} lines)`));
-        }
-      }
-    }
-    console.log("");
-    console.log(chalk.gray(`     Total: ${detection.totalLines} lines of existing instructions`));
-  } else {
-    console.log(chalk.gray("  \u{1F4C4} No existing IDE instructions found"));
-  }
-  console.log("");
-  console.log(chalk.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-  console.log("");
-}
-function displaySummary(targetIDE, detection) {
-  const outputFileMap = {
-    cursor: ".cursor/rules/",
-    copilot: ".github/instructions/",
-    windsurf: ".windsurfrules",
-    claude: "CLAUDE.md"
-  };
-  const outputFile = outputFileMap[targetIDE] || ".cursor/rules/";
-  console.log(chalk.blue("\n\u2728 Paradigm initialized!\n"));
-  console.log(chalk.white("  Created:"));
-  console.log(chalk.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-  console.log(chalk.white("  \u{1F4C1} .paradigm/"));
-  console.log(chalk.gray("     \u251C\u2500\u2500 config.yaml      Configuration"));
-  console.log(chalk.gray("     \u251C\u2500\u2500 specs/           Logger, symbols, context"));
-  console.log(chalk.gray("     \u2514\u2500\u2500 docs/            Patterns, troubleshooting"));
-  console.log(chalk.white("  \u{1F4C4} .premise             Project overview"));
-  console.log(chalk.white("  \u{1F4C4} .purpose             Feature context"));
-  console.log(chalk.white(`  \u{1F4C4} ${outputFile.padEnd(20)} IDE instructions`));
-  console.log("");
-  console.log(chalk.gray("  Reference content (prompts, commands, etc.) available via MCP"));
-  if (detection.hasExisting) {
-    console.log("");
-    console.log(chalk.yellow("  \u26A0  Your existing IDE files were preserved."));
-    console.log(chalk.gray("     Run `paradigm init --migrate` to get a migration prompt."));
-  }
-  console.log("");
-  console.log(chalk.white("  Next steps:"));
-  console.log(chalk.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-  console.log(chalk.white("  1. ") + chalk.gray("Review ") + chalk.cyan(".paradigm/config.yaml"));
-  console.log(chalk.white("  2. ") + chalk.gray("Edit ") + chalk.cyan(".purpose") + chalk.gray(" to define your features"));
-  console.log(chalk.white("  3. ") + chalk.gray("Run ") + chalk.cyan("paradigm beacon") + chalk.gray(" to generate AI context"));
-  console.log(chalk.white("  4. ") + chalk.gray("Run ") + chalk.cyan("paradigm doctor") + chalk.gray(" to verify setup"));
-  console.log(chalk.white("  5. ") + chalk.gray("Run ") + chalk.cyan("paradigm visualize") + chalk.gray(" to see your project"));
-  console.log("");
-}
-async function initCommand(options) {
-  const cwd = process.cwd();
-  const projectName = options.name || path.basename(cwd);
-  const spinner = ora();
-  const tracker = log.command("init").start("Initializing Paradigm", { project: projectName, quick: !!options.quick });
-  const detection = detectExistingIDEFiles(cwd);
-  log.operation("detect-ide").debug("IDE detection complete", { hasExisting: detection.hasExisting });
-  if (options.migrate) {
-    if (!detection.hasExisting) {
-      console.log(chalk.yellow("\n  No existing IDE instruction files found.\n"));
-      console.log(chalk.gray("  Run `paradigm init` to create a fresh setup.\n"));
-      return;
-    }
-    console.log(chalk.blue("\n  Migration Prompt\n"));
-    console.log(chalk.gray("  Copy the following prompt to an AI agent:\n"));
-    console.log(chalk.gray("  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n"));
-    console.log(generateMigrationPrompt(detection, projectName));
-    console.log(chalk.gray("\n  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n"));
-    return;
-  }
-  if (options.dryRun) {
-    displayDetectionResults(detection, projectName);
-    console.log(chalk.white("  Would create (dry run):"));
-    console.log(chalk.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-    console.log(chalk.cyan("  \u{1F4C1} .paradigm/"));
-    console.log(chalk.cyan("     \u251C\u2500\u2500 config.yaml"));
-    console.log(chalk.cyan("     \u251C\u2500\u2500 specs/"));
-    console.log(chalk.cyan("     \u2514\u2500\u2500 docs/"));
-    console.log(chalk.cyan("  \u{1F4C4} .premise"));
-    console.log(chalk.cyan("  \u{1F4C4} .purpose"));
-    console.log(chalk.cyan("  \u{1F4C1} .cursor/rules/*.mdc"));
-    console.log("");
-    console.log(chalk.gray("  Reference content (prompts, commands, etc.) served via MCP"));
-    console.log(chalk.gray("  Run without --dry-run to create these files.\n"));
-    return;
-  }
-  if (!options.quick) {
-    displayDetectionResults(detection, projectName);
-    if (detection.hasExisting && !options.force) {
-      console.log(chalk.white("  What would you like to do?\n"));
-      console.log(chalk.cyan("  paradigm init --migrate"));
-      console.log(chalk.gray("      Get an AI-ready prompt to convert your existing rules\n"));
-      console.log(chalk.cyan("  paradigm init --force"));
-      console.log(chalk.gray("      Create .paradigm/ alongside existing files\n"));
-      console.log(chalk.cyan("  paradigm init --dry-run"));
-      console.log(chalk.gray("      Preview what would be created\n"));
-    }
-  }
-  const templatesDir = getTemplatesDir();
-  const paradigmDir = path.join(cwd, ".paradigm");
-  if (fs.existsSync(paradigmDir)) {
-    const stat = fs.statSync(paradigmDir);
-    if (stat.isFile()) {
-      if (!options.force) {
-        console.log(chalk.yellow("  \u26A0 Legacy .paradigm file found."));
-        console.log(chalk.gray("    Run `paradigm upgrade --all` to migrate.\n"));
-        return;
-      }
-      fs.unlinkSync(paradigmDir);
-    } else if (stat.isDirectory() && !options.force) {
-      console.log(chalk.yellow("  \u26A0 .paradigm/ already exists (use --force to overwrite)\n"));
-      return;
-    }
-  }
-  spinner.start("Creating .paradigm/ directory...");
-  try {
-    if (!fs.existsSync(paradigmDir)) {
-      fs.mkdirSync(paradigmDir, { recursive: true });
-    }
-    if (fs.existsSync(templatesDir)) {
-      copyDir(templatesDir, paradigmDir, projectName);
-      if (!fs.existsSync(path.join(paradigmDir, "fixtures.yaml"))) {
-        createFixturesTemplate(paradigmDir);
-      }
-      applyDisciplineToConfig(paradigmDir, cwd, options.stack);
-      spinner.succeed(chalk.green(".paradigm/ created"));
-    } else {
-      spinner.warn(chalk.yellow("Templates not found, creating minimal structure"));
-      createMinimalStructure(paradigmDir, projectName);
-    }
-  } catch (error) {
-    spinner.fail(chalk.red(`Failed: ${error.message}`));
-    return;
-  }
-  const premisePath = path.join(cwd, ".premise");
-  if (!fs.existsSync(premisePath) || options.force) {
-    spinner.start("Creating .premise...");
-    fs.writeFileSync(premisePath, getDefaultPremiseContent(projectName));
-    spinner.succeed(chalk.green(".premise created"));
-  }
-  const purposePath = path.join(cwd, ".purpose");
-  if (!fs.existsSync(purposePath) || options.force) {
-    spinner.start("Creating .purpose...");
-    fs.writeFileSync(purposePath, getDefaultPurposeContent());
-    spinner.succeed(chalk.green(".purpose created"));
-  }
-  const portalPath = path.join(cwd, "portal.yaml");
-  if (!fs.existsSync(portalPath)) {
-    console.log(chalk.gray("  \u25CB No portal.yaml (optional - create manually if you need gate/auth definitions)"));
-    console.log(chalk.gray("    See: https://github.com/a-company/paradigm/blob/main/docs/guides/portals.md"));
-  }
-  let targetIDE;
-  if (options.ide) {
-    const validIDEs = ["cursor", "copilot", "windsurf", "claude"];
-    targetIDE = validIDEs.includes(options.ide.toLowerCase()) ? options.ide.toLowerCase() : "cursor";
-  } else {
-    spinner.start("Detecting IDE...");
-    const ideDetection = detectIDE(cwd);
-    targetIDE = ideDetection.detected || "cursor";
-    spinner.succeed(`Using ${chalk.cyan(targetIDE)}`);
-  }
-  const files = loadParadigmFiles(cwd);
-  if (files) {
-    spinner.start("Generating IDE instructions...");
-    const result = syncToIDE(cwd, targetIDE, files, true);
-    if (result.success) {
-      spinner.succeed(chalk.green(result.message || "IDE instructions generated"));
-    } else {
-      spinner.warn(chalk.yellow(result.message));
-    }
-  }
-  if (!options.quick) {
-    spinner.start("Creating scan index for MCP tools...");
-    try {
-      await indexCommand(cwd, { quiet: true });
-      spinner.succeed(chalk.green("Scan index created"));
-    } catch (error) {
-      spinner.warn(chalk.yellow("Could not create scan index: " + error.message));
-      console.log(chalk.gray("    Run `paradigm scan` manually after adding .purpose files"));
-    }
-  }
-  displaySummary(targetIDE, detection);
-  tracker.success("Paradigm initialized", { project: projectName, ide: targetIDE });
-}
-function applyDisciplineToConfig(paradigmDir, rootDir, explicitStack) {
-  const configPath = path.join(paradigmDir, "config.yaml");
-  if (!fs.existsSync(configPath)) return;
-  const discipline = detectDiscipline(rootDir);
-  if (discipline === "auto") return;
-  let content = fs.readFileSync(configPath, "utf8");
-  content = content.replace(
-    /^discipline:\s*auto\b.*$/m,
-    `discipline: ${discipline}`
-  );
-  const stackId = explicitStack || detectStack(rootDir);
-  const config = stackId ? getStackConfig(stackId) : getDisciplineConfig(discipline);
-  if (!config) {
-    let applyConfigToContent2 = function() {
-      const mappingLines2 = Object.entries(fallback.symbolMapping).map(([pattern, symbol]) => `    "${pattern}": "${symbol}"`).join("\n");
-      content = content.replace(
-        /  symbol-mapping:\n(?:(?:    .*| *)\n)*/,
-        `  symbol-mapping:
-${mappingLines2}
-`
-      );
-      const purposeLines2 = fallback.purposeRequired.map((pr) => `  - pattern: "${pr.pattern}"
-    depth: ${pr.depth}`).join("\n");
-      content = content.replace(
-        /purpose-required:\n(?:  - pattern:.*\n    depth:.*\n)*/,
-        `purpose-required:
-${purposeLines2}
-`
-      );
-      fs.writeFileSync(configPath, content, "utf8");
-    };
-    var applyConfigToContent = applyConfigToContent2;
-    const fallback = getDisciplineConfig(discipline);
-    applyConfigToContent2();
-    return;
-  }
-  if (stackId) {
-    content = content.replace(
-      /^(discipline:\s*.+)$/m,
-      `$1
-stack: ${stackId}`
-    );
-  }
-  const mappingLines = Object.entries(config.symbolMapping).map(([pattern, symbol]) => `    "${pattern}": "${symbol}"`).join("\n");
-  content = content.replace(
-    /  symbol-mapping:\n(?:(?:    .*| *)\n)*/,
-    `  symbol-mapping:
-${mappingLines}
-`
-  );
-  const purposeLines = config.purposeRequired.map((pr) => `  - pattern: "${pr.pattern}"
-    depth: ${pr.depth}`).join("\n");
-  content = content.replace(
-    /purpose-required:\n(?:  - pattern:.*\n    depth:.*\n)*/,
-    `purpose-required:
-${purposeLines}
-`
-  );
-  fs.writeFileSync(configPath, content, "utf8");
-}
-function createMinimalStructure(paradigmDir, projectName) {
-  fs.mkdirSync(path.join(paradigmDir, "specs"), { recursive: true });
-  fs.mkdirSync(path.join(paradigmDir, "docs"), { recursive: true });
-  fs.mkdirSync(path.join(paradigmDir, "tasks"), { recursive: true });
-  fs.mkdirSync(path.join(paradigmDir, "lore"), { recursive: true });
-  const minimalConfig = `# Paradigm Configuration
-version: "1.0"
-project: "${projectName}"
-
-agent-guidelines:
-  overview: |
-    This project uses Paradigm for structured AI-assisted development.
-    All context, symbols, and specifications live in the .paradigm/ directory.
-  how-to-use:
-    - "Check .paradigm/specs/ for philosophy and patterns before making changes"
-    - "Reference symbols using prefixes: #component ^gate !signal $flow ~aspect"
-    - "Use the Paradigm logger instead of raw console.log/print statements"
-    - "Check .paradigm/docs/ for command reference and troubleshooting"
-  update-rules:
-    - "When adding a feature, create/update the nearest .purpose file"
-    - "When adding authorization, update portal.yaml"
-    - "Always update references when renaming symbols"
-
-symbol-system:
-  "#":
-    name: Component
-    description: Any documented code unit (feature, service, module, integration)
-    examples: ["#checkout", "#login-handler", "#Button", "#stripe-client"]
-  "$":
-    name: Flow
-    description: Multi-step processes or user journeys
-    examples: ["$checkout-flow", "$onboarding", "$auth-flow"]
-  "^":
-    name: Gate
-    description: Access control points and authorization rules
-    examples: ["^authenticated", "^admin-only", "^rate-limited"]
-  "!":
-    name: Signal
-    description: Events emitted for side effects
-    examples: ["!login-success", "!payment-failed", "!rate-limited"]
-  "~":
-    name: Aspect
-    description: Cross-cutting rules with required code anchors
-    examples: ["~audit-required", "~rate-limited", "~cached"]
-
-logging:
-  enforce: true
-  default-level: debug
-
-conventions:
-  - "Use kebab-case for all symbol IDs (feature-name, not featureName)"
-  - "Document flows when logic spans 3+ components"
-  - "Reference related items using symbol prefixes (# $ ^ ! ~)"
-  - "Update .purpose files when changing feature behavior"
-  - "ALWAYS use Paradigm logger, NEVER raw console.log/print"
-`;
-  fs.writeFileSync(path.join(paradigmDir, "config.yaml"), minimalConfig, "utf8");
-  createFixturesTemplate(paradigmDir);
-}
-function createFixturesTemplate(paradigmDir) {
-  const fixturesTemplate = `# Test Fixtures for Flow Validation
-# Use with paradigm_test_fixtures MCP tool
-version: "1.0"
-
-# User fixtures for authentication testing
-users:
-  admin:
-    id: "user-admin"
-    email: "admin@test.com"
-    role: "admin"
-    token: "Bearer test-admin-token"
-  member:
-    id: "user-member"
-    email: "member@test.com"
-    role: "member"
-    token: "Bearer test-member-token"
-  outsider:
-    id: "user-outsider"
-    email: "outsider@test.com"
-    token: "Bearer test-outsider-token"
-
-# Resource fixtures for entity testing
-resources:
-  project:
-    id: "project-1"
-    name: "Test Project"
-    members: ["user-member"]
-    admins: ["user-admin"]
-  task:
-    id: "task-1"
-    projectId: "project-1"
-    title: "Sample Task"
-    assignees: ["user-member"]
-
-# Payload fixtures for API testing
-payloads:
-  createProject:
-    name: "New Project"
-    description: "Test project description"
-  createTask:
-    title: "New Task"
-    description: "Task description"
-    assignees: []
-  updateTask:
-    title: "Updated Task"
-    status: "in-progress"
-`;
-  fs.writeFileSync(path.join(paradigmDir, "fixtures.yaml"), fixturesTemplate, "utf8");
-}
-
-export {
-  initCommand
-};