@oxagen/cli 3.0.1-712 → 3.0.1-715

package/oxagen.mjs

@@ -29810,7 +29810,7 @@ import { readFileSync as readFileSync10 } from "node:fs";
 import { dirname as dirname9, resolve as resolve3 } from "node:path";
 import { fileURLToPath } from "node:url";
 function readVersion() {
-  if (true) return "3.0.1-712";
+  if (true) return "3.0.1-715";
   try {
     const here = dirname9(fileURLToPath(import.meta.url));
     const pkg = JSON.parse(
@@ -72708,7 +72708,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@oxagen/cli",
-      version: "3.0.1-712",
+      version: "3.0.1-715",
       description: "Oxagen governance CLI: spend, source tracking, grounding, credentials, and audit (agentic coding lives in the stella CLI)",
       type: "module",
       main: "./dist/index.js",
@@ -93033,7 +93033,9 @@ __export(src_exports, {
   HARNESS_RENDERERS: () => HARNESS_RENDERERS,
   HOOK_TIMEOUT_SECONDS: () => HOOK_TIMEOUT_SECONDS,
   INSTALLABLE: () => INSTALLABLE,
+  LOCAL_SETTINGS_FILE: () => LOCAL_SETTINGS_FILE,
   PROJECT_DIR_NAME: () => PROJECT_DIR_NAME,
+  PROJECT_SETTINGS_FILE: () => PROJECT_SETTINGS_FILE,
   checkSteeringFreshness: () => checkSteeringFreshness,
   evaluateGate: () => evaluateGate,
   execGit: () => execGit,
@@ -94165,6 +94167,7 @@ __export(steering_exports, {
 });
 import { execFileSync } from "node:child_process";
 import { existsSync as existsSync32, realpathSync as realpathSync12 } from "node:fs";
+import { homedir as homedir14 } from "node:os";
 import {
   dirname as dirname40,
   join as join73,
@@ -94181,16 +94184,25 @@ function locateProject(start, timeoutMs = 5e3) {
   const gitRoot = rawGitRoot === null ? null : realpathOr2(rawGitRoot);
   const from = realpathOr2(start);
   if (gitRoot !== null) return { root: gitRoot, insideGit: true };
+  const home = realpathOr2(homedir14());
   let dir = from;
   for (; ; ) {
-    if (existsSync32(join73(dir, PROJECT_DIR_NAME)))
-      return { root: dir, insideGit: false };
-    if (dir === root) return { root: from, insideGit: false };
+    if (hasProjectSteering(dir, home)) return { root: dir, insideGit: false };
+    if (dir === home || dir === root) return { root: from, insideGit: false };
     const parent = dirname40(dir);
     if (parent === dir) return { root: from, insideGit: false };
     dir = parent;
   }
 }
+function hasProjectSteering(root, home = realpathOr2(homedir14())) {
+  if (!existsSync32(join73(root, PROJECT_DIR_NAME))) return false;
+  if (root !== home) return true;
+  return [
+    workspaceLinkPath(root),
+    join73(root, PROJECT_DIR_NAME, PROJECT_SETTINGS_FILE),
+    join73(root, PROJECT_DIR_NAME, LOCAL_SETTINGS_FILE)
+  ].some((path2) => existsSync32(path2));
+}
 function realpathOr2(path2) {
   try {
     return realpathSync12(path2);
@@ -94710,7 +94722,7 @@ async function steeringGate(opts = {}, writer = stdoutWriter, cwd = process.cwd(
   const allowNetwork = opts.network !== false;
   const budget = budgetFrom(HOOK_PATH_BUDGET_MS);
   const location = locateProject(cwd, Math.min(5e3, budget.remaining()));
-  if (!existsSync32(join73(location.root, PROJECT_DIR_NAME)) && !location.insideGit && !budget.expired()) {
+  if (!hasProjectSteering(location.root) && !location.insideGit && !budget.expired()) {
     process.exitCode = 0;
     return;
   }
@@ -94845,7 +94857,7 @@ var init_steering_record_label = __esm({
 });
 
 // ../../packages/oxagen/src/contracts/run.shared.ts
-var IN_APP_AGENT_SURFACES, RUN_PUBLIC_ID_BODY, RUN_PUBLIC_ID_REGEX, MODEL_CLASS_REPLAY_SURFACE, RUN_STATUSES, TACHO_SESSION_SURFACES, LATEST_ACTIVITY_MESSAGES, LATEST_ACTIVITY_TEXT_MAX;
+var IN_APP_AGENT_SURFACES, RUN_PUBLIC_ID_BODY, RUN_PUBLIC_ID_REGEX, MODEL_CLASS_REPLAY_SURFACE, RUN_STATUSES, RUN_STATES, TACHO_SESSION_SURFACES, LATEST_ACTIVITY_MESSAGES, LATEST_ACTIVITY_TEXT_MAX;
 var init_run_shared = __esm({
   "../../packages/oxagen/src/contracts/run.shared.ts"() {
     "use strict";
@@ -94854,6 +94866,14 @@ var init_run_shared = __esm({
     RUN_PUBLIC_ID_REGEX = new RegExp(`^${RUN_PUBLIC_ID_BODY}$`);
     MODEL_CLASS_REPLAY_SURFACE = "model_class_replay";
     RUN_STATUSES = ["live", "sealed", "halted"];
+    RUN_STATES = [
+      "live",
+      "parked",
+      "paused",
+      "ended",
+      "failed",
+      "halted"
+    ];
     TACHO_SESSION_SURFACES = [
       ...IN_APP_AGENT_SURFACES,
       MODEL_CLASS_REPLAY_SURFACE
@@ -104076,7 +104096,7 @@ var init_kinds_shared = __esm({
 });
 
 // ../../packages/oxagen/src/contracts/run.list.ts
-var runPublicIdSchema, frameSeqSchema, runStatusSchema, runOutcomeSchema, runCostSchema, replayGradeSchema, generatedRunSummarySchema, editedRunSummarySchema, runSummarySchema, latestActivitySchema, operatorKindSchema, RUN_OPERATOR_ROLES, runOperatorRoleSchema, runModelSchema, runMachineSnapshotSchema, runMachineSchema, runSandboxSchema, COMMAND_BLOCKS, HOST_POLL_WINDOW_MS, RUN_PULL_REQUEST_MAX, runPullRequestSchema, runDiffSchema, runAttributionSchema, RUN_PULL_REQUEST_FILTERS, RUN_PAUSE_STATES, runPauseSchema, RUN_REPLAY_FILTERS, RUN_SORT_KEYS, RUN_LIST_TOTAL_BOUND, RUN_LABEL_MAX, runWorkOrderRefSchema, runKindSchema, runItemSchema, runList;
+var runPublicIdSchema, frameSeqSchema, runStatusSchema, runStateSchema, RUN_LIST_KINDS_MAX, runOutcomeSchema, runCostSchema, replayGradeSchema, generatedRunSummarySchema, editedRunSummarySchema, runSummarySchema, latestActivitySchema, operatorKindSchema, RUN_OPERATOR_ROLES, runOperatorRoleSchema, runModelSchema, runMachineSnapshotSchema, runMachineSchema, runSandboxSchema, COMMAND_BLOCKS, HOST_POLL_WINDOW_MS, RUN_PULL_REQUEST_MAX, runPullRequestSchema, runDiffSchema, runAttributionSchema, RUN_PULL_REQUEST_FILTERS, RUN_PAUSE_STATES, runPauseSchema, RUN_REPLAY_FILTERS, RUN_SORT_KEYS, RUN_LIST_TOTAL_BOUND, RUN_LABEL_MAX, runWorkOrderRefSchema, runKindSchema, runItemSchema, runList;
 var init_run_list = __esm({
   "../../packages/oxagen/src/contracts/run.list.ts"() {
     "use strict";
@@ -104093,6 +104113,8 @@ var init_run_list = __esm({
     runPublicIdSchema = external_exports.string().regex(RUN_PUBLIC_ID_REGEX, "a run public id (arun_\u2026 or tse_\u2026)");
     frameSeqSchema = external_exports.string().regex(/^\d{1,19}$/, "a frame sequence (up to 19 decimal digits)");
     runStatusSchema = external_exports.enum(RUN_STATUSES);
+    runStateSchema = external_exports.enum(RUN_STATES);
+    RUN_LIST_KINDS_MAX = 50;
     runOutcomeSchema = external_exports.enum([
       "running",
       "completed",
@@ -104362,6 +104384,12 @@ var init_run_list = __esm({
        */
       operatorRole: runOperatorRoleSchema.nullable(),
       status: runStatusSchema,
+      /**
+       * The run's state in `RUN_STATES`: the lifecycle split by the pause in
+       * force and a pending approval, the rule the `state` filter lists by.
+       * Absent where the reader did not read both.
+       */
+      state: runStateSchema.optional(),
       outcome: runOutcomeSchema,
       /** Distinct turns; null when the store could not count them. */
       turns: external_exports.number().int().nonnegative().nullable(),
@@ -104406,6 +104434,17 @@ var init_run_list = __esm({
        * could not read the workspace's run kinds.
        */
       kind: runKindSchema.optional(),
+      /**
+       * How much work the run links, for a list that shows the counts before
+       * a person opens the run: the pull requests the run's change set links
+       * (`forge.pull_request_runs`, #5949), and the work items `get_run_work`
+       * lists for it. `list_runs` answers it when the input sets `linkedWork`,
+       * and leaves it out when the counts could not be read.
+       */
+      linkedWork: external_exports.object({
+        pullRequests: external_exports.number().int().nonnegative(),
+        workItems: external_exports.number().int().nonnegative()
+      }).strict().optional(),
       /** RFC 3339. */
       startedAt: external_exports.string().datetime(),
       /**
@@ -104646,7 +104685,7 @@ var init_run_list = __esm({
     runList = registerCapability({
       name: "list_runs",
       domain: "run",
-      description: "List the runs recorded in this workspace, newest first: root sessions in one cursor-paged list, with the operator, the model, the machine, status, counts and metered cost each row recorded. The in-app assistant's turns are listed too, marked inApp; they take no run commands. Given own, it lists only the runs the caller operated.",
+      description: "List the runs recorded in this workspace, newest first: root sessions in one cursor-paged list, with the operator, the model, the machine, status, counts and metered cost each row recorded. The in-app assistant's turns are listed too, marked inApp; they take no run commands. Given own, it lists only the runs the caller operated. Given state or kind, it lists only the runs in those states or of those kinds, and given linkedWork, each row counts the pull requests and work items it links.",
       mode: "sync",
       surfaces: ["api", "mcp", "agent", "cli"],
       layers: ["schema", "api", "mcp", "cli", "unit", "docs", "app"],
@@ -104679,6 +104718,19 @@ var init_run_list = __esm({
          */
         /** Only runs in these statuses. Absent lists every status. */
         status: external_exports.array(runStatusSchema).min(1).max(3).optional(),
+        /**
+         * Only runs in these states (`RUN_STATES`): the lifecycle split into
+         * live, parked, paused, ended, failed and halted. Sent with `status`, a
+         * run must match both. Absent lists every state.
+         */
+        state: external_exports.array(runStateSchema).min(1).max(RUN_STATES.length).optional(),
+        /**
+         * Only runs whose kind in force is one of these, by the kind's id in
+         * the workspace's run kinds (`list_kinds`). The kind in force is a
+         * person's pick, else the classifier's, else Unknown, so Unknown's id
+         * also lists every run no one classified. Absent lists every kind.
+         */
+        kind: external_exports.array(kindIdSchema).min(1).max(RUN_LIST_KINDS_MAX).optional(),
         /** Only runs published at these tiers. */
         tier: external_exports.array(external_exports.enum(GRADE_ENFORCEMENT_TIERS)).min(1).max(4).optional(),
         /** Only runs with these grades; `not_recorded` matches a null grade. */
@@ -104729,7 +104781,13 @@ var init_run_list = __esm({
          * every root session the workspace holds, so a read that does not show
          * it leaves this out and pays nothing for it. Runs sets it.
          */
-        countLive: external_exports.boolean().optional()
+        countLive: external_exports.boolean().optional(),
+        /**
+         * `true` answers each row's `linkedWork`: how many pull requests and
+         * work items the run links. Two indexed reads a page, so a caller that
+         * shows no counts leaves it off.
+         */
+        linkedWork: external_exports.boolean().optional()
       }).strict(),
       output: external_exports.object({
         runs: external_exports.array(runItemSchema).max(100),
@@ -108721,13 +108779,13 @@ __export(steering_import_exports, {
   harnessHome: () => harnessHome
 });
 import { readdir as readdir5, realpath as realpath3, stat as stat5 } from "node:fs/promises";
-import { homedir as homedir14 } from "node:os";
+import { homedir as homedir15 } from "node:os";
 import { basename as basename11, extname, join as join75, relative as relative10, sep as sep13 } from "node:path";
 function envDir2(env, key) {
   const value = env[key];
   return value === void 0 || value.trim() === "" ? null : value;
 }
-function harnessHome(harness, env = process.env, home = homedir14()) {
+function harnessHome(harness, env = process.env, home = homedir15()) {
   switch (harness) {
     case "claude-code": {
       const config2 = envDir2(env, "CLAUDE_CONFIG_DIR") ?? join75(home, ".claude");
@@ -108955,7 +109013,7 @@ function parseTarget(value, writer) {
     writer
   );
 }
-async function handleSteeringImport(paths, opts, writer = stdoutWriter, env = process.env, home = homedir14()) {
+async function handleSteeringImport(paths, opts, writer = stdoutWriter, env = process.env, home = homedir15()) {
   const harness = parseHarness(opts.harness, writer);
   if (paths.length === 0 && harness === void 0) {
     failCommand(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxagen/cli",
-  "version": "3.0.1-712",
+  "version": "3.0.1-715",
   "description": "Oxagen governance CLI: spend, source tracking, grounding, credentials, and audit (agentic coding lives in the stella CLI)",
   "type": "module",
   "bin": {