fifony 0.1.22 → 0.1.23

package/dist/agent/run-local.js

@@ -6,38 +6,46 @@ import {
   buildQueueTitle,
   buildRuntimeState,
   cleanStalePidFile,
-  cleanWorkspace,
   closeStateStore,
-  computeMetrics,
+  createContainer,
   deriveConfig,
-  detectAvailableProviders,
-  detectDefaultBranch,
   detectProjectName,
-  getProviderDefaultCommand,
+  ensureNotStale,
+  hasTerminalQueue,
   hydrate,
-  initLogger,
-  initQueueWorkers,
   initStateStore,
   installGracefulShutdown,
   isAgentStillRunning,
+  isShuttingDown,
   loadPersistedState,
   loadRuntimeSettings,
-  logger,
-  parsePort,
   persistDetectedProvidersSetting,
   persistState,
   persistStateFull,
   recoverPlanningSession,
-  resolveDefaultProvider,
   resolveProjectMetadata,
-  scheduler,
-  setSkipSource,
   startApiServer,
-  stopQueueWorkers,
   syncRuntimeConfigSettings,
   validateConfig
-} from "../chunk-VP6TGOMT.js";
-import "../chunk-F6JEQIP2.js";
+} from "../chunk-KT5V7N5H.js";
+import {
+  enqueueForExecution,
+  enqueueForPlanning,
+  enqueueForReview,
+  initQueueWorkers,
+  stopQueueWorkers
+} from "../chunk-NLIVWBNV.js";
+import {
+  cleanWorkspace,
+  computeMetrics,
+  detectAvailableProviders,
+  detectDefaultBranch,
+  executeTransition,
+  getProviderDefaultCommand,
+  hasDirtyState,
+  resolveDefaultProvider,
+  setSkipSource
+} from "../chunk-G6CQK2WH.js";
 import {
   CLI_ARGS,
   PACKAGE_ROOT,
@@ -45,17 +53,34 @@ import {
   TARGET_ROOT,
   debugBoot,
   fail,
-  now
-} from "../chunk-O665NS5E.js";
+  now,
+  parseIntArg,
+  sleep
+} from "../chunk-DD5BE2W6.js";
+import {
+  initLogger,
+  logger
+} from "../chunk-DVU3CXWA.js";
 
-// src/agent/run-local.ts
+// src/boot.ts
 import { mkdirSync } from "fs";
 import { env, exit, argv } from "process";
-
-// src/agent/dev-server.ts
 import { resolve } from "path";
-var VITE_CONFIG_PATH = resolve(PACKAGE_ROOT, "app/vite.config.js");
+function parsePort(args) {
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === "--port") {
+      const value = args[i + 1];
+      if (!value || !/^\d+$/.test(value)) {
+        fail(`Invalid value for --port: ${value ?? "<empty>"}`);
+      }
+      return parseIntArg(value, 4040);
+    }
+  }
+  return void 0;
+}
 async function startDevFrontend(apiPort, devPort) {
+  const VITE_CONFIG_PATH = resolve(PACKAGE_ROOT, "app/vite.config.js");
   let createViteServer;
   try {
     const vite = await import("vite");
@@ -64,15 +89,51 @@ async function startDevFrontend(apiPort, devPort) {
     logger.warn("Vite not installed (devDependency). Run 'pnpm install' in the project to enable --dev mode.");
     return;
   }
+  for (let attempt = 0; attempt < 20; attempt++) {
+    try {
+      const res = await fetch(`http://localhost:${apiPort}/api/health`);
+      if (res.ok) break;
+    } catch {
+      await new Promise((r) => setTimeout(r, 250));
+    }
+  }
   try {
     const server = await createViteServer({
       configFile: VITE_CONFIG_PATH,
+      customLogger: {
+        info: (msg) => logger.info(`[Vite] ${msg}`),
+        warn: (msg) => logger.warn(`[Vite] ${msg}`),
+        warnOnce: (msg) => logger.warn(`[Vite] ${msg}`),
+        error: (msg) => {
+          if (msg.includes("ws proxy error") || msg.includes("ws proxy socket error")) {
+            logger.debug(`[Vite] ${msg.split("\n")[0]} (transient, suppressed)`);
+            return;
+          }
+          logger.error(`[Vite] ${msg}`);
+        },
+        hasErrorLogged: () => false,
+        clearScreen: () => {
+        },
+        hasWarned: false
+      },
       server: {
         port: devPort,
         host: true,
         proxy: {
           "/api": `http://localhost:${apiPort}`,
-          "/ws": { target: `ws://localhost:${apiPort}`, ws: true },
+          "/ws": {
+            target: `ws://localhost:${apiPort}`,
+            ws: true,
+            configure: (proxy) => {
+              const silence = (err) => {
+                logger.debug(`[Vite] WS proxy transient: ${err.code || err.message}`);
+              };
+              proxy.on("error", silence);
+              proxy.on("proxyReqWs", (_proxyReq, _req, socket) => {
+                socket.on("error", silence);
+              });
+            }
+          },
           "/docs": `http://localhost:${apiPort}`,
           "/health": `http://localhost:${apiPort}`,
           "/manifest.webmanifest": `http://localhost:${apiPort}`,
@@ -89,8 +150,6 @@ async function startDevFrontend(apiPort, devPort) {
     logger.warn(`Failed to start Vite dev server: ${String(error)}`);
   }
 }
-
-// src/agent/run-local.ts
 function usage() {
   console.log(
     `Usage: ${argv[1]} [options]
@@ -171,6 +230,8 @@ async function main() {
     booting: true
   };
   let apiState = earlyState;
+  createContainer(apiState);
+  debugBoot("main:container-early-init");
   if (dashboardPort) {
     await startApiServer(apiState, dashboardPort);
     debugBoot("main:api-server-early-start");
@@ -197,6 +258,23 @@ async function main() {
   state.config.dashboardPort = dashboardPort ? String(dashboardPort) : void 0;
   state.updatedAt = now();
   state.booting = false;
+  try {
+    const { getIssueStateMachinePlugin, ISSUE_STATE_MACHINE_ID } = await import("../issue-state-machine-NSDN4MV4.js");
+    const fsmPlugin = getIssueStateMachinePlugin();
+    if (fsmPlugin?.getState) {
+      for (const issue of state.issues) {
+        try {
+          const fsmState = await fsmPlugin.getState(ISSUE_STATE_MACHINE_ID, issue.id);
+          if (fsmState && fsmState !== issue.state) {
+            logger.warn({ issueId: issue.id, memoryState: issue.state, fsmState }, "[Boot] Reconciling desync \u2014 FSM is source of truth");
+            issue.state = fsmState;
+          }
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
   if (!state.config.defaultBranch) {
     try {
       const detectedBranch = detectDefaultBranch(TARGET_ROOT);
@@ -241,13 +319,22 @@ async function main() {
         const { alive, pid } = isAgentStillRunning(issue);
         if (alive && pid) {
           logger.info(`Agent for ${issue.identifier} still alive (PID ${pid.pid}), keeping state as Running.`);
-          issue.state = "Running";
+          if (issue.state !== "Running") {
+            try {
+              await executeTransition(issue, "RUN", { issue, note: `Orphaned agent detected (PID ${pid.pid}), still alive \u2014 tracking resumed.` });
+            } catch {
+              issue.state = "Running";
+            }
+          }
           addEvent(state, issue.id, "info", `Orphaned agent detected (PID ${pid.pid}), still alive \u2014 tracking resumed.`);
         } else {
           if (issue.workspacePath) cleanStalePidFile(issue.workspacePath);
           if (issue.state === "Running") {
-            issue.state = "Queued";
-            issue.history.push(`[${now()}] Agent process not found on boot \u2014 marked Queued.`);
+            try {
+              await executeTransition(issue, "REQUEUE", { issue, note: `Agent process not found on boot \u2014 marked Queued.` });
+            } catch {
+              issue.state = "Queued";
+            }
             addEvent(state, issue.id, "info", `Agent for ${issue.identifier} not found, marked Queued.`);
           }
         }
@@ -255,16 +342,18 @@ async function main() {
     }
   }
   state.metrics = computeMetrics(state.issues);
+  if (dashboardPort) {
+    Object.assign(apiState, state);
+    debugBoot("main:api-state-swapped");
+  }
+  createContainer(apiState);
+  logger.info("[Boot] DI container initialized with full state");
   await persistStateFull(state);
   try {
     await initQueueWorkers(state);
   } catch (error) {
     logger.warn({ err: error }, "[Boot] Queue workers failed to initialize \u2014 continuing without queue-based dispatch");
   }
-  if (dashboardPort) {
-    Object.assign(apiState, state);
-    debugBoot("main:api-state-swapped");
-  }
   const running = /* @__PURE__ */ new Set();
   installGracefulShutdown(state, running);
   logger.info("[Boot] Runtime ready");
@@ -278,8 +367,49 @@ async function main() {
   try {
     addEvent(state, void 0, "info", `Runtime started in local-only mode (filesystem tracker).`);
     const runForever = !runOnce && (Boolean(dashboardPort) || interfaceMode === "mcp");
-    logger.info({ runForever, runOnce, dashboardPort, interfaceMode }, "[Boot] Entering scheduler loop");
-    await scheduler(state, running, runForever);
+    logger.info({ runForever, runOnce, dashboardPort, interfaceMode }, "[Boot] Entering queue supervisor loop");
+    for (const issue of state.issues) {
+      try {
+        if (issue.state === "Planning" && issue.planningStatus !== "planning") {
+          await enqueueForPlanning(issue);
+        } else if (issue.state === "Queued" || issue.state === "Running") {
+          await enqueueForExecution(issue);
+        } else if (issue.state === "Reviewing") {
+          await enqueueForReview(issue);
+        }
+      } catch (err) {
+        logger.error({ err, issueId: issue.id, state: issue.state }, "[Boot] Failed to enqueue issue for recovery");
+      }
+    }
+    const PERSIST_DEBOUNCE_MS = 5e3;
+    let lastPersistAt = 0;
+    if (runForever) {
+      while (!isShuttingDown()) {
+        const statesBefore = new Map(state.issues.map((i) => [i.id, i.state]));
+        await ensureNotStale(state, state.config.staleInProgressTimeoutMs);
+        for (const issue of state.issues) {
+          const prev = statesBefore.get(issue.id);
+          if (prev !== issue.state) {
+            if (issue.state === "Queued") enqueueForExecution(issue).catch(() => {
+            });
+            else if (issue.state === "Reviewing") enqueueForReview(issue).catch(() => {
+            });
+            else if (issue.state === "Planning") enqueueForPlanning(issue).catch(() => {
+            });
+          }
+        }
+        state.updatedAt = now();
+        if (hasDirtyState() || Date.now() - lastPersistAt > PERSIST_DEBOUNCE_MS) {
+          await persistState(state);
+          lastPersistAt = Date.now();
+        }
+        await sleep(1e3);
+      }
+    } else {
+      while (!hasTerminalQueue(state)) {
+        await sleep(state.config.pollIntervalMs);
+      }
+    }
   } catch (error) {
     console.error("FATAL STACK TRACE:", error);
     addEvent(state, void 0, "error", `Fatal runtime error: ${String(error)}`);

package/dist/agent/run-local.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/agent/run-local.ts","../../src/agent/dev-server.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { mkdirSync } from \"node:fs\";\nimport { env, exit, argv } from \"node:process\";\nimport { CLI_ARGS, STATE_ROOT, TARGET_ROOT } from \"./constants.ts\";\nimport { debugBoot, fail, now } from \"./helpers.ts\";\nimport { initLogger, logger } from \"./logger.ts\";\nimport { initStateStore, loadPersistedState, persistState, persistStateFull, closeStateStore } from \"./store.ts\";\nimport { initQueueWorkers, stopQueueWorkers } from \"./queue-workers.ts\";\nimport {\n  applyPersistedSettings,\n  loadRuntimeSettings,\n  persistDetectedProvidersSetting,\n  syncRuntimeConfigSettings,\n} from \"./settings.ts\";\nimport { buildQueueTitle, detectProjectName, resolveProjectMetadata } from \"./project-meta.ts\";\nimport {\n  detectAvailableProviders,\n  resolveDefaultProvider,\n  getProviderDefaultCommand,\n} from \"./providers.ts\";\nimport { parsePort, setSkipSource } from \"./workflow.ts\";\nimport { deriveConfig, applyWorkflowConfig, buildRuntimeState, computeMetrics, addEvent, validateConfig } from \"./issues.ts\";\nimport { startApiServer } from \"./api-server.ts\";\nimport { scheduler, installGracefulShutdown } from \"./scheduler.ts\";\nimport { cleanWorkspace, isAgentStillRunning, cleanStalePidFile } from \"./agent.ts\";\nimport { startDevFrontend } from \"./dev-server.ts\";\nimport { recoverPlanningSession } from \"./issue-planner.ts\";\nimport { hydrate as hydrateTokenLedger } from \"./token-ledger.ts\";\nimport { detectDefaultBranch } from \"./workspace-setup.ts\";\nimport type { RuntimeState } from \"./types.ts\";\n\nfunction usage() {\n  console.log(\n    `Usage: ${argv[1]} [options]\\n` +\n    \"Options:\\n\" +\n    \"  --workspace <path>     Target workspace root (default: current directory)\\n\" +\n    \"  --persistence <path>   Persistence root (default: current directory)\\n\" +\n    \"  --port <n>             Start local dashboard\\n\" +\n    \"  --concurrency <n>      Maximum number of local workers\\n\" +\n    \"  --attempts <n>         Maximum attempts per issue\\n\" +\n    \"  --poll <ms>            Scheduler interval in ms\\n\" +\n    \"  --timeout <ms>         Agent command timeout in ms (default: 1800000)\\n\" +\n    \"  --dev                   Start Vite dev server alongside API (HMR on port+1)\\n\" +\n    \"  --once                  Process once and exit\\n\" +\n    \"  --skip-source           Skip source snapshot copy\\n\" +\n    \"  --skip-scan             Skip project analysis\\n\" +\n    \"  --skip-recovery         Skip orphaned agent recovery\\n\" +\n    \"  --fast-boot             Equivalent to --skip-source --skip-scan --skip-recovery\\n\",\n  );\n}\n\nasync function main() {\n  debugBoot(\"main:start\");\n\n  const args = CLI_ARGS;\n  if (args.includes(\"--help\") || args.includes(\"-h\")) {\n    usage();\n    return;\n  }\n\n  mkdirSync(STATE_ROOT, { recursive: true });\n  initLogger(STATE_ROOT);\n  logger.info(\"[Boot] Fifony runtime starting\");\n  logger.info({ stateRoot: STATE_ROOT, cwd: process.cwd() }, \"[Boot] State root initialized\");\n\n  // Detect available providers\n  const detectedProviders = detectAvailableProviders();\n  for (const p of detectedProviders) {\n    logger.info(`Provider ${p.name}: ${p.available ? `available at ${p.path}` : \"not found\"}`);\n  }\n\n  const interfaceMode = (env.FIFONY_INTERFACE ?? \"cli\").trim().toLowerCase();\n  const runOnce = args.includes(\"--once\");\n  const devMode = args.includes(\"--dev\") || env.NODE_ENV === \"development\";\n  const fastBoot = args.includes(\"--fast-boot\");\n  const skipSource = fastBoot || args.includes(\"--skip-source\");\n  if (skipSource) setSkipSource(true);\n\n  debugBoot(\"main:state-root-ready\");\n\n  const port = parsePort(args);\n  let config = applyWorkflowConfig(deriveConfig(args), port);\n\n  // Auto-resolve provider command if not configured\n  if (!config.agentCommand.trim()) {\n    const defaultProvider = resolveDefaultProvider(detectedProviders);\n    if (defaultProvider) {\n      const defaultCommand = getProviderDefaultCommand(defaultProvider);\n      if (defaultCommand) {\n        config = { ...config, agentProvider: defaultProvider, agentCommand: defaultCommand };\n        logger.info(`Auto-detected provider: ${defaultProvider} → ${defaultCommand}`);\n      }\n    }\n  }\n\n  const dashboardPort = port ?? (config.dashboardPort ? Number.parseInt(config.dashboardPort, 10) : undefined);\n  const skipRecovery = args.includes(\"--skip-recovery\") || args.includes(\"--fast-boot\");\n  const detectedProjectName = detectProjectName(TARGET_ROOT);\n\n  // ── Phase B: Parallel initialization ────────────────────────────────────────\n  debugBoot(\"main:phase-b-start\");\n  logger.debug(\"[Boot] Initializing state store (s3db)\");\n  await initStateStore();\n  logger.info(\"[Boot] State store initialized\");\n  debugBoot(\"main:store-initialized\");\n\n  // ── Early API start: dashboard available while boot continues ─────────────\n  // Build a minimal placeholder state for the early API server\n  const earlyState: RuntimeState = {\n    projectName: detectedProjectName,\n    detectedProjectName,\n    projectNameSource: detectedProjectName ? \"detected\" : \"missing\",\n    queueTitle: buildQueueTitle(detectedProjectName),\n    startedAt: now(),\n    updatedAt: now(),\n    trackerKind: \"filesystem\",\n    sourceRepoUrl: TARGET_ROOT,\n    sourceRef: \"workspace\",\n    config,\n    issues: [],\n    events: [],\n    metrics: { total: 0, planning: 0, queued: 0, inProgress: 0, blocked: 0, done: 0, cancelled: 0, activeWorkers: 0 },\n    notes: [],\n    booting: true,\n  };\n\n  let apiState = earlyState;\n  if (dashboardPort) {\n    await startApiServer(apiState, dashboardPort);\n    debugBoot(\"main:api-server-early-start\");\n\n    if (devMode) {\n      const devPort = dashboardPort + 1;\n      await startDevFrontend(dashboardPort, devPort);\n    }\n  }\n\n  // ── Phase C: Parallel state loading ─────────────────────────────────────────\n  debugBoot(\"main:phase-c-start\");\n  logger.debug(\"[Boot] Loading persisted state, settings, and recovering sessions\");\n  const [previous, persistedSettings] = await Promise.all([\n    loadPersistedState(),\n    loadRuntimeSettings(),\n    persistDetectedProvidersSetting(detectedProviders),\n    recoverPlanningSession(),\n  ]);\n  logger.info({ hadPreviousState: previous !== null, issueCount: previous?.issues?.length ?? 0, settingsCount: persistedSettings.length }, \"[Boot] State loaded from persistence\");\n  debugBoot(\"main:state-loaded\");\n\n  config = applyPersistedSettings(config, persistedSettings);\n  await syncRuntimeConfigSettings(config, persistedSettings);\n  const projectMetadata = resolveProjectMetadata(persistedSettings, TARGET_ROOT);\n  const state = buildRuntimeState(previous, config, projectMetadata);\n  debugBoot(\"main:state-merged\");\n\n  state.config.dashboardPort = dashboardPort ? String(dashboardPort) : undefined;\n  state.updatedAt = now();\n  state.booting = false;\n\n  // Detect and lock the default branch once at startup\n  if (!state.config.defaultBranch) {\n    try {\n      const detectedBranch = detectDefaultBranch(TARGET_ROOT);\n      state.config.defaultBranch = detectedBranch;\n      logger.info({ defaultBranch: detectedBranch }, \"[Agent] Default branch detected\");\n    } catch {\n      // Not a git repo or detection failed — leave undefined\n    }\n  }\n\n  if (state.config.agentCommand) {\n    state.notes.push(`Using agent command: ${state.config.agentCommand}`);\n  }\n  state.notes.push(`Agent session max turns: ${state.config.maxTurns}`);\n  state.notes.push(`Agent provider: ${state.config.agentProvider}`);\n  state.notes.push(`Interface mode: ${interfaceMode}`);\n\n  if (!state.config.agentCommand.trim()) {\n    const available = detectedProviders.filter((p) => p.available).map((p) => p.name);\n    fail(\n      available.length === 0\n        ? \"No agent command configured and no providers (claude, codex) found in PATH.\\nInstall claude or codex, or set FIFONY_AGENT_COMMAND.\"\n        : \"No agent command configured. Set FIFONY_AGENT_COMMAND.\",\n    );\n  }\n\n  // Validate config at startup (spec §6.3)\n  const configErrors = validateConfig(config);\n  if (configErrors.length > 0) {\n    for (const err of configErrors) logger.warn(`Config validation: ${err}`);\n  }\n\n  // Clean terminal workspaces in background (non-blocking boot)\n  const terminalIssues = state.issues.filter((i) => i.state === \"Done\" || i.state === \"Cancelled\");\n  if (terminalIssues.length > 0) {\n    logger.info(`Scheduling cleanup of ${terminalIssues.length} terminal workspace(s) in background...`);\n    setImmediate(async () => {\n      for (const issue of terminalIssues) {\n        try { await cleanWorkspace(issue.id, issue, state); } catch {}\n      }\n      logger.info(\"Background workspace cleanup complete.\");\n    });\n  }\n\n  // Recover orphaned agent processes from previous session\n  if (!skipRecovery) {\n    logger.debug({ issueCount: state.issues.filter((i) => i.state === \"Running\" || i.state === \"Queued\").length }, \"[Boot] Checking for orphaned agent processes\");\n    for (const issue of state.issues) {\n      if (issue.state === \"Running\" || issue.state === \"Queued\") {\n        const { alive, pid } = isAgentStillRunning(issue);\n        if (alive && pid) {\n          logger.info(`Agent for ${issue.identifier} still alive (PID ${pid.pid}), keeping state as Running.`);\n          issue.state = \"Running\";\n          addEvent(state, issue.id, \"info\", `Orphaned agent detected (PID ${pid.pid}), still alive — tracking resumed.`);\n        } else {\n          // Agent died — clean PID file, mark as Queued for resumption\n          if (issue.workspacePath) cleanStalePidFile(issue.workspacePath);\n          if (issue.state === \"Running\") {\n            issue.state = \"Queued\";\n            issue.history.push(`[${now()}] Agent process not found on boot — marked Queued.`);\n            addEvent(state, issue.id, \"info\", `Agent for ${issue.identifier} not found, marked Queued.`);\n          }\n        }\n      }\n    }\n  }\n\n  state.metrics = computeMetrics(state.issues);\n  await persistStateFull(state);\n\n  // Initialize queue workers after state is fully ready\n  try {\n    await initQueueWorkers(state);\n  } catch (error) {\n    logger.warn({ err: error }, \"[Boot] Queue workers failed to initialize — continuing without queue-based dispatch\");\n  }\n\n  // Update the API server to use the real state (swap reference)\n  if (dashboardPort) {\n    // The API server closure captures apiState — mutate it to point to real state\n    Object.assign(apiState, state);\n    debugBoot(\"main:api-state-swapped\");\n  }\n\n  const running = new Set<string>();\n  installGracefulShutdown(state, running);\n\n  logger.info(\"[Boot] Runtime ready\");\n  hydrateTokenLedger(state.issues);\n  logger.info(`Loaded issues: ${state.issues.length}`);\n  logger.info(`Worker concurrency: ${state.config.workerConcurrency}`);\n  logger.info(`Max attempts: ${state.config.maxAttemptsDefault}`);\n  logger.info(`Max turns: ${state.config.maxTurns}`);\n  logger.info(`Agent provider: ${state.config.agentProvider}`);\n  logger.info(`Interface mode: ${interfaceMode}`);\n\n  try {\n    addEvent(state, undefined, \"info\", `Runtime started in local-only mode (filesystem tracker).`);\n    const runForever = !runOnce && (Boolean(dashboardPort) || interfaceMode === \"mcp\");\n    logger.info({ runForever, runOnce, dashboardPort, interfaceMode }, \"[Boot] Entering scheduler loop\");\n    await scheduler(state, running, runForever);\n  } catch (error) {\n    console.error(\"FATAL STACK TRACE:\", error);\n    addEvent(state, undefined, \"error\", `Fatal runtime error: ${String(error)}`);\n    await persistState(state);\n    throw error;\n  } finally {\n    state.updatedAt = now();\n    state.metrics = computeMetrics(state.issues);\n    await persistStateFull(state);\n    try { await stopQueueWorkers(); } catch {}\n    await closeStateStore();\n  }\n}\n\nmain().catch((error) => {\n  logger.error({ err: error }, `Fatal runtime error: ${String(error)}`);\n  exit(1);\n});\n","/**\n * Development server that runs Vite dev server alongside the API.\n * Uses dynamic import so vite (devDependency) is only loaded when --dev is used.\n */\nimport { resolve } from \"node:path\";\nimport { PACKAGE_ROOT } from \"./constants.ts\";\nimport { logger } from \"./logger.ts\";\n\nconst VITE_CONFIG_PATH = resolve(PACKAGE_ROOT, \"app/vite.config.js\");\n\nexport async function startDevFrontend(apiPort: number, devPort: number): Promise<void> {\n  let createViteServer: typeof import(\"vite\").createServer;\n  try {\n    const vite = await import(\"vite\");\n    createViteServer = vite.createServer;\n  } catch {\n    logger.warn(\"Vite not installed (devDependency). Run 'pnpm install' in the project to enable --dev mode.\");\n    return;\n  }\n\n  try {\n    const server = await createViteServer({\n      configFile: VITE_CONFIG_PATH,\n      server: {\n        port: devPort,\n        host: true,\n        proxy: {\n          \"/api\": `http://localhost:${apiPort}`,\n          \"/ws\": { target: `ws://localhost:${apiPort}`, ws: true },\n          \"/docs\": `http://localhost:${apiPort}`,\n          \"/health\": `http://localhost:${apiPort}`,\n          \"/manifest.webmanifest\": `http://localhost:${apiPort}`,\n          \"/service-worker.js\": `http://localhost:${apiPort}`,\n          \"/icon.svg\": `http://localhost:${apiPort}`,\n          \"/icon-maskable.svg\": `http://localhost:${apiPort}`,\n          \"/offline.html\": `http://localhost:${apiPort}`,\n        },\n      },\n    });\n\n    await server.listen();\n    logger.info(`Dev frontend available at http://localhost:${devPort}`);\n  } catch (error) {\n    logger.warn(`Failed to start Vite dev server: ${String(error)}`);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/boot.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { mkdirSync } from \"node:fs\";\nimport { env, exit, argv } from \"node:process\";\nimport { CLI_ARGS, PACKAGE_ROOT, STATE_ROOT, TARGET_ROOT } from \"./concerns/constants.ts\";\nimport { debugBoot, fail, now, sleep, parseIntArg } from \"./concerns/helpers.ts\";\nimport { initLogger, logger } from \"./concerns/logger.ts\";\nimport { initStateStore, loadPersistedState, persistState, persistStateFull, closeStateStore } from \"./persistence/store.ts\";\nimport { initQueueWorkers, stopQueueWorkers, enqueueForPlanning, enqueueForExecution, enqueueForReview } from \"./persistence/plugins/queue-workers.ts\";\nimport { createContainer } from \"./persistence/container.ts\";\nimport {\n  applyPersistedSettings,\n  loadRuntimeSettings,\n  persistDetectedProvidersSetting,\n  syncRuntimeConfigSettings,\n} from \"./persistence/settings.ts\";\nimport { buildQueueTitle, detectProjectName, resolveProjectMetadata } from \"./domains/project.ts\";\nimport {\n  detectAvailableProviders,\n  resolveDefaultProvider,\n  getProviderDefaultCommand,\n} from \"./agents/providers.ts\";\nimport { setSkipSource, detectDefaultBranch } from \"./domains/workspace.ts\";\nimport { deriveConfig, applyWorkflowConfig, buildRuntimeState, computeMetrics, addEvent, validateConfig } from \"./domains/issues.ts\";\nimport { hasDirtyState } from \"./persistence/dirty-tracker.ts\";\nimport { executeTransition } from \"./persistence/plugins/issue-state-machine.ts\";\nimport { startApiServer } from \"./persistence/plugins/api-server.ts\";\nimport { installGracefulShutdown, isShuttingDown, ensureNotStale, hasTerminalQueue } from \"./persistence/plugins/scheduler.ts\";\nimport { cleanWorkspace, isAgentStillRunning, cleanStalePidFile } from \"./agents/agent.ts\";\nimport { recoverPlanningSession } from \"./agents/planning/issue-planner.ts\";\nimport { hydrate as hydrateTokenLedger } from \"./domains/tokens.ts\";\nimport { resolve } from \"node:path\";\nimport type { RuntimeState } from \"./types.ts\";\n\nfunction parsePort(args: string[]): number | undefined {\n  for (let i = 0; i < args.length; i += 1) {\n    const arg = args[i];\n    if (arg === \"--port\") {\n      const value = args[i + 1];\n      if (!value || !/^\\d+$/.test(value)) {\n        fail(`Invalid value for --port: ${value ?? \"<empty>\"}`);\n      }\n      return parseIntArg(value, 4040);\n    }\n  }\n  return undefined;\n}\n\nasync function startDevFrontend(apiPort: number, devPort: number): Promise<void> {\n  const VITE_CONFIG_PATH = resolve(PACKAGE_ROOT, \"app/vite.config.js\");\n  let createViteServer: typeof import(\"vite\").createServer;\n  try {\n    const vite = await import(\"vite\");\n    createViteServer = vite.createServer;\n  } catch {\n    logger.warn(\"Vite not installed (devDependency). Run 'pnpm install' in the project to enable --dev mode.\");\n    return;\n  }\n  // Wait for the API server to be ready before starting the proxy\n  for (let attempt = 0; attempt < 20; attempt++) {\n    try {\n      const res = await fetch(`http://localhost:${apiPort}/api/health`);\n      if (res.ok) break;\n    } catch {\n      await new Promise((r) => setTimeout(r, 250));\n    }\n  }\n\n  try {\n    const server = await createViteServer({\n      configFile: VITE_CONFIG_PATH,\n      customLogger: {\n        info: (msg: string) => logger.info(`[Vite] ${msg}`),\n        warn: (msg: string) => logger.warn(`[Vite] ${msg}`),\n        warnOnce: (msg: string) => logger.warn(`[Vite] ${msg}`),\n        error: (msg: string) => {\n          if (msg.includes(\"ws proxy error\") || msg.includes(\"ws proxy socket error\")) {\n            logger.debug(`[Vite] ${msg.split(\"\\n\")[0]} (transient, suppressed)`);\n            return;\n          }\n          logger.error(`[Vite] ${msg}`);\n        },\n        hasErrorLogged: () => false,\n        clearScreen: () => {},\n        hasWarned: false,\n      },\n      server: {\n        port: devPort,\n        host: true,\n        proxy: {\n          \"/api\": `http://localhost:${apiPort}`,\n          \"/ws\": {\n            target: `ws://localhost:${apiPort}`,\n            ws: true,\n            configure: (proxy) => {\n              const silence = (err: any) => {\n                logger.debug(`[Vite] WS proxy transient: ${err.code || err.message}`);\n              };\n              proxy.on(\"error\", silence);\n              proxy.on(\"proxyReqWs\", (_proxyReq: any, _req: any, socket: any) => {\n                socket.on(\"error\", silence);\n              });\n            },\n          },\n          \"/docs\": `http://localhost:${apiPort}`,\n          \"/health\": `http://localhost:${apiPort}`,\n          \"/manifest.webmanifest\": `http://localhost:${apiPort}`,\n          \"/service-worker.js\": `http://localhost:${apiPort}`,\n          \"/icon.svg\": `http://localhost:${apiPort}`,\n          \"/icon-maskable.svg\": `http://localhost:${apiPort}`,\n          \"/offline.html\": `http://localhost:${apiPort}`,\n        },\n      },\n    });\n    await server.listen();\n    logger.info(`Dev frontend available at http://localhost:${devPort}`);\n  } catch (error) {\n    logger.warn(`Failed to start Vite dev server: ${String(error)}`);\n  }\n}\n\nfunction usage() {\n  console.log(\n    `Usage: ${argv[1]} [options]\\n` +\n    \"Options:\\n\" +\n    \"  --workspace <path>     Target workspace root (default: current directory)\\n\" +\n    \"  --persistence <path>   Persistence root (default: current directory)\\n\" +\n    \"  --port <n>             Start local dashboard\\n\" +\n    \"  --concurrency <n>      Maximum number of local workers\\n\" +\n    \"  --attempts <n>         Maximum attempts per issue\\n\" +\n    \"  --poll <ms>            Scheduler interval in ms\\n\" +\n    \"  --timeout <ms>         Agent command timeout in ms (default: 1800000)\\n\" +\n    \"  --dev                   Start Vite dev server alongside API (HMR on port+1)\\n\" +\n    \"  --once                  Process once and exit\\n\" +\n    \"  --skip-source           Skip source snapshot copy\\n\" +\n    \"  --skip-scan             Skip project analysis\\n\" +\n    \"  --skip-recovery         Skip orphaned agent recovery\\n\" +\n    \"  --fast-boot             Equivalent to --skip-source --skip-scan --skip-recovery\\n\",\n  );\n}\n\nasync function main() {\n  debugBoot(\"main:start\");\n\n  const args = CLI_ARGS;\n  if (args.includes(\"--help\") || args.includes(\"-h\")) {\n    usage();\n    return;\n  }\n\n  mkdirSync(STATE_ROOT, { recursive: true });\n  initLogger(STATE_ROOT);\n  logger.info(\"[Boot] Fifony runtime starting\");\n  logger.info({ stateRoot: STATE_ROOT, cwd: process.cwd() }, \"[Boot] State root initialized\");\n\n  // Detect available providers\n  const detectedProviders = detectAvailableProviders();\n  for (const p of detectedProviders) {\n    logger.info(`Provider ${p.name}: ${p.available ? `available at ${p.path}` : \"not found\"}`);\n  }\n\n  const interfaceMode = (env.FIFONY_INTERFACE ?? \"cli\").trim().toLowerCase();\n  const runOnce = args.includes(\"--once\");\n  const devMode = args.includes(\"--dev\") || env.NODE_ENV === \"development\";\n  const fastBoot = args.includes(\"--fast-boot\");\n  const skipSource = fastBoot || args.includes(\"--skip-source\");\n  if (skipSource) setSkipSource(true);\n\n  debugBoot(\"main:state-root-ready\");\n\n  const port = parsePort(args);\n  let config = applyWorkflowConfig(deriveConfig(args), port);\n\n  // Auto-resolve provider command if not configured\n  if (!config.agentCommand.trim()) {\n    const defaultProvider = resolveDefaultProvider(detectedProviders);\n    if (defaultProvider) {\n      const defaultCommand = getProviderDefaultCommand(defaultProvider);\n      if (defaultCommand) {\n        config = { ...config, agentProvider: defaultProvider, agentCommand: defaultCommand };\n        logger.info(`Auto-detected provider: ${defaultProvider} → ${defaultCommand}`);\n      }\n    }\n  }\n\n  const dashboardPort = port ?? (config.dashboardPort ? Number.parseInt(config.dashboardPort, 10) : undefined);\n  const skipRecovery = args.includes(\"--skip-recovery\") || args.includes(\"--fast-boot\");\n  const detectedProjectName = detectProjectName(TARGET_ROOT);\n\n  // ── Phase B: Parallel initialization ────────────────────────────────────────\n  debugBoot(\"main:phase-b-start\");\n  logger.debug(\"[Boot] Initializing state store (s3db)\");\n  await initStateStore();\n  logger.info(\"[Boot] State store initialized\");\n  debugBoot(\"main:store-initialized\");\n\n  // ── Early API start: dashboard available while boot continues ─────────────\n  // Build a minimal placeholder state for the early API server\n  const earlyState: RuntimeState = {\n    projectName: detectedProjectName,\n    detectedProjectName,\n    projectNameSource: detectedProjectName ? \"detected\" : \"missing\",\n    queueTitle: buildQueueTitle(detectedProjectName),\n    startedAt: now(),\n    updatedAt: now(),\n    trackerKind: \"filesystem\",\n    sourceRepoUrl: TARGET_ROOT,\n    sourceRef: \"workspace\",\n    config,\n    issues: [],\n    events: [],\n    metrics: { total: 0, planning: 0, queued: 0, inProgress: 0, blocked: 0, done: 0, cancelled: 0, activeWorkers: 0 },\n    notes: [],\n    booting: true,\n  };\n\n  let apiState = earlyState;\n  // Initialize container early so API routes can use commands immediately\n  createContainer(apiState);\n  debugBoot(\"main:container-early-init\");\n\n  if (dashboardPort) {\n    await startApiServer(apiState, dashboardPort);\n    debugBoot(\"main:api-server-early-start\");\n\n    if (devMode) {\n      const devPort = dashboardPort + 1;\n      await startDevFrontend(dashboardPort, devPort);\n    }\n  }\n\n  // ── Phase C: Parallel state loading ─────────────────────────────────────────\n  debugBoot(\"main:phase-c-start\");\n  logger.debug(\"[Boot] Loading persisted state, settings, and recovering sessions\");\n  const [previous, persistedSettings] = await Promise.all([\n    loadPersistedState(),\n    loadRuntimeSettings(),\n    persistDetectedProvidersSetting(detectedProviders),\n    recoverPlanningSession(),\n  ]);\n  logger.info({ hadPreviousState: previous !== null, issueCount: previous?.issues?.length ?? 0, settingsCount: persistedSettings.length }, \"[Boot] State loaded from persistence\");\n  debugBoot(\"main:state-loaded\");\n\n  config = applyPersistedSettings(config, persistedSettings);\n  await syncRuntimeConfigSettings(config, persistedSettings);\n  const projectMetadata = resolveProjectMetadata(persistedSettings, TARGET_ROOT);\n  const state = buildRuntimeState(previous, config, projectMetadata);\n  debugBoot(\"main:state-merged\");\n\n  state.config.dashboardPort = dashboardPort ? String(dashboardPort) : undefined;\n  state.updatedAt = now();\n  state.booting = false;\n\n  // Reconcile in-memory state with FSM persisted state (source of truth)\n  try {\n    const { getIssueStateMachinePlugin, ISSUE_STATE_MACHINE_ID } = await import(\"./persistence/plugins/issue-state-machine.ts\");\n    const fsmPlugin = getIssueStateMachinePlugin();\n    if (fsmPlugin?.getState) {\n      for (const issue of state.issues) {\n        try {\n          const fsmState = await fsmPlugin.getState(ISSUE_STATE_MACHINE_ID, issue.id);\n          if (fsmState && fsmState !== issue.state) {\n            logger.warn({ issueId: issue.id, memoryState: issue.state, fsmState }, \"[Boot] Reconciling desync — FSM is source of truth\");\n            issue.state = fsmState as typeof issue.state;\n          }\n        } catch { /* FSM entity may not exist yet */ }\n      }\n    }\n  } catch { /* FSM plugin may not be ready */ }\n\n  // Detect and lock the default branch once at startup\n  if (!state.config.defaultBranch) {\n    try {\n      const detectedBranch = detectDefaultBranch(TARGET_ROOT);\n      state.config.defaultBranch = detectedBranch;\n      logger.info({ defaultBranch: detectedBranch }, \"[Agent] Default branch detected\");\n    } catch {\n      // Not a git repo or detection failed — leave undefined\n    }\n  }\n\n  if (state.config.agentCommand) {\n    state.notes.push(`Using agent command: ${state.config.agentCommand}`);\n  }\n  state.notes.push(`Agent session max turns: ${state.config.maxTurns}`);\n  state.notes.push(`Agent provider: ${state.config.agentProvider}`);\n  state.notes.push(`Interface mode: ${interfaceMode}`);\n\n  if (!state.config.agentCommand.trim()) {\n    const available = detectedProviders.filter((p) => p.available).map((p) => p.name);\n    fail(\n      available.length === 0\n        ? \"No agent command configured and no providers (claude, codex) found in PATH.\\nInstall claude or codex, or set FIFONY_AGENT_COMMAND.\"\n        : \"No agent command configured. Set FIFONY_AGENT_COMMAND.\",\n    );\n  }\n\n  // Validate config at startup (spec §6.3)\n  const configErrors = validateConfig(config);\n  if (configErrors.length > 0) {\n    for (const err of configErrors) logger.warn(`Config validation: ${err}`);\n  }\n\n  // Clean terminal workspaces in background (non-blocking boot)\n  const terminalIssues = state.issues.filter((i) => i.state === \"Done\" || i.state === \"Cancelled\");\n  if (terminalIssues.length > 0) {\n    logger.info(`Scheduling cleanup of ${terminalIssues.length} terminal workspace(s) in background...`);\n    setImmediate(async () => {\n      for (const issue of terminalIssues) {\n        try { await cleanWorkspace(issue.id, issue, state); } catch {}\n      }\n      logger.info(\"Background workspace cleanup complete.\");\n    });\n  }\n\n  // Recover orphaned agent processes from previous session\n  if (!skipRecovery) {\n    logger.debug({ issueCount: state.issues.filter((i) => i.state === \"Running\" || i.state === \"Queued\").length }, \"[Boot] Checking for orphaned agent processes\");\n    for (const issue of state.issues) {\n      if (issue.state === \"Running\" || issue.state === \"Queued\") {\n        const { alive, pid } = isAgentStillRunning(issue);\n        if (alive && pid) {\n          logger.info(`Agent for ${issue.identifier} still alive (PID ${pid.pid}), keeping state as Running.`);\n          if (issue.state !== \"Running\") {\n            try { await executeTransition(issue, \"RUN\", { issue, note: `Orphaned agent detected (PID ${pid.pid}), still alive — tracking resumed.` }); }\n            catch { issue.state = \"Running\"; }\n          }\n          addEvent(state, issue.id, \"info\", `Orphaned agent detected (PID ${pid.pid}), still alive — tracking resumed.`);\n        } else {\n          // Agent died — clean PID file, mark as Queued for resumption\n          if (issue.workspacePath) cleanStalePidFile(issue.workspacePath);\n          if (issue.state === \"Running\") {\n            try { await executeTransition(issue, \"REQUEUE\", { issue, note: `Agent process not found on boot — marked Queued.` }); }\n            catch { issue.state = \"Queued\"; }\n            addEvent(state, issue.id, \"info\", `Agent for ${issue.identifier} not found, marked Queued.`);\n          }\n        }\n      }\n    }\n  }\n\n  state.metrics = computeMetrics(state.issues);\n\n  // Swap state into API server IMMEDIATELY so the dashboard shows real data\n  if (dashboardPort) {\n    Object.assign(apiState, state);\n    debugBoot(\"main:api-state-swapped\");\n  }\n  createContainer(apiState);\n  logger.info(\"[Boot] DI container initialized with full state\");\n\n  await persistStateFull(state);\n\n  // Initialize queue workers (can be slow — dashboard already has real data)\n  try {\n    await initQueueWorkers(state);\n  } catch (error) {\n    logger.warn({ err: error }, \"[Boot] Queue workers failed to initialize — continuing without queue-based dispatch\");\n  }\n\n  const running = new Set<string>();\n  installGracefulShutdown(state, running);\n\n  logger.info(\"[Boot] Runtime ready\");\n  hydrateTokenLedger(state.issues);\n  logger.info(`Loaded issues: ${state.issues.length}`);\n  logger.info(`Worker concurrency: ${state.config.workerConcurrency}`);\n  logger.info(`Max attempts: ${state.config.maxAttemptsDefault}`);\n  logger.info(`Max turns: ${state.config.maxTurns}`);\n  logger.info(`Agent provider: ${state.config.agentProvider}`);\n  logger.info(`Interface mode: ${interfaceMode}`);\n\n  try {\n    addEvent(state, undefined, \"info\", `Runtime started in local-only mode (filesystem tracker).`);\n    const runForever = !runOnce && (Boolean(dashboardPort) || interfaceMode === \"mcp\");\n    logger.info({ runForever, runOnce, dashboardPort, interfaceMode }, \"[Boot] Entering queue supervisor loop\");\n\n    // Boot recovery: enqueue all in-progress issues so queue workers pick them up\n    for (const issue of state.issues) {\n      try {\n        if (issue.state === \"Planning\" && issue.planningStatus !== \"planning\") {\n          await enqueueForPlanning(issue);\n        } else if (issue.state === \"Queued\" || issue.state === \"Running\") {\n          await enqueueForExecution(issue);\n        } else if (issue.state === \"Reviewing\") {\n          await enqueueForReview(issue);\n        }\n      } catch (err) {\n        logger.error({ err, issueId: issue.id, state: issue.state }, \"[Boot] Failed to enqueue issue for recovery\");\n      }\n    }\n\n    const PERSIST_DEBOUNCE_MS = 5_000;\n    let lastPersistAt = 0;\n\n    if (runForever) {\n      while (!isShuttingDown()) {\n        // Take a snapshot of states before stale recovery so we can detect transitions\n        const statesBefore = new Map(state.issues.map((i) => [i.id, i.state]));\n        await ensureNotStale(state, state.config.staleInProgressTimeoutMs);\n\n        // Re-enqueue any issues that just changed state due to stale recovery or retry eligibility\n        for (const issue of state.issues) {\n          const prev = statesBefore.get(issue.id);\n          if (prev !== issue.state) {\n            if (issue.state === \"Queued\") enqueueForExecution(issue).catch(() => {});\n            else if (issue.state === \"Reviewing\") enqueueForReview(issue).catch(() => {});\n            else if (issue.state === \"Planning\") enqueueForPlanning(issue).catch(() => {});\n          }\n        }\n\n        state.updatedAt = now();\n        if (hasDirtyState() || Date.now() - lastPersistAt > PERSIST_DEBOUNCE_MS) {\n          await persistState(state);\n          lastPersistAt = Date.now();\n        }\n        await sleep(1_000);\n      }\n    } else {\n      // Batch mode: wait until all issues reach terminal states\n      while (!hasTerminalQueue(state)) {\n        await sleep(state.config.pollIntervalMs);\n      }\n    }\n  } catch (error) {\n    console.error(\"FATAL STACK TRACE:\", error);\n    addEvent(state, undefined, \"error\", `Fatal runtime error: ${String(error)}`);\n    await persistState(state);\n    throw error;\n  } finally {\n    state.updatedAt = now();\n    state.metrics = computeMetrics(state.issues);\n    await persistStateFull(state);\n    try { await stopQueueWorkers(); } catch {}\n    await closeStateStore();\n  }\n}\n\nmain().catch((error) => {\n  logger.error({ err: error }, `Fatal runtime error: ${String(error)}`);\n  exit(1);\n});\n"],"mappings":"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","names":[]}

package/dist/{chunk-O665NS5E.js → chunk-DD5BE2W6.js}

@@ -1,4 +1,4 @@
-// src/agent/constants.ts
+// src/concerns/constants.ts
 import { basename, dirname, join, resolve } from "path";
 import { fileURLToPath } from "url";
 import { env, argv, cwd as getCwd } from "process";
@@ -36,9 +36,7 @@ var SOURCE_ROOT = `${STATE_ROOT}/source`;
 var WORKSPACE_ROOT = `${STATE_ROOT}/workspaces`;
 var SOURCE_MARKER = `${SOURCE_ROOT}/.fifony-local-source-ready`;
 var ATTACHMENTS_ROOT = `${STATE_ROOT}/attachments`;
-var S3DB_DATABASE_PATH = `${STATE_ROOT}/s3db`;
-var S3DB_BUCKET = env.FIFONY_STORAGE_BUCKET ?? "fifony";
-var S3DB_KEY_PREFIX = env.FIFONY_STORAGE_KEY_PREFIX ?? "state";
+var S3DB_DATABASE_PATH = `${STATE_ROOT}/fifony.sqlite`;
 var S3DB_RUNTIME_RESOURCE = "runtime_state";
 var S3DB_ISSUE_RESOURCE = "issues";
 var S3DB_ISSUE_PLAN_RESOURCE = "issue_plans";
@@ -75,7 +73,7 @@ var SKIP_SOURCE = FAST_BOOT || CLI_ARGS.includes("--skip-source");
 var SKIP_SCAN = FAST_BOOT || CLI_ARGS.includes("--skip-scan");
 var SKIP_RECOVERY = FAST_BOOT || CLI_ARGS.includes("--skip-recovery");
 
-// src/agent/helpers.ts
+// src/concerns/helpers.ts
 import { env as env2 } from "process";
 import { parse as parseYaml } from "yaml";
 function now() {
@@ -537,25 +535,25 @@ function mergeCapabilityProviders(baseProviders, resolution) {
   });
 }
 
-// src/prompting.ts
+// src/agents/prompting.ts
 import { TemplateEngine } from "recker";
 
-// src/generated/prompts.ts
+// src/agents/generated/prompts.ts
 var PROMPT_TEMPLATES = {
   "agent-provider-base": '{{#if isPlanner}}\nRole: planner.\nAnalyze the issue and prepare an execution plan for the implementation agents.\nDo not claim the issue is complete unless the plan itself is the deliverable.\n{{else}}\n{{#if isReviewer}}\nRole: reviewer.\nInspect the workspace and review the current implementation critically.\nIf rework is required, emit `FIFONY_STATUS=continue` and provide actionable `nextPrompt` feedback.\nEmit `FIFONY_STATUS=done` only when the work is acceptable.\n{{else}}\nRole: executor.\nImplement the required changes in the workspace.\nUse any planner guidance or prior reviewer feedback already persisted in the workspace.\n{{/if}}\n{{/if}}\n\n{{#if hasImpeccableOverlay}}\nImpeccable overlay is active.\nRaise the bar on UI polish, clarity, responsiveness, visual hierarchy, and interaction quality.\n{{#if isReviewer}}\nReview with a stricter frontend and product-quality standard than a normal correctness-only pass.\n{{else}}\nWhen touching frontend work, do not settle for baseline implementation quality.\n{{/if}}\n{{/if}}\n\n{{#if hasFrontendDesignOverlay}}\nFrontend-design overlay is active.\nPrefer stronger hierarchy, spacing, and readability decisions over generic implementation choices.\n{{/if}}\n\n{{#if profileInstructions}}\n## Agent Profile\n{{profileInstructions}}\n{{/if}}\n\n{{#if skillContext}}\n{{skillContext}}\n{{/if}}\n\n{{#if capabilityCategory}}\nCapability routing: {{capabilityCategory}}.\nSelection reason: {{selectionReason}}\n{{#if overlays.length}}\nOverlays: {{overlays | join ", "}}.\n{{/if}}\n{{/if}}\n\n{{#if targetPaths.length}}\nTarget paths: {{targetPaths | join ", "}}\n{{/if}}\n\nWorkspace: {{workspacePath}}\n\n{{basePrompt}}\n',
-  // src/prompts/agent-provider-base.stub.md
+  // src/agents/prompts/agent-provider-base.stub.md
   "agent-turn": 'Continue working on {{issueIdentifier}}.\nTurn {{turnIndex}} of {{maxTurns}}.\n\nBase objective:\n{{basePrompt}}\n\nContinuation guidance:\n{{continuation}}\n\nPrevious command output tail:\n```text\n{{outputTail}}\n```\n\nBefore exiting successfully, emit one of the following control markers:\n- `FIFONY_STATUS=continue` if more turns are required.\n- `FIFONY_STATUS=done` if the issue is complete.\n- `FIFONY_STATUS=blocked` if manual intervention is required.\nYou may also write `fifony-result.json` with `{ "status": "...", "summary": "...", "nextPrompt": "..." }`.\n',
-  // src/prompts/agent-turn.stub.md
+  // src/agents/prompts/agent-turn.stub.md
   "compile-execution-claude": '{{#if isPlanner}}\nRole: planner. Analyze the issue and prepare an execution plan.\n{{else}}\n{{#if isReviewer}}\nRole: reviewer. Inspect and review the implementation critically.\n{{else}}\nRole: executor. Implement the required changes.\n{{/if}}\n{{/if}}\n\n{{#if profileInstructions}}\n## Agent Profile\n{{profileInstructions}}\n{{/if}}\n\n{{#if skillContext}}\n{{skillContext}}\n{{/if}}\n\n{{planPrompt}}\n\n{{#if subagentsToUse.length}}\n## Subagent Strategy (Claude-specific)\nYou have access to the Agent tool for spawning subagents. Use them for:\n{{#each subagentsToUse}}\n- **{{name}}** ({{role}}): {{why}}\n{{/each}}\n\nLaunch subagents for independent subtasks to maximize parallelism.\nUse the main thread for coordination and integration.\n{{/if}}\n\n{{#if skillsToUse.length}}\n## Skills to Activate\n{{#each skillsToUse}}\n- Invoke **/{{name}}** - {{why}}\n{{/each}}\n{{/if}}\n\n{{#if suggestedPaths.length}}\nTarget paths: {{suggestedPaths | join ", "}}\n{{/if}}\n\nWorkspace: {{workspacePath}}\n\nIssue: {{issueIdentifier}}\nTitle: {{title}}\nDescription: {{description}}\n\n## Structured Input\nThe file `fifony-execution-payload.json` in the workspace contains the canonical structured data for this task.\nUse it as the source of truth for constraints, success criteria, execution intent, and plan details.\nIf there is any conflict between this prompt and the structured fields in the payload, prioritize the payload.\n\n{{#if validationItems.length}}\n## Pre-completion enforcement\nBefore reporting done, verify:\n{{#each validationItems}}\n- {{value}}\n{{/each}}\n{{/if}}\n',
-  // src/prompts/compile-execution-claude.stub.md
+  // src/agents/prompts/compile-execution-claude.stub.md
   "compile-execution-codex": '{{#if isReviewer}}\nRole: reviewer. Inspect and review the implementation critically.\n{{else}}\n{{#if isPlanner}}\nRole: planner. Analyze and prepare an execution plan.\n{{else}}\nRole: executor. Implement the required changes in the workspace.\n{{/if}}\n{{/if}}\n\n{{#if profileInstructions}}\n## Agent Profile\n{{profileInstructions}}\n{{/if}}\n\n{{#if skillContext}}\n{{skillContext}}\n{{/if}}\n\nIssue: {{issueIdentifier}}\nTitle: {{title}}\nDescription: {{description}}\nWorkspace: {{workspacePath}}\n\n{{planPrompt}}\n\n{{#if phases.length}}\n## Checkpoint Execution (Codex mode)\nExecute in strict phases. After each phase, verify outputs before proceeding.\n{{#each phases}}\n- **{{phaseName}}**: {{goal}}\n{{#if outputs.length}}  Checkpoint: verify {{outputs | join ", "}} before next phase.{{/if}}\n{{/each}}\n{{else}}\n## Execution Order\nExecute steps in order. Verify each step\'s `doneWhen` criterion before proceeding.\n{{/if}}\n\n{{#if suggestedPaths.length}}\nTarget paths: {{suggestedPaths | join ", "}}\nFocus changes on these paths. Do not make unnecessary changes elsewhere.\n{{/if}}\n\n{{#if skillsToUse.length}}\n## Specialized Procedures\n{{#each skillsToUse}}\n- Apply **{{name}}** procedure: {{why}}\n{{/each}}\n{{/if}}\n\n{{#if validationItems.length}}\n## Pre-completion checks\nBefore reporting done, run:\n{{#each validationItems}}\n- {{value}}\n{{/each}}\n{{/if}}\n\n## Structured Input\nThe file `fifony-execution-payload.json` in the workspace contains the canonical structured data for this task.\nUse it as the source of truth for constraints, success criteria, execution intent, and plan details.\nIf there is any conflict between this prompt and the structured fields in the payload, prioritize the payload.\n\n## Output Format\n\n{{outputContract}}\n',
-  // src/prompts/compile-execution-codex.stub.md
+  // src/agents/prompts/compile-execution-codex.stub.md
   "compile-review": "Review the work done for {{issueIdentifier}}.\n\nTitle: {{title}}\nDescription: {{description}}\nWorkspace: {{workspacePath}}\n\n{{#if planPrompt}}\n# Original Execution Plan\n\n{{planPrompt}}\n{{/if}}\n\n{{#if successCriteria.length}}\n# Success Criteria (evaluate against these)\n{{#each successCriteria}}\n- [ ] {{value}}\n{{/each}}\n{{/if}}\n\n{{#if deliverables.length}}\n# Expected Deliverables\n{{#each deliverables}}\n- [ ] {{value}}\n{{/each}}\n{{/if}}\n\n{{#if diffSummary}}\n# Changes Made (diff summary)\n```\n{{diffSummary}}\n```\n{{/if}}\n\n# Structured Context\nIf `fifony-execution-payload.json` exists in the workspace, read it for the canonical structured task data.\nUse the `successCriteria`, `constraints`, and `deliverables` fields as your evaluation checklist.\n\n# Review Instructions\n\n1. Verify each success criterion from the plan is met.\n2. Check that all expected deliverables are present.\n3. Review the diff for correctness, security issues, and code quality.\n4. Verify validation checks pass (run commands if specified in the plan).\n5. Check for unintended side effects or regressions.\n\nIf the work is acceptable, emit FIFONY_STATUS=done.\nIf rework is needed, emit FIFONY_STATUS=continue and provide actionable feedback in nextPrompt.\nIf the work is fundamentally broken, emit FIFONY_STATUS=blocked.\n",
-  // src/prompts/compile-review.stub.md
+  // src/agents/prompts/compile-review.stub.md
   "integrations-agency-agents": '---\nagent:\n  providers:\n    - provider: claude\n      role: planner\n      profile: agency-senior-project-manager\n    - provider: codex\n      role: executor\n      profile: agency-senior-developer\n    - provider: claude\n      role: reviewer\n      profile: agency-code-reviewer\ncodex:\n  command: "codex"\nclaude:\n  command: "claude"\n---\n\nUse local agency agent profiles discovered from workspace or home directories.\nWorkspace: {{workspaceRoot}}\n',
-  // src/prompts/integrations-agency-agents.stub.md
+  // src/agents/prompts/integrations-agency-agents.stub.md
   "integrations-impeccable": '# Impeccable integration idea\n\nUse impeccable-oriented skills as a frontend review layer around fifony issues.\n\nSuggested pattern:\n\n1. Use `agency-senior-developer` or `codex` as executor.\n2. Route UI-heavy issues to a reviewer prompt that explicitly asks for impeccable-style critique.\n3. Expose the resulting review through the fifony MCP prompts or as a follow-up review issue.\n\nSuggested labels:\n- frontend\n- ui\n- design-system\n\nSuggested reviewer prompt seed:\n"Review this implementation using impeccable standards for frontend quality, polish, hierarchy, spacing, responsiveness, and interaction clarity."\n',
-  // src/prompts/integrations-impeccable.stub.md
+  // src/agents/prompts/integrations-impeccable.stub.md
   "issue-enhancer-description": `You are helping improve issue metadata for a software execution queue.
 Rewrite the description to be clearer, complete, and directly actionable.
 Return strict JSON only with this schema:
@@ -582,9 +580,9 @@ Rules:
 - Avoid extra wrappers, outer quotes, or extra explanation.
 - The value should be in Portuguese if the input is in Portuguese; otherwise in English.
 `,
-  // src/prompts/issue-enhancer-description.stub.md
+  // src/agents/prompts/issue-enhancer-description.stub.md
   "issue-enhancer-title": 'You are helping improve issue metadata for a software execution queue.\nRewrite the title for clarity, actionability, and specificity.\nReturn strict JSON only with this schema:\n{ "field": "title", "value": "..." }\n\nIssue type: {{issueType}}\nCurrent title: {{title}}\nDescription context: {{description}}\n{{#if images}}\nVisual evidence (attached screenshots for context):\n{{#each images}}\n- {{this}}\n{{/each}}\n{{/if}}\n\nRules:\n- Keep it concise and suitable as a task title.\n- Use imperative language when possible.\n- If the issue type is "bug", start with "fix: ". If "feature", start with "feat: ". If "refactor", start with "refactor: ". If "docs", start with "docs: ". If "chore", start with "chore: ". For "blank", use no prefix.\n- Do not include markdown, quotes, or extra explanation.\n- The value should be in Portuguese if the input is in Portuguese; otherwise in English.\n',
-  // src/prompts/issue-enhancer-title.stub.md
+  // src/agents/prompts/issue-enhancer-title.stub.md
   "issue-planner": `You are a senior technical execution planner.
 Produce the best possible plan for the issue below, filling the JSON schema precisely.
 {{#if fast}}
@@ -633,50 +631,51 @@ Effort suggestion:
 - Set per-role if different: planner, executor, reviewer
 {{/unless}}
 
-Return strict JSON matching EXACTLY this schema. No text outside JSON. Use these exact field names:
+Return strict JSON matching this schema. No text outside JSON. Use these exact field names.
+IMPORTANT: Replace ALL placeholder values with real content specific to the issue above. Do NOT copy the example values literally \u2014 every field must contain actual plan content derived from the issue.
 
 \`\`\`json
 {
-  "summary": "one-line summary of what needs to be done",
+  "summary": "<YOUR one-line summary here>",
   "estimatedComplexity": "trivial|low|medium|high",
   "steps": [
     {
       "step": 1,
-      "action": "what to do (concrete, specific)",
-      "files": ["path/to/file.ts"],
-      "details": "additional context if needed",
+      "action": "<YOUR concrete action here>",
+      "files": ["<real/path/to/file.ts>"],
+      "details": "<YOUR additional context>",
       "ownerType": "agent|human|skill|subagent|tool",
-      "doneWhen": "acceptance criterion as a single string"
+      "doneWhen": "<YOUR acceptance criterion>"
     }
   ],
-  "assumptions": ["..."],
-  "constraints": ["..."],
+  "assumptions": ["<YOUR assumptions>"],
+  "constraints": ["<YOUR constraints>"],
   "unknowns": [
-    { "question": "...", "whyItMatters": "...", "howToResolve": "..." }
+    { "question": "<YOUR question>", "whyItMatters": "<YOUR reason>", "howToResolve": "<YOUR approach>" }
   ],
-  "successCriteria": ["..."],
+  "successCriteria": ["<YOUR criteria>"],
   "risks": [
-    { "risk": "...", "impact": "...", "mitigation": "..." }
+    { "risk": "<YOUR risk>", "impact": "<YOUR impact>", "mitigation": "<YOUR mitigation>" }
   ],
-  "suggestedPaths": ["path/to/relevant/file.ts"],
-  "suggestedLabels": ["frontend", "bug", "feature", "..."],
+  "suggestedPaths": ["<real/path/to/relevant/file.ts>"],
+  "suggestedLabels": ["frontend", "bug", "feature"],
   "suggestedEffort": { "default": "medium", "planner": "low", "executor": "medium", "reviewer": "medium" }
 }
 \`\`\`
 `,
-  // src/prompts/issue-planner.stub.md
+  // src/agents/prompts/issue-planner.stub.md
   "issue-planner-refine": "You are a senior technical execution planner refining an existing plan based on user feedback.\n\n## Original Issue\nTitle: {{title}}\nDescription: {{description}}\n\n## Current Plan (JSON)\n```json\n{{currentPlan}}\n```\n\n## User Feedback\n{{feedback}}\n\n## Instructions\n\nRevise the plan above to address the user's feedback precisely.\n\nRules:\n- Keep all parts of the plan that are NOT affected by the feedback unchanged.\n- Only modify, add, or remove elements that the feedback specifically requests.\n- Preserve the same JSON schema structure as the current plan.\n- Maintain step numbering consistency after changes.\n- If feedback asks to add steps, insert them in the logical position and renumber.\n- If feedback asks to remove steps, renumber remaining steps sequentially.\n- Update the summary if the overall direction changed.\n- Re-evaluate estimatedComplexity if the scope changed significantly.\n- Update suggestedPaths and suggestedLabels if affected by the changes.\n\nReturn strict JSON. No text outside JSON.\n",
-  // src/prompts/issue-planner-refine.stub.md
+  // src/agents/prompts/issue-planner-refine.stub.md
   "mcp-integrate-client": "Integrate {{client}} with the local fifony MCP server.\n\nGoal: {{goal}}\n\n{{integrationGuide}}\n\nUse the available fifony resources and tools instead of inventing your own persistence model.\n",
-  // src/prompts/mcp-integrate-client.stub.md
+  // src/agents/prompts/mcp-integrate-client.stub.md
   "mcp-integration-guide": '# fifony MCP integration\n\nWorkspace root: `{{workspaceRoot}}`\nPersistence root: `{{persistenceRoot}}`\nState root: `{{stateRoot}}`\n\nRecommended MCP client command:\n\n```json\n{\n  "mcpServers": {\n    "fifony": {\n      "command": "npx",\n      "args": ["fifony", "mcp", "--workspace", "{{workspaceRoot}}", "--persistence", "{{persistenceRoot}}"]\n    }\n  }\n}\n```\n\nExpected workflow:\n\n1. Read `fifony://guide/overview` and `fifony://state/summary`.\n2. Use `fifony.list_issues` or read `fifony://issues`.\n3. Create work with `fifony.create_issue`.\n4. Update workflow state with `fifony.update_issue_state`.\n5. Use the prompts exposed by this MCP server to structure planning or execution.\n\nThe MCP server is read-write against the same `s3db` filesystem store used by the fifony runtime.\n',
-  // src/prompts/mcp-integration-guide.stub.md
+  // src/agents/prompts/mcp-integration-guide.stub.md
   "mcp-issue": 'You are integrating with fifony as the {{role}} using {{provider}}.\n\nIssue ID: {{id}}\nTitle: {{title}}\nState: {{state}}\nCapability category: {{capabilityCategory}}\n{{#if overlays.length}}\nOverlays: {{overlays | join ", "}}\n{{/if}}\n{{#if paths.length}}\nPaths: {{paths | join ", "}}\n{{/if}}\nDescription:\n{{description}}\n\nUse fifony as the source of truth:\n- Persist transitions through the fifony tools instead of inventing local state.\n- Keep outputs actionable and aligned with the tracked issue lifecycle.\n',
-  // src/prompts/mcp-issue.stub.md
+  // src/agents/prompts/mcp-issue.stub.md
   "mcp-review-workflow": "Review the pipeline configuration for this fifony workspace as {{provider}}.\n\nWorkspace: {{workspaceRoot}}\n\nFocus on:\n- provider orchestration quality (plan/execute/review stages)\n- hooks safety (beforeRun, afterRun, afterCreate, beforeRemove)\n- prompt clarity\n- issue lifecycle correctness\n- what an MCP client needs in order to integrate cleanly\n",
-  // src/prompts/mcp-review-workflow.stub.md
+  // src/agents/prompts/mcp-review-workflow.stub.md
   "mcp-route-task": "Use this routing decision as the execution plan for the task.\n\n{{resolutionJson}}\n",
-  // src/prompts/mcp-route-task.stub.md
+  // src/agents/prompts/mcp-route-task.stub.md
   "project-analysis": `You are analyzing a software project to help configure an AI-powered development assistant.
 
 Look at the project structure, source code, configuration files, and any documentation you can find. Pay special attention to:
@@ -702,14 +701,14 @@ For "suggestedAgents", choose from: frontend-developer, backend-architect, datab
 
 Return ONLY the JSON object. No markdown fences, no explanation, no extra text.
 `,
-  // src/prompts/project-analysis.stub.md
+  // src/agents/prompts/project-analysis.stub.md
   "workflow-default": "You are working on {{issue.identifier}}.\n\nTitle: {{issue.title}}\nDescription:\n{{issue.description}}\n",
-  // src/prompts/workflow-default.stub.md
+  // src/agents/prompts/workflow-default.stub.md
   "workflow-plan-section": '## Execution Plan\n\nComplexity: {{estimatedComplexity}}\nSummary: {{summary}}\n\nSteps:\n{{#each steps}}\n{{step}}. {{action}}{{#if files.length}} (files: {{files | join ", "}}){{/if}}{{#if details}} - {{details}}{{/if}}\n{{/each}}\n\nFollow this plan. Complete each step in order.\n'
-  // src/prompts/workflow-plan-section.stub.md
+  // src/agents/prompts/workflow-plan-section.stub.md
 };
 
-// src/prompting.ts
+// src/agents/prompting.ts
 var engine = new TemplateEngine({
   cache: true,
   format: "raw",
@@ -736,8 +735,6 @@ export {
   SOURCE_MARKER,
   ATTACHMENTS_ROOT,
   S3DB_DATABASE_PATH,
-  S3DB_BUCKET,
-  S3DB_KEY_PREFIX,
   S3DB_RUNTIME_RESOURCE,
   S3DB_ISSUE_RESOURCE,
   S3DB_ISSUE_PLAN_RESOURCE,
@@ -782,4 +779,4 @@ export {
   mergeCapabilityProviders,
   renderPrompt
 };
-//# sourceMappingURL=chunk-O665NS5E.js.map
+//# sourceMappingURL=chunk-DD5BE2W6.js.map