@ran-sh/dsh-crew 1.9.0 → 1.10.0

package/src/dsh-cohort.mjs

@@ -1,20 +1,20 @@
-// Single source of truth for the pinned DeepSeek Harness cohort.
-//
-// The Crew runtime, the SDK client, and the worker composition must all
-// resolve to this exact version. All other modules re-export from here so a
-// cohort bump touches exactly one file (plus package.json's 48 DSH pins).
-export const DSH_CLI_PACKAGE = '@deepseek-ai/dsh';
-export const TARGET_DSH_VERSION = '0.1.5-rc.2';
-export const TARGET_DSH_SPEC = `${DSH_CLI_PACKAGE}@${TARGET_DSH_VERSION}`;
-
-// Retained-cohort support: when a release's manifest pins an older DSH
-// cohort than the current TARGET, the old runtime is retained on disk so a
-// rollback can restore it offline (no registry round-trip).
-export const RETAINED_RUNTIMES_DIRNAME = 'retained-runtimes';
-
-// Lifecycle-owned cohort metadata for a managed release. Historical releases
-// (pre-1.0.4) did not pin @deepseek-ai/dsh in their manifest; this sidecar
-// records the runtime cohort fact the lifecycle observed for them WITHOUT
-// mutating the immutable release manifest. Resolution priority:
-//   manifest exact pin -> sidecar -> (legacy discovery) -> fail closed.
-export const RELEASE_COHORT_FILENAME = 'release-cohort.json';
+// Single source of truth for the pinned DeepSeek Harness cohort.
+//
+// The Crew runtime, the SDK client, and the worker composition must all
+// resolve to this exact version. All other modules re-export from here so a
+// cohort bump touches exactly one file (plus package.json's 48 DSH pins).
+export const DSH_CLI_PACKAGE = '@deepseek-ai/dsh';
+export const TARGET_DSH_VERSION = '0.1.5-rc.2';
+export const TARGET_DSH_SPEC = `${DSH_CLI_PACKAGE}@${TARGET_DSH_VERSION}`;
+
+// Retained-cohort support: when a release's manifest pins an older DSH
+// cohort than the current TARGET, the old runtime is retained on disk so a
+// rollback can restore it offline (no registry round-trip).
+export const RETAINED_RUNTIMES_DIRNAME = 'retained-runtimes';
+
+// Lifecycle-owned cohort metadata for a managed release. Historical releases
+// (pre-1.0.4) did not pin @deepseek-ai/dsh in their manifest; this sidecar
+// records the runtime cohort fact the lifecycle observed for them WITHOUT
+// mutating the immutable release manifest. Resolution priority:
+//   manifest exact pin -> sidecar -> (legacy discovery) -> fail closed.
+export const RELEASE_COHORT_FILENAME = 'release-cohort.json';

package/src/extension-contract.mjs

@@ -1,104 +1,104 @@
-// Stable extension-capability projection for GPT-first orchestrators. It
-// describes only DSH Crew and deliberately never advertises itself as a top-
-// level Executor or control plane.
-
-import { validateModelCallabilityV2 } from './model-callability-contract.mjs';
-
-export const EXTENSION_CONTRACT_SCHEMA_VERSION = 1;
-
-function row(matrix, id) {
-  return Array.isArray(matrix?.rows) ? matrix.rows.find((entry) => entry?.id === id) : undefined;
-}
-
-function component(status, reasonCode, evidence = null) {
-  return { status, reason_code: reasonCode, ...(evidence ? { evidence } : {}) };
-}
-
-function workspaceComponent(workspace) {
-  if (workspace?.status === 'CONFLICT' || workspace?.status === 'READ_ONLY') {
-    return { ...component('DEGRADED', workspace.reason_code ?? `WORKSPACE_${workspace.status}`), state: workspace.status };
-  }
-  if (workspace?.status === 'UNAVAILABLE') {
-    return { ...component('UNAVAILABLE', workspace.reason_code ?? 'WORKSPACE_UNAVAILABLE'), state: 'UNAVAILABLE' };
-  }
-  if (workspace?.status === 'READY') {
-    return { ...component('READY', workspace.reason_code ?? 'WORKSPACE_READY'), state: 'READY' };
-  }
-  return workspace?.ok === true
-    ? { ...component('READY', workspace.context ? 'WORKSPACE_CONTEXT_RESOLVED' : 'WORKSPACE_CONTEXT_NOT_REQUESTED'), state: 'READY' }
-    : { ...component('UNAVAILABLE', workspace?.code ?? 'WORKSPACE_NOT_CHECKED'), state: 'UNAVAILABLE' };
-}
-
-function readinessFromRow(entry, { pass = 'READY', notRun = 'DEGRADED' } = {}) {
-  if (!entry) return component('UNAVAILABLE', 'NO_EVIDENCE');
-  if (entry.status === 'PASS') return component(pass, entry.reason_code ?? 'CHECK_PASSED');
-  if (entry.status === 'NOT_RUN' || entry.status === 'SKIP') return component(notRun, entry.reason_code ?? 'CHECK_NOT_RUN');
-  return component('UNAVAILABLE', entry.reason_code ?? 'CHECK_FAILED');
-}
-
-function modelReadinessFromSnapshot(readinessSnapshot, matrix, runtime, expectedEnabledRoles, now = Date.now()) {
-  const callability = readinessSnapshot?.model_callability;
-  const providerHealthEvidence = row(matrix, 'provider_health');
-  const catalogEvidence = row(matrix, 'provider_catalog');
-  if (callability && typeof callability === 'object') {
-    const validation = validateModelCallabilityV2({
-      projection: callability,
-      runtime,
-      expectedEnabledRoles,
-      expectedSelections: { worker: readinessSnapshot?.worker?.selected ?? null, reviewer: readinessSnapshot?.reviewer?.selected ?? null },
-      now,
-    });
-    if (validation.ok && validation.state === 'CALLABLE') return component('READY', 'CURRENT_MODEL_CALLABLE', { captured_at: callability.captured_at, expires_at: callability.expires_at, runtime_id: callability.current_runtime_id });
-    if (validation.ok && validation.state === 'NOT_CALLABLE') return component('UNAVAILABLE', callability.roles.worker?.state === 'NOT_CALLABLE' ? callability.roles.worker.reason_code : callability.roles.reviewer.reason_code ?? 'CURRENT_MODEL_NOT_CALLABLE');
-    if (validation.ok && validation.state === 'STALE') return component('DEGRADED', 'MODEL_EVIDENCE_STALE');
-    return component('DEGRADED', validation.reason_code ?? 'MODEL_CALLABILITY_UNKNOWN');
-  }
-  if (providerHealthEvidence?.status === 'FAIL') return readinessFromRow(providerHealthEvidence);
-  if (catalogEvidence?.status === 'FAIL') return readinessFromRow(catalogEvidence);
-  if (providerHealthEvidence || catalogEvidence) return component('DEGRADED', 'MODEL_CALLABILITY_NOT_PROJECTED');
-  return component('UNAVAILABLE', 'MODEL_CALLABILITY_NOT_PROJECTED');
-}
-
-export function buildExtensionContract({ config = {}, readinessMatrix = {}, readinessSnapshot = null, workspace = null, profiles = null, runtime = null } = {}) {
-  const matrix = readinessSnapshot?.readiness_matrix ?? readinessMatrix;
-  const workerEnabled = config.subagents_enabled !== false && config.worker_state !== 'disabled';
-  const reviewerEnabled = config.subagents_enabled !== false && config.review_state !== 'disabled';
-  const reviewerHealthEvidence = row(matrix, 'reviewer_health');
-  const lifecycleEvidence = row(matrix, 'provider_lifecycle_consistent');
-  const modelReadiness = modelReadinessFromSnapshot(readinessSnapshot, matrix, runtime, { worker: workerEnabled, reviewer: reviewerEnabled });
-  const components = {
-    harness: readinessFromRow(row(matrix, 'hub_compatibility')),
-    provider_lifecycle: lifecycleEvidence
-      ? readinessFromRow(lifecycleEvidence, { notRun: 'DEGRADED' })
-      : component('DEGRADED', 'PROVIDER_LIFECYCLE_NOT_CHECKED'),
-    model: modelReadiness,
-    workspace: workspaceComponent(workspace),
-    reviewer: reviewerEnabled
-      ? reviewerHealthEvidence?.status === 'FAIL'
-        ? readinessFromRow(reviewerHealthEvidence)
-        : readinessFromRow(row(matrix, 'reviewer_pipeline'))
-      : component('NOT_APPLICABLE', 'REVIEWER_DISABLED'),
-  };
-  const states = Object.entries(components).filter(([key]) => key !== 'reviewer' || reviewerEnabled).map(([, entry]) => entry.status);
-  const readiness = states.includes('UNAVAILABLE') ? 'UNAVAILABLE' : states.includes('DEGRADED') ? 'DEGRADED' : 'READY';
-  return {
-    schema_version: EXTENSION_CONTRACT_SCHEMA_VERSION,
-    kind: 'dsh-crew-extension',
-    runtime: runtime ?? null,
-    ...(readinessSnapshot ? { readiness_snapshot: readinessSnapshot } : {}),
-    capabilities: {
-      'deepseek.worker': workerEnabled,
-      'deepseek.reviewer': reviewerEnabled,
-      'worktree.isolation': true,
-      'model.fallback': config.escalate_on_failure === true,
-      'job.cancel': true,
-      'job.watch': true,
-      'job.resume': false,
-      'result.evidence': true,
-      'events.canonical': true,
-      'profiles.roles': profiles?.ok === true,
-      'workspace.context': true,
-    },
-    readiness: { status: readiness, components },
-  };
-}
+// Stable extension-capability projection for GPT-first orchestrators. It
+// describes only DSH Crew and deliberately never advertises itself as a top-
+// level Executor or control plane.
+
+import { validateModelCallabilityV2 } from './model-callability-contract.mjs';
+
+export const EXTENSION_CONTRACT_SCHEMA_VERSION = 1;
+
+function row(matrix, id) {
+  return Array.isArray(matrix?.rows) ? matrix.rows.find((entry) => entry?.id === id) : undefined;
+}
+
+function component(status, reasonCode, evidence = null) {
+  return { status, reason_code: reasonCode, ...(evidence ? { evidence } : {}) };
+}
+
+function workspaceComponent(workspace) {
+  if (workspace?.status === 'CONFLICT' || workspace?.status === 'READ_ONLY') {
+    return { ...component('DEGRADED', workspace.reason_code ?? `WORKSPACE_${workspace.status}`), state: workspace.status };
+  }
+  if (workspace?.status === 'UNAVAILABLE') {
+    return { ...component('UNAVAILABLE', workspace.reason_code ?? 'WORKSPACE_UNAVAILABLE'), state: 'UNAVAILABLE' };
+  }
+  if (workspace?.status === 'READY') {
+    return { ...component('READY', workspace.reason_code ?? 'WORKSPACE_READY'), state: 'READY' };
+  }
+  return workspace?.ok === true
+    ? { ...component('READY', workspace.context ? 'WORKSPACE_CONTEXT_RESOLVED' : 'WORKSPACE_CONTEXT_NOT_REQUESTED'), state: 'READY' }
+    : { ...component('UNAVAILABLE', workspace?.code ?? 'WORKSPACE_NOT_CHECKED'), state: 'UNAVAILABLE' };
+}
+
+function readinessFromRow(entry, { pass = 'READY', notRun = 'DEGRADED' } = {}) {
+  if (!entry) return component('UNAVAILABLE', 'NO_EVIDENCE');
+  if (entry.status === 'PASS') return component(pass, entry.reason_code ?? 'CHECK_PASSED');
+  if (entry.status === 'NOT_RUN' || entry.status === 'SKIP') return component(notRun, entry.reason_code ?? 'CHECK_NOT_RUN');
+  return component('UNAVAILABLE', entry.reason_code ?? 'CHECK_FAILED');
+}
+
+function modelReadinessFromSnapshot(readinessSnapshot, matrix, runtime, expectedEnabledRoles, now = Date.now()) {
+  const callability = readinessSnapshot?.model_callability;
+  const providerHealthEvidence = row(matrix, 'provider_health');
+  const catalogEvidence = row(matrix, 'provider_catalog');
+  if (callability && typeof callability === 'object') {
+    const validation = validateModelCallabilityV2({
+      projection: callability,
+      runtime,
+      expectedEnabledRoles,
+      expectedSelections: { worker: readinessSnapshot?.worker?.selected ?? null, reviewer: readinessSnapshot?.reviewer?.selected ?? null },
+      now,
+    });
+    if (validation.ok && validation.state === 'CALLABLE') return component('READY', 'CURRENT_MODEL_CALLABLE', { captured_at: callability.captured_at, expires_at: callability.expires_at, runtime_id: callability.current_runtime_id });
+    if (validation.ok && validation.state === 'NOT_CALLABLE') return component('UNAVAILABLE', callability.roles.worker?.state === 'NOT_CALLABLE' ? callability.roles.worker.reason_code : callability.roles.reviewer.reason_code ?? 'CURRENT_MODEL_NOT_CALLABLE');
+    if (validation.ok && validation.state === 'STALE') return component('DEGRADED', 'MODEL_EVIDENCE_STALE');
+    return component('DEGRADED', validation.reason_code ?? 'MODEL_CALLABILITY_UNKNOWN');
+  }
+  if (providerHealthEvidence?.status === 'FAIL') return readinessFromRow(providerHealthEvidence);
+  if (catalogEvidence?.status === 'FAIL') return readinessFromRow(catalogEvidence);
+  if (providerHealthEvidence || catalogEvidence) return component('DEGRADED', 'MODEL_CALLABILITY_NOT_PROJECTED');
+  return component('UNAVAILABLE', 'MODEL_CALLABILITY_NOT_PROJECTED');
+}
+
+export function buildExtensionContract({ config = {}, readinessMatrix = {}, readinessSnapshot = null, workspace = null, profiles = null, runtime = null } = {}) {
+  const matrix = readinessSnapshot?.readiness_matrix ?? readinessMatrix;
+  const workerEnabled = config.subagents_enabled !== false && config.worker_state !== 'disabled';
+  const reviewerEnabled = config.subagents_enabled !== false && config.review_state !== 'disabled';
+  const reviewerHealthEvidence = row(matrix, 'reviewer_health');
+  const lifecycleEvidence = row(matrix, 'provider_lifecycle_consistent');
+  const modelReadiness = modelReadinessFromSnapshot(readinessSnapshot, matrix, runtime, { worker: workerEnabled, reviewer: reviewerEnabled });
+  const components = {
+    harness: readinessFromRow(row(matrix, 'hub_compatibility')),
+    provider_lifecycle: lifecycleEvidence
+      ? readinessFromRow(lifecycleEvidence, { notRun: 'DEGRADED' })
+      : component('DEGRADED', 'PROVIDER_LIFECYCLE_NOT_CHECKED'),
+    model: modelReadiness,
+    workspace: workspaceComponent(workspace),
+    reviewer: reviewerEnabled
+      ? reviewerHealthEvidence?.status === 'FAIL'
+        ? readinessFromRow(reviewerHealthEvidence)
+        : readinessFromRow(row(matrix, 'reviewer_pipeline'))
+      : component('NOT_APPLICABLE', 'REVIEWER_DISABLED'),
+  };
+  const states = Object.entries(components).filter(([key]) => key !== 'reviewer' || reviewerEnabled).map(([, entry]) => entry.status);
+  const readiness = states.includes('UNAVAILABLE') ? 'UNAVAILABLE' : states.includes('DEGRADED') ? 'DEGRADED' : 'READY';
+  return {
+    schema_version: EXTENSION_CONTRACT_SCHEMA_VERSION,
+    kind: 'dsh-crew-extension',
+    runtime: runtime ?? null,
+    ...(readinessSnapshot ? { readiness_snapshot: readinessSnapshot } : {}),
+    capabilities: {
+      'deepseek.worker': workerEnabled,
+      'deepseek.reviewer': reviewerEnabled,
+      'worktree.isolation': true,
+      'model.fallback': config.escalate_on_failure === true,
+      'job.cancel': true,
+      'job.watch': true,
+      'job.resume': false,
+      'result.evidence': true,
+      'events.canonical': true,
+      'profiles.roles': profiles?.ok === true,
+      'workspace.context': true,
+    },
+    readiness: { status: readiness, components },
+  };
+}