@engineeros/connector 0.13.3 → 0.14.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. 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, retry, or temporary connection loss, and then synthesizes the selected results into System State. The connector prints the current safe activity and elapsed time every 30 seconds, stops a stage that produces no agent activity for ten minutes instead of waiting indefinitely, and gives an incomplete final report one bounded correction turn instead of repeatedly restarting the stage. 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.
+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 evidence 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.0` runs up to three dependency-ready read-only assessment workers concurrently; 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 evidence, 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

@@ -24,6 +24,7 @@ import {
   promptStreamEvent,
   requeueInterruptedAssessment,
   stopProcess,
+  takeWorkspaceAssessmentWave,
   workspaceSnapshot,
 } from "../src/runner.mjs";
 import { disposeAcpRuntimes } from "../src/acp-client.mjs";
@@ -195,6 +196,8 @@ firstMessage.capabilities = capabilities;
 
 let stopped = false;
 let active = null;
+const activeAssessments = new Map();
+const ASSESSMENT_WORKER_LIMIT = 3;
 const available = [];
 const assessments = [];
 const activePrompts = new Map();
@@ -212,7 +215,10 @@ process.on("SIGINT", async () => {
   clearConnectionWatchdog?.();
   clearTimeout(reconnectTimer);
   clearInterval(pingTimer);
-  await stopProcess(active?.child);
+  await Promise.all([
+    stopProcess(active?.child),
+    ...[...activeAssessments.values()].map((state) => stopProcess(state.child)),
+  ]);
   await Promise.all([...activePrompts.values()].map(cancelPrompt));
   await disposeAcpRuntimes();
   socket?.close();
@@ -278,9 +284,10 @@ async function connect() {
       return;
     }
     if (message.type === "workspace.assessment") {
+      const assessmentKey = `${message.assessment_id}:${message.stage}`;
       const disposition = enqueueWorkspaceAssessment(
         assessments,
-        active,
+        activeAssessments.get(assessmentKey),
         message,
       );
       if (disposition === "deferred") {
@@ -339,9 +346,9 @@ async function connect() {
     clearInterval(pingTimer);
     for (const promptState of activePrompts.values())
       void cancelPrompt(promptState);
-    if (active?.kind === "assessment") {
-      active.transportInterrupted = true;
-      if (event.code === 4001) void stopProcess(active.child);
+    for (const assessmentState of activeAssessments.values()) {
+      assessmentState.transportInterrupted = true;
+      if (event.code === 4001) void stopProcess(assessmentState.child);
     }
     if (connectionRejected) {
       stopped = true;
@@ -463,21 +470,27 @@ function sendPromptEvent(promptId, event) {
 }
 
 function pump() {
-  if (active || socket.readyState !== WebSocket.OPEN) return;
-  const assessment = assessments.shift();
-  if (assessment) {
+  if (socket.readyState !== WebSocket.OPEN || active) return;
+  const wave = takeWorkspaceAssessmentWave(
+    assessments,
+    activeAssessments.size,
+    ASSESSMENT_WORKER_LIMIT,
+  );
+  for (const assessment of wave) {
+    const assessmentKey = `${assessment.assessment_id}:${assessment.stage}`;
     const assessmentState = {
       kind: "assessment",
+      key: assessmentKey,
       runId: assessment.assessment_id,
       stage: assessment.stage,
       child: null,
       resumeAssignment: null,
       transportInterrupted: false,
     };
-    active = assessmentState;
+    activeAssessments.set(assessmentKey, assessmentState);
     void executeAssessment(assessment, assessmentState);
-    return;
   }
+  if (activeAssessments.size > 0 || assessments.length > 0) return;
   const runId = available.shift();
   if (!runId) return;
   active = { kind: "goal", runId, child: null, cancelled: false };
@@ -604,8 +617,10 @@ async function executeAssessment(assignment, assessmentState) {
   let inactivityFailure = null;
   let lastReportedMilestone = null;
   const creditedMilestones = new Set();
+  const isActiveAssessment = () =>
+    activeAssessments.get(assessmentState.key) === assessmentState;
   const reportProgress = (message, { milestone = true } = {}) => {
-    if (active !== assessmentState) return;
+    if (!isActiveAssessment()) return;
     if (milestone && lastReportedMilestone === message) return;
     if (milestone) {
       lastReportedMilestone = message;
@@ -635,7 +650,7 @@ async function executeAssessment(assignment, assessmentState) {
     if (
       !output ||
       socket.readyState !== WebSocket.OPEN ||
-      active !== assessmentState
+      !isActiveAssessment()
     ) {
       return;
     }
@@ -693,7 +708,7 @@ async function executeAssessment(assignment, assessmentState) {
     }
     let result = await executeWorkspaceAssessment(assignment, config, {
       onProcess: (child) => {
-        if (active === assessmentState) {
+        if (isActiveAssessment()) {
           assessmentState.child = child;
           agentProcessStarted = true;
           lastAgentActivityAt = Date.now();
@@ -747,7 +762,7 @@ async function executeAssessment(assignment, assessmentState) {
     const message = inactivityFailure || protocolFailureMessage(error);
     if (
       !assessmentState.transportInterrupted &&
-      active === assessmentState &&
+      isActiveAssessment() &&
       socket.readyState === WebSocket.OPEN
     ) {
       socket.send(
@@ -764,8 +779,8 @@ async function executeAssessment(assignment, assessmentState) {
   } finally {
     if (outputTimer) clearTimeout(outputTimer);
     clearInterval(heartbeat);
-    if (active === assessmentState) {
-      active = null;
+    if (isActiveAssessment()) {
+      activeAssessments.delete(assessmentState.key);
       const replayQueued = requeueInterruptedAssessment(
         assessments,
         assessmentState,

package/package.json

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

package/src/runner.mjs

@@ -845,18 +845,10 @@ function assessmentCommandMilestone(command) {
 
 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:")
-  ) {
+  const requiredOutputHeading = String(
+    assignment?.required_output_heading || "",
+  ).trim();
+  if (!stage || !requiredOutputHeading.startsWith("# Assessment Stage: ")) {
     throw new Error("EngineerOS assessment assignment has an unsupported stage.");
   }
   return {
@@ -1000,6 +992,22 @@ export function enqueueWorkspaceAssessment(
   return "queued";
 }
 
+export function takeWorkspaceAssessmentWave(queue, activeCount, limit = 3) {
+  const available = Math.max(0, limit - activeCount);
+  if (!available || !queue.length) return [];
+  if (queue[0]?.parallelizable !== true) {
+    return activeCount === 0 ? queue.splice(0, 1) : [];
+  }
+  const wave = [];
+  while (
+    wave.length < available &&
+    queue[0]?.parallelizable === true
+  ) {
+    wave.push(queue.shift());
+  }
+  return wave;
+}
+
 export function requeueInterruptedAssessment(
   queue,
   assessmentState,