@zixt/host 0.0.60 → 0.0.62

package/dist/index.js

@@ -31,7 +31,7 @@ import { homedir } from "node:os";
 // package.json
 var package_default = {
   name: "@zixt/host",
-  version: "0.0.60",
+  version: "0.0.62",
   type: "module",
   exports: {
     ".": "./src/client.ts",
@@ -16152,6 +16152,7 @@ var taskGitSummaryLabel = (maxLength, label) => external_exports.string().min(1)
   isSafeSingleLineDisplayText,
   `${label} must not contain control, line-separator, or bidirectional formatting characters`
 );
+var PullRequestLookup = external_exports.enum(["observed", "unavailable"]);
 var TaskGitSummary = external_exports.object({
   repositories: external_exports.array(
     external_exports.object({
@@ -16166,6 +16167,12 @@ var TaskGitSummary = external_exports.object({
       ahead: external_exports.number().int().min(0),
       behind: external_exports.number().int().min(0),
       changedFiles: external_exports.number().int().min(0),
+      /**
+       * Whether Zixt could actually ask GitHub about this branch.
+       * Absent is a Host that never reported it, which is also "Zixt
+       * does not know" — never evidence that no pull request exists.
+       */
+      pullRequestLookup: PullRequestLookup.optional(),
       pullRequest: external_exports.object({
         number: external_exports.number().int().min(1),
         url: external_exports.string().max(2e3).regex(
@@ -16318,9 +16325,14 @@ var TaskProgressStep = external_exports.object({
   kind: TaskTimingPhaseKind,
   state: TaskProgressStepState,
   /** Time spent in this step so far; 0 for pending and skipped steps. */
-  durationMs: external_exports.number().int().min(0)
+  durationMs: external_exports.number().int().min(0),
+  /**
+   * What comparable finished Tasks spent here, from their recorded shares
+   * rather than an even split across steps. 0 when no cohort supports one.
+   */
+  expectedMs: external_exports.number().int().min(0)
 }).strict();
-var TaskProgressBasis = external_exports.enum(["none", "steps", "history"]);
+var TaskProgressBasis = external_exports.enum(["none", "steps", "history", "phase_history"]);
 var TaskProgressConfidence = external_exports.enum(["none", "low", "medium"]);
 var TaskProgressCaveat = external_exports.enum([
   /** A person owes an answer or a decision; nothing is running. */
@@ -16338,14 +16350,27 @@ var TaskProgressCaveat = external_exports.enum([
   /** No comparable finished Task exists, so no time can be predicted at all. */
   "no_history"
 ]);
+var TaskProgressSampleScope = external_exports.enum([
+  /** Same teammate, same repository, similar size of request. */
+  "agent_repository_size",
+  /** Same teammate, same repository. */
+  "agent_repository",
+  /** Same teammate, any work. */
+  "agent",
+  /** Anyone in the organization. */
+  "organization"
+]);
 var TaskProgressSample = external_exports.object({
   size: external_exports.number().int().min(1),
-  /** `agent` compares the same teammate; `organization` widens when it must. */
-  scope: external_exports.enum(["agent", "organization"]),
+  scope: TaskProgressSampleScope,
+  /** One in five comparable Tasks finished their work within this. */
+  p20Ms: external_exports.number().int().min(0).default(0),
   /** Middle working time of the sample. */
   medianMs: external_exports.number().int().min(0),
   /** Four in five comparable Tasks finished their work within this. */
-  p80Ms: external_exports.number().int().min(0)
+  p80Ms: external_exports.number().int().min(0),
+  /** Newest observation in the cohort; the estimate ages with its evidence. */
+  newestAt: IsoDate.nullable().default(null)
 }).strict();
 var TaskProgressEstimate = external_exports.object({
   schemaVersion: external_exports.literal(1),
@@ -16537,6 +16562,12 @@ var TaskWorkingContextBase = external_exports.object({
       changedFiles: external_exports.number().int().min(0),
       /** Present only for a safely parsed github.com remote. */
       githubRepository: GithubRepositoryName.optional(),
+      /**
+       * Whether the authenticated branch read reached GitHub at all.
+       * Absence of a pull request only means "there is none" when this
+       * says `observed`.
+       */
+      pullRequestLookup: PullRequestLookup.optional(),
       /** Present only when GitHub associates this exact branch with a PR. */
       pullRequest: external_exports.object({
         number: external_exports.number().int().min(1),
@@ -34818,9 +34849,9 @@ function selectPullRequest(output, expectedBaseRepository, expectedHeadRepositor
   try {
     value = JSON.parse(output);
   } catch {
-    return void 0;
+    return { lookup: "unavailable" };
   }
-  if (!Array.isArray(value)) return void 0;
+  if (!Array.isArray(value)) return { lookup: "unavailable" };
   let best;
   for (const entry of value.slice(0, PULL_REQUEST_LIST_LIMIT)) {
     if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
@@ -34835,16 +34866,17 @@ function selectPullRequest(output, expectedBaseRepository, expectedHeadRepositor
       best = parsed;
     }
   }
-  return best;
+  return { lookup: "observed", ...best ? { pullRequest: best } : {} };
 }
 async function pullRequest(command, gitCommand, repositoryCwd, commandCwd, repository, branch, signal) {
-  if (!command || !repository || !branch) return void 0;
+  if (!command || !repository || !branch) return { lookup: "unavailable" };
   const baseRepositories = await pullRequestBaseRepositories(
     gitCommand,
     repositoryCwd,
     repository,
     signal
   );
+  let answered = false;
   for (const baseRepository of baseRepositories) {
     const output = await run(
       command.executablePath,
@@ -34868,10 +34900,11 @@ async function pullRequest(command, gitCommand, repositoryCwd, commandCwd, repos
       signal
     );
     if (!output) continue;
-    const parsed = selectPullRequest(output, baseRepository, repository, branch);
-    if (parsed) return parsed;
+    const observation = selectPullRequest(output, baseRepository, repository, branch);
+    if (observation.lookup === "observed") answered = true;
+    if (observation.pullRequest) return observation;
   }
-  return void 0;
+  return { lookup: answered ? "observed" : "unavailable" };
 }
 async function repositoryState(directory, git, env, signal) {
   if (!git.available || !git.executablePath) return null;
@@ -35016,9 +35049,10 @@ var WorkingContextPullRequestCache = class {
   }
   #entries = /* @__PURE__ */ new Map();
   async enrich(context, command, options = {}) {
-    if (!command || !context.repositories || context.repositories.length === 0) return context;
+    if (!context.repositories || context.repositories.length === 0) return context;
     const repositories = await Promise.all(
       context.repositories.map(async (repository) => {
+        if (!command) return { ...repository, pullRequestLookup: "unavailable" };
         if (!repository.githubRepository || !repository.branch) return repository;
         const key = JSON.stringify([
           repository.githubRepository.toLocaleLowerCase("en-US"),
@@ -35026,7 +35060,7 @@ var WorkingContextPullRequestCache = class {
           repository.headSha
         ]);
         const cached2 = this.#entries.get(key);
-        let observed = cached2?.pullRequest;
+        let observed = cached2?.observation ?? { lookup: "unavailable" };
         if (options.force || !cached2 || this.now() - cached2.checkedAt >= this.ttlMs) {
           observed = await pullRequest(
             command,
@@ -35039,7 +35073,7 @@ var WorkingContextPullRequestCache = class {
           );
           if (!options.signal?.aborted) {
             this.#entries.delete(key);
-            this.#entries.set(key, { checkedAt: this.now(), pullRequest: observed });
+            this.#entries.set(key, { checkedAt: this.now(), observation: observed });
             while (this.#entries.size > Math.max(1, this.maxEntries)) {
               const oldest = this.#entries.keys().next().value;
               if (oldest === void 0) break;
@@ -35047,7 +35081,14 @@ var WorkingContextPullRequestCache = class {
             }
           }
         }
-        return observed ? { ...repository, pullRequest: observed } : repository;
+        if (observed.lookup === "unavailable") {
+          return repository.pullRequest || repository.pullRequestLookup === "observed" ? repository : { ...repository, pullRequestLookup: "unavailable" };
+        }
+        return {
+          ...repository,
+          pullRequestLookup: observed.lookup,
+          ...observed.pullRequest ? { pullRequest: observed.pullRequest } : {}
+        };
       })
     );
     return TaskWorkingContextObservation.parse({ ...context, repositories });

package/package.json

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