@engineeros/connector 0.8.3 → 0.8.5

package/README.md

@@ -49,7 +49,7 @@ Credentials are stored per workspace under `~/.engineeros/connectors` with owner
 
 Keep the connector online to receive Goals assigned from EngineerOS. Each Goal runs in an isolated worktree below `~/.engineeros/runs`. Cancellation stops Codex. The connector returns changed paths, a bounded diff, and the exact repository ZIP; a human still performs independent attestation.
 
-During the writable implementation phase, Codex receives an authenticated EngineerOS MCP server automatically. It can list, read, create, update, reclassify, and soft-delete project artifacts through the same repository boundary used by Copilot. The backend accepts those calls only while the assigned Goal is running. Read-only project prompts and the independent verification phase do not receive mutation tools.
+During the writable implementation phase, Codex receives an authenticated EngineerOS MCP server automatically. It can list, read, create, update, reclassify, soft-delete, and materialize project artifacts into canonical Product records through the same repository boundary used by Copilot. The backend accepts those calls only while the assigned Goal is running. Read-only project prompts and the independent verification phase do not receive mutation tools.
 
 Requirements: Node.js 22 or newer, Git, and an authenticated Codex CLI (`codex login`).
 

package/bin/engineeros-connector.mjs

@@ -16,6 +16,7 @@ import {
   executeConnectedPrompt,
   executeWorkspaceAssessment,
   inspectCodingAgent,
+  promptProgressMessage,
   stopProcess,
   workspaceSnapshot,
 } from "../src/runner.mjs";
@@ -385,6 +386,25 @@ function pump() {
 
 async function executePrompt(assignment) {
   const promptId = assignment.prompt_id;
+  let lastProgressMessage;
+  const reportProgress = (message) => {
+    if (
+      !message ||
+      message === lastProgressMessage ||
+      socket.readyState !== WebSocket.OPEN ||
+      active?.runId !== promptId
+    ) {
+      return;
+    }
+    lastProgressMessage = message;
+    socket.send(
+      JSON.stringify({
+        type: "prompt.progress",
+        prompt_id: promptId,
+        message: String(message).slice(0, 500),
+      }),
+    );
+  };
   console.log(
     `Answering ${assignment.purpose || "project"} prompt with ${codingAgent.name}.`,
   );
@@ -393,6 +413,7 @@ async function executePrompt(assignment) {
       onProcess: (child) => {
         if (active?.runId === promptId) active.child = child;
       },
+      onEvent: (event) => reportProgress(promptProgressMessage(event)),
     });
     config = {
       ...config,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@engineeros/connector",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "description": "Connect a local coding agent to EngineerOS, using ACP when supported.",
   "private": false,
   "type": "module",

package/src/mcp-server.mjs

@@ -119,6 +119,17 @@ export const artifactTools = [
     },
     annotations: { readOnlyHint: false, destructiveHint: false },
   },
+  {
+    name: "engineeros_materialize_product_artifacts",
+    description:
+      "Materialize structured Product documents into the canonical EngineerOS Vision, Portfolio capabilities, and project graph during the currently approved writable Goal.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false,
+    },
+    annotations: { readOnlyHint: false, destructiveHint: false },
+  },
   {
     name: "engineeros_delete_artifact",
     description:
@@ -210,6 +221,10 @@ async function callArtifactTool(context, tool, arguments_) {
 
 function renderArtifactToolResult(result) {
   const lines = ["# EngineerOS artifact tool result", "", result.message || "Completed."];
+  if (result.vision_id) lines.push("", `- Vision ID: \`${result.vision_id}\``);
+  if (Array.isArray(result.capability_ids) && result.capability_ids.length) {
+    lines.push(`- Capability IDs: ${result.capability_ids.map((id) => `\`${id}\``).join(", ")}`);
+  }
   if (result.artifact) lines.push("", ...artifactMarkdown(result.artifact));
   if (Array.isArray(result.artifacts)) {
     lines.push("", `## Artifacts (${result.total ?? result.artifacts.length})`, "");

package/src/runner.mjs

@@ -570,6 +570,31 @@ export function assessmentProgressMessage(event) {
   return null;
 }
 
+export function promptProgressMessage(event) {
+  if (!event || typeof event !== "object") return null;
+  if (event.type === "turn.started")
+    return "Reviewing the request and workspace context";
+  if (event.type === "item.started") {
+    if (event.item?.type === "command_execution") {
+      return assessmentCommandMilestone(event.item.command);
+    }
+    if (event.item?.type === "mcp_tool_call")
+      return "Checking connected project evidence";
+    if (event.item?.type === "web_search")
+      return "Checking an external technical reference";
+    return null;
+  }
+  if (event.type === "item.completed" && event.item?.type === "agent_message") {
+    return "Preparing the response";
+  }
+  if (event.type === "agent.connected") return "Connected to the coding agent";
+  if (event.type === "acp.tool_call" || event.type === "acp.tool_call_update") {
+    return "Inspecting the workspace with the coding agent";
+  }
+  if (event.type === "acp.agent_message_chunk") return "Preparing the response";
+  return null;
+}
+
 function assessmentCommandMilestone(command) {
   const value = Array.isArray(command)
     ? command.join(" ")