@engineeros/connector 0.14.4 → 0.14.5

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. Select any combination of fifteen brownfield assessment domains, collectively covering 133 baseline checks from product and architecture through security, privacy, project-specific compliance, delivery, reliability, governance, and modernization planning. Every domain uses a detailed structured-Markdown contract. EngineerOS stores each completed stage, resumes unfinished work after a connector restart, retry, or temporary connection loss, and then synthesizes the selected results into System State. Connector `0.14.4` runs up to three independent assessment stages for every supported coding-agent protocol, including ACP agents such as OpenCode. The connector owns the worker pool and sends one aggregate heartbeat containing every active worker's phase, progress, last activity, and event count; workers no longer compete to send individual WebSocket progress heartbeats. Live output remains coalesced separately because it is durable report content. Capability detail and project-specific compliance controls fan out after their catalogs, and final synthesis waits for every selected result. Compliance findings describe repository-verifiable engineering readiness and missing external context, never legal compliance or certification. Each result, live output, validation correction, and retry remains independently durable. The connector prints each worker's safe activity and elapsed time every 30 seconds, stops a worker that produces no agent activity for ten minutes instead of waiting indefinitely, and gives an incomplete report one bounded correction turn instead of repeatedly restarting it. 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 any combination of fifteen brownfield assessment domains, collectively covering 133 baseline checks from product and architecture through security, privacy, project-specific compliance, delivery, reliability, governance, and modernization planning. Every domain uses a detailed structured-Markdown contract. EngineerOS stores each completed stage, resumes unfinished work after a connector restart, retry, or temporary connection loss, and then synthesizes the selected results into System State. Connector `0.14.5` runs up to three independent assessment stages for every supported coding-agent protocol. ACP agents such as OpenCode use isolated stage sessions within one persistent coding-agent process, avoiding the CPU and memory spike from launching three full agent runtimes. The connector owns the worker pool and sends one aggregate heartbeat containing every active worker's phase, progress, last activity, and event count; workers no longer compete to send individual WebSocket progress heartbeats. Live output remains coalesced separately because it is durable report content. Capability detail and project-specific compliance controls fan out after their catalogs, and final synthesis waits for every selected result. Compliance findings describe repository-verifiable engineering readiness and missing external context, never legal compliance or certification. Each result, live output, validation correction, and retry remains independently durable. The connector prints each worker's safe activity and elapsed time every 30 seconds, stops a worker that produces no agent activity for ten minutes instead of waiting indefinitely, and gives an incomplete report one bounded correction turn instead of repeatedly restarting it. 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

@@ -206,7 +206,7 @@ const ASSESSMENT_WORKER_LIMIT = workspaceAssessmentWorkerLimit(
   codingAgent.protocol,
 );
 console.log(
-  `Assessment supervisor can run up to ${ASSESSMENT_WORKER_LIMIT} independent ${codingAgent.name} workers.`,
+  `Assessment supervisor can run up to ${ASSESSMENT_WORKER_LIMIT} independent ${codingAgent.name} stages.`,
 );
 const available = [];
 const assessments = [];
@@ -506,6 +506,7 @@ function pump() {
       runId: assessment.assessment_id,
       stage: assessment.stage,
       child: null,
+      controller: null,
       resumeAssignment: null,
       phase: "starting",
       progressPercent: 5,
@@ -626,6 +627,14 @@ async function cancelPrompt(promptState) {
   await stopProcess(promptState.child);
 }
 
+async function cancelAssessment(assessmentState) {
+  if (typeof assessmentState.controller?.cancel === "function") {
+    await assessmentState.controller.cancel();
+    return;
+  }
+  await stopProcess(assessmentState.child);
+}
+
 async function executeAssessment(assignment, assessmentState) {
   const assessmentId = assignment.assessment_id;
   const stage = assignment.stage;
@@ -722,7 +731,7 @@ async function executeAssessment(assignment, assessmentState) {
     if (!inactivityFailure && nextInactivityFailure) {
       inactivityFailure = nextInactivityFailure;
       console.error(`[assessment:${stage}] ${inactivityFailure}`);
-      void stopProcess(assessmentState.child);
+      void cancelAssessment(assessmentState);
       return;
     }
     if (inactivityFailure) return;
@@ -741,6 +750,9 @@ async function executeAssessment(assignment, assessmentState) {
       reportProgress("Calculating changed files and affected behavior");
     }
     let result = await executeWorkspaceAssessment(assignment, config, {
+      onController: (controller) => {
+        if (isActiveAssessment()) assessmentState.controller = controller;
+      },
       onProcess: (child) => {
         if (isActiveAssessment()) {
           assessmentState.child = child;

package/package.json

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

package/src/runner.mjs

@@ -357,6 +357,28 @@ export async function executeWorkspaceAssessment(
   callbacks,
 ) {
   const execution = workspaceAssessmentExecution(assignment);
+  const assessmentAcpContext =
+    config.agent_protocol === "acp"
+      ? {
+          persistentAcp: true,
+          sessionKey: `assessment:${assignment.assessment_id}:${assignment.stage}`,
+        }
+      : undefined;
+  const launchAssessmentAgent = (turnPrompt, previousSessionId) => {
+    const controller = launchAgentProcess(
+      config.workspace,
+      turnPrompt,
+      execution.sandboxMode,
+      config,
+      callbacks,
+      execution.profile,
+      previousSessionId,
+      assessmentAcpContext,
+    );
+    callbacks.onController?.(controller);
+    callbacks.onProcess?.(controller.child);
+    return controller;
+  };
   const startingRevision = await run(
     "git",
     ["rev-parse", "HEAD"],
@@ -389,15 +411,7 @@ export async function executeWorkspaceAssessment(
         changeImpact.markdown,
       )
     : execution.prompt;
-  const controller = launchAgentProcess(
-    config.workspace,
-    prompt,
-    execution.sandboxMode,
-    config,
-    callbacks,
-    execution.profile,
-  );
-  callbacks.onProcess?.(controller.child);
+  const controller = launchAssessmentAgent(prompt);
   let completed = await controller.completed;
   const recovered = await recoverAssessmentStageOutput({
     completed,
@@ -408,16 +422,10 @@ export async function executeWorkspaceAssessment(
         type: "assessment.output_correction",
         message: "The Agent is completing the required stage report structure",
       });
-      const correction = launchAgentProcess(
-        config.workspace,
+      const correction = launchAssessmentAgent(
         correctionPrompt,
-        execution.sandboxMode,
-        config,
-        callbacks,
-        execution.profile,
         previousSessionId,
       );
-      callbacks.onProcess?.(correction.child);
       return correction.completed;
     },
   });
@@ -457,19 +465,13 @@ export async function executeWorkspaceAssessment(
           type: "assessment.output_correction",
           message: "The Agent is correcting the rejected stage report",
         });
-        const correction = launchAgentProcess(
-          config.workspace,
+        const correction = launchAssessmentAgent(
           assessmentRejectionCorrectionPrompt(
             validationMessage,
             execution.requiredOutputHeading,
           ),
-          execution.sandboxMode,
-          config,
-          callbacks,
-          execution.profile,
           completed.sessionId,
         );
-        callbacks.onProcess?.(correction.child);
         const corrected = await correction.completed;
         const correctedReport = normalizeAgentStructuredOutput(
           corrected.finalMessage,