@qlucent/fishi 0.7.0 → 0.9.0

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { Command } from "commander";
-import chalk9 from "chalk";
+import chalk12 from "chalk";
 
 // src/commands/init.ts
 import chalk from "chalk";
@@ -1970,11 +1970,297 @@ async function sandboxCommand(action) {
   }
 }
 
+// src/commands/quickstart.ts
+import chalk9 from "chalk";
+import ora2 from "ora";
+import path11 from "path";
+import fs11 from "fs";
+import { detectDevServer, startDevServer, getVibeModeConfig } from "@qlucent/fishi-core";
+import { detectConflicts as detectConflicts2, createBackup as createBackup2 } from "@qlucent/fishi-core";
+import { detectDocker as detectDocker3 } from "@qlucent/fishi-core";
+async function quickstartCommand(description, options) {
+  const targetDir = process.cwd();
+  const projectName = path11.basename(targetDir);
+  console.log("");
+  console.log(chalk9.cyan.bold("  FISHI \u2014 Vibe Mode"));
+  console.log(chalk9.gray("  Skip the ceremony, start shipping"));
+  console.log("");
+  if (fs11.existsSync(path11.join(targetDir, ".fishi"))) {
+    console.log(chalk9.yellow("  FISHI already initialized. Starting dev server only..."));
+    const serverConfig2 = detectDevServer(targetDir, options.devCmd);
+    if (serverConfig2.detected) {
+      console.log(chalk9.green(`  Starting ${serverConfig2.framework} dev server on :${serverConfig2.port}...`));
+      const child = startDevServer(targetDir, serverConfig2);
+      child.stdout?.on("data", (d) => process.stdout.write(d));
+      child.stderr?.on("data", (d) => process.stderr.write(d));
+      child.on("close", (code) => process.exit(code || 0));
+      return;
+    }
+    console.log(chalk9.yellow("  Could not detect dev server. Use --dev-cmd to specify."));
+    return;
+  }
+  const spinner = ora2("Analyzing project...").start();
+  const detection = await detectProjectType(targetDir);
+  spinner.succeed(`Project type: ${chalk9.bold(detection.type)}`);
+  let brownfieldAnalysis = null;
+  if (detection.type === "brownfield" || detection.type === "hybrid") {
+    const analysisSpinner = ora2("Running brownfield analysis...").start();
+    brownfieldAnalysis = await runBrownfieldAnalysis(targetDir);
+    analysisSpinner.succeed("Brownfield analysis complete");
+  }
+  const conflictResult = detectConflicts2(targetDir);
+  let resolutions;
+  if (conflictResult.hasConflicts) {
+    console.log(chalk9.yellow(`  Auto-merging ${conflictResult.totalConflicts} conflicting files (vibe mode)...`));
+    const allPaths = conflictResult.categories.flatMap((c) => c.conflicts.map((f) => f.path));
+    await createBackup2(targetDir, allPaths);
+    resolutions = { categories: {}, files: {} };
+    for (const cat of conflictResult.categories) {
+      if (cat.conflicts.length > 0) {
+        const noMerge = ["agents", "skills", "commands"];
+        resolutions.categories[cat.name] = noMerge.includes(cat.name) ? "skip" : "merge";
+      }
+    }
+  }
+  const initOptions = {
+    description: description || `${projectName} project`,
+    interactive: false,
+    costMode: options.costMode || "balanced",
+    language: options.language || brownfieldAnalysis?.language,
+    framework: options.framework || brownfieldAnalysis?.framework
+  };
+  let brownfieldData = void 0;
+  if (brownfieldAnalysis) {
+    brownfieldData = {
+      language: brownfieldAnalysis.language,
+      framework: brownfieldAnalysis.framework,
+      testFramework: brownfieldAnalysis.testFramework,
+      packageManager: brownfieldAnalysis.packageManager,
+      linter: brownfieldAnalysis.linter,
+      formatter: brownfieldAnalysis.formatter,
+      cssFramework: brownfieldAnalysis.cssFramework,
+      orm: brownfieldAnalysis.orm,
+      database: brownfieldAnalysis.database,
+      authProvider: brownfieldAnalysis.authProvider,
+      apiStyle: brownfieldAnalysis.apiStyle,
+      monorepo: brownfieldAnalysis.monorepo,
+      conventions: brownfieldAnalysis.conventions,
+      codePatterns: brownfieldAnalysis.codePatterns,
+      fileStats: {
+        totalFiles: brownfieldAnalysis.fileStats.totalFiles,
+        codeFiles: brownfieldAnalysis.fileStats.codeFiles,
+        testFiles: brownfieldAnalysis.fileStats.testFiles
+      }
+    };
+  }
+  const scaffoldSpinner = ora2("Scaffolding FISHI...").start();
+  try {
+    const result = await scaffold(targetDir, {
+      ...initOptions,
+      projectName,
+      projectType: detection.type,
+      brownfieldAnalysis: brownfieldData,
+      resolutions,
+      docsReadmeExists: conflictResult.docsReadmeExists,
+      rootClaudeMdExists: conflictResult.rootClaudeMdExists
+    });
+    scaffoldSpinner.succeed(`Scaffolded: ${result.agentCount} agents, ${result.skillCount} skills, ${result.commandCount} commands`);
+  } catch (error) {
+    scaffoldSpinner.fail("Scaffolding failed");
+    console.error(chalk9.red(`  Error: ${error instanceof Error ? error.message : error}`));
+    process.exit(1);
+  }
+  const fishiYamlPath = path11.join(targetDir, ".fishi", "fishi.yaml");
+  if (fs11.existsSync(fishiYamlPath)) {
+    fs11.appendFileSync(fishiYamlPath, getVibeModeConfig(true), "utf-8");
+  }
+  const dockerAvailable = detectDocker3();
+  const sandboxMode = dockerAvailable ? "docker" : "process";
+  fs11.appendFileSync(fishiYamlPath, `
+sandbox:
+  mode: ${sandboxMode}
+  docker_available: ${dockerAvailable}
+`, "utf-8");
+  const projectYamlPath = path11.join(targetDir, ".fishi", "state", "project.yaml");
+  if (fs11.existsSync(projectYamlPath)) {
+    let content = fs11.readFileSync(projectYamlPath, "utf-8");
+    content = content.replace(/^phase:\s*.+$/m, "phase: development");
+    fs11.writeFileSync(projectYamlPath, content, "utf-8");
+  }
+  const serverConfig = detectDevServer(targetDir, options.devCmd);
+  console.log("");
+  console.log(chalk9.cyan.bold("  Vibe Mode Active"));
+  console.log(chalk9.gray(`  Phase: ${chalk9.green("development")} (gates auto-skipped)`));
+  console.log(chalk9.gray(`  Sandbox: ${sandboxMode}`));
+  if (serverConfig.detected) {
+    const port = options.port ? parseInt(options.port, 10) : serverConfig.port;
+    console.log(chalk9.gray(`  Dev server: ${serverConfig.framework} on :${port}`));
+    console.log("");
+    console.log(chalk9.green.bold(`  Preview: http://localhost:${port}`));
+    console.log("");
+    console.log(chalk9.gray("  Starting dev server..."));
+    console.log("");
+    const child = startDevServer(targetDir, { ...serverConfig, port });
+    child.stdout?.on("data", (d) => process.stdout.write(d));
+    child.stderr?.on("data", (d) => process.stderr.write(d));
+    child.on("close", (code) => {
+      console.log(chalk9.gray(`
+  Dev server stopped (exit ${code})`));
+    });
+    process.on("SIGINT", () => {
+      child.kill();
+      console.log(chalk9.gray("\n  Dev server stopped."));
+      process.exit(0);
+    });
+  } else {
+    console.log("");
+    console.log(chalk9.yellow("  No dev server detected. Run your dev server manually."));
+    console.log(chalk9.gray('  Or use: fishi quickstart --dev-cmd "npm run dev"'));
+    console.log("");
+    console.log(chalk9.cyan.bold("  Ready to ship!"));
+    console.log(chalk9.gray("  Run `claude` to start working with your AI dev team."));
+    console.log("");
+  }
+}
+
+// src/commands/preview.ts
+import chalk10 from "chalk";
+import fs12 from "fs";
+import path12 from "path";
+import { detectDevServer as detectDevServer2, startDevServer as startDevServer2 } from "@qlucent/fishi-core";
+async function previewCommand(options) {
+  const targetDir = process.cwd();
+  if (!fs12.existsSync(path12.join(targetDir, ".fishi"))) {
+    console.log(chalk10.yellow("  No FISHI project found. Run `fishi init` or `fishi quickstart` first."));
+    return;
+  }
+  const serverConfig = detectDevServer2(targetDir, options.devCmd);
+  if (!serverConfig.detected) {
+    console.log(chalk10.yellow("  Could not detect dev server."));
+    console.log(chalk10.gray('  Use --dev-cmd to specify: fishi preview --dev-cmd "npm run dev"'));
+    return;
+  }
+  const port = options.port ? parseInt(options.port, 10) : serverConfig.port;
+  console.log("");
+  console.log(chalk10.cyan.bold("  FISHI Live Preview"));
+  console.log(chalk10.gray(`  Framework: ${serverConfig.framework}`));
+  console.log(chalk10.green.bold(`  URL: http://localhost:${port}`));
+  console.log(chalk10.gray("  Press Ctrl+C to stop"));
+  console.log("");
+  const child = startDevServer2(targetDir, { ...serverConfig, port });
+  child.stdout?.on("data", (d) => process.stdout.write(d));
+  child.stderr?.on("data", (d) => process.stderr.write(d));
+  child.on("close", (code) => {
+    console.log(chalk10.gray(`
+  Dev server stopped (exit ${code})`));
+  });
+  process.on("SIGINT", () => {
+    child.kill();
+    console.log(chalk10.gray("\n  Dev server stopped."));
+    process.exit(0);
+  });
+}
+
+// src/commands/design.ts
+import chalk11 from "chalk";
+import fs13 from "fs";
+import path13 from "path";
+import {
+  detectDesignTokens,
+  generateDefaultTokens,
+  detectComponentRegistry,
+  runBrandGuardian,
+  generateDesignSystemConfig
+} from "@qlucent/fishi-core";
+async function designCommand(action, options) {
+  const targetDir = process.cwd();
+  if (action === "detect") {
+    console.log("");
+    console.log(chalk11.cyan.bold("  FISHI Design System \u2014 Detect"));
+    console.log("");
+    const tokens = detectDesignTokens(targetDir);
+    const registry = detectComponentRegistry(targetDir);
+    console.log(chalk11.white.bold("  Design Tokens"));
+    console.log(chalk11.gray(`    Colors:        ${Object.keys(tokens.colors).length} detected`));
+    console.log(chalk11.gray(`    Typography:    ${tokens.typography.fontFamilies.length} font families, ${Object.keys(tokens.typography.scale).length} scale values`));
+    console.log(chalk11.gray(`    Spacing:       ${Object.keys(tokens.spacing).length} values`));
+    console.log(chalk11.gray(`    Border radius: ${Object.keys(tokens.borderRadius).length} values`));
+    console.log(chalk11.gray(`    Dark mode:     ${tokens.darkMode ? chalk11.green("yes") : chalk11.yellow("no")}`));
+    console.log("");
+    console.log(chalk11.white.bold("  Component Registry"));
+    console.log(chalk11.gray(`    Library:       ${registry.library || "none detected"}`));
+    console.log(chalk11.gray(`    Framework:     ${registry.framework || "none detected"}`));
+    console.log(chalk11.gray(`    Components:    ${registry.components.length} found`));
+    if (registry.components.length > 0) {
+      const byType = {};
+      for (const c of registry.components) byType[c.type] = (byType[c.type] || 0) + 1;
+      for (const [type, count] of Object.entries(byType)) {
+        console.log(chalk11.gray(`      ${type}: ${count}`));
+      }
+    }
+    console.log("");
+    if (options.output || fs13.existsSync(path13.join(targetDir, ".fishi"))) {
+      const outputPath = options.output || path13.join(targetDir, ".fishi", "design-system.json");
+      const dir = path13.dirname(outputPath);
+      if (!fs13.existsSync(dir)) fs13.mkdirSync(dir, { recursive: true });
+      fs13.writeFileSync(outputPath, generateDesignSystemConfig(tokens, registry), "utf-8");
+      console.log(chalk11.green(`  Saved to ${path13.relative(targetDir, outputPath)}`));
+    }
+  } else if (action === "init") {
+    console.log("");
+    console.log(chalk11.cyan.bold("  FISHI Design System \u2014 Initialize"));
+    console.log("");
+    let tokens = detectDesignTokens(targetDir);
+    const hasExisting = Object.keys(tokens.colors).length > 0;
+    if (!hasExisting) {
+      tokens = generateDefaultTokens();
+      console.log(chalk11.yellow("  No design tokens found \u2014 using FISHI defaults."));
+    } else {
+      console.log(chalk11.green(`  Detected ${Object.keys(tokens.colors).length} colors from your project.`));
+    }
+    const registry = detectComponentRegistry(targetDir);
+    const outputPath = path13.join(targetDir, ".fishi", "design-system.json");
+    const dir = path13.dirname(outputPath);
+    if (!fs13.existsSync(dir)) fs13.mkdirSync(dir, { recursive: true });
+    fs13.writeFileSync(outputPath, generateDesignSystemConfig(tokens, registry), "utf-8");
+    console.log(chalk11.green(`  Design system saved to .fishi/design-system.json`));
+    console.log(chalk11.gray("  Your agents will use these tokens for consistent styling."));
+    console.log("");
+  } else if (action === "validate") {
+    console.log("");
+    console.log(chalk11.cyan.bold("  FISHI Brand Guardian \u2014 Validation"));
+    console.log("");
+    const tokens = detectDesignTokens(targetDir);
+    const report = runBrandGuardian(targetDir, tokens);
+    if (report.issues.length === 0) {
+      console.log(chalk11.green("  No issues found! Your frontend follows the design system."));
+    } else {
+      for (const issue of report.issues) {
+        const icon = issue.severity === "error" ? chalk11.red("ERROR") : issue.severity === "warning" ? chalk11.yellow("WARN") : chalk11.blue("INFO");
+        console.log(`  ${icon} ${chalk11.gray(issue.file)}:${issue.line}`);
+        console.log(`        ${issue.message}`);
+        if (issue.fix) console.log(`        ${chalk11.gray("Fix: " + issue.fix)}`);
+      }
+    }
+    console.log("");
+    console.log(chalk11.white.bold("  Summary"));
+    console.log(chalk11.gray(`    Files scanned: ${report.stats.filesScanned}`));
+    console.log(chalk11.red(`    Errors:        ${report.stats.errors}`));
+    console.log(chalk11.yellow(`    Warnings:      ${report.stats.warnings}`));
+    console.log(chalk11.blue(`    Info:          ${report.stats.infos}`));
+    console.log(`    Status:        ${report.passed ? chalk11.green("PASSED") : chalk11.red("FAILED")}`);
+    console.log("");
+    if (!report.passed) process.exit(1);
+  } else {
+    console.log(chalk11.yellow(`  Unknown action: ${action}. Use: detect, init, validate`));
+  }
+}
+
 // src/index.ts
 var program = new Command();
 program.name("fishi").description(
-  chalk9.cyan("\u{1F41F} FISHI") + " \u2014 Your AI Dev Team That Actually Ships\n   Autonomous agent framework for Claude Code"
-).version("0.7.0");
+  chalk12.cyan("\u{1F41F} FISHI") + " \u2014 Your AI Dev Team That Actually Ships\n   Autonomous agent framework for Claude Code"
+).version("0.9.0");
 program.command("init").description("Initialize FISHI in the current directory").argument("[description]", "Project description (skip wizard with zero-config)").option("-l, --language <lang>", "Primary language (e.g., typescript, python)").option("-f, --framework <framework>", "Framework (e.g., nextjs, express, django)").option(
   "-c, --cost-mode <mode>",
   "Cost mode: performance | balanced | economy",
@@ -1987,4 +2273,7 @@ program.command("validate").description("Validate scaffold integrity \u2014 chec
 program.command("monitor").description("Agent observability \u2014 TUI dashboard showing agent activity, tokens, gates").option("-w, --watch", "Watch mode \u2014 auto-refresh on changes").action(monitorCommand);
 program.command("dashboard").description("Agent observability \u2014 web dashboard at http://localhost:4269").option("-p, --port <port>", "Port number", "4269").action(dashboardCommand);
 program.command("sandbox").description("Sandbox status and policy management").argument("<action>", "Action: status | policy").action(sandboxCommand);
+program.command("quickstart").description("Vibe mode \u2014 skip gates, scaffold + start dev server immediately").argument("[description]", "What are you building?").option("-l, --language <lang>", "Primary language").option("-f, --framework <framework>", "Framework").option("-c, --cost-mode <mode>", "Cost mode", "balanced").option("--dev-cmd <cmd>", "Custom dev server command").option("--port <port>", "Dev server port").action(quickstartCommand);
+program.command("preview").description("Start live preview dev server").option("--dev-cmd <cmd>", "Custom dev server command").option("--port <port>", "Dev server port").action(previewCommand);
+program.command("design").description("Design system \u2014 detect tokens, init design system, validate with Brand Guardian").argument("<action>", "Action: detect | init | validate").option("-o, --output <path>", "Output path for design config").action(designCommand);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qlucent/fishi",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "FISHI — Your AI Dev Team That Actually Ships. Autonomous agent framework for Claude Code.",
   "license": "MIT",
   "type": "module",