@zixt/host 0.0.56 → 0.0.58

package/dist/index.js

@@ -31,7 +31,7 @@ import { homedir } from "node:os";
 // package.json
 var package_default = {
   name: "@zixt/host",
-  version: "0.0.56",
+  version: "0.0.58",
   type: "module",
   exports: {
     ".": "./src/client.ts",
@@ -16232,6 +16232,68 @@ var TaskEventRecord = external_exports.object({
   attachments: external_exports.array(TaskAttachmentRef).max(TASK_MESSAGE_MAX_ATTACHMENTS).optional(),
   at: IsoDate
 });
+var TaskTimingPhaseKind = external_exports.enum([
+  /** Waiting for a Machine: queue, dispatch, and re-queue between runs. */
+  "queued",
+  /** Assigned to a Machine, session not started yet. */
+  "startup",
+  /** Preparing the environment: dependencies, folders, tools, services. */
+  "setup",
+  /** Reading, searching, and browsing to find things out. */
+  "research",
+  /** Doing the Task's actual work: edits, writes, configuration, other tools. */
+  "work",
+  /** Running checks: tests, builds, linters, verification. */
+  "validation",
+  /** Work that happened after checks had already started in the same run. */
+  "rework",
+  /** Reporting and handing off the result: messages, pull requests, files. */
+  "delivery",
+  /** Parked on a question or an approval a person owed. */
+  "awaiting_person",
+  /** Nothing was running: the Task sat between runs with no one waiting on it. */
+  "idle",
+  /** Measured time the Task's activity record cannot break down. */
+  "unattributed"
+]);
+var TaskTimingBasis = external_exports.enum(["measured", "estimated"]);
+var TaskTimingPhase = external_exports.object({
+  kind: TaskTimingPhaseKind,
+  durationMs: external_exports.number().int().min(0),
+  basis: TaskTimingBasis,
+  /** Activity steps behind an estimated phase; 0 for measured lifecycle phases. */
+  steps: external_exports.number().int().min(0)
+}).strict();
+var TaskTimingRun = external_exports.object({
+  epoch: external_exports.number().int().min(1),
+  status: TaskStatus,
+  startedAt: IsoDate.nullable(),
+  finishedAt: IsoDate.nullable(),
+  /** Waiting for this run's Machine, including re-queue after an earlier run. */
+  waitingMs: external_exports.number().int().min(0),
+  activeMs: external_exports.number().int().min(0),
+  unattributedMs: external_exports.number().int().min(0)
+}).strict();
+var TASK_TIMING_MAX_RUNS = 50;
+var TaskTimingBreakdown = external_exports.object({
+  schemaVersion: external_exports.literal(1),
+  from: IsoDate,
+  to: IsoDate,
+  totalElapsedMs: external_exports.number().int().min(0),
+  /** Time a Machine was running the Task, broken down or not. */
+  activeMs: external_exports.number().int().min(0),
+  /** Queue, startup, approval, and idle time: nothing was being worked on. */
+  waitingMs: external_exports.number().int().min(0),
+  /** Active time the activity record cannot name. */
+  unattributedMs: external_exports.number().int().min(0),
+  runCount: external_exports.number().int().min(0),
+  /** False while the Task can still accrue time; the breakdown is then a snapshot. */
+  settled: external_exports.boolean(),
+  /** True once at least one estimated phase carries time worth showing. */
+  attributed: external_exports.boolean(),
+  phases: external_exports.array(TaskTimingPhase),
+  runs: external_exports.array(TaskTimingRun).max(TASK_TIMING_MAX_RUNS)
+}).strict();
 var CreateTaskInput = external_exports.object({
   /** Stable client-generated key: retrying the same submission returns one Task. */
   requestId: external_exports.uuid().optional(),
@@ -16491,7 +16553,9 @@ var TaskDetailResponse = external_exports.object({
   reviewAuthorization: TaskReviewAuthorization,
   context: TaskResolvedContext,
   /** Newest host-observed folder/Git state; null until a current Host reports it. */
-  workingContext: TaskWorkingContext.nullable().default(null)
+  workingContext: TaskWorkingContext.nullable().default(null),
+  /** TS-19 timing breakdown; null when the Task has no usable timing evidence. */
+  timing: TaskTimingBreakdown.nullable().default(null)
 });
 var TaskSupportBundle = external_exports.object({
   schemaVersion: external_exports.literal(1),
@@ -34629,9 +34693,8 @@ async function pullRequestBaseRepositories(gitCommand, cwd, checkoutRepository,
   add(checkoutRepository);
   return repositories;
 }
-function parsePullRequest(output, expectedBaseRepository, expectedHeadRepository, expectedHeadBranch) {
+function parsePullRequest(value, expectedBaseRepository, expectedHeadRepository, expectedHeadBranch) {
   try {
-    const value = JSON.parse(output);
     const state = typeof value["state"] === "string" ? value["state"].toLowerCase() : "";
     const number4 = Number(value["number"]);
     const location = canonicalPullRequestLocation(value["url"], number4);
@@ -34654,10 +34717,41 @@ function parsePullRequest(output, expectedBaseRepository, expectedHeadRepository
     return void 0;
   }
 }
+var PULL_REQUEST_LIST_LIMIT = 20;
+var PULL_REQUEST_STATE_RANK = {
+  // A still-open pull request is the branch's current truth even when an
+  // earlier one from the same branch already merged; a closed one is the
+  // weakest evidence because it says only that somebody gave up on it.
+  open: 3,
+  merged: 2,
+  closed: 1
+};
+function selectPullRequest(output, expectedBaseRepository, expectedHeadRepository, expectedHeadBranch) {
+  let value;
+  try {
+    value = JSON.parse(output);
+  } catch {
+    return void 0;
+  }
+  if (!Array.isArray(value)) return void 0;
+  let best;
+  for (const entry of value.slice(0, PULL_REQUEST_LIST_LIMIT)) {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
+    const parsed = parsePullRequest(
+      entry,
+      expectedBaseRepository,
+      expectedHeadRepository,
+      expectedHeadBranch
+    );
+    if (!parsed) continue;
+    if (!best || PULL_REQUEST_STATE_RANK[parsed.state] > PULL_REQUEST_STATE_RANK[best.state] || PULL_REQUEST_STATE_RANK[parsed.state] === PULL_REQUEST_STATE_RANK[best.state] && parsed.number > best.number) {
+      best = parsed;
+    }
+  }
+  return best;
+}
 async function pullRequest(command, gitCommand, repositoryCwd, commandCwd, repository, branch, signal) {
   if (!command || !repository || !branch) return void 0;
-  const headOwner = repository.split("/")[0];
-  const selector = `${headOwner}:${branch}`;
   const baseRepositories = await pullRequestBaseRepositories(
     gitCommand,
     repositoryCwd,
@@ -34670,10 +34764,15 @@ async function pullRequest(command, gitCommand, repositoryCwd, commandCwd, repos
       [
         ...command.prefixArgs ?? [],
         "pr",
-        "view",
-        selector,
+        "list",
         "--repo",
         baseRepository,
+        "--head",
+        branch,
+        "--state",
+        "all",
+        "--limit",
+        String(PULL_REQUEST_LIST_LIMIT),
         "--json",
         "number,title,url,state,isDraft,baseRefName,headRefName,headRepository,headRepositoryOwner"
       ],
@@ -34682,7 +34781,7 @@ async function pullRequest(command, gitCommand, repositoryCwd, commandCwd, repos
       signal
     );
     if (!output) continue;
-    const parsed = parsePullRequest(output, baseRepository, repository, branch);
+    const parsed = selectPullRequest(output, baseRepository, repository, branch);
     if (parsed) return parsed;
   }
   return void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zixt/host",
-  "version": "0.0.56",
+  "version": "0.0.58",
   "type": "module",
   "exports": {
     ".": "./src/client.ts",