archgraph-argo 0.12.2 → 0.12.4

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

@@ -33,8 +33,8 @@ const EA_TEMPLATE_PATH_CANDIDATES = [
   ['.opencode', 'EA-model-template.qea'],
   ['eatool', 'EA-model-template.qea'],
   ['EA-model-template.qea'],
-  ['Argo.feap'],
 ];
+const EA_MODEL_EXTENSIONS = new Set(['.qea', '.feap', '.eap']);
 const WINDOWS_RESERVED_NAMES = new Set([
   'CON', 'PRN', 'AUX', 'NUL',
   'COM1', 'COM2', 'COM3', 'COM4', 'COM5', 'COM6', 'COM7', 'COM8', 'COM9',
@@ -379,7 +379,7 @@ async function callTool(name, args = {}, progressToken = null, dependencies = un
     return toolResult({
       status: report.status,
       workspaceRoot: workspace.workspaceRoot,
-      targetFeapName: workspace.targetFeapName,
+      targetEaName: workspace.targetEaName,
       createdFiles: workspace.createdFiles,
       updatedFiles: workspace.updatedFiles,
       removedFiles: workspace.removedFiles,
@@ -387,7 +387,7 @@ async function callTool(name, args = {}, progressToken = null, dependencies = un
       workspaceBootstrap: {
         status: 'ok',
         workspaceRoot: workspace.workspaceRoot,
-        targetFeapName: workspace.targetFeapName,
+        targetEaName: workspace.targetEaName,
         createdFiles: workspace.createdFiles,
         updatedFiles: workspace.updatedFiles,
         removedFiles: workspace.removedFiles,
@@ -481,13 +481,18 @@ async function initializeWorkspace(workspaceRoot) {
   }
 
   const templateSourcePath = resolveTemplateSourcePath(workspaceRoot);
-  const targetFeapName = buildTargetFileName(workspaceName);
-  const targetFeapPath = path.join(workspaceRoot, targetFeapName);
-  if (!fs.existsSync(targetFeapPath)) {
-    await fs.promises.copyFile(templateSourcePath, targetFeapPath);
-    createdFiles.push(normalizeRelativePath(targetFeapName));
+  const targetEaName = buildEaTargetFileName(workspaceName);
+  const targetEaPath = path.join(workspaceRoot, targetEaName);
+  const existingEaFiles = listExistingEaModelFiles(workspaceRoot);
+  if (existingEaFiles.length === 0) {
+    // No EA model file in the workspace: bootstrap a project-named .qea from the
+    // template (EA 17.2+ .qea/SQLite). Never generate a legacy .feap anymore.
+    await fs.promises.copyFile(templateSourcePath, targetEaPath);
+    createdFiles.push(normalizeRelativePath(targetEaName));
+  } else if (existingEaFiles.includes(targetEaName)) {
+    skippedSteps.push(`${normalizeRelativePath(targetEaName)} already exists`);
   } else {
-    skippedSteps.push(`${normalizeRelativePath(targetFeapName)} already exists`);
+    skippedSteps.push(`EA model already present (${existingEaFiles.join(', ')}); skip bootstrapping ${normalizeRelativePath(targetEaName)}`);
   }
 
   for (const handoffPath of HANDOFF_FILES_TO_RESET) {
@@ -509,7 +514,7 @@ async function initializeWorkspace(workspaceRoot) {
   return {
     workspaceRoot,
     qeaFullProjection,
-    targetFeapName,
+    targetEaName,
     createdFiles,
     updatedFiles,
     removedFiles,
@@ -543,12 +548,24 @@ function resolveGraphDefaultSourcePath() {
   throw new Error(`Unable to locate default SystemArchitecture template. Checked: bundled ${BUNDLED_GRAPH_DEFAULT_SEGMENTS.join('/')}`);
 }
 
-function buildTargetFileName(workspaceName) {
+function listExistingEaModelFiles(workspaceRoot) {
+  let names = [];
+  try {
+    names = fs.readdirSync(workspaceRoot).filter(name =>
+      EA_MODEL_EXTENSIONS.has(path.extname(name).toLowerCase()),
+    );
+  } catch {
+    /* treat an unreadable root as having no EA model file */
+  }
+  return names.sort();
+}
+
+function buildEaTargetFileName(workspaceName) {
   const sanitized = sanitizeFileName(workspaceName) || 'workspace';
   const safeBaseName = WINDOWS_RESERVED_NAMES.has(sanitized.toUpperCase())
     ? `${sanitized}_workspace`
     : sanitized;
-  return `${safeBaseName}.feap`;
+  return `${safeBaseName}.qea`;
 }
 
 function sanitizeFileName(value) {

package/argo/scripts/ensureArgoHarnessEnvironment.js

@@ -135,7 +135,7 @@ async function ensureWorkspaceBootstrap({ checkOnly, workspaceRoot }) {
     return {
       status: 'ok',
       workspaceRoot: workspace.workspaceRoot,
-      targetFeapName: workspace.targetFeapName,
+      targetEaName: workspace.targetEaName,
       createdFiles: workspace.createdFiles,
       updatedFiles: workspace.updatedFiles,
       removedFiles: workspace.removedFiles,

package/argo/skills/argo-init/SKILL.md

@@ -7,9 +7,9 @@ disable-model-invocation: true
 
 # ARGO INIT
 
-`argo-init` 通过 ARGO MCP 的 `initializeWorkspace` 接口完成确定性初始化：工作区 bootstrap（缺 `SystemArchitecture.json` / `.feap` 自动生成）+ Neo4j 结构投影同步 + **.qea 全量投影（整库清空重建，逻辑同 Neo4j init）** + 语义生命周期初始化 + canonical 校验 + subdiagram_views 一致性，并返回完整报告。**不需要也不应执行任何 WORKSPACE 外脚本**——所有确定性步骤都在 MCP 进程内完成，避免扩大访问面。
+`argo-init` 通过 ARGO MCP 的 `initializeWorkspace` 接口完成确定性初始化：工作区 bootstrap（缺 `SystemArchitecture.json` / EA 模型文件（`.qea`）自动生成）+ Neo4j 结构投影同步 + **.qea 全量投影（整库清空重建，逻辑同 Neo4j init）** + 语义生命周期初始化 + canonical 校验 + subdiagram_views 一致性，并返回完整报告。**不需要也不应执行任何 WORKSPACE 外脚本**——所有确定性步骤都在 MCP 进程内完成，避免扩大访问面。
 
-- 工作区缺少 `design/KG/SystemArchitecture.json` 时自动从部署的 `defaults` 拷贝默认模板；缺 `.feap` 时以当前项目名拷贝默认模板。
+- 工作区缺少 `design/KG/SystemArchitecture.json` 时自动从部署的 `defaults` 拷贝默认模板；缺 EA 模型文件（仓库根无 `.qea`/`.feap`/`.eap`）时以当前项目名拷贝默认 `.qea` 模板（不再补建遗留 `.feap`）。
 - 本机 Neo4j 连接可用，canonical 意图图完成至少一次 JSON -> Neo4j 初始同步并通过一致性校验；**投影到的 Neo4j 数据库名称必须与本仓库名称一致**（如仓库 archgraph → 库 archgraph），不一致须报告为告警/失败。
 - **.qea 投影**：init 对仓库 EA 文件（仓库根 `.qea`，经 `ARGO_EA_QEA` 或仓库根唯一 `*.qea` 解析）执行整库清空后全量重建；**必须确认投影目标是本仓库自己的 `.qea` 文件**，并报告投影成功/失败与耗时。
 - 语义生命周期：双 gate 未开启时记录 skipped/disabled；开启时执行全量 embedding backfill 与 readiness 对齐。
@@ -29,7 +29,7 @@ disable-model-invocation: true
 
 调用 ARGO MCP 工具 `initializeWorkspace`（传入当前工作区根 `workspaceRoot`）。该接口在 MCP 进程内完成全部确定性步骤并返回报告：
 
-- `workspaceBootstrap`：缺 `SystemArchitecture.json` / `.feap` 时自动生成（createdFiles / skippedSteps）
+- `workspaceBootstrap`：缺 `SystemArchitecture.json` / EA 模型文件时自动生成 `.qea`（createdFiles / skippedSteps；仓库根已有 `.qea`/`.feap` 时不重复补建）
 - `mcp`：ARGO MCP 健康（协议 / tools-list / ping）
 - `systemArchitecture`：canonical 校验（元素/关系/视图计数）
 - `subdiagramViews`：subdiagram_views 一致性检查/修复

package/package.json

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