@stackbilt/cli 0.9.1 → 0.10.0

package/LICENSE

@@ -1,3 +1,19 @@
+Copyright 2026 Stackbilt LLC
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+---
+
                                  Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
@@ -175,7 +191,7 @@
 
    END OF TERMS AND CONDITIONS
 
-   Copyright 2026 StackBilt, Smart Brand Strategies LLC
+   Copyright 2026 Stackbilt LLC
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -69,6 +69,8 @@ charter adf migrate --dry-run  # preview agent config → ADF migration
 charter adf sync --check     # verify .adf files match locked hashes
 charter adf evidence --auto-measure --format json  # validate metric ceilings
 charter telemetry report --period 24h --format json  # passive local usage summary
+charter blast src/foo.ts --depth 3  # reverse dep graph → files affected by changing this seed
+charter surface --markdown          # extract routes (Hono/Express) + D1 schema as markdown
 ```
 
 ## Human Onboarding (Copy/Paste)
@@ -299,6 +301,44 @@ charter adf migrate [--dry-run] [--source <file>] [--no-backup]
 - `metrics recalibrate`: Re-measure current LOC from manifest metric sources, propose and apply new ceilings using configurable headroom, and append rationale records to `BUDGET_RATIONALES`. Requires explicit rationale (`--reason`) unless `--auto-rationale` is used.
 - `migrate`: Scan existing agent config files (CLAUDE.md, .cursorrules, agents.md, GEMINI.md, copilot-instructions.md), classify content using the ADX-002 decision tree, and migrate into ADF modules. `--dry-run` previews the migration plan without writing files. `--source <file>` targets a single file. `--no-backup` skips `.pre-adf-migrate.bak` creation. `--merge-strategy` controls deduplication: `dedupe` (default, skip items already in ADF), `append` (always add), or `replace`. Environment-specific rules (WSL, PATH, credential helpers) are retained in the thin pointer.
 
+### `charter blast`
+
+Compute the blast radius of a change: which files transitively depend on the given seed files? Builds a reverse dependency graph (TS/JS imports — handles ESM `.js → .ts`, tsconfig path aliases including `extends` chains, `src/index.*` fallback, cycles, comments) and BFS-traverses up to a configurable depth.
+
+```bash
+charter blast src/kernel/dispatch.ts            # default depth 3
+charter blast src/a.ts src/b.ts --depth 4       # multi-seed
+charter blast src/foo.ts --format json          # structured output
+charter blast src/foo.ts --root ./packages/x    # scan a subdirectory
+```
+
+Reports:
+- `affected` — relative paths of transitively dependent files
+- `hotFiles` — top 20 most-imported files in the graph (architectural hubs)
+- `summary.totalAffected`, `summary.depthHistogram`
+
+Blast radius ≥20 files triggers a `CROSS_CUTTING` warning — a signal for governance gates to escalate the change. Pure heuristic, no LLM calls, zero runtime dependencies. Backed by `@stackbilt/blast`.
+
+### `charter surface`
+
+Extract the API surface of a project: HTTP routes and database schema. Designed for Cloudflare Worker projects but works on any Node.js HTTP backend.
+
+```bash
+charter surface                                 # text summary
+charter surface --format json                   # machine-readable
+charter surface --markdown                      # for .ai/surface.adf injection
+charter surface --root ./packages/worker        # scan a subdirectory
+charter surface --schema db/schema.sql          # explicit schema path
+```
+
+Detects:
+- **Routes** — Hono, Express, itty-router via regex (requires `/` path prefix; strips comments before scanning)
+- **Schema** — D1/SQLite `CREATE TABLE` statements with column flags (pk, unique, nullable, default)
+
+Ignores `__tests__/`, `*.test.*`, `*.spec.*` to avoid false positives from test fixtures.
+
+Use cases: breaking change detection (diff surfaces before/after a PR), auto-generated AI context maps, deploy pipeline gates, mission brief fingerprinting for autonomous task runners. Backed by `@stackbilt/surface`.
+
 ### `charter telemetry`
 
 Passive local observability for Charter/ADF usage. Every CLI run appends command metadata (timestamp, command path, flags, duration, exit code) to `.charter/telemetry/events.ndjson`.
@@ -372,6 +412,8 @@ Setup-only options:
 - `@stackbilt/drift` -- blessed-stack pattern drift detection
 - `@stackbilt/validate` -- citation validation and intent classification
 - `@stackbilt/adf` -- ADF parser, formatter, patcher, and bundler
+- `@stackbilt/blast` -- reverse dependency graph + blast radius analysis
+- `@stackbilt/surface` -- API surface extraction (routes + D1 schema)
 - `@stackbilt/ci` -- GitHub Actions integration helpers
 
 ## License

package/dist/__tests__/bootstrap.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bootstrap.test.d.ts.map

package/dist/__tests__/bootstrap.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/bootstrap.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/bootstrap.test.js

@@ -0,0 +1,134 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const vitest_1 = require("vitest");
+const bootstrap_1 = require("../commands/bootstrap");
+const baseOptions = {
+    configPath: '.charter',
+    format: 'text',
+    ciMode: false,
+    yes: false,
+};
+(0, vitest_1.describe)('bootstrapCommand', () => {
+    let originalCwd;
+    let tempDir;
+    let logs;
+    (0, vitest_1.beforeEach)(() => {
+        originalCwd = process.cwd();
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'charter-bootstrap-test-'));
+        process.chdir(tempDir);
+        logs = [];
+        vitest_1.vi.spyOn(console, 'log').mockImplementation((...args) => {
+            logs.push(args.map(String).join(' '));
+        });
+    });
+    (0, vitest_1.afterEach)(() => {
+        process.chdir(originalCwd);
+        fs.rmSync(tempDir, { recursive: true, force: true });
+        vitest_1.vi.restoreAllMocks();
+    });
+    (0, vitest_1.it)('keeps custom ADF files when run with --yes but without --force', async () => {
+        fs.mkdirSync('.ai', { recursive: true });
+        const customCore = `ADF: 0.1
+
+CONTEXT:
+  - Custom core instructions
+`;
+        fs.writeFileSync(path.join('.ai', 'core.adf'), customCore);
+        const exitCode = await (0, bootstrap_1.bootstrapCommand)({ ...baseOptions, yes: true }, ['--yes', '--preset', 'worker', '--skip-install', '--skip-doctor']);
+        (0, vitest_1.expect)(exitCode).toBe(0);
+        (0, vitest_1.expect)(fs.readFileSync(path.join('.ai', 'core.adf'), 'utf-8')).toBe(customCore);
+        (0, vitest_1.expect)(fs.existsSync(path.join('.ai', '.backup'))).toBe(false);
+        (0, vitest_1.expect)(fs.existsSync(path.join('.ai', 'manifest.adf'))).toBe(true);
+        (0, vitest_1.expect)(fs.existsSync(path.join('.ai', 'state.adf'))).toBe(true);
+        const skipWarning = logs.find(l => l.includes('.ai/core.adf has custom content') && l.includes('skipping scaffold overwrite'));
+        (0, vitest_1.expect)(skipWarning).toBeDefined();
+        (0, vitest_1.expect)(skipWarning).toMatch(/\d+ bytes/);
+    });
+    (0, vitest_1.it)('backs up and overwrites custom ADF files when run with --force', async () => {
+        fs.mkdirSync('.ai', { recursive: true });
+        const customCore = `ADF: 0.1
+
+CONTEXT:
+  - Preserve me in backup
+`;
+        const customState = `ADF: 0.1
+STATE:
+  CURRENT: Custom state
+`;
+        fs.writeFileSync(path.join('.ai', 'core.adf'), customCore);
+        fs.writeFileSync(path.join('.ai', 'state.adf'), customState);
+        const exitCode = await (0, bootstrap_1.bootstrapCommand)(baseOptions, ['--force', '--preset', 'worker', '--skip-install', '--skip-doctor']);
+        (0, vitest_1.expect)(exitCode).toBe(0);
+        // Backup files should exist with timestamp suffix
+        const backupDir = path.join('.ai', '.backup');
+        (0, vitest_1.expect)(fs.existsSync(backupDir)).toBe(true);
+        const backupFiles = fs.readdirSync(backupDir);
+        const coreBackup = backupFiles.find(f => f.startsWith('core.adf.'));
+        const stateBackup = backupFiles.find(f => f.startsWith('state.adf.'));
+        (0, vitest_1.expect)(coreBackup).toBeDefined();
+        (0, vitest_1.expect)(stateBackup).toBeDefined();
+        (0, vitest_1.expect)(fs.readFileSync(path.join(backupDir, coreBackup), 'utf-8')).toBe(customCore);
+        (0, vitest_1.expect)(fs.readFileSync(path.join(backupDir, stateBackup), 'utf-8')).toBe(customState);
+        // Originals should be overwritten with scaffold content
+        (0, vitest_1.expect)(fs.readFileSync(path.join('.ai', 'core.adf'), 'utf-8')).not.toBe(customCore);
+        (0, vitest_1.expect)(fs.readFileSync(path.join('.ai', 'state.adf'), 'utf-8')).not.toBe(customState);
+        (0, vitest_1.expect)(logs).toContain('  Backed up 2 files to .ai/.backup/');
+    });
+    (0, vitest_1.it)('detects orphaned .adf modules and auto-registers them in --yes mode', async () => {
+        // Pre-create .ai/ with extra modules that won't be in the scaffold manifest
+        fs.mkdirSync('.ai', { recursive: true });
+        fs.writeFileSync(path.join('.ai', 'agent.adf'), 'ADF: 0.1\n\nCONTEXT:\n  - Agent rules\n');
+        fs.writeFileSync(path.join('.ai', 'persona.adf'), 'ADF: 0.1\n\nCONTEXT:\n  - Persona rules\n');
+        const exitCode = await (0, bootstrap_1.bootstrapCommand)({ ...baseOptions, yes: true }, ['--yes', '--preset', 'worker', '--skip-install', '--skip-doctor']);
+        (0, vitest_1.expect)(exitCode).toBe(0);
+        // Should warn about the two unregistered modules
+        const orphanWarning = logs.find(l => l.includes('unregistered .adf module'));
+        (0, vitest_1.expect)(orphanWarning).toBeDefined();
+        (0, vitest_1.expect)(orphanWarning).toContain('agent.adf');
+        (0, vitest_1.expect)(orphanWarning).toContain('persona.adf');
+        // In --yes mode, orphans should be auto-registered in manifest
+        const registerLog = logs.find(l => l.includes('Registered 2 module(s) as ON_DEMAND'));
+        (0, vitest_1.expect)(registerLog).toBeDefined();
+        // Verify manifest contains the orphan entries
+        const manifest = fs.readFileSync(path.join('.ai', 'manifest.adf'), 'utf-8');
+        (0, vitest_1.expect)(manifest).toContain('agent.adf');
+        (0, vitest_1.expect)(manifest).toContain('persona.adf');
+    });
+});
+//# sourceMappingURL=bootstrap.test.js.map

package/dist/__tests__/bootstrap.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.test.js","sourceRoot":"","sources":["../../src/__tests__/bootstrap.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/integration/precommit-hook.test.js

@@ -170,7 +170,7 @@ function writeHookFixtureRepo(tmp) {
 // v3 Pre-commit Hook Simulation
 // ============================================================================
 (0, vitest_1.describe)('pre-commit hook auto-tidy (integration)', () => {
-    (0, vitest_1.it)('auto-tidies bloated CLAUDE.md during git commit', { timeout: 30000 }, () => {
+    (0, vitest_1.it)('auto-tidies bloated CLAUDE.md during git commit', { timeout: 60000 }, () => {
         const tmp = makeTempDir('hook-tidy');
         writeHookFixtureRepo(tmp);
         // Inject bloat into CLAUDE.md
@@ -197,7 +197,7 @@ function writeHookFixtureRepo(tmp) {
         (0, vitest_1.expect)(finalContent).not.toContain('## Database Rules');
         (0, vitest_1.expect)(finalContent).toContain('## Environment');
     });
-    (0, vitest_1.it)('passes through cleanly when CLAUDE.md has no bloat', { timeout: 30000 }, () => {
+    (0, vitest_1.it)('passes through cleanly when CLAUDE.md has no bloat', { timeout: 60000 }, () => {
         const tmp = makeTempDir('hook-clean');
         writeHookFixtureRepo(tmp);
         // Make a trivial change to CLAUDE.md (add env item, not bloat)
@@ -210,7 +210,7 @@ function writeHookFixtureRepo(tmp) {
         const finalContent = fs.readFileSync(path.join(tmp, 'CLAUDE.md'), 'utf-8');
         (0, vitest_1.expect)(finalContent).toContain('DO NOT add rules');
     });
-    (0, vitest_1.it)('skips tidy when CHARTER_SKIP_TIDY=1 is set', { timeout: 30000 }, () => {
+    (0, vitest_1.it)('skips tidy when CHARTER_SKIP_TIDY=1 is set', { timeout: 60000 }, () => {
         const tmp = makeTempDir('hook-skip');
         writeHookFixtureRepo(tmp);
         // Inject bloat
@@ -237,7 +237,7 @@ function writeHookFixtureRepo(tmp) {
         const finalContent = fs.readFileSync(path.join(tmp, 'CLAUDE.md'), 'utf-8');
         (0, vitest_1.expect)(finalContent).toContain('## Architecture');
     });
-    (0, vitest_1.it)('re-stages modified .adf modules after tidy', { timeout: 30000 }, () => {
+    (0, vitest_1.it)('re-stages modified .adf modules after tidy', { timeout: 60000 }, () => {
         const tmp = makeTempDir('hook-restage');
         writeHookFixtureRepo(tmp);
         // Inject bloat with trigger keywords that route to backend.adf

package/dist/__tests__/score.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=score.test.d.ts.map

package/dist/__tests__/score.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/score.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/score.test.js

@@ -0,0 +1,234 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const vitest_1 = require("vitest");
+const index_1 = require("../index");
+const score_1 = require("../commands/score");
+const baseOptions = {
+    configPath: '.charter',
+    format: 'json',
+    ciMode: false,
+    yes: false,
+};
+const originalCwd = process.cwd();
+const tempDirs = [];
+(0, vitest_1.afterEach)(() => {
+    process.chdir(originalCwd);
+    while (tempDirs.length > 0) {
+        const dir = tempDirs.pop();
+        if (dir) {
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+    }
+    vitest_1.vi.restoreAllMocks();
+});
+(0, vitest_1.describe)('scoreCommand', () => {
+    (0, vitest_1.it)('gives a strong score to a well-grounded Charter-style repo', async () => {
+        const tmp = createTempRepo();
+        process.chdir(tmp);
+        fs.mkdirSync(path.join(tmp, '.ai'), { recursive: true });
+        fs.mkdirSync(path.join(tmp, '.github', 'workflows'), { recursive: true });
+        fs.mkdirSync(path.join(tmp, '.githooks'), { recursive: true });
+        fs.mkdirSync(path.join(tmp, '.codex', 'skills', 'review'), { recursive: true });
+        fs.mkdirSync(path.join(tmp, '.claude'), { recursive: true });
+        fs.mkdirSync(path.join(tmp, 'src'), { recursive: true });
+        fs.writeFileSync(path.join(tmp, 'package.json'), JSON.stringify({
+            name: 'ready-repo',
+            version: '1.0.0',
+            scripts: {
+                test: 'vitest run',
+                'test:unit': 'vitest run src/index.ts',
+            },
+        }, null, 2));
+        fs.writeFileSync(path.join(tmp, 'README.md'), `# Ready Repo
+
+See \`src/index.ts\` and \`.ai/manifest.adf\`.
+
+\`\`\`sh
+npm test
+npm run test:unit
+\`\`\`
+`);
+        fs.writeFileSync(path.join(tmp, 'CLAUDE.md'), `# Working Rules
+
+Use \`src/index.ts\` as the main entrypoint.
+Review \`.ai/manifest.adf\` before changing architecture.
+
+\`\`\`sh
+charter adf evidence --auto-measure
+\`\`\`
+`);
+        fs.writeFileSync(path.join(tmp, '.cursorrules'), `Keep edits small.
+Check \`.ai/core.adf\` and \`.ai/state.adf\` before large changes.
+`);
+        fs.writeFileSync(path.join(tmp, 'AGENTS.md'), `# Agents
+
+Coordinate ownership before parallel changes.
+Use \`npm test\` before handing work back.
+`);
+        fs.writeFileSync(path.join(tmp, '.ai', 'manifest.adf'), `ADF: 0.1
+ROLE: Repo context router
+
+DEFAULT_LOAD:
+  - core.adf
+  - state.adf
+
+ON_DEMAND:
+  - backend.adf (Triggers on: API, Node, DB)
+`);
+        fs.writeFileSync(path.join(tmp, '.ai', 'core.adf'), `ADF: 0.1
+
+CONTEXT:
+  - Service entrypoint: src/index.ts
+
+CONSTRAINTS [load-bearing]:
+  - Run npm test before merge
+  - Keep API handlers pure at the edge
+
+METRICS:
+  entry_loc: 12 / 200 [lines]
+`);
+        fs.writeFileSync(path.join(tmp, '.ai', 'state.adf'), `ADF: 0.1
+STATE:
+  CURRENT: scoring implementation is active
+  NEXT: keep docs synchronized
+`);
+        fs.writeFileSync(path.join(tmp, '.ai', 'backend.adf'), `ADF: 0.1
+CONTEXT:
+  - API routes live in src/index.ts
+`);
+        fs.writeFileSync(path.join(tmp, 'src', 'index.ts'), 'export const ready = true;\n');
+        fs.writeFileSync(path.join(tmp, '.github', 'workflows', 'ci.yml'), 'name: CI\non: [push]\n');
+        fs.writeFileSync(path.join(tmp, '.githooks', 'pre-commit'), '#!/usr/bin/env sh\nnpm test\n');
+        fs.writeFileSync(path.join(tmp, '.codex', 'skills', 'review', 'SKILL.md'), '# Review Skill\n');
+        fs.writeFileSync(path.join(tmp, '.claude', 'settings.json'), JSON.stringify({
+            permissions: {
+                allow: ['Bash(npm test)'],
+            },
+        }, null, 2));
+        const { exitCode, report } = await captureJson(() => (0, score_1.scoreCommand)(baseOptions, []));
+        (0, vitest_1.expect)(exitCode).toBe(0);
+        (0, vitest_1.expect)(report.score.grade).toBe('A');
+        (0, vitest_1.expect)(report.score.total).toBeGreaterThanOrEqual(95);
+        (0, vitest_1.expect)(findCategory(report, 'agent-config')?.score).toBe(25);
+        (0, vitest_1.expect)(findCategory(report, 'architecture')?.score).toBe(20);
+        (0, vitest_1.expect)(findCategory(report, 'governance')?.score).toBe(10);
+        (0, vitest_1.expect)(report.recommendations).not.toContainEqual(vitest_1.expect.stringContaining('charter bootstrap --yes'));
+    });
+    (0, vitest_1.it)('is registered in the top-level CLI and scores non-Charter repos without crashing', async () => {
+        const tmp = createTempRepo();
+        process.chdir(tmp);
+        fs.mkdirSync(path.join(tmp, 'src'), { recursive: true });
+        fs.mkdirSync(path.join(tmp, '.github', 'workflows'), { recursive: true });
+        fs.writeFileSync(path.join(tmp, 'package.json'), JSON.stringify({
+            name: 'plain-repo',
+            version: '1.0.0',
+            scripts: {
+                test: 'node --test',
+            },
+        }, null, 2));
+        fs.writeFileSync(path.join(tmp, 'README.md'), `# Plain Repo
+
+Main module: \`src/app.ts\`
+
+\`\`\`sh
+npm test
+\`\`\`
+`);
+        fs.writeFileSync(path.join(tmp, 'src', 'app.ts'), 'export const app = 1;\n');
+        fs.writeFileSync(path.join(tmp, '.github', 'workflows', 'ci.yml'), 'name: CI\non: [push]\n');
+        const { exitCode, report } = await captureJson(() => (0, index_1.run)(['score', '--format', 'json']));
+        (0, vitest_1.expect)(exitCode).toBe(0);
+        (0, vitest_1.expect)(report.score.total).toBeGreaterThan(0);
+        (0, vitest_1.expect)(report.recommendations.some((item) => item.includes('charter bootstrap --yes'))).toBe(true);
+        (0, vitest_1.expect)(report.recommendations.some((item) => item.includes('CLAUDE.md'))).toBe(true);
+    });
+    (0, vitest_1.it)('falls back to mtime freshness and flags stale config relative to code', async () => {
+        const tmp = createTempRepo();
+        process.chdir(tmp);
+        fs.mkdirSync(path.join(tmp, 'src'), { recursive: true });
+        fs.writeFileSync(path.join(tmp, 'package.json'), JSON.stringify({
+            name: 'stale-repo',
+            version: '1.0.0',
+            scripts: {
+                test: 'node --test',
+            },
+        }, null, 2));
+        fs.writeFileSync(path.join(tmp, 'README.md'), `# Stale Repo
+
+\`\`\`sh
+npm test
+\`\`\`
+`);
+        fs.writeFileSync(path.join(tmp, 'CLAUDE.md'), '# Repo Rules\n\nRun `npm test` before merge.\n');
+        fs.writeFileSync(path.join(tmp, '.cursorrules'), 'Keep changes localized.\n');
+        fs.writeFileSync(path.join(tmp, 'AGENTS.md'), '# Agents\n\nCoordinate work.\n');
+        fs.writeFileSync(path.join(tmp, 'src', 'app.ts'), 'export const stale = true;\n');
+        const oldDate = new Date(Date.now() - (160 * 24 * 60 * 60 * 1000));
+        const newDate = new Date(Date.now() - (2 * 24 * 60 * 60 * 1000));
+        for (const file of ['CLAUDE.md', '.cursorrules', 'AGENTS.md']) {
+            fs.utimesSync(path.join(tmp, file), oldDate, oldDate);
+        }
+        fs.utimesSync(path.join(tmp, 'src', 'app.ts'), newDate, newDate);
+        const { report } = await captureJson(() => (0, score_1.scoreCommand)(baseOptions, []));
+        (0, vitest_1.expect)(report.signals.freshness.strategy).toBe('mtime');
+        (0, vitest_1.expect)((report.signals.freshness.deltaDays || 0)).toBeGreaterThan(100);
+        (0, vitest_1.expect)(findCategory(report, 'freshness')?.score).toBeLessThanOrEqual(2);
+        (0, vitest_1.expect)(report.recommendations.some((item) => item.includes('Refresh agent config after recent code changes'))).toBe(true);
+    });
+});
+function createTempRepo() {
+    const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'charter-score-test-'));
+    tempDirs.push(tmp);
+    return tmp;
+}
+async function captureJson(runCommand) {
+    const logs = [];
+    vitest_1.vi.spyOn(console, 'log').mockImplementation((message) => {
+        logs.push(String(message ?? ''));
+    });
+    const exitCode = await runCommand();
+    return {
+        exitCode,
+        report: JSON.parse(logs[0]),
+    };
+}
+function findCategory(report, id) {
+    return report.categories.find((category) => category.id === id);
+}
+//# sourceMappingURL=score.test.js.map

package/dist/__tests__/score.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.test.js","sourceRoot":"","sources":["../../src/__tests__/score.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/adf-tidy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adf-tidy.d.ts","sourceRoot":"","sources":["../../src/commands/adf-tidy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAwE3C,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwHzF"}
+{"version":3,"file":"adf-tidy.d.ts","sourceRoot":"","sources":["../../src/commands/adf-tidy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAwE3C,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwHzF"}

package/dist/commands/adf-tidy.js

@@ -220,7 +220,9 @@ function extractBeyondPointer(content, fileName) {
     const template = getPointerTemplates()[baseName];
     if (!template)
         return '';
-    const lines = content.split('\n');
+    // Strip charter-managed sentinel blocks before scanning for bloat.
+    // Without this, tidy treats the module index table as user-authored content.
+    const lines = (0, adf_1.stripCharterSentinels)(content).split('\n');
     const bloatLines = [];
     let inEnvironmentSection = false;
     let inPointerHeader = true; // Start true — skip the pointer preamble
@@ -254,13 +256,14 @@ function extractBeyondPointer(content, fileName) {
         }
         // Section detection
         if (trimmed.startsWith('## ')) {
-            if (trimmed === '## Environment') {
+            // Environment and Module Index are charter-managed retained sections — not bloat (#71)
+            if (trimmed === '## Environment' || trimmed === '## Module Index') {
                 inEnvironmentSection = true;
                 continue;
             }
             else {
                 inEnvironmentSection = false;
-                // Non-Environment H2 section = bloat
+                // Non-retained H2 section = bloat
                 bloatLines.push(line);
                 continue;
             }