@coreframe/dev-contracts 0.1.14 → 0.2.0

package/dist/development-controls.d.ts

@@ -5,8 +5,6 @@ declare const developmentControlsEvents: {
 };
 type DevelopmentControlAction = {
   type: "restart-vite";
-} | {
-  type: "restart-flutter";
 };
 type DevelopmentControlActionRequest = {
   action: DevelopmentControlAction;

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 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, ManagedDevActivity, ManagedDevAlignmentRetry, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCodexRetry, ManagedDevCodexStage, ManagedDevCommit, ManagedDevDiagnosticRequest, ManagedDevDraft, ManagedDevOperation, ManagedDevOperationPhase, ManagedDevOperationStep, ManagedDevOperationTurn, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, canResetManagedDevBranches, 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, ManagedDevAlignmentRetry, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCodexRetry, ManagedDevCodexStage, ManagedDevCommit, ManagedDevDiagnosticRequest, ManagedDevDraft, ManagedDevOperation, ManagedDevOperationPhase, ManagedDevOperationStep, ManagedDevOperationTurn, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, canResetManagedDevBranches, devJobsEnv, devJobsPath, devJobsTokenHeader, developmentControlsEvents, flutterDevToolsEvents, flutterDevToolsProtocolVersion, isManagedDevOperationActive, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv, managedDevOperationPhases, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix };
+import { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevActivity, ManagedDevAlignmentRetry, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCodexRetry, ManagedDevCodexStage, ManagedDevCommit, ManagedDevDiagnosticRequest, ManagedDevDraft, ManagedDevHistory, ManagedDevOperation, ManagedDevOperationPhase, ManagedDevOperationStep, ManagedDevOperationTurn, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecovery, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, canResetManagedDevBranches, isManagedDevOperationActive, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, managedDevOperationPhases, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix } from "./managed-dev.js";
+export { DevelopmentControlAction, DevelopmentControlActionRequest, DevelopmentControlActionResponse, ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevActivity, ManagedDevAlignmentRetry, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCodexRetry, ManagedDevCodexStage, ManagedDevCommit, ManagedDevDiagnosticRequest, ManagedDevDraft, ManagedDevHistory, ManagedDevOperation, ManagedDevOperationPhase, ManagedDevOperationStep, ManagedDevOperationTurn, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecovery, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, canResetManagedDevBranches, devJobsEnv, devJobsPath, devJobsTokenHeader, developmentControlsEvents, isManagedDevOperationActive, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, 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{canResetManagedDevBranches as o,isManagedDevOperationActive as s,managedDevCodexEfforts as c,managedDevCodexModels as l,managedDevEnv as u,managedDevEvents as d,managedDevFlutterRestartFileEnv as f,managedDevOperationPhases as p,managedDevSupervisorRecoveryErrorPrefix as m,managedDevSupervisorRecoveryPrefix as h}from"./managed-dev.js";export{o as canResetManagedDevBranches,e as devJobsEnv,t as devJobsPath,n as devJobsTokenHeader,r as developmentControlsEvents,i as flutterDevToolsEvents,a as flutterDevToolsProtocolVersion,s as isManagedDevOperationActive,c as managedDevCodexEfforts,l as managedDevCodexModels,u as managedDevEnv,d as managedDevEvents,f as managedDevFlutterRestartFileEnv,p as managedDevOperationPhases,m as managedDevSupervisorRecoveryErrorPrefix,h 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{canResetManagedDevBranches as i,isManagedDevOperationActive as a,managedDevCodexEfforts as o,managedDevCodexModels as s,managedDevEnv as c,managedDevEvents as l,managedDevOperationPhases as u,managedDevSupervisorRecoveryErrorPrefix as d,managedDevSupervisorRecoveryPrefix as f}from"./managed-dev.js";export{i as canResetManagedDevBranches,e as devJobsEnv,t as devJobsPath,n as devJobsTokenHeader,r as developmentControlsEvents,a as isManagedDevOperationActive,o as managedDevCodexEfforts,s as managedDevCodexModels,c as managedDevEnv,l as managedDevEvents,u as managedDevOperationPhases,d as managedDevSupervisorRecoveryErrorPrefix,f as managedDevSupervisorRecoveryPrefix};

package/dist/managed-dev.d.ts

@@ -1,6 +1,5 @@
 //#region src/managed-dev.d.ts
 declare const managedDevEnv = "COREFRAME_MANAGED_DEV";
-declare const managedDevFlutterRestartFileEnv = "COREFRAME_MANAGED_DEV_FLUTTER_RESTART_FILE";
 declare const managedDevEvents: {
   readonly action: "coreframe:managed-dev:action";
   readonly actionResult: "coreframe:managed-dev:action-result";
@@ -49,7 +48,6 @@ type ManagedDevSetupFailure = {
   commit: string;
   message: string;
   output: string;
-  flutterRestartRequired?: boolean;
   restartRequired: boolean;
   stage: "codegen" | "dependencies" | "migration";
 };
@@ -147,6 +145,8 @@ type ManagedDevOperation = {
 declare function isManagedDevOperationActive(operation: ManagedDevOperation | undefined): boolean;
 declare function canResetManagedDevBranches(status: ManagedDevStatus | undefined): boolean;
 type ManagedDevCodexRetry = {
+  checkpoint?: string;
+  ignoreConsumed?: boolean;
   base: string;
   source: "dev" | "upstream";
   target: string;
@@ -158,7 +158,23 @@ type ManagedDevAlignmentRetry = {
   main: string;
   dev: string;
 };
+type ManagedDevHistory = {
+  main: string;
+  dev: string;
+  consumed?: string;
+  kind: "align" | "apply" | "review";
+  reason: string;
+};
+type ManagedDevRecovery = {
+  prepared?: string;
+  id: string;
+  main: string;
+  dev: string;
+  completed: boolean;
+};
 type ManagedDevStatus = {
+  history?: ManagedDevHistory;
+  recovery?: ManagedDevRecovery[];
   codexRetry?: ManagedDevCodexRetry;
   devAlignment?: ManagedDevAlignmentRetry;
   fetchFailure?: string;
@@ -185,6 +201,22 @@ type ManagedDevStatus = {
   warnings: string[];
 };
 type ManagedDevAction = {
+  type: "sync-dev";
+  main: string;
+  dev: string;
+  codex?: ManagedDevCodexOptions;
+} | {
+  type: "recover-history";
+  id: string;
+} | {
+  type: "apply-recovery";
+  id: string;
+  side: "main" | "dev" | "prepared";
+  codex?: ManagedDevCodexOptions;
+} | {
+  type: "discard-history";
+  id: string;
+} | {
   type: "reset-branches";
   operationId: string;
 } | {
@@ -337,4 +369,4 @@ type ManagedDevDiagnosticRequest = {
   pending?: boolean;
 };
 //#endregion
-export { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevActivity, ManagedDevAlignmentRetry, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCodexRetry, ManagedDevCodexStage, ManagedDevCommit, ManagedDevDiagnosticRequest, ManagedDevDraft, ManagedDevOperation, ManagedDevOperationPhase, ManagedDevOperationStep, ManagedDevOperationTurn, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, canResetManagedDevBranches, isManagedDevOperationActive, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv, managedDevOperationPhases, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix };
+export { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevActivity, ManagedDevAlignmentRetry, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCodexRetry, ManagedDevCodexStage, ManagedDevCommit, ManagedDevDiagnosticRequest, ManagedDevDraft, ManagedDevHistory, ManagedDevOperation, ManagedDevOperationPhase, ManagedDevOperationStep, ManagedDevOperationTurn, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecovery, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, canResetManagedDevBranches, isManagedDevOperationActive, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, 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={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`}function s(e){let t=e?.operation;return!!(t?.branchReset&&t.kind!==`fast-forward`&&(e?.pendingRebase||o(t)&&![`setup`,`checks`,`cleanup`,`finished`].includes(t.phase)))}const c=[`gpt-6.1-sol`,`gpt-6-luna`],l=[`low`,`medium`,`high`,`xhigh`,`max`];export{s as canResetManagedDevBranches,o as isManagedDevOperationActive,l as managedDevCodexEfforts,c as managedDevCodexModels,e as managedDevEnv,n as managedDevEvents,t as managedDevFlutterRestartFileEnv,a as managedDevOperationPhases,i as managedDevSupervisorRecoveryErrorPrefix,r as managedDevSupervisorRecoveryPrefix};
+const e=`COREFRAME_MANAGED_DEV`,t={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`},n=`Managed development supervisor `,r=`${n}recovery failed after `,i={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 a(e){return e?.state===`running`||e?.state===`cancelling`}function o(e){let t=e?.operation;return!!(t?.branchReset&&t.kind!==`fast-forward`&&(e?.pendingRebase||a(t)&&![`setup`,`checks`,`cleanup`,`finished`].includes(t.phase)))}const s=[`gpt-6.1-sol`,`gpt-6-luna`],c=[`low`,`medium`,`high`,`xhigh`,`max`];export{o as canResetManagedDevBranches,a as isManagedDevOperationActive,c as managedDevCodexEfforts,s as managedDevCodexModels,e as managedDevEnv,t as managedDevEvents,i as managedDevOperationPhases,r as managedDevSupervisorRecoveryErrorPrefix,n as managedDevSupervisorRecoveryPrefix};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coreframe/dev-contracts",
-  "version": "0.1.14",
+  "version": "0.2.0",
   "description": "Shared contracts for Coreframe managed development workflows",
   "repository": {
     "type": "git",
@@ -24,10 +24,6 @@
       "types": "./dist/development-controls.d.ts",
       "default": "./dist/development-controls.js"
     },
-    "./flutter-devtools": {
-      "types": "./dist/flutter-devtools.d.ts",
-      "default": "./dist/flutter-devtools.js"
-    },
     "./managed-dev": {
       "types": "./dist/managed-dev.d.ts",
       "default": "./dist/managed-dev.js"

package/dist/flutter-devtools.d.ts

@@ -1,57 +0,0 @@
-//#region src/flutter-devtools.d.ts
-/** Wire-protocol version shared by the page, Vite broker, and native Flutter client. */
-declare const flutterDevToolsProtocolVersion = 1;
-/** Vite custom-event names for pairing Flutter development surfaces with their page runtime. */
-declare const flutterDevToolsEvents: {
-  readonly nativeConnect: "coreframe:flutter-devtools:native-connect";
-  readonly pageConnect: "coreframe:flutter-devtools:page-connect";
-  readonly pageDisconnect: "coreframe:flutter-devtools:page-disconnect";
-  readonly ready: "coreframe:flutter-devtools:ready";
-  readonly stateLauncherConnection: "coreframe:flutter-devtools:state-launcher-connection";
-  readonly stateLauncherRequest: "coreframe:flutter-devtools:state-launcher-request";
-  readonly stateLauncherResult: "coreframe:flutter-devtools:state-launcher-result";
-  readonly stateLauncherState: "coreframe:flutter-devtools:state-launcher-state";
-};
-/** Identifies one page-runtime epoch inside a Flutter shell session. */
-type FlutterDevToolsIdentity = {
-  applicationScopeId: string;
-  rootWebRuntimeId: string;
-  shellSessionId: string;
-};
-/** Identifies one WebView runtime without coupling it to application auth. */
-type FlutterDevToolsLauncherIdentity = Pick<FlutterDevToolsIdentity, "rootWebRuntimeId" | "shellSessionId"> & {
-  /** Kept optional so older scoped launcher messages remain source-compatible. */applicationScopeId?: string;
-};
-/** Registers an independent native client with the Vite broker. */
-type FlutterDevToolsNativeConnect = {
-  protocolVersion: typeof flutterDevToolsProtocolVersion;
-  shellSessionId: string;
-};
-/** Registers the current page-runtime epoch with the Vite broker. */
-type FlutterDevToolsPageConnect = FlutterDevToolsIdentity & {
-  protocolVersion: typeof flutterDevToolsProtocolVersion;
-};
-/** Reports server-owned capabilities to a registered native client. */
-type FlutterDevToolsReady = {
-  managedDev: boolean;
-  protocolVersion: typeof flutterDevToolsProtocolVersion;
-};
-/** Reports whether the native launcher has a current page-runtime peer. */
-type FlutterDevToolsStateLauncherConnection = {
-  connected: boolean;
-  identity?: FlutterDevToolsLauncherIdentity;
-};
-/** Routes a launcher request from the native client to its paired page. */
-type FlutterDevToolsStateLauncherRequest<Request = unknown> = FlutterDevToolsLauncherIdentity & {
-  request: Request;
-};
-/** Routes a launcher result from the paired page to its native client. */
-type FlutterDevToolsStateLauncherResult<Result = unknown> = FlutterDevToolsLauncherIdentity & {
-  result: Result;
-};
-/** Publishes page-owned launcher state to the paired native client. */
-type FlutterDevToolsStateLauncherState<State = unknown> = FlutterDevToolsLauncherIdentity & {
-  state: State;
-};
-//#endregion
-export { FlutterDevToolsIdentity, FlutterDevToolsLauncherIdentity, FlutterDevToolsNativeConnect, FlutterDevToolsPageConnect, FlutterDevToolsReady, FlutterDevToolsStateLauncherConnection, FlutterDevToolsStateLauncherRequest, FlutterDevToolsStateLauncherResult, FlutterDevToolsStateLauncherState, flutterDevToolsEvents, flutterDevToolsProtocolVersion };

package/dist/flutter-devtools.js

@@ -1 +0,0 @@
-const e=1,t={nativeConnect:`coreframe:flutter-devtools:native-connect`,pageConnect:`coreframe:flutter-devtools:page-connect`,pageDisconnect:`coreframe:flutter-devtools:page-disconnect`,ready:`coreframe:flutter-devtools:ready`,stateLauncherConnection:`coreframe:flutter-devtools:state-launcher-connection`,stateLauncherRequest:`coreframe:flutter-devtools:state-launcher-request`,stateLauncherResult:`coreframe:flutter-devtools:state-launcher-result`,stateLauncherState:`coreframe:flutter-devtools:state-launcher-state`};export{t as flutterDevToolsEvents,e as flutterDevToolsProtocolVersion};