fifony 0.1.42 → 0.1.43

package/dist/chunk-2CVTK5F2.js

@@ -1,288 +0,0 @@
-import {
-  ALLOWED_STATES,
-  DEBUG_BOOT
-} from "./chunk-37N5OFHM.js";
-
-// src/concerns/helpers.ts
-import { env } from "process";
-import { parse as parseYaml } from "yaml";
-function now() {
-  return (/* @__PURE__ */ new Date()).toISOString();
-}
-function isoWeek(date) {
-  const d = date ? new Date(date) : /* @__PURE__ */ new Date();
-  if (Number.isNaN(d.getTime())) return "";
-  const tmp = new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
-  const dayNum = tmp.getUTCDay() || 7;
-  tmp.setUTCDate(tmp.getUTCDate() + 4 - dayNum);
-  const yearStart = new Date(Date.UTC(tmp.getUTCFullYear(), 0, 1));
-  const weekNo = Math.ceil(((tmp.getTime() - yearStart.getTime()) / 864e5 + 1) / 7);
-  return `${tmp.getUTCFullYear()}-W${String(weekNo).padStart(2, "0")}`;
-}
-function resolveEnvVar(value) {
-  if (!value.startsWith("$")) return value;
-  const varName = value.slice(1);
-  const resolved = env[varName];
-  return resolved && resolved.trim().length > 0 ? resolved.trim() : "";
-}
-function toStringValue(value, fallback = "") {
-  if (typeof value !== "string" || value.trim().length === 0) return fallback;
-  const trimmed = value.trim();
-  if (trimmed.startsWith("$") && /^\$[A-Za-z_][A-Za-z0-9_]*$/.test(trimmed)) {
-    const resolved = resolveEnvVar(trimmed);
-    return resolved.length > 0 ? resolved : fallback;
-  }
-  return trimmed;
-}
-function toNumberValue(value, fallback = 1) {
-  const parsed = typeof value === "number" ? value : typeof value === "string" ? Number.parseInt(value, 10) : Number.NaN;
-  return Number.isFinite(parsed) && parsed > 0 ? Math.round(parsed) : fallback;
-}
-function toBooleanValue(value, fallback) {
-  return typeof value === "boolean" ? value : fallback;
-}
-function toStringArray(value) {
-  if (!Array.isArray(value)) return [];
-  return value.filter((entry) => typeof entry === "string" && entry.trim().length > 0).map((entry) => entry.trim());
-}
-function clamp(value, min, max) {
-  return Math.min(Math.max(value, min), max);
-}
-function parseIssueState(value) {
-  const raw = typeof value === "string" ? value.trim() : "";
-  if (ALLOWED_STATES.includes(raw)) {
-    return raw;
-  }
-  return void 0;
-}
-function normalizeState(value, fallback = "Planning") {
-  return parseIssueState(value) ?? fallback;
-}
-function parseEnvNumber(name, fallback) {
-  return toNumberValue(env[name], fallback);
-}
-function parseIntArg(value, fallback) {
-  const parsed = Number.parseInt(value, 10);
-  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
-}
-function parsePositiveIntEnv(name, fallback) {
-  const source = env[name];
-  if (!source) return fallback;
-  return parseIntArg(source, fallback);
-}
-function withRetryBackoff(attempt, baseDelayMs) {
-  return Math.min(baseDelayMs * 2 ** attempt, 5 * 60 * 1e3);
-}
-function idToSafePath(value) {
-  return value.toLowerCase().replace(/[^a-z0-9._-]/g, "-");
-}
-function appendFileTail(target, text, maxLength) {
-  const merged = `${target}
-${text}`;
-  if (merged.length <= maxLength) return merged;
-  return `\u2026${merged.slice(-(maxLength - 1))}`;
-}
-function debugBoot(message) {
-  if (!DEBUG_BOOT) return;
-  console.error(`[FIFONY_DEBUG_BOOT] ${message}`);
-}
-function fail(message) {
-  console.error(message);
-  process.exit(1);
-}
-function extractJsonObjects(text) {
-  const results = [];
-  let depth = 0;
-  let start = -1;
-  let inStr = false;
-  let esc = false;
-  for (let i = 0; i < text.length; i++) {
-    const ch = text[i];
-    if (inStr) {
-      if (esc) {
-        esc = false;
-        continue;
-      }
-      if (ch === "\\") {
-        esc = true;
-        continue;
-      }
-      if (ch === '"') {
-        inStr = false;
-      }
-      continue;
-    }
-    if (ch === '"') {
-      inStr = true;
-      continue;
-    }
-    if (ch === "{") {
-      if (depth === 0) start = i;
-      depth++;
-    } else if (ch === "}") {
-      depth = Math.max(0, depth - 1);
-      if (depth === 0 && start >= 0) {
-        results.push(text.slice(start, i + 1));
-        start = -1;
-      }
-    }
-  }
-  return results;
-}
-function repairTruncatedJson(text) {
-  const firstBrace = text.indexOf("{");
-  if (firstBrace < 0) return null;
-  let json = text.slice(firstBrace);
-  let inStr = false;
-  let esc = false;
-  const stack = [];
-  for (let i = 0; i < json.length; i++) {
-    const ch = json[i];
-    if (inStr) {
-      if (esc) {
-        esc = false;
-        continue;
-      }
-      if (ch === "\\") {
-        esc = true;
-        continue;
-      }
-      if (ch === '"') {
-        inStr = false;
-      }
-      continue;
-    }
-    if (ch === '"') {
-      inStr = true;
-      continue;
-    }
-    if (ch === "{") stack.push("{");
-    else if (ch === "[") stack.push("[");
-    else if (ch === "}") {
-      if (stack.length > 0 && stack[stack.length - 1] === "{") stack.pop();
-    } else if (ch === "]") {
-      if (stack.length > 0 && stack[stack.length - 1] === "[") stack.pop();
-    }
-  }
-  if (!inStr && stack.length === 0) return json;
-  if (inStr) {
-    if (json.endsWith("\\")) json = json.slice(0, -1);
-    json += '"';
-  }
-  json = json.replace(/[,:\s]+$/, "");
-  while (stack.length > 0) {
-    const open = stack.pop();
-    json += open === "{" ? "}" : "]";
-  }
-  return json;
-}
-
-// src/agents/prompting.ts
-import { TemplateEngine } from "recker";
-
-// 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 capabilitiesManifest}}\n{{capabilitiesManifest}}\n{{/if}}\n\n{{#if skillContext}}\n{{skillContext}}\n{{/if}}\n\n{{#if targetPaths.length}}\nTarget paths: {{targetPaths | join ", "}}\n{{/if}}\n\nWorkspace: {{workspacePath}}\n\n{{basePrompt}}\n',
-  // 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/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 capabilitiesManifest}}\n{{capabilitiesManifest}}\n{{/if}}\n\n{{#if skillContext}}\n{{skillContext}}\n{{/if}}\n\n{{planPrompt}}\n\n{{#if suggestedAgents.length}}\n## Agents (Claude-specific)\nYou have access to the Agent tool for spawning subagents. Use these agents for this task:\n{{#each suggestedAgents}}\n- Use the **{{this}}** agent for specialized work in its domain.\n{{/each}}\n\nLaunch agents for independent subtasks to maximize parallelism.\nUse the main thread for coordination and integration.\n{{/if}}\n\n{{#if suggestedSkills.length}}\n## Skills\nInvoke these skills during execution:\n{{#each suggestedSkills}}\n- Run **/{{this}}** for specialized quality checks and procedures.\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 `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/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 capabilitiesManifest}}\n{{capabilitiesManifest}}\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 suggestedSkills.length}}\n## Skills\nInvoke these skills during execution:\n{{#each suggestedSkills}}\n- Run **/{{this}}** for specialized quality checks and procedures.\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 `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/agents/prompts/compile-execution-codex.stub.md
-  "compile-review": "Review the work done for {{issueIdentifier}}.\n\nTitle: {{title}}\nDescription: {{description}}\nWorkspace: {{workspacePath}}\n{{#if images.length}}\n\n## Visual Evidence (screenshots attached to this issue)\n{{#each images}}\n- {{this}}\n{{/each}}\nCompare the implementation against these screenshots if they show expected behavior or bugs.\n{{/if}}\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 `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/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/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/agents/prompts/integrations-impeccable.stub.md
-  "issue-enhancer-description": 'You are helping improve issue metadata for a software execution queue.\nRewrite the description to be clearer, complete, and directly actionable.\n\nIssue type: {{issueType}}\nCurrent title: {{title}}\nCurrent description: {{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 but include meaningful acceptance criteria tailored to the issue type.\n- For "bug": focus on problem description, expected behavior, and steps to reproduce.\n- For "feature": focus on goal, acceptance criteria, and any relevant notes.\n- For "refactor": describe current state, desired state, and scope.\n- For "docs": describe what to document and target audience.\n- For "chore": describe the task and why it\'s needed now.\n- Use markdown formatting appropriate for the type (## headings, bullet points).\n- The value should be in Portuguese if the input is in Portuguese; otherwise in English.\n\nAfter your analysis, return a single JSON code block as the LAST thing in your output:\n```json\n{ "field": "description", "value": "<REPLACE_WITH_ACTUAL_DESCRIPTION>" }\n```\n',
-  // 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.\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\nReturn a single JSON code block as the LAST thing in your output:\n```json\n{ "field": "title", "value": "<REPLACE_WITH_ACTUAL_TITLE>" }\n```\n',
-  // src/agents/prompts/issue-enhancer-title.stub.md
-  "issue-planner": 'You are a senior technical execution planner.\nProduce the best possible plan for the issue below, filling the JSON schema precisely.\n{{#if fast}}\n\nFAST MODE: Be brief and direct. Minimize reasoning depth.\n- 2-4 steps maximum. Skip optional fields (unknowns, risks, alternatives).\n- Focus only on: summary, steps, estimatedComplexity, suggestedPaths.\n{{/if}}\n\n{{#if availableCapabilities}}\n## Installed Capabilities (recommend from these lists)\n\n{{#if availableSkills.length}}\n### Skills\n{{#each availableSkills}}\n- **{{name}}**{{#if description}} \u2014 {{description}}{{/if}}{{#if whenToUse}} (Use when: {{whenToUse}}){{/if}}\n{{/each}}\n{{/if}}\n{{#if availableAgents.length}}\n### Agents\n{{#each availableAgents}}\n- **{{name}}**{{#if description}} \u2014 {{description}}{{/if}}{{#if whenToUse}} (Use when: {{whenToUse}}){{/if}}{{#if avoidIf}} (Avoid if: {{avoidIf}}){{/if}}\n{{/each}}\n{{/if}}\n{{#if availableCommands.length}}\n### Commands\n{{#each availableCommands}}\n- /{{name}}\n{{/each}}\n{{/if}}\n\nRecommend skills and agents ONLY from these lists. Do not invent names.\nOnly recommend when there is a concrete benefit \u2014 not everything needs skills or agents.\n{{/if}}\n\nIssue title: {{title}}\nIssue description: {{description}}\n{{#if images}}\nVisual evidence (attached screenshots for context):\n{{#each images}}\n- {{this}}\n{{/each}}\n{{/if}}\n{{#unless fast}}\n\nQuality rules:\n- Be concrete, not generic. No vague phrases like \'implement\' or \'improve\' without detail.\n- Break work into actionable steps (2-8 steps). Each step describes WHAT, not HOW.\n- Each step must have a clear \'doneWhen\' acceptance criterion.\n- Identify assumptions, constraints, unknowns, and risks.\n- For unknowns, specify what question needs answering and how to resolve it.\n- Suggest file paths that are likely relevant to the changes.\n\nComplexity estimation:\n- trivial: < 5 min, single-file cosmetic change\n- low: 5-15 min, small focused change\n- medium: 15-60 min, multi-file change with testing\n- high: > 1 hour, architectural change or new feature\n\nEffort suggestion:\n- low: simple fixes, no deep reasoning needed\n- medium: standard development work\n- high: complex architecture, security, or cross-cutting changes\n- Set per-role if different: planner, executor, reviewer\n{{/unless}}\n\n## Instructions\n\nYou are encouraged to explore the codebase \u2014 read files, search for patterns, inspect structure \u2014 to produce an informed plan. Use any tools available to you.\n\nAfter your analysis, you MUST output the final plan as a single JSON code block (```json ... ```).\nThe JSON block must be the LAST thing in your output. Any analysis or reasoning should come BEFORE it.\n\nIMPORTANT: 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.\n\nUse these exact field names:\n\n```json\n{\n  "summary": "<YOUR one-line summary here>",\n  "estimatedComplexity": "trivial|low|medium|high",\n  "steps": [\n    {\n      "step": 1,\n      "action": "<YOUR concrete action here>",\n      "files": ["<real/path/to/file.ts>"],\n      "details": "<YOUR additional context>",\n      "doneWhen": "<YOUR acceptance criterion>"\n    }\n  ],\n  "assumptions": ["<YOUR assumptions>"],\n  "constraints": ["<YOUR constraints>"],\n  "unknowns": [\n    { "question": "<YOUR question>", "whyItMatters": "<YOUR reason>", "howToResolve": "<YOUR approach>" }\n  ],\n  "successCriteria": ["<YOUR criteria>"],\n  "risks": [\n    { "risk": "<YOUR risk>", "impact": "<YOUR impact>", "mitigation": "<YOUR mitigation>" }\n  ],\n  "suggestedPaths": ["<real/path/to/relevant/file.ts>"],\n  "suggestedSkills": ["<skill-name-from-list-above>"],\n  "suggestedAgents": ["<agent-name-from-list-above>"],\n  "suggestedEffort": { "default": "medium", "planner": "low", "executor": "medium", "reviewer": "medium" }\n}\n```\n',
-  // 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{{#if images}}\n\n## Visual Evidence\n{{#each images}}\n- {{this}}\n{{/each}}\n{{/if}}\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, suggestedSkills, and suggestedAgents if affected by the changes.\n\nYou may explore the codebase to inform your revisions. After your analysis, return the revised plan as a single JSON code block (```json ... ```) as the LAST thing in your output.\n",
-  // 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/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/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}}\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/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/agents/prompts/mcp-review-workflow.stub.md
-  "merge-conflict-resolver": 'You are resolving git merge conflicts in a software project.\n\n## Context\n\nIssue: {{issueIdentifier}} \u2014 {{title}}\n{{#if description}}\nDescription: {{description}}\n{{/if}}\nMerging branch `{{featureBranch}}` into `{{baseBranch}}`.\n\n## Conflicting Files\n\nThe following files have conflict markers (`<<<<<<<`, `=======`, `>>>>>>>`) that you must resolve:\n\n{{#each conflictFiles}}\n- {{this}}\n{{/each}}\n\n## Instructions\n\n1. Read each conflicting file and understand the intent of BOTH sides.\n2. Resolve ALL conflict markers (`<<<<<<<`, `=======`, `>>>>>>>`) by choosing the correct combination of changes. Prefer keeping both sides\' intent when possible.\n3. CRITICAL: Before staging, run `grep -n "^<<<<<<<" <file>` on EACH file to verify zero conflict markers remain. If any markers remain, fix them first.\n4. After verifying each file is clean, stage with `git add <file>`.\n5. Do NOT commit \u2014 the merge commit will be created automatically after you finish.\n6. Do NOT modify files that are not in the conflict list.\n7. Do NOT use `git add .` or `git add -A` \u2014 stage only the conflicting files listed above.\n',
-  // src/agents/prompts/merge-conflict-resolver.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:
-- README, CLAUDE.md, AGENTS.md, or any project documentation
-- Build files: package.json, Cargo.toml, pyproject.toml, build.gradle, Gemfile, go.mod, Makefile, CMakeLists.txt, pom.xml, etc.
-- Source code directories and their contents
-- Configuration files (.env, docker-compose, terraform, etc.)
-- CI/CD pipelines (.github/workflows, .gitlab-ci, Jenkinsfile, etc.)
-
-Return a JSON object with exactly these fields:
-
-{
-  "description": "A concise 2-3 sentence description of what this project does, its purpose, and who it's for.",
-  "language": "The primary programming language (e.g. typescript, python, rust, java, kotlin, ruby, go, swift, c++)",
-  "domains": ["Array of relevant domain tags that apply to this project"],
-  "stack": ["Array of key technologies, frameworks, and tools used"],
-  "suggestedAgents": ["Array of specialist agent names that would help develop this project"]
-}
-
-For "domains", choose from: frontend, backend, mobile, devops, database, ai-ml, security, testing, games, ecommerce, fintech, healthcare, education, saas, design, product, marketing, embedded, blockchain, spatial-computing, data-engineering.
-
-For "suggestedAgents", choose from: frontend-developer, backend-architect, database-optimizer, security-engineer, devops-automator, mobile-app-builder, ai-engineer, ui-designer, ux-architect, code-reviewer, technical-writer, sre, data-engineer, software-architect, game-designer.
-
-Return ONLY the JSON object. No markdown fences, no explanation, no extra text.
-`,
-  // 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/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/agents/prompts/workflow-plan-section.stub.md
-};
-
-// src/agents/prompting.ts
-var engine = new TemplateEngine({
-  cache: true,
-  format: "raw",
-  strict: false
-});
-function normalizePrompt(text) {
-  return text.replace(/\r\n/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
-}
-async function renderPrompt(name, context = {}) {
-  return renderPromptString(PROMPT_TEMPLATES[name], context);
-}
-async function renderPromptString(template, context = {}) {
-  const rendered = await engine.render(template, context);
-  return normalizePrompt(rendered);
-}
-
-export {
-  now,
-  isoWeek,
-  toStringValue,
-  toNumberValue,
-  toBooleanValue,
-  toStringArray,
-  clamp,
-  parseIssueState,
-  normalizeState,
-  parseEnvNumber,
-  parseIntArg,
-  parsePositiveIntEnv,
-  withRetryBackoff,
-  idToSafePath,
-  appendFileTail,
-  debugBoot,
-  fail,
-  extractJsonObjects,
-  repairTruncatedJson,
-  renderPrompt
-};
-//# sourceMappingURL=chunk-2CVTK5F2.js.map

package/dist/chunk-37N5OFHM.js

@@ -1,125 +0,0 @@
-// src/concerns/constants.ts
-import { basename, dirname, join, resolve } from "path";
-import { fileURLToPath } from "url";
-import { env, argv, cwd as getCwd } from "process";
-import { homedir } from "os";
-import { existsSync } from "fs";
-var __filename = fileURLToPath(import.meta.url);
-var __dirname = dirname(__filename);
-function findPackageRoot(startDir) {
-  let dir = startDir;
-  for (let i = 0; i < 5; i++) {
-    if (existsSync(join(dir, "package.json"))) return dir;
-    const parent = dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return resolve(startDir, "../..");
-}
-var PACKAGE_ROOT = findPackageRoot(__dirname);
-var CLI_ARGS = argv.slice(2);
-function readArgValue(args, flag) {
-  const index = args.indexOf(flag);
-  if (index === -1) return void 0;
-  const value = args[index + 1];
-  if (!value || value.startsWith("--")) return void 0;
-  return value;
-}
-function resolveInputPath(value) {
-  if (value.startsWith("~/")) {
-    return resolve(homedir(), value.slice(2));
-  }
-  return resolve(value);
-}
-function resolvePersistenceRoot(value) {
-  const resolved = value.startsWith("file://") ? fileURLToPath(value) : resolveInputPath(value);
-  return basename(resolved) === ".fifony" ? resolved : join(resolved, ".fifony");
-}
-var CLI_WORKSPACE_ROOT = readArgValue(CLI_ARGS, "--workspace");
-var CLI_PERSISTENCE = readArgValue(CLI_ARGS, "--persistence");
-var TARGET_ROOT = resolveInputPath(
-  env.FIFONY_WORKSPACE_ROOT ?? CLI_WORKSPACE_ROOT ?? getCwd()
-);
-var STATE_ROOT = resolvePersistenceRoot(
-  env.FIFONY_PERSISTENCE ?? CLI_PERSISTENCE ?? env.FIFONY_BOOTSTRAP_ROOT ?? TARGET_ROOT
-);
-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}/fifony.sqlite`;
-var S3DB_RUNTIME_RESOURCE = "runtime_state";
-var S3DB_ISSUE_RESOURCE = "issues";
-var S3DB_ISSUE_PLAN_RESOURCE = "issue_plans";
-var S3DB_EVENT_RESOURCE = "events";
-var S3DB_SETTINGS_RESOURCE = "settings";
-var S3DB_AGENT_SESSION_RESOURCE = "agent_sessions";
-var S3DB_AGENT_PIPELINE_RESOURCE = "agent_pipelines";
-var S3DB_RUNTIME_RECORD_ID = "current";
-var S3DB_RUNTIME_SCHEMA_VERSION = 1;
-var FRONTEND_DIR = `${PACKAGE_ROOT}/app/dist`;
-var FRONTEND_INDEX = `${FRONTEND_DIR}/index.html`;
-var FRONTEND_MANIFEST_JSON = `${FRONTEND_DIR}/manifest.webmanifest`;
-var FRONTEND_SERVICE_WORKER_JS = `${FRONTEND_DIR}/service-worker.js`;
-var FRONTEND_ICON_SVG = `${FRONTEND_DIR}/icon.svg`;
-var FRONTEND_MASKABLE_ICON_SVG = `${FRONTEND_DIR}/icon-maskable.svg`;
-var FRONTEND_OFFLINE_HTML = `${FRONTEND_DIR}/offline.html`;
-var DEBUG_BOOT = env.FIFONY_DEBUG_BOOT === "1";
-var ALLOWED_STATES = [
-  "Planning",
-  "PendingApproval",
-  "Queued",
-  "Running",
-  "Reviewing",
-  "PendingDecision",
-  "Blocked",
-  "Approved",
-  "Merged",
-  "Cancelled",
-  "Archived"
-];
-var TERMINAL_STATES = /* @__PURE__ */ new Set(["Merged", "Cancelled", "Archived"]);
-var COMPLETED_STATES = /* @__PURE__ */ new Set(["Approved", "Merged", "Cancelled", "Archived"]);
-var EXECUTING_STATES = /* @__PURE__ */ new Set(["Running", "Reviewing"]);
-var PERSIST_EVENTS_MAX = 500;
-var FAST_BOOT = CLI_ARGS.includes("--fast-boot");
-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");
-var QUIET_MODE = CLI_ARGS.includes("--quiet") || CLI_ARGS.includes("--silent");
-
-export {
-  PACKAGE_ROOT,
-  CLI_ARGS,
-  TARGET_ROOT,
-  STATE_ROOT,
-  SOURCE_ROOT,
-  WORKSPACE_ROOT,
-  SOURCE_MARKER,
-  ATTACHMENTS_ROOT,
-  S3DB_DATABASE_PATH,
-  S3DB_RUNTIME_RESOURCE,
-  S3DB_ISSUE_RESOURCE,
-  S3DB_ISSUE_PLAN_RESOURCE,
-  S3DB_EVENT_RESOURCE,
-  S3DB_SETTINGS_RESOURCE,
-  S3DB_AGENT_SESSION_RESOURCE,
-  S3DB_AGENT_PIPELINE_RESOURCE,
-  S3DB_RUNTIME_RECORD_ID,
-  S3DB_RUNTIME_SCHEMA_VERSION,
-  FRONTEND_DIR,
-  FRONTEND_INDEX,
-  FRONTEND_MANIFEST_JSON,
-  FRONTEND_SERVICE_WORKER_JS,
-  FRONTEND_ICON_SVG,
-  FRONTEND_MASKABLE_ICON_SVG,
-  FRONTEND_OFFLINE_HTML,
-  DEBUG_BOOT,
-  ALLOWED_STATES,
-  TERMINAL_STATES,
-  COMPLETED_STATES,
-  EXECUTING_STATES,
-  PERSIST_EVENTS_MAX,
-  QUIET_MODE
-};
-//# sourceMappingURL=chunk-37N5OFHM.js.map