@mestreyoda/fabrica 0.2.21 → 0.2.22

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.21") {
-    return "0.2.21";
+  if ("0.2.22") {
+    return "0.2.22";
   }
   try {
     const pkgPath = path5.join(THIS_DIR, "..", "..", "package.json");
@@ -118618,9 +118618,9 @@ function fallbackSpecData(type, rawIdea) {
     default:
       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"
+        "Allows operators to complete the primary workflow end to end as requested",
+        "Validates and enforces the role, permission, or delivery constraints described in the request",
+        "Processes the asynchronous or background behavior required for the main operational path"
       ];
   }
   return base;
@@ -139764,6 +139764,287 @@ var securityReviewStep = {
 
 // lib/intake/steps/create-task.ts
 init_workflow();
+
+// lib/dispatch/telegram-bootstrap-session.ts
+init_constants();
+import { createHash as createHash4, randomUUID as randomUUID4 } from "node:crypto";
+import fs34 from "node:fs/promises";
+import path35 from "node:path";
+var SESSION_TTL_MS = 10 * 6e4;
+var CLASSIFYING_TTL_MS = 15e3;
+var RELEASED_CLASSIFY_ERRORS = /* @__PURE__ */ new Set([
+  "classify_invalid_result",
+  "classify_low_confidence",
+  "classify_not_project",
+  "classify_result_expired"
+]);
+function toCanonicalTelegramBootstrapConversationId(conversationId) {
+  const trimmed = conversationId.trim();
+  if (!trimmed) return trimmed;
+  return trimmed.startsWith("telegram:") ? trimmed : `telegram:${trimmed}`;
+}
+function sessionsDir(workspaceDir) {
+  return path35.join(workspaceDir, DATA_DIR, "bootstrap-sessions");
+}
+function sessionPath(workspaceDir, conversationId) {
+  return path35.join(
+    sessionsDir(workspaceDir),
+    `${toCanonicalTelegramBootstrapConversationId(conversationId)}.json`
+  );
+}
+function alternateSessionPath(workspaceDir, conversationId) {
+  const canonical = toCanonicalTelegramBootstrapConversationId(conversationId);
+  const bare = canonical.startsWith("telegram:") ? canonical.slice("telegram:".length) : canonical;
+  if (!bare || bare === canonical) return null;
+  return path35.join(sessionsDir(workspaceDir), `${bare}.json`);
+}
+function normalizeStoredSession(session) {
+  const canonicalConversationId = toCanonicalTelegramBootstrapConversationId(session.conversationId);
+  if (canonicalConversationId === session.conversationId) {
+    return session;
+  }
+  return {
+    ...session,
+    id: buildBootstrapSessionId(canonicalConversationId, session.rawIdea),
+    conversationId: canonicalConversationId
+  };
+}
+function stableHash(input) {
+  return createHash4("sha256").update(input).digest("hex").slice(0, 16);
+}
+function buildBootstrapSessionId(conversationId, rawIdea) {
+  return `tgdm-${conversationId}-${stableHash(rawIdea.trim().toLowerCase())}`;
+}
+function buildBootstrapRequestFingerprint(input) {
+  return stableHash(JSON.stringify({
+    rawIdea: input.rawIdea.trim().toLowerCase(),
+    projectName: input.projectName?.trim().toLowerCase() || null,
+    stackHint: input.stackHint?.trim().toLowerCase() || null,
+    repoUrl: input.repoUrl?.trim().toLowerCase() || null,
+    repoPath: input.repoPath?.trim().toLowerCase() || null
+  }));
+}
+function buildBootstrapRequestHash(input) {
+  return buildBootstrapRequestFingerprint(input);
+}
+function nextSuppressUntil(status) {
+  const ttl = status === "classifying" || status === "pending_classify" ? CLASSIFYING_TTL_MS : SESSION_TTL_MS;
+  return new Date(Date.now() + ttl).toISOString();
+}
+function isReleasedClassifyFailure(error48) {
+  return Boolean(error48 && RELEASED_CLASSIFY_ERRORS.has(error48));
+}
+function resolveNullableField(inputValue, existingValue, fallback = null) {
+  return inputValue !== void 0 ? inputValue : existingValue ?? fallback;
+}
+function defaultNextRetryAtForStatus(status, existingValue) {
+  if (status === "bootstrapping" || status === "dispatching") {
+    return existingValue ?? null;
+  }
+  return null;
+}
+var MONOTONIC_BOOTSTRAP_FIELDS = [
+  "ackSentAt",
+  "projectRegisteredAt",
+  "topicKickoffSentAt",
+  "projectTickedAt",
+  "completionAckSentAt"
+];
+function shouldPersistBootstrapCheckpoint(current, next) {
+  if (!current) return { ok: true };
+  if (current.conversationId !== next.conversationId) return { ok: true };
+  const currentAttemptSeq = current.attemptSeq ?? null;
+  const nextAttemptSeq = next.attemptSeq ?? null;
+  if (currentAttemptSeq != null && nextAttemptSeq != null && nextAttemptSeq < currentAttemptSeq) {
+    return { ok: false, reason: "stale_regression" };
+  }
+  const sameAttempt = Boolean(
+    current.attemptId && next.attemptId && current.attemptSeq != null && next.attemptSeq != null && current.attemptId === next.attemptId && current.attemptSeq === next.attemptSeq
+  );
+  if (!sameAttempt) return { ok: true };
+  for (const field of MONOTONIC_BOOTSTRAP_FIELDS) {
+    if (current[field] && !next[field]) {
+      return { ok: false, reason: "stale_regression" };
+    }
+  }
+  return { ok: true };
+}
+async function readTelegramBootstrapSession(workspaceDir, conversationId) {
+  const canonicalConversationId = toCanonicalTelegramBootstrapConversationId(conversationId);
+  const paths = [
+    sessionPath(workspaceDir, canonicalConversationId),
+    alternateSessionPath(workspaceDir, conversationId)
+  ].filter((entry) => Boolean(entry));
+  try {
+    for (const candidatePath of paths) {
+      try {
+        const raw = await fs34.readFile(candidatePath, "utf-8");
+        const session = normalizeStoredSession(JSON.parse(raw));
+        if (session.status === "failed" && isReleasedClassifyFailure(session.error)) {
+          await deleteTelegramBootstrapSession(workspaceDir, canonicalConversationId);
+          return null;
+        }
+        return session;
+      } catch (error48) {
+        if (error48?.code === "ENOENT") continue;
+        throw error48;
+      }
+    }
+    return null;
+  } catch (error48) {
+    if (error48?.code === "ENOENT") return null;
+    throw error48;
+  }
+}
+async function deleteTelegramBootstrapSession(workspaceDir, conversationId) {
+  await fs34.unlink(sessionPath(workspaceDir, conversationId)).catch(() => {
+  });
+  const legacyPath = alternateSessionPath(workspaceDir, conversationId);
+  if (legacyPath) {
+    await fs34.unlink(legacyPath).catch(() => {
+    });
+  }
+}
+async function writeTelegramBootstrapSession(workspaceDir, session) {
+  const canonicalSession = normalizeStoredSession(session);
+  const dir = sessionsDir(workspaceDir);
+  await fs34.mkdir(dir, { recursive: true });
+  const file2 = sessionPath(workspaceDir, canonicalSession.conversationId);
+  const tmp = `${file2}.${randomUUID4()}.tmp`;
+  await fs34.writeFile(tmp, JSON.stringify(canonicalSession, null, 2) + "\n", "utf-8");
+  await fs34.rename(tmp, file2);
+  const legacyPath = alternateSessionPath(workspaceDir, session.conversationId);
+  if (legacyPath) {
+    await fs34.unlink(legacyPath).catch(() => {
+    });
+  }
+}
+async function upsertTelegramBootstrapSession(workspaceDir, input) {
+  const conversationId = toCanonicalTelegramBootstrapConversationId(input.conversationId);
+  const existing = await readTelegramBootstrapSession(workspaceDir, conversationId);
+  const resolvedSourceRoute = resolveNullableField(input.sourceRoute, existing?.sourceRoute);
+  const resolvedProjectRoute = resolveNullableField(input.projectRoute, existing?.projectRoute);
+  const resolvedProjectName = resolveNullableField(input.projectName, existing?.projectName);
+  const resolvedStackHint = resolveNullableField(input.stackHint, existing?.stackHint);
+  const resolvedRepoUrl = resolveNullableField(input.repoUrl, existing?.repoUrl);
+  const resolvedRepoPath = resolveNullableField(input.repoPath, existing?.repoPath);
+  const resolvedProjectSlug = resolveNullableField(input.projectSlug, existing?.projectSlug);
+  const resolvedIssueId = resolveNullableField(input.issueId, existing?.issueId);
+  const resolvedIssueUrl = resolveNullableField(input.issueUrl, existing?.issueUrl);
+  const resolvedTriageReadyForDispatch = resolveNullableField(input.triageReadyForDispatch, existing?.triageReadyForDispatch);
+  const resolvedTriageErrors = input.triageErrors !== void 0 ? input.triageErrors : existing?.triageErrors ?? null;
+  const resolvedMessageThreadId = resolveNullableField(input.messageThreadId, existing?.messageThreadId);
+  const resolvedProjectChannelId = resolveNullableField(input.projectChannelId, existing?.projectChannelId);
+  const resolvedAttemptCount = resolveNullableField(input.attemptCount, existing?.attemptCount, 0);
+  const resolvedAttemptId = resolveNullableField(input.attemptId, existing?.attemptId);
+  const resolvedAttemptSeq = resolveNullableField(input.attemptSeq, existing?.attemptSeq);
+  const resolvedClassifySessionKey = resolveNullableField(input.classifySessionKey, existing?.classifySessionKey);
+  const resolvedClassifyRunId = resolveNullableField(input.classifyRunId, existing?.classifyRunId);
+  const resolvedClassifyStartedAt = resolveNullableField(input.classifyStartedAt, existing?.classifyStartedAt);
+  const resolvedBootstrapStep = resolveNullableField(input.bootstrapStep, existing?.bootstrapStep);
+  const resolvedNextRetryAt = input.nextRetryAt !== void 0 ? input.nextRetryAt : defaultNextRetryAtForStatus(input.status, existing?.nextRetryAt);
+  const resolvedAckSentAt = resolveNullableField(input.ackSentAt, existing?.ackSentAt);
+  const resolvedProjectRegisteredAt = resolveNullableField(input.projectRegisteredAt, existing?.projectRegisteredAt);
+  const resolvedTopicKickoffSentAt = resolveNullableField(input.topicKickoffSentAt, existing?.topicKickoffSentAt);
+  const resolvedProjectTickedAt = resolveNullableField(input.projectTickedAt, existing?.projectTickedAt);
+  const resolvedCompletionAckSentAt = resolveNullableField(input.completionAckSentAt, existing?.completionAckSentAt);
+  const resolvedError = input.error !== void 0 ? input.error : input.lastError !== void 0 ? input.lastError : existing?.error ?? existing?.lastError ?? null;
+  const requestHash = buildBootstrapRequestHash({
+    rawIdea: input.rawIdea,
+    projectName: resolvedProjectName,
+    stackHint: resolvedStackHint,
+    repoUrl: resolvedRepoUrl,
+    repoPath: resolvedRepoPath
+  });
+  const now2 = (/* @__PURE__ */ new Date()).toISOString();
+  const session = {
+    id: existing?.id ?? buildBootstrapSessionId(conversationId, input.rawIdea),
+    conversationId,
+    sourceChannel: input.sourceChannel ?? input.sourceRoute?.channel ?? existing?.sourceChannel ?? "telegram",
+    sourceRoute: resolvedSourceRoute,
+    projectRoute: resolvedProjectRoute,
+    requestHash,
+    requestFingerprint: requestHash,
+    lastCompletedRequestHash: input.status === "completed" ? requestHash : existing?.lastCompletedRequestHash ?? null,
+    rawIdea: input.rawIdea,
+    projectName: resolvedProjectName,
+    stackHint: resolvedStackHint,
+    repoUrl: resolvedRepoUrl,
+    repoPath: resolvedRepoPath,
+    projectSlug: resolvedProjectSlug,
+    issueId: resolvedIssueId,
+    issueUrl: resolvedIssueUrl,
+    triageReadyForDispatch: resolvedTriageReadyForDispatch,
+    triageErrors: resolvedTriageErrors,
+    messageThreadId: resolvedMessageThreadId,
+    projectChannelId: resolvedProjectChannelId,
+    language: input.language ?? existing?.language,
+    status: input.status,
+    attemptId: resolvedAttemptId,
+    attemptSeq: resolvedAttemptSeq,
+    classifySessionKey: resolvedClassifySessionKey,
+    classifyRunId: resolvedClassifyRunId,
+    classifyStartedAt: resolvedClassifyStartedAt,
+    bootstrapStep: resolvedBootstrapStep,
+    attemptCount: resolvedAttemptCount,
+    lastError: resolvedError,
+    nextRetryAt: resolvedNextRetryAt,
+    ackSentAt: resolvedAckSentAt,
+    projectRegisteredAt: resolvedProjectRegisteredAt,
+    topicKickoffSentAt: resolvedTopicKickoffSentAt,
+    projectTickedAt: resolvedProjectTickedAt,
+    completionAckSentAt: resolvedCompletionAckSentAt,
+    pendingClarification: input.pendingClarification !== void 0 ? input.pendingClarification : existing?.pendingClarification ?? null,
+    orphanedArtifacts: input.orphanedArtifacts !== void 0 ? input.orphanedArtifacts : existing?.orphanedArtifacts ?? null,
+    createdAt: existing?.createdAt ?? now2,
+    updatedAt: now2,
+    suppressUntil: nextSuppressUntil(input.status),
+    error: resolvedError
+  };
+  const writeDecision = shouldPersistBootstrapCheckpoint(existing, session);
+  if (!writeDecision.ok && existing) {
+    return existing;
+  }
+  await writeTelegramBootstrapSession(workspaceDir, session);
+  return session;
+}
+function shouldSuppressTelegramBootstrapReply(session, request) {
+  if (!session) return false;
+  if (isTelegramBootstrapSessionExpired(session)) return false;
+  if (session.status === "completed" || session.status === "failed") {
+    if (session.status === "failed" && isReleasedClassifyFailure(session.error)) return false;
+    if (!request) return false;
+    return buildBootstrapRequestFingerprint(request) === session.requestHash;
+  }
+  if (!request) return true;
+  return buildBootstrapRequestFingerprint(request) === session.requestHash;
+}
+function isTelegramBootstrapSessionExpired(session, now2 = Date.now()) {
+  if (!session) return false;
+  const suppressUntil = Date.parse(session.suppressUntil);
+  return !Number.isNaN(suppressUntil) && suppressUntil < now2;
+}
+function isRecoverableTelegramBootstrapSession(session) {
+  return session?.status === "bootstrapping" || session?.status === "dispatching";
+}
+function isClaimableTelegramBootstrapSession(session, now2 = Date.now()) {
+  if (!isRecoverableTelegramBootstrapSession(session)) return false;
+  if (!session.nextRetryAt) return true;
+  const retryAt = Date.parse(session.nextRetryAt);
+  return Number.isNaN(retryAt) || retryAt <= now2;
+}
+function isSupersededTelegramBootstrapAttempt(current, candidate) {
+  if (!current || !candidate) return false;
+  if (current.conversationId !== candidate.conversationId) return true;
+  const currentHasAttempt = current.attemptId != null && current.attemptSeq != null;
+  const candidateHasAttempt = candidate.attemptId != null && candidate.attemptSeq != null;
+  if (currentHasAttempt || candidateHasAttempt) {
+    return current.attemptId !== candidate.attemptId || current.attemptSeq !== candidate.attemptSeq;
+  }
+  return current.requestHash !== candidate.requestHash || current.status !== candidate.status || current.updatedAt !== candidate.updatedAt;
+}
+
+// lib/intake/steps/create-task.ts
 function buildIssueBody(payload) {
   const spec = payload.spec;
   const sections = [];
@@ -139835,6 +140116,26 @@ var createTaskStep = {
         created_at: (/* @__PURE__ */ new Date()).toISOString()
       };
       ctx.log(`Issue created via provider: #${issue3.number} \u2014 ${issue3.url}`);
+      const bootstrapConversationId2 = payload.metadata?.source === "telegram-dm-bootstrap" ? payload.metadata?.channel_id : null;
+      if (bootstrapConversationId2) {
+        await upsertTelegramBootstrapSession(ctx.workspaceDir, {
+          conversationId: String(bootstrapConversationId2),
+          rawIdea: payload.raw_idea,
+          projectName: payload.metadata?.project_name ?? null,
+          stackHint: payload.metadata?.stack_hint ?? null,
+          repoUrl: repoUrl ?? null,
+          repoPath: repoPath ?? null,
+          status: "dispatching",
+          bootstrapStep: "project_registered",
+          projectSlug: projectSlug ?? null,
+          issueId: issue3.number,
+          issueUrl: issue3.url,
+          projectChannelId: payload.metadata?.channel_id ?? null,
+          messageThreadId: payload.metadata?.message_thread_id ?? null,
+          projectRegisteredAt: (/* @__PURE__ */ new Date()).toISOString()
+        }).catch(() => {
+        });
+      }
       return {
         ...payload,
         step: "create-task",
@@ -139870,6 +140171,26 @@ var createTaskStep = {
       created_at: (/* @__PURE__ */ new Date()).toISOString()
     };
     ctx.log(`Issue created via compatibility fallback: #${issueNumber} \u2014 ${issueUrl}`);
+    const bootstrapConversationId = payload.metadata?.source === "telegram-dm-bootstrap" ? payload.metadata?.channel_id : null;
+    if (bootstrapConversationId) {
+      await upsertTelegramBootstrapSession(ctx.workspaceDir, {
+        conversationId: String(bootstrapConversationId),
+        rawIdea: payload.raw_idea,
+        projectName: payload.metadata?.project_name ?? null,
+        stackHint: payload.metadata?.stack_hint ?? null,
+        repoUrl: repoUrl ?? null,
+        repoPath: repoPath ?? null,
+        status: "dispatching",
+        bootstrapStep: "project_registered",
+        projectSlug: projectSlug ?? null,
+        issueId: issue2.number,
+        issueUrl: issue2.url,
+        projectChannelId: payload.metadata?.channel_id ?? null,
+        messageThreadId: payload.metadata?.message_thread_id ?? null,
+        projectRegisteredAt: (/* @__PURE__ */ new Date()).toISOString()
+      }).catch(() => {
+      });
+    }
     return {
       ...payload,
       step: "create-task",
@@ -139996,7 +140317,7 @@ function runTriageLogic(input, matrix) {
     objective: input.objective ?? input.rawIdea,
     scopeItems: (input.scopeText ?? "").split("\n").filter((l) => l.trim()),
     acceptanceCriteria: (input.acText ?? "").split("\n").filter((l) => l.trim()),
-    dod: input.scopeText ?? ""
+    dod: input.dodText ?? ""
   });
   const specQualityBlock = specQualityErrors.length > 0;
   return {
@@ -140100,8 +140421,9 @@ var triageStep = {
       rawIdea: payload.raw_idea,
       acText: spec.acceptance_criteria.join("\n"),
       scopeText: spec.scope_v1.join("\n"),
+      dodText: spec.definition_of_done.join("\n"),
       oosText: spec.out_of_scope.join("\n"),
-      authSignal: payload.metadata?.auth_gate?.signal ?? false
+      authSignal: /\b(login|register|jwt|oauth|auth|role-based access|rbac|permission)\b/i.test(`${payload.raw_idea} ${spec.objective}`)
     }, matrix);
     const repoUrl = payload.scaffold?.repo_url ?? payload.metadata?.repo_url ?? "";
     const repoPath = payload.provisioning?.repo_local ?? payload.scaffold?.repo_local ?? payload.metadata?.repo_path ?? payload.project_map?.root ?? void 0;
@@ -140229,6 +140551,27 @@ var triageStep = {
       child_issue_numbers: createdChildIssueNumbers
     };
     ctx.log(`Triage: ${triage.priority}, effort=${triage.effort}, ready=${triage.ready_for_dispatch}`);
+    const bootstrapConversationId = payload.metadata?.source === "telegram-dm-bootstrap" ? payload.metadata?.channel_id : null;
+    if (bootstrapConversationId) {
+      await upsertTelegramBootstrapSession(ctx.workspaceDir, {
+        conversationId: String(bootstrapConversationId),
+        rawIdea: payload.raw_idea,
+        projectName: payload.metadata?.project_name ?? null,
+        stackHint: payload.metadata?.stack_hint ?? null,
+        repoUrl: payload.provisioning?.repo_url ?? payload.scaffold?.repo_url ?? payload.metadata?.repo_url ?? null,
+        repoPath: payload.provisioning?.repo_local ?? payload.scaffold?.repo_local ?? payload.metadata?.repo_path ?? null,
+        status: triage.ready_for_dispatch ? "dispatching" : "completed",
+        bootstrapStep: triage.ready_for_dispatch ? "project_ticked" : "completed",
+        projectSlug: payload.metadata?.project_slug ?? payload.scaffold?.project_slug ?? null,
+        issueId: issue2.number,
+        issueUrl: issue2.url,
+        projectChannelId: triage.project_channel_id ?? payload.metadata?.channel_id ?? null,
+        messageThreadId: payload.metadata?.message_thread_id ?? null,
+        triageReadyForDispatch: triage.ready_for_dispatch,
+        triageErrors: triage.errors
+      }).catch(() => {
+      });
+    }
     return {
       ...payload,
       step: "triage",
@@ -140576,23 +140919,23 @@ init_workflow();
 
 // lib/dispatch/dispatch-dedup.ts
 init_constants();
-import fs34 from "node:fs/promises";
-import path35 from "node:path";
-import { createHash as createHash4 } from "node:crypto";
+import fs35 from "node:fs/promises";
+import path36 from "node:path";
+import { createHash as createHash5 } from "node:crypto";
 var DEDUP_FILE = "dispatch-dedup.ndjson";
 var BUCKET_MS = 5 * 6e4;
 var DEFAULT_TTL_MS2 = 30 * 6e4;
 function dedupPath(workspaceDir) {
-  return path35.join(workspaceDir, DATA_DIR, DEDUP_FILE);
+  return path36.join(workspaceDir, DATA_DIR, DEDUP_FILE);
 }
 function computeDispatchId(projectSlug, issueId, role, level, now2 = Date.now()) {
   const bucket = Math.floor(now2 / BUCKET_MS);
   const input = `${projectSlug}:${issueId}:${role}:${level}:${bucket}`;
-  return createHash4("sha256").update(input).digest("hex").slice(0, 16);
+  return createHash5("sha256").update(input).digest("hex").slice(0, 16);
 }
 async function readEntries2(filePath) {
   try {
-    const content = await fs34.readFile(filePath, "utf-8");
+    const content = await fs35.readFile(filePath, "utf-8");
     return content.split("\n").filter(Boolean).map((line) => {
       try {
         return JSON.parse(line);
@@ -140611,9 +140954,9 @@ async function isDuplicate(workspaceDir, dispatchId) {
 }
 async function recordDispatch(workspaceDir, dispatchId) {
   const filePath = dedupPath(workspaceDir);
-  await fs34.mkdir(path35.dirname(filePath), { recursive: true });
+  await fs35.mkdir(path36.dirname(filePath), { recursive: true });
   const entry = { id: dispatchId, ts: Date.now() };
-  await fs34.appendFile(filePath, JSON.stringify(entry) + "\n", "utf-8");
+  await fs35.appendFile(filePath, JSON.stringify(entry) + "\n", "utf-8");
 }
 async function cleanupExpired(workspaceDir, ttlMs = DEFAULT_TTL_MS2) {
   const filePath = dedupPath(workspaceDir);
@@ -140623,8 +140966,8 @@ async function cleanupExpired(workspaceDir, ttlMs = DEFAULT_TTL_MS2) {
   if (kept.length < entries.length) {
     const content = kept.map((e2) => JSON.stringify(e2)).join("\n") + (kept.length > 0 ? "\n" : "");
     const tmpPath = filePath + ".tmp";
-    await fs34.writeFile(tmpPath, content, "utf-8");
-    await fs34.rename(tmpPath, filePath);
+    await fs35.writeFile(tmpPath, content, "utf-8");
+    await fs35.rename(tmpPath, filePath);
   }
 }
 
@@ -140856,392 +141199,117 @@ async function projectTick(opts) {
       if (dryRun) {
         const existingSession = roleWorker.levels[effectiveLevel]?.[freeSlot]?.sessionKey;
         pickups.push({
-          project: project.name,
-          projectSlug,
-          issueId: issue2.iid,
-          issueTitle: issue2.title,
-          issueUrl: issue2.web_url,
-          role,
-          level: effectiveLevel,
-          sessionAction: existingSession ? "send" : "spawn",
-          announcement: `[DRY RUN] Would pick up #${issue2.iid}`
-        });
-        pickupCount++;
-        continue;
-      }
-      const environment = await ensureEnvironment({
-        workspaceDir,
-        projectSlug,
-        project: fresh,
-        stack,
-        mode: role === "tester" ? "tester" : "developer",
-        runCommand
-      });
-      if (!environment.ready) {
-        const environmentSkipReason = classifyEnvironmentGateSkip(environment.state);
-        skipped.push({ role, reason: environmentSkipReason });
-        await log(workspaceDir, "dispatch_blocked_environment_not_ready", {
-          projectSlug,
-          role,
-          issueId: issue2.iid,
-          reason: environmentSkipReason,
-          environmentStatus: environment.state.status,
-          nextProvisionRetryAt: environment.state.nextProvisionRetryAt ?? null,
-          lastProvisionError: environment.state.lastProvisionError ?? null
-        }).catch(() => {
-        });
-        continue;
-      }
-    }
-    if (dryRun) {
-      const existingSession = roleWorker.levels[effectiveLevel]?.[freeSlot]?.sessionKey;
-      pickups.push({
-        project: project.name,
-        projectSlug,
-        issueId: issue2.iid,
-        issueTitle: issue2.title,
-        issueUrl: issue2.web_url,
-        role,
-        level: effectiveLevel,
-        sessionAction: existingSession ? "send" : "spawn",
-        announcement: `[DRY RUN] Would pick up #${issue2.iid}`
-      });
-    } else {
-      try {
-        const dr = await dispatch({
-          workspaceDir,
-          agentId,
-          project: fresh,
-          issueId: issue2.iid,
-          issueTitle: issue2.title,
-          issueDescription: issue2.description ?? "",
-          issueUrl: issue2.web_url,
-          role,
-          level: effectiveLevel,
-          fromLabel: currentLabel,
-          toLabel: targetLabel,
-          provider,
-          pluginConfig,
-          sessionKey,
-          runtime,
-          slotIndex: freeSlot,
-          instanceName,
-          runCommand
-        });
-        pickups.push({
-          project: project.name,
-          projectSlug,
-          issueId: issue2.iid,
-          issueTitle: issue2.title,
-          issueUrl: issue2.web_url,
-          role,
-          level: dr.level,
-          sessionAction: dr.sessionAction,
-          announcement: dr.announcement
-        });
-        await recordDispatch(workspaceDir, dispatchId).catch(() => {
-        });
-      } catch (err) {
-        skipped.push({ role, reason: `Dispatch failed: ${err.message}` });
-        continue;
-      }
-    }
-    pickupCount++;
-  }
-  return { pickups, skipped };
-}
-function resolveLevelForIssue(issue2, role) {
-  const roleLevel = detectRoleLevelFromLabels(issue2.labels);
-  if (roleLevel?.role === role) return roleLevel.level;
-  if (roleLevel) {
-    const levels = getLevelsForRole(role);
-    if (levels.includes(roleLevel.level)) return roleLevel.level;
-  }
-  return selectLevel(issue2.title, issue2.description ?? "", role).level;
-}
-function getFeedbackQueueLabel(workflow) {
-  const developerQueues = getQueueLabels(workflow, "developer");
-  return developerQueues.find((label) => isFeedbackState(workflow, label)) ?? null;
-}
-
-// lib/dispatch/telegram-bootstrap-hook.ts
-init_audit();
-init_zod();
-
-// lib/dispatch/telegram-bootstrap-session.ts
-init_constants();
-import { createHash as createHash5, randomUUID as randomUUID4 } from "node:crypto";
-import fs35 from "node:fs/promises";
-import path36 from "node:path";
-var SESSION_TTL_MS = 10 * 6e4;
-var CLASSIFYING_TTL_MS = 15e3;
-var RELEASED_CLASSIFY_ERRORS = /* @__PURE__ */ new Set([
-  "classify_invalid_result",
-  "classify_low_confidence",
-  "classify_not_project",
-  "classify_result_expired"
-]);
-function toCanonicalTelegramBootstrapConversationId(conversationId) {
-  const trimmed = conversationId.trim();
-  if (!trimmed) return trimmed;
-  return trimmed.startsWith("telegram:") ? trimmed : `telegram:${trimmed}`;
-}
-function sessionsDir(workspaceDir) {
-  return path36.join(workspaceDir, DATA_DIR, "bootstrap-sessions");
-}
-function sessionPath(workspaceDir, conversationId) {
-  return path36.join(
-    sessionsDir(workspaceDir),
-    `${toCanonicalTelegramBootstrapConversationId(conversationId)}.json`
-  );
-}
-function alternateSessionPath(workspaceDir, conversationId) {
-  const canonical = toCanonicalTelegramBootstrapConversationId(conversationId);
-  const bare = canonical.startsWith("telegram:") ? canonical.slice("telegram:".length) : canonical;
-  if (!bare || bare === canonical) return null;
-  return path36.join(sessionsDir(workspaceDir), `${bare}.json`);
-}
-function normalizeStoredSession(session) {
-  const canonicalConversationId = toCanonicalTelegramBootstrapConversationId(session.conversationId);
-  if (canonicalConversationId === session.conversationId) {
-    return session;
-  }
-  return {
-    ...session,
-    id: buildBootstrapSessionId(canonicalConversationId, session.rawIdea),
-    conversationId: canonicalConversationId
-  };
-}
-function stableHash(input) {
-  return createHash5("sha256").update(input).digest("hex").slice(0, 16);
-}
-function buildBootstrapSessionId(conversationId, rawIdea) {
-  return `tgdm-${conversationId}-${stableHash(rawIdea.trim().toLowerCase())}`;
-}
-function buildBootstrapRequestFingerprint(input) {
-  return stableHash(JSON.stringify({
-    rawIdea: input.rawIdea.trim().toLowerCase(),
-    projectName: input.projectName?.trim().toLowerCase() || null,
-    stackHint: input.stackHint?.trim().toLowerCase() || null,
-    repoUrl: input.repoUrl?.trim().toLowerCase() || null,
-    repoPath: input.repoPath?.trim().toLowerCase() || null
-  }));
-}
-function buildBootstrapRequestHash(input) {
-  return buildBootstrapRequestFingerprint(input);
-}
-function nextSuppressUntil(status) {
-  const ttl = status === "classifying" || status === "pending_classify" ? CLASSIFYING_TTL_MS : SESSION_TTL_MS;
-  return new Date(Date.now() + ttl).toISOString();
-}
-function isReleasedClassifyFailure(error48) {
-  return Boolean(error48 && RELEASED_CLASSIFY_ERRORS.has(error48));
-}
-function resolveNullableField(inputValue, existingValue, fallback = null) {
-  return inputValue !== void 0 ? inputValue : existingValue ?? fallback;
-}
-function defaultNextRetryAtForStatus(status, existingValue) {
-  if (status === "bootstrapping" || status === "dispatching") {
-    return existingValue ?? null;
-  }
-  return null;
-}
-var MONOTONIC_BOOTSTRAP_FIELDS = [
-  "ackSentAt",
-  "projectRegisteredAt",
-  "topicKickoffSentAt",
-  "projectTickedAt",
-  "completionAckSentAt"
-];
-function shouldPersistBootstrapCheckpoint(current, next) {
-  if (!current) return { ok: true };
-  if (current.conversationId !== next.conversationId) return { ok: true };
-  const currentAttemptSeq = current.attemptSeq ?? null;
-  const nextAttemptSeq = next.attemptSeq ?? null;
-  if (currentAttemptSeq != null && nextAttemptSeq != null && nextAttemptSeq < currentAttemptSeq) {
-    return { ok: false, reason: "stale_regression" };
-  }
-  const sameAttempt = Boolean(
-    current.attemptId && next.attemptId && current.attemptSeq != null && next.attemptSeq != null && current.attemptId === next.attemptId && current.attemptSeq === next.attemptSeq
-  );
-  if (!sameAttempt) return { ok: true };
-  for (const field of MONOTONIC_BOOTSTRAP_FIELDS) {
-    if (current[field] && !next[field]) {
-      return { ok: false, reason: "stale_regression" };
+          project: project.name,
+          projectSlug,
+          issueId: issue2.iid,
+          issueTitle: issue2.title,
+          issueUrl: issue2.web_url,
+          role,
+          level: effectiveLevel,
+          sessionAction: existingSession ? "send" : "spawn",
+          announcement: `[DRY RUN] Would pick up #${issue2.iid}`
+        });
+        pickupCount++;
+        continue;
+      }
+      const environment = await ensureEnvironment({
+        workspaceDir,
+        projectSlug,
+        project: fresh,
+        stack,
+        mode: role === "tester" ? "tester" : "developer",
+        runCommand
+      });
+      if (!environment.ready) {
+        const environmentSkipReason = classifyEnvironmentGateSkip(environment.state);
+        skipped.push({ role, reason: environmentSkipReason });
+        await log(workspaceDir, "dispatch_blocked_environment_not_ready", {
+          projectSlug,
+          role,
+          issueId: issue2.iid,
+          reason: environmentSkipReason,
+          environmentStatus: environment.state.status,
+          nextProvisionRetryAt: environment.state.nextProvisionRetryAt ?? null,
+          lastProvisionError: environment.state.lastProvisionError ?? null
+        }).catch(() => {
+        });
+        continue;
+      }
     }
-  }
-  return { ok: true };
-}
-async function readTelegramBootstrapSession(workspaceDir, conversationId) {
-  const canonicalConversationId = toCanonicalTelegramBootstrapConversationId(conversationId);
-  const paths = [
-    sessionPath(workspaceDir, canonicalConversationId),
-    alternateSessionPath(workspaceDir, conversationId)
-  ].filter((entry) => Boolean(entry));
-  try {
-    for (const candidatePath of paths) {
+    if (dryRun) {
+      const existingSession = roleWorker.levels[effectiveLevel]?.[freeSlot]?.sessionKey;
+      pickups.push({
+        project: project.name,
+        projectSlug,
+        issueId: issue2.iid,
+        issueTitle: issue2.title,
+        issueUrl: issue2.web_url,
+        role,
+        level: effectiveLevel,
+        sessionAction: existingSession ? "send" : "spawn",
+        announcement: `[DRY RUN] Would pick up #${issue2.iid}`
+      });
+    } else {
       try {
-        const raw = await fs35.readFile(candidatePath, "utf-8");
-        const session = normalizeStoredSession(JSON.parse(raw));
-        if (session.status === "failed" && isReleasedClassifyFailure(session.error)) {
-          await deleteTelegramBootstrapSession(workspaceDir, canonicalConversationId);
-          return null;
-        }
-        return session;
-      } catch (error48) {
-        if (error48?.code === "ENOENT") continue;
-        throw error48;
+        const dr = await dispatch({
+          workspaceDir,
+          agentId,
+          project: fresh,
+          issueId: issue2.iid,
+          issueTitle: issue2.title,
+          issueDescription: issue2.description ?? "",
+          issueUrl: issue2.web_url,
+          role,
+          level: effectiveLevel,
+          fromLabel: currentLabel,
+          toLabel: targetLabel,
+          provider,
+          pluginConfig,
+          sessionKey,
+          runtime,
+          slotIndex: freeSlot,
+          instanceName,
+          runCommand
+        });
+        pickups.push({
+          project: project.name,
+          projectSlug,
+          issueId: issue2.iid,
+          issueTitle: issue2.title,
+          issueUrl: issue2.web_url,
+          role,
+          level: dr.level,
+          sessionAction: dr.sessionAction,
+          announcement: dr.announcement
+        });
+        await recordDispatch(workspaceDir, dispatchId).catch(() => {
+        });
+      } catch (err) {
+        skipped.push({ role, reason: `Dispatch failed: ${err.message}` });
+        continue;
       }
     }
-    return null;
-  } catch (error48) {
-    if (error48?.code === "ENOENT") return null;
-    throw error48;
-  }
-}
-async function deleteTelegramBootstrapSession(workspaceDir, conversationId) {
-  await fs35.unlink(sessionPath(workspaceDir, conversationId)).catch(() => {
-  });
-  const legacyPath = alternateSessionPath(workspaceDir, conversationId);
-  if (legacyPath) {
-    await fs35.unlink(legacyPath).catch(() => {
-    });
-  }
-}
-async function writeTelegramBootstrapSession(workspaceDir, session) {
-  const canonicalSession = normalizeStoredSession(session);
-  const dir = sessionsDir(workspaceDir);
-  await fs35.mkdir(dir, { recursive: true });
-  const file2 = sessionPath(workspaceDir, canonicalSession.conversationId);
-  const tmp = `${file2}.${randomUUID4()}.tmp`;
-  await fs35.writeFile(tmp, JSON.stringify(canonicalSession, null, 2) + "\n", "utf-8");
-  await fs35.rename(tmp, file2);
-  const legacyPath = alternateSessionPath(workspaceDir, session.conversationId);
-  if (legacyPath) {
-    await fs35.unlink(legacyPath).catch(() => {
-    });
-  }
-}
-async function upsertTelegramBootstrapSession(workspaceDir, input) {
-  const conversationId = toCanonicalTelegramBootstrapConversationId(input.conversationId);
-  const existing = await readTelegramBootstrapSession(workspaceDir, conversationId);
-  const resolvedSourceRoute = resolveNullableField(input.sourceRoute, existing?.sourceRoute);
-  const resolvedProjectRoute = resolveNullableField(input.projectRoute, existing?.projectRoute);
-  const resolvedProjectName = resolveNullableField(input.projectName, existing?.projectName);
-  const resolvedStackHint = resolveNullableField(input.stackHint, existing?.stackHint);
-  const resolvedRepoUrl = resolveNullableField(input.repoUrl, existing?.repoUrl);
-  const resolvedRepoPath = resolveNullableField(input.repoPath, existing?.repoPath);
-  const resolvedProjectSlug = resolveNullableField(input.projectSlug, existing?.projectSlug);
-  const resolvedIssueId = resolveNullableField(input.issueId, existing?.issueId);
-  const resolvedMessageThreadId = resolveNullableField(input.messageThreadId, existing?.messageThreadId);
-  const resolvedProjectChannelId = resolveNullableField(input.projectChannelId, existing?.projectChannelId);
-  const resolvedAttemptCount = resolveNullableField(input.attemptCount, existing?.attemptCount, 0);
-  const resolvedAttemptId = resolveNullableField(input.attemptId, existing?.attemptId);
-  const resolvedAttemptSeq = resolveNullableField(input.attemptSeq, existing?.attemptSeq);
-  const resolvedClassifySessionKey = resolveNullableField(input.classifySessionKey, existing?.classifySessionKey);
-  const resolvedClassifyRunId = resolveNullableField(input.classifyRunId, existing?.classifyRunId);
-  const resolvedClassifyStartedAt = resolveNullableField(input.classifyStartedAt, existing?.classifyStartedAt);
-  const resolvedBootstrapStep = resolveNullableField(input.bootstrapStep, existing?.bootstrapStep);
-  const resolvedNextRetryAt = input.nextRetryAt !== void 0 ? input.nextRetryAt : defaultNextRetryAtForStatus(input.status, existing?.nextRetryAt);
-  const resolvedAckSentAt = resolveNullableField(input.ackSentAt, existing?.ackSentAt);
-  const resolvedProjectRegisteredAt = resolveNullableField(input.projectRegisteredAt, existing?.projectRegisteredAt);
-  const resolvedTopicKickoffSentAt = resolveNullableField(input.topicKickoffSentAt, existing?.topicKickoffSentAt);
-  const resolvedProjectTickedAt = resolveNullableField(input.projectTickedAt, existing?.projectTickedAt);
-  const resolvedCompletionAckSentAt = resolveNullableField(input.completionAckSentAt, existing?.completionAckSentAt);
-  const resolvedError = input.error !== void 0 ? input.error : input.lastError !== void 0 ? input.lastError : existing?.error ?? existing?.lastError ?? null;
-  const requestHash = buildBootstrapRequestHash({
-    rawIdea: input.rawIdea,
-    projectName: resolvedProjectName,
-    stackHint: resolvedStackHint,
-    repoUrl: resolvedRepoUrl,
-    repoPath: resolvedRepoPath
-  });
-  const now2 = (/* @__PURE__ */ new Date()).toISOString();
-  const session = {
-    id: existing?.id ?? buildBootstrapSessionId(conversationId, input.rawIdea),
-    conversationId,
-    sourceChannel: input.sourceChannel ?? input.sourceRoute?.channel ?? existing?.sourceChannel ?? "telegram",
-    sourceRoute: resolvedSourceRoute,
-    projectRoute: resolvedProjectRoute,
-    requestHash,
-    requestFingerprint: requestHash,
-    lastCompletedRequestHash: input.status === "completed" ? requestHash : existing?.lastCompletedRequestHash ?? null,
-    rawIdea: input.rawIdea,
-    projectName: resolvedProjectName,
-    stackHint: resolvedStackHint,
-    repoUrl: resolvedRepoUrl,
-    repoPath: resolvedRepoPath,
-    projectSlug: resolvedProjectSlug,
-    issueId: resolvedIssueId,
-    messageThreadId: resolvedMessageThreadId,
-    projectChannelId: resolvedProjectChannelId,
-    language: input.language ?? existing?.language,
-    status: input.status,
-    attemptId: resolvedAttemptId,
-    attemptSeq: resolvedAttemptSeq,
-    classifySessionKey: resolvedClassifySessionKey,
-    classifyRunId: resolvedClassifyRunId,
-    classifyStartedAt: resolvedClassifyStartedAt,
-    bootstrapStep: resolvedBootstrapStep,
-    attemptCount: resolvedAttemptCount,
-    lastError: resolvedError,
-    nextRetryAt: resolvedNextRetryAt,
-    ackSentAt: resolvedAckSentAt,
-    projectRegisteredAt: resolvedProjectRegisteredAt,
-    topicKickoffSentAt: resolvedTopicKickoffSentAt,
-    projectTickedAt: resolvedProjectTickedAt,
-    completionAckSentAt: resolvedCompletionAckSentAt,
-    pendingClarification: input.pendingClarification !== void 0 ? input.pendingClarification : existing?.pendingClarification ?? null,
-    orphanedArtifacts: input.orphanedArtifacts !== void 0 ? input.orphanedArtifacts : existing?.orphanedArtifacts ?? null,
-    createdAt: existing?.createdAt ?? now2,
-    updatedAt: now2,
-    suppressUntil: nextSuppressUntil(input.status),
-    error: resolvedError
-  };
-  const writeDecision = shouldPersistBootstrapCheckpoint(existing, session);
-  if (!writeDecision.ok && existing) {
-    return existing;
+    pickupCount++;
   }
-  await writeTelegramBootstrapSession(workspaceDir, session);
-  return session;
+  return { pickups, skipped };
 }
-function shouldSuppressTelegramBootstrapReply(session, request) {
-  if (!session) return false;
-  if (isTelegramBootstrapSessionExpired(session)) return false;
-  if (session.status === "completed" || session.status === "failed") {
-    if (session.status === "failed" && isReleasedClassifyFailure(session.error)) return false;
-    if (!request) return false;
-    return buildBootstrapRequestFingerprint(request) === session.requestHash;
+function resolveLevelForIssue(issue2, role) {
+  const roleLevel = detectRoleLevelFromLabels(issue2.labels);
+  if (roleLevel?.role === role) return roleLevel.level;
+  if (roleLevel) {
+    const levels = getLevelsForRole(role);
+    if (levels.includes(roleLevel.level)) return roleLevel.level;
   }
-  if (!request) return true;
-  return buildBootstrapRequestFingerprint(request) === session.requestHash;
-}
-function isTelegramBootstrapSessionExpired(session, now2 = Date.now()) {
-  if (!session) return false;
-  const suppressUntil = Date.parse(session.suppressUntil);
-  return !Number.isNaN(suppressUntil) && suppressUntil < now2;
-}
-function isRecoverableTelegramBootstrapSession(session) {
-  return session?.status === "bootstrapping" || session?.status === "dispatching";
-}
-function isClaimableTelegramBootstrapSession(session, now2 = Date.now()) {
-  if (!isRecoverableTelegramBootstrapSession(session)) return false;
-  if (!session.nextRetryAt) return true;
-  const retryAt = Date.parse(session.nextRetryAt);
-  return Number.isNaN(retryAt) || retryAt <= now2;
+  return selectLevel(issue2.title, issue2.description ?? "", role).level;
 }
-function isSupersededTelegramBootstrapAttempt(current, candidate) {
-  if (!current || !candidate) return false;
-  if (current.conversationId !== candidate.conversationId) return true;
-  const currentHasAttempt = current.attemptId != null && current.attemptSeq != null;
-  const candidateHasAttempt = candidate.attemptId != null && candidate.attemptSeq != null;
-  if (currentHasAttempt || candidateHasAttempt) {
-    return current.attemptId !== candidate.attemptId || current.attemptSeq !== candidate.attemptSeq;
-  }
-  return current.requestHash !== candidate.requestHash || current.status !== candidate.status || current.updatedAt !== candidate.updatedAt;
+function getFeedbackQueueLabel(workflow) {
+  const developerQueues = getQueueLabels(workflow, "developer");
+  return developerQueues.find((label) => isFeedbackState(workflow, label)) ?? null;
 }
 
 // lib/dispatch/telegram-bootstrap-hook.ts
+init_audit();
+init_zod();
 init_constants();
 var BOOTSTRAP_RETRY_DELAY_MS = 15e3;
 var LAYER3_CONFIDENCE_THRESHOLD = 0.6;
@@ -143089,6 +143157,8 @@ Erro: ${result.error ?? "erro desconhecido"}`
   const projectChannelId = result.payload.metadata.channel_id ?? telegramConfig.projectsForumChatId;
   const messageThreadId = result.payload.metadata.message_thread_id;
   const projectSlug = result.payload.metadata.project_slug ?? result.payload.scaffold?.project_slug ?? null;
+  const createdIssue = result.payload.issues?.[0] ?? null;
+  const triage = result.payload.triage ?? null;
   if (projectChannelId && messageThreadId) {
     const projectRoute = {
       channel: "telegram",
@@ -143103,6 +143173,10 @@ Erro: ${result.error ?? "erro desconhecido"}`
       bootstrapStep: "project_registered",
       projectName: resolvedProjectName,
       projectSlug: projectSlug ?? void 0,
+      issueId: createdIssue?.number ?? null,
+      issueUrl: createdIssue?.url ?? null,
+      triageReadyForDispatch: triage?.ready_for_dispatch ?? null,
+      triageErrors: triage?.errors ?? null,
       projectRegisteredAt: (/* @__PURE__ */ new Date()).toISOString(),
       projectChannelId: String(projectChannelId),
       messageThreadId,
@@ -143118,6 +143192,10 @@ Erro: ${result.error ?? "erro desconhecido"}`
       status: "dispatching",
       projectName: resolvedProjectName,
       projectSlug: projectSlug ?? void 0,
+      issueId: createdIssue?.number ?? null,
+      issueUrl: createdIssue?.url ?? null,
+      triageReadyForDispatch: triage?.ready_for_dispatch ?? null,
+      triageErrors: triage?.errors ?? null,
       projectRegisteredAt: (/* @__PURE__ */ new Date()).toISOString(),
       projectChannelId: String(projectChannelId),
       messageThreadId,
@@ -143133,6 +143211,10 @@ Erro: ${result.error ?? "erro desconhecido"}`
       ...registeredSession,
       projectName: resolvedProjectName,
       projectSlug: projectSlug ?? registeredSession.projectSlug ?? void 0,
+      issueId: createdIssue?.number ?? registeredSession.issueId ?? null,
+      issueUrl: createdIssue?.url ?? registeredSession.issueUrl ?? null,
+      triageReadyForDispatch: triage?.ready_for_dispatch ?? registeredSession.triageReadyForDispatch ?? null,
+      triageErrors: triage?.errors ?? registeredSession.triageErrors ?? null,
       projectRegisteredAt: registeredSession.projectRegisteredAt ?? (/* @__PURE__ */ new Date()).toISOString(),
       language: currentSession?.language ?? "pt"
     });

package/package.json

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