@qlucent/fishi-core 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { ChildProcess } from 'child_process';
+
 type ProjectType = 'greenfield' | 'brownfield' | 'hybrid';
 type CostMode = 'performance' | 'balanced' | 'economy';
 type ModelTier = 'opus' | 'sonnet' | 'haiku';
@@ -620,10 +622,31 @@ declare function runInSandbox(command: string, args: string[], worktreePath: str
     nodeModulesPath?: string;
 }): SandboxRunResult;
 
+interface DevServerConfig {
+    command: string;
+    args: string[];
+    port: number;
+    framework: string;
+    detected: boolean;
+}
+/**
+ * Detect the dev server command from package.json scripts or framework detection.
+ */
+declare function detectDevServer(projectDir: string, customCmd?: string): DevServerConfig;
+/**
+ * Start the dev server as a background process.
+ * Returns the child process handle.
+ */
+declare function startDevServer(projectDir: string, config: DevServerConfig): ChildProcess;
+/**
+ * Get the vibe mode config for fishi.yaml.
+ */
+declare function getVibeModeConfig(enabled: boolean): string;
+
 declare function getSandboxPolicyTemplate(): string;
 
 declare function getDockerfileTemplate(): string;
 
 declare function getDashboardHtml(): string;
 
-export { type AgentDefinition, type AgentRole, type AgentTemplate, type BackupManifest, type BrownfieldAnalysisData, type ClaudeMdOptions, type CommandTemplate, type ConflictCategory, type ConflictMap, type ConflictResolution, type CostMode, type DetectionCheck, type DetectionResult, type DynamicAgent, type DynamicAgentConfig, type ExecutionConfig, type FileConflict, type FileResolutionMap, type FishiConfig, type FishiYamlOptions, type GateConfig, type GateStatus, type GitConfig, type HookTemplate, type InitOptions, type McpConfig, type McpServerConfig, type ModelRoutingConfig, type ModelTier, type MonitorEvent, type MonitorState, type MonitorSummary, type ProjectConfig, type ProjectType, type ProjectYamlOptions, type SandboxConfig, type SandboxMode, type SandboxPolicy, type SandboxRunResult, type ScaffoldOptions, type ScaffoldResult, type SkillTemplate, type StateConfig, type TaskStatus, type TaskboardConfig, type TemplateContext, architectAgentTemplate, backendAgentTemplate, buildSandboxEnv, createBackup, detectConflicts, detectDocker, devLeadTemplate, devopsAgentTemplate, docsAgentTemplate, emitEvent, frontendAgentTemplate, fullstackAgentTemplate, generateScaffold, getAdaptiveTaskGraphSkill, getAgentCompleteHook, getAgentFactoryTemplate, getAgentRegistryTemplate, getAgentSummary, getApiDesignSkill, getAutoCheckpointHook, getBoardCommand, getBrainstormingSkill, getBrownfieldAnalysisSkill, getBrownfieldDiscoverySkill, getClaudeMdTemplate, getCodeGenSkill, getCoordinatorFactoryTemplate, getDashboardHtml, getDebuggingSkill, getDeploymentSkill, getDocCheckerScript, getDockerfileTemplate, getDocumentationSkill, getFishiYamlTemplate, getGateCommand, getGateManagerScript, getGitignoreAdditions, getInitCommand, getLearningsManagerScript, getMasterOrchestratorTemplate, getMcpJsonTemplate, getMemoryManagerScript, getModelRoutingReference, getMonitorEmitterScript, getPhaseRunnerScript, getPostEditHook, getPrdCommand, getPrdSkill, getProjectYamlTemplate, getResetCommand, getResumeCommand, getSafetyCheckHook, getSandboxPolicyTemplate, getSessionStartHook, getSettingsJsonTemplate, getSprintCommand, getStatusCommand, getTaskboardOpsSkill, getTaskboardUpdateHook, getTestingSkill, getTodoManagerScript, getValidateScaffoldScript, getWorktreeManagerScript, getWorktreeSetupHook, marketingAgentTemplate, mergeClaudeMd, mergeClaudeMdTop, mergeGitignore, mergeMcpJson, mergeSettingsJson, opsLeadTemplate, planningAgentTemplate, planningLeadTemplate, qualityLeadTemplate, readMonitorState, readSandboxConfig, readSandboxPolicy, researchAgentTemplate, runInDockerSandbox, runInProcessSandbox, runInSandbox, securityAgentTemplate, testingAgentTemplate, uiuxAgentTemplate, writingAgentTemplate };
+export { type AgentDefinition, type AgentRole, type AgentTemplate, type BackupManifest, type BrownfieldAnalysisData, type ClaudeMdOptions, type CommandTemplate, type ConflictCategory, type ConflictMap, type ConflictResolution, type CostMode, type DetectionCheck, type DetectionResult, type DevServerConfig, type DynamicAgent, type DynamicAgentConfig, type ExecutionConfig, type FileConflict, type FileResolutionMap, type FishiConfig, type FishiYamlOptions, type GateConfig, type GateStatus, type GitConfig, type HookTemplate, type InitOptions, type McpConfig, type McpServerConfig, type ModelRoutingConfig, type ModelTier, type MonitorEvent, type MonitorState, type MonitorSummary, type ProjectConfig, type ProjectType, type ProjectYamlOptions, type SandboxConfig, type SandboxMode, type SandboxPolicy, type SandboxRunResult, type ScaffoldOptions, type ScaffoldResult, type SkillTemplate, type StateConfig, type TaskStatus, type TaskboardConfig, type TemplateContext, architectAgentTemplate, backendAgentTemplate, buildSandboxEnv, createBackup, detectConflicts, detectDevServer, detectDocker, devLeadTemplate, devopsAgentTemplate, docsAgentTemplate, emitEvent, frontendAgentTemplate, fullstackAgentTemplate, generateScaffold, getAdaptiveTaskGraphSkill, getAgentCompleteHook, getAgentFactoryTemplate, getAgentRegistryTemplate, getAgentSummary, getApiDesignSkill, getAutoCheckpointHook, getBoardCommand, getBrainstormingSkill, getBrownfieldAnalysisSkill, getBrownfieldDiscoverySkill, getClaudeMdTemplate, getCodeGenSkill, getCoordinatorFactoryTemplate, getDashboardHtml, getDebuggingSkill, getDeploymentSkill, getDocCheckerScript, getDockerfileTemplate, getDocumentationSkill, getFishiYamlTemplate, getGateCommand, getGateManagerScript, getGitignoreAdditions, getInitCommand, getLearningsManagerScript, getMasterOrchestratorTemplate, getMcpJsonTemplate, getMemoryManagerScript, getModelRoutingReference, getMonitorEmitterScript, getPhaseRunnerScript, getPostEditHook, getPrdCommand, getPrdSkill, getProjectYamlTemplate, getResetCommand, getResumeCommand, getSafetyCheckHook, getSandboxPolicyTemplate, getSessionStartHook, getSettingsJsonTemplate, getSprintCommand, getStatusCommand, getTaskboardOpsSkill, getTaskboardUpdateHook, getTestingSkill, getTodoManagerScript, getValidateScaffoldScript, getVibeModeConfig, getWorktreeManagerScript, getWorktreeSetupHook, marketingAgentTemplate, mergeClaudeMd, mergeClaudeMdTop, mergeGitignore, mergeMcpJson, mergeSettingsJson, opsLeadTemplate, planningAgentTemplate, planningLeadTemplate, qualityLeadTemplate, readMonitorState, readSandboxConfig, readSandboxPolicy, researchAgentTemplate, runInDockerSandbox, runInProcessSandbox, runInSandbox, securityAgentTemplate, startDevServer, testingAgentTemplate, uiuxAgentTemplate, writingAgentTemplate };

package/dist/index.js

@@ -11111,7 +11111,7 @@ async function createBackup(targetDir, conflictingFiles) {
       manifestFiles.push({ path: relPath, size: stat.size });
     }
   }
-  const fishiVersion = "0.7.0";
+  const fishiVersion = "0.8.0";
   const manifest = {
     timestamp: now.toISOString(),
     fishi_version: fishiVersion,
@@ -11368,6 +11368,104 @@ function runInSandbox(command, args, worktreePath, projectDir, options = {}) {
   return runInProcessSandbox(command, args, worktreePath, policy);
 }
 
+// src/generators/preview-server.ts
+import { existsSync as existsSync6, readFileSync as readFileSync3 } from "fs";
+import { join as join6 } from "path";
+import { spawn as spawn2 } from "child_process";
+function detectDevServer(projectDir, customCmd) {
+  if (customCmd) {
+    const parts = customCmd.split(/\s+/);
+    return {
+      command: parts[0],
+      args: parts.slice(1),
+      port: 3e3,
+      framework: "custom",
+      detected: true
+    };
+  }
+  const pkgPath = join6(projectDir, "package.json");
+  if (!existsSync6(pkgPath)) {
+    if (existsSync6(join6(projectDir, "manage.py"))) {
+      return { command: "python", args: ["manage.py", "runserver"], port: 8e3, framework: "django", detected: true };
+    }
+    if (existsSync6(join6(projectDir, "requirements.txt"))) {
+      const reqs = readFileSync3(join6(projectDir, "requirements.txt"), "utf-8");
+      if (reqs.includes("flask")) return { command: "python", args: ["-m", "flask", "run"], port: 5e3, framework: "flask", detected: true };
+      if (reqs.includes("fastapi")) return { command: "uvicorn", args: ["main:app", "--reload"], port: 8e3, framework: "fastapi", detected: true };
+    }
+    return { command: "", args: [], port: 3e3, framework: "unknown", detected: false };
+  }
+  const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
+  const scripts = pkg.scripts || {};
+  if (scripts.dev) {
+    const devCmd = scripts.dev;
+    const port = extractPort(devCmd) || 3e3;
+    const framework = detectFrameworkFromCmd(devCmd, pkg);
+    return { command: "npm", args: ["run", "dev"], port, framework, detected: true };
+  }
+  if (scripts.start) {
+    const port = extractPort(scripts.start) || 3e3;
+    const framework = detectFrameworkFromCmd(scripts.start, pkg);
+    return { command: "npm", args: ["run", "start"], port, framework, detected: true };
+  }
+  const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+  if (deps["next"]) return { command: "npx", args: ["next", "dev"], port: 3e3, framework: "nextjs", detected: true };
+  if (deps["vite"]) return { command: "npx", args: ["vite"], port: 5173, framework: "vite", detected: true };
+  if (deps["astro"]) return { command: "npx", args: ["astro", "dev"], port: 4321, framework: "astro", detected: true };
+  if (deps["nuxt"]) return { command: "npx", args: ["nuxt", "dev"], port: 3e3, framework: "nuxt", detected: true };
+  if (deps["svelte-kit"] || deps["@sveltejs/kit"]) return { command: "npx", args: ["vite", "dev"], port: 5173, framework: "sveltekit", detected: true };
+  if (deps["gatsby"]) return { command: "npx", args: ["gatsby", "develop"], port: 8e3, framework: "gatsby", detected: true };
+  if (deps["remix"] || deps["@remix-run/dev"]) return { command: "npx", args: ["remix", "vite:dev"], port: 5173, framework: "remix", detected: true };
+  if (deps["express"]) return { command: "node", args: ["index.js"], port: 3e3, framework: "express", detected: true };
+  if (existsSync6(join6(projectDir, "manage.py"))) {
+    return { command: "python", args: ["manage.py", "runserver"], port: 8e3, framework: "django", detected: true };
+  }
+  if (existsSync6(join6(projectDir, "requirements.txt"))) {
+    const reqs = readFileSync3(join6(projectDir, "requirements.txt"), "utf-8");
+    if (reqs.includes("flask")) return { command: "python", args: ["-m", "flask", "run"], port: 5e3, framework: "flask", detected: true };
+    if (reqs.includes("fastapi")) return { command: "uvicorn", args: ["main:app", "--reload"], port: 8e3, framework: "fastapi", detected: true };
+  }
+  return { command: "", args: [], port: 3e3, framework: "unknown", detected: false };
+}
+function extractPort(cmd) {
+  const portMatch = cmd.match(/(?:--port|-p)\s+(\d+)/) || cmd.match(/PORT=(\d+)/) || cmd.match(/:(\d{4,5})/);
+  return portMatch ? parseInt(portMatch[1], 10) : null;
+}
+function detectFrameworkFromCmd(cmd, _pkg) {
+  if (cmd.includes("next")) return "nextjs";
+  if (cmd.includes("vite")) return "vite";
+  if (cmd.includes("astro")) return "astro";
+  if (cmd.includes("nuxt")) return "nuxt";
+  if (cmd.includes("gatsby")) return "gatsby";
+  if (cmd.includes("remix")) return "remix";
+  if (cmd.includes("svelte")) return "sveltekit";
+  if (cmd.includes("express") || cmd.includes("node server")) return "express";
+  if (cmd.includes("flask")) return "flask";
+  if (cmd.includes("django") || cmd.includes("manage.py")) return "django";
+  if (cmd.includes("uvicorn") || cmd.includes("fastapi")) return "fastapi";
+  return "unknown";
+}
+function startDevServer(projectDir, config) {
+  const child = spawn2(config.command, config.args, {
+    cwd: projectDir,
+    stdio: "pipe",
+    detached: false,
+    env: { ...process.env, PORT: String(config.port) },
+    shell: true
+  });
+  return child;
+}
+function getVibeModeConfig(enabled) {
+  return `
+vibe_mode:
+  enabled: ${enabled}
+  auto_approve_gates: ${enabled}
+  auto_generate_prd: ${enabled}
+  background_testing: ${enabled}
+  dev_server_autostart: ${enabled}
+`;
+}
+
 // src/templates/configs/sandbox-policy.ts
 function getSandboxPolicyTemplate() {
   return `# FISHI Sandbox Policy
@@ -11765,6 +11863,7 @@ export {
   buildSandboxEnv,
   createBackup,
   detectConflicts,
+  detectDevServer,
   detectDocker,
   devLeadTemplate,
   devopsAgentTemplate,
@@ -11822,6 +11921,7 @@ export {
   getTestingSkill,
   getTodoManagerScript,
   getValidateScaffoldScript,
+  getVibeModeConfig,
   getWorktreeManagerScript,
   getWorktreeSetupHook,
   marketingAgentTemplate,
@@ -11842,6 +11942,7 @@ export {
   runInProcessSandbox,
   runInSandbox,
   securityAgentTemplate,
+  startDevServer,
   testingAgentTemplate,
   uiuxAgentTemplate,
   writingAgentTemplate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qlucent/fishi-core",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Shared templates, types, and generators for the FISHI framework",
   "license": "MIT",
   "type": "module",