@mestreyoda/fabrica 0.2.41 → 0.2.43

package/README.md

@@ -148,6 +148,8 @@ At minimum, when DM bootstrap is enabled, set:
 
 If `projectsForumChatId` is missing while DM bootstrap is enabled, Fabrica can accept the DM but will fail when it needs to create the project topic.
 
+Tip: if you export `FABRICA_PROJECTS_CHANNEL_ID` before running `openclaw fabrica setup`, Fabrica now copies that value into `plugins.entries.fabrica.config.telegram.projectsForumChatId` automatically during setup.
+
 **6. Validate operational readiness**:
 
 ```bash
@@ -203,6 +205,27 @@ tail -f ~/.openclaw/workspace/logs/genesis.log
 openclaw fabrica metrics
 ```
 
+This command now includes convergence-oriented telemetry such as:
+- cause counts (for example `qa_missing_required_gates`, `qa_sanitization_failed`)
+- human escalations
+- average dispatch → first PR timing
+- per-stack breakdowns
+
+**11. Inspect a live issue/run**:
+
+```bash
+openclaw fabrica doctor issue --project <slug> --issue <id>
+```
+
+Use this when a project is looping or stuck. It shows:
+- current PR / artifact state
+- progress state
+- convergence cause + QA subcause
+- missing QA gates, when applicable
+- recommended next action
+
+For deferred, non-blocking ideas after this milestone, see `FUTURE_IMPROVEMENTS.md`.
+
 ## Configuration
 
 ### Minimal (gh CLI only)

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.41") {
-    return "0.2.41";
+  if ("0.2.43") {
+    return "0.2.43";
   }
   try {
     const pkgPath = path5.join(THIS_DIR, "..", "..", "package.json");
@@ -147275,6 +147275,7 @@ async function writePluginConfig(runtime, agentId, projectExecution) {
   ensurePluginAllowed(config2);
   ensureInternalHooks(config2);
   ensureHeartbeatDefaults(config2);
+  ensureTelegramDefaults(config2);
   configureSubagentCleanup(config2);
   ensureTelegramLinkPreviewDisabled(config2);
   if (agentId) {
@@ -147326,6 +147327,23 @@ function ensureHeartbeatDefaults(config2) {
     fabrica.work_heartbeat = { ...HEARTBEAT_DEFAULTS };
   }
 }
+function ensureTelegramDefaults(config2) {
+  const fabrica = config2.plugins.entries.fabrica.config;
+  if (!fabrica.telegram) fabrica.telegram = {};
+  const telegram = fabrica.telegram;
+  if (telegram.bootstrapDmEnabled === void 0) {
+    telegram.bootstrapDmEnabled = true;
+  }
+  if (telegram.projectsForumChatId === void 0 && process.env.FABRICA_PROJECTS_CHANNEL_ID) {
+    telegram.projectsForumChatId = process.env.FABRICA_PROJECTS_CHANNEL_ID;
+  }
+  if (telegram.projectsForumAccountId === void 0 && process.env.FABRICA_PROJECTS_CHANNEL_ACCOUNT_ID) {
+    telegram.projectsForumAccountId = process.env.FABRICA_PROJECTS_CHANNEL_ACCOUNT_ID;
+  }
+  if (telegram.opsChatId === void 0 && process.env.TELEGRAM_CHAT_ID) {
+    telegram.opsChatId = process.env.TELEGRAM_CHAT_ID;
+  }
+}
 function ensureTelegramLinkPreviewDisabled(config2) {
   const channels = config2.channels;
   if (!channels) return;
@@ -150062,7 +150080,8 @@ function registerCli(program, ctx) {
     } else {
       console.log("  1. Run `openclaw fabrica doctor workspace --workspace <path>` to confirm workspace readiness");
       console.log("  2. If you want the official Telegram DM \u2192 topic flow, set plugins.entries.fabrica.config.telegram.projectsForumChatId");
-      console.log("  3. Re-run `openclaw fabrica setup` after the Telegram forum config is in place");
+      console.log("  3. You can also export FABRICA_PROJECTS_CHANNEL_ID before running setup to prefill that value automatically");
+      console.log("  4. Re-run `openclaw fabrica setup` after the Telegram forum config is in place");
     }
   });
   const doctor = fabrica.command("doctor").description("Diagnose workspace integrity and optionally auto-fix issues");

package/package.json

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