@mestreyoda/fabrica 0.2.42 → 0.2.44

package/README.md

@@ -53,14 +53,31 @@ The heartbeat ticks every 60 seconds. On each tick, Fabrica alternates between a
 
 ## Requirements
 
-- [OpenClaw](https://openclaw.dev) runtime >= 2026.3.13 (gateway running on port 18789)
+- [OpenClaw](https://openclaw.dev) runtime >= 2026.3.13
+- OpenClaw gateway operational on the local machine (default port 18789)
 - Git (for repository operations and local development)
-- Node.js 20+ (for local development or programmatic genesis)
-- `gh` CLI authenticated to GitHub (required for issue and PR operations)
+- Node.js 20+ with npm/npx available
+- `gh` CLI authenticated to GitHub (required for repo, issue, PR, and comment operations)
 - A GitHub organization or personal account where repositories will be created
 - For Python stacks, Fabrica provisions `uv` and project-local environments itself without `sudo`
 - (Optional) Telegram bot token and group chat IDs for DM bootstrap and notifications
 
+### Host prerequisites vs project provisioning
+
+Fabrica provisions a lot inside each project runtime, but it is not a universal host bootstrapper.
+
+What should already exist on the machine:
+- OpenClaw installed and working
+- Node/npm usable
+- Git usable
+- `gh auth` completed with permissions to create repositories, issues, PRs, and comments
+
+What Fabrica provisions at project/runtime level:
+- Python `uv` bootstrapping when needed
+- project-local `.venv` for Python stacks
+- project scaffolding and QA contract files
+- stack-specific environment preparation before developer/tester pickup
+
 ## Installation
 
 ### Via npm (recommended)
@@ -106,6 +123,7 @@ gh auth status || gh auth login
 ```
 
 Fabrica uses authenticated `gh` CLI for GitHub operations in the default setup.
+Make sure the authenticated identity can create repositories, issues, PRs, and comments in the target account or organization.
 
 **2. Install Fabrica**:
 
@@ -148,6 +166,15 @@ 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.
+
+Example:
+
+```bash
+export FABRICA_PROJECTS_CHANNEL_ID="<YOUR_PROJECTS_FORUM_CHAT_ID>"
+openclaw fabrica setup --workspace /path/to/workspace --new-agent fabrica
+```
+
 **6. Validate operational readiness**:
 
 ```bash
@@ -337,6 +364,17 @@ worker start, worker completion, review queueing, reviewer reject/approve, and
 operational recovery events, with cycle-aware dedupe so late deliveries from an
 older dispatch do not masquerade as current work.
 
+## Minimal path without Telegram
+
+Telegram is the recommended human-facing flow, but it is not required to use Fabrica.
+
+If you want a minimal path without Telegram:
+1. authenticate `gh`
+2. install the plugin
+3. run `openclaw fabrica doctor workspace --workspace /path/to/workspace`
+4. run `openclaw fabrica setup --workspace /path/to/workspace --new-agent fabrica`
+5. use the programmatic genesis path below to trigger the pipeline
+
 ## Programmatic genesis
 
 In addition to Telegram DM bootstrap, the full pipeline can be triggered from a CLI script — no Telegram or running agent session required:

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.42") {
-    return "0.2.42";
+  if ("0.2.44") {
+    return "0.2.44";
   }
   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.42",
+  "version": "0.2.44",
   "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",