@ryuenn3123/agentic-senior-core 4.1.0 → 4.2.1

package/lib/cli/utils.mjs

@@ -55,7 +55,13 @@ export function printUsage() {
   console.log('  agentic-senior-core launch');
   console.log('  agentic-senior-core init [target-directory] [--preset <name>] [--stack <name>] [--blueprint <name>] [--project-description <text>] [--ci <true|false>] [--token-optimize] [--no-token-optimize] [--token-agent <name>] [--memory-continuity] [--no-memory-continuity] [--scaffold-docs] [--no-scaffold-docs] [--docs-lang <en|id>] [--project-config <path>] [--runtime-env <auto|linux-wsl|linux|windows|macos>]');
   console.log('  agentic-senior-core upgrade [target-directory] [--dry-run] [--yes] [--mcp-template] [--no-mcp-template] [--prune] [--no-prune]');
-  console.log('  agentic-senior-core optimize [target-directory] [--agent <copilot|claude|cursor|windsurf|gemini|codex|cline>] [--enable|--disable] [--show]');
+  console.log('  agentic-senior-core optimize [install|off|status|doctor] [target-directory] [--agent <copilot|claude|cursor|windsurf|gemini|codex|cline>] [--enable|--disable] [--show]');
+  console.log('  asc optimize status [target-directory]');
+  console.log('  asc optimize doctor [target-directory]');
+  console.log('  agentic-senior-core context "<request>" [--json] [--request-id <id>] [--file <path>] [--files <paths>]');
+  console.log('  ascx git status');
+  console.log('  ascx git diff');
+  console.log('  ascx npm test');
   console.log('  agentic-senior-core mcp');
   console.log('  agentic-senior-core rollback [target-directory]');
   console.log('  agentic-senior-core audit:design-anti-repeat [target-directory] [--json] [--palette-advisory] [--threshold <number>]');
@@ -89,6 +95,14 @@ export function printUsage() {
   console.log('  --enable     Enable token optimization policy state');
   console.log('  --disable    Disable token optimization policy state');
   console.log('  --show       Print current token optimization state as JSON');
+  console.log('  status       Show ASCX runtime token saver readiness');
+  console.log('  doctor       Diagnose ASCX runtime token saver readiness and tee write safety');
+  console.log('  --json       Print context manifest as JSON');
+  console.log('  --stdin      Read context request text from stdin');
+  console.log('  --request-id Set the context manifest request id');
+  console.log('  --file       Add a context file path signal for adaptive rule selection');
+  console.log('  --files      Add comma-separated context file path signals');
+  console.log('  ascx         Execute a supported command with evidence-preserving output compression');
 }
 
 /**

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "4.1.0",
+  "version": "4.2.1",
   "type": "module",
   "description": "Change your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {
-    "agentic-senior-core": "bin/agentic-senior-core.js"
+    "asc": "bin/agentic-senior-core.js",
+    "agentic-senior-core": "bin/agentic-senior-core.js",
+    "ascx": "bin/ascx.js"
   },
   "files": [
     "bin/",
+    "benchmarks/compact-natural-mode/",
+    "benchmarks/runtime-token-saver/",
     "lib/",
     "scripts/",
     ".agent-context/policies/",
@@ -71,6 +75,9 @@
     "sbom:generate": "node ./scripts/generate-sbom.mjs",
     "benchmark:detection": "node ./scripts/detection-benchmark.mjs",
     "benchmark:token": "node ./scripts/token-optimization-benchmark.mjs",
+    "benchmark:adaptive-context": "node ./scripts/adaptive-context-benchmark.mjs",
+    "benchmark:ascx": "node ./scripts/ascx-runtime-token-saver-benchmark.mjs",
+    "benchmark:compact-natural": "node ./scripts/compact-natural-mode-benchmark.mjs",
     "benchmark:bundle": "node ./scripts/benchmark-evidence-bundle.mjs",
     "benchmark:writer-judge": "node ./scripts/benchmark-writer-judge-matrix.mjs",
     "benchmark:gate": "node ./scripts/benchmark-gate.mjs",
@@ -83,7 +90,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/audit-caching-scope-hygiene.test.mjs ./tests/research-dossier-migration.test.mjs ./tests/typography-palette-anti-repeat-audit.test.mjs ./tests/audit-design-anti-repeat-command.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/audit-caching-scope-hygiene.test.mjs ./tests/research-dossier-migration.test.mjs ./tests/typography-palette-anti-repeat-audit.test.mjs ./tests/audit-design-anti-repeat-command.test.mjs ./tests/adaptive-context.test.mjs ./tests/ascx-runtime-token-saver.test.mjs ./tests/compact-natural-mode.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/adaptive-context/fixtures.mjs

@@ -0,0 +1,188 @@
+export const ADAPTIVE_CONTEXT_FIXTURES = [
+  {
+    id: 'auth-flow-review',
+    requestText: 'Review this login auth flow. Check JWT session handling, API response errors, and what tests should cover.',
+    requiredLabels: ['SEC', 'API', 'ERR', 'TEST'],
+    allowedLabels: ['SEC', 'API', 'ERR', 'TEST'],
+  },
+  {
+    id: 'real-auth-refactor',
+    requestText: 'Tolong refactor auth flow ini, jangan ubah behavior, cek security dan test juga.',
+    requiredLabels: ['SEC', 'ARCH', 'TEST'],
+    allowedLabels: ['SEC', 'ARCH', 'TEST', 'ERR', 'API'],
+  },
+  {
+    id: 'runtime-hardening',
+    requestText: 'Make adaptive context runtime stable. Fix missed implicit cases before moving to ASCX.',
+    requiredLabels: ['ARCH', 'TEST', 'ERR'],
+    allowedLabels: ['ARCH', 'TEST', 'ERR'],
+  },
+  {
+    id: 'natural-migration-broke',
+    requestText: 'Something broke after I pushed the migration yesterday.',
+    requiredLabels: ['MIG', 'ERR'],
+    allowedLabels: ['MIG', 'ERR'],
+  },
+  {
+    id: 'natural-frontend-mobile-overlap',
+    requestText: 'This page flickers on mobile and the text overlaps.',
+    requiredLabels: ['FE'],
+    allowedLabels: ['FE'],
+  },
+  {
+    id: 'indonesian-access-leak',
+    requestText: 'Audit pembayaran ini, takut kebuka akses user lain.',
+    requiredLabels: ['SEC'],
+    allowedLabels: ['SEC'],
+  },
+  {
+    id: 'indonesian-readable-service',
+    requestText: 'Rapihin service ini biar namingnya enak dibaca.',
+    requiredLabels: ['ARCH', 'NAME'],
+    allowedLabels: ['ARCH', 'NAME'],
+  },
+  {
+    id: 'natural-cron-silent',
+    requestText: 'My cron stops silently, need logs and retry.',
+    requiredLabels: ['JOB', 'ERR', 'OBS', 'RES'],
+    allowedLabels: ['JOB', 'ERR', 'OBS', 'RES'],
+  },
+  {
+    id: 'auth-middleware-duplicate',
+    requestText: 'Remove duplicate code in auth middleware.',
+    requiredLabels: ['SEC', 'ARCH'],
+    allowedLabels: ['SEC', 'ARCH'],
+  },
+  {
+    id: 'indonesian-slow-query',
+    requestText: 'Bisa cek kenapa checkout lemot banget pas query order.',
+    requiredLabels: ['DATA', 'PERF'],
+    allowedLabels: ['DATA', 'PERF'],
+  },
+  {
+    id: 'config-exposing-key',
+    requestText: 'Update env var for staging without exposing key.',
+    requiredLabels: ['CFG', 'SEC'],
+    allowedLabels: ['CFG', 'SEC'],
+  },
+  {
+    id: 'token-budget-context-hardening',
+    requestText: 'Tighten adaptive context token budget and benchmark reporting for real request corpus.',
+    requiredLabels: ['ARCH', 'TEST'],
+    allowedLabels: ['ARCH', 'TEST'],
+  },
+  {
+    id: 'tenant-access-leak-indonesian',
+    requestText: 'Pas login, user bisa lihat data tenant sebelah.',
+    requiredLabels: ['SEC'],
+    allowedLabels: ['SEC'],
+  },
+  {
+    id: 'invoice-worker-no-log',
+    requestText: 'Abis deploy, worker invoice ga jalan tapi ga ada error di log.',
+    requiredLabels: ['JOB', 'ERR', 'OBS'],
+    allowedLabels: ['JOB', 'ERR', 'OBS'],
+  },
+  {
+    id: 'checkout-helper-naming',
+    requestText: 'Rapihin nama variabel di checkout helper, jangan bikin abstraction baru.',
+    requiredLabels: ['ARCH', 'NAME'],
+    allowedLabels: ['ARCH', 'NAME'],
+  },
+  {
+    id: 'mobile-button-cut-off',
+    requestText: 'Button checkout kepotong di layar kecil.',
+    requiredLabels: ['FE'],
+    allowedLabels: ['FE'],
+  },
+  {
+    id: 'production-migration-rollback',
+    requestText: 'Migration order sukses locally tapi production rollback.',
+    requiredLabels: ['MIG', 'ERR'],
+    allowedLabels: ['MIG', 'ERR'],
+  },
+  {
+    id: 'cancel-order-idempotent-endpoint',
+    requestText: 'Buat endpoint cancel order idempotent dan documented.',
+    requiredLabels: ['API'],
+    allowedLabels: ['API'],
+  },
+  {
+    id: 'production-env-secret-error',
+    requestText: 'Env production salah kebaca, jangan tampilin secret di error.',
+    requiredLabels: ['CFG', 'SEC', 'ERR'],
+    allowedLabels: ['CFG', 'SEC', 'ERR'],
+  },
+  {
+    id: 'websocket-reconnect-timeout',
+    requestText: 'WebSocket reconnect sering timeout, perlu fallback.',
+    requiredLabels: ['RT', 'RES'],
+    allowedLabels: ['RT', 'RES'],
+  },
+  {
+    id: 'invoice-query-timeout-nplusone',
+    requestText: 'Query invoice timeout dan N+1.',
+    requiredLabels: ['DATA', 'PERF', 'RES'],
+    allowedLabels: ['DATA', 'PERF', 'RES'],
+  },
+  {
+    id: 'dependency-update-check',
+    requestText: 'Cek dependency package ini outdated atau perlu update.',
+    requiredLabels: ['DEP'],
+    allowedLabels: ['DEP'],
+  },
+  {
+    id: 'frontend-redesign',
+    requestText: 'Redesign this frontend screen from zero with responsive layout, motion, and UI design docs.',
+    requiredLabels: ['FE'],
+    allowedLabels: ['FE'],
+  },
+  {
+    id: 'database-migration-failure',
+    requestText: 'The database migration fails during rollback after a schema change. Check query impact and validation coverage.',
+    requiredLabels: ['DATA', 'MIG', 'ERR', 'TEST'],
+    allowedLabels: ['DATA', 'MIG', 'ERR', 'TEST'],
+  },
+  {
+    id: 'docker-env-setup',
+    requestText: 'Set up Docker Compose with env config and validation so the container can run locally.',
+    requiredLabels: ['DOCK', 'CFG', 'TEST'],
+    allowedLabels: ['DOCK', 'CFG', 'TEST'],
+  },
+  {
+    id: 'worker-retry-observability',
+    requestText: 'Fix the queue worker retry flow. It publishes events, needs fallback behavior, and should log trace data.',
+    requiredLabels: ['JOB', 'EVT', 'RES', 'OBS', 'ERR'],
+    allowedLabels: ['JOB', 'EVT', 'RES', 'OBS', 'ERR'],
+  },
+  {
+    id: 'service-refactor-clean-code',
+    requestText: 'Refactor this service module. Clean up helper names, avoid over-engineering, and keep tests readable.',
+    requiredLabels: ['ARCH', 'NAME', 'TEST'],
+    allowedLabels: ['ARCH', 'NAME', 'TEST'],
+  },
+  {
+    id: 'versioned-api-endpoint',
+    requestText: 'Design a versioned API endpoint contract with safe request validation, error responses, and backward compatibility.',
+    requiredLabels: ['API', 'VER', 'ERR', 'SEC', 'TEST'],
+    allowedLabels: ['API', 'VER', 'ERR', 'SEC', 'TEST'],
+  },
+  {
+    id: 'slow-query-performance',
+    requestText: 'The SQL query is slow and may be an N+1 issue. Add observability and a performance test.',
+    requiredLabels: ['PERF', 'DATA', 'OBS', 'TEST'],
+    allowedLabels: ['PERF', 'DATA', 'OBS', 'TEST'],
+  },
+  {
+    id: 'config-secret-feature-flag',
+    requestText: 'Add a feature flag from env config without leaking secrets in errors.',
+    requiredLabels: ['CFG', 'SEC', 'ERR'],
+    allowedLabels: ['CFG', 'SEC', 'ERR'],
+  },
+  {
+    id: 'realtime-stream-contract',
+    requestText: 'Plan a realtime WebSocket stream API with timeout recovery and monitoring.',
+    requiredLabels: ['RT', 'API', 'RES', 'OBS'],
+    allowedLabels: ['RT', 'API', 'RES', 'OBS'],
+  },
+];

package/scripts/adaptive-context-benchmark.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+import { evaluateAdaptiveContextFixtures } from '../lib/cli/adaptive-context.mjs';
+import { ADAPTIVE_CONTEXT_FIXTURES } from './adaptive-context/fixtures.mjs';
+
+const report = evaluateAdaptiveContextFixtures(ADAPTIVE_CONTEXT_FIXTURES);
+
+console.log(JSON.stringify(report, null, 2));
+process.exit(report.passed ? 0 : 1);

package/scripts/ascx-runtime-token-saver-benchmark.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+import { evaluateAscxFixtures } from '../lib/cli/ascx/fixture-evaluator.mjs';
+import { ASCX_RUNTIME_TOKEN_SAVER_FIXTURES } from '../benchmarks/runtime-token-saver/fixtures.mjs';
+
+const report = await evaluateAscxFixtures(ASCX_RUNTIME_TOKEN_SAVER_FIXTURES);
+
+console.log(JSON.stringify(report, null, 2));
+process.exit(report.passed ? 0 : 1);

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

@@ -148,9 +148,7 @@ export function buildReleaseBenchmarkBundle(options = {}) {
       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/archive/phase-2-outcome.md',
-      phase_3_outcome: 'docs/archive/phase-3-outcome.md',
-      phase_5_plan: 'docs/archive/phase-5-hardening.md',
+      historical_record: 'docs/archive/HISTORY.md',
     },
     integrity: {
       hash_algorithm: 'SHA-256',

package/scripts/clean-local-artifacts.mjs

@@ -25,6 +25,8 @@ const LOCAL_ARTIFACT_PATHS = [
   '.agent-context/state/docs-quality-drift-report.json',
   '.agent-context/state/memory-continuity-benchmark.json',
   '.agent-context/state/quality-trend-report.json',
+  '.agent-context/state/token-saver',
+  '.agent-context/state/token-optimization-report.json',
   '.agent-context/state/token-optimization-benchmark.json',
   '.agent-context/state/weekly-governance-report.json',
 ];

package/scripts/compact-natural-mode-benchmark.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+import { COMPACT_NATURAL_MODE_FIXTURES } from '../benchmarks/compact-natural-mode/fixtures.mjs';
+import { evaluateCompactNaturalFixtures } from '../benchmarks/compact-natural-mode/scorer.mjs';
+
+const report = evaluateCompactNaturalFixtures(COMPACT_NATURAL_MODE_FIXTURES);
+
+console.log(JSON.stringify(report, null, 2));
+process.exit(report.passed ? 0 : 1);

package/scripts/validate/config.mjs

@@ -15,6 +15,7 @@ export const FORMAL_ARTIFACT_PATHS = [
   'docs/deep-analysis-and-roadmap-backlog.md',
   '.agent-context/rules/api-docs.md',
   '.agent-context/review-checklists/pr-checklist.md',
+  '.agent-context/prompts/compact-natural-mode.md',
   '.agent-context/prompts/review-code.md',
   'CLAUDE.md',
   'GEMINI.md',
@@ -280,6 +281,11 @@ export const REQUIRED_UPGRADE_UI_CONTRACT_WARNING_SNIPPETS = [
       'Planned seed on apply: docs/design-intent.json',
       'Upgrade synchronizes governance assets and can seed docs/design-intent.json, but it does not author project-specific docs/DESIGN.md automatically.',
       'detectUiScopeSignals',
+    ],
+  },
+  {
+    path: 'lib/cli/commands/upgrade/design-intent-seed.mjs',
+    snippets: [
       'seed-generated-during-upgrade',
     ],
   },

package/scripts/validate.mjs

@@ -161,6 +161,7 @@ async function validateRequiredFiles() {
     'scripts/release-gate.mjs',
     'scripts/generate-sbom.mjs',
     '.agent-context/policies/llm-judge-threshold.json',
+    '.agent-context/prompts/compact-natural-mode.md',
     '.agent-context/prompts/research-design.md',
     'mcp.json',
     'AGENTS.md',
@@ -252,6 +253,7 @@ async function validateRuleFiles() {
     'review-checklists/pr-checklist.md',
     'review-checklists/architecture-review.md',
     'prompts/init-project.md',
+    'prompts/compact-natural-mode.md',
     'prompts/bootstrap-design.md',
     'prompts/refactor.md',
     'prompts/review-code.md',