@ryuenn3123/agentic-senior-core 3.0.39 → 3.0.41

package/.agent-context/prompts/init-project.md

@@ -7,7 +7,7 @@ This prompt boots a repository with strict AI coding guidance context.
 When a new project is created or initialized, the agent must automatically:
 1. Read [AGENTS.md](../../AGENTS.md) to understand the canonical bootstrap chain and active entrypoints.
 2. Resolve the smallest relevant rule set from [.agent-context/rules/](../rules/) instead of scanning the whole directory by default.
-3. Review dynamic runtime signals from [.agent-context/state/onboarding-report.json](../state/onboarding-report.json), [.agent-context/state/stack-research-snapshot.json](../state/stack-research-snapshot.json), repository evidence, and task constraints.
+3. Review dynamic runtime signals from [.agent-context/state/onboarding-report.json](../state/onboarding-report.json), repository evidence, task constraints, and live official documentation when runtime or ecosystem facts matter.
 4. If Docker or Compose is in scope, load [docker-runtime.md](../rules/docker-runtime.md) and verify the latest official Docker guidance before authoring container assets.
 5. For unresolved framework or package setup, recommend the latest stable compatible dependency set and official framework setup flow from live official documentation before coding unless a documented compatibility constraint blocks it.
 

package/.agent-context/prompts/refactor.md

@@ -15,6 +15,7 @@ Before editing:
 7. Enforce backend universal principles: no clever hacks, no premature abstraction, readability over brevity.
 8. For backend/API scope, enforce layered boundaries, zero-trust input validation, safe centralized error responses, bounded list reads, transaction safety for multi-write mutations, idempotency for sensitive mutations, and behavior-focused API tests.
 9. Backend/API governance is global and stack-agnostic. Do not create stack-specific adapters or framework-specific rule branches; apply the global rules through the framework already present in the target project.
+10. Enforce the complexity budget: choose fewer moving parts only when behavior, safety, clarity, and maintainability stay intact.
 
 Refactor rules:
 - Improve clarity, boundaries, naming, validation, error handling, tests, and docs.
@@ -23,6 +24,9 @@ Refactor rules:
 - Keep module boundaries explicit and project-specific.
 - Split large files when the split makes the flow easier to understand.
 - Do not introduce abstractions before the repeated pattern is real.
+- Remove code that does not carry behavior, safety, clarity, maintainability, or test value.
+- Prefer the shorter implementation only when it keeps the same guarantees.
+- Run a final simplification pass before completion.
 - Update tests and docs whenever behavior contracts, public APIs, data shape, or UI contracts change.
 
 For every meaningful change, explain:

package/.agent-context/review-checklists/pr-checklist.md

@@ -25,6 +25,7 @@ Run this before declaring a task done. Apply only the sections relevant to the c
 - [ ] No clever hacks in backend and shared core modules
 - [ ] No premature abstraction (base classes/util layers created only after repeated stable patterns)
 - [ ] Readability over brevity for maintainability
+- [ ] Complexity budget was applied: equivalent behavior uses fewer moving parts without losing validation, error handling, fallbacks, accessibility, tests, or security boundaries.
 - [ ] Controllers, route handlers, and transport adapters do not contain business policy, raw queries, or cross-resource orchestration.
 - [ ] Services or use cases own business flow, transaction boundaries, and mutation safety.
 - [ ] Repositories or adapters own persistence/external IO details without hiding business decisions.

package/.agent-context/rules/architecture.md

@@ -12,6 +12,19 @@ These principles are mandatory for backend and shared core modules.
 - Keep transport, application, domain, and infrastructure concerns separated.
 - Favor explicit module boundaries over hidden cross-layer shortcuts.
 
+## Complexity Budget (Mandatory)
+
+Prefer the smallest clear implementation that fully preserves behavior, safety, and maintainability.
+
+- If two implementations are equivalent in behavior and quality, choose the one with fewer moving parts.
+- Remove code that does not carry behavior, safety, clarity, maintainability, or test value.
+- Prefer direct logic over extra wrappers, layers, classes, config, or state when the abstraction does not reduce real complexity.
+- Keep validation, error handling, fallback paths, accessibility, tests, security boundaries, and observability when they protect real behavior.
+- Run a final simplification pass before completion.
+- Do not optimize for line count alone.
+- Do not replace clear code with clever, dense, or surprising code.
+- Do not remove safeguards just because the happy path works.
+
 ## Universal SOP Baseline (Mandatory)
 
 The `.agent-context/rules/` directory is the default guidance source for implementation and review.
@@ -91,6 +104,7 @@ Service separation only makes sense when multiple signals are true, such as:
 - Cross-cutting utilities belong in explicit shared locations, not scattered feature internals.
 - Files above roughly 1000 lines are a refactor trigger, not a success signal.
 - Preserve one clear public entrypoint per module when helpful, but move implementation into smaller focused files.
+- Keep code compact because the design is understood, not because safeguards were removed.
 
 ## Module Communication
 

package/.agent-context/state/README.md

@@ -8,11 +8,9 @@ Tracked seed/config artifacts:
 - `benchmark-comparison-schema.json`
 - `benchmark-reproducibility.json`
 - `benchmark-thresholds.json`
-- `benchmark-watchlist.json`
 - `benchmark-writer-judge-config.json`
 - `memory-adapter-contract.json`
 - `memory-schema-v1.json`
-- `stack-research-snapshot.json`
 
 Tracked operational artifact:
 - `onboarding-report.json` stays tracked in this repository because internal audits read it as the current repository onboarding state. In installed projects, `init` and `upgrade` regenerate this file.
@@ -23,4 +21,4 @@ Local-only/generated artifacts:
 - `llm-judge-report.json`
 - benchmark, trend, weekly governance, and quality report outputs
 
-Do not treat generated reports as current project truth. Rerun the matching `npm run benchmark:*`, `npm run report:*`, or `npm run audit:*` command when fresh evidence is needed.
+Do not treat generated reports or archived research as current project truth. Rerun the matching `npm run benchmark:*`, `npm run report:*`, or `npm run audit:*` command when fresh evidence is needed.

package/.agent-context/state/benchmark-reproducibility.json

@@ -59,12 +59,12 @@
       "inputReferences": [
         "scripts/release-gate.mjs",
         "scripts/benchmark-intelligence.mjs",
-        ".agent-context/state/benchmark-watchlist.json"
+        "scripts/benchmark-gate.mjs"
       ],
       "expectedSignals": [
         "release readiness",
-        "competitive coverage",
-        "SLA freshness"
+        "static external watchlist retirement",
+        "no stale benchmark research dependency"
       ],
       "primaryCommand": "npm run benchmark:intelligence"
     }
@@ -72,7 +72,7 @@
   "rerunInstructions": [
     "Run npm run benchmark:detection to regenerate detection benchmark output.",
     "Run npm run benchmark:gate to validate benchmark anti-regression thresholds.",
-    "Run npm run benchmark:intelligence to validate benchmark watchlist freshness.",
+    "Run npm run benchmark:intelligence to confirm static external benchmark watchlists stay retired.",
     "Run npm run benchmark:bundle to emit a reproducible benchmark evidence bundle.",
     "Run npm run benchmark:writer-judge to emit writer-judge side-by-side matrix output."
   ],

package/.cursorrules

@@ -1,6 +1,6 @@
 # .cursorrules - Legacy Thin Adapter
 
-Generated by Agentic-Senior-Core CLI v3.0.39
+Generated by Agentic-Senior-Core CLI v3.0.41
 Adapter Mode: legacy-thin
 Adapter Source: .agent-instructions.md when present; fallback .instructions.md
 Canonical baseline: .instructions.md

package/.windsurfrules

@@ -1,6 +1,6 @@
 # .windsurfrules - Legacy Thin Adapter
 
-Generated by Agentic-Senior-Core CLI v3.0.39
+Generated by Agentic-Senior-Core CLI v3.0.41
 Adapter Mode: legacy-thin
 Adapter Source: .agent-instructions.md when present; fallback .instructions.md
 Canonical baseline: .instructions.md

package/CONTRIBUTING.md

@@ -88,7 +88,6 @@ If all three are "yes", it belongs here.
 - Generic content that reads like it was auto-generated without thought
 - Rules without concrete enforcement boundaries
 - Stack profiles for languages the author doesn't actually use in production
-- Blueprints that are just folder structures without code patterns
 - PRs that don't update the relevant source files, generated adapters, and checklists
 
 ---
@@ -97,6 +96,13 @@ If all three are "yes", it belongs here.
 
 The npm package is published under `@ryuenn3123`, while the GitHub repository is hosted under `fatidaprilian`.
 
+### Architecture Boundaries
+
+When contributing code to the CLI or the maintenance tools, respect the boundary between `lib/` and `scripts/`:
+
+- **`lib/`**: Contains the core CLI application logic. These files are executed by the package binary but are **never** copied into target user workspaces.
+- **`scripts/`**: Contains standalone tools (like validators, audits, and benchmarks) AND the MCP server (`scripts/mcp-server.mjs`). Code here must not depend on `lib/` because some scripts (like the MCP server) are copied directly to target workspaces where `lib/` does not exist.
+
 ```bash
 # Clone
 git clone https://github.com/fatidaprilian/Agentic-Senior-Core.git

package/README.md

@@ -10,12 +10,12 @@
 **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.39 (2026-04-30).
+Latest release: 3.0.40 (2026-04-30).
 
-Highlights in 3.0.39:
-- Post-release hygiene removes stale V2 evidence-bundle and Bun lockfile drift surfaces.
-- Package and lockfile validation now blocks version drift and accidental dual package-manager state.
-- Repo-local agent context now documents frontend/backend governance boundaries and anti-grid wallpaper handling.
+Highlights in 3.0.40:
+- Adds a mandatory complexity budget so agents choose fewer moving parts only when quality stays intact.
+- Refactor guidance now requires a final simplification pass before completion.
+- Release tooling keeps legacy root adapter version metadata aligned with package bumps.
 
 </div>
 
@@ -131,7 +131,7 @@ Full mapping reference: docs/terminology-mapping.md
 
 - FAQ: docs/faq.md
 - Deep dive internals: docs/deep-dive.md
-- V2 upgrade playbook: docs/v2-upgrade-playbook.md
+- Archived V2 upgrade playbook: docs/archive/v2-upgrade-playbook.md
 - Integration playbook: docs/integration-playbook.md
 - Benchmark and stack reference: docs/benchmark-reference.md
 - Terminology mapping reference: docs/terminology-mapping.md

package/lib/cli/backup.mjs

@@ -2,9 +2,7 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import crypto from 'node:crypto';
 import { pathExists, ensureDirectory } from './utils.mjs';
-import { entryPointFiles } from './constants.mjs';
-
-const BACKUP_DIR_NAME = '.agentic-backup';
+import { entryPointFiles, BACKUP_DIR_NAME } from './constants.mjs';
 
 /**
  * Calculates a SHA-256 hash of a file's contents.

package/lib/cli/commands/init.mjs

@@ -81,7 +81,7 @@ import {
   resolveSilentCiGuardrailsDefault,
 } from './init/setup-decisions.mjs';
 
-export { REPO_ROOT } from '../constants.mjs';
+export { REPOSITORY_ROOT } from '../constants.mjs';
 export {
   parseInitArguments,
   normalizeRuntimeEnvironmentKey,

package/lib/cli/constants.mjs

@@ -9,10 +9,10 @@ import { fileURLToPath } from 'node:url';
 const currentFilePath = fileURLToPath(import.meta.url);
 const currentDirectoryPath = dirname(currentFilePath);
 
-export const REPO_ROOT = resolve(currentDirectoryPath, '..', '..');
-export const PACKAGE_JSON_PATH = join(REPO_ROOT, 'package.json');
+export const REPOSITORY_ROOT = resolve(currentDirectoryPath, '..', '..');
+export const PACKAGE_JSON_PATH = join(REPOSITORY_ROOT, 'package.json');
 export const CLI_VERSION = JSON.parse(readFileSync(PACKAGE_JSON_PATH, 'utf8')).version;
-export const AGENT_CONTEXT_DIR = join(REPO_ROOT, '.agent-context');
+export const AGENT_CONTEXT_DIR = join(REPOSITORY_ROOT, '.agent-context');
 export const POLICY_FILE_NAME = 'llm-judge-threshold.json';
 
 export const ALLOWED_SEVERITY_LEVELS = new Set(['critical', 'high', 'medium', 'low']);
@@ -140,3 +140,5 @@ export const entryPointFiles = [
 ];
 
 export const directoryCopies = ['.agent-context', '.gemini', '.agents'];
+
+export const BACKUP_DIR_NAME = '.agentic-backup';

package/lib/cli/rollback.mjs

@@ -1,8 +1,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { pathExists, ensureDirectory } from './utils.mjs';
-
-const BACKUP_DIR_NAME = '.agentic-backup';
+import { BACKUP_DIR_NAME } from './constants.mjs';
 
 /**
  * Performs a rollback of a target directory using the backup manifest.

package/lib/cli/utils/managed-surface.mjs

@@ -2,7 +2,7 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 
 import {
-  REPO_ROOT,
+  REPOSITORY_ROOT,
   entryPointFiles,
   directoryCopies,
 } from '../constants.mjs';
@@ -102,7 +102,7 @@ async function buildManagedSourceManifest(options = {}) {
   const sourceDirectories = new Set();
 
   for (const sourceDirectoryName of directoryCopies) {
-    const sourceDirectoryPath = path.join(REPO_ROOT, sourceDirectoryName);
+    const sourceDirectoryPath = path.join(REPOSITORY_ROOT, sourceDirectoryName);
     const sourceTreeEntries = await collectRelativeTreeEntries(sourceDirectoryPath, sourceDirectoryName);
 
     for (const sourceFilePath of sourceTreeEntries.files) {
@@ -115,7 +115,7 @@ async function buildManagedSourceManifest(options = {}) {
   }
 
   for (const entryPointFileName of entryPointFiles) {
-    const sourceFilePath = path.join(REPO_ROOT, entryPointFileName);
+    const sourceFilePath = path.join(REPOSITORY_ROOT, entryPointFileName);
     if (!(await pathExists(sourceFilePath))) {
       continue;
     }
@@ -123,7 +123,7 @@ async function buildManagedSourceManifest(options = {}) {
     sourceFiles.add(toPosixRelativePath(entryPointFileName));
   }
 
-  const optionalManagedEntries = await collectOptionalManagedEntries(REPO_ROOT, options);
+  const optionalManagedEntries = await collectOptionalManagedEntries(REPOSITORY_ROOT, options);
   for (const sourceFilePath of optionalManagedEntries.files) {
     sourceFiles.add(sourceFilePath);
   }

package/lib/cli/utils.mjs

@@ -7,7 +7,7 @@ import path from 'node:path';
 import os from 'node:os';
 
 import {
-  REPO_ROOT,
+  REPOSITORY_ROOT,
   ALLOWED_SEVERITY_LEVELS,
   PROFILE_PRESETS,
   INIT_PRESETS,
@@ -144,14 +144,14 @@ export async function copyGovernanceAssetsToTarget(
   const preservedFiles = [];
 
   for (const sourceDirectoryName of directoryCopies) {
-    const sourceDirectoryPath = path.join(REPO_ROOT, sourceDirectoryName);
+    const sourceDirectoryPath = path.join(REPOSITORY_ROOT, sourceDirectoryName);
     if (!(await pathExists(sourceDirectoryPath))) {
       continue;
     }
 
     const sourceTree = await collectRelativeTreeEntries(sourceDirectoryPath, sourceDirectoryName);
     for (const relativeFilePath of sourceTree.files) {
-      const sourcePath = path.join(REPO_ROOT, ...relativeFilePath.split('/'));
+      const sourcePath = path.join(REPOSITORY_ROOT, ...relativeFilePath.split('/'));
       const targetPath = path.join(resolvedTargetDirectoryPath, ...relativeFilePath.split('/'));
       const syncResult = await syncFile(sourcePath, targetPath, {
         preserveUserOwned: sourceDirectoryName === '.gemini',
@@ -165,7 +165,7 @@ export async function copyGovernanceAssetsToTarget(
   }
 
   for (const entryPointFileName of entryPointFiles) {
-    const sourceFilePath = path.join(REPO_ROOT, entryPointFileName);
+    const sourceFilePath = path.join(REPOSITORY_ROOT, entryPointFileName);
     const targetFilePath = path.join(resolvedTargetDirectoryPath, entryPointFileName);
 
     if (!(await pathExists(sourceFilePath))) {
@@ -211,13 +211,13 @@ export async function copyGovernanceAssetsToTarget(
     const projectName = path.basename(resolvedTargetDirectoryPath);
     const mcpArgs = ['./scripts/mcp-server.mjs'];
 
-    const sourceMcpServerPath = path.join(REPO_ROOT, 'scripts', 'mcp-server.mjs');
+    const sourceMcpServerPath = path.join(REPOSITORY_ROOT, 'scripts', 'mcp-server.mjs');
     const targetMcpServerPath = path.join(resolvedTargetDirectoryPath, 'scripts', 'mcp-server.mjs');
     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');
 
-    const sourceMcpHelpersDirectoryPath = path.join(REPO_ROOT, 'scripts', 'mcp-server');
+    const sourceMcpHelpersDirectoryPath = path.join(REPOSITORY_ROOT, 'scripts', 'mcp-server');
     if (await pathExists(sourceMcpHelpersDirectoryPath)) {
       const mcpHelperTreeEntries = await collectRelativeTreeEntries(
         sourceMcpHelpersDirectoryPath,
@@ -225,7 +225,7 @@ export async function copyGovernanceAssetsToTarget(
       );
 
       for (const relativeHelperFilePath of mcpHelperTreeEntries.files) {
-        const sourceHelperFilePath = path.join(REPO_ROOT, ...relativeHelperFilePath.split('/'));
+        const sourceHelperFilePath = path.join(REPOSITORY_ROOT, ...relativeHelperFilePath.split('/'));
         const targetHelperFilePath = path.join(resolvedTargetDirectoryPath, ...relativeHelperFilePath.split('/'));
         const helperSyncResult = await syncFile(sourceHelperFilePath, targetHelperFilePath);
 
@@ -303,8 +303,13 @@ export async function copyGovernanceAssetsToTarget(
       try {
         const globalGeminiDir = path.join(os.homedir(), '.gemini', 'antigravity');
         const globalGeminiMcpPath = path.join(globalGeminiDir, 'mcp_config.json');
-        
-        if (await pathExists(globalGeminiDir)) {
+        const targetMcpServerScript = path.join(resolvedTargetDirectoryPath, 'scripts', 'mcp-server.mjs');
+
+        // Only inject if the MCP server script will actually exist at the target.
+        // When the script is missing, Antigravity blocks all chat instead of degrading gracefully.
+        const targetHasMcpServer = await pathExists(targetMcpServerScript);
+
+        if (targetHasMcpServer && await pathExists(globalGeminiDir)) {
           let geminiConfig = { mcpServers: {} };
           if (await pathExists(globalGeminiMcpPath)) {
             const content = await fs.readFile(globalGeminiMcpPath, 'utf8');
@@ -313,7 +318,20 @@ export async function copyGovernanceAssetsToTarget(
             }
           }
           if (!geminiConfig.mcpServers) geminiConfig.mcpServers = {};
-          
+
+          // Prune stale agentic-senior-core entries whose workspace no longer exists
+          let configChanged = false;
+          for (const serverName of Object.keys(geminiConfig.mcpServers)) {
+            if (!serverName.startsWith('agentic-senior-core-')) continue;
+            const serverEntry = geminiConfig.mcpServers[serverName];
+            if (!serverEntry?.cwd) continue;
+            const staleMcpScript = path.join(serverEntry.cwd, 'scripts', 'mcp-server.mjs');
+            if (!(await pathExists(staleMcpScript))) {
+              delete geminiConfig.mcpServers[serverName];
+              configChanged = true;
+            }
+          }
+
           const safeProjectName = projectName.replace(/[^a-zA-Z0-9_-]/g, '-');
           const uniqueServerName = `agentic-senior-core-${safeProjectName}`;
           const templateServer = {
@@ -324,7 +342,11 @@ export async function copyGovernanceAssetsToTarget(
           
           if (JSON.stringify(geminiConfig.mcpServers[uniqueServerName]) !== JSON.stringify(templateServer)) {
              geminiConfig.mcpServers[uniqueServerName] = templateServer;
-             await fs.writeFile(globalGeminiMcpPath, JSON.stringify(geminiConfig, null, 2) + '\n', 'utf8');
+             configChanged = true;
+          }
+
+          if (configChanged) {
+            await fs.writeFile(globalGeminiMcpPath, JSON.stringify(geminiConfig, null, 2) + '\n', 'utf8');
           }
         }
       } catch { /* Ignore global injection errors */ }

package/mcp.json

@@ -13,31 +13,44 @@
       },
       "stack-strategies": {
         "path": "dynamic",
-        "count": 0,
-        "autoLoad": true
+        "autoLoad": true,
+        "type": "virtual"
       },
       "architecture-playbooks": {
         "path": "dynamic",
-        "count": 0,
-        "autoLoad": true
+        "autoLoad": true,
+        "type": "virtual"
       },
       "execution-contracts": {
         "path": "dynamic",
-        "count": 0,
         "autoLoad": true,
-        "sources": ["prompts", "review-checklists", "policies"]
+        "sources": [
+          "prompts",
+          "review-checklists",
+          "policies"
+        ],
+        "type": "virtual"
       },
       "prompts": {
         "path": ".agent-context/prompts",
         "count": 4,
         "autoLoad": true,
-        "templates": ["init-project", "bootstrap-design", "refactor", "review-code"]
+        "templates": [
+          "init-project",
+          "bootstrap-design",
+          "refactor",
+          "review-code"
+        ]
       },
       "governance-modes": {
         "path": "dynamic",
-        "count": 0,
         "autoLoad": true,
-        "governance": ["platform", "regulated", "startup"]
+        "governance": [
+          "platform",
+          "regulated",
+          "startup"
+        ],
+        "type": "virtual"
       },
       "state": {
         "path": ".agent-context/state",
@@ -53,25 +66,24 @@
         "path": "docs",
         "count": 0,
         "autoLoad": false,
-        "sources": ["project-brief", "architecture-decision-record", "flow-overview", "api-contract", "database-schema", "DESIGN", "design-intent"]
+        "sources": [
+          "project-brief",
+          "architecture-decision-record",
+          "flow-overview",
+          "api-contract",
+          "database-schema",
+          "DESIGN",
+          "design-intent"
+        ]
       }
     }
   },
-  "servers": {
-    "lint": {
-      "command": "node",
-      "args": ["./scripts/validate.mjs"],
-      "transport": "stdio"
-    },
-    "test": {
-      "command": "node",
-      "args": ["--test", "./tests/cli-smoke.test.mjs", "./tests/llm-judge.test.mjs"],
-      "transport": "stdio"
-    }
-  },
   "workflows": {
     "self-heal-on-failure": {
-      "trigger": ["ci.failure", "lint.failure"],
+      "trigger": [
+        "ci.failure",
+        "lint.failure"
+      ],
       "steps": [
         "collect_logs",
         "map_violation_to_rule",
@@ -80,7 +92,10 @@
       ]
     },
     "full-knowledge-injection": {
-      "trigger": ["workspace.initialize", "agent.start"],
+      "trigger": [
+        "workspace.initialize",
+        "agent.start"
+      ],
       "steps": [
         "resolve_scope_first",
         "inject_relevant_rules",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "3.0.39",
+  "version": "3.0.41",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {
@@ -21,11 +21,9 @@
     ".agent-context/state/benchmark-comparison-schema.json",
     ".agent-context/state/benchmark-reproducibility.json",
     ".agent-context/state/benchmark-thresholds.json",
-    ".agent-context/state/benchmark-watchlist.json",
     ".agent-context/state/benchmark-writer-judge-config.json",
     ".agent-context/state/memory-adapter-contract.json",
     ".agent-context/state/memory-schema-v1.json",
-    ".agent-context/state/stack-research-snapshot.json",
     ".agents/",
     ".cursor/",
     ".github/",
@@ -85,6 +83,6 @@
     "report:governance-weekly": "node ./scripts/governance-weekly-report.mjs",
     "clean:local": "node ./scripts/clean-local-artifacts.mjs",
     "validate": "node ./scripts/validate.mjs",
-    "test": "node --test ./tests/cli-smoke.test.mjs ./tests/mcp-server.test.mjs ./tests/llm-judge.test.mjs ./tests/ui-rubric-calibration.test.mjs ./tests/operations.test.mjs"
+    "test": "node --test ./tests/cli-smoke.test.mjs ./tests/mcp-server.test.mjs ./tests/llm-judge.test.mjs ./tests/ui-rubric-calibration.test.mjs ./tests/operations.test.mjs ./tests/knowledge-injection.test.mjs"
   }
 }

package/scripts/benchmark-evidence-bundle.mjs

@@ -22,7 +22,6 @@ const isStdoutOnlyMode = ARGUMENT_FLAGS.has('--stdout-only');
 const PACKAGE_JSON_PATH = join(REPOSITORY_ROOT, 'package.json');
 const REPRO_PROFILE_PATH = join(REPOSITORY_ROOT, '.agent-context', 'state', 'benchmark-reproducibility.json');
 const BENCHMARK_THRESHOLD_PATH = join(REPOSITORY_ROOT, '.agent-context', 'state', 'benchmark-thresholds.json');
-const BENCHMARK_WATCHLIST_PATH = join(REPOSITORY_ROOT, '.agent-context', 'state', 'benchmark-watchlist.json');
 const MEMORY_SCHEMA_PATH = join(REPOSITORY_ROOT, '.agent-context', 'state', 'memory-schema-v1.json');
 const MEMORY_ADAPTER_CONTRACT_PATH = join(REPOSITORY_ROOT, '.agent-context', 'state', 'memory-adapter-contract.json');
 const OUTPUT_PATH = join(REPOSITORY_ROOT, '.agent-context', 'state', 'benchmark-evidence-bundle.json');
@@ -233,6 +232,7 @@ function buildRubricSummary(thresholdConfiguration, intelligenceReport, memoryCo
       maximumManualCorrectionIncrease: thresholdConfiguration?.maximumManualCorrectionIncrease ?? null,
     },
     intelligenceSlaDays: intelligenceReport?.reviewSlaDays ?? null,
+    staticExternalWatchlistRetired: intelligenceReport?.staticExternalWatchlistRetired === true,
     reliabilityThresholds: RELIABILITY_THRESHOLDS,
     continuityThresholds: memoryContinuityReport?.thresholds || null,
   };
@@ -384,10 +384,6 @@ function buildHistorySnapshot({
   reliabilitySignals,
   securityIndicators,
 }) {
-  const staleWatchlistCount = Array.isArray(benchmarkIntelligenceReport?.watchlist)
-    ? benchmarkIntelligenceReport.watchlist.filter((watchlistEntry) => watchlistEntry?.stale === true).length
-    : null;
-
   return {
     generatedAt,
     releaseVersion,
@@ -396,7 +392,7 @@ function buildHistorySnapshot({
     manualCorrectionRate: toFiniteNumber(detectionBenchmarkReport?.manualCorrectionRate, 0),
     benchmarkGatePassed: benchmarkGateReport?.passed === true,
     intelligencePassed: benchmarkIntelligenceReport?.passed === true,
-    staleWatchlistCount,
+    staticExternalWatchlistRetired: benchmarkIntelligenceReport?.staticExternalWatchlistRetired === true,
     reliabilityPassed: reliabilitySignals.passed,
     reliabilityRiskLevel: reliabilitySignals.riskLevel,
     incorrectDetectionRate: reliabilitySignals.metrics.incorrectDetectionRate,
@@ -419,8 +415,6 @@ function buildReleaseDelta(historyEntries, currentSnapshot) {
 
   const top1AccuracyDelta = Number((currentSnapshot.top1Accuracy - previousReleaseSnapshot.top1Accuracy).toFixed(4));
   const manualCorrectionDelta = Number((currentSnapshot.manualCorrectionRate - previousReleaseSnapshot.manualCorrectionRate).toFixed(4));
-  const staleWatchlistDelta =
-    (toFiniteNumber(currentSnapshot.staleWatchlistCount, 0) - toFiniteNumber(previousReleaseSnapshot.staleWatchlistCount, 0));
   const vulnerabilityDelta =
     (toFiniteNumber(currentSnapshot.vulnerabilityTotal, 0) - toFiniteNumber(previousReleaseSnapshot.vulnerabilityTotal, 0));
 
@@ -433,12 +427,10 @@ function buildReleaseDelta(historyEntries, currentSnapshot) {
     },
     top1AccuracyDelta,
     manualCorrectionRateDelta: manualCorrectionDelta,
-    staleWatchlistCountDelta: staleWatchlistDelta,
     vulnerabilityTotalDelta: vulnerabilityDelta,
     summary: [
       `top1Accuracy: ${top1AccuracyDelta >= 0 ? '+' : ''}${top1AccuracyDelta}`,
       `manualCorrectionRate: ${manualCorrectionDelta >= 0 ? '+' : ''}${manualCorrectionDelta}`,
-      `staleWatchlistCount: ${staleWatchlistDelta >= 0 ? '+' : ''}${staleWatchlistDelta}`,
       `vulnerabilityTotal: ${vulnerabilityDelta >= 0 ? '+' : ''}${vulnerabilityDelta}`,
     ],
   };
@@ -453,7 +445,7 @@ function buildTrendTable(historyEntries) {
     manualCorrectionRate: historyEntry.manualCorrectionRate,
     incorrectDetectionRate: historyEntry.incorrectDetectionRate,
     lowConfidenceRate: historyEntry.lowConfidenceRate,
-    staleWatchlistCount: historyEntry.staleWatchlistCount,
+    staticExternalWatchlistRetired: historyEntry.staticExternalWatchlistRetired === true,
     vulnerabilityTotal: historyEntry.vulnerabilityTotal,
     criticalVulnerabilityCount: historyEntry.criticalVulnerabilityCount,
     benchmarkGatePassed: historyEntry.benchmarkGatePassed,
@@ -470,7 +462,7 @@ function buildChartSeries(historyEntries) {
     manualCorrectionRate: historyEntries.map((historyEntry) => historyEntry.manualCorrectionRate),
     incorrectDetectionRate: historyEntries.map((historyEntry) => historyEntry.incorrectDetectionRate),
     lowConfidenceRate: historyEntries.map((historyEntry) => historyEntry.lowConfidenceRate),
-    staleWatchlistCount: historyEntries.map((historyEntry) => historyEntry.staleWatchlistCount),
+    staticExternalWatchlistRetired: historyEntries.map((historyEntry) => historyEntry.staticExternalWatchlistRetired === true),
     vulnerabilityTotal: historyEntries.map((historyEntry) => historyEntry.vulnerabilityTotal),
   };
 }
@@ -503,7 +495,6 @@ function convertTrendTableToCsv(trendTable) {
 async function runBenchmarkEvidenceBundle() {
   const reproducibilityProfile = readJsonOrNull(REPRO_PROFILE_PATH);
   const thresholdConfiguration = readJsonOrNull(BENCHMARK_THRESHOLD_PATH);
-  const watchlistConfiguration = readJsonOrNull(BENCHMARK_WATCHLIST_PATH);
   const memorySchemaConfiguration = readJsonOrNull(MEMORY_SCHEMA_PATH);
   const memoryAdapterContractConfiguration = readJsonOrNull(MEMORY_ADAPTER_CONTRACT_PATH);
   const releaseVersion = readReleaseVersion();
@@ -611,9 +602,10 @@ async function runBenchmarkEvidenceBundle() {
     rawInputs: {
       scenarios: Array.isArray(reproducibilityProfile?.scenarios) ? reproducibilityProfile.scenarios : [],
       benchmarkThresholds: thresholdConfiguration,
-      benchmarkWatchlist: Array.isArray(watchlistConfiguration?.repositories)
-        ? watchlistConfiguration.repositories
-        : [],
+      benchmarkWatchlist: {
+        retired: true,
+        reason: 'Static external benchmark watchlists were removed to avoid stale or biasing research inputs.',
+      },
       memorySchema: memorySchemaConfiguration,
       memoryAdapterContract: memoryAdapterContractConfiguration,
     },

package/scripts/benchmark-intelligence.mjs

@@ -3,133 +3,26 @@
 /**
  * benchmark-intelligence.mjs
  *
- * Competitive intelligence cadence validator.
- * Ensures benchmark watchlist coverage and review freshness.
+ * Benchmark intelligence compatibility report.
+ * Static external watchlists were retired to avoid stale or biasing research inputs.
  */
 
-import { existsSync, readFileSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const SCRIPT_FILE_PATH = fileURLToPath(import.meta.url);
-const SCRIPT_DIR = dirname(SCRIPT_FILE_PATH);
-const REPOSITORY_ROOT = resolve(SCRIPT_DIR, '..');
-const WATCHLIST_PATH = join(REPOSITORY_ROOT, '.agent-context', 'state', 'benchmark-watchlist.json');
-const REVIEW_SLA_DAYS = 14;
-const REQUIRED_BENCHMARK_REPOSITORIES = new Set([
-  'sickn33/antigravity-awesome-skills',
-  'github/awesome-copilot',
-  'MiniMax-AI/skills',
-]);
-
-function parseDateOrNull(rawDateValue) {
-  if (typeof rawDateValue !== 'string') {
-    return null;
-  }
-
-  if (!/^\d{4}-\d{2}-\d{2}$/.test(rawDateValue)) {
-    return null;
-  }
-
-  const parsedDate = new Date(`${rawDateValue}T00:00:00.000Z`);
-  return Number.isNaN(parsedDate.getTime()) ? null : parsedDate;
-}
-
-function calculateAgeInDays(referenceDate, targetDate) {
-  const ageInMilliseconds = referenceDate.getTime() - targetDate.getTime();
-  return Math.floor(ageInMilliseconds / (1000 * 60 * 60 * 24));
-}
-
-function loadWatchlistConfiguration() {
-  if (!existsSync(WATCHLIST_PATH)) {
-    return { repositories: [] };
-  }
-
-  return JSON.parse(readFileSync(WATCHLIST_PATH, 'utf8'));
-}
-
 function runIntelligenceValidation() {
-  const watchlistConfiguration = loadWatchlistConfiguration();
-  const watchlistEntries = Array.isArray(watchlistConfiguration.repositories)
-    ? watchlistConfiguration.repositories
-    : [];
-  const validationResults = [];
-  const currentDate = new Date();
-
-  const trackedRepositoryNames = new Set();
-  for (const watchlistEntry of watchlistEntries) {
-    trackedRepositoryNames.add(watchlistEntry.repository);
-  }
-
-  for (const requiredRepositoryName of REQUIRED_BENCHMARK_REPOSITORIES) {
-    const hasRequiredRepository = trackedRepositoryNames.has(requiredRepositoryName);
-    validationResults.push({
-      checkName: 'required-benchmark-repository',
-      repository: requiredRepositoryName,
-      passed: hasRequiredRepository,
-      details: hasRequiredRepository
-        ? `${requiredRepositoryName} is present in watchlist`
-        : `${requiredRepositoryName} is missing from watchlist`,
-    });
-  }
-
-  const watchlistReport = watchlistEntries.map((watchlistEntry) => {
-    const repositoryName = watchlistEntry.repository;
-    const repositoryOwner = watchlistEntry.owner;
-    const lastReviewedDate = parseDateOrNull(watchlistEntry.lastReviewedAt);
-
-    const hasOwner = typeof repositoryOwner === 'string' && repositoryOwner.trim().length > 0;
-    validationResults.push({
-      checkName: 'watchlist-owner-defined',
-      repository: repositoryName,
-      passed: hasOwner,
-      details: hasOwner ? `Owner ${repositoryOwner} is defined` : 'Owner is missing',
-    });
-
-    if (!lastReviewedDate) {
-      validationResults.push({
-        checkName: 'review-date-format',
-        repository: repositoryName,
-        passed: false,
-        details: `Invalid or missing lastReviewedAt: ${String(watchlistEntry.lastReviewedAt)}`,
-      });
-
-      return {
-        repository: repositoryName,
-        owner: repositoryOwner,
-        lastReviewedAt: watchlistEntry.lastReviewedAt,
-        ageInDays: null,
-        stale: true,
-      };
-    }
-
-    const reviewAgeInDays = calculateAgeInDays(currentDate, lastReviewedDate);
-    const reviewWithinSla = reviewAgeInDays <= REVIEW_SLA_DAYS;
-
-    validationResults.push({
-      checkName: 'review-sla-compliance',
-      repository: repositoryName,
-      passed: reviewWithinSla,
-      details: `ageInDays=${reviewAgeInDays} slaDays=${REVIEW_SLA_DAYS}`,
-    });
-
-    return {
-      repository: repositoryName,
-      owner: repositoryOwner,
-      lastReviewedAt: watchlistEntry.lastReviewedAt,
-      ageInDays: reviewAgeInDays,
-      stale: !reviewWithinSla,
-    };
-  });
-
-  const failedCheckCount = validationResults.filter((validationResult) => !validationResult.passed).length;
+  const validationResults = [
+    {
+      checkName: 'static-external-watchlist-retired',
+      passed: true,
+      details: 'Static external benchmark watchlists are retired; use live official docs and repo evidence for current claims.',
+    },
+  ];
   const intelligenceReport = {
     generatedAt: new Date().toISOString(),
     reportName: 'benchmark-intelligence',
-    passed: failedCheckCount === 0,
-    failureCount: failedCheckCount,
-    reviewSlaDays: REVIEW_SLA_DAYS,
-    watchlist: watchlistReport,
+    passed: true,
+    failureCount: 0,
+    reviewSlaDays: null,
+    staticExternalWatchlistRetired: true,
+    watchlist: [],
     results: validationResults,
   };
 

package/scripts/benchmark-writer-judge-matrix.mjs

@@ -152,10 +152,6 @@ function loadScenarios(reproducibilityProfile) {
 }
 
 function buildBaseSignals(detectionBenchmarkReport, tokenBenchmarkReport, benchmarkGateReport, benchmarkIntelligenceReport, thresholdConfiguration) {
-  const staleWatchlistCount = Array.isArray(benchmarkIntelligenceReport?.watchlist)
-    ? benchmarkIntelligenceReport.watchlist.filter((watchlistEntry) => watchlistEntry?.stale === true).length
-    : 0;
-
   const top1Accuracy = Number(detectionBenchmarkReport?.top1Accuracy || 0);
   const manualCorrectionRate = Number(detectionBenchmarkReport?.manualCorrectionRate || 1);
 
@@ -166,7 +162,7 @@ function buildBaseSignals(detectionBenchmarkReport, tokenBenchmarkReport, benchm
     benchmarkGatePassed: benchmarkGateReport?.passed === true,
     benchmarkGateFailureCount: Number(benchmarkGateReport?.failureCount || 0),
     intelligenceFailureCount: Number(benchmarkIntelligenceReport?.failureCount || 0),
-    staleWatchlistCount,
+    staticExternalWatchlistRetired: benchmarkIntelligenceReport?.staticExternalWatchlistRetired === true,
     top1AccuracyMet: top1Accuracy >= Number(thresholdConfiguration?.minimumTop1Accuracy || 0),
     manualCorrectionMet: manualCorrectionRate <= Number(thresholdConfiguration?.maximumManualCorrectionRate || 1),
   };
@@ -182,7 +178,7 @@ function buildWriterScenarioRun(writerModel, scenario, baseSignals, writerWeight
     ? clamp(100 + deterministicOffset(`${writerModel.id}:reliability`, 2), 0, 100)
     : clamp(100 - (baseSignals.benchmarkGateFailureCount * 20), 0, 100);
   const freshnessScore = clamp(
-    100 - (baseSignals.intelligenceFailureCount * 15) - (baseSignals.staleWatchlistCount * 10) + deterministicOffset(`${writerModel.id}:freshness`, 2),
+    100 - (baseSignals.intelligenceFailureCount * 15) + deterministicOffset(`${writerModel.id}:freshness`, 2),
     0,
     100
   );

package/scripts/bump-version.mjs

@@ -62,16 +62,31 @@ async function bumpVersion() {
     console.log('Updated package-lock.json');
   }
 
-  // 3. Update docs/deep_analysis_and_roadmap_backlog.md
-  const roadmapPath = path.join(ROOT_DIR, 'docs', 'deep_analysis_and_roadmap_backlog.md');
+  // 3. Update docs/deep-analysis-and-roadmap-backlog.md
+  const roadmapPath = path.join(ROOT_DIR, 'docs', 'deep-analysis-and-roadmap-backlog.md');
   if (await fileExists(roadmapPath)) {
     let roadmapContent = await readTextFile(roadmapPath);
     roadmapContent = roadmapContent.replace(`Current Version: ${oldVersion}`, `Current Version: ${newVersion}`);
     await writeTextFile(roadmapPath, roadmapContent);
-    console.log('Updated docs/deep_analysis_and_roadmap_backlog.md');
+    console.log('Updated docs/deep-analysis-and-roadmap-backlog.md');
   }
 
-  // 4. Update CHANGELOG.md
+  // 4. Update legacy root adapters that carry release metadata.
+  const legacyAdapterFiles = ['.cursorrules', '.windsurfrules'];
+  for (const legacyAdapterFile of legacyAdapterFiles) {
+    const legacyAdapterPath = path.join(ROOT_DIR, legacyAdapterFile);
+    if (await fileExists(legacyAdapterPath)) {
+      const legacyAdapterContent = await readTextFile(legacyAdapterPath);
+      const updatedLegacyAdapterContent = legacyAdapterContent.replace(
+        /Generated by Agentic-Senior-Core CLI v\d+\.\d+\.\d+/,
+        `Generated by Agentic-Senior-Core CLI v${newVersion}`
+      );
+      await writeTextFile(legacyAdapterPath, updatedLegacyAdapterContent);
+      console.log(`Updated ${legacyAdapterFile}`);
+    }
+  }
+
+  // 5. Update CHANGELOG.md
   const changelogPath = path.join(ROOT_DIR, 'CHANGELOG.md');
   if (await fileExists(changelogPath)) {
     let changelogContent = await readTextFile(changelogPath);

package/scripts/clean-local-artifacts.mjs

@@ -12,6 +12,7 @@ const LOCAL_ARTIFACT_PATHS = [
   'validate_output.txt',
   'release-gate-report.json',
   '.benchmarks',
+  '.zed',
   '.agentic-backup',
   '.agent-context/state/active-memory.json',
   '.agent-context/state/v3-purge-audit.json',

package/scripts/docs-quality-drift-report.mjs

@@ -33,7 +33,7 @@ const MONITORED_STATIC_FILE_PATHS = [
   '.gemini/instructions.md',
   '.cursor/rules/agentic-senior-core.mdc',
   '.windsurf/rules/agentic-senior-core.md',
-  'docs/deep_analysis_and_roadmap_backlog.md',
+  'docs/deep-analysis-and-roadmap-backlog.md',
 ];
 
 const MONITORED_DIRECTORY_PATHS = [

package/scripts/frontend-usability-audit.mjs

@@ -3,9 +3,9 @@
 /**
  * frontend-usability-audit.mjs
  *
- * Governance-level audit for V1.7 frontend execution assets.
+ * Governance-level audit for current frontend governance assets.
  * This repository does not host a frontend runtime app, so the audit validates
- * required execution artifacts and quality gates documentation.
+ * required quality gates and archived execution evidence.
  */
 
 import { existsSync, readFileSync } from 'node:fs';
@@ -18,8 +18,8 @@ const REPOSITORY_ROOT = resolve(__dirname, '..');
 
 const REQUIRED_FILES = [
   'docs/roadmap.md',
-  'docs/v1.7-issue-breakdown.md',
-  'docs/v1.7-execution-playbook.md',
+  'docs/archive/v1.7-issue-breakdown.md',
+  'docs/archive/v1.7-execution-playbook.md',
   '.instructions.md',
   '.agent-context/prompts/bootstrap-design.md',
   'scripts/ui-design-judge.mjs',

package/scripts/mcp-server/constants.mjs

@@ -15,6 +15,10 @@ export const DEFAULT_TREND_WINDOW_DAYS = 90;
 export const MAX_TREND_PACKAGES = 10;
 export const FALLBACK_PACKAGE_VERSION = '0.0.0-local';
 
+// IMPORTANT: This version extraction logic is intentionally duplicated from lib/cli/constants.mjs.
+// The MCP server is designed to be copied directly into target user workspaces where
+// the original package.json may not exist in the parent tree. This try/catch fallback
+// ensures the server can still run standalone without crashing if package.json is missing.
 function resolvePackageVersion() {
   try {
     const parsedPackageManifest = JSON.parse(

package/scripts/release-gate/static-checks.mjs

@@ -100,7 +100,6 @@ export function runStaticReleaseChecks(results, diagnostics) {
 
   const requiredOperationsFiles = [
     '.agent-context/review-checklists/architecture-review.md',
-    'docs/v1.8-operations-playbook.md',
     '.github/workflows/release-gate.yml',
     '.github/workflows/sbom-compliance.yml',
     '.github/workflows/governance-weekly-report.yml',

package/scripts/validate/config.mjs

@@ -14,7 +14,7 @@ export const FORMAL_ARTIFACT_PATHS = [
   '.instructions.md',
   'README.md',
   'CHANGELOG.md',
-  'docs/deep_analysis_and_roadmap_backlog.md',
+  'docs/deep-analysis-and-roadmap-backlog.md',
   '.agent-context/rules/api-docs.md',
   '.agent-context/review-checklists/pr-checklist.md',
   '.agent-context/prompts/review-code.md',
@@ -49,7 +49,7 @@ export const REQUIRED_HUMAN_WRITING_SNIPPETS = [
     ],
   },
   {
-    path: 'docs/deep_analysis_and_roadmap_backlog.md',
+    path: 'docs/deep-analysis-and-roadmap-backlog.md',
     snippets: [
       '## Part 6: Documentation and Explanation Standards (Mandatory)',
       'This applies to documentation, release notes, onboarding text, review summaries, and agent-facing explanations.',

package/scripts/validate.mjs

@@ -166,14 +166,12 @@ async function validateRequiredFiles() {
     'docs/faq.md',
     'docs/deep-dive.md',
     'docs/terminology-mapping.md',
-    'docs/v1.7-execution-playbook.md',
-    'docs/v1.7-issue-breakdown.md',
-    'docs/v1.8-operations-playbook.md',
-    'docs/v2-upgrade-playbook.md',
+    'docs/archive/v1.7-execution-playbook.md',
+    'docs/archive/v1.7-issue-breakdown.md',
+    'docs/archive/v1.8-operations-playbook.md',
+    'docs/archive/v2-upgrade-playbook.md',
     '.agent-context/state/benchmark-reproducibility.json',
     '.agent-context/state/benchmark-writer-judge-config.json',
-    '.agent-context/state/benchmark-watchlist.json',
-    '.agent-context/state/stack-research-snapshot.json',
     '.agent-context/state/memory-schema-v1.json',
     '.agent-context/state/memory-adapter-contract.json',
     '.vscode/mcp.json',
@@ -569,7 +567,7 @@ async function validateDocumentationFlow() {
     'npm run validate',
     'docs/faq.md',
     'docs/deep-dive.md',
-    'docs/v2-upgrade-playbook.md',
+    'docs/archive/v2-upgrade-playbook.md',
   ];
 
   for (const requiredReadmeSnippet of requiredReadmeSnippets) {
@@ -581,90 +579,17 @@ async function validateDocumentationFlow() {
   }
 }
 
-function isNormalizedMetricValue(value) {
-  return Number.isFinite(Number(value)) && Number(value) >= 0 && Number(value) <= 1;
-}
-
-async function validateStackResearchSnapshotState() {
-  console.log('\nChecking deterministic stack research snapshot state...');
-
-  const snapshotPath = join(ROOT_DIR, '.agent-context', 'state', 'stack-research-snapshot.json');
-  if (!(await fileExists(snapshotPath))) {
-    fail('Missing deterministic stack research snapshot: .agent-context/state/stack-research-snapshot.json');
-    return;
-  }
-
-  let snapshotPayload;
-  try {
-    snapshotPayload = JSON.parse(await readTextFile(snapshotPath));
-  } catch {
-    fail('Invalid JSON in .agent-context/state/stack-research-snapshot.json');
-    return;
-  }
-
-  if (snapshotPayload?.deterministic === true) {
-    pass('stack-research-snapshot.json declares deterministic: true');
-  } else {
-    fail('stack-research-snapshot.json must declare deterministic: true');
-  }
-
-  const generatedAtValue = String(snapshotPayload?.generatedAt || '');
-  if (!Number.isNaN(Date.parse(generatedAtValue))) {
-    pass('stack-research-snapshot.json includes valid generatedAt timestamp');
-  } else {
-    fail('stack-research-snapshot.json must include a valid generatedAt timestamp');
-  }
-
-  if (Array.isArray(snapshotPayload?.trustedRealtimeSources) && snapshotPayload.trustedRealtimeSources.length > 0) {
-    pass('stack-research-snapshot.json includes trustedRealtimeSources');
-  } else {
-    fail('stack-research-snapshot.json must include at least one trustedRealtimeSources entry');
-  }
-
-  if (!Array.isArray(snapshotPayload?.stackSignals) || snapshotPayload.stackSignals.length === 0) {
-    fail('stack-research-snapshot.json must include non-empty stackSignals array');
-    return;
-  }
-
-  pass(`stack-research-snapshot.json includes ${snapshotPayload.stackSignals.length} stack signal entries`);
-
-  const invalidSignalEntries = snapshotPayload.stackSignals.filter((signalEntry) => {
-    const hasStackName = typeof signalEntry?.stackFileName === 'string' && signalEntry.stackFileName.trim().length > 0;
-    const hasMeasuredAt = !Number.isNaN(Date.parse(String(signalEntry?.measuredAt || '')));
-    const metrics = signalEntry?.metrics || {};
-    const hasValidMetrics = isNormalizedMetricValue(metrics.ecosystemMaturity)
-      && isNormalizedMetricValue(metrics.talentAvailability)
-      && isNormalizedMetricValue(metrics.deliveryVelocity);
-
-    return !(hasStackName && hasMeasuredAt && hasValidMetrics);
-  });
-
-  if (invalidSignalEntries.length === 0) {
-    pass('stack-research-snapshot.json stackSignals keep measurable metrics and timestamps');
-  } else {
-    fail(`stack-research-snapshot.json has invalid stackSignals entries: ${invalidSignalEntries.length}`);
-  }
-}
-
 async function validateMcpConfiguration() {
   console.log('\nChecking MCP configuration...');
 
   const mcpConfiguration = JSON.parse(await readTextFile(join(ROOT_DIR, 'mcp.json')));
-  const lintServerCommand = mcpConfiguration.servers?.lint?.command;
-  const testServerCommand = mcpConfiguration.servers?.test?.command;
   const workspaceMcpConfiguration = JSON.parse(await readTextFile(join(ROOT_DIR, '.vscode', 'mcp.json')));
   const workspaceServerConfig = workspaceMcpConfiguration.servers?.['agentic-senior-core'];
 
-  if (lintServerCommand === 'node') {
-    pass('MCP lint server uses Node');
-  } else {
-    fail('MCP lint server must use Node');
-  }
-
-  if (testServerCommand === 'node') {
-    pass('MCP test server uses Node');
+  if (mcpConfiguration.knowledgeLayers?.enabled === true) {
+    pass('Root MCP config has knowledgeLayers enabled');
   } else {
-    fail('MCP test server must use Node');
+    fail('Root MCP config must have knowledgeLayers.enabled: true');
   }
 
   if (typeof workspaceMcpConfiguration.$schema === 'undefined') {
@@ -732,7 +657,6 @@ async function main() {
   await validateDependencyFreshnessAutomationCoverage(coverageValidationContext);
   await validateDeterministicBoundaryEnforcementCoverage(coverageValidationContext);
   await validateRulesOnlyActiveSurfaceCoverage(coverageValidationContext);
-  await validateStackResearchSnapshotState();
   await validateMcpConfiguration();
   await validateHumanWritingGovernance(coverageValidationContext);
   await validateInstructionAdapters(coverageValidationContext);

package/.agent-context/state/benchmark-watchlist.json

@@ -1,19 +0,0 @@
-{
-  "repositories": [
-    {
-      "repository": "sickn33/antigravity-awesome-skills",
-      "owner": "core-architecture",
-      "lastReviewedAt": "2026-04-17"
-    },
-    {
-      "repository": "github/awesome-copilot",
-      "owner": "core-architecture",
-      "lastReviewedAt": "2026-04-17"
-    },
-    {
-      "repository": "MiniMax-AI/skills",
-      "owner": "frontend-governance",
-      "lastReviewedAt": "2026-04-17"
-    }
-  ]
-}

package/.agent-context/state/stack-research-snapshot.json

@@ -1,112 +0,0 @@
-{
-  "schemaVersion": "1.0.0",
-  "snapshotId": "ecosystem-signals-2026-04-18",
-  "generatedAt": "2026-04-18T00:00:00.000Z",
-  "deterministic": true,
-  "sourceName": "Agentic-Senior-Core deterministic stack research snapshot",
-  "sourceUrl": "state://stack-research-snapshot/2026-04-18",
-  "trustedRealtimeSources": [
-    {
-      "sourceId": "awwwards-trend-feed",
-      "sourceName": "Awwwards Trend Feed",
-      "sourceUrl": "https://www.awwwards.com"
-    },
-    {
-      "sourceId": "github-ecosystem-signals",
-      "sourceName": "GitHub Ecosystem Signals",
-      "sourceUrl": "https://github.com"
-    }
-  ],
-  "stackSignals": [
-    {
-      "stackFileName": "typescript.md",
-      "measuredAt": "2026-04-18T00:00:00.000Z",
-      "metrics": {
-        "ecosystemMaturity": 0.91,
-        "talentAvailability": 0.9,
-        "deliveryVelocity": 0.89
-      }
-    },
-    {
-      "stackFileName": "python.md",
-      "measuredAt": "2026-04-18T00:00:00.000Z",
-      "metrics": {
-        "ecosystemMaturity": 0.92,
-        "talentAvailability": 0.88,
-        "deliveryVelocity": 0.9
-      }
-    },
-    {
-      "stackFileName": "java.md",
-      "measuredAt": "2026-04-18T00:00:00.000Z",
-      "metrics": {
-        "ecosystemMaturity": 0.89,
-        "talentAvailability": 0.83,
-        "deliveryVelocity": 0.8
-      }
-    },
-    {
-      "stackFileName": "php.md",
-      "measuredAt": "2026-04-18T00:00:00.000Z",
-      "metrics": {
-        "ecosystemMaturity": 0.79,
-        "talentAvailability": 0.75,
-        "deliveryVelocity": 0.84
-      }
-    },
-    {
-      "stackFileName": "go.md",
-      "measuredAt": "2026-04-18T00:00:00.000Z",
-      "metrics": {
-        "ecosystemMaturity": 0.84,
-        "talentAvailability": 0.78,
-        "deliveryVelocity": 0.82
-      }
-    },
-    {
-      "stackFileName": "csharp.md",
-      "measuredAt": "2026-04-18T00:00:00.000Z",
-      "metrics": {
-        "ecosystemMaturity": 0.86,
-        "talentAvailability": 0.8,
-        "deliveryVelocity": 0.79
-      }
-    },
-    {
-      "stackFileName": "rust.md",
-      "measuredAt": "2026-04-18T00:00:00.000Z",
-      "metrics": {
-        "ecosystemMaturity": 0.74,
-        "talentAvailability": 0.63,
-        "deliveryVelocity": 0.67
-      }
-    },
-    {
-      "stackFileName": "ruby.md",
-      "measuredAt": "2026-04-18T00:00:00.000Z",
-      "metrics": {
-        "ecosystemMaturity": 0.7,
-        "talentAvailability": 0.62,
-        "deliveryVelocity": 0.72
-      }
-    },
-    {
-      "stackFileName": "react-native.md",
-      "measuredAt": "2026-04-18T00:00:00.000Z",
-      "metrics": {
-        "ecosystemMaturity": 0.72,
-        "talentAvailability": 0.67,
-        "deliveryVelocity": 0.74
-      }
-    },
-    {
-      "stackFileName": "flutter.md",
-      "measuredAt": "2026-04-18T00:00:00.000Z",
-      "metrics": {
-        "ecosystemMaturity": 0.75,
-        "talentAvailability": 0.69,
-        "deliveryVelocity": 0.76
-      }
-    }
-  ]
-}

package/.github/ISSUE_TEMPLATE/v1.7-frontend-work-item.yml

@@ -1,54 +0,0 @@
-name: V1.7 Frontend Work Item
-description: Track a V1.7 frontend task with quality-gate ready acceptance criteria.
-title: "[V1.7][QX] "
-labels:
-  - v1.7
-body:
-  - type: textarea
-    id: background
-    attributes:
-      label: Background
-      description: Why this item exists and what user problem it addresses.
-    validations:
-      required: true
-  - type: textarea
-    id: scope
-    attributes:
-      label: Scope
-      description: What is included in this issue.
-    validations:
-      required: true
-  - type: textarea
-    id: out_of_scope
-    attributes:
-      label: Out of Scope
-      description: What is intentionally excluded.
-    validations:
-      required: true
-  - type: textarea
-    id: acceptance_criteria
-    attributes:
-      label: Acceptance Criteria
-      description: Use measurable and testable criteria.
-      placeholder: |
-        - [ ] ...
-        - [ ] ...
-    validations:
-      required: true
-  - type: textarea
-    id: dependencies
-    attributes:
-      label: Dependencies
-      description: Link prerequisite issues or blockers.
-  - type: textarea
-    id: definition_of_done
-    attributes:
-      label: Definition of Done
-      description: Include testing, documentation, and evidence requirements.
-    validations:
-      required: true
-  - type: textarea
-    id: evidence
-    attributes:
-      label: Evidence
-      description: Screenshots, benchmark output, links to reports.