@coreframe/dev-contracts 0.0.0 → 0.1.1

package/dist/codex-task.d.ts

@@ -0,0 +1,21 @@
+//#region src/codex-task.d.ts
+declare const codexTaskEnv = "COREFRAME_CODEX_TASKS";
+declare const codexTaskEvents: {
+  readonly result: "coreframe:codex-task:result";
+  readonly start: "coreframe:codex-task:start";
+};
+type CodexTaskStartRequest = {
+  openInBackground?: boolean;
+  prompt: string;
+  requestId: string;
+};
+type CodexTaskStartResponse = {
+  error?: string;
+  openedInCodex?: boolean;
+  requestId: string;
+  threadId?: string;
+  url?: string;
+  warning?: string;
+};
+//#endregion
+export { CodexTaskStartRequest, CodexTaskStartResponse, codexTaskEnv, codexTaskEvents };

package/dist/codex-task.js

@@ -0,0 +1 @@
+const e=`COREFRAME_CODEX_TASKS`,t={result:`coreframe:codex-task:result`,start:`coreframe:codex-task:start`};export{e as codexTaskEnv,t as codexTaskEvents};

package/dist/development-controls.d.ts

@@ -0,0 +1,19 @@
+//#region src/development-controls.d.ts
+declare const developmentControlsEvents: {
+  readonly action: "coreframe:development-controls:action";
+  readonly actionResult: "coreframe:development-controls:action-result";
+};
+type DevelopmentControlAction = {
+  type: "restart-vite";
+};
+type DevelopmentControlActionRequest = {
+  action: DevelopmentControlAction;
+  requestId: string;
+};
+type DevelopmentControlActionResponse = {
+  error?: string;
+  requestId: string;
+  state: "busy" | "complete" | "error";
+};
+//#endregion
+export { DevelopmentControlAction, DevelopmentControlActionRequest, DevelopmentControlActionResponse, developmentControlsEvents };

package/dist/development-controls.js

@@ -0,0 +1 @@
+const e={action:`coreframe:development-controls:action`,actionResult:`coreframe:development-controls:action-result`};export{e as developmentControlsEvents};

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { CodexTaskStartRequest, CodexTaskStartResponse, codexTaskEnv, codexTaskEvents } from "./codex-task.js";
+import { DevelopmentControlAction, DevelopmentControlActionRequest, DevelopmentControlActionResponse, developmentControlsEvents } from "./development-controls.js";
+import { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDraft, ManagedDevRebasedCommit, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, managedDevEnv, managedDevEvents } from "./managed-dev.js";
+export { CodexTaskStartRequest, CodexTaskStartResponse, DevelopmentControlAction, DevelopmentControlActionRequest, DevelopmentControlActionResponse, ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDraft, ManagedDevRebasedCommit, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, codexTaskEnv, codexTaskEvents, developmentControlsEvents, managedDevEnv, managedDevEvents };

package/dist/index.js

@@ -0,0 +1 @@
+import{codexTaskEnv as e,codexTaskEvents as t}from"./codex-task.js";import{developmentControlsEvents as n}from"./development-controls.js";import{managedDevEnv as r,managedDevEvents as i}from"./managed-dev.js";export{e as codexTaskEnv,t as codexTaskEvents,n as developmentControlsEvents,r as managedDevEnv,i as managedDevEvents};

package/dist/managed-dev.d.ts

@@ -0,0 +1,137 @@
+//#region src/managed-dev.d.ts
+declare const managedDevEnv = "COREFRAME_MANAGED_DEV";
+declare const managedDevEvents: {
+  readonly action: "coreframe:managed-dev:action";
+  readonly actionResult: "coreframe:managed-dev:action-result";
+  readonly codex: "coreframe:managed-dev:codex";
+  readonly status: "coreframe:managed-dev:status";
+  readonly statusRequest: "coreframe:managed-dev:status-request";
+};
+type ManagedDevCommit = {
+  commit: string;
+  shortCommit: string;
+  subject: string;
+};
+type ManagedDevTarget = ManagedDevCommit & {
+  commits?: ManagedDevCommit[];
+  source: "dev" | "upstream";
+};
+type ManagedDevDraft = {
+  fingerprint: string;
+  tracked: boolean;
+  untracked: string[];
+};
+type ManagedDevCheck = {
+  command: "pnpm test" | "pnpm typecheck";
+  dismissed?: boolean;
+  failureId?: string;
+  output?: string;
+  status: "failed" | "passed" | "pending" | "running";
+};
+type ManagedDevCheckTrigger = "database-recovery" | "dependency-recovery" | "synchronization";
+type ManagedDevChecks = {
+  commit: string;
+  commands: ManagedDevCheck[];
+  trigger: ManagedDevCheckTrigger;
+};
+type ManagedDevSetupFailure = {
+  command: "pnpm db migrate" | "pnpm db setup" | "pnpm install --frozen-lockfile";
+  commit: string;
+  message: string;
+  output: string;
+  restartRequired: boolean;
+  stage: "dependencies" | "migration";
+};
+type ManagedDevStatus = {
+  busy?: string;
+  checks?: ManagedDevChecks;
+  codexCompletion?: ManagedDevCodexCompletion;
+  currentCommit?: string;
+  draft?: ManagedDevDraft;
+  message?: string;
+  mode: "error" | "managed" | "unmanaged" | "waiting";
+  proposal?: string;
+  setupFailure?: ManagedDevSetupFailure;
+  target?: ManagedDevTarget;
+  warnings: string[];
+};
+type ManagedDevAction = {
+  id: string;
+  type: "acknowledge-codex";
+} | {
+  failureId: string;
+  type: "dismiss-check";
+} | {
+  type: "apply";
+  fingerprint?: string;
+  message?: string;
+  target: string;
+  untracked?: string[];
+} | {
+  type: "commit";
+  fingerprint: string;
+  message: string;
+  untracked: string[];
+} | {
+  type: "message";
+  fingerprint: string;
+  untracked: string[];
+} | {
+  type: "prepare";
+  target: string;
+} | {
+  type: "reject";
+} | {
+  type: "reset-database";
+} | {
+  type: "retry-install";
+};
+type ManagedDevActionResult = {
+  status: ManagedDevStatus;
+};
+type ManagedDevCodexMessage = {
+  kind: "agent" | "thought" | "user";
+  text: string;
+};
+type ManagedDevRebasedCommit = ManagedDevCommit;
+type ManagedDevCodexCompletion = {
+  commits?: ManagedDevRebasedCommit[];
+  finalMessage: string;
+  id: string;
+  messages: ManagedDevCodexMessage[];
+  totalCommits?: number;
+};
+type ManagedDevCodexEvent = {
+  commits: ManagedDevRebasedCommit[];
+  message: ManagedDevCodexMessage;
+  phase: "start";
+  totalCommits?: number;
+} | {
+  message: ManagedDevCodexMessage;
+  phase: "message";
+} | {
+  finalMessage: string;
+  phase: "complete";
+} | {
+  commits: ManagedDevRebasedCommit[];
+  phase: "progress";
+  totalCommits?: number;
+} | {
+  phase: "error";
+};
+type ManagedDevActionRequest = {
+  action: ManagedDevAction;
+  requestId: string;
+};
+type ManagedDevActionResponse = Partial<ManagedDevActionResult> & {
+  error?: string;
+  requestId: string;
+};
+type ManagedDevCodexResponse = ManagedDevCodexEvent & {
+  requestId: string;
+};
+type ManagedDevStatusResponse = {
+  status: ManagedDevStatus;
+};
+//#endregion
+export { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDraft, ManagedDevRebasedCommit, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, managedDevEnv, managedDevEvents };

package/dist/managed-dev.js

@@ -0,0 +1 @@
+const e=`COREFRAME_MANAGED_DEV`,t={action:`coreframe:managed-dev:action`,actionResult:`coreframe:managed-dev:action-result`,codex:`coreframe:managed-dev:codex`,status:`coreframe:managed-dev:status`,statusRequest:`coreframe:managed-dev:status-request`};export{e as managedDevEnv,t as managedDevEvents};

package/package.json

@@ -1,13 +1,44 @@
 {
   "name": "@coreframe/dev-contracts",
-  "version": "0.0.0",
-  "description": "",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "version": "0.1.1",
+  "description": "Shared contracts for Coreframe managed development workflows",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/airlock-labs/coreframe.git",
+    "directory": "node/dev-contracts"
+  },
+  "files": [
+    "dist/"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./codex-task": {
+      "types": "./dist/codex-task.d.ts",
+      "default": "./dist/codex-task.js"
+    },
+    "./development-controls": {
+      "types": "./dist/development-controls.d.ts",
+      "default": "./dist/development-controls.js"
+    },
+    "./managed-dev": {
+      "types": "./dist/managed-dev.d.ts",
+      "default": "./dist/managed-dev.js"
+    }
   },
-  "keywords": [],
-  "author": "",
-  "license": "All rights reserved",
-  "type": "commonjs"
-}
+  "devDependencies": {
+    "tsdown": "0.22.3",
+    "typescript": "6.0.3",
+    "vitest": "^4.1.9"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run --reporter=minimal",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "format": "oxlint --fix && oxfmt",
+    "lint": "oxlint"
+  }
+}

package/readme.md

@@ -1 +0,0 @@
-Coming soon...