empirical-sdd 0.26.0 → 0.26.1

package/CHANGELOG.md

@@ -8,6 +8,16 @@ under the alpha rules in [docs/versioning.md](docs/versioning.md).
 
 ## [Unreleased]
 
+## [0.26.1] - 2026-08-21
+
+### Fixed
+
+- Made `empirical update` invoke and verify the CLI installed under npm's actual
+  global prefix, then fail with actionable diagnostics when an older Empirical
+  installation still shadows it through `PATH`.
+- Bounded Linear team discovery pages so the nested project and workflow-state
+  connections stay below Linear's GraphQL query-complexity limit.
+
 ## [0.26.0] - 2026-08-20
 
 ### Added
@@ -183,7 +193,8 @@ Published through GitHub Actions trusted publishing with npm provenance.
 
 - Prepared and released package version `0.20.2`.
 
-[Unreleased]: https://github.com/goempirical/empirical-sdd/compare/v0.26.0...HEAD
+[Unreleased]: https://github.com/goempirical/empirical-sdd/compare/v0.26.1...HEAD
+[0.26.1]: https://github.com/goempirical/empirical-sdd/compare/v0.26.0...v0.26.1
 [0.26.0]: https://github.com/goempirical/empirical-sdd/compare/v0.25.0...v0.26.0
 [0.25.0]: https://github.com/goempirical/empirical-sdd/compare/v0.24.1...v0.25.0
 [0.24.1]: https://github.com/goempirical/empirical-sdd/compare/v0.24.0...v0.24.1

package/dist/cli.js

@@ -14862,7 +14862,7 @@ function verifyReceiptDigest(receipt) {
     throw new Error(`Evidence receipt ${parsed.id} has an asserted result inconsistent with its provenance.`);
   }
 }
-var SCHEMA_VERSION = 5, POLICY_SCHEMA_VERSION = 2, MANIFEST_SCHEMA_VERSION = 2, RECEIPT_SCHEMA_VERSION = 1, PRODUCT_VERSION = "0.26.0", workflowSchema, executionModeSchema, riskFloorSchema, completionLevelSchema, phaseSchema, workflowStatusSchema, criterionSchema, evidenceKindSchema, commandPolicySchema, evidencePolicySchema, projectPolicySchema, impactManifestSchema, authorizationSchema, COMPLETION_ORDER, receiptProvenanceSchema, receiptBaseSchema, executedReceiptSchema, artifactRecordSchema, collectedReceiptSchema, evidenceReceiptSchema;
+var SCHEMA_VERSION = 5, POLICY_SCHEMA_VERSION = 2, MANIFEST_SCHEMA_VERSION = 2, RECEIPT_SCHEMA_VERSION = 1, PRODUCT_VERSION = "0.26.1", workflowSchema, executionModeSchema, riskFloorSchema, completionLevelSchema, phaseSchema, workflowStatusSchema, criterionSchema, evidenceKindSchema, commandPolicySchema, evidencePolicySchema, projectPolicySchema, impactManifestSchema, authorizationSchema, COMPLETION_ORDER, receiptProvenanceSchema, receiptBaseSchema, executedReceiptSchema, artifactRecordSchema, collectedReceiptSchema, evidenceReceiptSchema;
 var init_protocol = __esm(() => {
   init_zod();
   workflowSchema = exports_external.enum(["fast", "complex"]);
@@ -37279,6 +37279,7 @@ var TRACKER_PROGRESS_STATES = [
   "done"
 ];
 var TRACKER_DISCOVERY_LIMIT = 100;
+var LINEAR_TEAM_DISCOVERY_PAGE_SIZE = 10;
 var TRACKER_ARTIFACT_MAX_COUNT = 10;
 var TRACKER_ARTIFACT_MAX_BYTES = 5 * 1024 * 1024;
 var TRACKER_ARTIFACT_TOTAL_BYTES = 10 * 1024 * 1024;
@@ -39247,9 +39248,9 @@ async function discoverLinearResources(authorization, dependencies) {
   let after = null;
   const cursors = new Set;
   for (let page = 0;page < TRACKER_DISCOVERY_LIMIT; page += 1) {
-    const data = await linearGraphql(`query EmpiricalTrackerDiscovery($after: String) {
+    const data = await linearGraphql(`query EmpiricalTrackerDiscovery($after: String, $teamFirst: Int!) {
         organization { id name urlKey }
-        teams(first: 100, after: $after) {
+        teams(first: $teamFirst, after: $after) {
           nodes {
             id name key
             projects(first: 100) { nodes { id name url } pageInfo { hasNextPage endCursor } }
@@ -39257,7 +39258,7 @@ async function discoverLinearResources(authorization, dependencies) {
           }
           pageInfo { hasNextPage endCursor }
         }
-      }`, { after }, authorization, dependencies);
+      }`, { after, teamFirst: LINEAR_TEAM_DISCOVERY_PAGE_SIZE }, authorization, dependencies);
     const organizationValue = data.organization ?? (typeof data.viewer === "object" && data.viewer !== null && !Array.isArray(data.viewer) ? data.viewer.organization : undefined);
     const organization = record4(organizationValue, "Linear organization");
     const workspaceId = requiredString(organization, "id", "Linear workspace id");
@@ -44197,15 +44198,38 @@ function normalizeColumns(columns) {
 
 // src/lifecycle.ts
 import { spawnSync as spawnSync6 } from "node:child_process";
-function updateEmpirical(runner = runInherited) {
-  const npm = process.platform === "win32" ? "npm.cmd" : "npm";
-  const empirical = process.platform === "win32" ? "empirical.cmd" : "empirical";
+import { posix as posix2, win32 as win322 } from "node:path";
+function updateEmpirical(runner = runInherited, platform = process.platform) {
+  const npm = platform === "win32" ? "npm.cmd" : "npm";
+  const empirical = platform === "win32" ? "empirical.cmd" : "empirical";
+  const latestResult = runner(npm, ["view", "empirical-sdd@latest", "version", "--json"], { capture: true });
+  assertStage(latestResult, "UPDATE_LATEST_VERSION_FAILED", "npm latest-version lookup");
+  const expectedVersion = parseNpmVersion(latestResult.stdout);
   const packageResult = runner(npm, ["install", "-g", "empirical-sdd@latest"]);
   assertStage(packageResult, "UPDATE_PACKAGE_FAILED", "npm package update");
-  const integrationResult = runner(empirical, ["install", "--yes"]);
+  const prefixResult = runner(npm, ["prefix", "--global"], { capture: true });
+  assertStage(prefixResult, "UPDATE_PREFIX_FAILED", "npm global-prefix discovery");
+  const prefix = parseGlobalPrefix(prefixResult.stdout, platform);
+  const installedEmpirical = resolveGlobalEmpirical(prefix, platform);
+  const installedVersionResult = runner(installedEmpirical, ["--version"], { capture: true });
+  assertStage(installedVersionResult, "UPDATE_INSTALLED_VERSION_FAILED", "npm-installed CLI verification");
+  const installedVersion = parseCliVersion(installedVersionResult.stdout, "npm-installed CLI");
+  if (installedVersion !== expectedVersion) {
+    throw new EmpiricalError("UPDATE_INSTALLED_VERSION_MISMATCH", `npm-installed CLI version mismatch: expected ${expectedVersion}, observed ${installedVersion} at ${installedEmpirical}. Retry empirical update after checking npm's registry and global prefix.`);
+  }
+  const integrationResult = runner(installedEmpirical, ["install", "--yes"]);
   assertStage(integrationResult, "UPDATE_INTEGRATIONS_FAILED", "agent integration refresh");
+  const pathVersionResult = runner(empirical, ["--version"], { capture: true });
+  assertStage(pathVersionResult, "UPDATE_PATH_VERSION_FAILED", "PATH-visible CLI verification", pathRemediation(prefix, installedEmpirical, platform));
+  const pathVersion = parseCliVersion(pathVersionResult.stdout, "PATH-visible CLI");
+  if (pathVersion !== expectedVersion) {
+    throw new EmpiricalError("UPDATE_PATH_SHADOWED", `PATH-visible empirical version mismatch: expected ${expectedVersion}, observed ${pathVersion}. npm installed the current CLI at ${installedEmpirical}, but another installation is shadowing it. ${pathRemediation(prefix, installedEmpirical, platform)}`);
+  }
   return { package: "updated", integrations: "refreshed" };
 }
+function resolveGlobalEmpirical(prefix, platform) {
+  return platform === "win32" ? win322.join(prefix, "empirical.cmd") : posix2.join(prefix, "bin", "empirical");
+}
 function uninstallEmpirical(runner = runInherited) {
   const npm = process.platform === "win32" ? "npm.cmd" : "npm";
   const result = runner(npm, ["uninstall", "-g", "empirical-sdd"]);
@@ -44215,9 +44239,55 @@ function uninstallEmpirical(runner = runInherited) {
 function isUninstallConfirmed(answer) {
   return /^(?:y|yes)$/i.test(answer.trim());
 }
-function runInherited(command, args) {
-  const result = spawnSync6(command, args, { stdio: "inherit", shell: false });
-  return { status: result.status, ...result.error ? { error: result.error } : {} };
+function runInherited(command, args, options = {}) {
+  const result = options.capture ? spawnSync6(command, args, { encoding: "utf8", stdio: ["inherit", "pipe", "pipe"], shell: false }) : spawnSync6(command, args, { stdio: "inherit", shell: false });
+  return {
+    status: result.status,
+    ...result.error ? { error: result.error } : {},
+    ...typeof result.stdout === "string" ? { stdout: result.stdout } : {}
+  };
+}
+function parseNpmVersion(stdout) {
+  const output = requiredOutput(stdout, "npm latest-version lookup");
+  let parsed;
+  try {
+    parsed = JSON.parse(output);
+  } catch {
+    throw new EmpiricalError("UPDATE_LATEST_VERSION_INVALID", "npm latest-version lookup returned malformed JSON");
+  }
+  if (typeof parsed !== "string" || !isVersion(parsed)) {
+    throw new EmpiricalError("UPDATE_LATEST_VERSION_INVALID", "npm latest-version lookup did not return one semantic version");
+  }
+  return parsed;
+}
+function parseGlobalPrefix(stdout, platform) {
+  const prefix = requiredOutput(stdout, "npm global-prefix discovery");
+  const absolute = platform === "win32" ? win322.isAbsolute(prefix) : posix2.isAbsolute(prefix);
+  if (!absolute || /[\r\n]/u.test(prefix)) {
+    throw new EmpiricalError("UPDATE_PREFIX_INVALID", "npm global-prefix discovery did not return one absolute path");
+  }
+  return prefix;
+}
+function parseCliVersion(stdout, stage) {
+  const version2 = requiredOutput(stdout, stage);
+  if (!isVersion(version2)) {
+    throw new EmpiricalError("UPDATE_CLI_VERSION_INVALID", `${stage} did not return one semantic version`);
+  }
+  return version2;
+}
+function requiredOutput(stdout, stage) {
+  const output = stdout?.trim();
+  if (!output)
+    throw new EmpiricalError("UPDATE_OUTPUT_MISSING", `${stage} returned no output`);
+  return output;
+}
+function isVersion(value) {
+  return /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/u.test(value);
+}
+function pathRemediation(prefix, installedEmpirical, platform) {
+  const inspect = platform === "win32" ? "where empirical" : "type -a empirical";
+  const bin = platform === "win32" ? prefix : posix2.join(prefix, "bin");
+  return `Run '${inspect}' and place ${bin} before the older Empirical entry in PATH. The npm-installed executable is ${installedEmpirical}.`;
 }
 function assertStage(result, code, stage, remediation) {
   if (!result.error && result.status === 0)

package/dist/demo-integration-repair.js

@@ -14861,7 +14861,7 @@ function verifyReceiptDigest(receipt) {
     throw new Error(`Evidence receipt ${parsed.id} has an asserted result inconsistent with its provenance.`);
   }
 }
-var SCHEMA_VERSION = 5, POLICY_SCHEMA_VERSION = 2, MANIFEST_SCHEMA_VERSION = 2, RECEIPT_SCHEMA_VERSION = 1, PRODUCT_VERSION = "0.26.0", workflowSchema, executionModeSchema, riskFloorSchema, completionLevelSchema, phaseSchema, workflowStatusSchema, criterionSchema, evidenceKindSchema, commandPolicySchema, evidencePolicySchema, projectPolicySchema, impactManifestSchema, authorizationSchema, COMPLETION_ORDER, receiptProvenanceSchema, receiptBaseSchema, executedReceiptSchema, artifactRecordSchema, collectedReceiptSchema, evidenceReceiptSchema;
+var SCHEMA_VERSION = 5, POLICY_SCHEMA_VERSION = 2, MANIFEST_SCHEMA_VERSION = 2, RECEIPT_SCHEMA_VERSION = 1, PRODUCT_VERSION = "0.26.1", workflowSchema, executionModeSchema, riskFloorSchema, completionLevelSchema, phaseSchema, workflowStatusSchema, criterionSchema, evidenceKindSchema, commandPolicySchema, evidencePolicySchema, projectPolicySchema, impactManifestSchema, authorizationSchema, COMPLETION_ORDER, receiptProvenanceSchema, receiptBaseSchema, executedReceiptSchema, artifactRecordSchema, collectedReceiptSchema, evidenceReceiptSchema;
 var init_protocol = __esm(() => {
   init_zod();
   workflowSchema = exports_external.enum(["fast", "complex"]);
@@ -22323,6 +22323,7 @@ var TRACKER_PROGRESS_STATES = [
   "done"
 ];
 var TRACKER_DISCOVERY_LIMIT = 100;
+var LINEAR_TEAM_DISCOVERY_PAGE_SIZE = 10;
 var TRACKER_ARTIFACT_MAX_COUNT = 10;
 var TRACKER_ARTIFACT_MAX_BYTES = 5 * 1024 * 1024;
 var TRACKER_ARTIFACT_TOTAL_BYTES = 10 * 1024 * 1024;
@@ -24291,9 +24292,9 @@ async function discoverLinearResources(authorization, dependencies) {
   let after = null;
   const cursors = new Set;
   for (let page = 0;page < TRACKER_DISCOVERY_LIMIT; page += 1) {
-    const data = await linearGraphql(`query EmpiricalTrackerDiscovery($after: String) {
+    const data = await linearGraphql(`query EmpiricalTrackerDiscovery($after: String, $teamFirst: Int!) {
         organization { id name urlKey }
-        teams(first: 100, after: $after) {
+        teams(first: $teamFirst, after: $after) {
           nodes {
             id name key
             projects(first: 100) { nodes { id name url } pageInfo { hasNextPage endCursor } }
@@ -24301,7 +24302,7 @@ async function discoverLinearResources(authorization, dependencies) {
           }
           pageInfo { hasNextPage endCursor }
         }
-      }`, { after }, authorization, dependencies);
+      }`, { after, teamFirst: LINEAR_TEAM_DISCOVERY_PAGE_SIZE }, authorization, dependencies);
     const organizationValue = data.organization ?? (typeof data.viewer === "object" && data.viewer !== null && !Array.isArray(data.viewer) ? data.viewer.organization : undefined);
     const organization = record3(organizationValue, "Linear organization");
     const workspaceId = requiredString(organization, "id", "Linear workspace id");

package/dist/demo-ticket-policy.js

@@ -14861,7 +14861,7 @@ function verifyReceiptDigest(receipt) {
     throw new Error(`Evidence receipt ${parsed.id} has an asserted result inconsistent with its provenance.`);
   }
 }
-var SCHEMA_VERSION = 5, POLICY_SCHEMA_VERSION = 2, MANIFEST_SCHEMA_VERSION = 2, RECEIPT_SCHEMA_VERSION = 1, PRODUCT_VERSION = "0.26.0", workflowSchema, executionModeSchema, riskFloorSchema, completionLevelSchema, phaseSchema, workflowStatusSchema, criterionSchema, evidenceKindSchema, commandPolicySchema, evidencePolicySchema, projectPolicySchema, impactManifestSchema, authorizationSchema, COMPLETION_ORDER, receiptProvenanceSchema, receiptBaseSchema, executedReceiptSchema, artifactRecordSchema, collectedReceiptSchema, evidenceReceiptSchema;
+var SCHEMA_VERSION = 5, POLICY_SCHEMA_VERSION = 2, MANIFEST_SCHEMA_VERSION = 2, RECEIPT_SCHEMA_VERSION = 1, PRODUCT_VERSION = "0.26.1", workflowSchema, executionModeSchema, riskFloorSchema, completionLevelSchema, phaseSchema, workflowStatusSchema, criterionSchema, evidenceKindSchema, commandPolicySchema, evidencePolicySchema, projectPolicySchema, impactManifestSchema, authorizationSchema, COMPLETION_ORDER, receiptProvenanceSchema, receiptBaseSchema, executedReceiptSchema, artifactRecordSchema, collectedReceiptSchema, evidenceReceiptSchema;
 var init_protocol = __esm(() => {
   init_zod();
   workflowSchema = exports_external.enum(["fast", "complex"]);
@@ -22323,6 +22323,7 @@ var TRACKER_PROGRESS_STATES = [
   "done"
 ];
 var TRACKER_DISCOVERY_LIMIT = 100;
+var LINEAR_TEAM_DISCOVERY_PAGE_SIZE = 10;
 var TRACKER_ARTIFACT_MAX_COUNT = 10;
 var TRACKER_ARTIFACT_MAX_BYTES = 5 * 1024 * 1024;
 var TRACKER_ARTIFACT_TOTAL_BYTES = 10 * 1024 * 1024;
@@ -24291,9 +24292,9 @@ async function discoverLinearResources(authorization, dependencies) {
   let after = null;
   const cursors = new Set;
   for (let page = 0;page < TRACKER_DISCOVERY_LIMIT; page += 1) {
-    const data = await linearGraphql(`query EmpiricalTrackerDiscovery($after: String) {
+    const data = await linearGraphql(`query EmpiricalTrackerDiscovery($after: String, $teamFirst: Int!) {
         organization { id name urlKey }
-        teams(first: 100, after: $after) {
+        teams(first: $teamFirst, after: $after) {
           nodes {
             id name key
             projects(first: 100) { nodes { id name url } pageInfo { hasNextPage endCursor } }
@@ -24301,7 +24302,7 @@ async function discoverLinearResources(authorization, dependencies) {
           }
           pageInfo { hasNextPage endCursor }
         }
-      }`, { after }, authorization, dependencies);
+      }`, { after, teamFirst: LINEAR_TEAM_DISCOVERY_PAGE_SIZE }, authorization, dependencies);
     const organizationValue = data.organization ?? (typeof data.viewer === "object" && data.viewer !== null && !Array.isArray(data.viewer) ? data.viewer.organization : undefined);
     const organization = record3(organizationValue, "Linear organization");
     const workspaceId = requiredString(organization, "id", "Linear workspace id");

package/dist/index.js

@@ -14861,7 +14861,7 @@ function verifyReceiptDigest(receipt) {
     throw new Error(`Evidence receipt ${parsed.id} has an asserted result inconsistent with its provenance.`);
   }
 }
-var SCHEMA_VERSION = 5, POLICY_SCHEMA_VERSION = 2, MANIFEST_SCHEMA_VERSION = 2, RECEIPT_SCHEMA_VERSION = 1, PRODUCT_VERSION = "0.26.0", workflowSchema, executionModeSchema, riskFloorSchema, completionLevelSchema, phaseSchema, workflowStatusSchema, criterionSchema, evidenceKindSchema, commandPolicySchema, evidencePolicySchema, projectPolicySchema, impactManifestSchema, authorizationSchema, COMPLETION_ORDER, receiptProvenanceSchema, receiptBaseSchema, executedReceiptSchema, artifactRecordSchema, collectedReceiptSchema, evidenceReceiptSchema;
+var SCHEMA_VERSION = 5, POLICY_SCHEMA_VERSION = 2, MANIFEST_SCHEMA_VERSION = 2, RECEIPT_SCHEMA_VERSION = 1, PRODUCT_VERSION = "0.26.1", workflowSchema, executionModeSchema, riskFloorSchema, completionLevelSchema, phaseSchema, workflowStatusSchema, criterionSchema, evidenceKindSchema, commandPolicySchema, evidencePolicySchema, projectPolicySchema, impactManifestSchema, authorizationSchema, COMPLETION_ORDER, receiptProvenanceSchema, receiptBaseSchema, executedReceiptSchema, artifactRecordSchema, collectedReceiptSchema, evidenceReceiptSchema;
 var init_protocol = __esm(() => {
   init_zod();
   workflowSchema = exports_external.enum(["fast", "complex"]);
@@ -22317,6 +22317,7 @@ var TRACKER_PROGRESS_STATES = [
   "done"
 ];
 var TRACKER_DISCOVERY_LIMIT = 100;
+var LINEAR_TEAM_DISCOVERY_PAGE_SIZE = 10;
 var TRACKER_ARTIFACT_MAX_COUNT = 10;
 var TRACKER_ARTIFACT_MAX_BYTES = 5 * 1024 * 1024;
 var TRACKER_ARTIFACT_TOTAL_BYTES = 10 * 1024 * 1024;
@@ -24285,9 +24286,9 @@ async function discoverLinearResources(authorization, dependencies) {
   let after = null;
   const cursors = new Set;
   for (let page = 0;page < TRACKER_DISCOVERY_LIMIT; page += 1) {
-    const data = await linearGraphql(`query EmpiricalTrackerDiscovery($after: String) {
+    const data = await linearGraphql(`query EmpiricalTrackerDiscovery($after: String, $teamFirst: Int!) {
         organization { id name urlKey }
-        teams(first: 100, after: $after) {
+        teams(first: $teamFirst, after: $after) {
           nodes {
             id name key
             projects(first: 100) { nodes { id name url } pageInfo { hasNextPage endCursor } }
@@ -24295,7 +24296,7 @@ async function discoverLinearResources(authorization, dependencies) {
           }
           pageInfo { hasNextPage endCursor }
         }
-      }`, { after }, authorization, dependencies);
+      }`, { after, teamFirst: LINEAR_TEAM_DISCOVERY_PAGE_SIZE }, authorization, dependencies);
     const organizationValue = data.organization ?? (typeof data.viewer === "object" && data.viewer !== null && !Array.isArray(data.viewer) ? data.viewer.organization : undefined);
     const organization = record3(organizationValue, "Linear organization");
     const workspaceId = requiredString(organization, "id", "Linear workspace id");

package/dist/integrations.js

@@ -14861,7 +14861,7 @@ function verifyReceiptDigest(receipt) {
     throw new Error(`Evidence receipt ${parsed.id} has an asserted result inconsistent with its provenance.`);
   }
 }
-var SCHEMA_VERSION = 5, POLICY_SCHEMA_VERSION = 2, MANIFEST_SCHEMA_VERSION = 2, RECEIPT_SCHEMA_VERSION = 1, PRODUCT_VERSION = "0.26.0", workflowSchema, executionModeSchema, riskFloorSchema, completionLevelSchema, phaseSchema, workflowStatusSchema, criterionSchema, evidenceKindSchema, commandPolicySchema, evidencePolicySchema, projectPolicySchema, impactManifestSchema, authorizationSchema, COMPLETION_ORDER, receiptProvenanceSchema, receiptBaseSchema, executedReceiptSchema, artifactRecordSchema, collectedReceiptSchema, evidenceReceiptSchema;
+var SCHEMA_VERSION = 5, POLICY_SCHEMA_VERSION = 2, MANIFEST_SCHEMA_VERSION = 2, RECEIPT_SCHEMA_VERSION = 1, PRODUCT_VERSION = "0.26.1", workflowSchema, executionModeSchema, riskFloorSchema, completionLevelSchema, phaseSchema, workflowStatusSchema, criterionSchema, evidenceKindSchema, commandPolicySchema, evidencePolicySchema, projectPolicySchema, impactManifestSchema, authorizationSchema, COMPLETION_ORDER, receiptProvenanceSchema, receiptBaseSchema, executedReceiptSchema, artifactRecordSchema, collectedReceiptSchema, evidenceReceiptSchema;
 var init_protocol = __esm(() => {
   init_zod();
   workflowSchema = exports_external.enum(["fast", "complex"]);

package/dist/lifecycle.d.ts

@@ -1,8 +1,12 @@
 export interface LifecycleProcessResult {
     status: number | null;
     error?: Error;
+    stdout?: string;
 }
-export type LifecycleRunner = (command: string, args: string[]) => LifecycleProcessResult;
+export interface LifecycleRunOptions {
+    capture?: boolean;
+}
+export type LifecycleRunner = (command: string, args: string[], options?: LifecycleRunOptions) => LifecycleProcessResult;
 export interface UpdateReport {
     package: "updated";
     integrations: "refreshed";
@@ -10,6 +14,7 @@ export interface UpdateReport {
 export interface PackageUninstallReport {
     package: "removed";
 }
-export declare function updateEmpirical(runner?: LifecycleRunner): UpdateReport;
+export declare function updateEmpirical(runner?: LifecycleRunner, platform?: NodeJS.Platform): UpdateReport;
+export declare function resolveGlobalEmpirical(prefix: string, platform: NodeJS.Platform): string;
 export declare function uninstallEmpirical(runner?: LifecycleRunner): PackageUninstallReport;
 export declare function isUninstallConfirmed(answer: string): boolean;

package/dist/mcp.js

@@ -14861,7 +14861,7 @@ function verifyReceiptDigest(receipt) {
     throw new Error(`Evidence receipt ${parsed.id} has an asserted result inconsistent with its provenance.`);
   }
 }
-var SCHEMA_VERSION = 5, POLICY_SCHEMA_VERSION = 2, MANIFEST_SCHEMA_VERSION = 2, RECEIPT_SCHEMA_VERSION = 1, PRODUCT_VERSION = "0.26.0", workflowSchema, executionModeSchema, riskFloorSchema, completionLevelSchema, phaseSchema, workflowStatusSchema, criterionSchema, evidenceKindSchema, commandPolicySchema, evidencePolicySchema, projectPolicySchema, impactManifestSchema, authorizationSchema, COMPLETION_ORDER, receiptProvenanceSchema, receiptBaseSchema, executedReceiptSchema, artifactRecordSchema, collectedReceiptSchema, evidenceReceiptSchema;
+var SCHEMA_VERSION = 5, POLICY_SCHEMA_VERSION = 2, MANIFEST_SCHEMA_VERSION = 2, RECEIPT_SCHEMA_VERSION = 1, PRODUCT_VERSION = "0.26.1", workflowSchema, executionModeSchema, riskFloorSchema, completionLevelSchema, phaseSchema, workflowStatusSchema, criterionSchema, evidenceKindSchema, commandPolicySchema, evidencePolicySchema, projectPolicySchema, impactManifestSchema, authorizationSchema, COMPLETION_ORDER, receiptProvenanceSchema, receiptBaseSchema, executedReceiptSchema, artifactRecordSchema, collectedReceiptSchema, evidenceReceiptSchema;
 var init_protocol = __esm(() => {
   init_zod();
   workflowSchema = exports_external.enum(["fast", "complex"]);
@@ -37278,6 +37278,7 @@ var TRACKER_PROGRESS_STATES = [
   "done"
 ];
 var TRACKER_DISCOVERY_LIMIT = 100;
+var LINEAR_TEAM_DISCOVERY_PAGE_SIZE = 10;
 var TRACKER_ARTIFACT_MAX_COUNT = 10;
 var TRACKER_ARTIFACT_MAX_BYTES = 5 * 1024 * 1024;
 var TRACKER_ARTIFACT_TOTAL_BYTES = 10 * 1024 * 1024;
@@ -39246,9 +39247,9 @@ async function discoverLinearResources(authorization, dependencies) {
   let after = null;
   const cursors = new Set;
   for (let page = 0;page < TRACKER_DISCOVERY_LIMIT; page += 1) {
-    const data = await linearGraphql(`query EmpiricalTrackerDiscovery($after: String) {
+    const data = await linearGraphql(`query EmpiricalTrackerDiscovery($after: String, $teamFirst: Int!) {
         organization { id name urlKey }
-        teams(first: 100, after: $after) {
+        teams(first: $teamFirst, after: $after) {
           nodes {
             id name key
             projects(first: 100) { nodes { id name url } pageInfo { hasNextPage endCursor } }
@@ -39256,7 +39257,7 @@ async function discoverLinearResources(authorization, dependencies) {
           }
           pageInfo { hasNextPage endCursor }
         }
-      }`, { after }, authorization, dependencies);
+      }`, { after, teamFirst: LINEAR_TEAM_DISCOVERY_PAGE_SIZE }, authorization, dependencies);
     const organizationValue = data.organization ?? (typeof data.viewer === "object" && data.viewer !== null && !Array.isArray(data.viewer) ? data.viewer.organization : undefined);
     const organization = record4(organizationValue, "Linear organization");
     const workspaceId = requiredString(organization, "id", "Linear workspace id");

package/dist/protocol.d.ts

@@ -3,7 +3,7 @@ export declare const SCHEMA_VERSION: 5;
 export declare const POLICY_SCHEMA_VERSION: 2;
 export declare const MANIFEST_SCHEMA_VERSION: 2;
 export declare const RECEIPT_SCHEMA_VERSION: 1;
-export declare const PRODUCT_VERSION = "0.26.0";
+export declare const PRODUCT_VERSION = "0.26.1";
 export declare const workflowSchema: z.ZodEnum<{
     complex: "complex";
     fast: "fast";

package/dist/protocol.js

@@ -14861,7 +14861,7 @@ function verifyReceiptDigest(receipt) {
     throw new Error(`Evidence receipt ${parsed.id} has an asserted result inconsistent with its provenance.`);
   }
 }
-var SCHEMA_VERSION = 5, POLICY_SCHEMA_VERSION = 2, MANIFEST_SCHEMA_VERSION = 2, RECEIPT_SCHEMA_VERSION = 1, PRODUCT_VERSION = "0.26.0", workflowSchema, executionModeSchema, riskFloorSchema, completionLevelSchema, phaseSchema, workflowStatusSchema, criterionSchema, evidenceKindSchema, commandPolicySchema, evidencePolicySchema, projectPolicySchema, impactManifestSchema, authorizationSchema, COMPLETION_ORDER, receiptProvenanceSchema, receiptBaseSchema, executedReceiptSchema, artifactRecordSchema, collectedReceiptSchema, evidenceReceiptSchema;
+var SCHEMA_VERSION = 5, POLICY_SCHEMA_VERSION = 2, MANIFEST_SCHEMA_VERSION = 2, RECEIPT_SCHEMA_VERSION = 1, PRODUCT_VERSION = "0.26.1", workflowSchema, executionModeSchema, riskFloorSchema, completionLevelSchema, phaseSchema, workflowStatusSchema, criterionSchema, evidenceKindSchema, commandPolicySchema, evidencePolicySchema, projectPolicySchema, impactManifestSchema, authorizationSchema, COMPLETION_ORDER, receiptProvenanceSchema, receiptBaseSchema, executedReceiptSchema, artifactRecordSchema, collectedReceiptSchema, evidenceReceiptSchema;
 var init_protocol = __esm(() => {
   init_zod();
   workflowSchema = exports_external.enum(["fast", "complex"]);

package/docs/demo.md

@@ -1,4 +1,4 @@
-# Empirical 0.26.0 demo
+# Empirical 0.26.1 demo
 
 ## Install once
 

package/docs/versioning.md

@@ -25,12 +25,10 @@ and the prepared changelog heading must match it. `SCHEMA_VERSION` changes only
 when durable state compatibility changes; a package version change does not
 imply a schema change.
 
-The prepared `0.26.0` release is an alpha MINOR: it adds public concise/detailed
-question modes, strict Tracker Policy v2 ticket-requirement matrices, safe
-optional no-ticket behavior, and a packaged offline demo while leaving Schema 5
-and Tracker Policy v1/v2 compatible. Existing repositories require no state
-migration; repositories without an explicit question mode retain detailed
-questions until configured otherwise.
+The prepared `0.26.1` release is an alpha PATCH: it bounds Linear team pages so
+tracker discovery remains below Linear's GraphQL query-complexity limit. Schema
+5 and Tracker Policy v1/v2 remain compatible, and existing repositories require
+no state migration.
 
 ## Changelog rules
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "empirical-sdd",
-  "version": "0.26.0",
+  "version": "0.26.1",
   "description": "Agent-neutral, resumable spec-driven development for every terminal-capable coding agent",
   "type": "module",
   "bin": {