@pleri/olam-cli 0.1.82 → 0.1.84

package/dist/image-digests.json

@@ -4,6 +4,6 @@
   "host-cp": "sha256:ab8540c92b84b0fff082d9221b0792f0ccdfe7053143be261122b148501b0fc6",
   "mcp-auth": "sha256:e47169ad3fbc9cab216248fecbc56874343a5daab84b1f18d67529b7d415cf95",
   "$schema_version": 1,
-  "$published_version": "0.1.82",
+  "$published_version": "0.1.84",
   "$registry": "ghcr.io/pleri"
 }

package/dist/index.js

@@ -8268,6 +8268,7 @@ var init_baseline_diff = __esm({
 // ../core/dist/world/context-injection.js
 import * as fs15 from "node:fs";
 import * as path16 from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 function injectWorldContext(opts) {
   const { world, task, linearTicketId, claudeMdExtra, taskContext, services, pleriPlaneUrl } = opts;
   const claudeDir = path16.join(world.workspacePath, ".claude");
@@ -8342,82 +8343,22 @@ function injectWorldContext(opts) {
   sections.push("4. When done, push and the work will be available for review");
   sections.push("5. Your `AskUserQuestion` calls are intercepted and surfaced to the operator's host CP automatically. The operator answers in the SPA; claude resumes when keys are injected.");
   sections.push("");
-  sections.push("## Lane Orchestration");
-  sections.push("");
-  sections.push("You can create parallel work lanes via the container API at http://localhost:8080.");
-  sections.push("Lanes run independent Claude Code sessions in isolated git worktrees.");
-  sections.push("");
-  sections.push("### When to create lanes");
-  sections.push("- Task has 2+ independent scopes (different directories/modules)");
-  sections.push("- Work can be done simultaneously without file conflicts");
-  sections.push("- Estimated effort > ~30 tool calls per scope");
-  sections.push("");
-  sections.push("### When NOT to create lanes");
-  sections.push("- Simple tasks touching few files");
-  sections.push("- Sequential work where each step depends on the previous");
-  sections.push("- Everything is in one directory");
-  sections.push("");
-  sections.push("### Lane API (use curl from this session)");
-  sections.push("");
-  sections.push(`Create: \`curl -s -X POST -H 'Content-Type: application/json' -d '{"name":"auth-fix","task":"Fix auth bugs","scope":["src/auth/**"],"avoids":["tests/**"]}' http://localhost:8080/lanes/create\``);
-  sections.push("");
-  sections.push("List: `curl -s http://localhost:8080/lanes`");
-  sections.push("");
-  sections.push(`Dispatch to lane: \`curl -s -X POST -H 'Content-Type: application/json' -d '{"prompt":"Start by reviewing..."}' http://localhost:8080/lanes/auth-fix/dispatch\``);
-  sections.push("");
-  sections.push("Check status: `curl -s http://localhost:8080/lanes/auth-fix`");
+  sections.push("## Lane Orchestration (advanced \u2014 read on demand)");
   sections.push("");
-  sections.push("Merge: `curl -s -X POST http://localhost:8080/lanes/auth-fix/merge`");
+  sections.push("This world supports parallel work lanes via the container API at http://localhost:8080.");
+  sections.push("Use only when the task has 2+ independent scopes that can run simultaneously.");
   sections.push("");
-  sections.push("Destroy: `curl -s -X DELETE http://localhost:8080/lanes/auth-fix`");
+  sections.push("**Full lane API + workflow**: see `~/.olam/docs/lane-orchestration.md` (mounted into the world).");
   sections.push("");
-  sections.push("### Orchestration workflow");
-  sections.push("1. Analyze the task \u2014 identify independent work streams");
-  sections.push("2. Create lanes with non-overlapping scope globs");
-  sections.push("3. Dispatch initial prompts to each lane");
-  sections.push("4. **Monitor progress** \u2014 poll lane status every 30 seconds:");
-  sections.push("   ```bash");
-  sections.push(`   while true; do STATUS=$(curl -s http://localhost:8080/lanes); RUNNING=$(echo "$STATUS" | jq '[.lanes[] | select(.status == "running")] | length'); echo "Running lanes: $RUNNING"; if [ "$RUNNING" = "0" ]; then echo "All lanes complete!"; break; fi; sleep 30; done`);
-  sections.push("   ```");
-  sections.push('5. **When a lane completes** (status is "completed" or no longer "running"):');
-  sections.push("   - Check its output: `curl -s http://localhost:8080/lanes/<name>`");
-  sections.push("   - If satisfactory, merge it: `curl -s -X POST http://localhost:8080/lanes/<name>/merge`");
-  sections.push("   - The merge automatically triggers a Codex adversarial review");
-  sections.push("6. **After ALL lanes are merged**:");
-  sections.push("   - Run tests to verify the merged result: `npm test` or equivalent");
-  sections.push("   - Review the combined changes: `git diff main...HEAD --stat`");
-  sections.push('   - Create a PR: `gh pr create --title "..." --body "..."`');
-  sections.push("7. Clean up lanes: `curl -s -X DELETE http://localhost:8080/lanes/<name>`");
+  sections.push("## Creating PRs from inside this world");
   sections.push("");
-  sections.push("### Important: Do not just report completion \u2014 ACT on it");
-  sections.push("When all lanes are done, immediately start merging and creating the PR.");
-  sections.push("Do not wait for the user to tell you to merge. The workflow is:");
-  sections.push("lanes complete -> merge each -> run tests -> create PR -> report to user.");
-  sections.push("");
-  sections.push("### CRITICAL: `gh pr create` from inside an Olam world");
-  sections.push("");
-  sections.push("Calling `gh pr create` directly inside this container will HANG");
-  sections.push("FOREVER on a TTY confirmation prompt that you can't answer.");
-  sections.push("This is a known and reproduced issue.");
-  sections.push("");
-  sections.push("You MUST always invoke it through this exact pattern:");
+  sections.push("`gh pr create` hangs on a TTY prompt inside the container. Always use:");
   sections.push("");
   sections.push("```bash");
-  sections.push("echo y | timeout 30 gh pr create \\");
-  sections.push("  --base main \\");
-  sections.push("  --head <branch> \\");
-  sections.push('  --title "<title>" \\');
-  sections.push("  --body-file /tmp/pr-body.md");
+  sections.push('echo y | timeout 30 gh pr create --base main --head <branch> --title "..." --body-file /tmp/pr-body.md');
   sections.push("```");
   sections.push("");
-  sections.push("- `echo y |` answers the Submit confirmation up front.");
-  sections.push("- `timeout 30` is a hard deadline \u2014 if gh hangs anyway, the command");
-  sections.push("  exits non-zero and you can react instead of stalling the world.");
-  sections.push("- `--body-file` (not `--body`) avoids shell-escaping bugs in long bodies.");
-  sections.push("- Always pass `--head` and `--base` explicitly so gh has nothing to ask.");
-  sections.push("");
-  sections.push('If the command exits non-zero with an error like "no commits" or');
-  sections.push('"branch not found", `git push -u origin <branch>` first, then retry.');
+  sections.push("**Why + full troubleshooting**: see `~/.olam/docs/gh-pr-create.md`.");
   sections.push("");
   sections.push("## Available Skills & Plugins");
   sections.push("");
@@ -8433,6 +8374,16 @@ function injectWorldContext(opts) {
   }
   const content = sections.join("\n");
   fs15.writeFileSync(path16.join(claudeDir, "CLAUDE.md"), content);
+  writeOlamDocs(world.workspacePath);
+}
+function writeOlamDocs(workspacePath) {
+  const docsDir = path16.join(workspacePath, ".olam", "docs");
+  fs15.mkdirSync(docsDir, { recursive: true });
+  for (const filename of ["lane-orchestration.md", "gh-pr-create.md"]) {
+    const src = path16.join(TEMPLATES_DIR, filename);
+    const dest = path16.join(docsDir, filename);
+    fs15.copyFileSync(src, dest);
+  }
 }
 function formatTaskSource(ctx) {
   if (ctx.source === "linear" && ctx.ticketId) {
@@ -8453,9 +8404,11 @@ function hasPlanFile(world) {
     return false;
   }
 }
+var TEMPLATES_DIR;
 var init_context_injection = __esm({
   "../core/dist/world/context-injection.js"() {
     "use strict";
+    TEMPLATES_DIR = fileURLToPath3(new URL("./templates", import.meta.url));
   }
 });
 
@@ -12269,7 +12222,7 @@ var init_session_aggregator = __esm({
 import * as http from "node:http";
 import * as fs23 from "node:fs";
 import * as path25 from "node:path";
-import { fileURLToPath as fileURLToPath3 } from "node:url";
+import { fileURLToPath as fileURLToPath4 } from "node:url";
 function jsonResponse(res, data, status = 200) {
   res.writeHead(status, { "Content-Type": "application/json; charset=utf-8" });
   res.end(JSON.stringify(data));
@@ -12450,7 +12403,7 @@ function findSessionInWorld(registry, sessionId) {
 }
 function createDashboardServer(opts) {
   const { port, registry } = opts;
-  const thisDir = path25.dirname(fileURLToPath3(import.meta.url));
+  const thisDir = path25.dirname(fileURLToPath4(import.meta.url));
   const defaultPublicDir = path25.resolve(thisDir, "../../../control-plane/public");
   const publicDir = opts.publicDir ?? defaultPublicDir;
   let hasPublicDir = fs23.existsSync(publicDir);
@@ -13805,9 +13758,9 @@ __export(install_root_exports, {
 });
 import { existsSync as existsSync23 } from "node:fs";
 import { dirname as dirname17, join as join28, resolve as resolve8 } from "node:path";
-import { fileURLToPath as fileURLToPath4 } from "node:url";
+import { fileURLToPath as fileURLToPath5 } from "node:url";
 function installRoot(metaUrl = import.meta.url) {
-  const here = fileURLToPath4(metaUrl);
+  const here = fileURLToPath5(metaUrl);
   return resolve8(dirname17(here), "..");
 }
 function isDevMode(env = process.env, installRootDir = installRoot()) {

package/dist/mcp-server.js

@@ -29835,6 +29835,8 @@ function formatBaselineSummary(result) {
 // ../core/dist/world/context-injection.js
 import * as fs16 from "node:fs";
 import * as path18 from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+var TEMPLATES_DIR = fileURLToPath2(new URL("./templates", import.meta.url));
 function injectWorldContext(opts) {
   const { world, task, linearTicketId, claudeMdExtra, taskContext, services, pleriPlaneUrl } = opts;
   const claudeDir = path18.join(world.workspacePath, ".claude");
@@ -29909,82 +29911,22 @@ function injectWorldContext(opts) {
   sections.push("4. When done, push and the work will be available for review");
   sections.push("5. Your `AskUserQuestion` calls are intercepted and surfaced to the operator's host CP automatically. The operator answers in the SPA; claude resumes when keys are injected.");
   sections.push("");
-  sections.push("## Lane Orchestration");
-  sections.push("");
-  sections.push("You can create parallel work lanes via the container API at http://localhost:8080.");
-  sections.push("Lanes run independent Claude Code sessions in isolated git worktrees.");
-  sections.push("");
-  sections.push("### When to create lanes");
-  sections.push("- Task has 2+ independent scopes (different directories/modules)");
-  sections.push("- Work can be done simultaneously without file conflicts");
-  sections.push("- Estimated effort > ~30 tool calls per scope");
-  sections.push("");
-  sections.push("### When NOT to create lanes");
-  sections.push("- Simple tasks touching few files");
-  sections.push("- Sequential work where each step depends on the previous");
-  sections.push("- Everything is in one directory");
-  sections.push("");
-  sections.push("### Lane API (use curl from this session)");
-  sections.push("");
-  sections.push(`Create: \`curl -s -X POST -H 'Content-Type: application/json' -d '{"name":"auth-fix","task":"Fix auth bugs","scope":["src/auth/**"],"avoids":["tests/**"]}' http://localhost:8080/lanes/create\``);
-  sections.push("");
-  sections.push("List: `curl -s http://localhost:8080/lanes`");
-  sections.push("");
-  sections.push(`Dispatch to lane: \`curl -s -X POST -H 'Content-Type: application/json' -d '{"prompt":"Start by reviewing..."}' http://localhost:8080/lanes/auth-fix/dispatch\``);
+  sections.push("## Lane Orchestration (advanced \u2014 read on demand)");
   sections.push("");
-  sections.push("Check status: `curl -s http://localhost:8080/lanes/auth-fix`");
+  sections.push("This world supports parallel work lanes via the container API at http://localhost:8080.");
+  sections.push("Use only when the task has 2+ independent scopes that can run simultaneously.");
   sections.push("");
-  sections.push("Merge: `curl -s -X POST http://localhost:8080/lanes/auth-fix/merge`");
+  sections.push("**Full lane API + workflow**: see `~/.olam/docs/lane-orchestration.md` (mounted into the world).");
   sections.push("");
-  sections.push("Destroy: `curl -s -X DELETE http://localhost:8080/lanes/auth-fix`");
+  sections.push("## Creating PRs from inside this world");
   sections.push("");
-  sections.push("### Orchestration workflow");
-  sections.push("1. Analyze the task \u2014 identify independent work streams");
-  sections.push("2. Create lanes with non-overlapping scope globs");
-  sections.push("3. Dispatch initial prompts to each lane");
-  sections.push("4. **Monitor progress** \u2014 poll lane status every 30 seconds:");
-  sections.push("   ```bash");
-  sections.push(`   while true; do STATUS=$(curl -s http://localhost:8080/lanes); RUNNING=$(echo "$STATUS" | jq '[.lanes[] | select(.status == "running")] | length'); echo "Running lanes: $RUNNING"; if [ "$RUNNING" = "0" ]; then echo "All lanes complete!"; break; fi; sleep 30; done`);
-  sections.push("   ```");
-  sections.push('5. **When a lane completes** (status is "completed" or no longer "running"):');
-  sections.push("   - Check its output: `curl -s http://localhost:8080/lanes/<name>`");
-  sections.push("   - If satisfactory, merge it: `curl -s -X POST http://localhost:8080/lanes/<name>/merge`");
-  sections.push("   - The merge automatically triggers a Codex adversarial review");
-  sections.push("6. **After ALL lanes are merged**:");
-  sections.push("   - Run tests to verify the merged result: `npm test` or equivalent");
-  sections.push("   - Review the combined changes: `git diff main...HEAD --stat`");
-  sections.push('   - Create a PR: `gh pr create --title "..." --body "..."`');
-  sections.push("7. Clean up lanes: `curl -s -X DELETE http://localhost:8080/lanes/<name>`");
-  sections.push("");
-  sections.push("### Important: Do not just report completion \u2014 ACT on it");
-  sections.push("When all lanes are done, immediately start merging and creating the PR.");
-  sections.push("Do not wait for the user to tell you to merge. The workflow is:");
-  sections.push("lanes complete -> merge each -> run tests -> create PR -> report to user.");
-  sections.push("");
-  sections.push("### CRITICAL: `gh pr create` from inside an Olam world");
-  sections.push("");
-  sections.push("Calling `gh pr create` directly inside this container will HANG");
-  sections.push("FOREVER on a TTY confirmation prompt that you can't answer.");
-  sections.push("This is a known and reproduced issue.");
-  sections.push("");
-  sections.push("You MUST always invoke it through this exact pattern:");
+  sections.push("`gh pr create` hangs on a TTY prompt inside the container. Always use:");
   sections.push("");
   sections.push("```bash");
-  sections.push("echo y | timeout 30 gh pr create \\");
-  sections.push("  --base main \\");
-  sections.push("  --head <branch> \\");
-  sections.push('  --title "<title>" \\');
-  sections.push("  --body-file /tmp/pr-body.md");
+  sections.push('echo y | timeout 30 gh pr create --base main --head <branch> --title "..." --body-file /tmp/pr-body.md');
   sections.push("```");
   sections.push("");
-  sections.push("- `echo y |` answers the Submit confirmation up front.");
-  sections.push("- `timeout 30` is a hard deadline \u2014 if gh hangs anyway, the command");
-  sections.push("  exits non-zero and you can react instead of stalling the world.");
-  sections.push("- `--body-file` (not `--body`) avoids shell-escaping bugs in long bodies.");
-  sections.push("- Always pass `--head` and `--base` explicitly so gh has nothing to ask.");
-  sections.push("");
-  sections.push('If the command exits non-zero with an error like "no commits" or');
-  sections.push('"branch not found", `git push -u origin <branch>` first, then retry.');
+  sections.push("**Why + full troubleshooting**: see `~/.olam/docs/gh-pr-create.md`.");
   sections.push("");
   sections.push("## Available Skills & Plugins");
   sections.push("");
@@ -30000,6 +29942,16 @@ function injectWorldContext(opts) {
   }
   const content = sections.join("\n");
   fs16.writeFileSync(path18.join(claudeDir, "CLAUDE.md"), content);
+  writeOlamDocs(world.workspacePath);
+}
+function writeOlamDocs(workspacePath) {
+  const docsDir = path18.join(workspacePath, ".olam", "docs");
+  fs16.mkdirSync(docsDir, { recursive: true });
+  for (const filename of ["lane-orchestration.md", "gh-pr-create.md"]) {
+    const src = path18.join(TEMPLATES_DIR, filename);
+    const dest = path18.join(docsDir, filename);
+    fs16.copyFileSync(src, dest);
+  }
 }
 function formatTaskSource(ctx) {
   if (ctx.source === "linear" && ctx.ticketId) {
@@ -32669,7 +32621,7 @@ import * as http2 from "node:http";
 import * as http from "node:http";
 import * as fs22 from "node:fs";
 import * as path25 from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // ../core/dist/dashboard/serialize.js
 function serializeTokenUsage(usage) {
@@ -33174,7 +33126,7 @@ function findSessionInWorld(registry2, sessionId) {
 }
 function createDashboardServer(opts) {
   const { port, registry: registry2 } = opts;
-  const thisDir = path25.dirname(fileURLToPath2(import.meta.url));
+  const thisDir = path25.dirname(fileURLToPath3(import.meta.url));
   const defaultPublicDir = path25.resolve(thisDir, "../../../control-plane/public");
   const publicDir = opts.publicDir ?? defaultPublicDir;
   let hasPublicDir = fs22.existsSync(publicDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pleri/olam-cli",
-  "version": "0.1.82",
+  "version": "0.1.84",
   "type": "module",
   "bin": {
     "olam": "./bin/olam.cjs"