archgraph-argo 0.11.0 → 0.12.0

package/argo/scripts/argo-mcp-server.js

@@ -1,7 +1,8 @@
 const fs = require('node:fs');
 const path = require('node:path');
 const readline = require('node:readline');
-const { AsyncLocalStorage } = require('node:async_hooks');
+const { AsyncLocalStorage } = require('node:async_hooks');
+const { spawnSync } = require('node:child_process');
 
 const validatorMcp = require('./validator-mcp-server.js');
 const systemArchitectureMcp = require('./systemarchitecture-mcp-server.js');
@@ -395,7 +396,8 @@ async function callTool(name, args = {}, progressToken = null, dependencies = un
       mcp: report.mcp,
       systemArchitecture: report.systemArchitecture,
       subdiagramViews: report.subdiagramViews,
-      neo4j: report.neo4j,
+      neo4j: report.neo4j,
+      qeaFullProjection: workspace.qeaFullProjection,
       semanticLifecycle: report.semanticLifecycle,
       semanticState: report.semanticLifecycle && report.semanticLifecycle.state,
       alignment: report.semanticLifecycle && report.semanticLifecycle.alignment,
@@ -418,6 +420,48 @@ async function withCanonicalSemanticInitTestComposition(composition, callback) {
   return canonicalSemanticInitStorage.run(Object.freeze({ ...composition }), callback);
 }
 
+function resolveQeaProjectionTarget(workspaceRoot) {
+  try {
+    if (!workspaceRoot || !fs.existsSync(workspaceRoot)) { return null; }
+    const pick = (p) => (p && fs.existsSync(p) ? path.resolve(p) : null);
+    const qeaPath = pick(process.env.ARGO_EA_QEA);
+    if (qeaPath) { return { qeaPath, workspaceRoot }; }
+    let qeas = [];
+    try { qeas = fs.readdirSync(workspaceRoot).filter((n) => n.toLowerCase().endsWith('.qea')); } catch { /* ignore */ }
+    if (qeas.length === 1) { return { qeaPath: path.resolve(workspaceRoot, qeas[0]), workspaceRoot }; }
+    console.log('[ea-qea] init projection target: none' + (qeas.length > 1 ? ' (' + qeas.length + ' *.qea found; expected exactly one or ARGO_EA_QEA)' : '') + ' in ' + workspaceRoot);
+    return null;
+  } catch (error) {
+    console.log('[ea-qea] init projection target resolution failed: ' + String(error && error.message ? error.message : error));
+    return null;
+  }
+}
+
+// argo init .qea FULL projection (mirrors Neo4j initial full sync): wipes the whole target
+// .qea then rebuilds it purely from the canonical graph. Non-fatal by contract.
+function runQeaFullProjection(workspaceRoot, graphTargetPath) {
+  const target = resolveQeaProjectionTarget(workspaceRoot);
+  const script = path.join(__dirname, 'ea-qea-sync.js');
+  if (!target || !fs.existsSync(script)) {
+    return { status: 'noop', reason: !target ? 'no .qea target (env ARGO_EA_QEA or exactly one root *.qea)' : 'argo/scripts/ea-qea-sync.js missing' };
+  }
+  const snapshotDir = path.join(workspaceRoot, '.argo', 'temp', 'qea-backups');
+  const args = [script, '--mode', 'full', '--graph', graphTargetPath, '--qea', target.qeaPath, '--snapshot-dir', snapshotDir];
+  const started = Date.now();
+  try {
+    const res = spawnSync(process.execPath, args, { cwd: workspaceRoot, encoding: 'utf8', windowsHide: true, timeout: 120000 });
+    const ok = res.status === 0;
+    return {
+      status: ok ? 'ok' : 'failed',
+      qea: target.qeaPath,
+      ms: Date.now() - started,
+      ...(ok ? {} : { error: String((res.stderr || '').slice(0, 600) || ('exit ' + res.status)) }),
+    };
+  } catch (error) {
+    return { status: 'failed', qea: target.qeaPath, ms: Date.now() - started, error: String(error && error.message ? error.message : error) };
+  }
+}
+
 async function initializeWorkspace(workspaceRoot) {
   const workspaceName = path.basename(workspaceRoot);
   const createdFiles = [];
@@ -454,8 +498,17 @@ async function initializeWorkspace(workspaceRoot) {
     }
   }
 
+  // WP2791: init .qea FULL projection (parallel to Neo4j initial full sync in the harness
+  // report). Non-fatal: a qea failure must never fail workspace init.
+  let qeaFullProjection = null;
+  try {
+    qeaFullProjection = runQeaFullProjection(workspaceRoot, graphTargetPath);
+  } catch (error) {
+    qeaFullProjection = { status: 'failed', error: String(error && error.message ? error.message : error) };
+  }
   return {
-    workspaceRoot,
+    workspaceRoot,
+    qeaFullProjection,
     targetFeapName,
     createdFiles,
     updatedFiles,