snipara-companion 2.1.0 → 2.1.1

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import { ProjectIntelligenceEngineeringLeadPlanSummary } from '@snipara/project-intelligence-contracts';
+
 declare function resolveQueryFromToolInput(toolInput?: string, tool?: string): string | null;
 
 declare function extractFilesFromToolInput(toolInput?: string): string[];
@@ -2151,65 +2153,11 @@ declare function buildAgentReadinessAuditReport(options?: BuildAgentReadinessAud
 declare function formatAgentReadinessAuditReport(report: AgentReadinessAuditReport): string;
 declare function agentReadinessAuditCommand(options: AgentReadinessAuditCommandOptions): Promise<void>;
 
-type EngineeringLeadPosture = "lead_ready" | "lead_watch" | "lead_blocked" | "lead_cold_start";
-type EngineeringLeadStatus = "healthy" | "watch" | "risk" | "unknown";
-type EngineeringLeadWorkerRole = "main_agent" | "coding_worker" | "test_worker" | "reviewer" | "documentation_worker" | "human_approver";
-type EngineeringLeadRoutingMode = "hold" | "main_agent_execute" | "explicit_handoff_ready" | "needs_contract";
-interface EngineeringLeadEvidenceRef {
-    id: string;
-    kind: "memory" | "project_decision" | "shadow_signal" | "context_graph" | "outcome_signal" | "retrieval_event" | "workflow" | "repository" | "manual";
-    label: string;
-    sourceRef?: string | null;
-    strength?: number | null;
-    reviewStatus?: string | null;
-    authorityStatus?: string | null;
-    freshness?: string | null;
-}
-interface EngineeringLeadWorkerContract {
-    writeScope: string[];
-    contextRefs: EngineeringLeadEvidenceRef[];
-    acceptanceCriteria: string[];
-    proofRequired: string[];
-    approvalRequired: boolean;
-    fallback: "main_agent";
-}
-interface EngineeringLeadWorkerRecommendation {
-    id: string;
-    role: EngineeringLeadWorkerRole;
-    label: string;
-    status: EngineeringLeadStatus;
-    routingMode: EngineeringLeadRoutingMode;
-    workPackageId: string | null;
-    workPackageTitle: string | null;
-    owner: string | null;
-    rationale: string;
-    contract: EngineeringLeadWorkerContract;
-    proofGates: string[];
-    brainUpdateCandidates: string[];
-    evidence: EngineeringLeadEvidenceRef[];
-    reasonCodes: string[];
-}
-interface EngineeringLeadPlanSummary {
-    version: "project-intelligence-engineering-lead-plan-v0";
-    posture: EngineeringLeadPosture;
-    status: EngineeringLeadStatus;
-    score: number;
-    headline: string;
-    operatingMode: "advisory_fail_closed";
-    nextAction: string;
-    workersSpawned: 0;
-    failClosedFallback: "main_agent";
-    workerRecommendations: EngineeringLeadWorkerRecommendation[];
-    proofGates: string[];
-    brainUpdateActions: string[];
-    metrics: Array<{
-        label: string;
-        value: string | number;
-    }>;
-    evidence: EngineeringLeadEvidenceRef[];
-    caveats: string[];
-    reasonCodes: string[];
-}
+declare const ENGINEERING_LEAD_STATUSES: readonly ["healthy", "watch", "risk", "unknown"];
+declare const ENGINEERING_LEAD_POSTURES: readonly ["lead_ready", "lead_watch", "lead_blocked", "lead_cold_start"];
+declare const ENGINEERING_LEAD_WORKER_ROLES: readonly ["main_agent", "coding_worker", "test_worker", "reviewer", "documentation_worker", "human_approver"];
+declare const ENGINEERING_LEAD_ROUTING_MODES: readonly ["hold", "main_agent_execute", "explicit_handoff_ready", "needs_contract"];
+type EngineeringLeadPlanSummary = ProjectIntelligenceEngineeringLeadPlanSummary;
 interface CompanionEngineeringLeadPlanReport {
     version: "snipara.companion_engineering_lead_plan.v1";
     generatedAt: string;
@@ -3557,4 +3505,4 @@ declare function buildOrchestratorHandoff(options: OrchestratorHandoffOptions):
 declare function buildAdaptiveWorkRoutingRecommendation(options: AdaptiveWorkRoutingOptions): AdaptiveWorkRoutingRecommendation;
 declare function writeOrchestratorHandoff(options: OrchestratorHandoffOptions): WrittenOrchestratorHandoff;
 
-export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, COLLABORATION_STATE_RELATIVE_PATH, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, TEAM_SYNC_STATE_RELATIVE_PATH, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, agentReadinessAuditCommand, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalShortestPathResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readLocalCodeOverlayCache, readLocalCodePromotionState, referencesIngestCommand, referencesScanCommand, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeOrchestratorHandoff };
+export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, COLLABORATION_STATE_RELATIVE_PATH, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, TEAM_SYNC_STATE_RELATIVE_PATH, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, agentReadinessAuditCommand, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalShortestPathResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readLocalCodeOverlayCache, readLocalCodePromotionState, referencesIngestCommand, referencesScanCommand, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeOrchestratorHandoff };

package/dist/index.js

@@ -35,6 +35,10 @@ __export(index_exports, {
   AutomationInstallConflictError: () => AutomationInstallConflictError,
   AutomationUnsupportedHookBundleError: () => AutomationUnsupportedHookBundleError,
   COLLABORATION_STATE_RELATIVE_PATH: () => COLLABORATION_STATE_RELATIVE_PATH,
+  ENGINEERING_LEAD_POSTURES: () => ENGINEERING_LEAD_POSTURES,
+  ENGINEERING_LEAD_ROUTING_MODES: () => ENGINEERING_LEAD_ROUTING_MODES,
+  ENGINEERING_LEAD_STATUSES: () => ENGINEERING_LEAD_STATUSES,
+  ENGINEERING_LEAD_WORKER_ROLES: () => ENGINEERING_LEAD_WORKER_ROLES,
   ORCHESTRATOR_HANDOFF_RELATIVE_PATH: () => ORCHESTRATOR_HANDOFF_RELATIVE_PATH,
   TEAM_SYNC_STATE_RELATIVE_PATH: () => TEAM_SYNC_STATE_RELATIVE_PATH,
   WORKFLOW_PLANS_RELATIVE_DIR: () => WORKFLOW_PLANS_RELATIVE_DIR,
@@ -10451,6 +10455,36 @@ async function agentReadinessAuditCommand(options) {
 // src/commands/lead-plan.ts
 var fs16 = __toESM(require("fs"));
 var path15 = __toESM(require("path"));
+
+// ../project-intelligence-contracts/src/index.ts
+var PROJECT_HEALTH_COCKPIT_STATUSES = ["healthy", "watch", "risk", "unknown"];
+var PROJECT_INTELLIGENCE_ENGINEERING_LEAD_PLAN_VERSION = "project-intelligence-engineering-lead-plan-v0";
+var PROJECT_INTELLIGENCE_ENGINEERING_LEAD_POSTURES = [
+  "lead_ready",
+  "lead_watch",
+  "lead_blocked",
+  "lead_cold_start"
+];
+var PROJECT_INTELLIGENCE_ENGINEERING_LEAD_WORKER_ROLES = [
+  "main_agent",
+  "coding_worker",
+  "test_worker",
+  "reviewer",
+  "documentation_worker",
+  "human_approver"
+];
+var PROJECT_INTELLIGENCE_ENGINEERING_LEAD_ROUTING_MODES = [
+  "hold",
+  "main_agent_execute",
+  "explicit_handoff_ready",
+  "needs_contract"
+];
+
+// src/commands/lead-plan.ts
+var ENGINEERING_LEAD_STATUSES = PROJECT_HEALTH_COCKPIT_STATUSES;
+var ENGINEERING_LEAD_POSTURES = PROJECT_INTELLIGENCE_ENGINEERING_LEAD_POSTURES;
+var ENGINEERING_LEAD_WORKER_ROLES = PROJECT_INTELLIGENCE_ENGINEERING_LEAD_WORKER_ROLES;
+var ENGINEERING_LEAD_ROUTING_MODES = PROJECT_INTELLIGENCE_ENGINEERING_LEAD_ROUTING_MODES;
 var TARGET_LABELS = {
   codex: "Codex",
   "claude-code": "Claude Code",
@@ -10504,17 +10538,17 @@ function numberValue2(value, fallback) {
 function booleanValue(value, fallback) {
   return typeof value === "boolean" ? value : fallback;
 }
-function statusValue(value, fallback) {
-  return value === "healthy" || value === "watch" || value === "risk" || value === "unknown" ? value : fallback;
-}
-function postureValue(value, fallback) {
-  return value === "lead_ready" || value === "lead_watch" || value === "lead_blocked" || value === "lead_cold_start" ? value : fallback;
-}
-function roleValue(value, fallback) {
-  return value === "main_agent" || value === "coding_worker" || value === "test_worker" || value === "reviewer" || value === "documentation_worker" || value === "human_approver" ? value : fallback;
+function cockpitEnumValue(field, values, value, fallback) {
+  if (typeof value === "string" && values.includes(value)) {
+    return { value, droppedReasonCode: null };
+  }
+  return {
+    value: fallback,
+    droppedReasonCode: typeof value === "string" && value.trim() ? `companion_dropped_unknown_${field}` : null
+  };
 }
-function routingModeValue(value, fallback) {
-  return value === "hold" || value === "main_agent_execute" || value === "explicit_handoff_ready" || value === "needs_contract" ? value : fallback;
+function compactReasonCodes(values) {
+  return values.filter((value) => Boolean(value));
 }
 function slug(value, fallback) {
   const normalized = value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48);
@@ -10737,7 +10771,7 @@ function buildLocalEngineeringLeadPlan(input) {
     ]
   };
   return {
-    version: "project-intelligence-engineering-lead-plan-v0",
+    version: PROJECT_INTELLIGENCE_ENGINEERING_LEAD_PLAN_VERSION,
     posture,
     status,
     score,
@@ -10774,12 +10808,30 @@ function buildLocalEngineeringLeadPlan(input) {
 }
 function normalizeWorkerRecommendation(value, index) {
   const contract = isRecord5(value.contract) ? value.contract : {};
+  const role = cockpitEnumValue(
+    "worker_role",
+    ENGINEERING_LEAD_WORKER_ROLES,
+    value.role,
+    "main_agent"
+  );
+  const status = cockpitEnumValue(
+    "worker_status",
+    ENGINEERING_LEAD_STATUSES,
+    value.status,
+    "unknown"
+  );
+  const routingMode = cockpitEnumValue(
+    "routing_mode",
+    ENGINEERING_LEAD_ROUTING_MODES,
+    value.routingMode,
+    "hold"
+  );
   return {
     id: stringValue3(value.id) ?? `worker:${index + 1}`,
-    role: roleValue(value.role, "main_agent"),
-    label: stringValue3(value.label) ?? workerLabel(roleValue(value.role, "main_agent")),
-    status: statusValue(value.status, "unknown"),
-    routingMode: routingModeValue(value.routingMode, "hold"),
+    role: role.value,
+    label: stringValue3(value.label) ?? workerLabel(role.value),
+    status: status.value,
+    routingMode: routingMode.value,
     workPackageId: stringValue3(value.workPackageId) ?? null,
     workPackageTitle: stringValue3(value.workPackageTitle) ?? null,
     owner: stringValue3(value.owner) ?? null,
@@ -10795,7 +10847,16 @@ function normalizeWorkerRecommendation(value, index) {
     proofGates: stringList(value.proofGates),
     brainUpdateCandidates: stringList(value.brainUpdateCandidates),
     evidence: normalizeEvidence(value.evidence),
-    reasonCodes: stringList(value.reasonCodes)
+    reasonCodes: [
+      .../* @__PURE__ */ new Set([
+        ...stringList(value.reasonCodes),
+        ...compactReasonCodes([
+          role.droppedReasonCode,
+          status.droppedReasonCode,
+          routingMode.droppedReasonCode
+        ])
+      ])
+    ]
   };
 }
 function normalizeCockpitPlan(cockpit) {
@@ -10804,10 +10865,25 @@ function normalizeCockpitPlan(cockpit) {
   const workerRecommendations = recordList2(rawPlan.workerRecommendations).map(
     normalizeWorkerRecommendation
   );
+  const posture = cockpitEnumValue(
+    "posture",
+    ENGINEERING_LEAD_POSTURES,
+    rawPlan.posture,
+    "lead_cold_start"
+  );
+  const status = cockpitEnumValue(
+    "status",
+    ENGINEERING_LEAD_STATUSES,
+    rawPlan.status,
+    statusForScore(score)
+  );
+  const workerDroppedReasonCodes = workerRecommendations.flatMap(
+    (worker) => worker.reasonCodes.filter((code2) => code2.startsWith("companion_dropped_unknown_"))
+  );
   return {
-    version: "project-intelligence-engineering-lead-plan-v0",
-    posture: postureValue(rawPlan.posture, "lead_cold_start"),
-    status: statusValue(rawPlan.status, statusForScore(score)),
+    version: PROJECT_INTELLIGENCE_ENGINEERING_LEAD_PLAN_VERSION,
+    posture: posture.value,
+    status: status.value,
     score,
     headline: stringValue3(rawPlan.headline) ?? "Imported Project Health Engineering Lead Plan.",
     operatingMode: "advisory_fail_closed",
@@ -10832,7 +10908,9 @@ function normalizeCockpitPlan(cockpit) {
     reasonCodes: [
       .../* @__PURE__ */ new Set([
         "companion_imported_project_health_lead_plan",
-        ...stringList(rawPlan.reasonCodes)
+        ...compactReasonCodes([posture.droppedReasonCode, status.droppedReasonCode]),
+        ...stringList(rawPlan.reasonCodes),
+        ...workerDroppedReasonCodes
       ])
     ]
   };
@@ -24805,6 +24883,10 @@ if (require.main === module) {
   AutomationInstallConflictError,
   AutomationUnsupportedHookBundleError,
   COLLABORATION_STATE_RELATIVE_PATH,
+  ENGINEERING_LEAD_POSTURES,
+  ENGINEERING_LEAD_ROUTING_MODES,
+  ENGINEERING_LEAD_STATUSES,
+  ENGINEERING_LEAD_WORKER_ROLES,
   ORCHESTRATOR_HANDOFF_RELATIVE_PATH,
   TEAM_SYNC_STATE_RELATIVE_PATH,
   WORKFLOW_PLANS_RELATIVE_DIR,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snipara-companion",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Local-first CLI that asks your repo what breaks before an AI coding agent edits it.",
   "main": "dist/index.js",
   "bin": {
@@ -57,6 +57,7 @@
     "conf": "^12.0.0"
   },
   "devDependencies": {
+    "@snipara/project-intelligence-contracts": "workspace:*",
     "@eslint/js": "^9.39.3",
     "@types/node": "^20.19.31",
     "@typescript-eslint/eslint-plugin": "^8.56.0",