@engineeros/connector 0.4.0 → 0.4.1

package/README.md

@@ -2,6 +2,11 @@
 
 Connect a local Codex CLI workspace to EngineerOS through an outbound WebSocket.
 
+This package is only a connector. EngineerOS owns every prompt, Goal instruction, and
+execution boundary. The connector validates the assignment envelope, passes the supplied
+Markdown to Codex CLI unchanged, streams lifecycle events, and returns bounded results.
+It contains no product, assessment, planning, architecture, or delivery prompt templates.
+
 ## Onboard a workspace
 
 Create a connection command from **Project steering -> Connect workspace**, then run it inside the local folder:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@engineeros/connector",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Connect a local Codex CLI workspace to EngineerOS over an outbound WebSocket.",
   "private": false,
   "type": "module",

package/src/runner.mjs

@@ -82,14 +82,16 @@ const CODE_MARKERS = new Set([
 ]);
 
 export async function executeAssignment(assignment, config, callbacks) {
+  const execution = connectorExecution(assignment);
   const runWorkspace = await prepareRunWorkspace(
     config.workspace,
     assignment.run_id,
     assignment.base_revision,
   );
-  const controller = launchCodex(
+  const controller = launchCodexProcess(
     runWorkspace,
-    assignment.packet_markdown,
+    execution.prompt,
+    execution.sandboxMode,
     callbacks,
   );
   callbacks.onProcess?.(controller.child);
@@ -113,27 +115,23 @@ export async function executeAssignment(assignment, config, callbacks) {
 }
 
 export async function executeWorkspaceAssessment(assignment, config, callbacks) {
+  const execution = connectorExecution(assignment);
   const revision = await run(
     "git",
     ["rev-parse", "HEAD"],
     config.workspace,
     { allowFailure: true },
   );
-  const instruction = `${assignment.prompt_markdown}\n\n## EngineerOS execution instruction\n\nAssess the current workspace at the requested inventory revision ${assignment.source_revision}. Remain read-only. Return only the required structured Markdown assessment as your final answer.\n`;
   const controller = launchCodexProcess(
     config.workspace,
-    instruction,
-    "read-only",
+    execution.prompt,
+    execution.sandboxMode,
     callbacks,
   );
   callbacks.onProcess?.(controller.child);
   const completed = await controller.completed;
   const report = completed.finalMessage.trim();
-  if (!report.startsWith("# Workspace Assessment")) {
-    throw new Error(
-      "Codex completed without returning the required structured Workspace Assessment.",
-    );
-  }
+  if (!report) throw new Error("Codex completed without returning a response.");
   return {
     report_markdown: report,
     observed_head_revision:
@@ -142,11 +140,11 @@ export async function executeWorkspaceAssessment(assignment, config, callbacks)
 }
 
 export async function executeConnectedPrompt(assignment, config, callbacks) {
-  const instruction = `${assignment.prompt_markdown}\n\n## EngineerOS connector instruction\n\nAnswer this project prompt from the connected workspace. Remain read-only and return only the requested response as your final answer.\n`;
+  const execution = connectorExecution(assignment);
   const controller = launchCodexProcess(
     config.workspace,
-    instruction,
-    "read-only",
+    execution.prompt,
+    execution.sandboxMode,
     callbacks,
   );
   callbacks.onProcess?.(controller.child);
@@ -158,6 +156,18 @@ export async function executeConnectedPrompt(assignment, config, callbacks) {
   return { content, model: "codex-cli" };
 }
 
+export function connectorExecution(assignment) {
+  const prompt = assignment?.prompt_markdown;
+  if (typeof prompt !== "string" || !prompt.trim()) {
+    throw new Error("EngineerOS assignment is missing prompt_markdown.");
+  }
+  const sandboxMode = assignment?.sandbox_mode;
+  if (!new Set(["read-only", "workspace-write"]).has(sandboxMode)) {
+    throw new Error("EngineerOS assignment has an unsupported sandbox_mode.");
+  }
+  return { prompt, sandboxMode };
+}
+
 export async function stopProcess(child) {
   if (!child || child.exitCode !== null) return;
   if (process.platform === "win32") {
@@ -278,11 +288,6 @@ async function prepareRunWorkspace(workspace, runId, baseRevision) {
   return target;
 }
 
-function launchCodex(workspace, packet, callbacks) {
-  const prompt = `${packet}\n\n## EngineerOS execution instruction\n\nImplement this frozen Goal completely in the current run workspace. Run the required verification. Do not commit, push, or modify files outside this workspace. End with a concise result and verification summary.\n`;
-  return launchCodexProcess(workspace, prompt, "workspace-write", callbacks);
-}
-
 function launchCodexProcess(workspace, prompt, sandbox, callbacks) {
   const command =
     process.env.CODEX_BIN ||