@mestreyoda/fabrica 0.2.43 → 0.2.45

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 22+ 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**:
 
@@ -150,6 +168,13 @@ If `projectsForumChatId` is missing while DM bootstrap is enabled, Fabrica can a
 
 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
@@ -339,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.43") {
-    return "0.2.43";
+  if ("0.2.45") {
+    return "0.2.45";
   }
   try {
     const pkgPath = path5.join(THIS_DIR, "..", "..", "package.json");
@@ -134190,21 +134190,22 @@ async function migrateChannelBinding(api, channel, fromAgentId, toAgentId) {
 init_logger();
 import fs26 from "node:fs/promises";
 import path25 from "node:path";
-async function createAgent(api, name, runCommand, channelBinding) {
+async function createAgent(api, name, runCommand, channelBinding, workspacePath) {
   const rc = runCommand;
   const agentId = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
   const args = ["agents", "add", agentId, "--non-interactive"];
   if (channelBinding) args.push("--bind", channelBinding);
+  if (workspacePath) args.push("--workspace", workspacePath);
   try {
     await rc(["openclaw", ...args], { timeoutMs: 3e4 });
   } catch (err) {
     throw new Error(`Failed to create agent "${name}": ${err.message}`);
   }
   const runtime = "runtime" in api ? api.runtime : api;
-  const workspacePath = resolveWorkspacePath(runtime, agentId);
-  await cleanupWorkspace(workspacePath);
+  const resolvedWorkspacePath = workspacePath ?? resolveWorkspacePath(runtime, agentId);
+  await cleanupWorkspace(resolvedWorkspacePath);
   await updateAgentDisplayName(runtime, agentId, name);
-  return { agentId, workspacePath };
+  return { agentId, workspacePath: resolvedWorkspacePath };
 }
 function resolveWorkspacePath(api, agentId) {
   const runtime = "runtime" in api ? api.runtime : api;
@@ -147377,7 +147378,13 @@ async function runSetup(opts) {
 async function resolveOrCreateAgent(opts, warnings) {
   if (opts.newAgentName) {
     if (!opts.runCommand) throw new Error("runCommand is required when creating a new agent");
-    const { agentId, workspacePath } = await createAgent(opts.runtime, opts.newAgentName, opts.runCommand, opts.channelBinding);
+    const { agentId, workspacePath } = await createAgent(
+      opts.runtime,
+      opts.newAgentName,
+      opts.runCommand,
+      opts.channelBinding,
+      opts.workspacePath
+    );
     const bindingMigrated = await tryMigrateBinding(opts, agentId, warnings);
     return { agentId, workspacePath, agentCreated: true, bindingMigrated };
   }
@@ -147416,6 +147423,11 @@ function buildModelConfig(overrides) {
   }
   return result;
 }
+function ensureYamlMapNode(doc, value) {
+  if (value instanceof import_yaml3.default.YAMLMap) return value;
+  const seeded = value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  return doc.createNode(seeded);
+}
 function getDefaultWorkspacePath(runtime) {
   try {
     const config2 = runtime.config.loadConfig();
@@ -147433,16 +147445,15 @@ async function writeModelsToWorkflow(workspacePath, models) {
   }
   const doc = content ? import_yaml3.default.parseDocument(content) : new import_yaml3.default.Document({});
   if (!doc.has("roles")) {
-    doc.set("roles", {});
+    doc.set("roles", doc.createNode({}));
   }
-  const roles = doc.getIn(["roles"], true);
+  const roles = ensureYamlMapNode(doc, doc.getIn(["roles"], true));
+  doc.set("roles", roles);
   for (const [role, levels] of Object.entries(models)) {
-    if (!roles.has(role)) {
-      roles.set(role, doc.createNode({ models: levels }));
-    } else {
-      const roleNode = roles.get(role, true);
-      roleNode.set("models", doc.createNode(levels));
-    }
+    const existingRoleNode = roles.get(role, true);
+    const roleNode = ensureYamlMapNode(doc, existingRoleNode);
+    roleNode.set("models", doc.createNode(levels));
+    roles.set(role, roleNode);
   }
   await fs39.writeFile(workflowPath, doc.toString({ lineWidth: 120 }), "utf-8");
 }

package/package.json

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