oxe-cc 1.12.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oxe-cc",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "description": "OXE — spec-driven workflows in .oxe/ with runtime enterprise, evidence-first verification and multi-runtime integrations (npx)",
   "license": "MIT",
   "author": "",
@@ -68,7 +68,7 @@
     "sync:cursor": "node scripts/sync-cursor-from-prompts.cjs",
     "release:doctor": "node scripts/release-doctor.cjs",
     "release:manifest": "node scripts/release-doctor.cjs --write-manifest",
-    "test:root": "node --test tests/install.test.cjs tests/oxe-project-health.test.cjs tests/oxe-dashboard.test.cjs tests/oxe-operational.test.cjs tests/oxe-azure.test.cjs tests/oxe-sdk.test.cjs tests/oxe-manifest.test.cjs tests/oxe-agent-install.test.cjs tests/oxe-install-resolve-full.test.cjs tests/oxe-health-extended.test.cjs tests/oxe-workflows-edge.test.cjs tests/oxe-sdk-edge.test.cjs tests/oxe-cli-edge.test.cjs tests/oxe-npm-version.test.cjs tests/oxe-scripts.test.cjs tests/oxe-retro-health.test.cjs tests/oxe-security-permissions.test.cjs tests/oxe-runtime-semantics.test.cjs tests/oxe-plugins.test.cjs",
+    "test:root": "node --test tests/install.test.cjs tests/oxe-project-health.test.cjs tests/oxe-dashboard.test.cjs tests/oxe-operational.test.cjs tests/oxe-azure.test.cjs tests/oxe-sdk.test.cjs tests/oxe-manifest.test.cjs tests/oxe-agent-install.test.cjs tests/oxe-install-resolve-full.test.cjs tests/oxe-health-extended.test.cjs tests/oxe-workflows-edge.test.cjs tests/oxe-sdk-edge.test.cjs tests/oxe-cli-edge.test.cjs tests/oxe-npm-version.test.cjs tests/oxe-scripts.test.cjs tests/oxe-retro-health.test.cjs tests/oxe-security-permissions.test.cjs tests/oxe-runtime-semantics.test.cjs tests/oxe-plugins.test.cjs tests/oxe-status-summary.test.cjs tests/oxe-integration-contracts.test.cjs",
     "test:runtime": "cd packages/runtime && npm test",
     "test:runtime-smoke": "node scripts/runtime-smoke-matrix.cjs",
     "test:runtime-real": "node scripts/runtime-real-suite.cjs",

package/packages/runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxe/runtime",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "private": true,
   "license": "MIT",
   "description": "OXE agentic execution engine — enterprise runtime core",

package/vscode-extension/package.json

@@ -2,7 +2,7 @@
   "name": "oxe-agents",
   "displayName": "OXE Agents",
   "description": "Agentes OXE para GitHub Copilot Chat — cada fase do ciclo como um @agente no VS Code",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "publisher": "oxe-cc",
   "license": "MIT",
   "engines": {