@coreframe/dev-contracts 0.1.11 → 0.1.13

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { devJobsEnv, devJobsPath, devJobsTokenHeader } from "./dev-jobs.js";
 import { DevelopmentControlAction, DevelopmentControlActionRequest, DevelopmentControlActionResponse, developmentControlsEvents } from "./development-controls.js";
 import { FlutterDevToolsIdentity, FlutterDevToolsLauncherIdentity, FlutterDevToolsNativeConnect, FlutterDevToolsPageConnect, FlutterDevToolsReady, FlutterDevToolsStateLauncherConnection, FlutterDevToolsStateLauncherRequest, FlutterDevToolsStateLauncherResult, FlutterDevToolsStateLauncherState, flutterDevToolsEvents, flutterDevToolsProtocolVersion } from "./flutter-devtools.js";
-import { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDiagnosticRequest, ManagedDevDraft, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix } from "./managed-dev.js";
-export { DevelopmentControlAction, DevelopmentControlActionRequest, DevelopmentControlActionResponse, FlutterDevToolsIdentity, FlutterDevToolsLauncherIdentity, FlutterDevToolsNativeConnect, FlutterDevToolsPageConnect, FlutterDevToolsReady, FlutterDevToolsStateLauncherConnection, FlutterDevToolsStateLauncherRequest, FlutterDevToolsStateLauncherResult, FlutterDevToolsStateLauncherState, ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDiagnosticRequest, ManagedDevDraft, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, devJobsEnv, devJobsPath, devJobsTokenHeader, developmentControlsEvents, flutterDevToolsEvents, flutterDevToolsProtocolVersion, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix };
+import { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevActivity, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCodexStage, ManagedDevCommit, ManagedDevDiagnosticRequest, ManagedDevDraft, ManagedDevOperation, ManagedDevOperationPhase, ManagedDevOperationStep, ManagedDevOperationTurn, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, isManagedDevOperationActive, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv, managedDevOperationPhases, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix } from "./managed-dev.js";
+export { DevelopmentControlAction, DevelopmentControlActionRequest, DevelopmentControlActionResponse, FlutterDevToolsIdentity, FlutterDevToolsLauncherIdentity, FlutterDevToolsNativeConnect, FlutterDevToolsPageConnect, FlutterDevToolsReady, FlutterDevToolsStateLauncherConnection, FlutterDevToolsStateLauncherRequest, FlutterDevToolsStateLauncherResult, FlutterDevToolsStateLauncherState, ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevActivity, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCodexStage, ManagedDevCommit, ManagedDevDiagnosticRequest, ManagedDevDraft, ManagedDevOperation, ManagedDevOperationPhase, ManagedDevOperationStep, ManagedDevOperationTurn, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, devJobsEnv, devJobsPath, devJobsTokenHeader, developmentControlsEvents, flutterDevToolsEvents, flutterDevToolsProtocolVersion, isManagedDevOperationActive, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv, managedDevOperationPhases, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix };

package/dist/index.js

@@ -1 +1 @@
-import{devJobsEnv as e,devJobsPath as t,devJobsTokenHeader as n}from"./dev-jobs.js";import{developmentControlsEvents as r}from"./development-controls.js";import{flutterDevToolsEvents as i,flutterDevToolsProtocolVersion as a}from"./flutter-devtools.js";import{managedDevCodexEfforts as o,managedDevCodexModels as s,managedDevEnv as c,managedDevEvents as l,managedDevFlutterRestartFileEnv as u,managedDevSupervisorRecoveryErrorPrefix as d,managedDevSupervisorRecoveryPrefix as f}from"./managed-dev.js";export{e as devJobsEnv,t as devJobsPath,n as devJobsTokenHeader,r as developmentControlsEvents,i as flutterDevToolsEvents,a as flutterDevToolsProtocolVersion,o as managedDevCodexEfforts,s as managedDevCodexModels,c as managedDevEnv,l as managedDevEvents,u as managedDevFlutterRestartFileEnv,d as managedDevSupervisorRecoveryErrorPrefix,f as managedDevSupervisorRecoveryPrefix};
+import{devJobsEnv as e,devJobsPath as t,devJobsTokenHeader as n}from"./dev-jobs.js";import{developmentControlsEvents as r}from"./development-controls.js";import{flutterDevToolsEvents as i,flutterDevToolsProtocolVersion as a}from"./flutter-devtools.js";import{isManagedDevOperationActive as o,managedDevCodexEfforts as s,managedDevCodexModels as c,managedDevEnv as l,managedDevEvents as u,managedDevFlutterRestartFileEnv as d,managedDevOperationPhases as f,managedDevSupervisorRecoveryErrorPrefix as p,managedDevSupervisorRecoveryPrefix as m}from"./managed-dev.js";export{e as devJobsEnv,t as devJobsPath,n as devJobsTokenHeader,r as developmentControlsEvents,i as flutterDevToolsEvents,a as flutterDevToolsProtocolVersion,o as isManagedDevOperationActive,s as managedDevCodexEfforts,c as managedDevCodexModels,l as managedDevEnv,u as managedDevEvents,d as managedDevFlutterRestartFileEnv,f as managedDevOperationPhases,p as managedDevSupervisorRecoveryErrorPrefix,m as managedDevSupervisorRecoveryPrefix};

package/dist/managed-dev.d.ts

@@ -23,14 +23,20 @@ type ManagedDevTarget = ManagedDevCommit & {
 type ManagedDevDraft = {
   fingerprint: string;
   tracked: boolean;
+  trackedFiles?: Array<{
+    path: string;
+    status: string;
+    originalPath?: string;
+  }>;
   untracked: string[];
+  artifactFiles?: string[];
 };
 type ManagedDevCheck = {
   command: "pnpm test" | "pnpm typecheck";
   dismissed?: boolean;
   failureId?: string;
   output?: string;
-  status: "failed" | "passed" | "pending" | "running";
+  status: "failed" | "passed" | "pending" | "running" | "cancelled";
 };
 type ManagedDevCheckTrigger = "codegen-recovery" | "database-recovery" | "dependency-recovery" | "synchronization";
 type ManagedDevChecks = {
@@ -49,11 +55,91 @@ type ManagedDevSetupFailure = {
 };
 type ManagedDevPendingRebase = {
   /** Local commits replayed cleanly before the first conflict. */applied: number; /** Local commits still waiting to be replayed, starting with the conflicted one. */
-  commits: ManagedDevCommit[]; /** Conflicted paths at the stop point. */
+  commits: ManagedDevCommit[]; /** Original commits the replay dropped or skipped before stopping. */
+  dropped?: ManagedDevCommit[]; /** Conflicted paths at the stop point. */
   files: string[];
   target: ManagedDevTarget;
 };
+/** Observable work, retained in status so reconnecting overlays recover active calls. */
+type ManagedDevActivity = {
+  id: string;
+  label: string;
+  command?: string;
+  source: "codex" | "supervisor";
+  stage?: ManagedDevCodexStage;
+  status: "running" | "succeeded" | "failed" | "cancelled" | "interrupted";
+  startedAt: number;
+  finishedAt?: number;
+  output?: string;
+  exitCode?: number;
+};
+declare const managedDevOperationPhases: {
+  readonly preparing: "Preparing update";
+  readonly replaying: "Replaying commits";
+  readonly merging: "Merging branches";
+  readonly "awaiting-resolution": "Waiting for conflict resolution";
+  readonly resolving: "Resolving conflicts";
+  readonly verifying: "Verifying update";
+  readonly publishing: "Applying prepared update";
+  readonly setup: "Preparing environment";
+  readonly checks: "Running project checks";
+  readonly cleanup: "Cleaning up";
+  readonly finished: "Update finished";
+};
+type ManagedDevOperationPhase = keyof typeof managedDevOperationPhases;
+type ManagedDevOperationTurn = {
+  id: string;
+  stage: ManagedDevCodexStage;
+  startedAt: number;
+  finishedAt?: number;
+  status: "running" | "complete" | "failed" | "interrupted";
+  messages: ManagedDevCodexMessage[];
+  finalMessage?: string;
+};
+type ManagedDevOperationStep = {
+  id: string;
+  label: string;
+  phase: ManagedDevOperationPhase;
+  status: "running" | "succeeded" | "failed" | "interrupted";
+  startedAt: number;
+  finishedAt?: number;
+  pulse?: number;
+};
+/** The supervisor's bounded snapshot; sufficient to reconstruct the UI on any connection. */
+type ManagedDevOperation = {
+  id: string;
+  requestIds: string[];
+  revision: number;
+  sessionId: string;
+  source: "dev" | "upstream";
+  target: string;
+  kind: "rebase" | "merge" | "fast-forward";
+  state: "running" | "awaiting-resolution" | "cancelling" | "succeeded" | "cancelled" | "failed" | "interrupted";
+  phase: ManagedDevOperationPhase;
+  startedAt: number;
+  updatedAt: number;
+  finishedAt?: number;
+  cancellation: "available" | "requested" | "unavailable";
+  cancellationDeferred?: boolean;
+  published: boolean;
+  message?: string;
+  progress?: {
+    applied: number;
+    total?: number;
+    skipped: number;
+    remaining?: number;
+    current?: ManagedDevCommit;
+    files?: string[];
+  };
+  turns: ManagedDevOperationTurn[];
+  steps: ManagedDevOperationStep[];
+  activities: ManagedDevActivity[];
+  historyTruncated?: boolean;
+};
+declare function isManagedDevOperationActive(operation: ManagedDevOperation | undefined): boolean;
 type ManagedDevStatus = {
+  operation?: ManagedDevOperation;
+  activities?: ManagedDevActivity[];
   trace?: {
     sessionId: string;
     revision: number;
@@ -69,6 +155,7 @@ type ManagedDevStatus = {
   mode: "error" | "managed" | "unmanaged" | "waiting";
   pendingRebase?: ManagedDevPendingRebase;
   proposal?: string;
+  proposalUntracked?: string[];
   setupFailure?: ManagedDevSetupFailure;
   target?: ManagedDevTarget;
   warnings: string[];
@@ -78,6 +165,10 @@ type ManagedDevAction = {
   type: "acknowledge-codex";
 } | {
   type: "cancel-codex";
+  operationId?: string;
+} | {
+  type: "acknowledge-operation";
+  id: string;
 } | {
   failureId: string;
   type: "dismiss-check";
@@ -147,30 +238,49 @@ type ManagedDevCodexCompletion = {
   messages: ManagedDevCodexMessage[];
   totalCommits?: number;
 };
+/**
+ * Which workflow stage a Codex event belongs to within one integration action. Resolving and
+ * verifying are separate subprocesses; operation completion is only reached after the whole
+ * workflow finishes.
+ */
+type ManagedDevCodexStage = "resolve" | "verify";
 type ManagedDevCodexEvent = {
+  phase: "activity";
+  activity: ManagedDevActivity;
+  stage?: ManagedDevCodexStage;
+} | {
   commits: ManagedDevRebasedCommit[];
   message: ManagedDevCodexMessage;
   phase: "start";
+  stage?: ManagedDevCodexStage;
   totalCommits?: number;
+  currentCommit?: ManagedDevCommit;
+  files?: string[];
 } | {
   message: ManagedDevCodexMessage;
   phase: "message";
+  stage?: ManagedDevCodexStage;
 } | {
   finalMessage: string;
   phase: "complete";
+  stage?: ManagedDevCodexStage;
 } | {
   commits: ManagedDevRebasedCommit[];
   phase: "progress";
+  stage?: ManagedDevCodexStage;
   totalCommits?: number;
 } | {
   phase: "error";
+  stage?: ManagedDevCodexStage;
 };
 type ManagedDevActionRequest = {
+  clientId?: string;
   action: ManagedDevAction | ManagedDevRecoveryAction;
   requestId: string;
 };
 type ManagedDevActionResponse = Partial<ManagedDevActionResult> & {
   error?: string;
+  errorCode?: "UNKNOWN_REQUEST";
   requestId: string;
 };
 type ManagedDevCodexResponse = ManagedDevCodexEvent & {
@@ -189,4 +299,4 @@ type ManagedDevDiagnosticRequest = {
   pending?: boolean;
 };
 //#endregion
-export { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDiagnosticRequest, ManagedDevDraft, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix };
+export { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevActivity, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCodexStage, ManagedDevCommit, ManagedDevDiagnosticRequest, ManagedDevDraft, ManagedDevOperation, ManagedDevOperationPhase, ManagedDevOperationStep, ManagedDevOperationTurn, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, isManagedDevOperationActive, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv, managedDevOperationPhases, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix };

package/dist/managed-dev.js

@@ -1 +1 @@
-const e=`COREFRAME_MANAGED_DEV`,t=`COREFRAME_MANAGED_DEV_FLUTTER_RESTART_FILE`,n={action:`coreframe:managed-dev:action`,actionResult:`coreframe:managed-dev:action-result`,codex:`coreframe:managed-dev:codex`,diagnostic:`coreframe:managed-dev:diagnostic`,status:`coreframe:managed-dev:status`,statusRequest:`coreframe:managed-dev:status-request`},r=`Managed development supervisor `,i=`${r}recovery failed after `,a=[`gpt-6.1-sol`,`gpt-6-luna`],o=[`low`,`medium`,`high`,`xhigh`,`max`];export{o as managedDevCodexEfforts,a as managedDevCodexModels,e as managedDevEnv,n as managedDevEvents,t as managedDevFlutterRestartFileEnv,i as managedDevSupervisorRecoveryErrorPrefix,r as managedDevSupervisorRecoveryPrefix};
+const e=`COREFRAME_MANAGED_DEV`,t=`COREFRAME_MANAGED_DEV_FLUTTER_RESTART_FILE`,n={action:`coreframe:managed-dev:action`,actionResult:`coreframe:managed-dev:action-result`,codex:`coreframe:managed-dev:codex`,diagnostic:`coreframe:managed-dev:diagnostic`,status:`coreframe:managed-dev:status`,statusRequest:`coreframe:managed-dev:status-request`},r=`Managed development supervisor `,i=`${r}recovery failed after `,a={preparing:`Preparing update`,replaying:`Replaying commits`,merging:`Merging branches`,"awaiting-resolution":`Waiting for conflict resolution`,resolving:`Resolving conflicts`,verifying:`Verifying update`,publishing:`Applying prepared update`,setup:`Preparing environment`,checks:`Running project checks`,cleanup:`Cleaning up`,finished:`Update finished`};function o(e){return e?.state===`running`||e?.state===`cancelling`}const s=[`gpt-6.1-sol`,`gpt-6-luna`],c=[`low`,`medium`,`high`,`xhigh`,`max`];export{o as isManagedDevOperationActive,c as managedDevCodexEfforts,s as managedDevCodexModels,e as managedDevEnv,n as managedDevEvents,t as managedDevFlutterRestartFileEnv,a as managedDevOperationPhases,i as managedDevSupervisorRecoveryErrorPrefix,r as managedDevSupervisorRecoveryPrefix};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coreframe/dev-contracts",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Shared contracts for Coreframe managed development workflows",
   "repository": {
     "type": "git",