@linzumi/cli 0.0.22-beta → 0.0.23-beta

package/README.md

@@ -117,9 +117,9 @@ Codex command.
 npx -y @linzumi/cli@latest signup --email alice@example.com --workspace-name "Alice's Linzumi" --agent-name BuildBot
 npx -y @linzumi/cli@latest claim --pending <pending_id> --code <XXXX-XXXX>
 npx -y @linzumi/cli@latest channel post <support_channel_id> "Hello @sean, starting this launch run."
-npx -y @linzumi/cli@latest hello
+npx -y @linzumi/cli@latest thread new "Hello Linzumi confetti" --message "Preparing the Hello Linzumi demo. Next I will generate /tmp/hello_linzumi, start its hot-reload server bound to 0.0.0.0 on port 8787, and ask Linzumi Codex to add confetti when the page loads."
+npx -y @linzumi/cli@latest init-hello-linzumi-demo-app --parent-dir /tmp --name hello_linzumi --host 0.0.0.0 --port 8787 --reset --json
 (cd /tmp/hello_linzumi && npm run dev > /tmp/hello_linzumi/dev.log 2>&1 &)
-npx -y @linzumi/cli@latest thread new "Hello Linzumi confetti" --message "Please add confetti when the page loads."
 npx -y @linzumi/cli@latest agent runner /tmp/hello_linzumi \
   --runner-id hello-linzumi-agent \
   --allowed-cwd /tmp/hello_linzumi \
@@ -261,7 +261,7 @@ intentionally. Every action is auditable from the thread.
 ## Pinning a version
 
 ```bash
-npm install -g @linzumi/cli@0.0.22-beta
+npm install -g @linzumi/cli@0.0.23-beta
 linzumi --version
 ```
 

package/dist/index.js

@@ -7773,48 +7773,92 @@ Launch target:
 }
 
 // src/helloLinzumiProject.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync7, readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "node:fs";
+import { existsSync as existsSync7, mkdirSync as mkdirSync7, readFileSync as readFileSync6, rmSync as rmSync2, writeFileSync as writeFileSync6 } from "node:fs";
 import { dirname as dirname7, join as join7, resolve as resolve5 } from "node:path";
 import { fileURLToPath } from "node:url";
 var defaultHelloLinzumiProjectDir = "/tmp/hello_linzumi";
+var defaultHelloLinzumiProjectName = "hello_linzumi";
+var defaultHelloLinzumiParentDir = "/tmp";
+var defaultHelloLinzumiPort = 8787;
+var defaultHelloLinzumiHost = "0.0.0.0";
 var markerFile = ".linzumi-demo-project";
 var moduleDir = dirname7(fileURLToPath(import.meta.url));
 var linzumiLogoSvg = readFileSync6(join7(moduleDir, "assets", "linzumi-logo.svg"), "utf8");
-function createHelloLinzumiProject(rootPath = defaultHelloLinzumiProjectDir) {
-  const root = resolve5(rootPath);
-  assertWritableDemoRoot(root);
+function createHelloLinzumiProject(input = {}) {
+  const options = typeof input === "string" ? { rootPath: input } : input;
+  const root = resolveHelloProjectRoot(options);
+  const port = options.port ?? defaultHelloLinzumiPort;
+  const host = normalizeHost(options.host);
+  assertTcpPort(port);
+  assertWritableDemoRoot(root, options.reset === true);
   mkdirSync7(join7(root, "src"), { recursive: true });
-  for (const file of demoFiles()) {
+  for (const file of demoFiles({ root, port, host })) {
     writeFileSync6(join7(root, file.path), file.content, "utf8");
   }
   return {
     root,
-    port: 8787,
+    port,
+    host,
     startCommand: "npm run dev",
-    previewUrl: "http://127.0.0.1:8787"
+    previewUrl: `http://${host}:${port}`
   };
 }
-function assertWritableDemoRoot(root) {
+function resolveHelloProjectRoot(options) {
+  if (options.rootPath !== undefined && (options.parentDir !== undefined || options.name !== undefined)) {
+    throw new Error("linzumi init-hello-linzumi-demo-app accepts either --dir or --parent-dir/--name, not both");
+  }
+  if (options.rootPath !== undefined) {
+    return resolve5(options.rootPath);
+  }
+  const name = normalizeProjectName(options.name ?? defaultHelloLinzumiProjectName);
+  return resolve5(options.parentDir ?? defaultHelloLinzumiParentDir, name);
+}
+function normalizeProjectName(value) {
+  const name = value.trim();
+  if (name === "" || name === "." || name === ".." || name.includes("/") || name.includes("\\")) {
+    throw new Error("--name must be a single directory name");
+  }
+  return name;
+}
+function normalizeHost(value) {
+  const host = value?.trim() ?? defaultHelloLinzumiHost;
+  if (host === "") {
+    throw new Error("--host must not be empty");
+  }
+  return host;
+}
+function assertTcpPort(port) {
+  if (Number.isInteger(port) && port > 0 && port <= 65535) {
+    return;
+  }
+  throw new Error("--port must be a TCP port from 1 to 65535");
+}
+function assertWritableDemoRoot(root, reset) {
   if (!existsSync7(root)) {
     return;
   }
   const markerPath = join7(root, markerFile);
-  if (existsSync7(markerPath) && readFileSync6(markerPath, "utf8").trim() === "hello-linzumi") {
+  const isDemoRoot = existsSync7(markerPath) && readFileSync6(markerPath, "utf8").trim() === "hello-linzumi";
+  if (isDemoRoot && reset) {
+    rmSync2(root, { recursive: true, force: true });
+    return;
+  }
+  if (isDemoRoot) {
     return;
   }
-  throw new Error(`${root} already exists and is not a Linzumi demo project; move it before rerunning linzumi hello`);
+  throw new Error(`${root} already exists and is not a Linzumi demo project; move it before rerunning linzumi init-hello-linzumi-demo-app`);
 }
-function demoFiles() {
+function demoFiles(options) {
   return [
     { path: markerFile, content: `hello-linzumi
 ` },
     { path: "package.json", content: packageJson },
-    { path: "server.mjs", content: serverSource },
+    { path: "server.mjs", content: serverSource(options) },
     { path: "index.html", content: htmlSource },
-    { path: "src/main.js", content: mainSource },
+    { path: "src/main.js", content: mainSource(options) },
     { path: "src/styles.css", content: cssSource },
     { path: "src/linzumi-logo.svg", content: linzumiLogoSvg },
-    { path: "README.md", content: readmeSource }
+    { path: "README.md", content: readmeSource(options) }
   ];
 }
 var packageJson = `${JSON.stringify({
@@ -7828,12 +7872,13 @@ var packageJson = `${JSON.stringify({
   }
 }, null, 2)}
 `;
-var serverSource = `import { createReadStream, existsSync, statSync, watch } from "node:fs";
+var serverSource = ({ host, port }) => `import { createReadStream, existsSync, statSync, watch } from "node:fs";
 import { extname, join, normalize } from "node:path";
 import { createServer } from "node:http";
 
 const root = process.cwd();
-const port = Number(process.env.PORT ?? "8787");
+const port = Number(process.env.PORT ?? "${port}");
+const host = process.env.HOST ?? ${JSON.stringify(host)};
 const clients = new Set();
 
 const contentTypes = new Map([
@@ -7844,7 +7889,7 @@ const contentTypes = new Map([
 ]);
 
 const server = createServer((request, response) => {
-  const url = new URL(request.url ?? "/", "http://127.0.0.1");
+  const url = new URL(request.url ?? "/", "http://0.0.0.0");
 
   if (url.pathname === "/events") {
     response.writeHead(200, {
@@ -7891,10 +7936,10 @@ for (const watchedPath of [join(root, "index.html"), join(root, "src")]) {
   });
 }
 
-server.listen(port, "127.0.0.1", () => {
+server.listen(port, host, () => {
   const address = server.address();
   const actualPort = typeof address === "object" && address !== null ? address.port : port;
-  process.stdout.write(\`Hello Linzumi listening on http://127.0.0.1:\${actualPort}\\n\`);
+  process.stdout.write(\`Hello Linzumi listening on http://\${host}:\${actualPort}\\n\`);
 });
 `;
 var htmlSource = `<!doctype html>
@@ -8180,7 +8225,9 @@ h1 {
   }
 }
 `;
-var mainSource = `const prompts = [
+var mainSource = ({ root, host, port }) => `const projectLabel = ${JSON.stringify(`${root} · ${host}:${port}`)};
+
+const prompts = [
   "Add a soft confetti burst when I click the heading.",
   "Make this a kanban board with three columns for my groceries.",
   "Add a guestbook so my team can sign in.",
@@ -8236,7 +8283,7 @@ document.querySelector("#app").innerHTML = \`
     </div>
 
     <div class="footer-note">
-      <code>/tmp/hello_linzumi · localhost:8787</code>
+      <code>\${escape(projectLabel)}</code>
       <a href="https://linzumi.com" target="_blank" rel="noreferrer">linzumi.com →</a>
     </div>
   </div>
@@ -8261,10 +8308,10 @@ events.addEventListener("reload", () => {
   window.location.reload();
 });
 `;
-var readmeSource = `# Linzumi launch demo
+var readmeSource = ({ host, port }) => `# Linzumi launch demo
 
 A tiny Node-only HTTP server with browser live reload, generated by
-\`linzumi hello\`.
+\`linzumi init-hello-linzumi-demo-app\`.
 
 Run it:
 
@@ -8272,7 +8319,8 @@ Run it:
 npm run dev
 \`\`\`
 
-Then open http://127.0.0.1:8787. The page reloads when \`index.html\` or files
+The app binds to \`${host}\` by default so Linzumi can reach it through the
+secure tunnel. Then open http://${host}:${port}. The page reloads when \`index.html\` or files
 under \`src/\` change.
 
 The bootstrap agent in your terminal has already opened the browser VS Code
@@ -8318,6 +8366,12 @@ var flagDefinitions = new Map([
 ]);
 var helloFlagDefinitions = new Map([
   ["dir", { kind: "value" }],
+  ["parent-dir", { kind: "value" }],
+  ["name", { kind: "value" }],
+  ["port", { kind: "value" }],
+  ["host", { kind: "value" }],
+  ["reset", { kind: "boolean" }],
+  ["json", { kind: "boolean" }],
   ["help", { kind: "boolean" }]
 ]);
 if (isMainModule()) {
@@ -8343,7 +8397,7 @@ async function main(args) {
       process.stdout.write(connectGuideText());
       return;
     case "version":
-      process.stdout.write(`linzumi 0.0.22-beta
+      process.stdout.write(`linzumi 0.0.23-beta
 `);
       return;
     case "auth":
@@ -8393,6 +8447,7 @@ function parseCommand(args) {
     case "paths":
       return { command: "paths", args: rest };
     case "hello":
+    case "init-hello-linzumi-demo-app":
       return { command: "hello", args: rest };
     case "agent":
       return rest[0] === "runner" ? { command: "agentRunner", args: rest.slice(1) } : { command: "agent", args: rest };
@@ -8422,12 +8477,32 @@ function runHelloCommand(args) {
     process.stdout.write(helloHelpText());
     return;
   }
-  const project = createHelloLinzumiProject(stringValue3(values, "dir") ?? defaultHelloLinzumiProjectDir);
+  const project = createHelloLinzumiProject({
+    rootPath: stringValue3(values, "dir"),
+    parentDir: stringValue3(values, "parent-dir") === undefined ? undefined : resolveUserPath(required(values, "parent-dir")),
+    name: stringValue3(values, "name"),
+    port: tcpPortValue(values, "port"),
+    host: stringValue3(values, "host"),
+    reset: values.get("reset") === true
+  });
+  if (values.get("json") === true) {
+    process.stdout.write(`${JSON.stringify({
+      project_dir: project.root,
+      dev_command: project.startCommand,
+      preview_url: project.previewUrl,
+      port: project.port,
+      host: project.host
+    })}
+`);
+    return;
+  }
   process.stdout.write(`project_dir: ${project.root}
 `);
   process.stdout.write(`dev_command: ${project.startCommand}
 `);
   process.stdout.write(`preview_url: ${project.previewUrl}
+`);
+  process.stdout.write(`bind_host: ${project.host}
 `);
 }
 function runPathsCommand(args) {
@@ -8742,7 +8817,7 @@ async function parseRunnerArgs(args, deps = {
     process.exit(0);
   }
   if (values.get("version") === true) {
-    process.stdout.write(`linzumi 0.0.22-beta
+    process.stdout.write(`linzumi 0.0.23-beta
 `);
     process.exit(0);
   }
@@ -8941,6 +9016,17 @@ function positiveIntegerValue(values, key) {
   }
   throw new Error(`--${key} must be a positive integer`);
 }
+function tcpPortValue(values, key) {
+  const value = stringValue3(values, key);
+  if (value === undefined) {
+    return;
+  }
+  const parsed = Number(value);
+  if (Number.isInteger(parsed) && parsed > 0 && parsed <= 65535) {
+    return parsed;
+  }
+  throw new Error(`--${key} must be a TCP port from 1 to 65535`);
+}
 function helpText() {
   return `Linzumi local Codex runner
 
@@ -8952,7 +9038,7 @@ Usage:
   linzumi post <thread_id> <message>
   linzumi inbox <thread_id> --since-last
   linzumi done <thread_id> --message <message>
-  linzumi hello
+  linzumi init-hello-linzumi-demo-app
   linzumi agent runner <folder> [options]
   linzumi start <folder> [options]
   linzumi paths list|add|remove [path]
@@ -8994,7 +9080,7 @@ Examples:
     linzumi thread new "Hello world" --message "Starting now. ETA 3m."
     linzumi post thr_abc123 "PR is open"
     linzumi done thr_abc123 --message "Done: https://github.com/example/repo/pull/1"
-    linzumi hello
+    linzumi init-hello-linzumi-demo-app
     linzumi agent runner ~/code/my-app --runner-id launch-agent-runner
     linzumi start ~/
     linzumi start ~/code/my-app
@@ -9019,19 +9105,27 @@ function helloHelpText() {
   return `Linzumi Hello demo project
 
 Usage:
-  linzumi hello [--dir <path>]
+  linzumi init-hello-linzumi-demo-app [--dir <path>]
+  linzumi init-hello-linzumi-demo-app [--parent-dir <path> --name <dirname>]
 
 Creates a tiny Node-only "Hello Linzumi" app with browser live reload.
 
 Default:
   ${defaultHelloLinzumiProjectDir}
+  host ${defaultHelloLinzumiHost}, port ${defaultHelloLinzumiPort}
 
 After creation:
   cd ${defaultHelloLinzumiProjectDir}
   npm run dev
 
 Options:
-  --dir <path>  Override the project directory for tests or local experiments.
+  --dir <path>         Exact project directory.
+  --parent-dir <path>  Parent directory, default ${defaultHelloLinzumiParentDir}.
+  --name <dirname>     Project directory name with --parent-dir, default ${defaultHelloLinzumiProjectName}.
+  --host <host>        Bind host baked into the demo app, default ${defaultHelloLinzumiHost}.
+  --port <port>        Port baked into the demo app, default ${defaultHelloLinzumiPort}.
+  --reset              Recreate an existing marked Linzumi demo directory.
+  --json               Print machine-readable project details.
 `;
 }
 function pathsHelpText() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linzumi/cli",
-  "version": "0.0.22-beta",
+  "version": "0.0.23-beta",
   "description": "Linzumi CLI — point a Codex agent at the real code on your laptop, with your team watching and steering from shared threads.",
   "type": "module",
   "bin": {