@ryuenn3123/agentic-senior-core 4.0.0 → 4.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "4.0.0",
+  "version": "4.0.2",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {
@@ -83,7 +83,7 @@
     "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 ./tests/knowledge-injection.test.mjs ./tests/migrate-rule-format.test.mjs ./tests/audit-caching-scope-hygiene.test.mjs ./benchmarks/token-usage/lib/token-counter.test.mjs ./benchmarks/token-usage/lib/provider-cache-matrix.test.mjs ./benchmarks/token-usage/lib/cache-layer-contract.test.mjs ./benchmarks/token-usage/lib/cache-economics.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 ./tests/migrate-rule-format.test.mjs ./tests/audit-caching-scope-hygiene.test.mjs ./tests/research-dossier-migration.test.mjs ./benchmarks/token-usage/lib/token-counter.test.mjs ./benchmarks/token-usage/lib/provider-cache-matrix.test.mjs ./benchmarks/token-usage/lib/cache-layer-contract.test.mjs ./benchmarks/token-usage/lib/cache-economics.test.mjs"
   },
   "devDependencies": {
     "@anthropic-ai/sdk": "^0.96.0",

package/scripts/audit-caching-scope-hygiene.mjs

@@ -6,7 +6,7 @@
  *
  * Phase 5 drift catcher. Scans user-facing surfaces (README, AGENTS.md, FAQ,
  * integration playbook, CHANGELOG) for caching numerical claims and verifies
- * that each claim is integration-scoped per `docs/plan/research-foundation.md`
+ * that each claim is integration-scoped per `docs/architecture/decisions-foundation.md`
  * D4 "Per-Tool Caching Scope Matrix".
  *
  * The rule: never publish a single universal "X% caching saving" figure that
@@ -16,8 +16,8 @@
  *      (direct API, Claude Code SDK programmatic, Cursor, Windsurf, Codex CLI,
  *      Kiro, IDE wrapper) within +/- 600 characters of the figure, OR
  *   2. live in a documented exempt context (Phase 1 aggregate-cap CHANGELOG
- *      rationale, plan files under docs/plan/, benchmark JSON under
- *      benchmarks/results/, the canonical D4 matrix itself).
+ *      rationale, archived plan files under docs/archive/, benchmark JSON
+ *      under benchmarks/results/, the canonical D4 matrix itself).
  */
 
 import { existsSync, readFileSync } from 'node:fs';
@@ -200,7 +200,7 @@ export function runCachingScopeHygieneAudit(options = {}) {
           file: surfacePath,
           line: lineNumber,
           kind: 'caching-claim.missing-integration-scope',
-          detail: `Caching saving claim "${claim.matchedText.trim()}" lacks an integration-mode marker within +/- ${CONTEXT_WINDOW_RADIUS} chars. Add a per-tool / direct-API / IDE-wrapper label, or move the figure under a clearly-scoped paragraph. Source of truth: docs/plan/research-foundation.md D4.`,
+          detail: `Caching saving claim "${claim.matchedText.trim()}" lacks an integration-mode marker within +/- ${CONTEXT_WINDOW_RADIUS} chars. Add a per-tool / direct-API / IDE-wrapper label, or move the figure under a clearly-scoped paragraph. Source of truth: docs/architecture/decisions-foundation.md D4.`,
         });
       }
     }

package/scripts/build-release-benchmark-bundle.mjs

@@ -31,7 +31,7 @@ const SOURCE_ARTIFACTS = [
     artifactId: 'phase-2-cache',
     relativePath: 'benchmarks/results/cache-phase-2-2026-05-16.json',
     role: 'cache-simulation',
-    description: 'Phase 2 offline warm-cache simulation. Direct provider API integration mode; see docs/plan/research-foundation.md D4 for the per-tool scope matrix.',
+    description: 'Phase 2 offline warm-cache simulation. Direct provider API integration mode; see docs/architecture/decisions-foundation.md D4 for the per-tool scope matrix.',
   },
   {
     artifactId: 'phase-3-anti-halu',
@@ -145,12 +145,12 @@ export function buildReleaseBenchmarkBundle(options = {}) {
     generated_at: new Date().toISOString(),
     description: 'Phase 5 release benchmark bundle. References Phase 0-3 locked artifacts plus the Phase 5 supply-chain snapshot. No artifact is regenerated by this bundle. Artifact integrity is verified by SHA-256 hash via scripts/audit-release-bundle.mjs.',
     sources: {
-      research_foundation: 'docs/plan/research-foundation.md',
-      d4_caching_scope_matrix: 'docs/plan/research-foundation.md#d4',
+      research_foundation: 'docs/architecture/decisions-foundation.md',
+      d4_caching_scope_matrix: 'docs/architecture/decisions-foundation.md#d4',
       caching_reporting_format: 'docs/benchmark-reference.md',
-      phase_2_outcome: 'docs/plan/phase-2-outcome.md',
-      phase_3_outcome: 'docs/plan/phase-3-outcome.md',
-      phase_5_plan: 'docs/plan/phase-5-hardening.md',
+      phase_2_outcome: 'docs/archive/phase-2-outcome.md',
+      phase_3_outcome: 'docs/archive/phase-3-outcome.md',
+      phase_5_plan: 'docs/archive/phase-5-hardening.md',
     },
     integrity: {
       hash_algorithm: 'SHA-256',

package/scripts/documentation-boundary-audit.mjs

@@ -74,6 +74,19 @@ const BOUNDARY_RULES = [
       'README.md',
     ],
     trigger(filePath) {
+      // Path-based exclusion: design-contract JSON shape lives under
+      // lib/cli/project-scaffolder/. Files like research-dossier-migration.mjs
+      // describe agent-prompt JSON contract migrations, not database schema
+      // or persistent-store migrations, so they must not trigger this boundary
+      // even when the filename contains the words "schema" or "migration".
+      // Tests for those design-contract migrations are excluded for the same
+      // reason.
+      if (filePath.startsWith('lib/cli/project-scaffolder/')) {
+        return false;
+      }
+      if (filePath.startsWith('tests/') && /research-dossier|design-contract/i.test(filePath)) {
+        return false;
+      }
       return !isDocumentationFilePath(filePath)
         && /(database|schema|migration|repository|sql|prisma|typeorm|knex)/i.test(filePath);
     },

package/scripts/migrate-rule-format/id-prefix-table.mjs

@@ -1,7 +1,7 @@
 // @ts-check
 
 /**
- * Locked ID prefix table per `docs/plan/format-spec.md` section 3.
+ * Locked ID prefix table per `docs/architecture/format-spec.md` section 3.
  * The migration helper reads this map to assign frontmatter and section IDs.
  * Lock new entries here when adding a new rule file; never invent prefixes inline.
  */

package/scripts/migrate-rule-format/render-new.mjs

@@ -2,7 +2,7 @@
 
 /**
  * Renders a parsed legacy rule file plus a prefix-table entry into the v4
- * canonical format defined in `docs/plan/format-spec.md`.
+ * canonical format defined in `docs/architecture/format-spec.md`.
  *
  * Section IDs auto-assign sequentially starting at 001. The renderer never
  * skips integers; humans introduce gaps manually during review by editing

package/scripts/migrate-rule-format.mjs

@@ -5,7 +5,7 @@
  * scripts/migrate-rule-format.mjs
  *
  * Phase 1 Task 1.2 migration helper. Converts a legacy v3 rule file into the
- * canonical v4 format defined in docs/plan/format-spec.md. Output is written
+ * canonical v4 format defined in docs/architecture/format-spec.md. Output is written
  * to a `.candidate.md` sibling so the human migrator can review the diff
  * before replacing the original.
  *

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

@@ -79,7 +79,12 @@ export function runStaticReleaseChecks(results, diagnostics) {
         stackFileName: 'agent-decision-runtime.md',
         blueprintFileName: 'agent-decision-architecture.md',
       },
-      status: 'release-gate-seed-validation',
+      // Seed status so `tokenContinuityClassification: pending-research`
+      // is a valid placeholder. This probe asserts seed-shape completeness,
+      // not active-contract behavior; an agent or user fills the contract
+      // with anchor-derived / continuity-retained / newly-introduced once
+      // the dossier is filled.
+      status: 'seed-needs-design-synthesis',
     }));
     const designContractIssues = validateDesignContractCompleteness(designIntentSeed);
 

package/scripts/validate/config.mjs

@@ -301,6 +301,12 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'Motion/Palette Decision',
       'product categories are heuristics',
       'perform live web research',
+      'research-design.md',
+      'researchDossier.metadata',
+      'researchVerifiedAt',
+      'freshnessWindowDays',
+      'Anti-repeat ledger',
+      'user-explicit redesign',
     ],
   },
   {
@@ -352,6 +358,31 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'A new dependency, package count, or vague performance concern is not a blocker by itself.',
       'default component-kit styling without product rationale',
       'genericity findings that cannot name the exact drift signal',
+      'research-design.md',
+      'Section 3-5 gates from `research-design.md`',
+    ],
+  },
+  {
+    path: '.agent-context/prompts/research-design.md',
+    snippets: [
+      '# Research-Design Brief',
+      '## Section 3 — Category Code Identification',
+      '## Section 4 — Morphological Exploration',
+      '## Section 5 — Anchor Candidates',
+      'specificity self-test',
+      'uncomfortable combination',
+      'STRONG PASS',
+      'DISCARD',
+      'Anti-Repeat Ledger Gate',
+      'previousAnchors',
+      'previousMotionSignatures',
+      'Dimensional split',
+      'typographyClusters',
+      'paletteClusters',
+      'layoutClusters',
+      'motionClusters',
+      'imageryClusters',
+      'tokenContinuityClassification',
     ],
   },
   {

package/scripts/validate.mjs

@@ -158,6 +158,7 @@ async function validateRequiredFiles() {
     'scripts/release-gate.mjs',
     'scripts/generate-sbom.mjs',
     '.agent-context/policies/llm-judge-threshold.json',
+    '.agent-context/prompts/research-design.md',
     'mcp.json',
     'AGENTS.md',
     'CLAUDE.md',