@codions/portta 0.0.0-develop.166.sha-d31f10f → 0.0.0-develop.171.sha-d749180

package/dist/cli.js

@@ -21311,6 +21311,113 @@ var init_password = __esm({
   }
 });
 
+// ../core/src/project-config.ts
+function hostShape(value3) {
+  if (/:\/\//.test(value3)) return "looks like a URL";
+  if (value3.startsWith("//")) return "looks like a URL";
+  if (value3.startsWith("/")) return "is an absolute path";
+  if (/^[a-z]:[\\/]/i.test(value3)) return "is an absolute path";
+  if (value3.startsWith("~")) return "is a home-relative path, which differs per machine";
+  if (/^\d{1,5}:\d{1,5}$/.test(value3)) return "looks like a published host port";
+  return null;
+}
+function defaultProjectConfig() {
+  return {
+    version: 1,
+    name: null,
+    mainBranch: null,
+    worktrees: {
+      root: PROJECT_CONFIG_DEFAULTS.worktreeRoot,
+      branchPattern: PROJECT_CONFIG_DEFAULTS.branchPattern
+    },
+    stack: [],
+    instructions: []
+  };
+}
+function parseProjectConfig(document) {
+  if (document === null || document === void 0) {
+    return { ok: false, issues: [{ path: "", message: `${PROJECT_CONFIG_FILE} is empty` }] };
+  }
+  const parsed = Schema.safeParse(document);
+  if (!parsed.success) {
+    return {
+      ok: false,
+      issues: parsed.error.issues.map((issue2) => ({
+        path: issue2.path.join("."),
+        message: issue2.message
+      }))
+    };
+  }
+  const value3 = parsed.data;
+  const defaults = defaultProjectConfig();
+  return {
+    ok: true,
+    config: {
+      version: 1,
+      name: value3.name ?? null,
+      mainBranch: value3.mainBranch ?? null,
+      worktrees: {
+        root: value3.worktrees?.root ?? defaults.worktrees.root,
+        branchPattern: value3.worktrees?.branchPattern ?? defaults.worktrees.branchPattern
+      },
+      stack: value3.stack ?? [],
+      instructions: value3.instructions ?? []
+    }
+  };
+}
+var PROJECT_CONFIG_FILE, PROJECT_CONFIG_PATH, PROJECT_CONFIG_DEFAULTS, BRANCH_PATTERN_PLACEHOLDERS, portable, repoRelativePath, branchPattern, Schema;
+var init_project_config = __esm({
+  "../core/src/project-config.ts"() {
+    "use strict";
+    init_zod();
+    PROJECT_CONFIG_FILE = "project.yaml";
+    PROJECT_CONFIG_PATH = `.portta/${PROJECT_CONFIG_FILE}`;
+    PROJECT_CONFIG_DEFAULTS = {
+      worktreeRoot: ".portta/worktrees",
+      branchPattern: "{type}/{slug}"
+    };
+    BRANCH_PATTERN_PLACEHOLDERS = ["type", "slug"];
+    portable = (label3) => external_exports.string().trim().min(1).superRefine((value3, ctx) => {
+      const shape = hostShape(value3);
+      if (shape) {
+        ctx.addIssue({
+          code: "custom",
+          message: `${label3} ${shape}; that belongs to the host, not to the project (ADR 0052)`
+        });
+      }
+    });
+    repoRelativePath = (label3) => portable(label3).superRefine((value3, ctx) => {
+      const normalized = value3.replaceAll("\\", "/");
+      if (normalized.split("/").includes("..")) {
+        ctx.addIssue({ code: "custom", message: `${label3} escapes the repository with '..'` });
+      }
+    });
+    branchPattern = portable("the branch pattern").superRefine((value3, ctx) => {
+      const used = [...value3.matchAll(/\{([^}]*)\}/g)].map((match2) => match2[1] ?? "");
+      const allowed = new Set(BRANCH_PATTERN_PLACEHOLDERS);
+      for (const placeholder of used) {
+        if (!allowed.has(placeholder)) {
+          ctx.addIssue({
+            code: "custom",
+            message: `unknown placeholder {${placeholder}}; the branch pattern accepts ${BRANCH_PATTERN_PLACEHOLDERS.map((name) => `{${name}}`).join(" and ")}`
+          });
+        }
+      }
+    });
+    Schema = external_exports.strictObject({
+      version: external_exports.literal(1),
+      name: portable("the project name").optional(),
+      mainBranch: portable("the main branch").optional(),
+      worktrees: external_exports.strictObject({
+        root: repoRelativePath("the worktree root").optional(),
+        branchPattern: branchPattern.optional()
+      }).optional(),
+      stack: external_exports.array(external_exports.string().trim().min(1).regex(/^[a-z0-9][a-z0-9.+-]*$/i, "a stack entry is a plain identifier such as node or mysql")).optional(),
+      instructions: external_exports.array(repoRelativePath("an instruction path")).optional()
+    });
+  }
+});
+
 // ../core/src/project-order.ts
 function parseDependsOn(label3) {
   if (!label3 || label3.trim() === "") return [];
@@ -21757,6 +21864,14 @@ var init_runner = __esm({
   }
 });
 
+// ../core/src/module-endpoints.ts
+var init_module_endpoints = __esm({
+  "../core/src/module-endpoints.ts"() {
+    "use strict";
+    init_dynamic();
+  }
+});
+
 // ../core/src/shares.ts
 function shareRouterName(id) {
   return `portta-share-${id}`;
@@ -22318,6 +22433,7 @@ var init_src = __esm({
     init_namespace();
     init_paths();
     init_password();
+    init_project_config();
     init_project_order();
     init_projects_home();
     init_protections();
@@ -22326,6 +22442,7 @@ var init_src = __esm({
     init_audit_actions();
     init_roles();
     init_runner();
+    init_module_endpoints();
     init_shares();
     init_tunnel();
     init_activity();
@@ -22384,7 +22501,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@codions/portta",
-      version: "0.0.0-develop.166.sha-d31f10f",
+      version: "0.0.0-develop.171.sha-d749180",
       description: "Machine-first CLI for a shared Docker development gateway",
       license: "MIT",
       type: "module",
@@ -22458,7 +22575,7 @@ var init_version = __esm({
     "use strict";
     init_package();
     CLI_VERSION = package_default.version;
-    CLI_BUILD_DATE = true ? "2026-09-18T00:00:48Z" : void 0;
+    CLI_BUILD_DATE = true ? "2026-09-18T00:56:55Z" : void 0;
   }
 });
 
@@ -36934,7 +37051,7 @@ function agentTemplatePlaceholder(variable) {
 function hostPortFromEnv(env) {
   return parseInt(env[ENV_NAMES.hostPort] || env.PORT || String(APP_DEFAULTS.port), 10);
 }
-var APP_NAME, APP_SLUG, CLI_NAME, GLOBAL_CONFIG_DIR, HOST_STATE_DIR, PROJECT_CONFIG_DIR, PATH_NAMES, PROJECT_CONFIG_PATH, PROJECT_LOCAL_CONFIG_PATH, APP_DEFAULTS, ENV_NAMES, RUNTIME_IDENTITY, SERVICE_IDENTITY, LINEAR_IDENTITY;
+var APP_NAME, APP_SLUG, CLI_NAME, GLOBAL_CONFIG_DIR, HOST_STATE_DIR, PROJECT_CONFIG_DIR, PATH_NAMES, PROJECT_CONFIG_PATH2, PROJECT_LOCAL_CONFIG_PATH, APP_DEFAULTS, ENV_NAMES, RUNTIME_IDENTITY, SERVICE_IDENTITY, LINEAR_IDENTITY;
 var init_config2 = __esm({
   "../core/src/taskflow/config.ts"() {
     "use strict";
@@ -36963,7 +37080,7 @@ var init_config2 = __esm({
       archiveState: "archive.json",
       openSessionsState: "open-sessions.json"
     };
-    PROJECT_CONFIG_PATH = `${PROJECT_CONFIG_DIR}/${PATH_NAMES.projectConfig}`;
+    PROJECT_CONFIG_PATH2 = `${PROJECT_CONFIG_DIR}/${PATH_NAMES.projectConfig}`;
     PROJECT_LOCAL_CONFIG_PATH = `${PROJECT_CONFIG_DIR}/${PATH_NAMES.projectLocalConfig}`;
     APP_DEFAULTS = {
       port: 5111,
@@ -47725,7 +47842,7 @@ var require_Schema = __commonJS({
     var string4 = require_string();
     var tags = require_tags();
     var sortMapEntriesByKey = (a3, b) => a3.key < b.key ? -1 : a3.key > b.key ? 1 : 0;
-    var Schema = class _Schema {
+    var Schema2 = class _Schema {
       constructor({ compat, customTags, merge: merge2, resolveKnownTags, schema, sortMapEntries, toStringDefaults }) {
         this.compat = Array.isArray(compat) ? tags.getTags(compat, "compat") : compat ? tags.getTags(null, compat) : null;
         this.name = typeof schema === "string" && schema || "core";
@@ -47743,7 +47860,7 @@ var require_Schema = __commonJS({
         return copy;
       }
     };
-    exports.Schema = Schema;
+    exports.Schema = Schema2;
   }
 });
 
@@ -47836,7 +47953,7 @@ var require_Document = __commonJS({
     var identity3 = require_identity();
     var Pair = require_Pair();
     var toJS = require_toJS();
-    var Schema = require_Schema();
+    var Schema2 = require_Schema();
     var stringifyDocument = require_stringifyDocument();
     var anchors = require_anchors();
     var applyReviver = require_applyReviver();
@@ -48087,7 +48204,7 @@ var require_Document = __commonJS({
         if (options.schema instanceof Object)
           this.schema = options.schema;
         else if (opt)
-          this.schema = new Schema.Schema(Object.assign(opt, options));
+          this.schema = new Schema2.Schema(Object.assign(opt, options));
         else
           throw new Error(`With a null YAML version, the { schema: Schema } option is required`);
       }
@@ -51751,7 +51868,7 @@ var require_dist = __commonJS({
     "use strict";
     var composer = require_composer();
     var Document = require_Document();
-    var Schema = require_Schema();
+    var Schema2 = require_Schema();
     var errors = require_errors();
     var Alias = require_Alias();
     var identity3 = require_identity();
@@ -51767,7 +51884,7 @@ var require_dist = __commonJS({
     var visit2 = require_visit();
     exports.Composer = composer.Composer;
     exports.Document = Document.Document;
-    exports.Schema = Schema.Schema;
+    exports.Schema = Schema2.Schema;
     exports.YAMLError = errors.YAMLError;
     exports.YAMLParseError = errors.YAMLParseError;
     exports.YAMLWarning = errors.YAMLWarning;
@@ -52052,7 +52169,7 @@ function parseConfigDocument(text) {
   const parsed = (0, import_yaml.parse)(text);
   return isRecord2(parsed) ? parsed : {};
 }
-function parseProjectConfig(parsed) {
+function parseProjectConfig2(parsed) {
   const worktreeRoot = parseWorktreeRoot(parsed.workspace, DEFAULT_CONFIG.workspace.worktreeRoot);
   return {
     name: typeof parsed.name === "string" && parsed.name.trim() ? parsed.name.trim() : DEFAULT_CONFIG.name,
@@ -52082,7 +52199,7 @@ function parseProjectConfig(parsed) {
   };
 }
 function defaultConfig() {
-  return parseProjectConfig({});
+  return parseProjectConfig2({});
 }
 function parseTeamKeyList(raw2) {
   if (!Array.isArray(raw2)) return void 0;
@@ -52217,7 +52334,7 @@ function loadConfig(dir, options = {}) {
   let projectConfig;
   try {
     const text = readConfigFile(root2).trim();
-    projectConfig = text ? parseProjectConfig(parseConfigDocument(text)) : defaultConfig();
+    projectConfig = text ? parseProjectConfig2(parseConfigDocument(text)) : defaultConfig();
   } catch {
     projectConfig = defaultConfig();
   }
@@ -90034,7 +90151,7 @@ function createDaemonTaskflowHost(context) {
       port: hostListen(env).port,
       workflowBuiltinsDir: taskflowAssets(env).workflowBuiltinsDir,
       version: env.PORTTA_VERSION || "0.0.0-local",
-      buildDate: true ? "2026-09-18T00:00:48Z" : (/* @__PURE__ */ new Date()).toISOString(),
+      buildDate: true ? "2026-09-18T00:56:55Z" : (/* @__PURE__ */ new Date()).toISOString(),
       environmentStore: createEnvironmentStore(paths3.database),
       hostEnvironmentProvider: new HostEnvironmentProvider(),
       devContainerProvider: new DevContainerProvider(),
@@ -110160,8 +110277,8 @@ function detectInitEnvironment(gitRoot2, requested = "auto") {
 function buildInitPromptSpec(context) {
   const systemPrompt = [
     `You are bootstrapping a local repository for ${APP_NAME}.`,
-    `A starter \`${PROJECT_CONFIG_PATH}\` already exists at the repo root.`,
-    `Inspect the repository in the current working directory and edit that existing \`${PROJECT_CONFIG_PATH}\` in place.`,
+    `A starter \`${PROJECT_CONFIG_PATH2}\` already exists at the repo root.`,
+    `Inspect the repository in the current working directory and edit that existing \`${PROJECT_CONFIG_PATH2}\` in place.`,
     "Do not modify any other file.",
     "Do not ask the user questions. Infer the config from the repository contents.",
     "Be efficient: inspect only the files needed to determine the project name, main branch, service layout, dev commands, and ports.",
@@ -110186,11 +110303,11 @@ function buildInitPromptSpec(context) {
     "Only include optional sections like auto_name, lifecycleHooks, sandbox/docker config, mounts, or systemPrompt if the repository gives clear evidence they are needed.",
     "Prefer editing the existing keys over replacing the file with a completely different shape.",
     "Preserve the existing template structure and comments unless a specific change requires updating them.",
-    `Before finishing, verify that \`${PROJECT_CONFIG_PATH}\` exists and contains the final YAML.`
+    `Before finishing, verify that \`${PROJECT_CONFIG_PATH2}\` exists and contains the final YAML.`
   ].join("\n");
   return {
     systemPrompt,
-    userPrompt: `Adapt the existing starter \`${PROJECT_CONFIG_PATH}\` for this repository.`
+    userPrompt: `Adapt the existing starter \`${PROJECT_CONFIG_PATH2}\` for this repository.`
   };
 }
 function buildInitAgentCommand(agent, prompt, outputPrefix = `${APP_SLUG}-init`) {
@@ -110742,13 +110859,13 @@ var init_init_deps = __esm({
         tool: "claude",
         args: ["--version"],
         required: false,
-        hint: `Install the Claude Code CLI to let Claude scaffold ${PROJECT_CONFIG_PATH}`
+        hint: `Install the Claude Code CLI to let Claude scaffold ${PROJECT_CONFIG_PATH2}`
       },
       {
         tool: "codex",
         args: ["--version"],
         required: false,
-        hint: `Install the Codex CLI to let Codex scaffold ${PROJECT_CONFIG_PATH}`
+        hint: `Install the Codex CLI to let Codex scaffold ${PROJECT_CONFIG_PATH2}`
       },
       { tool: "docker", args: ["--version"], required: false, hint: "https://docs.docker.com/get-started/get-docker/" }
     ];
@@ -110953,7 +111070,7 @@ async function runInit(options) {
   let selectedAnalyze = resolveInitAnalysis(options, selectedRuntime);
   const configExists = existsSync29(taskflowYaml);
   if (configExists) {
-    log2.info(`${PROJECT_CONFIG_PATH} already exists`);
+    log2.info(`${PROJECT_CONFIG_PATH2} already exists`);
   } else if (needsInteractiveAnalysisFallback(options, selectedRuntime)) {
     selectedAnalyze = await selectFallbackAgent();
   }
@@ -110974,7 +111091,7 @@ async function runInit(options) {
           environmentProvider: detection.selectedRuntime
         })
       );
-      log2.success(`${PROJECT_CONFIG_PATH} created from deterministic detection`);
+      log2.success(`${PROJECT_CONFIG_PATH2} created from deterministic detection`);
     } else {
       const available2 = isInitAgentSelectable(
         depStatuses.find((status) => status.tool === selectedAnalyze) ?? { found: false }
@@ -110997,11 +111114,11 @@ async function runInit(options) {
       const prompt = buildInitPromptSpec({ ...context, defaultAgent: selectedAnalyze });
       const command = buildInitAgentCommand(selectedAnalyze, prompt);
       const streamPrinter = createAgentStreamPrinter(label3);
-      log2.step(`Running ${label3} to adapt ${PROJECT_CONFIG_PATH}...`);
+      log2.step(`Running ${label3} to adapt ${PROJECT_CONFIG_PATH2}...`);
       const result = await runInitAgentCommand(command, gitRoot2, { onEvent: streamPrinter.onEvent });
       streamPrinter.finish();
       if (!existsSync29(taskflowYaml)) {
-        log2.error(`${label3} removed ${PROJECT_CONFIG_PATH}`);
+        log2.error(`${label3} removed ${PROJECT_CONFIG_PATH2}`);
         const details = [
           result.summary ? `Summary:
 ${result.summary}` : "",
@@ -111018,12 +111135,12 @@ ${result.stderr.trim()}` : ""
       const finalYaml = await readFile12(taskflowYaml, "utf8");
       const changedTemplate = configExists || finalYaml !== starterTemplate;
       if (result.exitCode === 0 && changedTemplate) {
-        log2.success(`${label3} adapted ${PROJECT_CONFIG_PATH}`);
+        log2.success(`${label3} adapted ${PROJECT_CONFIG_PATH2}`);
       } else if (result.exitCode === 0) {
         log2.warning(`${label3} left the starter template unchanged`);
-        log2.warning(`${label3} did not change the starter template. Review ${PROJECT_CONFIG_PATH} manually.`);
+        log2.warning(`${label3} did not change the starter template. Review ${PROJECT_CONFIG_PATH2} manually.`);
       } else if (changedTemplate) {
-        log2.warning(`${label3} updated ${PROJECT_CONFIG_PATH}`);
+        log2.warning(`${label3} updated ${PROJECT_CONFIG_PATH2}`);
         log2.warning(`${label3} exited with code ${result.exitCode}. Review the generated file before using it.`);
       } else {
         log2.warning(`${label3} left the starter template in place`);
@@ -111046,7 +111163,7 @@ ${result.stderr.trim()}` : ""
   );
   outro("You're all set! Next steps:");
   console.log();
-  console.log(`  1. Review ${PROJECT_CONFIG_PATH} and adjust runtime and exposure overrides if needed`);
+  console.log(`  1. Review ${PROJECT_CONFIG_PATH2} and adjust runtime and exposure overrides if needed`);
   console.log("  2. Keep the host daemon running: portta host serve --detach  (or portta host service install)");
   console.log(`  3. Enable tab completion: eval "$(${flowInvocation()} completion zsh)"  (or bash)`);
   console.log();
@@ -111904,7 +112021,7 @@ import { setTimeout as delay4 } from "node:timers/promises";
 function projectSetupPhaseLabel(phase) {
   switch (phase) {
     case "creating_config":
-      return `Creating ${PROJECT_CONFIG_PATH}`;
+      return `Creating ${PROJECT_CONFIG_PATH2}`;
     case "analyzing":
       return "Analyzing project structure";
     case "ready":
@@ -119644,6 +119761,7 @@ async function dbRestore(file2, command) {
 
 // src/commands/projects.ts
 init_src();
+var import_yaml2 = __toESM(require_dist(), 1);
 init_zod();
 import { existsSync as existsSync23, mkdirSync as mkdirSync15, readFileSync as readFileSync22, realpathSync as realpathSync4, renameSync as renameSync5, rmSync as rmSync6, writeFileSync as writeFileSync12 } from "node:fs";
 import { createHash as createHash15 } from "node:crypto";
@@ -119784,6 +119902,21 @@ function declaredComposeName(file2) {
     return null;
   }
 }
+function readProjectConfig(root2) {
+  const path7 = join46(root2, PROJECT_CONFIG_PATH);
+  if (!existsSync23(path7)) {
+    return { source: "defaults", path: PROJECT_CONFIG_PATH, config: defaultProjectConfig(), issues: [] };
+  }
+  let document;
+  try {
+    document = (0, import_yaml2.parse)(readFileSync22(path7, "utf8"));
+  } catch (error61) {
+    const message = error61 instanceof Error ? error61.message : String(error61);
+    return { source: "file", path: PROJECT_CONFIG_PATH, config: null, issues: [{ path: "", message }] };
+  }
+  const parsed = parseProjectConfig(document);
+  return parsed.ok ? { source: "file", path: PROJECT_CONFIG_PATH, config: parsed.config, issues: [] } : { source: "file", path: PROJECT_CONFIG_PATH, config: null, issues: parsed.issues };
+}
 async function analyze(pathValue, options = {}, containers) {
   const base2 = resolve24(pathValue);
   let composeFile2;
@@ -119834,6 +119967,7 @@ async function analyze(pathValue, options = {}, containers) {
     path: path7,
     compose_file: basename14(composeFile2),
     gateway_overlay: overlay2,
+    project_config: readProjectConfig(path7),
     project: { name: project2, source: projectFromEnv ? ".env" : declaredName ? "compose name:" : "directory name (implicit)" },
     domain: gatewayContext({ required: false }).config.domain,
     services,
@@ -119865,6 +119999,19 @@ async function analyzeCommand(path7, options, command) {
     output2.line(`  project namespace      ${report.project.name} (${report.project.source})`);
     const identities = [...new Set(report.services.flatMap((service2) => Object.entries(service2.labels).filter(([key]) => key.startsWith("portta.project") || key.startsWith("portta.repo") || key.startsWith("portta.git.root")).map(([key, value3]) => `${key}=${value3}`)))];
     output2.line(`  declared identity      ${identities.length ? identities.join(" ") : "none (inferred from the Compose labels)"}`);
+    const declared = report.project_config;
+    if (declared.issues.length) {
+      output2.line(`  project.yaml           invalid, so its defaults are not applied:`);
+      for (const issue2 of declared.issues) output2.line(`    ${issue2.path ? `${issue2.path}: ` : ""}${issue2.message}`);
+    } else if (declared.config) {
+      const summary = [
+        declared.config.name ? `name ${declared.config.name}` : null,
+        declared.config.mainBranch ? `main branch ${declared.config.mainBranch}` : null,
+        `worktrees ${declared.config.worktrees.root}`,
+        `branches ${declared.config.worktrees.branchPattern}`
+      ].filter((part) => part !== null);
+      output2.line(`  project.yaml           ${declared.source === "file" ? summary.join(", ") : `absent, so defaults apply: ${summary.join(", ")}`}`);
+    }
     output2.line("\nServices");
     for (const service2 of report.services) output2.line(`  ${service2.name}	${service2.image ?? "<built>"}	${service2.kind}	${service2.published_ports.map((port) => `${port.host}:${port.container}`).join(",") || "-"}`);
     output2.line("\nFindings");
@@ -120407,7 +120554,7 @@ function helpAfter(command, text) {
 ${text(commandInvocation(context.command))}`);
 }
 function runOptions(command) {
-  return command.addOption(new Option("--input <text>", "Run input text").conflicts("inputJson")).option("--input-json <json>", "Run input as a JSON object").option("--profile <name>", `Profile from ${PROJECT_CONFIG_PATH}`).addOption(
+  return command.addOption(new Option("--input <text>", "Run input text").conflicts("inputJson")).option("--input-json <json>", "Run input as a JSON object").option("--profile <name>", `Profile from ${PROJECT_CONFIG_PATH2}`).addOption(
     new Option("--workspace <strategy>", "Execution workspace (default: workflow policy or worktree)").choices([
       "worktree",
       "branch",
@@ -120477,12 +120624,12 @@ ${environment.map(([name = "", text]) => `  ${name.padEnd(width)}  ${text}`).joi
 Analysis:   --analyze=auto uses the default agent only when runtime detection falls back to host.
             --analyze=claude | --analyze=codex always run that agent.`
   );
-  leaf(flow, "add [branch]", "Create a worktree using the dashboard lifecycle").option("--existing", "Use an existing local or remote branch instead of creating a new one").option("--base <branch>", "Base branch for a new worktree (defaults to config)").option("--profile <name>", `Worktree profile from ${PROJECT_CONFIG_PATH}`).option("--agent <id>", "Agent id to launch (repeatable)", collect).option("--prompt <text>", "Initial agent prompt").option("--env <KEY=VALUE>", "Runtime env override (repeatable)", collect).option("--interface <mode>", "Session UI: terminal or web-chat").option("-d, --detach", "Create worktree without switching to it").option(
+  leaf(flow, "add [branch]", "Create a worktree using the dashboard lifecycle").option("--existing", "Use an existing local or remote branch instead of creating a new one").option("--base <branch>", "Base branch for a new worktree (defaults to config)").option("--profile <name>", `Worktree profile from ${PROJECT_CONFIG_PATH2}`).option("--agent <id>", "Agent id to launch (repeatable)", collect).option("--prompt <text>", "Initial agent prompt").option("--env <KEY=VALUE>", "Runtime env override (repeatable)", collect).option("--interface <mode>", "Session UI: terminal or web-chat").option("-d, --detach", "Create worktree without switching to it").option(
     "--from-linear <issue-id>",
     `Bootstrap from a Linear issue, plus any saved ${APP_NAME} session or linked PR`
   ).option("--branch <name>", "Override the branch when --from-linear resolves to one");
   helpAfter(
-    leaf(flow, "oneshot [branch]", "Run a worktree start-to-finish, streaming logs to stdout").option("--resume <branch>", "Resume an existing local worktree instead of creating one").option("--prompt <text>", "Initial agent prompt (required; follow-up nudge when --resume)").option("--agent <id>", "Agent id to launch").option("--base <branch>", "Base branch for a new worktree (defaults to config)").option("--profile <name>", `Worktree profile from ${PROJECT_CONFIG_PATH}`).option("--env <KEY=VALUE>", "Runtime env override (repeatable)", collect).option("--keep-open", "Don't auto-close the worktree session when the agent finishes").option(
+    leaf(flow, "oneshot [branch]", "Run a worktree start-to-finish, streaming logs to stdout").option("--resume <branch>", "Resume an existing local worktree instead of creating one").option("--prompt <text>", "Initial agent prompt (required; follow-up nudge when --resume)").option("--agent <id>", "Agent id to launch").option("--base <branch>", "Base branch for a new worktree (defaults to config)").option("--profile <name>", `Worktree profile from ${PROJECT_CONFIG_PATH2}`).option("--env <KEY=VALUE>", "Runtime env override (repeatable)", collect).option("--keep-open", "Don't auto-close the worktree session when the agent finishes").option(
       "--linear <id|team>",
       "Tie this oneshot to Linear: ENG-123 loads the issue and posts back; ENG creates an issue when done"
     ).option("--branch <name>", "Override the branch when --linear resolves to one"),
@@ -120515,7 +120662,7 @@ running, resume with \`${invocation2} --resume <branch> --prompt <text>\`).`
       "--profile <name>",
       "Profile name (alternative to positional arg)"
     ),
-    () => `Switches the worktree to another profile from ${PROJECT_CONFIG_PATH}. An open
+    () => `Switches the worktree to another profile from ${PROJECT_CONFIG_PATH2}. An open
 worktree is restarted with the new pane layout and commands; a closed
 one picks the new profile up on its next open.`
   );