archgraph-argo 0.6.0 → 0.6.1

package/argo/rules/archgraph.instructions.md

@@ -8,6 +8,8 @@ applyTo: "**"
 当你领取到某个Workpackage后，进行任何开发活动前，必须先完成自我武装，从该Workpackage关联的元素中，找到完成任务需要使用的SKILL、需要遵守的全局规则。
 1. 对于需要的SKILL，请在.github/skills下创建一个或多个[SKILL名称]/SKILL.md;
 2. 对于要遵守的全局规则，需要在.github下面增加一个或多个 *.instructions.md文件。
+3. 工作完成后，需要将上面生成的SKILL和RULE刷新到知识图谱中对应的架构元素上，确保下次领取到该Workpackage的Agent可以直接获取到这些SKILL和RULE。
+4. 最后需要从.github/skills和.github下删除这些SKILL和RULE文件，确保仓库中不残留这些文件。
 </Principle>
 
 <Principle>
@@ -27,6 +29,10 @@ applyTo: "**"
 6. 知识图谱中所有的验收用例必须采用GIVEN-WHEN-THEN的格式进行描述和实现，以便于人类阅读同时可以自动化执行。
 </Principle>
 
+<Guideline>
+当你探索上下文时，采用小步探索的方式，每次查询的深度不要过大，每次查询后，你可以根据查询结果，决定下一步的探索方向。
+</Guideline>
+
 <instruction>
 你必须通过ARGO MCP server提供的工具来进行意图架构的读写操作，禁止直接修改意图架构的源文件：
 1. getIntentElementContext: 用于获取意图架构元素的上下文信息，包括元素的属性、关联关系等。

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

@@ -51,6 +51,7 @@ const VALIDATOR_TOOL_NAMES = new Set([
 const SYSTEM_ARCHITECTURE_TOOL_NAMES = new Set([
   'getSystemArchitecture',
   'getIntentElementContext',
+  'getArchitectureViewContext',
   'previewSystemArchitectureMutation',
   'applySystemArchitectureMutation',
   'addArchitectureElement',

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

@@ -213,6 +213,11 @@ const TOOLS = [
     description: 'read-only query that returns an intent subgraph context for one element. Uses ArchiMate semantic dependency traversal with dependencyDepth and dependentDepth, preserving native subgraph elements, relationships, and views.',
     inputSchema: intentElementContextInputSchema(),
   },
+  {
+    name: 'getArchitectureViewContext',
+    description: 'read-only query that resolves one view by view_id into its complete membership: the view object, every member element (from included_elements), every member relationship (from included_relationships), the parent element, and optionally child sub-views declared by member elements. Resolves ids into full canonical objects instead of returning raw id lists.',
+    inputSchema: viewContextInputSchema(),
+  },
   {
     name: 'generateArchitectureDiffPlantuml',
     description: 'Generate a timestamped PlantUML Markdown tree for current git diff changes in SystemArchitecture.json. The tool compares HEAD and working tree, extracts changed elements/relationships, and writes to .argo/temp/architecture_analysis/.',
@@ -397,6 +402,20 @@ function intentElementContextInputSchema() {
   };
 }
 
+function viewContextInputSchema() {
+  return {
+    type: 'object',
+    required: ['view_id'],
+    properties: {
+      architecturePath: { type: 'string', description: `Default: ${DEFAULT_GRAPH_PATH}` },
+      view_id: { type: 'string', description: 'The id of the view to resolve.' },
+      includeParentElement: { type: 'boolean', description: 'Default: true. Resolve the parent element referenced by the view.' },
+      includeChildViews: { type: 'boolean', description: 'Default: false. Include child views declared by member elements through subdiagram_views.' },
+    },
+    additionalProperties: false,
+  };
+}
+
 function mutationInputSchema() {
   return {
     type: 'object',
@@ -625,6 +644,87 @@ function buildIntentElementContext(context, args = {}) {
   };
 }
 
+function buildViewContext(context, args = {}) {
+  const viewId = typeof args.view_id === 'string' ? args.view_id.trim() : '';
+  if (!viewId) {
+    return {
+      status: 'failed',
+      error: { category: 'VIEW_ID_REQUIRED', message: 'view_id is required' },
+    };
+  }
+
+  const document = context.document;
+  const view = findView(document.views, viewId);
+  if (!view) {
+    return {
+      status: 'failed',
+      error: { category: 'VIEW_NOT_FOUND', message: `View '${viewId}' does not exist` },
+    };
+  }
+
+  const elementById = new Map((document.elements || []).map(element => [element.id, element]));
+  const relationshipById = new Map((document.relationships || []).map(relationship => [relationship.id, relationship]));
+
+  const elements = [];
+  const missingElementIds = [];
+  for (const elementId of view.included_elements || []) {
+    const element = elementById.get(elementId);
+    if (element) {
+      elements.push(clone(element));
+    } else {
+      missingElementIds.push(elementId);
+    }
+  }
+
+  const relationships = [];
+  const missingRelationshipIds = [];
+  for (const relationshipId of view.included_relationships || []) {
+    const relationship = relationshipById.get(relationshipId);
+    if (relationship) {
+      relationships.push(clone(relationship));
+    } else {
+      missingRelationshipIds.push(relationshipId);
+    }
+  }
+
+  const includeParentElement = args.includeParentElement !== false;
+  let parentElement = null;
+  if (includeParentElement && view.parent_element_id) {
+    const parent = elementById.get(view.parent_element_id);
+    parentElement = parent ? clone(parent) : null;
+  }
+
+  const includeChildViews = args.includeChildViews === true;
+  const childViews = [];
+  if (includeChildViews) {
+    const childViewIds = new Set();
+    for (const element of elements) {
+      for (const subview of element.subdiagram_views || []) {
+        if (subview && subview.view_id) {
+          childViewIds.add(subview.view_id);
+        }
+      }
+    }
+    for (const entry of document.views || []) {
+      if (childViewIds.has(entry.view_id)) {
+        childViews.push(clone(entry));
+      }
+    }
+  }
+
+  return {
+    status: 'passed',
+    graphPath: context.graphPath.relativePath,
+    view: clone(view),
+    elements,
+    relationships,
+    missingElementIds,
+    missingRelationshipIds,
+    parentElement,
+    childViews,
+  };
+}
+
 function resolveFocusElement(document, args) {
   if (args.elementId) {
     const element = (document.elements || []).find(entry => entry.id === args.elementId);
@@ -1820,6 +1920,11 @@ async function callTool(name, args = {}, dependencies = undefined) {
     return toolResult(attachContextWarnings(buildIntentElementContext(context, args), context));
   }
 
+  if (name === 'getArchitectureViewContext') {
+    const context = await loadContext(args);
+    return toolResult(attachContextWarnings(buildViewContext(context, args), context));
+  }
+
   if (name === 'generateArchitectureDiffPlantuml') {
     return toolResult(architectureDiffPlantuml.generateArchitectureDiffPlantuml({
       workspaceRoot: resolveWorkspaceRoot(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archgraph-argo",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Deploy the ArchGraph ARGO toolchain, skills, and rules (schema, scripts, argo-init skill, global rule) with one command.",
   "license": "MIT",
   "bin": {