@engineeros/connector 0.12.5 → 0.13.0

package/README.md

@@ -47,7 +47,7 @@ npx --yes @engineeros/connector@latest pair PAIRING-CODE --url https://your-engi
 
 The connector uploads a bounded ZIP snapshot for a safe file inventory, then stays online for deep assessments, rescans, and Goal Runs. Inventory never executes repository code. It excludes known secrets, dependency directories, build output, compiled binaries, files larger than 5 MB, agent-tool caches, Git metadata, and connector state before upload.
 
-From **Project steering -> Workspace**, run the workspace assessment to use the connected agent subscription already authenticated on that computer. EngineerOS stores the source-cited findings in System State and promotes the highest-return corrective action in Steering. Assessment cannot modify the workspace.
+From **Project steering -> Workspace**, run the workspace assessment to use the connected agent subscription already authenticated on that computer. Select Architecture, Capabilities, Quality, or any combination when only part of the workspace needs reassessment. EngineerOS stores every completed assessment stage before starting the next one, resumes the unfinished stage after a connector restart or retry, and then synthesizes the selected results into System State. Capabilities are assessed one discovered capability at a time so a large repository does not depend on one unbounded agent turn. Assessment cannot modify the workspace.
 
 After onboarding, every project prompt is routed to this connection. Copilot, shaping, planning, architecture, and experience generation use the connected agent subscription and workspace context. Interactive prompts run independently from assessments and Goal scheduling. Prompt runs are read-only; only an explicitly registered Goal Run receives workspace-write access. If the connector is offline, EngineerOS asks the user to reconnect instead of silently switching models.
 

package/bin/engineeros-connector.mjs

@@ -276,9 +276,12 @@ async function connect() {
     }
     if (message.type === "workspace.assessment") {
       if (
-        active?.runId !== message.assessment_id &&
+        (active?.runId !== message.assessment_id ||
+          active?.stage !== message.stage) &&
         !assessments.some(
-          (candidate) => candidate.assessment_id === message.assessment_id,
+          (candidate) =>
+            candidate.assessment_id === message.assessment_id &&
+            candidate.stage === message.stage,
         )
       ) {
         assessments.push(message);
@@ -463,6 +466,7 @@ function pump() {
     active = {
       kind: "assessment",
       runId: assessment.assessment_id,
+      stage: assessment.stage,
       child: null,
     };
     void executeAssessment(assessment);
@@ -577,14 +581,19 @@ async function cancelPrompt(promptState) {
 
 async function executeAssessment(assignment) {
   const assessmentId = assignment.assessment_id;
-  console.log(`Agent is assessing the workspace (${assessmentId}).`);
+  const stage = assignment.stage;
+  console.log(`Agent is running assessment stage ${stage} (${assessmentId}).`);
   let progress = 10;
   let outputBuffer = "";
   let outputLength = 0;
   let outputTimer;
   const reportedMilestones = new Set();
   const reportProgress = (message, { milestone = true } = {}) => {
-    if (socket.readyState !== WebSocket.OPEN || active?.runId !== assessmentId)
+    if (
+      socket.readyState !== WebSocket.OPEN ||
+      active?.runId !== assessmentId ||
+      active?.stage !== stage
+    )
       return;
     if (milestone && reportedMilestones.has(message)) return;
     if (milestone) reportedMilestones.add(message);
@@ -592,6 +601,7 @@ async function executeAssessment(assignment) {
       JSON.stringify({
         type: "workspace.assessment.progress",
         assessment_id: assessmentId,
+        stage,
         progress_percent: progress,
         message: String(message).slice(0, 500),
       }),
@@ -605,7 +615,8 @@ async function executeAssessment(assignment) {
     if (
       !output ||
       socket.readyState !== WebSocket.OPEN ||
-      active?.runId !== assessmentId
+      active?.runId !== assessmentId ||
+      active?.stage !== stage
     ) {
       return;
     }
@@ -614,6 +625,7 @@ async function executeAssessment(assignment) {
         JSON.stringify({
           type: "workspace.assessment.output",
           assessment_id: assessmentId,
+          stage,
           delta: output.slice(offset, offset + 50_000),
         }),
       );
@@ -631,7 +643,7 @@ async function executeAssessment(assignment) {
       outputTimer = setTimeout(flushOutput, 500);
     }
   };
-  reportProgress("Starting read-only repository assessment");
+  reportProgress(`Starting ${stage} assessment stage`);
   const heartbeat = setInterval(() => {
     progress = Math.min(90, progress + 5);
     reportProgress("Assessment in progress", { milestone: false });
@@ -643,7 +655,9 @@ async function executeAssessment(assignment) {
     }
     const result = await executeWorkspaceAssessment(assignment, config, {
       onProcess: (child) => {
-        if (active?.runId === assessmentId) active.child = child;
+        if (active?.runId === assessmentId && active?.stage === stage) {
+          active.child = child;
+        }
       },
       onEvent: (event) => {
         reportOutput(assessmentStreamDelta(event));
@@ -668,7 +682,7 @@ async function executeAssessment(assignment) {
         await describeRejectedResponse(response, "the assessment"),
       );
     }
-    console.log("Workspace assessment is current in EngineerOS.");
+    console.log(`Workspace assessment stage ${stage} was accepted by EngineerOS.`);
   } catch (error) {
     flushOutput();
     const message = protocolFailureMessage(error);
@@ -677,6 +691,7 @@ async function executeAssessment(assignment) {
         JSON.stringify({
           type: "workspace.assessment.failed",
           assessment_id: assessmentId,
+          stage,
           message,
         }),
       );

package/package.json

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

package/src/runner.mjs

@@ -414,8 +414,9 @@ export async function executeWorkspaceAssessment(
       "The Git commit changed during assessment. Refresh the workspace inventory and assess the new commit.",
     );
   }
-  return {
-    report_markdown: report,
+  return {
+    stage: assignment.stage,
+    report_markdown: report,
     observed_head_revision: endingHead,
     changed_files: changeImpact.changedFiles,
     change_impact_markdown: changeImpact.markdown,
@@ -761,11 +762,22 @@ function assessmentCommandMilestone(command) {
   return "Tracing architecture and code relationships";
 }
 
-export function workspaceAssessmentExecution(assignment) {
-  const requiredOutputHeading =
-    assignment?.assessment_mode === "incremental"
-      ? "# Workspace Assessment Delta"
-      : "# Workspace Assessment";
+export function workspaceAssessmentExecution(assignment) {
+  const stage = assignment?.stage;
+  const requiredOutputHeading =
+    stage === "synthesis"
+      ? "# Assessment Stage: Synthesis"
+      : stage === "capability_catalog"
+        ? "# Assessment Stage: Capability Catalog"
+        : String(stage || "").startsWith("capability:")
+          ? "# Assessment Stage: Capabilities"
+          : `# Assessment Stage: ${String(stage || "").replace(/^./, (value) => value.toUpperCase())}`;
+  if (
+    !new Set(["architecture", "capability_catalog", "quality", "synthesis"]).has(stage) &&
+    !String(stage || "").startsWith("capability:")
+  ) {
+    throw new Error("EngineerOS assessment assignment has an unsupported stage.");
+  }
   return {
     ...connectorExecution(assignment, { requiredOutputHeading }),
     requiredOutputHeading,