@ryuenn3123/agentic-senior-core 3.0.31 → 3.0.32

package/.agent-context/prompts/bootstrap-design.md

@@ -100,6 +100,7 @@ Do:
 - Synthesize a visual direction from the project context and explain why it fits.
 - Choose color, typography, spacing, motion, density, and component morphology dynamically from the product and audience.
 - Use modern, expressive interaction and motion as part of the core design language, especially when it improves hierarchy, feedback, delight, confidence, or memorability.
+- Use 3D or spatial/canvas experiences as primary UI only when they improve product understanding or exploration while preserving navigation, content clarity, user actions, performance, accessibility, and non-3D fallbacks.
 - Keep frontend code clean, componentized, accessible, and easy to maintain.
 - Use tokens and semantic aliases so future changes do not require rewriting components.
 - Make design decisions explicit before coding, then implement consistently.
@@ -110,6 +111,7 @@ Do not:
 - Let heading, body, data, and metadata collapse into one safe typographic treatment without rationale.
 - Reuse colors, layout shapes, or motion signatures from unrelated memory.
 - Add decorative animation that hurts clarity, accessibility, or runtime performance.
+- Let 3D visuals hide navigation, replace readable content, block core actions, or require a powerful device before the product can be understood.
 - Choose a dependency because this repo scaffold mentioned it. The LLM must verify fit from current project context and official docs.
 
 ## Responsive Rule

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

@@ -5,6 +5,7 @@ Run this before declaring a task done. Apply only the sections relevant to the c
 ## 1. Repo Context
 
 - [ ] The agent read `AGENTS.md` and the smallest relevant rule set.
+- [ ] For non-trivial coding, review, planning, or governance work, the agent produced a Bootstrap Receipt with loaded files, selected rules, skipped rules, unreachable files, and validation plan before implementation output.
 - [ ] Existing project context came from real files, docs, package metadata, and changed code, not folder name alone.
 - [ ] Runtime, framework, library, topology, and design choices are explicit user constraints or agent recommendations from current evidence.
 - [ ] No offline default stack, blueprint, vendor, or visual style was treated as authoritative.

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

@@ -69,6 +69,14 @@ Do not use this file to teach generic frontend basics the model already knows.
 - If live research is unavailable, mark `libraryResearchStatus` as `pending-verification`, record the library as `LIBRARY_TO_VERIFY`, and use native CSS, browser APIs, or already-present project dependencies until verification is possible.
 - Each `libraryDecisions[]` entry must have either verification metadata or a concrete `fallbackIfUnavailable`.
 
+## Spatial and 3D Experience Boundary
+
+- 3D, WebGL, canvas, and immersive spatial interfaces are allowed as the primary experience when they clarify the product, strengthen the chosen anchor, or make exploration meaningfully better than a flat UI.
+- 3D must not take over the jobs of navigation, content comprehension, or decisive user actions. Core routes, text, forms, and calls to action must remain discoverable, accessible, and usable without solving the scene.
+- Treat 3D as interaction architecture, not decoration. If it is only a modern-looking background or visual stunt, reduce it to a supporting accent or remove it.
+- Define performance and accessibility fallbacks before implementation: reduced motion, keyboard reachable controls, readable non-canvas content, mobile budgets, loading states, and a graceful non-3D path when rendering fails.
+- When 3D is central, document its product role, interaction model, fallback path, and library/runtime decision in `docs/DESIGN.md` and `docs/design-intent.json` before coding.
+
 ## Responsive Mutation Requirements
 
 - Responsive quality is not allowed to be scale-only. At least one surface must materially change position, grouping, priority, or disclosure strategy between mobile and desktop.

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

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-26T02:26:19.926Z",
+  "generatedAt": "2026-04-26T15:47:19.183Z",
   "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.31
+Generated by Agentic-Senior-Core CLI v3.0.32
 Timestamp: 2026-04-24T06:02:48.303Z
 Selected policy file: .agent-context/policies/llm-judge-threshold.json
 

package/.gemini/instructions.md

@@ -2,7 +2,7 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: c2aef70028abc43f5e3f110a2fa90086cd6697bac42ec97a8d4db3c4477880d4
+Canonical Snapshot SHA256: 58ca52e08f9503f55d49dfc64f800bb1124774251db4614478dbdfa618834445
 
 Canonical policy source: [.instructions.md](../.instructions.md).
 
@@ -23,6 +23,10 @@ If your host stops at this file, follow this minimum floor:
 6. Apply state awareness from [.agent-context/state/](../.agent-context/state) and policy thresholds from [.agent-context/policies/](../.agent-context/policies).
 7. Resolve runtime, structure, and dependency choices from project context docs plus live evidence.
 
+## Bootstrap Receipt
+
+For non-trivial coding, review, planning, or governance work, produce a short Bootstrap Receipt before implementation output: `loaded_files`, `selected_rules`, `skipped_rules`, `unreachable_files`, and `validation_plan`.
+
 ## Completion Gate
 
 Run [.agent-context/review-checklists/pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring completion.

package/.github/copilot-instructions.md

@@ -2,7 +2,7 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: c2aef70028abc43f5e3f110a2fa90086cd6697bac42ec97a8d4db3c4477880d4
+Canonical Snapshot SHA256: 58ca52e08f9503f55d49dfc64f800bb1124774251db4614478dbdfa618834445
 
 The canonical policy source for this repository is [.instructions.md](../.instructions.md).
 
@@ -23,6 +23,10 @@ If your host stops at this file, follow this minimum floor:
 6. Apply state awareness from [.agent-context/state/](../.agent-context/state) and thresholds from [.agent-context/policies/](../.agent-context/policies).
 7. Resolve runtime, structure, and dependency choices from project context docs plus live evidence.
 
+## Bootstrap Receipt
+
+For non-trivial coding, review, planning, or governance work, produce a short Bootstrap Receipt before implementation output: `loaded_files`, `selected_rules`, `skipped_rules`, `unreachable_files`, and `validation_plan`.
+
 ## Completion Gate
 
 Run [.agent-context/review-checklists/pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring work complete.

package/.instructions.md

@@ -16,6 +16,19 @@ You use clear, plain language in formal artifacts and do not use emoji.
 
 Resolve the smallest relevant layer set for the current request. Do not load every layer by default when the task is narrow.
 
+### Bootstrap Receipt
+
+For non-trivial coding, review, planning, or governance work, produce a concise bootstrap receipt before implementation output or file edits. The receipt is evidence of rule loading, not a request to expose hidden reasoning.
+
+Required fields:
+- `loaded_files`: entrypoint, canonical source, and project files actually read.
+- `selected_rules`: rule, prompt, checklist, state, or policy files selected for the current scope, with a short trigger.
+- `skipped_rules`: categories intentionally left unloaded because they are out of scope.
+- `unreachable_files`: required files that could not be read; stop instead of guessing when this list is non-empty.
+- `validation_plan`: commands or checks expected before completion.
+
+Keep the receipt short. Do not load every rule just to fill it out; scoped loading remains mandatory.
+
 ### Layer 1: Rules (15 Files) [SCOPE-RESOLVED]
 
 **Location**: `.agent-context/rules/`

package/.windsurfrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v3.0.31
+Generated by Agentic-Senior-Core CLI v3.0.32
 Timestamp: 2026-04-24T06:02:48.303Z
 Selected policy file: .agent-context/policies/llm-judge-threshold.json
 

package/AGENTS.md

@@ -2,7 +2,7 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: c2aef70028abc43f5e3f110a2fa90086cd6697bac42ec97a8d4db3c4477880d4
+Canonical Snapshot SHA256: 58ca52e08f9503f55d49dfc64f800bb1124774251db4614478dbdfa618834445
 
 This file is an adapter entrypoint for agent discovery.
 The canonical policy source is [.instructions.md](.instructions.md).
@@ -31,6 +31,10 @@ If your host stops at this file instead of following the full chain, obey the Cr
 7. Enforce policy thresholds from [.agent-context/policies/](.agent-context/policies).
 8. Use runtime evidence, structure, and live research signals from project context docs.
 
+## Bootstrap Receipt
+
+For non-trivial coding, review, planning, or governance work, produce a short Bootstrap Receipt before implementation output: `loaded_files`, `selected_rules`, `skipped_rules`, `unreachable_files`, and `validation_plan`.
+
 ## Trigger Rules
 
 - New project or module requests: propose scope, constraints, and required docs first, then wait for approval.

package/lib/cli/utils.mjs

@@ -179,6 +179,14 @@ function isPathWithinPrefix(relativePath, prefixPath) {
     || normalizedRelativePath.startsWith(`${normalizedPrefixPath}/`);
 }
 
+const localOnlyGovernanceFiles = new Set([
+  '.agent-context/state/active-memory.json',
+]);
+
+function isLocalOnlyGovernanceFile(relativePath) {
+  return localOnlyGovernanceFiles.has(toPosixRelativePath(relativePath));
+}
+
 async function collectRelativeTreeEntries(baseDirectoryPath, relativeRootPath) {
   const files = [];
   const directories = [];
@@ -203,6 +211,10 @@ async function collectRelativeTreeEntries(baseDirectoryPath, relativeRootPath) {
         continue;
       }
 
+      if (isLocalOnlyGovernanceFile(relativeEntryPath)) {
+        continue;
+      }
+
       files.push(relativeEntryPath);
     }
   }

package/package.json

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

package/scripts/sync-thin-adapters.mjs

@@ -60,6 +60,10 @@ If your host stops at this file instead of following the full chain, obey the Cr
 7. Enforce policy thresholds from [.agent-context/policies/](.agent-context/policies).
 8. Use runtime evidence, structure, and live research signals from project context docs.
 
+## Bootstrap Receipt
+
+For non-trivial coding, review, planning, or governance work, produce a short Bootstrap Receipt before implementation output: \`loaded_files\`, \`selected_rules\`, \`skipped_rules\`, \`unreachable_files\`, and \`validation_plan\`.
+
 ## Trigger Rules
 
 - New project or module requests: propose scope, constraints, and required docs first, then wait for approval.
@@ -96,6 +100,10 @@ If your host stops at this file, follow this minimum floor:
 6. Apply state awareness from [.agent-context/state/](../.agent-context/state) and thresholds from [.agent-context/policies/](../.agent-context/policies).
 7. Resolve runtime, structure, and dependency choices from project context docs plus live evidence.
 
+## Bootstrap Receipt
+
+For non-trivial coding, review, planning, or governance work, produce a short Bootstrap Receipt before implementation output: \`loaded_files\`, \`selected_rules\`, \`skipped_rules\`, \`unreachable_files\`, and \`validation_plan\`.
+
 ## Completion Gate
 
 Run [.agent-context/review-checklists/pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring work complete.
@@ -128,6 +136,10 @@ If your host stops at this file, follow this minimum floor:
 6. Apply state awareness from [.agent-context/state/](../.agent-context/state) and policy thresholds from [.agent-context/policies/](../.agent-context/policies).
 7. Resolve runtime, structure, and dependency choices from project context docs plus live evidence.
 
+## Bootstrap Receipt
+
+For non-trivial coding, review, planning, or governance work, produce a short Bootstrap Receipt before implementation output: \`loaded_files\`, \`selected_rules\`, \`skipped_rules\`, \`unreachable_files\`, and \`validation_plan\`.
+
 ## Completion Gate
 
 Run [.agent-context/review-checklists/pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring completion.

package/scripts/validate/coverage-checks.mjs

@@ -384,6 +384,22 @@ export async function validateInstructionAdapters(context) {
 
   const canonicalInstructionContent = normalizeLineEndings(await readTextFile(CANONICAL_INSTRUCTION_PATH));
   const canonicalSnapshotHash = createHash('sha256').update(canonicalInstructionContent).digest('hex');
+  const requiredBootstrapReceiptSnippets = [
+    'Bootstrap Receipt',
+    'loaded_files',
+    'selected_rules',
+    'skipped_rules',
+    'unreachable_files',
+    'validation_plan',
+  ];
+
+  for (const requiredBootstrapReceiptSnippet of requiredBootstrapReceiptSnippets) {
+    if (canonicalInstructionContent.includes(requiredBootstrapReceiptSnippet)) {
+      pass(`.instructions.md includes bootstrap receipt snippet: ${requiredBootstrapReceiptSnippet}`);
+    } else {
+      fail(`.instructions.md is missing bootstrap receipt snippet: ${requiredBootstrapReceiptSnippet}`);
+    }
+  }
 
   for (const thinAdapterPath of THIN_ADAPTER_PATHS) {
     const absoluteAdapterPath = join(ROOT_DIR, thinAdapterPath);
@@ -404,6 +420,14 @@ export async function validateInstructionAdapters(context) {
       fail(`${thinAdapterPath} must declare Adapter Mode: thin and Adapter Source: .instructions.md`);
     }
 
+    for (const requiredBootstrapReceiptSnippet of requiredBootstrapReceiptSnippets) {
+      if (thinAdapterContent.includes(requiredBootstrapReceiptSnippet)) {
+        pass(`${thinAdapterPath} includes bootstrap receipt snippet: ${requiredBootstrapReceiptSnippet}`);
+      } else {
+        fail(`${thinAdapterPath} is missing bootstrap receipt snippet: ${requiredBootstrapReceiptSnippet}`);
+      }
+    }
+
     const hashMatch = thinAdapterContent.match(/Canonical Snapshot SHA256:\s*([a-f0-9]{64})/);
     if (!hashMatch) {
       fail(`${thinAdapterPath} must declare Canonical Snapshot SHA256`);