@ran-sh/dsh-crew 0.5.7 → 1.0.0

package/src/runtime-readiness-snapshot.mjs

@@ -0,0 +1,87 @@
+// Single, bounded readiness projection shared by the Hub extension surface,
+// MCP diagnostics and the client. It consumes already-collected evidence and
+// never performs I/O or carries raw task/result/error/credential content.
+
+const MAX_HEALTH = 128;
+
+function text(value) { return typeof value === 'string' && value.trim() ? value.trim() : null; }
+
+function projectRuntime(runtime) {
+  if (!runtime || typeof runtime !== 'object') return null;
+  return {
+    execution_plane: text(runtime.execution_plane),
+    profile: text(runtime.profile),
+    listen_port: Number.isFinite(Number(runtime.listen_port)) ? Number(runtime.listen_port) : null,
+    runtime_id: text(runtime.runtime_id),
+  };
+}
+
+function projectSelection(value) {
+  if (!value || typeof value !== 'object') return null;
+  const provider = text(value.provider);
+  const model = text(value.model);
+  if (!provider || !model) return null;
+  return { provider, model, ...(text(value.source) ? { source: text(value.source) } : {}) };
+}
+
+function projectHealth(entry) {
+  if (!entry || typeof entry !== 'object') return null;
+  const provider = text(entry.provider);
+  const model = text(entry.model);
+  const state = text(entry.state);
+  if (!provider || !model || !state) return null;
+  return {
+    provider,
+    model,
+    state,
+    ...(text(entry.reason_code) ? { reason_code: text(entry.reason_code) } : {}),
+    ...(Number.isFinite(entry.observed_at) ? { observed_at: entry.observed_at } : {}),
+    ...(Number.isFinite(entry.expires_at) ? { expires_at: entry.expires_at } : {}),
+    fresh: entry.fresh === true,
+  };
+}
+
+function matrixRow(matrix, id) {
+  return Array.isArray(matrix?.rows) ? matrix.rows.find((row) => row?.id === id) ?? null : null;
+}
+
+function projectWorkspace(workspace) {
+  if (!workspace || typeof workspace !== 'object') return null;
+  return {
+    ...(text(workspace.status) ? { status: text(workspace.status) } : {}),
+    ...(text(workspace.reason_code) ? { reason_code: text(workspace.reason_code) } : {}),
+  };
+}
+
+export function buildRuntimeReadinessSnapshot({
+  runtime = null,
+  readinessMatrix = null,
+  selections = {},
+  health = [],
+  jobs = [],
+  workspace = null,
+} = {}) {
+  const projectedHealth = (Array.isArray(health) ? health : []).map(projectHealth).filter(Boolean).slice(0, MAX_HEALTH);
+  const projectedJobs = Array.isArray(jobs) ? jobs : [];
+  const verified = projectedJobs.filter((job) => job?.status === 'done' && job?.task_status === 'success' && job?.delivery_complete === true).length;
+  const workerJobs = projectedJobs.filter((job) => job?.role === 'worker').length;
+  const reviewerJobs = projectedJobs.filter((job) => job?.role === 'reviewer').length;
+  const workerSelection = projectSelection(selections.worker ?? selections.flash);
+  const reviewerSelection = projectSelection(selections.reviewer ?? selections.pro);
+  return {
+    schema_version: 1,
+    runtime: projectRuntime(runtime),
+    readiness_matrix: readinessMatrix && typeof readinessMatrix === 'object' ? structuredClone(readinessMatrix) : null,
+    provider_lifecycle: matrixRow(readinessMatrix, 'provider_lifecycle_consistent'),
+    health: projectedHealth,
+    worker: { selected: workerSelection, health: projectedHealth.filter((entry) => entry.provider === workerSelection?.provider && entry.model === workerSelection?.model) },
+    reviewer: { selected: reviewerSelection, health: projectedHealth.filter((entry) => entry.provider === reviewerSelection?.provider && entry.model === reviewerSelection?.model) },
+    historical_evidence: {
+      job_count: projectedJobs.length,
+      verified_job_count: verified,
+      worker_job_count: workerJobs,
+      reviewer_job_count: reviewerJobs,
+    },
+    workspace: projectWorkspace(workspace),
+  };
+}

package/src/server.mjs

@@ -9,7 +9,8 @@ import { hubCompatibilityMessage, resolveHubExecutionMode } from './hub-compatib
 import { RUNTIME_VERSION, getHubRuntimeIdentity } from './runtime-identity.mjs';
 import { resolveWorkerModel } from './model-routing.mjs';
 import { runtimeActivationMetadata } from './runtime-controls.mjs';
-import { buildConfigReadinessMatrix } from './config-readiness.mjs';
+import { buildConfigReadinessMatrix } from './config-readiness.mjs';
+import { buildRuntimeReadinessSnapshot } from './runtime-readiness-snapshot.mjs';
 import { classifyFailure, classifyFailureCode } from './failure-classification.mjs';
 import {
   normalizeGlobalConfig,
@@ -331,6 +332,8 @@ async function buildConfigReport() {
   let providerCatalogBody = null;
   let providerInventoryChecked = false;
   let providerInventoryBody = null;
+  let providerHealthChecked = false;
+  let providerHealthBody = null;
   let hubJobsChecked = false;
   let hubJobsBody = null;
   const workerProviderMode = globalConfig.worker_provider_mode ?? 'deepseek-official';
@@ -378,6 +381,16 @@ async function buildConfigReport() {
       providerInventoryBody = { ok: false, code: 'PROVIDER_INVENTORY_UNAVAILABLE' };
     }
   }
+  if (hubCompatibility.compatible) {
+    try {
+      providerHealthChecked = true;
+      const healthRes = await fetch(`${globalConfig.hub_url}/_dsh/dsh-crew/provider-health`, { signal: AbortSignal.timeout(800) });
+      providerHealthBody = healthRes.ok ? await healthRes.json() : { ok: false, code: 'PROVIDER_HEALTH_UNAVAILABLE' };
+    } catch {
+      providerHealthChecked = true;
+      providerHealthBody = { ok: false, code: 'PROVIDER_HEALTH_UNAVAILABLE' };
+    }
+  }
   if (hubCompatibility.compatible) {
     try {
       hubJobsChecked = true;
@@ -395,12 +408,22 @@ async function buildConfigReport() {
     providerCatalogBody,
     providerInventoryChecked,
     providerInventoryBody,
+    providerHealthChecked,
+    providerHealthBody,
     hubJobsChecked,
     hubJobsBody,
   });
   const roleProfiles = loadRoleProfiles();
-  const workspaceReadiness = await assessWorkspaceReadiness({ cwd: process.cwd() });
-  const extensionContract = buildExtensionContract({
+  const workspaceReadiness = await assessWorkspaceReadiness({ cwd: process.cwd() });
+  const readinessSnapshot = buildRuntimeReadinessSnapshot({
+    runtime: getHubRuntimeIdentity(),
+    readinessMatrix,
+    selections: { worker: effectiveWorkerSelection.worker ?? effectiveWorkerSelection.flash, reviewer: effectiveWorkerSelection.reviewer ?? effectiveWorkerSelection.pro },
+    health: providerHealthBody?.health,
+    jobs: hubJobsBody?.jobs,
+    workspace: workspaceReadiness,
+  });
+  const extensionContract = buildExtensionContract({
     config: {
       ...globalConfig,
       subagents_enabled: sessionConfig.enabled !== false && globalConfig.subagents_enabled !== false,
@@ -408,7 +431,8 @@ async function buildConfigReport() {
       review_state: globalConfig.review_state,
       escalate_on_failure: sessionConfig.escalate_on_failure ?? legacy.escalate_on_failure,
     },
-    readinessMatrix,
+    readinessMatrix,
+    readinessSnapshot,
     workspace: workspaceReadiness,
     profiles: roleProfiles,
     runtime: getHubRuntimeIdentity(),
@@ -450,7 +474,8 @@ async function buildConfigReport() {
     global_defaults: Object.fromEntries(SAFE_GLOBAL_KEYS.map((k) => [k, globalConfig[k]])),
     runtime_controls: runtimeControls,
     activation_boundaries: activationBoundaries,
-    readiness_matrix: readinessMatrix,
+    readiness_matrix: readinessMatrix,
+    readiness_snapshot: readinessSnapshot,
     role_profiles: roleProfiles,
     extension_contract: extensionContract,
     hub_reachable: hubCompatibility.reachable,