@ryuenn3123/agentic-senior-core 3.0.39 → 3.0.40

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/.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.40
 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.40
 Adapter Mode: legacy-thin
 Adapter Source: .agent-instructions.md when present; fallback .instructions.md
 Canonical baseline: .instructions.md

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>
 

package/package.json

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

package/scripts/bump-version.mjs

@@ -71,7 +71,22 @@ async function bumpVersion() {
     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);