overlord-cli 0.2607191710.0 → 0.2607201427.0

package/dist/index.js

@@ -13538,6 +13538,151 @@ var init_discover_project_local = __esm({
   }
 });
 
+// ../packages/contract/dist/launch-variables.js
+var LAUNCH_VARIABLES, LAUNCH_VARIABLE_NAMES;
+var init_launch_variables = __esm({
+  "../packages/contract/dist/launch-variables.js"() {
+    "use strict";
+    LAUNCH_VARIABLES = [
+      {
+        name: "MISSION_ID",
+        description: "Mission display id for the launch (e.g. coo:359).",
+        example: "coo:359",
+        availableAt: ["plan_build", "terminal_env"]
+      },
+      {
+        name: "OVERLORD_MISSION_ID",
+        description: "Same value as MISSION_ID \u2014 preferred Overlord-prefixed form.",
+        example: "coo:359",
+        availableAt: ["plan_build", "terminal_env"]
+      },
+      {
+        name: "OVERLORD_BACKEND_URL",
+        description: "Backend URL the agent CLI/MCP should call for this launch.",
+        example: "http://127.0.0.1:4310",
+        availableAt: ["plan_build", "terminal_env"]
+      },
+      {
+        name: "OVERLORD_EXECUTION_REQUEST_ID",
+        description: "Execution-request id when the launch is runner-driven. Empty/absent for a bare `ovld launch`.",
+        example: "380e8a6a-ccf0-49f4-9761-f1c0ba02c39c",
+        availableAt: ["plan_build", "terminal_env"]
+      },
+      {
+        name: "OVERLORD_WORKING_DIRECTORY",
+        description: "Absolute path the agent terminal cds into \u2014 the resolved execution-target checkout (or worktree).",
+        example: "/Users/you/src/overlord",
+        availableAt: ["plan_build", "terminal_env"]
+      },
+      {
+        name: "OVERLORD_CONTEXT_FILE",
+        description: "Absolute path to the markdown briefing written for this launch under `.overlord/tmp/`.",
+        example: "/Users/you/src/overlord/.overlord/tmp/mission-coo-359.md",
+        availableAt: ["plan_build", "terminal_env"]
+      },
+      {
+        name: "OVERLORD_TMPDIR",
+        description: "Project-scoped scratch directory (`.overlord/tmp/`). Also mirrored as TMPDIR/TMP/TEMP.",
+        example: "/Users/you/src/overlord/.overlord/tmp",
+        availableAt: ["plan_build", "terminal_env"]
+      },
+      {
+        name: "TMPDIR",
+        description: "Same path as OVERLORD_TMPDIR \u2014 standard temp-dir env name.",
+        example: "/Users/you/src/overlord/.overlord/tmp",
+        availableAt: ["plan_build", "terminal_env"]
+      },
+      {
+        name: "TMP",
+        description: "Same path as OVERLORD_TMPDIR \u2014 Windows-style temp-dir alias.",
+        example: "/Users/you/src/overlord/.overlord/tmp",
+        availableAt: ["plan_build", "terminal_env"]
+      },
+      {
+        name: "TEMP",
+        description: "Same path as OVERLORD_TMPDIR \u2014 Windows-style temp-dir alias.",
+        example: "/Users/you/src/overlord/.overlord/tmp",
+        availableAt: ["plan_build", "terminal_env"]
+      },
+      {
+        name: "OVERLORD_PROJECT_RESOURCES",
+        description: "JSON array of every project resource for this execution target (resourceKey, path, state, flags, accessMode). Set only when the project has resources.",
+        example: '[{"resourceKey":"primary","path":"/repo/a","state":"ready","isPrimary":true,"accessMode":"read_write"}]',
+        availableAt: ["plan_build", "terminal_env"],
+        format: "JSON array"
+      },
+      {
+        name: "OVERLORD_PROJECT_RESOURCES_PATHS",
+        description: "Comma-separated absolute paths of connected project resources with explicit `:rw` or `:ro` permission suffixes (entries without a local path are omitted). `read_write` resources emit `:rw`; reference (`read`) resources emit `:ro`.",
+        example: "/repo/a:rw,/repo/b:ro",
+        availableAt: ["plan_build", "terminal_env"],
+        format: "comma-separated paths with :rw/:ro suffix"
+      },
+      {
+        name: "OVERLORD_PROJECT_RESOURCES_PATHS_CSV",
+        description: "Alias of OVERLORD_PROJECT_RESOURCES_PATHS, kept for backward compatibility. Same comma-separated `:rw`/`:ro`-suffixed paths. Useful for env vars that expect a CSV list (e.g. AGENT_POD_EXTRA_ALLOWED_PATHS).",
+        example: "/repo/a:rw,/repo/b:ro",
+        availableAt: ["plan_build", "terminal_env"],
+        format: "comma-separated paths with :rw/:ro suffix"
+      },
+      {
+        name: "OVERLORD_PRIMARY_RESOURCE_PATH",
+        description: "Absolute path of the primary (or else current) project resource when connected locally; empty string otherwise.",
+        example: "/repo/a",
+        availableAt: ["plan_build", "terminal_env"]
+      }
+    ];
+    LAUNCH_VARIABLE_NAMES = LAUNCH_VARIABLES.filter((variable) => variable.availableAt.includes("plan_build")).map((variable) => variable.name);
+  }
+});
+
+// ../packages/contract/dist/resource-paths.js
+function accessModeToResourcePathPermission({ accessMode, isPrimary = false }) {
+  if (isPrimary)
+    return "rw";
+  return accessMode === "read" ? "ro" : "rw";
+}
+function formatResourcePathWithPermission({ path: path27, accessMode, isPrimary = false }) {
+  const trimmed = path27.trim();
+  if (!trimmed)
+    return "";
+  const permission = accessModeToResourcePathPermission({ accessMode, isPrimary });
+  return `${trimmed}:${permission}`;
+}
+function formatProjectResourcePathsFromManifest(projectResources) {
+  if (!Array.isArray(projectResources))
+    return "";
+  const paths = [];
+  for (const entry of projectResources) {
+    if (!entry || typeof entry !== "object")
+      continue;
+    const record = entry;
+    const path27 = typeof record.path === "string" ? record.path.trim() : "";
+    if (!path27)
+      continue;
+    paths.push(formatResourcePathWithPermission({
+      path: path27,
+      accessMode: typeof record.accessMode === "string" ? record.accessMode : null,
+      isPrimary: record.isPrimary === true
+    }));
+  }
+  return paths.join(",");
+}
+var init_resource_paths = __esm({
+  "../packages/contract/dist/resource-paths.js"() {
+    "use strict";
+  }
+});
+
+// ../packages/contract/dist/index.js
+var init_dist2 = __esm({
+  "../packages/contract/dist/index.js"() {
+    "use strict";
+    init_launch_variables();
+    init_resource_paths();
+  }
+});
+
 // src/pre-launch.ts
 function substitutePreLaunchVariables(commands, variables) {
   return commands.map(
@@ -13559,17 +13704,6 @@ function substituteLaunchEnvVars(envVars, variables) {
   }
   return resolved;
 }
-function resourcePaths(projectResources) {
-  if (!Array.isArray(projectResources)) return [];
-  const paths = [];
-  for (const entry of projectResources) {
-    if (entry && typeof entry === "object") {
-      const path27 = entry.path;
-      if (typeof path27 === "string" && path27.trim()) paths.push(path27.trim());
-    }
-  }
-  return paths;
-}
 function primaryResourcePath(projectResources) {
   if (!Array.isArray(projectResources)) return "";
   let currentPath = "";
@@ -13590,7 +13724,7 @@ function buildPreLaunchVariables({
   contextFile,
   tmpDir
 }) {
-  const paths = resourcePaths(projectResources);
+  const resourcePathsValue = formatProjectResourcePathsFromManifest(projectResources);
   const scratch = typeof tmpDir === "string" ? tmpDir.trim() : "";
   const cwd = typeof workingDirectory === "string" ? workingDirectory.trim() : "";
   const contextPath = typeof contextFile === "string" ? contextFile.trim() : "";
@@ -13600,8 +13734,8 @@ function buildPreLaunchVariables({
     OVERLORD_EXECUTION_REQUEST_ID: "",
     OVERLORD_PROJECT_RESOURCES: "",
     ...launchEnv,
-    OVERLORD_PROJECT_RESOURCES_PATHS: paths.join(" "),
-    OVERLORD_PROJECT_RESOURCES_PATHS_CSV: paths.join(","),
+    OVERLORD_PROJECT_RESOURCES_PATHS: resourcePathsValue,
+    OVERLORD_PROJECT_RESOURCES_PATHS_CSV: resourcePathsValue,
     OVERLORD_PRIMARY_RESOURCE_PATH: primaryResourcePath(projectResources),
     OVERLORD_WORKING_DIRECTORY: cwd,
     OVERLORD_CONTEXT_FILE: contextPath,
@@ -13615,6 +13749,7 @@ var PLACEHOLDER_PATTERN;
 var init_pre_launch = __esm({
   "src/pre-launch.ts"() {
     "use strict";
+    init_dist2();
     PLACEHOLDER_PATTERN = /\{([A-Z0-9_]+)\}/g;
   }
 });
@@ -16227,6 +16362,17 @@ __export(commands_exports, {
 import { existsSync as existsSync22, readFileSync as readFileSync17 } from "node:fs";
 import os5 from "node:os";
 import path26 from "node:path";
+function resourceAccessModeBody(value) {
+  if (typeof value !== "string") return {};
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "read" || normalized === "ro") return { accessMode: "read" };
+  if (normalized === "read_write" || normalized === "read-write" || normalized === "rw") {
+    return { accessMode: "read_write" };
+  }
+  throw new CliError({
+    message: `Invalid --access "${value}". Use "read" or "read_write".`
+  });
+}
 function writeProjectJsonFromResource({
   directory,
   projectId,
@@ -16234,6 +16380,7 @@ function writeProjectJsonFromResource({
 }) {
   const record = asRecord2(resource);
   if (typeof record.id !== "string") return;
+  if (record.accessMode === "read") return;
   writeProjectJson({
     directoryPath: directory,
     projectId,
@@ -16937,7 +17084,8 @@ async function runManagementCommand({
         body: {
           directoryPath: directory,
           ...resourceKey ? { resourceKey } : {},
-          isPrimary: flagValue(parsed.flags, "--primary") !== "false"
+          isPrimary: flagValue(parsed.flags, "--primary") !== "false",
+          ...resourceAccessModeBody(flagValue(parsed.flags, "--access"))
         }
       });
       writeProjectJsonFromResource({ directory, projectId, resource });
@@ -16955,7 +17103,8 @@ async function runManagementCommand({
         body: {
           sourceUrl,
           resourceKey: flagValue(parsed.flags, "--key"),
-          isPrimary: flagValue(parsed.flags, "--primary") !== "false"
+          isPrimary: flagValue(parsed.flags, "--primary") !== "false",
+          ...resourceAccessModeBody(flagValue(parsed.flags, "--access"))
         }
       });
       if (json) printJson({ resource });
@@ -17596,8 +17745,8 @@ var COMMAND_FLAGS = {
     "--no-input",
     "--if-needed"
   ],
-  "add-cwd": ["--directory", "--key", "--project-id", "--primary"],
-  "add-url": ["--url", "--project-id", "--key", "--primary"],
+  "add-cwd": ["--directory", "--key", "--project-id", "--primary", "--access"],
+  "add-url": ["--url", "--project-id", "--key", "--primary", "--access"],
   create: ["--objectives-json", "--objective", "--prompt", "--project-id", "--title", "--resource"],
   prompt: [
     "--objectives-json",
@@ -17726,9 +17875,9 @@ Organizations:
 
 Projects:
   ${primaryCommand} create-project --name "<name>" [--directory <path>|--no-directory]
-  ${primaryCommand} add-cwd [--directory <path>] [--project-id <id>] [--key <resourceKey>] [--primary true|false]
+  ${primaryCommand} add-cwd [--directory <path>] [--project-id <id>] [--key <resourceKey>] [--primary true|false] [--access read|read_write]
                                                  (prompts to pick a project when --project-id is omitted)
-  ${primaryCommand} add-url --url <git-url> --project-id <id> [--key <resourceKey>] [--primary true|false]
+  ${primaryCommand} add-url --url <git-url> --project-id <id> [--key <resourceKey>] [--primary true|false] [--access read|read_write]
 
 Missions:
   ${primaryCommand} create "<objective>" [--objectives-json '[...]'] [--json]