@mestreyoda/fabrica 0.2.20 → 0.2.21

package/dist/index.js

@@ -113905,8 +113905,8 @@ import fsSync from "node:fs";
 import path5 from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 function getCurrentVersion() {
-  if ("0.2.20") {
-    return "0.2.20";
+  if ("0.2.21") {
+    return "0.2.21";
   }
   try {
     const pkgPath = path5.join(THIS_DIR, "..", "..", "package.json");
@@ -114883,7 +114883,7 @@ function resolve2(config2, sourceLayers, trace2) {
     dispatchMs: config2.timeouts?.dispatchMs ?? 6e5,
     staleWorkerHours: config2.timeouts?.staleWorkerHours ?? 2,
     sessionContextBudget: config2.timeouts?.sessionContextBudget ?? 0.6,
-    stallTimeoutMinutes: config2.timeouts?.stallTimeoutMinutes ?? 5,
+    stallTimeoutMinutes: config2.timeouts?.stallTimeoutMinutes ?? 25,
     sessionConfirmAttempts: config2.timeouts?.sessionConfirmAttempts ?? 5,
     sessionConfirmDelayMs: config2.timeouts?.sessionConfirmDelayMs ?? 250,
     sessionLabelMaxLength: config2.timeouts?.sessionLabelMaxLength ?? 64,
@@ -118561,6 +118561,34 @@ var conduct_interview_exports = {};
 __export(conduct_interview_exports, {
   conductInterviewStep: () => conductInterviewStep
 });
+function deriveFeatureScopeFromRawIdea(rawIdea) {
+  const text = rawIdea.toLowerCase();
+  const scope = [];
+  const add = (item) => {
+    if (!scope.includes(item)) scope.push(item);
+  };
+  if (/\b(auth|oauth|jwt|login|register|session|role-based access|rbac|permissions?)\b/i.test(text)) {
+    add("Implement authentication, authorization, and role-aware access rules");
+  }
+  if (/\b(incident|project|task|owner|assign|timeline|status|update)s?\b/i.test(text)) {
+    add("Implement the core domain workflows and CRUD endpoints for the main entities");
+  }
+  if (/\b(alert|alerts|notif|notification|notifications|reminder|reminders|escalation|escalations)\b/i.test(text)) {
+    add("Implement notifications, reminders, and escalation flows for key events");
+  }
+  if (/\b(background process|background worker|worker|queue|job|celery|bull|sidekiq|scheduler)\b/i.test(text)) {
+    add("Implement the background processing pipeline required for asynchronous work");
+  }
+  if (/\b(admin view|admin panel|admin console|dashboard|audit history|audit log|activity history)\b/i.test(text)) {
+    add("Implement administrative visibility and audit/history capabilities for operators");
+  }
+  if (scope.length < 3) {
+    add("Implement the primary user workflow described in the request");
+    add("Expose the key interactions needed to operate the system end to end");
+    add("Add validation and persistence rules for the main business flow");
+  }
+  return scope.slice(0, 5);
+}
 function fallbackSpecData(type, rawIdea) {
   const title = rawIdea.slice(0, 120);
   const base = {
@@ -118588,7 +118616,12 @@ function fallbackSpecData(type, rawIdea) {
       base.acceptance_criteria = ["Infrastructure change applied and verified"];
       break;
     default:
-      base.acceptance_criteria = ["Feature works as described in the objective"];
+      base.scope_v1 = deriveFeatureScopeFromRawIdea(rawIdea);
+      base.acceptance_criteria = [
+        "The primary workflow works end to end as requested",
+        "Role, validation, or delivery constraints from the request are enforced",
+        "The asynchronous/background behavior works for the main operational path"
+      ];
   }
   return base;
 }
@@ -124987,6 +125020,20 @@ function buildMessage(event) {
       }
       return msg;
     }
+    case "workerProgress": {
+      const worker = formatWorkerString(event.role, {
+        name: event.name,
+        level: event.level
+      });
+      let msg = `\u23F3 ${worker} still working on #${event.issueId}: ${event.issueTitle}`;
+      if (event.summary) msg += `
+${event.summary}`;
+      if (event.minutesActive != null) msg += `
+\u{1F552} Active for ${event.minutesActive} min`;
+      msg += `
+\u{1F4CB} [Issue #${event.issueId}](${event.issueUrl})`;
+      return msg;
+    }
     case "workerComplete": {
       const icons = {
         done: "\u2705",
@@ -126741,6 +126788,10 @@ function createTaskCreateTool(ctx) {
         pickup: {
           type: "boolean",
           description: "If true, immediately pick up this issue for DEV after creation. Defaults to false."
+        },
+        parentIssueId: {
+          type: "number",
+          description: "Optional parent/epic issue ID when creating a child task as part of a decomposition plan."
         }
       }
     },
@@ -126749,12 +126800,17 @@ function createTaskCreateTool(ctx) {
       const description = params.description ?? "";
       const assignees = params.assignees ?? [];
       const pickup = params.pickup ?? false;
+      const parentIssueId = Number.isFinite(params.parentIssueId) ? Number(params.parentIssueId) : null;
       const workspaceDir = requireWorkspaceDir(toolCtx);
       const { project, route } = await resolveProjectFromContext(workspaceDir, toolCtx, params.channelId);
       const resolvedConfig = await loadConfig(workspaceDir, project.slug);
       const label = resolvedConfig.workflow.states[resolvedConfig.workflow.initial]?.label ?? "Planning";
       const { provider, type: providerType } = await resolveProvider(project, ctx.runCommand);
-      const issue2 = await provider.createIssue(title, description, label, assignees);
+      let body = description;
+      if (parentIssueId) {
+        body = `${description}${description.trim().length > 0 ? "\n\n" : ""}Parent issue: #${parentIssueId}`;
+      }
+      const issue2 = await provider.createIssue(title, body, label, assignees);
       provider.reactToIssue(issue2.iid, "eyes").catch(() => {
       });
       const primaryChannel = findPrimaryChannel(project);
@@ -126768,13 +126824,31 @@ function createTaskCreateTool(ctx) {
       );
       autoAssignOwnerLabel(workspaceDir, provider, issue2.iid, project).catch(() => {
       });
+      if (parentIssueId) {
+        await updateIssueRuntime(workspaceDir, project.slug, issue2.iid, {
+          parentIssueId
+        }).catch(() => {
+        });
+        const parentRuntime = project.issueRuntime?.[String(parentIssueId)] ?? {};
+        const previousChildren = Array.isArray(parentRuntime.childIssueIds) ? parentRuntime.childIssueIds : [];
+        await updateIssueRuntime(workspaceDir, project.slug, parentIssueId, {
+          childIssueIds: [.../* @__PURE__ */ new Set([...previousChildren, issue2.iid])]
+        }).catch(() => {
+        });
+        provider.addComment(
+          parentIssueId,
+          `\u{1F4CC} Child task created: [#${issue2.iid}: ${issue2.title}](${issue2.web_url})`
+        ).catch(() => {
+        });
+      }
       await log(workspaceDir, "task_create", {
         project: project.name,
         issueId: issue2.iid,
         title,
         label,
         provider: providerType,
-        pickup
+        pickup,
+        parentIssueId
       });
       const hasBody = description && description.trim().length > 0;
       let announcement = `\u{1F4CB} Created #${issue2.iid}: "${title}" (${label})`;
@@ -128835,6 +128909,7 @@ async function dispatchTask(opts) {
     inconclusiveCompletionAt: null,
     inconclusiveCompletionReason: null,
     sessionCompletedAt: null,
+    progressNotifiedAt: null,
     lastSessionKey: sessionKey
   }).catch((err) => {
     log(workspaceDir, "dispatch_warning", { step: "record_dispatch_requested", issue: issueId, err: String(err) }).catch(() => {
@@ -131332,6 +131407,7 @@ async function checkWorkerHealth(opts) {
     completionRecoveryWindowMs = COMPLETION_RECOVERY_WINDOW_MS,
     executionContractRecoveryWindowMs = EXECUTION_CONTRACT_RECOVERY_WINDOW_MS,
     runCommand,
+    stallTimeoutMinutes = 25,
     notificationConfig
   } = opts;
   const fixes = [];
@@ -131831,7 +131907,120 @@ async function checkWorkerHealth(opts) {
         continue;
       }
       if (slot.active && slot.startTime && sessionKey && sessions && sessionAlive) {
-        const hours = (Date.now() - new Date(slot.startTime).getTime()) / 36e5;
+        const startedAtMs = new Date(slot.startTime).getTime();
+        const minutesActive = (Date.now() - startedAtMs) / 6e4;
+        const hours = minutesActive / 60;
+        let hasReviewableArtifact = Boolean(
+          issueRuntime?.currentPrNumber || issueRuntime?.currentPrUrl || issueRuntime?.artifactOfRecord?.prNumber
+        );
+        if (!hasReviewableArtifact && issueIdNum) {
+          try {
+            const prStatus = await provider.getPrStatus(issueIdNum);
+            hasReviewableArtifact = Boolean(
+              prStatus.url && prStatus.state !== PrState.MERGED && prStatus.state !== PrState.CLOSED && prStatus.currentIssueMatch !== false
+            );
+          } catch {
+          }
+        }
+        if (role === "developer" && issue2 && issueIdNum && !hasReviewableArtifact && minutesActive >= Math.max(5, Math.floor(stallTimeoutMinutes / 2)) && !issueRuntime?.progressNotifiedAt) {
+          const channel = project.channels?.[0];
+          await notify(
+            {
+              type: "workerProgress",
+              project: project.name,
+              issueId: issueIdNum,
+              issueUrl: issue2.web_url,
+              issueTitle: issue2.title,
+              role,
+              level,
+              minutesActive: Math.round(minutesActive),
+              summary: "Still iterating on implementation/QA without a PR yet.",
+              dispatchCycleId: slot.dispatchCycleId ?? issueRuntime?.lastDispatchCycleId ?? null,
+              dispatchRunId: slot.dispatchRunId ?? issueRuntime?.dispatchRunId ?? null
+            },
+            {
+              workspaceDir,
+              config: notificationConfig,
+              target: channel ? {
+                channelId: channel.channelId,
+                channel: channel.channel,
+                accountId: channel.accountId,
+                messageThreadId: channel.messageThreadId
+              } : void 0,
+              runCommand
+            }
+          ).catch(() => {
+          });
+          await updateIssueRuntime(workspaceDir, projectSlug, issueIdNum, {
+            progressNotifiedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            lastSessionKey: sessionKey
+          }).catch(() => {
+          });
+        }
+        if (role === "developer" && issue2 && issueIdNum && !hasReviewableArtifact && minutesActive >= stallTimeoutMinutes) {
+          const fix = {
+            issue: {
+              type: "completion_recovery_exhausted",
+              severity: "critical",
+              project: project.name,
+              projectSlug,
+              role,
+              level,
+              sessionKey,
+              issueId: slot.issueId,
+              slotIndex,
+              message: `${role.toUpperCase()} ${level}[${slotIndex}] active for ${Math.round(minutesActive)}m without a PR or terminal result`
+            },
+            fixed: false
+          };
+          if (autoFix) {
+            const channel = project.channels?.[0];
+            await notify(
+              {
+                type: "workerRecoveryExhausted",
+                project: project.name,
+                issueId: issueIdNum,
+                issueUrl: issue2.web_url,
+                issueTitle: issue2.title,
+                role,
+                detail: `No PR or canonical completion after ${Math.round(minutesActive)} minutes of active work. Re-queueing for a fresh attempt.`,
+                nextState: slotQueueLabel,
+                dispatchCycleId: slot.dispatchCycleId ?? issueRuntime?.lastDispatchCycleId ?? null,
+                dispatchRunId: slot.dispatchRunId ?? issueRuntime?.dispatchRunId ?? null
+              },
+              {
+                workspaceDir,
+                config: notificationConfig,
+                target: channel ? {
+                  channelId: channel.channelId,
+                  channel: channel.channel,
+                  accountId: channel.accountId,
+                  messageThreadId: channel.messageThreadId
+                } : void 0,
+                runCommand
+              }
+            ).catch(() => {
+            });
+            await revertLabel(fix, expectedLabel, slotQueueLabel);
+            if (!fix.labelRevertFailed) {
+              await deactivateSlot();
+              await updateIssueRuntime(workspaceDir, projectSlug, issueIdNum, {
+                inconclusiveCompletionAt: (/* @__PURE__ */ new Date()).toISOString(),
+                inconclusiveCompletionReason: "stalled_without_artifact",
+                progressNotifiedAt: null
+              }).catch(() => {
+              });
+              fix.fixed = true;
+              await auditHealthFixApplied(workspaceDir, fix, {
+                action: "requeue_issue",
+                fromLabel: expectedLabel,
+                toLabel: slotQueueLabel
+              });
+            }
+          }
+          fixes.push(fix);
+          continue;
+        }
         if (hours > staleWorkerHours) {
           const fix = {
             issue: {
@@ -139694,14 +139883,14 @@ function detectRawIdeaComplexity(rawIdea) {
   const text = rawIdea.toLowerCase();
   const signals = [];
   const subsystemPatterns = [
-    [/\b(worker|background.?job|queue|celery|bull|sidekiq|task.?runner)\b/i, "background-worker"],
+    [/\b(worker|background.?job|background process|background service|background worker|queue|celery|bull|sidekiq|task.?runner|scheduler|job processor)\b/i, "background-worker"],
     [/\b(websocket|server.?sent|sse|real.?time|realtime|socket\.io|push.?notif)\b/i, "realtime"],
-    [/\b(auth|oauth|jwt|login|register|session|user.?account|signup)\b/i, "auth"],
-    [/\b(notif|alert|email|sms|webhook|subscription|subscribe)\b/i, "notifications"],
-    [/\b(database|banco|db|postgres|mysql|mongodb|redis|sqlite|orm)\b/i, "database"],
+    [/\b(auth|oauth|jwt|login|register|session|user.?account|signup|role-based access|rbac|permission[s]?)\b/i, "auth"],
+    [/\b(notif|notification[s]?|alert[s]?|email|sms|webhook|subscription|subscribe|reminder[s]?|escalation[s]?)\b/i, "notifications"],
+    [/\b(database|banco|db|postgres|mysql|mongodb|redis|sqlite|orm|audit history|audit log|activity history)\b/i, "database"],
     [/\b(api\s+rest|rest\s+api|endpoint|rota|route|graphql|grpc)\b/i, "api-layer"],
     [/\b(docker|kubernetes|k8s|deploy|ci|cd|pipeline)\b/i, "infra"],
-    [/\b(dashboard|frontend|interface|ui|tela|p[aá]gina)\b/i, "frontend"]
+    [/\b(dashboard|frontend|interface|ui|tela|p[aá]gina|admin view|admin panel|admin console)\b/i, "frontend"]
   ];
   for (const [regex, label] of subsystemPatterns) {
     if (regex.test(text)) signals.push(label);
@@ -139858,6 +140047,38 @@ function loadMatrix() {
   cachedMatrix = _require3("../configs/triage-matrix.json");
   return cachedMatrix;
 }
+function buildChildDrafts(payload, issueNumber, effort) {
+  const spec = payload.spec;
+  const scopeItems = spec.scope_v1.filter((item) => item.trim().length > 0);
+  const maxChildren = effort === "xlarge" ? 4 : 3;
+  const chunkSize = 2;
+  const drafts = [];
+  for (let i2 = 0; i2 < scopeItems.length && drafts.length < maxChildren; i2 += chunkSize) {
+    const slice = scopeItems.slice(i2, i2 + chunkSize);
+    if (slice.length === 0) continue;
+    const childIndex = drafts.length + 1;
+    drafts.push({
+      title: `${spec.title} \u2014 Part ${childIndex}`,
+      description: [
+        `## Objective`,
+        spec.objective,
+        "",
+        `## Parent Issue`,
+        `Parent issue: #${issueNumber}`,
+        "",
+        `## This Part`,
+        ...slice.map((item) => `- ${item}`),
+        "",
+        `## Acceptance Criteria`,
+        ...spec.acceptance_criteria.map((item) => `- ${item}`),
+        "",
+        `## Definition of Done`,
+        ...spec.definition_of_done.map((item) => `- ${item}`)
+      ].join("\n")
+    });
+  }
+  return drafts;
+}
 var triageStep = {
   name: "triage",
   shouldRun: (payload) => !!payload.issues?.length && !payload.dry_run,
@@ -139877,9 +140098,9 @@ var triageStep = {
       totalRisks: (impact?.risk_areas?.length ?? 0) + (payload.security?.spec_security_notes?.length ?? 0),
       objective: spec.objective,
       rawIdea: payload.raw_idea,
-      acText: spec.acceptance_criteria.join(" "),
-      scopeText: spec.scope_v1.join(" "),
-      oosText: spec.out_of_scope.join(" "),
+      acText: spec.acceptance_criteria.join("\n"),
+      scopeText: spec.scope_v1.join("\n"),
+      oosText: spec.out_of_scope.join("\n"),
       authSignal: payload.metadata?.auth_gate?.signal ?? false
     }, matrix);
     const repoUrl = payload.scaffold?.repo_url ?? payload.metadata?.repo_url ?? "";
@@ -139889,8 +140110,12 @@ var triageStep = {
     const initialLabel = resolvedConfig?.workflow.states[resolvedConfig.workflow.initial]?.label ?? "Planning";
     const allLabels = [decision.priorityLabel, decision.effortLabel];
     if (decision.typeLabel) allLabels.push(decision.typeLabel);
-    if (!decision.readyForDispatch) allLabels.push("needs-human");
+    if (!decision.readyForDispatch || decision.specQualityBlock) allLabels.push("needs-human");
     const uniqueLabels = Array.from(new Set(allLabels.filter(Boolean)));
+    const shouldDecompose = decision.readyForDispatch && !decision.specQualityBlock && ["large", "xlarge"].includes(decision.effort);
+    const decompositionDrafts = shouldDecompose ? buildChildDrafts(payload, issue2.number, decision.effort) : [];
+    const canDecompose = decompositionDrafts.length >= 2;
+    let createdChildIssueNumbers = [];
     if (ctx.createIssueProvider && repoPath) {
       try {
         const { provider } = await ctx.createIssueProvider({
@@ -139900,7 +140125,36 @@ var triageStep = {
         for (const label of uniqueLabels) {
           await provider.addLabel(issue2.number, label);
         }
-        if (decision.readyForDispatch) {
+        if (decision.specQualityBlock) {
+          await provider.addComment(issue2.number, [
+            "\u{1F6AB} Spec quality gate blocked automatic dispatch.",
+            "",
+            "The request needs a stronger objective, more concrete scope items, and verifiable acceptance criteria before creating execution tasks."
+          ].join("\n"));
+        } else if (canDecompose) {
+          await provider.addLabel(issue2.number, "decomposition:parent");
+          const childIssues = [];
+          for (const draft of decompositionDrafts) {
+            const child = await provider.createIssue(draft.title, draft.description, initialLabel);
+            childIssues.push({ iid: child.iid, title: child.title, web_url: child.web_url });
+            createdChildIssueNumbers.push(child.iid);
+            for (const label of uniqueLabels) {
+              await provider.addLabel(child.iid, label);
+            }
+            await provider.addLabel(child.iid, "decomposition:child");
+          }
+          await provider.addComment(issue2.number, [
+            "## Decomposition Plan",
+            ...childIssues.map((child) => `- [ ] #${child.iid} ${child.title}`)
+          ].join("\n"));
+        } else if (shouldDecompose) {
+          await provider.addLabel(issue2.number, "needs-human");
+          await provider.addComment(issue2.number, [
+            "\u26A0\uFE0F Automatic decomposition was requested, but the generated spec did not yield at least two independently scoped child tasks.",
+            "",
+            "Refine the scope/acceptance criteria or split the plan manually before dispatch."
+          ].join("\n"));
+        } else if (decision.readyForDispatch) {
           await provider.transitionLabel(issue2.number, initialLabel, decision.targetState);
           const dispatchLabels = [];
           if (decision.targetState === "To Do" && decision.dispatchLabel) {
@@ -139965,8 +140219,14 @@ var triageStep = {
       project_channel_id: null,
       labels_applied: uniqueLabels,
       issue_number: issue2.number,
-      ready_for_dispatch: decision.readyForDispatch && decision.errors.length === 0,
-      errors: decision.errors
+      ready_for_dispatch: decision.readyForDispatch && decision.errors.length === 0 && !decision.specQualityBlock && !canDecompose,
+      errors: [
+        ...decision.errors,
+        ...decision.specQualityBlock ? ["spec_quality_block"] : [],
+        ...shouldDecompose && !canDecompose ? ["decomposition_needs_human"] : []
+      ],
+      decomposition_mode: canDecompose ? "parent_child" : "none",
+      child_issue_numbers: createdChildIssueNumbers
     };
     ctx.log(`Triage: ${triage.priority}, effort=${triage.effort}, ready=${triage.ready_for_dispatch}`);
     return {
@@ -141099,6 +141359,11 @@ function inferProjectSlug(text) {
   const slug = cleaned.toLowerCase().normalize("NFKD").replace(/[^\w\s-]/g, "").trim().replace(/\s+/g, "-").replace(/-+/g, "-").slice(0, 64);
   return slug || void 0;
 }
+function normalizeProjectNameCandidate(value) {
+  const normalized = normalizeText3(value);
+  if (!normalized) return void 0;
+  return inferProjectSlug(normalized) ?? void 0;
+}
 function normalizeText3(value) {
   const trimmed = value?.trim();
   return trimmed ? trimmed : void 0;
@@ -141122,7 +141387,7 @@ function detectStackHint(text) {
 }
 function parseField(text, labels) {
   for (const label of labels) {
-    const regex = new RegExp(`^\\s*${label}\\s*:\\s*(.+)$`, "im");
+    const regex = new RegExp(`(?:^|[\\n.,;!?]\\s*)${label}\\s*:\\s*(.+)$`, "im");
     const match = text.match(regex);
     if (match?.[1]) return normalizeText3(match[1]);
   }
@@ -141134,12 +141399,12 @@ function parseIdeaBlock(text) {
 }
 function parseExplicitProjectName(text) {
   const match = text.match(/\b(?:called|named|chamado)\s+[`"'“”‘’]?([a-z0-9][a-z0-9-]{1,63})[`"'“”‘’]?(?=$|[\s.,!?;:])/i);
-  return match?.[1]?.toLowerCase();
+  return normalizeProjectNameCandidate(match?.[1]?.toLowerCase());
 }
 function parseBootstrapRequest(text) {
   const repoUrl = parseField(text, ["repository url", "repo url", "reposit[o\xF3]rio url", "github repo"]);
   const rawIdea = parseIdeaBlock(text) ?? text.trim();
-  const projectName = parseField(text, ["project name", "nome do projeto", "repo name", "repository name"]) ?? parseExplicitProjectName(text);
+  const projectName = normalizeProjectNameCandidate(parseField(text, ["project name", "nome do projeto", "repo name", "repository name"])) ?? parseExplicitProjectName(text);
   const repoPath = parseField(text, ["local repository path", "repo path", "caminho local", "local path"]);
   const explicitStack = parseField(text, ["stack", "framework", "linguagem"]);
   const stackHint = (explicitStack ? normalizeStackHint(explicitStack) : "") || detectStackHint(text);
@@ -141318,25 +141583,26 @@ function parseClarificationResponse(text, session) {
     if (autoPatterns.test(normalizeUserResponse(text))) {
       return { recognized: true, projectName: inferProjectSlug(session.rawIdea) ?? `project-${Date.now()}`, stackHint: session.stackHint ?? void 0 };
     }
-    const nameField = parseField(text, ["project name", "nome do projeto", "nome", "name"]);
+    const nameField = normalizeProjectNameCandidate(parseField(text, ["project name", "nome do projeto", "nome", "name"]));
     if (nameField) {
       return { recognized: true, projectName: nameField, stackHint: session.stackHint ?? void 0 };
     }
-    if (trimmed.length > 0 && trimmed.length <= 64) {
-      return { recognized: true, projectName: trimmed, stackHint: session.stackHint ?? void 0 };
+    const normalizedInlineName = trimmed.length <= 64 ? normalizeProjectNameCandidate(trimmed) : void 0;
+    if (normalizedInlineName) {
+      return { recognized: true, projectName: normalizedInlineName, stackHint: session.stackHint ?? void 0 };
     }
     return { recognized: false };
   }
+  const projectNameFromField = normalizeProjectNameCandidate(parseField(text, ["project name", "nome do projeto", "nome", "name"]));
+  const nameItMatch = !projectNameFromField ? text.match(/(?:name|call|chamar?)\s+(?:it\s+)?([\w-]{2,64})/i) : null;
+  const inlineName = projectNameFromField ?? normalizeProjectNameCandidate(nameItMatch?.[1]);
   const stackField = parseField(text, ["stack", "framework", "linguagem", "language"]);
   if (stackField) {
     const normalizedStack = normalizeStackHint(stackField) || detectStackHint(stackField) || stackField;
-    return { recognized: true, stackHint: normalizedStack };
+    return { recognized: true, stackHint: normalizedStack, projectName: inlineName };
   }
   const detectedStack = detectStackHint(text);
   if (detectedStack) {
-    const projectNameFromField = parseField(text, ["project name", "nome do projeto", "nome", "name"]);
-    const nameItMatch = !projectNameFromField ? text.match(/(?:name|call|chamar?)\s+(?:it\s+)?([\w-]{2,64})/i) : null;
-    const inlineName = projectNameFromField ?? (nameItMatch ? nameItMatch[1].toLowerCase().replace(/[^a-z0-9-]/g, "").replace(/-+/g, "-") || void 0 : void 0);
     return { recognized: true, stackHint: detectedStack, projectName: inlineName };
   }
   const lower2 = normalizeUserResponse(text);
@@ -141569,7 +141835,7 @@ async function handleTelegramBootstrapDmMessage(ctx, rawConversationId, content)
         conversationId,
         rawIdea: content,
         stackHint: parsed.stackHint ?? void 0,
-        projectName: parsed.projectSlug ?? void 0,
+        projectName: parsed.projectName ?? parsed.projectSlug ?? void 0,
         status: "clarifying",
         pendingClarification: "scope",
         language
@@ -143955,6 +144221,7 @@ async function performHealthPass(workspaceDir, projectSlug, project, sessions, p
       workflow: resolvedConfig?.workflow,
       dispatchConfirmTimeoutMs: resolvedConfig?.timeouts?.dispatchConfirmTimeoutMs,
       healthGracePeriodMs: resolvedConfig?.timeouts?.healthGracePeriodMs,
+      stallTimeoutMinutes,
       runCommand,
       notificationConfig: notifyConfig
     });
@@ -146332,8 +146599,18 @@ function stringifyAnswerRecord(record2) {
   }
   return normalized;
 }
-function deriveProjectName(repoUrl, projectName) {
+function extractExplicitProjectName(text) {
+  if (!text) return null;
+  const fieldMatch = text.match(/(?:^|[\n.,;!?]\s*)(?:project name|repo name|repository name|nome do projeto)\s*:\s*([a-z0-9][a-z0-9-]{1,63})\b/i);
+  if (fieldMatch?.[1]) return fieldMatch[1].trim().toLowerCase();
+  const inlineMatch = text.match(/\b(?:called|named|chamado)\s+[`"'“”‘’]?([a-z0-9][a-z0-9-]{1,63})[`"'“”‘’]?(?=$|[\s.,!?;:])/i);
+  if (inlineMatch?.[1]) return inlineMatch[1].trim().toLowerCase();
+  return null;
+}
+function deriveProjectName(repoUrl, projectName, freeText) {
   if (projectName) return projectName;
+  const parsedFromText = extractExplicitProjectName(freeText ?? null);
+  if (parsedFromText) return parsedFromText;
   if (!repoUrl) return null;
   const sanitized = repoUrl.replace(/\/+$/, "");
   const lastSegment = sanitized.split("/").pop();
@@ -146423,9 +146700,11 @@ function normalizeGenesisRequest(params, existingPayload) {
     throw new Error('phase is required and must be "discover" or "commit"');
   }
   const repoUrl = normalizeOptionalString(params.repo_url) ?? existingPayload?.metadata.repo_url ?? null;
+  const freeTextProjectSource = normalizeOptionalString(params.idea) ?? normalizeOptionalString(params.command) ?? existingPayload?.raw_idea ?? null;
   const projectName = deriveProjectName(
     repoUrl,
-    normalizeOptionalString(params.project_name) ?? existingPayload?.metadata.project_name ?? null
+    normalizeOptionalString(params.project_name) ?? existingPayload?.metadata.project_name ?? null,
+    freeTextProjectSource
   );
   const answersJson = {
     ...existingPayload?.metadata.answers_json ?? {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mestreyoda/fabrica",
-  "version": "0.2.20",
+  "version": "0.2.21",
   "description": "Autonomous software engineering pipeline for OpenClaw. Turns ideas into deployed code via intake, dispatch, review, test, and merge.",
   "type": "module",
   "main": "./dist/index.js",