zefiro 0.3.4 → 0.3.6

package/dist/cli.js

@@ -7876,37 +7876,44 @@ async function migrateFromLegacy(projectRoot, nonInteractive) {
 // src/commands/init.ts
 function registerInit(program2) {
   program2.command("init").description("Initialize zefiro configuration for your project").option("--non-interactive", "Skip interactive prompts, use defaults").action(async (cmdOpts) => {
-    const projectRoot = getProjectRoot();
-    const nonInteractive = !!cmdOpts?.nonInteractive;
-    header("zefiro init");
-    await migrateFromLegacy(projectRoot, nonInteractive);
-    const qaiDir = join6(projectRoot, CONFIG_DIR);
-    const isReInit = existsSync5(join6(qaiDir, "agents"));
-    if (isReInit) {
-      info(`Existing ${CONFIG_DIR}/ detected — preserving config and context.
-`);
-      await copyAgentsToLocal(projectRoot, nonInteractive);
-      await copyWorkflowGuide(projectRoot, nonInteractive);
-    } else {
-      const answers = nonInteractive ? getDefaultAnswers() : await askConfigQuestions();
-      await writeEnvVars(projectRoot, answers, nonInteractive);
-      await copyAgentsToLocal(projectRoot, nonInteractive);
-      await copyWorkflowGuide(projectRoot, nonInteractive);
-    }
-    console.log("");
-    success(`Initialization complete!
+    try {
+      const projectRoot = getProjectRoot();
+      const nonInteractive = !!cmdOpts?.nonInteractive;
+      header("zefiro init");
+      await migrateFromLegacy(projectRoot, nonInteractive);
+      const qaiDir = join6(projectRoot, CONFIG_DIR);
+      const isReInit = existsSync5(join6(qaiDir, "agents"));
+      if (isReInit) {
+        info(`Existing ${CONFIG_DIR}/ detected — preserving config and context.
 `);
-    if (!isReInit) {
-      console.log(import_picocolors2.default.bold("Next steps:"));
-      console.log(`  1. Use the ${import_picocolors2.default.cyan("init-agent")} in your AI tool to generate ${import_picocolors2.default.cyan(`${CONFIG_DIR}/context.md`)}`);
-      console.log(`     (or use the MCP server: ${import_picocolors2.default.cyan("zefiro_scan_codebase")} + ${import_picocolors2.default.cyan("zefiro_read_agent")})`);
-      console.log(`  2. Review the generated ${import_picocolors2.default.cyan(`${CONFIG_DIR}/context.md`)}`);
-      console.log(`  3. Run: ${import_picocolors2.default.cyan("zefiro scan")}`);
+        await copyAgentsToLocal(projectRoot, nonInteractive);
+        await copyWorkflowGuide(projectRoot, nonInteractive);
+      } else {
+        const answers = nonInteractive ? getDefaultAnswers() : await askConfigQuestions();
+        await writeEnvVars(projectRoot, answers, nonInteractive);
+        await copyAgentsToLocal(projectRoot, nonInteractive);
+        await copyWorkflowGuide(projectRoot, nonInteractive);
+      }
       console.log("");
-      console.log(import_picocolors2.default.dim("Tip: all QAI settings are in .env as QAI_* variables."));
-      console.log(import_picocolors2.default.dim(`     For advanced config, create ${CONFIG_DIR}/config.ts (import { defineConfig } from 'zefiro')`));
-    } else {
-      console.log(import_picocolors2.default.dim("Config and context.md were preserved. Only agents and workflow were checked."));
+      success(`Initialization complete!
+`);
+      if (!isReInit) {
+        console.log(import_picocolors2.default.bold("Next steps:"));
+        console.log(`  1. Use the ${import_picocolors2.default.cyan("init-agent")} in your AI tool to generate ${import_picocolors2.default.cyan(`${CONFIG_DIR}/context.md`)}`);
+        console.log(`     (or use the MCP server: ${import_picocolors2.default.cyan("zefiro_scan_codebase")} + ${import_picocolors2.default.cyan("zefiro_read_agent")})`);
+        console.log(`  2. Review the generated ${import_picocolors2.default.cyan(`${CONFIG_DIR}/context.md`)}`);
+        console.log(`  3. Run: ${import_picocolors2.default.cyan("zefiro scan")}`);
+        console.log("");
+        console.log(import_picocolors2.default.dim("Tip: all QAI settings are in .env as QAI_* variables."));
+        console.log(import_picocolors2.default.dim(`     For advanced config, create ${CONFIG_DIR}/config.ts (import { defineConfig } from 'zefiro')`));
+      } else {
+        console.log(import_picocolors2.default.dim("Config and context.md were preserved. Only agents and workflow were checked."));
+      }
+    } catch (err) {
+      if (err?.name === "ExitPromptError") {
+        process.exit(0);
+      }
+      throw err;
     }
   });
 }
@@ -12291,7 +12298,7 @@ var hasFlags = userArgs.some((a) => a.startsWith("-"));
 var cols = process.stdout.columns || 80;
 var rows = process.stdout.rows || 24;
 if (!hasCommand && !hasFlags && process.stdout.isTTY && cols >= 60 && rows >= 20) {
-  const { launchTui } = await import("./App-mqm228ma.js");
+  const { launchTui } = await import("./App-8jy21k5k.js");
   await launchTui(program2);
 } else {
   program2.parse();

package/dist/mcp.js

@@ -15218,6 +15218,120 @@ You have access to Zefiro, an AI-powered codebase scanner and QA map generator.
 - \`zefiro_scan_ast_detail\` — drill into a specific AST category
 - \`zefiro_build_qa_map\` — validate + write QAMapV2Payload
 - \`zefiro_read_qa_map\` — read existing QA map
+
+---
+
+## QAMapV2Payload Schema Reference
+
+The payload passed to \`zefiro_build_qa_map\` MUST conform exactly to this schema. All fields are required unless marked optional.
+
+### Top-level structure
+\`\`\`
+{
+  features:   Feature[]    // required, may be []
+  workflows:  Workflow[]   // required, may be []
+  components: Component[]  // required, may be []
+  scenarios:  Scenario[]   // required, may be []
+  commitSha?: string       // optional, auto-injected by the tool
+  metadata?:  object       // optional free-form
+}
+\`\`\`
+
+### Feature
+\`\`\`
+{
+  id:          string    // unique, e.g. "feat-auth"
+  name:        string
+  description: string
+  routes:      string[]  // URL paths this feature covers, e.g. ["/login", "/register"]
+  workflowIds: string[]  // IDs of workflows that belong to this feature
+  sourceFiles: string[]  // relative file paths, e.g. ["src/app/login/page.tsx"]
+}
+\`\`\`
+
+### Workflow
+\`\`\`
+{
+  id:            string
+  name:          string
+  featureId:     string   // must match an existing feature id
+  type:          "navigation" | "crud" | "multi-step" | "configuration" | "search-filter"
+  preconditions: string[] // may be []
+  steps:         WorkflowStep[]
+  componentIds:  string[] // component ids used by this workflow, may be []
+}
+\`\`\`
+
+### WorkflowStep
+\`\`\`
+{
+  id:                  string
+  order:               number  // 1-based integer
+  description:         string
+  componentIds:        string[] // component ids involved in this step, may be []
+  apiCalls:            string[] // API endpoints called, e.g. ["POST /api/login"], may be []
+  conditionalBranches: ConditionalBranch[] // may be []
+}
+\`\`\`
+
+### ConditionalBranch
+\`\`\`
+{
+  condition: string  // e.g. "invalid credentials"
+  outcome:   string  // e.g. "show error message"
+  type:      "validation" | "permission" | "error" | "business-logic"
+}
+\`\`\`
+
+### Component
+\`\`\`
+{
+  id:                   string
+  name:                 string
+  type:                 "form" | "display" | "navigation" | "modal" | "layout" | "feedback"
+  sourceFiles:          string[] // relative file paths
+  props:                string[] // prop names, may be []
+  referencedByWorkflows: string[] // workflow ids that use this component, may be []
+}
+\`\`\`
+
+### Scenario
+\`\`\`
+{
+  id:              string
+  workflowId:      string   // must match an existing workflow id
+  featureId:       string   // must match an existing feature id
+  name:            string
+  description:     string
+  category:        "happy-path" | "permission" | "validation" | "error" | "edge-case" | "precondition"
+  preconditions:   string[] // may be []
+  steps:           ScenarioStep[]
+  expectedOutcome: string
+  componentIds:    string[] // component ids exercised, may be []
+  workflowStepIds: string[] // workflow step ids covered, may be []
+  priority:        "critical" | "high" | "medium" | "low"
+}
+\`\`\`
+
+### ScenarioStep
+\`\`\`
+{
+  order:          number  // 1-based integer
+  action:         string  // what the user/system does
+  expectedResult: string  // what should happen
+}
+\`\`\`
+
+### Referential integrity rules
+- Every \`workflow.featureId\` must exist in \`features[].id\`
+- Every \`feature.workflowIds[]\` entry must exist in \`workflows[].id\`
+- Every \`workflow.componentIds[]\` entry must exist in \`components[].id\`
+- Every \`scenario.workflowId\` must exist in \`workflows[].id\`
+- Every \`scenario.featureId\` must exist in \`features[].id\`
+- Every \`scenario.componentIds[]\` entry must exist in \`components[].id\`
+- Every \`scenario.workflowStepIds[]\` entry must exist in a \`workflow.steps[].id\`
+- Every \`component.referencedByWorkflows[]\` entry must exist in \`workflows[].id\`
+- All ids must be unique within their entity type
 `.trim();
 var server = new McpServer({ name: "zefiro", version: "0.3.2" }, { instructions: SERVER_INSTRUCTIONS });
 server.registerTool("zefiro_scan_codebase", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zefiro",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "type": "module",
   "bin": {
     "zefiro": "./dist/cli.js",