@ryuenn3123/agentic-senior-core 3.0.5 → 3.0.6

package/.agent-context/state/memory-continuity-benchmark.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-18T13:45:51.853Z",
+  "generatedAt": "2026-04-19T03:52:25.678Z",
   "reportName": "memory-continuity-benchmark",
   "schemaVersion": "1.0.0",
   "passed": true,

package/.cursorrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v3.0.5
+Generated by Agentic-Senior-Core CLI v3.0.6
 Timestamp: 2026-04-18T00:00:00.000Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/.windsurfrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v3.0.5
+Generated by Agentic-Senior-Core CLI v3.0.6
 Timestamp: 2026-04-18T00:00:00.000Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/README.md

@@ -10,7 +10,7 @@
 **Production-grade Rules Engine (Governance Engine) for AI coding agents.**
 Works with Cursor, Windsurf, GitHub Copilot, Claude Code, Gemini, and other LLM-powered IDE workflows.
 
-Latest release: 3.0.5 (2026-04-18).
+Latest release: 3.0.6 (2026-04-19).
 
 Highlights in 3.0.0:
 - Universal IDE adapter surface is completed and synchronized through thin adapters.

package/lib/cli/commands/upgrade.mjs

@@ -256,6 +256,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
     console.log(`- Rules changed: ${isRulesContentChanged ? 'yes' : 'no'}`);
     console.log(`- Managed surface stale files: ${managedSurfacePlan.staleFiles.length}`);
     console.log(`- Managed surface stale directories: ${managedSurfacePlan.staleDirectories.length}`);
+    console.log(`- Managed surface sync mode: 1:1 (prune enabled)`);
     console.log(`- Managed surface prune mode: ${upgradeOptions.pruneManagedSurface === true ? 'enabled (default)' : 'disabled (--no-prune)'}`);
     console.log(`- MCP config write mode: ${upgradeOptions.includeMcpTemplate === true ? 'enabled (default)' : 'disabled (--no-mcp-template)'}`);
     if (projectDocStalenessReport.hasProjectDocs) {
@@ -332,11 +333,21 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       });
 
       console.log('\nUpgrade complete.');
+      console.log(`- Governance surface sync: 1:1 (${governanceSyncResult.updatedFiles.length} updated, ${governanceSyncResult.createdFiles.length} new, ${governanceSyncResult.deletedManagedFiles.length} deleted, ${governanceSyncResult.unchangedFiles.length} unchanged)`);
       console.log(`- Rules rewritten: ${isRulesContentChanged ? 'yes' : 'no (metadata refreshed)'}`);
-      console.log(`- Managed stale files removed: ${governanceSyncResult.deletedManagedFiles.length}`);
-      console.log(`- Managed stale directories removed: ${governanceSyncResult.deletedManagedDirectories.length}`);
+      if (governanceSyncResult.deletedManagedDirectories.length > 0) {
+        console.log(`- Managed stale directories removed: ${governanceSyncResult.deletedManagedDirectories.length}`);
+      }
       console.log(`- Setup time: ${formatDuration(setupDurationMs)}`);
-      console.log('- Updated files: .cursorrules, .windsurfrules, .agent-context/state/onboarding-report.json');
+
+      if (governanceSyncResult.updatedFiles.length > 0 || governanceSyncResult.createdFiles.length > 0 || governanceSyncResult.deletedManagedFiles.length > 0) {
+        console.log('\nDetailed changes:');
+        governanceSyncResult.createdFiles.forEach((fileName) => console.log(`  [NEW]     ${fileName}`));
+        governanceSyncResult.updatedFiles.forEach((fileName) => console.log(`  [UPDATED] ${fileName}`));
+        governanceSyncResult.deletedManagedFiles.forEach((fileName) => console.log(`  [DELETED] ${fileName}`));
+      }
+
+      console.log('\nRefreshed files: .cursorrules, .windsurfrules, .agent-context/state/onboarding-report.json');
     } catch (error) {
       console.error('\n[FATAL] An error occurred during upgrade. Attempting automatic rollback...');
       try {

package/lib/cli/utils.mjs

@@ -112,6 +112,66 @@ export async function copyDirectory(sourceDirectoryPath, targetDirectoryPath) {
   }
 }
 
+/**
+ * Synchronizes a single file between source and target, returning the operation status.
+ */
+export async function syncFile(sourcePath, targetPath) {
+  if (!(await pathExists(sourcePath))) return { status: 'skipped' };
+
+  if (!(await pathExists(targetPath))) {
+    await ensureDirectory(path.dirname(targetPath));
+    await fs.copyFile(sourcePath, targetPath);
+    return { status: 'created' };
+  }
+
+  const sourceContent = await fs.readFile(sourcePath);
+  const targetContent = await fs.readFile(targetPath);
+
+  if (sourceContent.equals(targetContent)) {
+    return { status: 'unchanged' };
+  }
+
+  await fs.copyFile(sourcePath, targetPath);
+  return { status: 'updated' };
+}
+
+/**
+ * Intelligent MCP configuration synchronization.
+ * Merges the agentic-senior-core server into existing config or creates new.
+ */
+async function syncMcpConfig(mcpJsonPath, templateConfig) {
+  const topKey = Object.keys(templateConfig)[0]; // e.g. "mcpServers" or "servers"
+  const serverName = 'agentic-senior-core';
+  const templateServer = templateConfig[topKey][serverName];
+
+  if (!(await pathExists(mcpJsonPath))) {
+    await ensureDirectory(path.dirname(mcpJsonPath));
+    await fs.writeFile(mcpJsonPath, JSON.stringify(templateConfig, null, 2) + '\n', 'utf8');
+    return { status: 'created' };
+  }
+
+  try {
+    const existingContent = await fs.readFile(mcpJsonPath, 'utf8');
+    const config = JSON.parse(existingContent);
+    
+    if (!config[topKey]) config[topKey] = {};
+    
+    const existingServer = config[topKey][serverName];
+
+    if (JSON.stringify(existingServer) === JSON.stringify(templateServer)) {
+       return { status: 'unchanged' };
+    }
+
+    config[topKey][serverName] = templateServer;
+    await fs.writeFile(mcpJsonPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+    return { status: 'updated' };
+  } catch {
+    // If JSON is broken, overwrite it as a last resort to recovery
+    await fs.writeFile(mcpJsonPath, JSON.stringify(templateConfig, null, 2) + '\n', 'utf8');
+    return { status: 'updated' };
+  }
+}
+
 function toPosixRelativePath(relativePath) {
   return relativePath.split(path.sep).join('/');
 }
@@ -281,9 +341,7 @@ export async function analyzeManagedGovernanceSurface(
     managedTargetFileCount: targetManifest.files.size,
     managedTargetDirectoryCount: targetManifest.directories.size,
   };
-}
-
-export async function copyGovernanceAssetsToTarget(
+}export async function copyGovernanceAssetsToTarget(
   resolvedTargetDirectoryPath,
   options = {}
 ) {
@@ -294,6 +352,9 @@ export async function copyGovernanceAssetsToTarget(
     : null;
   const deletedManagedFiles = [];
   const deletedManagedDirectories = [];
+  const createdFiles = [];
+  const updatedFiles = [];
+  const unchangedFiles = [];
 
   for (const sourceDirectoryName of directoryCopies) {
     const sourceDirectoryPath = path.join(REPO_ROOT, sourceDirectoryName);
@@ -301,7 +362,16 @@ export async function copyGovernanceAssetsToTarget(
       continue;
     }
 
-    await copyDirectory(sourceDirectoryPath, path.join(resolvedTargetDirectoryPath, sourceDirectoryName));
+    const sourceTree = await collectRelativeTreeEntries(sourceDirectoryPath, sourceDirectoryName);
+    for (const relativeFilePath of sourceTree.files) {
+      const sourcePath = path.join(REPO_ROOT, ...relativeFilePath.split('/'));
+      const targetPath = path.join(resolvedTargetDirectoryPath, ...relativeFilePath.split('/'));
+      const syncResult = await syncFile(sourcePath, targetPath);
+      
+      if (syncResult.status === 'created') createdFiles.push(relativeFilePath);
+      else if (syncResult.status === 'updated') updatedFiles.push(relativeFilePath);
+      else if (syncResult.status === 'unchanged') unchangedFiles.push(relativeFilePath);
+    }
   }
 
   for (const entryPointFileName of entryPointFiles) {
@@ -316,8 +386,10 @@ export async function copyGovernanceAssetsToTarget(
       continue;
     }
 
-    await ensureDirectory(path.dirname(targetFilePath));
-    await fs.copyFile(sourceFilePath, targetFilePath);
+    const syncResult = await syncFile(sourceFilePath, targetFilePath);
+    if (syncResult.status === 'created') createdFiles.push(entryPointFileName);
+    else if (syncResult.status === 'updated') updatedFiles.push(entryPointFileName);
+    else if (syncResult.status === 'unchanged') unchangedFiles.push(entryPointFileName);
   }
 
   if (shouldPruneManagedSurface && managedSurfacePlan) {
@@ -346,16 +418,14 @@ export async function copyGovernanceAssetsToTarget(
     const projectName = path.basename(resolvedTargetDirectoryPath);
     const mcpArgs = ['./scripts/mcp-server.mjs'];
 
-    // Ensure the MCP server entrypoint exists in the target project.
-    // The workspace MCP configs point at ./scripts/mcp-server.mjs, so we must copy it.
     const sourceMcpServerPath = path.join(REPO_ROOT, 'scripts', 'mcp-server.mjs');
     const targetMcpServerPath = path.join(resolvedTargetDirectoryPath, 'scripts', 'mcp-server.mjs');
-    await ensureDirectory(path.dirname(targetMcpServerPath));
-    await fs.copyFile(sourceMcpServerPath, targetMcpServerPath);
+    const mcpServerSync = await syncFile(sourceMcpServerPath, targetMcpServerPath);
+    if (mcpServerSync.status === 'created') createdFiles.push('scripts/mcp-server.mjs');
+    else if (mcpServerSync.status === 'updated') updatedFiles.push('scripts/mcp-server.mjs');
 
     // 1. VS Code (Workspace Local Settings)
-    const vscodeDirPath = path.join(resolvedTargetDirectoryPath, '.vscode');
-    const vscodeMcpJsonPath = path.join(vscodeDirPath, 'mcp.json');
+    const vscodeMcpJsonPath = path.join(resolvedTargetDirectoryPath, '.vscode', 'mcp.json');
     const vscodeWorkspaceMcpConfig = {
       servers: {
         'agentic-senior-core': {
@@ -366,15 +436,12 @@ export async function copyGovernanceAssetsToTarget(
         },
       },
     };
-
-    if (!(await pathExists(vscodeMcpJsonPath))) {
-      await ensureDirectory(vscodeDirPath);
-      await fs.writeFile(vscodeMcpJsonPath, JSON.stringify(vscodeWorkspaceMcpConfig, null, 2) + '\n', 'utf8');
-    }
+    const vscodeSync = await syncMcpConfig(vscodeMcpJsonPath, vscodeWorkspaceMcpConfig);
+    if (vscodeSync.status === 'created') createdFiles.push('.vscode/mcp.json');
+    else if (vscodeSync.status === 'updated') updatedFiles.push('.vscode/mcp.json');
 
     // 2. Cursor (Workspace Local Settings)
-    const cursorDirPath = path.join(resolvedTargetDirectoryPath, '.cursor');
-    const cursorMcpJsonPath = path.join(cursorDirPath, 'mcp.json');
+    const cursorMcpJsonPath = path.join(resolvedTargetDirectoryPath, '.cursor', 'mcp.json');
     const cursorWorkspaceMcpConfig = {
       mcpServers: {
         'agentic-senior-core': {
@@ -384,15 +451,12 @@ export async function copyGovernanceAssetsToTarget(
         },
       },
     };
-
-    if (!(await pathExists(cursorMcpJsonPath))) {
-      await ensureDirectory(cursorDirPath);
-      await fs.writeFile(cursorMcpJsonPath, JSON.stringify(cursorWorkspaceMcpConfig, null, 2) + '\n', 'utf8');
-    }
+    const cursorSync = await syncMcpConfig(cursorMcpJsonPath, cursorWorkspaceMcpConfig);
+    if (cursorSync.status === 'created') createdFiles.push('.cursor/mcp.json');
+    else if (cursorSync.status === 'updated') updatedFiles.push('.cursor/mcp.json');
 
     // 3. Zed IDE (Workspace Local Settings)
-    const zedDirPath = path.join(resolvedTargetDirectoryPath, '.zed');
-    const zedSettingsPath = path.join(zedDirPath, 'settings.json');
+    const zedSettingsPath = path.join(resolvedTargetDirectoryPath, '.zed', 'settings.json');
     const zedMcpConfig = {
       context_servers: {
         'agentic-senior-core': {
@@ -404,22 +468,22 @@ export async function copyGovernanceAssetsToTarget(
     };
 
     if (!(await pathExists(zedSettingsPath))) {
-      await ensureDirectory(zedDirPath);
+      await ensureDirectory(path.dirname(zedSettingsPath));
       await fs.writeFile(zedSettingsPath, JSON.stringify(zedMcpConfig, null, 2) + '\n', 'utf8');
+      createdFiles.push('.zed/settings.json');
     } else {
       try {
         const existingZedContent = await fs.readFile(zedSettingsPath, 'utf8');
         const parsedZedSettings = JSON.parse(existingZedContent);
-        if (!parsedZedSettings.context_servers) {
-          parsedZedSettings.context_servers = {};
-        }
-        if (!parsedZedSettings.context_servers['agentic-senior-core']) {
-          parsedZedSettings.context_servers['agentic-senior-core'] = zedMcpConfig.context_servers['agentic-senior-core'];
+        if (!parsedZedSettings.context_servers) parsedZedSettings.context_servers = {};
+        
+        const templateServer = zedMcpConfig.context_servers['agentic-senior-core'];
+        if (JSON.stringify(parsedZedSettings.context_servers['agentic-senior-core']) !== JSON.stringify(templateServer)) {
+          parsedZedSettings.context_servers['agentic-senior-core'] = templateServer;
           await fs.writeFile(zedSettingsPath, JSON.stringify(parsedZedSettings, null, 2) + '\n', 'utf8');
+          updatedFiles.push('.zed/settings.json');
         }
-      } catch {
-        // Fallback or ignore if user has broken JSON
-      }
+      } catch { /* Ignore malformed Zed JSON */ }
     }
 
     // 4. Antigravity / Gemini (Global Settings)
@@ -441,28 +505,29 @@ export async function copyGovernanceAssetsToTarget(
           
           const safeProjectName = projectName.replace(/[^a-zA-Z0-9_-]/g, '-');
           const uniqueServerName = `agentic-senior-core-${safeProjectName}`;
-          
-          // For global configs, we use absolute path for cwd
-          geminiConfig.mcpServers[uniqueServerName] = {
+          const templateServer = {
             command: 'node',
             args: mcpArgs,
             cwd: resolvedTargetDirectoryPath,
           };
           
-          await fs.writeFile(globalGeminiMcpPath, JSON.stringify(geminiConfig, null, 2) + '\n', 'utf8');
+          if (JSON.stringify(geminiConfig.mcpServers[uniqueServerName]) !== JSON.stringify(templateServer)) {
+             geminiConfig.mcpServers[uniqueServerName] = templateServer;
+             await fs.writeFile(globalGeminiMcpPath, JSON.stringify(geminiConfig, null, 2) + '\n', 'utf8');
+          }
         }
-      } catch {
-        // Ignore global injection errors
-      }
+      } catch { /* Ignore global injection errors */ }
     }
   }
 
   return {
     deletedManagedFiles,
     deletedManagedDirectories,
+    createdFiles,
+    updatedFiles,
+    unchangedFiles,
     managedSurfacePlan,
   };
-
 }
 
 export async function askChoice(promptMessage, options, userInterface) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "3.0.5",
+  "version": "3.0.6",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {