@ryuenn3123/agentic-senior-core 4.0.3 → 4.2.0

package/lib/cli/token-optimization.mjs

@@ -1,8 +1,10 @@
+import { existsSync } from 'node:fs';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { platform } from 'node:process';
 
+import { REPOSITORY_ROOT } from './constants.mjs';
 import { pathExists } from './utils.mjs';
 
 export const TOKEN_OPTIMIZATION_STATE_FILE_NAME = 'token-optimization.json';
@@ -44,13 +46,13 @@ const COMMAND_REWRITE_MAPPINGS = [
   },
   {
     rawCommand: 'git status',
-    optimizedCommand: 'rtk git status',
-    reason: 'Status output is condensed to actionable file changes.',
+    optimizedCommand: 'ascx git status',
+    reason: 'ASCX condenses status output while preserving changed-file evidence and raw tee safety.',
   },
   {
     rawCommand: 'git diff',
-    optimizedCommand: 'rtk git diff',
-    reason: 'Diff noise is trimmed while preserving code-review context.',
+    optimizedCommand: 'ascx git diff',
+    reason: 'ASCX preserves changed files, hunk anchors, binary/deleted markers, truncation notes, and raw tee safety.',
   },
   {
     rawCommand: 'git log -n 10',
@@ -59,8 +61,8 @@ const COMMAND_REWRITE_MAPPINGS = [
   },
   {
     rawCommand: 'npm test',
-    optimizedCommand: 'rtk test npm test',
-    reason: 'Test results emphasize failures and suppress repetitive pass logs.',
+    optimizedCommand: 'ascx npm test',
+    reason: 'ASCX preserves exit code, failing tests, assertions, file paths, and raw tee safety.',
   },
   {
     rawCommand: 'npm run build',
@@ -179,6 +181,157 @@ export function detectRtkBinary() {
   }
 }
 
+export function detectAscxRuntime() {
+  const localBinPath = path.join(REPOSITORY_ROOT, 'bin', 'ascx.js');
+  const pathDetection = spawnSync('ascx', [], {
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'pipe'],
+  });
+  const pathBinaryLooksAvailable = pathDetection.error == null
+    && typeof pathDetection.status === 'number'
+    && /command is required/i.test(`${pathDetection.stdout || ''}\n${pathDetection.stderr || ''}`);
+
+  if (pathBinaryLooksAvailable) {
+    return {
+      isAvailable: true,
+      source: 'path',
+      command: 'ascx',
+      localBinPath,
+      detectionError: null,
+    };
+  }
+
+  if (existsSync(localBinPath)) {
+    return {
+      isAvailable: true,
+      source: 'package-bin',
+      command: `node ${localBinPath}`,
+      localBinPath,
+      detectionError: pathDetection.error ? pathDetection.error.message : null,
+    };
+  }
+
+  return {
+    isAvailable: false,
+    source: 'missing',
+    command: null,
+    localBinPath,
+    detectionError: pathDetection.error
+      ? pathDetection.error.message
+      : (pathDetection.stderr || pathDetection.stdout || 'ascx binary was not detected').trim(),
+  };
+}
+
+export async function checkAscxTeeReadiness(targetDirectoryPath, options = {}) {
+  const shouldWriteProbe = options.writeProbe === true;
+  const stateDirectoryPath = path.join(targetDirectoryPath, '.agent-context', 'state');
+  const teeDirectoryPath = path.join(stateDirectoryPath, 'token-saver', 'tee');
+
+  try {
+    if (shouldWriteProbe) {
+      await fs.mkdir(teeDirectoryPath, { recursive: true });
+      const probeFilePath = path.join(teeDirectoryPath, `.ascx-probe-${process.pid}.tmp`);
+      await fs.writeFile(probeFilePath, 'ascx tee probe\n', 'utf8');
+      await fs.rm(probeFilePath, { force: true });
+    } else {
+      await fs.access(stateDirectoryPath);
+    }
+
+    return {
+      status: 'writable',
+      path: teeDirectoryPath,
+      error: null,
+    };
+  } catch (readinessError) {
+    return {
+      status: 'not-writable',
+      path: teeDirectoryPath,
+      error: readinessError instanceof Error ? readinessError.message : String(readinessError),
+    };
+  }
+}
+
+export function resolveRuntimeTokenSaverMode({
+  tokenOptimizationState,
+  ascxDetection,
+  rtkDetection,
+}) {
+  const stateEnabled = tokenOptimizationState?.enabled === true;
+  const rtkDetected = rtkDetection?.isAvailable === true;
+
+  if (stateEnabled && ascxDetection?.isAvailable && rtkDetected) {
+    return 'conflict-risk';
+  }
+
+  if (stateEnabled && ascxDetection?.isAvailable) {
+    return 'runtime-on';
+  }
+
+  if (stateEnabled) {
+    return 'policy-only';
+  }
+
+  if (rtkDetected) {
+    return 'external-runtime-detected';
+  }
+
+  return 'runtime-off';
+}
+
+export function buildRuntimeTokenSaverWarnings({
+  mode,
+  onboardingReport,
+  ascxDetection,
+  teeReadiness,
+  rtkDetection,
+}) {
+  const warnings = [];
+
+  if (!onboardingReport) {
+    warnings.push('project is not initialized; run init before enabling runtime token saving');
+  }
+
+  if (!ascxDetection?.isAvailable) {
+    warnings.push('ascx binary is missing; supported commands will not be compressed');
+  }
+
+  if (teeReadiness?.status !== 'writable') {
+    warnings.push('raw tee folder is not writable; failing commands may lose safety logs');
+  }
+
+  if (mode === 'conflict-risk') {
+    warnings.push('ASCX and an external runtime compressor both appear active; avoid double compression');
+  } else if (rtkDetection?.isAvailable) {
+    warnings.push('external runtime compressor detected; keep only one runtime compressor enabled by default');
+  }
+
+  return warnings;
+}
+
+export function buildRuntimeTokenSaverNextAction({ mode, warnings }) {
+  if (warnings.some((warning) => warning.includes('not initialized'))) {
+    return 'Run agentic-senior-core init before enabling ASCX runtime saving.';
+  }
+
+  if (warnings.some((warning) => warning.includes('tee folder'))) {
+    return 'Fix .agent-context/state write access, then rerun optimize doctor.';
+  }
+
+  if (mode === 'conflict-risk') {
+    return 'Disable either ASCX runtime saving or the external compressor before using compressed command output.';
+  }
+
+  if (mode === 'runtime-on') {
+    return 'Use ascx git status, ascx git diff, and ascx npm test for supported high-volume command output.';
+  }
+
+  if (mode === 'policy-only') {
+    return 'Install or expose the ascx binary, then rerun optimize doctor.';
+  }
+
+  return 'Run agentic-senior-core optimize install to enable ASCX guidance for this repository.';
+}
+
 export function buildRtkInstallHint() {
   if (platform === 'win32') {
     return 'Install the external token optimizer binary for Windows, extract it, and ensure the executable is on PATH.';
@@ -298,6 +451,7 @@ export function buildTokenOptimizationGuidanceBlock(tokenOptimizationState) {
   );
 
   const fallbackGuidance = [
+    '- Use ascx git status, ascx git diff, and ascx npm test when the ascx binary is available.',
     '- Use command variants with bounded output such as git diff --stat, rg --max-count, and npm test -- --reporter=dot.',
     '- Request only the lines or sections required for the current decision.',
     '- If shell output is still large, summarize and continue iteratively instead of dumping full logs.',
@@ -319,6 +473,7 @@ export function buildTokenOptimizationGuidanceBlock(tokenOptimizationState) {
     ...rewriteLines,
     '',
     'Important scope note:',
+    '- ASCX wrappers are explicit local command wrappers, not provider gateways.',
     '- Shell rewrite hooks affect shell tool calls only.',
     '- Built-in read/grep/glob style tools may bypass shell rewrites, so explicit compact shell commands should be preferred in high-volume sessions.',
     '',

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.0.3",
+  "version": "4.2.0",
   "type": "module",
-  "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
+  "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/",
@@ -63,7 +67,6 @@
     "audit:release-bundle": "node ./scripts/audit-release-bundle.mjs",
     "audit:file-size": "node ./scripts/audit-file-size.mjs",
     "audit:rule-id-uniqueness": "node ./scripts/audit-rule-id-uniqueness.mjs",
-    "audit:v3-purge": "node ./scripts/v3-purge-audit.mjs",
     "build:release-bundle": "node ./scripts/build-release-benchmark-bundle.mjs",
     "sync:adapters": "node ./scripts/sync-thin-adapters.mjs",
     "check:adapters": "node ./scripts/sync-thin-adapters.mjs --check",
@@ -72,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",
@@ -84,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/migrate-rule-format.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/audit-cache-layer-contract.mjs

@@ -5,6 +5,11 @@
  * Phase 2 cache-layer integrity gate. Validates provider cache metadata,
  * fixture segmentation, and the emitted cache simulation JSON without calling
  * provider APIs.
+ *
+ * Boundary: this audit covers the TECHNICAL contract (provider matrix,
+ * layer definitions, fixture segmentation, simulation result JSON shape).
+ * For public-prose hygiene around caching saving figures see
+ * audit-caching-scope-hygiene.mjs.
  */
 
 import { existsSync, readFileSync } from 'node:fs';

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

@@ -9,6 +9,11 @@
  * that each claim is integration-scoped per `docs/architecture/decisions-foundation.md`
  * D4 "Per-Tool Caching Scope Matrix".
  *
+ * Boundary: this audit covers PUBLIC-PROSE hygiene only (preventing
+ * universal "X% caching saving" claims that mix integration modes). For the
+ * technical provider/fixture/result-JSON contract see
+ * audit-cache-layer-contract.mjs.
+ *
  * The rule: never publish a single universal "X% caching saving" figure that
  * mixes integration modes. Every numerical caching saving claim on a public
  * surface must either:

package/scripts/clean-local-artifacts.mjs

@@ -15,7 +15,6 @@ const LOCAL_ARTIFACT_PATHS = [
   '.zed',
   '.agentic-backup',
   '.agent-context/state/active-memory.json',
-  '.agent-context/state/v3-purge-audit.json',
   '.agent-context/state/llm-judge-report.json',
   '.agent-context/state/benchmark-analysis.json',
   '.agent-context/state/benchmark-evidence-bundle.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/frontend-usability-audit.mjs

@@ -17,9 +17,7 @@ const __dirname = dirname(__filename);
 const REPOSITORY_ROOT = resolve(__dirname, '..');
 
 const REQUIRED_FILES = [
-  'docs/roadmap.md',
-  'docs/archive/v1.7-issue-breakdown.md',
-  'docs/archive/v1.7-execution-playbook.md',
+  'docs/archive/HISTORY.md',
   'AGENTS.md',
   '.agent-context/prompts/bootstrap-design.md',
   'scripts/ui-design-judge.mjs',
@@ -32,11 +30,10 @@ const REQUIRED_FILES = [
   'lib/cli/detector/design-evidence.mjs',
 ];
 
-const REQUIRED_ROADMAP_SNIPPETS = [
+const REQUIRED_HISTORY_SNIPPETS = [
   'V1.7',
   'Frontend Product Experience',
-  'Release status: Completed',
-  'Delivered Scope',
+  'completed',
 ];
 
 const REQUIRED_PR_CHECKLIST_SNIPPETS = [
@@ -174,7 +171,7 @@ function runAudit() {
     assertFileExists(requiredFilePath, failures);
   }
 
-  const roadmapPath = 'docs/roadmap.md';
+  const roadmapPath = 'docs/archive/HISTORY.md';
   const frontendRulePath = '.agent-context/rules/frontend-architecture.md';
   const bootstrapDesignPromptPath = '.agent-context/prompts/bootstrap-design.md';
   const instructionsPath = 'AGENTS.md';
@@ -185,7 +182,7 @@ function runAudit() {
 
   if (existsSync(resolve(REPOSITORY_ROOT, roadmapPath))) {
     const roadmapContent = readFileSync(resolve(REPOSITORY_ROOT, roadmapPath), 'utf8');
-    assertContains('Roadmap', roadmapPath, roadmapContent, REQUIRED_ROADMAP_SNIPPETS, failures);
+    assertContains('Project history', roadmapPath, roadmapContent, REQUIRED_HISTORY_SNIPPETS, failures);
   }
 
   if (existsSync(resolve(REPOSITORY_ROOT, prChecklistPath))) {

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

@@ -23,7 +23,6 @@ import {
 export function runStaticReleaseChecks(results, diagnostics) {
   const packageJsonPath = 'package.json';
   const changelogPath = 'CHANGELOG.md';
-  const roadmapPath = 'docs/roadmap.md';
 
   const packageJsonContent = readText(packageJsonPath);
   if (!packageJsonContent) {
@@ -61,13 +60,14 @@ export function runStaticReleaseChecks(results, diagnostics) {
     pushResult(results, true, 'changelog-version-entry', `Found release header for ${releaseVersion}`);
   }
 
-  const roadmapContent = readText(roadmapPath);
-  if (!roadmapContent) {
-    pushResult(results, false, 'roadmap-exists', `Missing ${roadmapPath}`);
-  } else if (!roadmapContent.includes('V1.8')) {
-    pushResult(results, false, 'roadmap-v18', 'Roadmap does not mention V1.8 release track');
+  const historyPath = 'docs/archive/HISTORY.md';
+  const historyContent = readText(historyPath);
+  if (!historyContent) {
+    pushResult(results, false, 'history-exists', `Missing ${historyPath}`);
+  } else if (!historyContent.includes('V1.8')) {
+    pushResult(results, false, 'history-v18', 'Project history does not mention V1.8 release track');
   } else {
-    pushResult(results, true, 'roadmap-v18', 'Roadmap includes V1.8 release track');
+    pushResult(results, true, 'history-v18', 'Project history includes V1.8 release track');
   }
 
   try {

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',
@@ -51,7 +52,6 @@ export const REQUIRED_HUMAN_WRITING_SNIPPETS = [
 ];
 export const TERMINOLOGY_REFERENCE_PATHS = [
   'README.md',
-  'docs/roadmap.md',
 ];
 export const REQUIRED_TERMINOLOGY_ROW_PATTERNS = [
   {
@@ -69,7 +69,6 @@ export const REQUIRED_TERMINOLOGY_ROW_PATTERNS = [
 ];
 export const REQUIRED_TERMINOLOGY_RULE_SNIPPET =
   'Rule: on first mention in developer-facing docs, include canonical term in parentheses.';
-export const TERMINOLOGY_REFERENCE_DOCUMENT_PATH = 'docs/terminology-mapping.md';
 export const REQUIRED_DEVELOPER_FIRST_MENTION_PATTERNS = [
   {
     path: 'README.md',