oxe-cc 1.11.0 → 1.14.0

package/lib/sdk/index.cjs

@@ -560,6 +560,8 @@ module.exports = {
     loadOxeConfigMerged: health.loadOxeConfigMerged,
     validateConfigShape: health.validateConfigShape,
     buildHealthReport: health.buildHealthReport,
+    buildStatusSummary: health.buildStatusSummary,
+    agentSkillsReport: health.agentSkillsReport,
     detectWorkspaceMode: health.detectWorkspaceMode,
     shouldSuppressExecutionWorkspaceGates: health.shouldSuppressExecutionWorkspaceGates,
     suggestNextStep: health.suggestNextStep,

package/lib/sdk/index.d.ts

@@ -45,6 +45,30 @@ export interface OxeNextSuggestion {
   artifacts: string[];
 }
 
+/** Compact, host-facing projection of the health report (versioned). */
+export interface OxeStatusSummary {
+  oxeSummarySchema: number;
+  workspaceMode: string;
+  phase: string | null;
+  healthStatus: string | null;
+  activeSession: string | null;
+  nextStep: string | null;
+  cursorCmd: string | null;
+  reason: string | null;
+  eventsCount: number;
+  warningsCount: number;
+}
+
+/** Per-agent OXE skills/integration status for a workspace. */
+export interface AgentSkillsStatus {
+  agent: string;
+  detected: boolean;
+  skillsInstalled: boolean;
+  skillsPath: string;
+  status: string;
+  issues: string[];
+}
+
 export interface AzureInventorySummary {
   total: number;
   servicebus: number;
@@ -146,54 +170,54 @@ export interface GateQueueSnapshot {
   all?: Array<Record<string, unknown>>;
 }
 
-export interface MultiAgentStatusSummary {
-  path: string | null;
-  enabled: boolean;
-  runId: string | null;
-  mode: string | null;
+export interface MultiAgentStatusSummary {
+  path: string | null;
+  enabled: boolean;
+  runId: string | null;
+  mode: string | null;
   workspaceIsolationEnforced: boolean;
   agents: Array<Record<string, unknown>>;
-  ownership: Array<Record<string, unknown>>;
-  orphanReassignments: Array<Record<string, unknown>>;
-  handoffs: Array<Record<string, unknown>>;
-  arbitrationResults: Array<Record<string, unknown>>;
-  summary?: Record<string, unknown> | null;
-}
-
-export type WorkspaceMode = 'product_package' | 'oxe_project';
-
-export interface ReleaseManifest {
-  schema_version: number;
-  generated_at: string;
-  project_root: string;
-  package_root: string;
-  release_contract: Record<string, unknown>;
-  versions: Record<string, unknown>;
-  runtime_compiled: { path: string; ok: boolean };
-  canonical_source?: Record<string, unknown>;
-  semantics?: Record<string, unknown>;
-  wrappers: Record<string, unknown>;
-  reports: Record<string, unknown>;
-}
-
-export interface ReleaseConsistencyResult {
-  ok: boolean;
-  blockers: string[];
-  warnings: string[];
-  manifest: ReleaseManifest;
-  manifestPath: string;
-}
-
-export interface RuntimeSmokeReport {
-  path: string;
-  present: boolean;
-  ok: boolean;
-  total: number;
-  failures: string[];
-  missingRequired: string[];
-  results: Array<Record<string, unknown>>;
-  raw: Record<string, unknown> | null;
-}
+  ownership: Array<Record<string, unknown>>;
+  orphanReassignments: Array<Record<string, unknown>>;
+  handoffs: Array<Record<string, unknown>>;
+  arbitrationResults: Array<Record<string, unknown>>;
+  summary?: Record<string, unknown> | null;
+}
+
+export type WorkspaceMode = 'product_package' | 'oxe_project';
+
+export interface ReleaseManifest {
+  schema_version: number;
+  generated_at: string;
+  project_root: string;
+  package_root: string;
+  release_contract: Record<string, unknown>;
+  versions: Record<string, unknown>;
+  runtime_compiled: { path: string; ok: boolean };
+  canonical_source?: Record<string, unknown>;
+  semantics?: Record<string, unknown>;
+  wrappers: Record<string, unknown>;
+  reports: Record<string, unknown>;
+}
+
+export interface ReleaseConsistencyResult {
+  ok: boolean;
+  blockers: string[];
+  warnings: string[];
+  manifest: ReleaseManifest;
+  manifestPath: string;
+}
+
+export interface RuntimeSmokeReport {
+  path: string;
+  present: boolean;
+  ok: boolean;
+  total: number;
+  failures: string[];
+  missingRequired: string[];
+  results: Array<Record<string, unknown>>;
+  raw: Record<string, unknown> | null;
+}
 
 export interface PolicyDecisionSummary {
   total: number;
@@ -229,67 +253,67 @@ export interface AuditSummary {
   actions: Record<string, number>;
 }
 
-export interface PromotionSummary {
-  status: string | null;
-  targetKind: string | null;
-  remote: string | null;
-  targetRef: string | null;
-  prUrl: string | null;
-  prNumber: number | null;
-  coveragePercent: number | null;
-  reasons: string[];
-  path: string;
-}
-
-export interface ExecutionImplementationPackSummary {
-  path: string | null;
-  exists: boolean;
-  parseError: string | null;
-  ready: boolean;
-  tasks: Array<Record<string, unknown>>;
-  taskCount: number;
-  mutatingTasks: number;
-  criticalGaps: string[];
-}
-
-export interface ExecutionReferenceAnchorsSummary {
-  path: string | null;
-  exists: boolean;
-  ready: boolean;
-  anchors: Array<Record<string, unknown>>;
-  missingCriticalCount: number;
-  staleCount: number;
-  criticalGaps: string[];
-}
-
-export interface ExecutionFixturePackSummary {
-  path: string | null;
-  exists: boolean;
-  parseError: string | null;
-  ready: boolean;
-  fixtures: Array<Record<string, unknown>>;
-  fixtureCount: number;
-  criticalGaps: string[];
-}
-
-export interface ExecutionRationalitySummary {
-  applicable: boolean;
-  planTaskCount: number;
-  externalReferenceCount: number;
-  implementationPackReady: boolean;
-  referenceAnchorsReady: boolean;
-  fixturePackReady: boolean;
-  executionRationalityReady: boolean;
-  criticalExecutionGaps: string[];
-  implementationPack: ExecutionImplementationPackSummary;
-  referenceAnchors: ExecutionReferenceAnchorsSummary;
-  fixturePack: ExecutionFixturePackSummary;
-}
+export interface PromotionSummary {
+  status: string | null;
+  targetKind: string | null;
+  remote: string | null;
+  targetRef: string | null;
+  prUrl: string | null;
+  prNumber: number | null;
+  coveragePercent: number | null;
+  reasons: string[];
+  path: string;
+}
+
+export interface ExecutionImplementationPackSummary {
+  path: string | null;
+  exists: boolean;
+  parseError: string | null;
+  ready: boolean;
+  tasks: Array<Record<string, unknown>>;
+  taskCount: number;
+  mutatingTasks: number;
+  criticalGaps: string[];
+}
+
+export interface ExecutionReferenceAnchorsSummary {
+  path: string | null;
+  exists: boolean;
+  ready: boolean;
+  anchors: Array<Record<string, unknown>>;
+  missingCriticalCount: number;
+  staleCount: number;
+  criticalGaps: string[];
+}
+
+export interface ExecutionFixturePackSummary {
+  path: string | null;
+  exists: boolean;
+  parseError: string | null;
+  ready: boolean;
+  fixtures: Array<Record<string, unknown>>;
+  fixtureCount: number;
+  criticalGaps: string[];
+}
+
+export interface ExecutionRationalitySummary {
+  applicable: boolean;
+  planTaskCount: number;
+  externalReferenceCount: number;
+  implementationPackReady: boolean;
+  referenceAnchorsReady: boolean;
+  fixturePackReady: boolean;
+  executionRationalityReady: boolean;
+  criticalExecutionGaps: string[];
+  implementationPack: ExecutionImplementationPackSummary;
+  referenceAnchors: ExecutionReferenceAnchorsSummary;
+  fixturePack: ExecutionFixturePackSummary;
+}
 
 /** Relatório retornado por `health.buildHealthReport` e incluído em `runDoctorChecks`.healthReport. */
-export interface OxeHealthReport {
-  workspaceMode?: WorkspaceMode;
-  configPath: string | null;
+export interface OxeHealthReport {
+  workspaceMode?: WorkspaceMode;
+  configPath: string | null;
   configParseError: string | null;
   unknownConfigKeys: string[];
   typeErrors: string[];
@@ -310,16 +334,16 @@ export interface OxeHealthReport {
   copilotWarn?: string[];
   copilot?: CopilotIntegrationReport | null;
   summaryGapWarn: string | null;
-  specWarn: string[];
-  planWarn: string[];
-  planSelfEvaluation?: Record<string, unknown> | null;
-  implementationPackReady?: boolean;
-  referenceAnchorsReady?: boolean;
-  fixturePackReady?: boolean;
-  executionRationalityReady?: boolean;
-  criticalExecutionGaps?: string[];
-  executionRationality?: ExecutionRationalitySummary | null;
-  planReviewStatus?: string | null;
+  specWarn: string[];
+  planWarn: string[];
+  planSelfEvaluation?: Record<string, unknown> | null;
+  implementationPackReady?: boolean;
+  referenceAnchorsReady?: boolean;
+  fixturePackReady?: boolean;
+  executionRationalityReady?: boolean;
+  criticalExecutionGaps?: string[];
+  executionRationality?: ExecutionRationalitySummary | null;
+  planReviewStatus?: string | null;
   activeRun?: Record<string, unknown> | null;
   eventsSummary?: Record<string, unknown> | null;
   memoryLayers?: Record<string, unknown> | null;
@@ -339,10 +363,10 @@ export interface OxeHealthReport {
   contextWarn?: string[];
   semanticsWarn?: string[];
   contextPacks?: Record<string, ContextPackSummary>;
-  contextQuality?: ContextQualitySummary;
-  semanticsDrift?: SemanticsDriftSummary;
-  releaseReadiness?: ReleaseConsistencyResult | null;
-  packFreshness?: Record<string, PackFreshness>;
+  contextQuality?: ContextQualitySummary;
+  semanticsDrift?: SemanticsDriftSummary;
+  releaseReadiness?: ReleaseConsistencyResult | null;
+  packFreshness?: Record<string, PackFreshness>;
   activeSummaryRefs?: { project: string | null; session: string | null; phase: string | null };
   scanFocusGlobs?: unknown;
   scanIgnoreGlobs?: unknown;
@@ -673,12 +697,12 @@ export interface OxeSdk {
   readMinNode: (packageRoot: string) => number;
 
   /** Parsing de artefatos OXE. */
-  parsePlan: (planMd: string) => ParsedPlan;
-  parseHypotheses: (planText: string) => CriticalHypothesis[];
-  parseConfidenceVector: (planText: string) => ConfidenceVector | null;
-  parseExecutionPlanTasks: (planPath: string | null) => Array<Record<string, unknown>>;
-  parseSpec: (specMd: string) => ParsedSpec;
-  parseState: (stateMd: string) => ParsedState;
+  parsePlan: (planMd: string) => ParsedPlan;
+  parseHypotheses: (planText: string) => CriticalHypothesis[];
+  parseConfidenceVector: (planText: string) => ConfidenceVector | null;
+  parseExecutionPlanTasks: (planPath: string | null) => Array<Record<string, unknown>>;
+  parseSpec: (specMd: string) => ParsedSpec;
+  parseState: (stateMd: string) => ParsedState;
   validateDecisionFidelity: (discussMd: string, planMd: string) => DecisionFidelityResult;
   parseLessonsMetrics: (metricsJson: string) => LessonMetric[];
   updateLessonMetric: (metrics: LessonMetric[], lessonId: string, outcome: LessonOutcome) => LessonMetric[];
@@ -695,13 +719,15 @@ export interface OxeSdk {
     timeoutMs?: number;
   }) => Promise<Record<string, unknown>>;
 
-  health: {
-    loadOxeConfigMerged: (targetProject: string) => { config: Record<string, unknown>; path: string | null; parseError: string | null; sources: { system: string | null; user: string | null; project: string | null } };
-    validateConfigShape: (cfg: Record<string, unknown>) => { unknownKeys: string[]; typeErrors: string[] };
-    buildHealthReport: (target: string) => OxeHealthReport;
-    detectWorkspaceMode: (target: string) => { workspaceMode: WorkspaceMode; packageName: string | null; canonicalTreePresent: boolean; commandsTreePresent: boolean };
-    shouldSuppressExecutionWorkspaceGates: (workspaceMode: WorkspaceMode, phase?: string | null, activeSession?: string | null, activeRun?: Record<string, unknown> | null) => boolean;
-    suggestNextStep: (target: string, cfg?: { discuss_before_plan?: boolean }) => OxeNextSuggestion;
+  health: {
+    loadOxeConfigMerged: (targetProject: string) => { config: Record<string, unknown>; path: string | null; parseError: string | null; sources: { system: string | null; user: string | null; project: string | null } };
+    validateConfigShape: (cfg: Record<string, unknown>) => { unknownKeys: string[]; typeErrors: string[] };
+    buildHealthReport: (target: string) => OxeHealthReport;
+    buildStatusSummary: (report: OxeHealthReport) => OxeStatusSummary;
+    agentSkillsReport: (target: string) => AgentSkillsStatus[];
+    detectWorkspaceMode: (target: string) => { workspaceMode: WorkspaceMode; packageName: string | null; canonicalTreePresent: boolean; commandsTreePresent: boolean };
+    shouldSuppressExecutionWorkspaceGates: (workspaceMode: WorkspaceMode, phase?: string | null, activeSession?: string | null, activeRun?: Record<string, unknown> | null) => boolean;
+    suggestNextStep: (target: string, cfg?: { discuss_before_plan?: boolean }) => OxeNextSuggestion;
     oxePaths: (target: string) => Record<string, string>;
     parseStatePhase: (stateText: string) => string | null;
     parseLastScanDate: (stateText: string) => Date | null;
@@ -714,12 +740,12 @@ export interface OxeSdk {
     copilotIntegrationReport: (target: string) => CopilotIntegrationReport;
     planAgentsWarnings: (target: string) => string[];
     phaseCoherenceWarnings: (phase: string, paths: Record<string, string>) => string[];
-    specSectionWarnings: (specPath: string, requiredHeadings: string[]) => string[];
-    planWaveWarningsFixed: (planPath: string, maxPerWave: number) => string[];
-    planTaskAceiteWarnings: (planPath: string) => string[];
-    buildExecutionRationality: (paths?: Record<string, string | null | undefined>) => ExecutionRationalitySummary;
-    executionRationalityWarningsFromSummary: (summary: ExecutionRationalitySummary) => string[];
-    verifyGapsWithoutSummaryWarning: (verifyPath: string, summaryPath: string) => string | null;
+    specSectionWarnings: (specPath: string, requiredHeadings: string[]) => string[];
+    planWaveWarningsFixed: (planPath: string, maxPerWave: number) => string[];
+    planTaskAceiteWarnings: (planPath: string) => string[];
+    buildExecutionRationality: (paths?: Record<string, string | null | undefined>) => ExecutionRationalitySummary;
+    executionRationalityWarningsFromSummary: (summary: ExecutionRationalitySummary) => string[];
+    verifyGapsWithoutSummaryWarning: (verifyPath: string, summaryPath: string) => string | null;
     expandExecutionProfile: (profile: string) => Record<string, unknown>;
     ALLOWED_CONFIG_KEYS: string[];
     EXECUTION_PROFILES: string[];
@@ -779,27 +805,27 @@ export interface OxeSdk {
     installNpmPlugin: (projectRoot: string, pkgName: string, version?: string) => { ok: boolean; path: string; error: string };
   };
 
-  dashboard: {
-    loadDashboardContext: (projectRoot: string, opts?: { activeSession?: string | null }) => Record<string, unknown>;
-    savePlanReviewStatus: (projectRoot: string, input?: Record<string, unknown>) => Record<string, unknown>;
-    addPlanReviewComment: (projectRoot: string, input?: Record<string, unknown>) => Record<string, unknown>;
-    updatePlanReviewCommentStatus: (projectRoot: string, input?: Record<string, unknown>) => Record<string, unknown> | null;
-  };
-
-  release: {
-    REQUIRED_RUNTIMES: string[];
-    WRAPPER_TARGETS: Array<Record<string, unknown>>;
-    releasePaths: (projectRoot: string) => Record<string, string>;
-    collectWrapperHashes: (projectRoot: string) => Record<string, unknown>;
-    loadRuntimeSmokeReport: (projectRoot: string) => RuntimeSmokeReport;
-    loadRecoveryFixtureReport: (projectRoot: string) => RuntimeSmokeReport;
-    loadMultiAgentSoakReport: (projectRoot: string) => RuntimeSmokeReport;
-    buildReleaseManifest: (projectRoot: string, options?: Record<string, unknown>) => ReleaseManifest;
-    inspectCanonicalSource: (projectRoot: string) => Record<string, unknown>;
-    evaluateReleaseManifest: (manifest: ReleaseManifest, options?: Record<string, unknown>) => ReleaseConsistencyResult;
-    inspectReleaseReadiness: (projectRoot: string, options?: Record<string, unknown>) => ReleaseConsistencyResult;
-    checkReleaseConsistency: (projectRoot: string, options?: Record<string, unknown>) => ReleaseConsistencyResult;
-  };
+  dashboard: {
+    loadDashboardContext: (projectRoot: string, opts?: { activeSession?: string | null }) => Record<string, unknown>;
+    savePlanReviewStatus: (projectRoot: string, input?: Record<string, unknown>) => Record<string, unknown>;
+    addPlanReviewComment: (projectRoot: string, input?: Record<string, unknown>) => Record<string, unknown>;
+    updatePlanReviewCommentStatus: (projectRoot: string, input?: Record<string, unknown>) => Record<string, unknown> | null;
+  };
+
+  release: {
+    REQUIRED_RUNTIMES: string[];
+    WRAPPER_TARGETS: Array<Record<string, unknown>>;
+    releasePaths: (projectRoot: string) => Record<string, string>;
+    collectWrapperHashes: (projectRoot: string) => Record<string, unknown>;
+    loadRuntimeSmokeReport: (projectRoot: string) => RuntimeSmokeReport;
+    loadRecoveryFixtureReport: (projectRoot: string) => RuntimeSmokeReport;
+    loadMultiAgentSoakReport: (projectRoot: string) => RuntimeSmokeReport;
+    buildReleaseManifest: (projectRoot: string, options?: Record<string, unknown>) => ReleaseManifest;
+    inspectCanonicalSource: (projectRoot: string) => Record<string, unknown>;
+    evaluateReleaseManifest: (manifest: ReleaseManifest, options?: Record<string, unknown>) => ReleaseConsistencyResult;
+    inspectReleaseReadiness: (projectRoot: string, options?: Record<string, unknown>) => ReleaseConsistencyResult;
+    checkReleaseConsistency: (projectRoot: string, options?: Record<string, unknown>) => ReleaseConsistencyResult;
+  };
 
   context: ContextAPI;
   runtimeSemantics: RuntimeSemanticsAPI;

package/oxe/schemas/swarm-run.schema.json

@@ -0,0 +1,130 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OXE Swarm Run",
+  "description": "Schema para SWARM-RUN.json — estado de um Swarm Mode run",
+  "type": "object",
+  "required": ["run_id", "started_at", "status", "objective", "agents"],
+  "properties": {
+    "run_id": {
+      "type": "string",
+      "pattern": "^swarm-\\d{8}-\\d{3}$",
+      "description": "ID único do swarm run (swarm-YYYYMMDD-NNN)"
+    },
+    "started_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "completed_at": {
+      "type": ["string", "null"],
+      "format": "date-time"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["running", "paused", "completed", "partial", "failed", "aborted"]
+    },
+    "objective": {
+      "type": "string",
+      "description": "Objetivo em linguagem natural fornecido pelo usuário"
+    },
+    "intent_tags": {
+      "type": "array",
+      "items": {"type": "string"},
+      "description": "Domínios detectados: backend, frontend, storage, auth, infra, test, docs, config"
+    },
+    "memory_applied": {
+      "type": "boolean"
+    },
+    "memory_sources": {
+      "type": "array",
+      "items": {"type": "string"},
+      "description": "Caminhos dos artefatos de memória injetados"
+    },
+    "agents": {
+      "type": "object",
+      "properties": {
+        "scout": {
+          "$ref": "#/definitions/AgentStatus"
+        },
+        "coordinator": {
+          "$ref": "#/definitions/AgentStatus"
+        },
+        "builders": {
+          "type": "array",
+          "items": {
+            "allOf": [
+              {"$ref": "#/definitions/AgentStatus"},
+              {
+                "properties": {
+                  "id": {"type": "string"},
+                  "persona": {"type": "string"},
+                  "task_ids": {"type": "array", "items": {"type": "string"}},
+                  "model_hint": {"type": "string", "enum": ["fast", "balanced", "powerful"]}
+                }
+              }
+            ]
+          }
+        },
+        "reviewer": {
+          "$ref": "#/definitions/AgentStatus"
+        },
+        "verifier": {
+          "$ref": "#/definitions/AgentStatus"
+        }
+      }
+    },
+    "task_graph": {
+      "type": ["object", "null"],
+      "description": "Referência ao TASK-GRAPH.json após decomposição pelo coordinator"
+    },
+    "file_ownership": {
+      "type": ["object", "null"],
+      "description": "Referência ao FILE-OWNERSHIP.json após atribuição"
+    },
+    "waves": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "wave": {"type": "integer"},
+          "task_ids": {"type": "array", "items": {"type": "string"}},
+          "status": {"type": "string", "enum": ["pending", "running", "done", "failed"]}
+        }
+      }
+    },
+    "quality_gates": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {"type": "string"},
+          "condition": {"type": "string"},
+          "type": {"type": "string", "enum": ["auto", "human"]},
+          "status": {"type": "string", "enum": ["pending", "passed", "failed", "waived"]},
+          "resolved_at": {"type": ["string", "null"]},
+          "resolved_by": {"type": ["string", "null"]}
+        }
+      }
+    },
+    "learning": {
+      "type": "object",
+      "properties": {
+        "distill_status": {"type": "string", "enum": ["pending", "done", "skipped"]},
+        "lessons_added": {"type": "integer"},
+        "skill_candidates": {"type": "integer"}
+      }
+    }
+  },
+  "definitions": {
+    "AgentStatus": {
+      "type": "object",
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": ["pending", "running", "done", "failed", "skipped"]
+        },
+        "started_at": {"type": ["string", "null"]},
+        "completed_at": {"type": ["string", "null"]}
+      }
+    }
+  }
+}