archgraph-argo 0.26.2 → 0.27.0

package/argo/schema/argob.config.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ArgoBument default schema bundle descriptor",
+  "description": "Descriptor for the default ARGO schema bundle (ArchiMate 3.2 + ARGO extensions). A repository may override this bundle by placing its own SystemArchitecture.schema.json (plus an optional argob.config.json / argob-rules.json) under <workspace>/.argo/schema.",
+  "language": "ArchiMate 3.2",
+  "elementTypeEnumKey": "archimateElementType",
+  "relationshipTypeEnumKey": "archimateRelationshipType",
+  "actorElementType": "Business Actor",
+  "guide": "archimate3.2.md",
+  "deliveryDependencies": {
+    "sourceDependsOnTarget": ["Access", "Assignment", "Specialization", "Composition", "Aggregation"],
+    "targetDependsOnSource": ["Serving", "Realization", "Flow", "Triggering", "Influence"]
+  },
+  "invariants": {
+    "statementGrammar": true,
+    "endpointMatrix": true,
+    "rootViewName": "SystemArchitecture",
+    "maxElementsPerView": 15
+  }
+}

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

@@ -12,6 +12,13 @@ const {
 const {
   loadRepositoryArgoEnvironment,
 } = require('./repositoryArgoEnvironment.js');
+const {
+  loadSchemaBundleAndOntology,
+} = require('./argob-schema.js');
+const {
+  externalQueryRequested,
+  queryExternalRead,
+} = require('./external-graph-query.js');
 const {
   getWorkspaceRoot,
   hasStaticWorkspace,
@@ -132,7 +139,7 @@ const TOOLS = [
   },
   {
     name: 'previewSystemArchitectureMutation',
-    description: 'Use before apply for complex or risky changes. Performs a dry-run of one or more mutations, runs schema, graph, view, and ArchiMate 3.2 validation, and does not write the graph.',
+    description: 'Use before apply for complex or risky changes. Performs a dry-run of one or more mutations, runs schema, graph, view, and modeling-language validation, and does not write the graph.',
     inputSchema: mutationInputSchema(),
   },
   {
@@ -405,6 +412,16 @@ async function callTool(name, args = {}, progressToken = null, dependencies = un
   } catch {
     // diagnostics are best-effort; never block a tool call
   }
+  // Cross-project read: a read tool with `projectId` is routed to the federation
+  // center (never silently served from the local graph).
+  if (externalQueryRequested(name, args)) {
+    const result = await queryExternalRead({
+      workspaceRoot: resolveWorkspaceRoot(args),
+      tool: name,
+      args,
+    });
+    return toolResult(result);
+  }
   if (name === 'initializeWorkspace') {
     const workspace = await initializeWorkspace(resolveWorkspaceRoot(args));
     // Deterministic argo-init harness report (Neo4j structural sync, semantic
@@ -421,6 +438,10 @@ async function callTool(name, args = {}, progressToken = null, dependencies = un
     return toolResult({
       status: report.status,
       workspaceRoot: workspace.workspaceRoot,
+      // The resolved modeling language for this workspace (default ArgoBument vs
+      // the repository's own .argo/schema bundle) so init names the active schema.
+      schema: workspace.schema,
+      schemaBundle: report.schemaBundle,
       targetEaName: workspace.targetEaName,
       createdFiles: workspace.createdFiles,
       updatedFiles: workspace.updatedFiles,
@@ -514,6 +535,22 @@ async function initializeWorkspace(workspaceRoot) {
   const graphTargetPath = path.join(workspaceRoot, ...WORKSPACE_GRAPH_PATH_SEGMENTS);
   const graphRelativePath = normalizeRelativePath(path.relative(workspaceRoot, graphTargetPath));
   if (!fs.existsSync(graphTargetPath)) {
+    // Only the built-in ArgoBument default schema auto-provides a graph (the
+    // packaged default). For any custom / replaced schema the graph is the user's
+    // own: never copy the packaged (mismatched) graph — fail closed if missing.
+    let ontology = null;
+    try { ontology = loadSchemaBundleAndOntology(workspaceRoot).ontology; } catch { ontology = null; }
+    const usesPackagedDefaultGraph = !!ontology && ontology.kind === 'default' && ontology.dialect === 'archimate-class-matrix';
+    if (!usesPackagedDefaultGraph) {
+      const label = ontology ? `${ontology.kind} / ${ontology.language}` : 'unknown';
+      const error = new Error(
+        `No default graph for the custom schema (${label}): the workspace has no ${graphRelativePath}. ` +
+        'A custom schema must author its own graph; the packaged default graph is not copied because it would not match the schema. ' +
+        `Add ${graphRelativePath} to the workspace.`,
+      );
+      error.code = 'NO_DEFAULT_GRAPH';
+      throw error;
+    }
     const graphSourcePath = resolveGraphDefaultSourcePath();
     await fs.promises.mkdir(path.dirname(graphTargetPath), { recursive: true });
     await fs.promises.copyFile(graphSourcePath, graphTargetPath);
@@ -553,8 +590,28 @@ async function initializeWorkspace(workspaceRoot) {
   } catch (error) {
     qeaFullProjection = { status: 'failed', error: String(error && error.message ? error.message : error) };
   }
+  // Report which schema this workspace resolves to (default ArgoBument vs a
+  // repository's own .argo/schema bundle) so the caller/human can see the active
+  // modeling language right after init.
+  let schema;
+  try {
+    const { bundle, ontology } = loadSchemaBundleAndOntology(workspaceRoot);
+    schema = {
+      kind: bundle.kind,
+      language: ontology.language,
+      dialect: ontology.dialect,
+      dir: bundle.relativeDir,
+      guide: bundle.guidePath ? bundle.guidePath.relativePath : null,
+      actorElementType: ontology.actorElementType,
+      bundleValidation: ontology.bundleValidation ? ontology.bundleValidation.status : null,
+    };
+  } catch (error) {
+    schema = { kind: 'unknown', error: String(error && error.message ? error.message : error) };
+  }
+
   return {
     workspaceRoot,
+    schema,
     qeaFullProjection,
     targetEaName,
     createdFiles,
@@ -634,6 +691,14 @@ function toolResult(payload) {
 }
 
 function canonicalInitErrorResult(error) {
+  // Workspace-bootstrap faults (e.g. a schema with no default graph) are not
+  // semantic-lifecycle secrets and must surface their message to the caller.
+  if (error && error.code === 'NO_DEFAULT_GRAPH') {
+    return toolResult({
+      status: 'failed',
+      error: { category: 'WORKSPACE_INIT_FAILED', code: error.code, message: String(error.message) },
+    });
+  }
   const result = semanticOperatorErrorResult(error);
   if (error.safeSemanticLifecycleMessage !== true) return result;
   const payload = Object.freeze({
@@ -768,6 +833,7 @@ async function handleRequest(request, dependencies = undefined) {
         && params.arguments
         && Object.prototype.hasOwnProperty.call(params.arguments, 'query')
         && params.arguments.query
+        && !externalQueryRequested(params.name, params.arguments)
       ) {
         activeDependencies = {
           semanticOperatorJourney: