@mestreyoda/fabrica 0.2.23 → 0.2.24

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.23") {
-    return "0.2.23";
+  if ("0.2.24") {
+    return "0.2.24";
   }
   try {
     const pkgPath = path5.join(THIS_DIR, "..", "..", "package.json");
@@ -122268,7 +122268,9 @@ async function clearIssueRuntime(workspaceDir, slugOrChannelId, issueId) {
         decompositionMode: existing.decompositionMode ?? null,
         decompositionStatus: existing.parentIssueId ? "completed" : existing.decompositionStatus ?? null,
         sessionCompletedAt: existing.sessionCompletedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
-        artifactOfRecord: existing.artifactOfRecord ?? null
+        artifactOfRecord: existing.artifactOfRecord ?? null,
+        qualityCriticality: existing.qualityCriticality ?? null,
+        riskProfile: existing.riskProfile ?? null
       } : null;
       if (preserved && (preserved.parentIssueId != null || (preserved.childIssueIds?.length ?? 0) > 0 || (preserved.dependencyIssueIds?.length ?? 0) > 0 || preserved.decompositionMode != null)) {
         project.issueRuntime[key] = preserved;
@@ -125107,6 +125109,10 @@ ${event.summary}`;
       if (event.summary) {
         msg += `
 ${event.summary}`;
+      }
+      if (event.acceptanceSummary) {
+        msg += `
+\u{1F9FE} ${event.acceptanceSummary}`;
       }
       if (event.prUrl) msg += `
 \u{1F517} ${prLink(event.prUrl)}`;
@@ -125223,6 +125229,8 @@ ${event.summary}`;
       let msg = `\u{1F3C1} Issue completed: #${event.issueId} \u2014 ${event.issueTitle}`;
       msg += `
 \u{1F4E6} Project: ${event.project}`;
+      if (event.acceptanceSummary) msg += `
+\u{1F9FE} ${event.acceptanceSummary}`;
       if (event.prUrl) msg += `
 \u{1F517} ${prLink(event.prUrl)}`;
       msg += `
@@ -125610,10 +125618,14 @@ function formatChildRollupLine(child) {
   const prUrl = runtime?.artifactOfRecord?.url ?? runtime?.currentPrUrl ?? null;
   const mergedAt = runtime?.artifactOfRecord?.mergedAt ?? null;
   const headSha = runtime?.artifactOfRecord?.headSha ?? runtime?.lastHeadSha ?? null;
+  const qualityCriticality = runtime?.qualityCriticality ?? null;
+  const riskProfile = runtime?.riskProfile ?? [];
   const extras = [
     prUrl ? `PR: ${prUrl}` : null,
     mergedAt ? `mergedAt: ${mergedAt}` : null,
-    headSha ? `headSha: ${headSha}` : null
+    headSha ? `headSha: ${headSha}` : null,
+    qualityCriticality ? `qualityCriticality: ${qualityCriticality}` : null,
+    riskProfile.length > 0 ? `risks: ${riskProfile.join(",")}` : null
   ].filter(Boolean);
   return `- #${child.issueId} \u2014 ${state}${extras.length > 0 ? ` \u2014 ${extras.join(" \u2014 ")}` : ""}`;
 }
@@ -125622,12 +125634,14 @@ var PARENT_ROLLUP_END = "<!-- fabrica:parent-rollup:end -->";
 function buildParentRollupComment(status, completedChildIds, blockedChildIds, children) {
   const allChildIds = children.map((child) => child.issueId);
   const pendingChildIds = allChildIds.filter((id) => !completedChildIds.includes(id) && !blockedChildIds.includes(id));
+  const highCriticalityChildren = children.filter((child) => child.runtime?.qualityCriticality === "high").map((child) => child.issueId);
   return [
     "## Parent Rollup",
     `- Status: ${status}`,
     `- Completed children (${completedChildIds.length}/${allChildIds.length}): ${completedChildIds.length > 0 ? completedChildIds.map((id) => `#${id}`).join(", ") : "none"}`,
     `- Pending children: ${pendingChildIds.length > 0 ? pendingChildIds.map((id) => `#${id}`).join(", ") : "none"}`,
     `- Blocked children: ${blockedChildIds.length > 0 ? blockedChildIds.map((id) => `#${id}`).join(", ") : "none"}`,
+    `- High-criticality children: ${highCriticalityChildren.length > 0 ? highCriticalityChildren.map((id) => `#${id}`).join(", ") : "none"}`,
     "",
     "### Child Status",
     ...children.map((child) => formatChildRollupLine(child))
@@ -125704,6 +125718,200 @@ async function reconcileParentLifecycleForIssue(opts) {
 // lib/services/pipeline.ts
 init_workflow();
 init_context3();
+
+// lib/quality/quality-gates.ts
+var BASE_POLICIES = {
+  api: {
+    archetype: "api",
+    requiredEvidence: ["request-level verification", "acceptance criteria traceability"],
+    requiredChecks: ["startup/build", "endpoint validation", "error-handling review"],
+    autoRejectConditions: ["missing input validation", "missing auth review on sensitive flows", "no meaningful API evidence"],
+    qualityCriticalityFloor: "medium"
+  },
+  "web-ui": {
+    archetype: "web-ui",
+    requiredEvidence: ["primary flow verification", "loading/error behavior"],
+    requiredChecks: ["build/render", "interaction smoke", "a11y sanity"],
+    autoRejectConditions: ["missing primary flow evidence", "missing loading/error handling"],
+    qualityCriticalityFloor: "medium"
+  },
+  cli: {
+    archetype: "cli",
+    requiredEvidence: ["command smoke", "help output", "exit-code behavior"],
+    requiredChecks: ["binary/script execution", "argv validation"],
+    autoRejectConditions: ["missing help output", "wrong exit-code behavior", "no command evidence"],
+    qualityCriticalityFloor: "low"
+  },
+  library: {
+    archetype: "library",
+    requiredEvidence: ["public API tests", "usage validation"],
+    requiredChecks: ["build/install", "public export verification"],
+    autoRejectConditions: ["no public API evidence", "broken exports"],
+    qualityCriticalityFloor: "low"
+  },
+  automation: {
+    archetype: "automation",
+    requiredEvidence: ["main flow verification", "failure-path evidence"],
+    requiredChecks: ["timeout/retry review", "idempotency review when applicable"],
+    autoRejectConditions: ["unsafe retries", "no failure-path evidence"],
+    qualityCriticalityFloor: "medium"
+  },
+  hybrid: {
+    archetype: "hybrid",
+    requiredEvidence: ["API and UI flow evidence", "integration behavior"],
+    requiredChecks: ["build", "API smoke", "UI smoke"],
+    autoRejectConditions: ["missing UI evidence", "missing API evidence"],
+    qualityCriticalityFloor: "medium"
+  },
+  unknown: {
+    archetype: "unknown",
+    requiredEvidence: ["basic behavioral evidence"],
+    requiredChecks: ["build or execution smoke"],
+    autoRejectConditions: ["no runnable evidence"],
+    qualityCriticalityFloor: "low"
+  }
+};
+function resolveQualityGatePolicy(opts) {
+  const archetype = opts.deliverable ?? "unknown";
+  const base = BASE_POLICIES[archetype] ?? BASE_POLICIES.unknown;
+  const ORDER = ["low", "medium", "high"];
+  const qualityCriticalityFloor = opts.qualityCriticality ? ORDER.indexOf(opts.qualityCriticality) > ORDER.indexOf(base.qualityCriticalityFloor) ? opts.qualityCriticality : base.qualityCriticalityFloor : base.qualityCriticalityFloor;
+  return {
+    ...base,
+    qualityCriticalityFloor
+  };
+}
+
+// lib/quality/done-policies.ts
+var BASE_POLICIES2 = {
+  api: {
+    archetype: "api",
+    requiredArtifacts: ["implemented endpoint surface", "runtime contract"],
+    requiredEvidence: ["API behavior evidence", "acceptance criteria coverage"],
+    behavioralChecks: ["startup works", "error paths handled", "validation enforced"],
+    disqualifyingConditions: ["missing endpoint evidence", "missing validation on exposed boundaries"],
+    qualityCriticalityFloor: "medium"
+  },
+  "web-ui": {
+    archetype: "web-ui",
+    requiredArtifacts: ["main user flow", "UI states"],
+    requiredEvidence: ["interaction evidence", "loading/error evidence"],
+    behavioralChecks: ["main flow works", "render path stable"],
+    disqualifyingConditions: ["missing main flow evidence", "broken loading/error handling"],
+    qualityCriticalityFloor: "medium"
+  },
+  cli: {
+    archetype: "cli",
+    requiredArtifacts: ["command entrypoint", "help contract"],
+    requiredEvidence: ["command execution evidence", "exit-code evidence"],
+    behavioralChecks: ["help works", "main command succeeds", "invalid args fail cleanly"],
+    disqualifyingConditions: ["missing help", "no command execution evidence"],
+    qualityCriticalityFloor: "low"
+  },
+  library: {
+    archetype: "library",
+    requiredArtifacts: ["public API surface"],
+    requiredEvidence: ["public API tests or examples"],
+    behavioralChecks: ["exports resolve", "usage path works"],
+    disqualifyingConditions: ["broken exports", "no public API evidence"],
+    qualityCriticalityFloor: "low"
+  },
+  automation: {
+    archetype: "automation",
+    requiredArtifacts: ["orchestration flow"],
+    requiredEvidence: ["main flow evidence", "failure-path evidence"],
+    behavioralChecks: ["timeouts are bounded", "retry semantics are safe where needed"],
+    disqualifyingConditions: ["unsafe retry behavior", "no failure-path evidence"],
+    qualityCriticalityFloor: "medium"
+  },
+  hybrid: {
+    archetype: "hybrid",
+    requiredArtifacts: ["API surface", "UI/main interaction flow"],
+    requiredEvidence: ["API evidence", "UI evidence"],
+    behavioralChecks: ["integrated path works"],
+    disqualifyingConditions: ["missing one side of hybrid evidence"],
+    qualityCriticalityFloor: "medium"
+  },
+  unknown: {
+    archetype: "unknown",
+    requiredArtifacts: ["core deliverable"],
+    requiredEvidence: ["basic runnable evidence"],
+    behavioralChecks: ["main path works"],
+    disqualifyingConditions: ["no evidence of working main path"],
+    qualityCriticalityFloor: "low"
+  }
+};
+function resolveDonePolicy(opts) {
+  const archetype = opts.deliverable ?? "unknown";
+  const base = BASE_POLICIES2[archetype] ?? BASE_POLICIES2.unknown;
+  const ORDER = ["low", "medium", "high"];
+  const qualityCriticalityFloor = opts.qualityCriticality ? ORDER.indexOf(opts.qualityCriticality) > ORDER.indexOf(base.qualityCriticalityFloor) ? opts.qualityCriticality : base.qualityCriticalityFloor : base.qualityCriticalityFloor;
+  return {
+    ...base,
+    qualityCriticalityFloor
+  };
+}
+
+// lib/services/pipeline.ts
+function hasMeaningfulCompletionEvidence(summary, prUrl, createdTasks) {
+  if (summary && summary.trim().length >= 12) return true;
+  if (prUrl && prUrl.trim().length > 0) return true;
+  if (createdTasks && createdTasks.length > 0) return true;
+  return false;
+}
+function hasArchetypeSpecificEvidence(deliverable, summary, prUrl, createdTasks) {
+  if (prUrl && prUrl.trim().length > 0) return true;
+  if (createdTasks && createdTasks.length > 0) return true;
+  const text = (summary ?? "").toLowerCase();
+  if (!text) return deliverable === "unknown";
+  if (deliverable === "cli") return /cli|command|help|exit|argv|flag|terminal/.test(text);
+  if (deliverable === "api") return /api|endpoint|route|request|response|validation|handler/.test(text);
+  if (deliverable === "web-ui") return /ui|screen|page|render|flow|loading|error|form/.test(text);
+  if (deliverable === "hybrid") return /api|ui|flow|integration|endpoint|screen/.test(text);
+  return true;
+}
+function buildFinalAcceptanceSummary(opts) {
+  const openConcerns = [];
+  if (!opts.hasEvidence) openConcerns.push("missing_meaningful_completion_evidence");
+  if (opts.deliverable === "unknown") openConcerns.push("deliverable_inference_is_unknown");
+  if (!opts.closeRequested) openConcerns.push("completion_did_not_request_close");
+  if (opts.qualityCriticality === "high") openConcerns.push("quality_criticality_high_requires_conservative_review");
+  if (opts.riskProfile.length > 0) openConcerns.push(...opts.riskProfile.map((risk) => `risk:${risk}`));
+  return {
+    deliverable: opts.deliverable,
+    fidelityStatus: opts.deliverable === "unknown" ? "warn" : "pass",
+    qualityGateStatus: opts.qualityPolicy.requiredChecks.length > 0 ? "pass" : "warn",
+    evidenceStatus: opts.hasEvidence ? "pass" : "fail",
+    donePolicyStatus: opts.donePolicy.requiredArtifacts.length > 0 ? "pass" : "warn",
+    openConcerns
+  };
+}
+function resolvePipelineDeliverable(project) {
+  const stack = project?.environment?.stack ?? project?.stack ?? null;
+  if (stack === "nextjs") return "web-ui";
+  if (stack === "node-cli" || stack === "python-cli") return "cli";
+  if (stack === "express" || stack === "fastapi" || stack === "flask" || stack === "django") return "api";
+  const nameText = `${project?.name ?? ""} ${project?.slug ?? ""} ${project?.repo ?? ""}`.toLowerCase();
+  if (/\bcli\b|command/.test(nameText)) return "cli";
+  if (/\bapi\b|service|backend/.test(nameText)) return "api";
+  if (/dashboard|frontend|web|ui/.test(nameText)) return "web-ui";
+  return "unknown";
+}
+function buildHumanAcceptanceSummary(summary) {
+  const badges = [];
+  badges.push(`deliverable=${summary.deliverable}`);
+  badges.push(`evidence=${summary.evidenceStatus}`);
+  if (summary.fidelityStatus !== "pass") badges.push(`fidelity=${summary.fidelityStatus}`);
+  if (summary.qualityGateStatus !== "pass") badges.push(`quality=${summary.qualityGateStatus}`);
+  if (summary.donePolicyStatus !== "pass") badges.push(`done=${summary.donePolicyStatus}`);
+  const concerns = summary.openConcerns.filter(
+    (c) => c === "quality_criticality_high_requires_conservative_review" || c.startsWith("risk:") || c === "deliverable_inference_is_unknown"
+  );
+  if (concerns.length > 0) {
+    badges.push(`concerns=${concerns.slice(0, 3).join(",")}`);
+  }
+  return badges.join(" | ");
+}
 async function persistMergedArtifact(opts) {
   const { workspaceDir, projectSlug, issueId, issueRuntime, prUrl, headSha } = opts;
   const prNumber = issueRuntime?.currentPrNumber ?? null;
@@ -125782,7 +125990,74 @@ async function executeCompletion(opts) {
   let mergedArtifactHeadSha;
   const project = await loadProjectBySlug(workspaceDir, projectSlug);
   const issueRuntime = project ? getIssueRuntime(project, issueId) : void 0;
+  const deliverable = resolvePipelineDeliverable(project);
+  const qualityCriticality = issueRuntime?.qualityCriticality ?? "medium";
+  const qualityPolicy = resolveQualityGatePolicy({ deliverable, qualityCriticality });
+  const donePolicy = resolveDonePolicy({ deliverable, qualityCriticality: qualityPolicy.qualityCriticalityFloor });
   const prSelector = issueRuntime?.currentPrNumber ? { prNumber: issueRuntime.currentPrNumber } : void 0;
+  const closeRequested = completionRule.actions.includes(Action.CLOSE_ISSUE);
+  const hasEvidence = hasMeaningfulCompletionEvidence(effectiveSummary, prUrl, createdTasks);
+  const hasArchetypeEvidence = hasArchetypeSpecificEvidence(deliverable, effectiveSummary, prUrl, createdTasks);
+  const finalAcceptance = buildFinalAcceptanceSummary({
+    deliverable,
+    qualityPolicy,
+    donePolicy,
+    hasEvidence,
+    closeRequested,
+    qualityCriticality,
+    riskProfile: issueRuntime?.riskProfile ?? []
+  });
+  await log(workspaceDir, "completion_policy_snapshot", {
+    project: projectName,
+    issue: issueId,
+    role,
+    deliverable,
+    qualityGateChecks: qualityPolicy.requiredChecks,
+    requiredEvidence: qualityPolicy.requiredEvidence,
+    doneArtifacts: donePolicy.requiredArtifacts,
+    doneEvidence: donePolicy.requiredEvidence,
+    qualityCriticality,
+    qualityCriticalityFloor: qualityPolicy.qualityCriticalityFloor,
+    riskProfile: issueRuntime?.riskProfile ?? [],
+    finalAcceptance
+  }).catch(() => {
+  });
+  await log(workspaceDir, "final_acceptance_summary", {
+    project: projectName,
+    issue: issueId,
+    role,
+    ...finalAcceptance
+  }).catch(() => {
+  });
+  if (closeRequested && !hasEvidence) {
+    await log(workspaceDir, "completion_policy_block", {
+      project: projectName,
+      issue: issueId,
+      role,
+      result,
+      reason: "missing_completion_evidence",
+      deliverable,
+      requiredEvidence: donePolicy.requiredEvidence
+    }).catch(() => {
+    });
+    throw new Error(
+      `Refusing to complete issue #${issueId} without meaningful completion evidence for ${deliverable}. Provide a substantive summary, PR evidence, or created-task evidence before close.`
+    );
+  }
+  if (closeRequested && !hasArchetypeEvidence) {
+    await log(workspaceDir, "completion_policy_block", {
+      project: projectName,
+      issue: issueId,
+      role,
+      result,
+      reason: "missing_archetype_specific_evidence",
+      deliverable
+    }).catch(() => {
+    });
+    throw new Error(
+      `Refusing to complete issue #${issueId} because the final summary lacks ${deliverable}-specific evidence. Describe the relevant ${deliverable} behavior more concretely or attach PR/task evidence.`
+    );
+  }
   const shouldBlockMergeBeforeTest = completionRule.actions.includes(Action.MERGE_PR) && role === "reviewer" && (workflow.testPolicy ?? TestPolicy.SKIP) === TestPolicy.AGENT;
   if (shouldBlockMergeBeforeTest) {
     completionRule = {
@@ -125930,6 +126205,7 @@ async function executeCompletion(opts) {
   }
   const notifyConfig = getNotificationConfig(pluginConfig);
   await provider.transitionLabel(issueId, completionRule.from, completionRule.to);
+  const acceptanceSummary = buildHumanAcceptanceSummary(finalAcceptance);
   for (const action of completionRule.actions) {
     switch (action) {
       case Action.CLOSE_ISSUE:
@@ -125951,7 +126227,8 @@ async function executeCompletion(opts) {
             issueId,
             issueUrl: issue2.web_url,
             issueTitle: issue2.title,
-            prUrl
+            prUrl,
+            acceptanceSummary
           },
           {
             workspaceDir,
@@ -126015,6 +126292,7 @@ async function executeCompletion(opts) {
       name: workerName,
       result: effectiveResult,
       summary: effectiveSummary,
+      acceptanceSummary,
       nextState,
       prUrl,
       createdTasks,
@@ -126132,7 +126410,8 @@ ${nextState}.`;
     prUrl,
     issueUrl: issue2.web_url,
     issueClosed: completionRule.actions.includes(Action.CLOSE_ISSUE),
-    issueReopened: completionRule.actions.includes(Action.REOPEN_ISSUE)
+    issueReopened: completionRule.actions.includes(Action.REOPEN_ISSUE),
+    finalAcceptance
   };
 }
 function describeStateByLabel(workflow, label) {
@@ -129055,6 +129334,7 @@ async function dispatchTask(opts) {
     pluginConfig,
     runtime
   } = opts;
+  const triggerSource = opts.triggerSource ?? "unknown";
   const slotIndex = opts.slotIndex ?? 0;
   const rc = opts.runCommand;
   const resolvedConfig = await loadConfig(workspaceDir, project.slug);
@@ -129101,6 +129381,8 @@ async function dispatchTask(opts) {
       role,
       level,
       fromLabel,
+      triggerSource,
+      dispatchSemantic: "feedback_redispatch",
       sessionKey: existingSessionKey,
       reason: "developer_feedback_cycle_requires_fresh_context"
     }).catch(() => {
@@ -129147,6 +129429,8 @@ async function dispatchTask(opts) {
         issue: issueId,
         role,
         level,
+        triggerSource,
+        dispatchSemantic: feedbackFreshSession ? "feedback_redispatch" : "fresh_dispatch",
         sessionKey,
         reason: feedbackFreshSession ? "gateway_session_alive_without_local_slot_tracking_after_feedback_reset" : "gateway_session_alive_without_local_slot_tracking"
       }).catch(() => {
@@ -129444,7 +129728,8 @@ async function dispatchTask(opts) {
       originalModel: effectiveModel.downgraded ? resolvedModel : void 0,
       effectiveModel: effectiveModel.downgraded ? model : void 0,
       dispatchCycleId,
-      dispatchRunId: sendResult.runId
+      dispatchRunId: sendResult.runId,
+      triggerSource
     },
     {
       workspaceDir,
@@ -129478,6 +129763,8 @@ async function dispatchTask(opts) {
     modelAvailability: effectiveModel.availableModels,
     workflowMeta: resolvedConfig.workflowMeta,
     sessionAction,
+    dispatchSemantic,
+    triggerSource,
     sessionKey,
     fromLabel,
     toLabel,
@@ -129514,7 +129801,9 @@ async function auditDispatch(workspaceDir, opts) {
     role: opts.role,
     level: opts.level,
     sessionAction: opts.sessionAction,
+    dispatchSemantic: opts.dispatchSemantic,
     sessionKey: opts.sessionKey,
+    triggerSource: opts.triggerSource,
     sessionLabel: opts.sessionLabel,
     sessionLabelFull: opts.sessionLabelFull,
     labelTransition: `${opts.fromLabel} \u2192 ${opts.toLabel}`
@@ -129525,6 +129814,8 @@ async function auditDispatch(workspaceDir, opts) {
     role: opts.role,
     level: opts.level,
     sessionAction: opts.sessionAction,
+    dispatchSemantic: opts.dispatchSemantic,
+    triggerSource: opts.triggerSource,
     sessionKey: opts.sessionKey,
     sessionLabel: opts.sessionLabel,
     sessionLabelFull: opts.sessionLabelFull
@@ -141231,6 +141522,8 @@ var triageStep = {
                 childReadyForDispatch: decision.targetState === "To Do",
                 parallelizable: child.draft.parallelizable,
                 recommendedLevel: child.draft.recommendedLevel,
+                qualityCriticality: decision.qualityCriticality,
+                riskProfile: decision.riskProfile,
                 decompositionMode: "none",
                 decompositionStatus: null
               }).catch(() => {
@@ -141239,6 +141532,8 @@ var triageStep = {
             await updateIssueRuntime(ctx.workspaceDir, projectSlug, issue2.number, {
               childIssueIds: createdChildIssueNumbers,
               maxParallelChildren: computeMaxParallelChildren(decompositionDrafts),
+              qualityCriticality: decision.qualityCriticality,
+              riskProfile: decision.riskProfile,
               decompositionMode: "parent_child",
               decompositionStatus: "active"
             }).catch(() => {
@@ -141356,6 +141651,14 @@ var triageStep = {
       }).catch(() => {
       });
     }
+    const resolvedProjectSlug = payload.metadata?.project_slug ?? payload.scaffold?.project_slug ?? null;
+    if (resolvedProjectSlug) {
+      await updateIssueRuntime(ctx.workspaceDir, resolvedProjectSlug, issue2.number, {
+        qualityCriticality: decision.qualityCriticality,
+        riskProfile: decision.riskProfile
+      }).catch(() => {
+      });
+    }
     return {
       ...payload,
       step: "triage",
@@ -141843,6 +142146,7 @@ async function projectTick(opts) {
     instanceName,
     runCommand
   } = opts;
+  const triggerSource = opts.triggerSource ?? (targetRole ? "followup_tick" : "heartbeat_periodic");
   const ensureEnvironment = opts.ensureEnvironmentReady ?? ensureEnvironmentReady;
   const dispatch = opts.dispatchTask ?? dispatchTask;
   const project = getProject(await readProjects(workspaceDir), projectSlug);
@@ -142122,7 +142426,8 @@ async function projectTick(opts) {
           runtime,
           slotIndex: freeSlot,
           instanceName,
-          runCommand
+          runCommand,
+          triggerSource
         });
         pickups.push({
           project: project.name,
@@ -142133,6 +142438,7 @@ async function projectTick(opts) {
           role,
           level: dr.level,
           sessionAction: dr.sessionAction,
+          triggerSource,
           announcement: dr.announcement
         });
         await recordDispatch(workspaceDir, dispatchId).catch(() => {
@@ -143311,7 +143617,8 @@ async function completeRegisteredBootstrap(ctx, workspaceDir, session) {
         pluginConfig: ctx.pluginConfig,
         runtime: ctx.runtime,
         runCommand: ctx.runCommand,
-        maxPickups: 1
+        maxPickups: 1,
+        triggerSource: "bootstrap_immediate_tick"
       });
     } catch (error48) {
       logBootstrapWarning(ctx, `[telegram-bootstrap] immediate projectTick failed: ${error48 instanceof Error ? error48.message : String(error48)}`);
@@ -145881,7 +146188,8 @@ async function tick(opts) {
         maxPickups: remaining,
         instanceName,
         runtime,
-        runCommand
+        runCommand,
+        triggerSource: "heartbeat_periodic"
       });
       result.totalPickups += tickResult.pickups.length;
       result.totalSkipped += tickResult.skipped.length;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mestreyoda/fabrica",
-  "version": "0.2.23",
+  "version": "0.2.24",
   "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",