@ryuenn3123/agentic-senior-core 2.5.22 → 3.0.2

package/AGENTS.md

@@ -2,7 +2,7 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 2a2a036b4fb90f9e668163b83614f2339044c0d021a6eaf2f380e626dfe72de0
+Canonical Snapshot SHA256: 354edbbfaedec284ddcc6d4a5bb5393a7f5385650d1a6ae84a2d9633b5a6d10d
 
 This file is an adapter entrypoint for agent discovery.
 The canonical policy source is [.instructions.md](.instructions.md).
@@ -11,13 +11,11 @@ The canonical policy source is [.instructions.md](.instructions.md).
 
 1. Load [.instructions.md](.instructions.md) first as the single source of truth.
 2. Read baseline governance from [.agent-context/rules/](.agent-context/rules).
-3. Load language conventions from [.agent-context/stacks/](.agent-context/stacks).
-4. Load scaffolding references from [.agent-context/blueprints/](.agent-context/blueprints) when creating modules/projects.
-5. Load domain packs from [.agent-context/skills/](.agent-context/skills).
-6. Apply request templates from [.agent-context/prompts/](.agent-context/prompts).
-7. Apply team governance defaults from [.agent-context/profiles/](.agent-context/profiles).
-8. Read change-risk maps from [.agent-context/state/](.agent-context/state).
-9. Enforce policy thresholds from [.agent-context/policies/](.agent-context/policies).
+3. Apply request templates from [.agent-context/prompts/](.agent-context/prompts).
+4. Enforce review contracts from [.agent-context/review-checklists/](.agent-context/review-checklists).
+5. Read change-risk maps and continuity state from [.agent-context/state/](.agent-context/state).
+6. Enforce policy thresholds from [.agent-context/policies/](.agent-context/policies).
+7. Use dynamic stack and architecture reasoning from project context docs and live research signals.
 
 ## Trigger Rules
 
@@ -25,4 +23,4 @@ The canonical policy source is [.instructions.md](.instructions.md).
 - Refactor or fix requests: propose plan first, then execute safely.
 - Completion: run [.agent-context/review-checklists/pr-checklist.md](.agent-context/review-checklists/pr-checklist.md) before declaring done.
 
-If this adapter drifts from canonical behavior, refresh from [.instructions.md](.instructions.md) and update the hash metadata.
+If this adapter drifts from canonical behavior, refresh from [.instructions.md](.instructions.md) and update the hash metadata.

package/CONTRIBUTING.md

@@ -9,8 +9,8 @@ Thanks for wanting to make AI agents write better code. Here's how to contribute
 | Type | Where | Description |
 |------|-------|-------------|
 | New rule | `.agent-context/rules/` | Universal engineering standard |
-| New stack | `.agent-context/stacks/` | Language-specific profile (Python, Go, Java, etc.) |
-| New blueprint | `.agent-context/blueprints/` | Project scaffolding template |
+| Stack strategy update | `.agent-context/rules/`, `.agent-context/state/stack-research-snapshot.json` | Dynamic language/runtime guidance and evidence |
+| Architecture playbook update | `.agent-context/prompts/`, `lib/cli/compiler.mjs` | Dynamic scaffolding and project-context guidance |
 | New checklist | `.agent-context/review-checklists/` | Self-audit guide |
 | State intelligence update | `.agent-context/state/` | Architecture boundaries and dependency map |
 | Override policy update | `.agent-override.md` | Scoped enterprise rule exceptions |
@@ -44,36 +44,23 @@ If all three are "yes", it belongs here.
 
 ---
 
-## How to Add a New Stack Profile (e.g., Python)
-
-1. Create `.agent-context/stacks/python.md`
-2. Follow the structure of `stacks/typescript.md`:
-   - Compiler/linter configuration (non-negotiable settings)
-   - Type system rules (the equivalent of "ban any")
-   - Validation at boundaries (Pydantic, marshmallow, etc.)
-   - Import conventions
-   - Async patterns
-   - Preferred libraries with justification
-   - Banned patterns with alternatives
-3. Update `AGENTS.md` to add the new stack to the manifest table
-4. Run `bun scripts/validate.ts` to verify everything links correctly
-5. Open a PR
+## How to Add or Adjust Stack Strategy Signals (e.g., Python)
+
+1. Update relevant universal guidance in `.agent-context/rules/` (typing, validation, architecture constraints).
+2. Add or adjust measurable stack evidence in `.agent-context/state/stack-research-snapshot.json`.
+3. Update stack-facing wording in prompts or CLI output when behavior changes.
+4. Run `npm run validate` to verify references and policy checks.
+5. Open a PR.
 
 ---
 
-## How to Add a New Blueprint
-
-1. Create `.agent-context/blueprints/<framework-name>.md`
-2. Include:
-   - Tech stack summary
-   - Complete directory structure
-   - Code patterns for each layer (with full examples)
-   - Environment validation setup
-   - Error handling setup
-   - Scaffolding checklist
-3. Update `AGENTS.md` manifest
-4. Update `prompts/init-project.md` available blueprints table
-5. Validate and PR
+## How to Add or Adjust Architecture Playbooks
+
+1. Update the architecture options in `.agent-context/prompts/init-project.md` and related discovery guidance.
+2. Update compiler/init behavior if generated project-context guidance or bootstrap flow changes.
+3. Keep transport/service/repository separation and validation boundaries explicit in examples.
+4. Run `npm run validate` and `npm test`.
+5. Open a PR.
 
 ---
 
@@ -96,7 +83,7 @@ If all three are "yes", it belongs here.
 1. **Fork** the repository
 2. **Branch** from `main`: `feat/add-python-stack` or `docs/fix-security-typo`
 3. **Write** your content following the quality standard above
-4. **Validate**: `bun scripts/validate.ts` must pass
+4. **Validate**: `npm run validate` must pass
 5. **Commit** with Conventional Commits: `feat(stacks): add Python profile`
 6. **Open PR** with:
    - What you added/changed
@@ -123,7 +110,7 @@ git clone https://github.com/fatidaprilian/Agentic-Senior-Core.git
 cd Agentic-Senior-Core
 
 # Validate
-bun run validate
+npm run validate
 
 # Test interactive CLI
 node ./bin/agentic-senior-core.js init /tmp/test-project

package/README.md

@@ -10,56 +10,30 @@
 **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.
 
-</div>
-
----
+Latest release: 3.0.2 (2026-04-18).
 
-## 60-Second Start
-
-```bash
-npx @ryuenn3123/agentic-senior-core init
-```
-
-That one command initializes your project with compiled rules, review checklists, and state context.
-
-Golden Standard mode is now the default path: init applies the recommended quality profile automatically, without a beginner/balanced/strict prompt on first run.
-
-Optional team default path:
-
-```bash
-npx @ryuenn3123/agentic-senior-core init --profile-pack startup
-```
+Highlights in 3.0.0:
+- Universal IDE adapter surface is completed and synchronized through thin adapters.
+- Scoped auto-docs sync rollout is active with explicit phase-1 boundaries and precision/recall evidence.
+- Init and scaffolding flow is slimmer, template-free on active path, and validated by deterministic release gates.
 
-Project-description-first path (AI as Architect with veto control):
+</div>
 
-```bash
-npx @ryuenn3123/agentic-senior-core init --project-description "Machine learning API for fraud detection"
-```
+---
 
-Default init path now attempts trusted realtime stack research first (with automatic snapshot fallback):
 
-```bash
-npx @ryuenn3123/agentic-senior-core init --project-description "Event-driven payments platform"
-```
+## 60-Second Start
 
-Force deterministic snapshot-only mode:
 
 ```bash
-npx @ryuenn3123/agentic-senior-core init --project-description "Event-driven payments platform" --architect-research-mode snapshot
+npx @ryuenn3123/agentic-senior-core init
 ```
 
-Optional trusted realtime enrichment (explicitly gated):
-
-```bash
-npx @ryuenn3123/agentic-senior-core init --project-description "Modern conversion-focused product website" --architect-research-mode realtime --enable-realtime-research --architect-realtime-signal-file ./realtime-signals.json
-```
+One command to initialize rules, checklists, and strict AI coding guidelines context for your project.
 
-AI-first project context bootstrap (no static docs template rendering):
+> **See [docs/deep-dive.md](docs/deep-dive.md) and [docs/roadmap.md](docs/roadmap.md) for advanced configuration, architect mode, snapshot, and realtime options.**
 
-- Init now generates bootstrap prompts under `.agent-context/prompts/`.
-- On first IDE chat, execute `bootstrap-project-context.md` when `docs/project-brief.md` is missing.
-- For UI-first projects, execute `bootstrap-design.md` when `docs/DESIGN.md` is missing.
-- The assistant should synthesize docs from scratch into `docs/` and treat them as living context.
+- This command writes `.agent-context/state/v3-purge-audit.json` and reports whether static directory deletion is safe.
 
 ---
 
@@ -99,10 +73,10 @@ If you see `Property $schema is not allowed`, keep `.vscode/mcp.json` without `$
 
 | Command | Purpose |
 |---------|---------|
-| `agentic-senior-core init` | Initialize rules operations context (Federated Governance baseline) |
+| `agentic-senior-core init` | Initialize strict AI coding guidelines (Federated Governance baseline) |
 | `agentic-senior-core upgrade --dry-run` | Preview safe upgrades |
 | `agentic-senior-core optimize --show` | Show token optimization state |
-| `agentic-senior-core skill frontend --tier advance` | Select skill packs |
+| `npm run audit:v3-purge` | Run deep purge readiness audit (no deletion) |
 | `agentic-senior-core mcp` | Start local MCP stdio runtime |
 
 ---
@@ -116,6 +90,9 @@ npx @ryuenn3123/agentic-senior-core upgrade --yes
 
 Use `--dry-run` first to preview changes safely, then apply with `--yes`.
 
+Upgrade now performs managed-surface synchronization by default: obsolete governance files under managed paths are pruned so the pack stays aligned with the latest release.
+Use `--no-prune` if you want to keep legacy managed files.
+
 ---
 
 ## Terminology Mapping (Final)
@@ -134,9 +111,6 @@ Full mapping reference: docs/terminology-mapping.md
 
 ## Reference Docs
 
-- GitHub Template: https://github.com/fatidaprilian/Agentic-Senior-Core/generate
-- Windows bootstrap script: scripts/init-project.ps1
-- Linux/macOS bootstrap script: scripts/init-project.sh
 - FAQ: docs/faq.md
 - Deep dive internals: docs/deep-dive.md
 - V2 upgrade playbook: docs/v2-upgrade-playbook.md

package/bin/agentic-senior-core.js

@@ -15,7 +15,6 @@ import { runMcpServerCommand } from '../lib/cli/commands/mcp.mjs';
 import { runOptimizeCommand, parseOptimizeArguments } from '../lib/cli/commands/optimize.mjs';
 import { runInitCommand, parseInitArguments } from '../lib/cli/commands/init.mjs';
 import { runUpgradeCommand, parseUpgradeArguments } from '../lib/cli/commands/upgrade.mjs';
-import { runSkillCommand } from '../lib/cli/skill-selector.mjs';
 
 async function main() {
   const commandArgument = process.argv[2];
@@ -36,11 +35,6 @@ async function main() {
     return;
   }
 
-  if (commandArgument === 'skill') {
-    await runSkillCommand(commandArguments);
-    return;
-  }
-
   if (commandArgument === 'upgrade') {
     const upgradeOptions = parseUpgradeArguments(commandArguments);
     await runUpgradeCommand(upgradeOptions.targetDirectory, upgradeOptions);