@coreframe/dev-contracts 0.1.12 → 0.1.14

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, ManagedDevActivity, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCodexStage, 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, ManagedDevActivity, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCodexStage, 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, 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 };

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{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};

package/dist/managed-dev.d.ts

@@ -23,16 +23,22 @@ 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 ManagedDevCheckTrigger = "codegen-recovery" | "database-recovery" | "dependency-recovery" | "synchronization" | "check-recovery";
 type ManagedDevChecks = {
   commit: string;
   commands: ManagedDevCheck[];
@@ -67,7 +73,96 @@ type ManagedDevActivity = {
   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 = {
+  /** Original and last published refs for a guarded reset of this integration. */branchReset?: {
+    main: string;
+    dev: string;
+    consumedDev: string;
+    expectedMain: string;
+    expectedDev: string;
+    expectedConsumedDev: string;
+  };
+  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;
+declare function canResetManagedDevBranches(status: ManagedDevStatus | undefined): boolean;
+type ManagedDevCodexRetry = {
+  base: string;
+  source: "dev" | "upstream";
+  target: string;
+  prepared?: string;
+  recoveryRef?: string;
+};
+type ManagedDevAlignmentRetry = {
+  previousMain: string;
+  main: string;
+  dev: string;
+};
 type ManagedDevStatus = {
+  codexRetry?: ManagedDevCodexRetry;
+  devAlignment?: ManagedDevAlignmentRetry;
+  fetchFailure?: string;
+  operation?: ManagedDevOperation;
   activities?: ManagedDevActivity[];
   trace?: {
     sessionId: string;
@@ -84,15 +179,23 @@ type ManagedDevStatus = {
   mode: "error" | "managed" | "unmanaged" | "waiting";
   pendingRebase?: ManagedDevPendingRebase;
   proposal?: string;
+  proposalUntracked?: string[];
   setupFailure?: ManagedDevSetupFailure;
   target?: ManagedDevTarget;
   warnings: string[];
 };
 type ManagedDevAction = {
+  type: "reset-branches";
+  operationId: string;
+} | {
   id: string;
   type: "acknowledge-codex";
 } | {
   type: "cancel-codex";
+  operationId?: string;
+} | {
+  type: "acknowledge-operation";
+  id: string;
 } | {
   failureId: string;
   type: "dismiss-check";
@@ -132,6 +235,17 @@ type ManagedDevAction = {
   type: "retry-codegen";
 } | {
   type: "retry-install";
+} | {
+  type: "retry-migration";
+} | {
+  type: "retry-checks";
+} | {
+  type: "retry-dev-alignment";
+} | {
+  type: "retry-fetch";
+} | {
+  type: "retry-codex";
+  codex?: ManagedDevCodexOptions;
 };
 /** An action handled by the Vite integration while a shared supervisor recovers. */
 type ManagedDevRecoveryAction = {
@@ -178,6 +292,8 @@ type ManagedDevCodexEvent = {
   phase: "start";
   stage?: ManagedDevCodexStage;
   totalCommits?: number;
+  currentCommit?: ManagedDevCommit;
+  files?: string[];
 } | {
   message: ManagedDevCodexMessage;
   phase: "message";
@@ -196,11 +312,13 @@ type ManagedDevCodexEvent = {
   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 & {
@@ -219,4 +337,4 @@ type ManagedDevDiagnosticRequest = {
   pending?: boolean;
 };
 //#endregion
-export { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevActivity, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCodexStage, ManagedDevCommit, ManagedDevDiagnosticRequest, ManagedDevDraft, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix };
+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 };

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`}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};

package/package.json

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