@stackbilt/cli 0.7.0 → 0.9.1

package/dist/__tests__/adf-context.test.d.ts

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

package/dist/__tests__/adf-context.test.d.ts.map

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

package/dist/__tests__/adf-context.test.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const adf_context_1 = require("../commands/adf-context");
+(0, vitest_1.describe)('filePathToKeywords', () => {
+    (0, vitest_1.it)('extracts react/frontend keywords from .tsx files', () => {
+        const kw = (0, adf_context_1.filePathToKeywords)(['src/components/Button.tsx']);
+        (0, vitest_1.expect)(kw).toContain('react');
+        (0, vitest_1.expect)(kw).toContain('frontend');
+    });
+    (0, vitest_1.it)('extracts css/frontend keywords from .css files', () => {
+        const kw = (0, adf_context_1.filePathToKeywords)(['src/styles/main.css']);
+        (0, vitest_1.expect)(kw).toContain('css');
+        (0, vitest_1.expect)(kw).toContain('frontend');
+    });
+    (0, vitest_1.it)('extracts api/backend keywords from api directory paths', () => {
+        const kw = (0, adf_context_1.filePathToKeywords)(['src/api/handler.ts']);
+        (0, vitest_1.expect)(kw).toContain('api');
+        (0, vitest_1.expect)(kw).toContain('backend');
+    });
+    (0, vitest_1.it)('extracts test/qa keywords from test directory paths', () => {
+        const kw = (0, adf_context_1.filePathToKeywords)(['src/__tests__/foo.test.ts']);
+        (0, vitest_1.expect)(kw).toContain('test');
+        (0, vitest_1.expect)(kw).toContain('qa');
+    });
+    (0, vitest_1.it)('extracts deploy/infra keywords from infra directories', () => {
+        const kw = (0, adf_context_1.filePathToKeywords)(['deploy/Dockerfile']);
+        (0, vitest_1.expect)(kw).toContain('deploy');
+        (0, vitest_1.expect)(kw).toContain('infra');
+    });
+    (0, vitest_1.it)('extracts auth/security keywords from auth directories', () => {
+        const kw = (0, adf_context_1.filePathToKeywords)(['src/auth/session.ts']);
+        (0, vitest_1.expect)(kw).toContain('auth');
+        (0, vitest_1.expect)(kw).toContain('security');
+    });
+    (0, vitest_1.it)('extracts db/backend keywords from .prisma files', () => {
+        const kw = (0, adf_context_1.filePathToKeywords)(['prisma/schema.prisma']);
+        (0, vitest_1.expect)(kw).toContain('db');
+        (0, vitest_1.expect)(kw).toContain('backend');
+    });
+    (0, vitest_1.it)('deduplicates keywords across multiple files', () => {
+        const kw = (0, adf_context_1.filePathToKeywords)(['src/components/A.tsx', 'src/components/B.tsx']);
+        const reactCount = kw.filter(k => k === 'react').length;
+        (0, vitest_1.expect)(reactCount).toBe(1);
+    });
+    (0, vitest_1.it)('returns empty array for unknown file types and directories', () => {
+        const kw = (0, adf_context_1.filePathToKeywords)(['README.md']);
+        (0, vitest_1.expect)(kw).toHaveLength(0);
+    });
+    (0, vitest_1.it)('extracts cloudflare/deploy keywords from wrangler.toml', () => {
+        const kw = (0, adf_context_1.filePathToKeywords)(['wrangler.toml']);
+        (0, vitest_1.expect)(kw).toContain('deploy');
+        (0, vitest_1.expect)(kw).toContain('cloudflare');
+    });
+    (0, vitest_1.it)('handles component directory signal', () => {
+        const kw = (0, adf_context_1.filePathToKeywords)(['src/ui/widget/DatePicker.ts']);
+        (0, vitest_1.expect)(kw).toContain('frontend');
+    });
+});
+//# sourceMappingURL=adf-context.test.js.map

package/dist/__tests__/adf-context.test.js.map

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

package/dist/__tests__/integration/evidence-contracts.test.js

@@ -77,22 +77,22 @@ const ciOptions = {
 function writeEvidenceFixture(tmp, actualLines, baseline, ceiling) {
     fs.mkdirSync(path.join(tmp, '.ai'), { recursive: true });
     fs.mkdirSync(path.join(tmp, 'src'), { recursive: true });
-    fs.writeFileSync(path.join(tmp, '.ai', 'manifest.adf'), `ADF: 0.1
-
-📦 DEFAULT_LOAD:
-  - core.adf
-  - state.adf
-
-💰 BUDGET:
-  MAX_TOKENS: 4000
-
-📊 METRICS:
-  APP_LOC: src/app.ts
+    fs.writeFileSync(path.join(tmp, '.ai', 'manifest.adf'), `ADF: 0.1
+
+📦 DEFAULT_LOAD:
+  - core.adf
+  - state.adf
+
+💰 BUDGET:
+  MAX_TOKENS: 4000
+
+📊 METRICS:
+  APP_LOC: src/app.ts
 `);
-    fs.writeFileSync(path.join(tmp, '.ai', 'core.adf'), `ADF: 0.1
-
-📊 METRICS:
-  app_loc: ${baseline} / ${ceiling} [lines]
+    fs.writeFileSync(path.join(tmp, '.ai', 'core.adf'), `ADF: 0.1
+
+📊 METRICS:
+  app_loc: ${baseline} / ${ceiling} [lines]
 `);
     fs.writeFileSync(path.join(tmp, '.ai', 'state.adf'), 'ADF: 0.1\n\n📋 STATE:\n  - CURRENT: testing\n');
     // Write a source file with exactly `actualLines` lines

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

@@ -77,39 +77,39 @@ function writeHookFixtureRepo(tmp) {
     // ADF structure
     fs.mkdirSync(path.join(tmp, '.ai'), { recursive: true });
     fs.mkdirSync(path.join(tmp, '.charter'), { recursive: true });
-    fs.writeFileSync(path.join(tmp, '.ai', 'manifest.adf'), `ADF: 0.1
-
-📦 DEFAULT_LOAD:
-  - core.adf
-  - state.adf
-
-📂 ON_DEMAND:
-  - backend.adf (Triggers on: database, API, migration)
-
-💰 BUDGET:
-  MAX_TOKENS: 4000
+    fs.writeFileSync(path.join(tmp, '.ai', 'manifest.adf'), `ADF: 0.1
+
+📦 DEFAULT_LOAD:
+  - core.adf
+  - state.adf
+
+📂 ON_DEMAND:
+  - backend.adf (Triggers on: database, API, migration)
+
+💰 BUDGET:
+  MAX_TOKENS: 4000
 `);
-    fs.writeFileSync(path.join(tmp, '.ai', 'core.adf'), `ADF: 0.1
-
-📐 RULES:
-  - All changes require tests
+    fs.writeFileSync(path.join(tmp, '.ai', 'core.adf'), `ADF: 0.1
+
+📐 RULES:
+  - All changes require tests
 `);
     fs.writeFileSync(path.join(tmp, '.ai', 'state.adf'), 'ADF: 0.1\n\n📋 STATE:\n  - CURRENT: testing\n');
-    fs.writeFileSync(path.join(tmp, '.ai', 'backend.adf'), `ADF: 0.1
-
-📐 RULES:
-  - Database access through repository pattern
+    fs.writeFileSync(path.join(tmp, '.ai', 'backend.adf'), `ADF: 0.1
+
+📐 RULES:
+  - Database access through repository pattern
 `);
     // Clean thin pointer
-    fs.writeFileSync(path.join(tmp, 'CLAUDE.md'), `# CLAUDE.md
-
-> **DO NOT add rules, constraints, or context to this file.**
-> This file is auto-managed by Charter. All project rules live in \`.ai/\`.
-> New rules should be added to the appropriate \`.ai/*.adf\` module.
-> See \`.ai/manifest.adf\` for the module routing manifest.
-
-## Environment
-- Node 20
+    fs.writeFileSync(path.join(tmp, 'CLAUDE.md'), `# CLAUDE.md
+
+> **DO NOT add rules, constraints, or context to this file.**
+> This file is auto-managed by Charter. All project rules live in \`.ai/\`.
+> New rules should be added to the appropriate \`.ai/*.adf\` module.
+> See \`.ai/manifest.adf\` for the module routing manifest.
+
+## Environment
+- Node 20
 `);
     // Pre-commit hook — simplified version that just runs tidy
     const hookDir = path.join(tmp, '.githooks');
@@ -174,15 +174,15 @@ function writeHookFixtureRepo(tmp) {
         const tmp = makeTempDir('hook-tidy');
         writeHookFixtureRepo(tmp);
         // Inject bloat into CLAUDE.md
-        const bloatedContent = fs.readFileSync(path.join(tmp, 'CLAUDE.md'), 'utf-8') + `
-## Architecture
-- Layered architecture with repository pattern
-- All database queries go through the repository layer
-- API endpoints validate input before processing
-
-## Database Rules
-- All database migrations must be reversible
-- Schema changes require migration scripts
+        const bloatedContent = fs.readFileSync(path.join(tmp, 'CLAUDE.md'), 'utf-8') + `
+## Architecture
+- Layered architecture with repository pattern
+- All database queries go through the repository layer
+- API endpoints validate input before processing
+
+## Database Rules
+- All database migrations must be reversible
+- Schema changes require migration scripts
 `;
         fs.writeFileSync(path.join(tmp, 'CLAUDE.md'), bloatedContent);
         // Stage and commit — hook should auto-tidy
@@ -214,9 +214,9 @@ function writeHookFixtureRepo(tmp) {
         const tmp = makeTempDir('hook-skip');
         writeHookFixtureRepo(tmp);
         // Inject bloat
-        const bloatedContent = fs.readFileSync(path.join(tmp, 'CLAUDE.md'), 'utf-8') + `
-## Architecture
-- Layered architecture pattern
+        const bloatedContent = fs.readFileSync(path.join(tmp, 'CLAUDE.md'), 'utf-8') + `
+## Architecture
+- Layered architecture pattern
 `;
         fs.writeFileSync(path.join(tmp, 'CLAUDE.md'), bloatedContent);
         // Stage and commit with skip flag
@@ -241,11 +241,11 @@ function writeHookFixtureRepo(tmp) {
         const tmp = makeTempDir('hook-restage');
         writeHookFixtureRepo(tmp);
         // Inject bloat with trigger keywords that route to backend.adf
-        const bloatedContent = fs.readFileSync(path.join(tmp, 'CLAUDE.md'), 'utf-8') + `
-## Database Rules
-- All database migrations must be reversible
-- Schema changes require migration scripts
-- API rate limiting applies to all database endpoints
+        const bloatedContent = fs.readFileSync(path.join(tmp, 'CLAUDE.md'), 'utf-8') + `
+## Database Rules
+- All database migrations must be reversible
+- Schema changes require migration scripts
+- API rate limiting applies to all database endpoints
 `;
         fs.writeFileSync(path.join(tmp, 'CLAUDE.md'), bloatedContent);
         // Record pre-commit state of backend.adf

package/dist/__tests__/integration/sync-bundle.test.js

@@ -67,48 +67,48 @@ const jsonOptions = {
 /** Write a minimal ADF repo with SYNC entries */
 function writeSyncFixture(tmp) {
     fs.mkdirSync(path.join(tmp, '.ai'), { recursive: true });
-    fs.writeFileSync(path.join(tmp, '.ai', 'manifest.adf'), `ADF: 0.1
-
-📦 DEFAULT_LOAD:
-  - core.adf
-  - state.adf
-
-🔄 SYNC:
-  - core.adf -> CLAUDE.md
+    fs.writeFileSync(path.join(tmp, '.ai', 'manifest.adf'), `ADF: 0.1
+
+📦 DEFAULT_LOAD:
+  - core.adf
+  - state.adf
+
+🔄 SYNC:
+  - core.adf -> CLAUDE.md
 `);
-    fs.writeFileSync(path.join(tmp, '.ai', 'core.adf'), `ADF: 0.1
-
-📐 RULES:
-  - All changes require tests
+    fs.writeFileSync(path.join(tmp, '.ai', 'core.adf'), `ADF: 0.1
+
+📐 RULES:
+  - All changes require tests
 `);
     fs.writeFileSync(path.join(tmp, '.ai', 'state.adf'), 'ADF: 0.1\n\n📋 STATE:\n  - CURRENT: testing\n');
 }
 /** Write a bundle fixture with on-demand modules */
 function writeBundleFixture(tmp, opts = {}) {
     fs.mkdirSync(path.join(tmp, '.ai'), { recursive: true });
-    fs.writeFileSync(path.join(tmp, '.ai', 'manifest.adf'), `ADF: 0.1
-
-📦 DEFAULT_LOAD:
-  - core.adf
-  - state.adf
-
-📂 ON_DEMAND:
-  - backend.adf (Triggers on: database, API, migration)
-
-💰 BUDGET:
-  MAX_TOKENS: 4000
+    fs.writeFileSync(path.join(tmp, '.ai', 'manifest.adf'), `ADF: 0.1
+
+📦 DEFAULT_LOAD:
+  - core.adf
+  - state.adf
+
+📂 ON_DEMAND:
+  - backend.adf (Triggers on: database, API, migration)
+
+💰 BUDGET:
+  MAX_TOKENS: 4000
 `);
-    fs.writeFileSync(path.join(tmp, '.ai', 'core.adf'), `ADF: 0.1
-
-📐 RULES:
-  - All changes require tests
+    fs.writeFileSync(path.join(tmp, '.ai', 'core.adf'), `ADF: 0.1
+
+📐 RULES:
+  - All changes require tests
 `);
     fs.writeFileSync(path.join(tmp, '.ai', 'state.adf'), 'ADF: 0.1\n\n📋 STATE:\n  - CURRENT: testing\n');
     if (opts.includeOnDemandFile) {
-        fs.writeFileSync(path.join(tmp, '.ai', 'backend.adf'), `ADF: 0.1
-
-📐 RULES:
-  - Database access through repository pattern
+        fs.writeFileSync(path.join(tmp, '.ai', 'backend.adf'), `ADF: 0.1
+
+📐 RULES:
+  - Database access through repository pattern
 `);
     }
 }

package/dist/__tests__/integration/vendor-bloat.test.js

@@ -78,61 +78,61 @@ const ciOptions = {
 function writeFixtureRepo(tmp) {
     fs.mkdirSync(path.join(tmp, '.ai'), { recursive: true });
     fs.mkdirSync(path.join(tmp, '.charter'), { recursive: true });
-    fs.writeFileSync(path.join(tmp, '.ai', 'manifest.adf'), `ADF: 0.1
-
-📐 RULES:
-  - Test manifest
-
-📦 DEFAULT_LOAD:
-  - core.adf
-  - state.adf
-
-📂 ON_DEMAND:
-  - backend.adf (Triggers on: database, API, migration, schema)
-  - frontend.adf (Triggers on: component, React, CSS, layout)
-
-💰 BUDGET:
-  MAX_TOKENS: 4000
+    fs.writeFileSync(path.join(tmp, '.ai', 'manifest.adf'), `ADF: 0.1
+
+📐 RULES:
+  - Test manifest
+
+📦 DEFAULT_LOAD:
+  - core.adf
+  - state.adf
+
+📂 ON_DEMAND:
+  - backend.adf (Triggers on: database, API, migration, schema)
+  - frontend.adf (Triggers on: component, React, CSS, layout)
+
+💰 BUDGET:
+  MAX_TOKENS: 4000
 `);
-    fs.writeFileSync(path.join(tmp, '.ai', 'core.adf'), `ADF: 0.1
-
-📁 STRUCTURE:
-  - src/ — source code
-
-📐 CONSTRAINTS: [load-bearing]
-  - All changes require tests
+    fs.writeFileSync(path.join(tmp, '.ai', 'core.adf'), `ADF: 0.1
+
+📁 STRUCTURE:
+  - src/ — source code
+
+📐 CONSTRAINTS: [load-bearing]
+  - All changes require tests
 `);
-    fs.writeFileSync(path.join(tmp, '.ai', 'state.adf'), `ADF: 0.1
-
-📋 STATE:
-  - CURRENT: testing
+    fs.writeFileSync(path.join(tmp, '.ai', 'state.adf'), `ADF: 0.1
+
+📋 STATE:
+  - CURRENT: testing
 `);
     // On-demand module stubs (so doctor doesn't warn about missing modules)
-    fs.writeFileSync(path.join(tmp, '.ai', 'backend.adf'), `ADF: 0.1
-
-📐 RULES:
-  - Database access goes through repository layer
+    fs.writeFileSync(path.join(tmp, '.ai', 'backend.adf'), `ADF: 0.1
+
+📐 RULES:
+  - Database access goes through repository layer
 `);
-    fs.writeFileSync(path.join(tmp, '.ai', 'frontend.adf'), `ADF: 0.1
-
-📐 RULES:
-  - Components use .tsx extension
+    fs.writeFileSync(path.join(tmp, '.ai', 'frontend.adf'), `ADF: 0.1
+
+📐 RULES:
+  - Components use .tsx extension
 `);
     // Init git repo so doctor's git check passes
     (0, node_child_process_1.execFileSync)('git', ['init'], { cwd: tmp, stdio: 'ignore' });
 }
 /** Write a clean thin-pointer CLAUDE.md */
 function writeCleanPointer(tmp) {
-    fs.writeFileSync(path.join(tmp, 'CLAUDE.md'), `# CLAUDE.md
-
-> **DO NOT add rules, constraints, or context to this file.**
-> This file is auto-managed by Charter. All project rules live in \`.ai/\`.
-> New rules should be added to the appropriate \`.ai/*.adf\` module.
-> See \`.ai/manifest.adf\` for the module routing manifest.
-
-## Environment
-- Node 20
-- pnpm 9
+    fs.writeFileSync(path.join(tmp, 'CLAUDE.md'), `# CLAUDE.md
+
+> **DO NOT add rules, constraints, or context to this file.**
+> This file is auto-managed by Charter. All project rules live in \`.ai/\`.
+> New rules should be added to the appropriate \`.ai/*.adf\` module.
+> See \`.ai/manifest.adf\` for the module routing manifest.
+
+## Environment
+- Node 20
+- pnpm 9
 `);
 }
 /**
@@ -140,36 +140,36 @@ function writeCleanPointer(tmp) {
  * architecture rules, trigger-heavy content, and non-Environment H2s.
  */
 function writeBloatedPointer(tmp) {
-    fs.writeFileSync(path.join(tmp, 'CLAUDE.md'), `# CLAUDE.md
-
-> **DO NOT add rules, constraints, or context to this file.**
-> This file is auto-managed by Charter. All project rules live in \`.ai/\`.
-> New rules should be added to the appropriate \`.ai/*.adf\` module.
-> See \`.ai/manifest.adf\` for the module routing manifest.
-
-## Environment
-- Node 20
-- pnpm 9
-
-## Architecture
-- The project uses a layered architecture pattern
-- All database queries go through the repository layer
-- API endpoints must validate input before processing
-
-## Build Commands
-- Run \`pnpm build\` for production
-- Run \`pnpm test\` for the test suite
-
-## Database Rules
-- All database migrations must be reversible
-- Schema changes require migration scripts
-- Database connections use connection pooling
-- API rate limiting applies to all database endpoints
-
-## Frontend Standards
-- All React component files use .tsx extension
-- CSS modules for component-scoped styles
-- Layout components handle responsive breakpoints
+    fs.writeFileSync(path.join(tmp, 'CLAUDE.md'), `# CLAUDE.md
+
+> **DO NOT add rules, constraints, or context to this file.**
+> This file is auto-managed by Charter. All project rules live in \`.ai/\`.
+> New rules should be added to the appropriate \`.ai/*.adf\` module.
+> See \`.ai/manifest.adf\` for the module routing manifest.
+
+## Environment
+- Node 20
+- pnpm 9
+
+## Architecture
+- The project uses a layered architecture pattern
+- All database queries go through the repository layer
+- API endpoints must validate input before processing
+
+## Build Commands
+- Run \`pnpm build\` for production
+- Run \`pnpm test\` for the test suite
+
+## Database Rules
+- All database migrations must be reversible
+- Schema changes require migration scripts
+- Database connections use connection pooling
+- API rate limiting applies to all database endpoints
+
+## Frontend Standards
+- All React component files use .tsx extension
+- CSS modules for component-scoped styles
+- Layout components handle responsive breakpoints
 `);
 }
 /** Capture console.log output during a command invocation */

package/dist/commands/adf-context.d.ts

@@ -0,0 +1,14 @@
+/**
+ * charter adf context
+ *
+ * Resolves ADF modules based on file paths and/or explicit keywords.
+ * Outputs the resolved module list and optionally the bundled context.
+ */
+import type { CLIOptions } from '../index';
+/**
+ * Extract keywords from file paths using extension and directory signals.
+ * Maps file system structure to domain keywords for module resolution.
+ */
+export declare function filePathToKeywords(filePaths: string[]): string[];
+export declare function adfContextCommand(options: CLIOptions, args: string[]): number;
+//# sourceMappingURL=adf-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adf-context.d.ts","sourceRoot":"","sources":["../../src/commands/adf-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAqBhE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CA0E7E"}

package/dist/commands/adf-context.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * charter adf context
+ *
+ * Resolves ADF modules based on file paths and/or explicit keywords.
+ * Outputs the resolved module list and optionally the bundled context.
+ */
+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 });
+exports.filePathToKeywords = filePathToKeywords;
+exports.adfContextCommand = adfContextCommand;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const adf_1 = require("@stackbilt/adf");
+const index_1 = require("../index");
+const flags_1 = require("../flags");
+/**
+ * Extract keywords from file paths using extension and directory signals.
+ * Maps file system structure to domain keywords for module resolution.
+ */
+function filePathToKeywords(filePaths) {
+    const keywords = [];
+    for (const fp of filePaths) {
+        const ext = path.extname(fp).slice(1).toLowerCase();
+        const dir = path.dirname(fp).toLowerCase();
+        // Extension signals
+        if (['tsx', 'jsx'].includes(ext))
+            keywords.push('react', 'ui', 'frontend');
+        if (['css', 'scss', 'sass', 'less'].includes(ext))
+            keywords.push('css', 'ui', 'frontend');
+        if (['prisma'].includes(ext))
+            keywords.push('db', 'backend');
+        if (['sql'].includes(ext))
+            keywords.push('db', 'migration');
+        if (ext === 'toml' && fp.includes('wrangler'))
+            keywords.push('deploy', 'cloudflare');
+        // Directory signals
+        if (/\b(component|ui|widget|page|layout|view)\b/.test(dir))
+            keywords.push('frontend', 'ui');
+        if (/\b(api|server|handler|route|middleware|controller)\b/.test(dir))
+            keywords.push('api', 'backend');
+        if (/\b(test|spec|__tests__|e2e)\b/.test(dir))
+            keywords.push('test', 'qa');
+        if (/\b(deploy|infra|docker|ci|\.github)\b/.test(dir))
+            keywords.push('deploy', 'infra');
+        if (/\b(auth|session|permission)\b/.test(dir))
+            keywords.push('auth', 'security');
+    }
+    return [...new Set(keywords)];
+}
+function adfContextCommand(options, args) {
+    const filesFlag = (0, flags_1.getFlag)(args, '--files');
+    const keywordsFlag = (0, flags_1.getFlag)(args, '--keywords');
+    const aiDir = (0, flags_1.getFlag)(args, '--ai-dir') || '.ai';
+    const bundle = args.includes('--bundle');
+    if (!filesFlag && !keywordsFlag) {
+        throw new index_1.CLIError('adf context requires --files <path,...> and/or --keywords <kw,...>.\n' +
+            'Usage: charter adf context --files src/components/Button.tsx,src/api/handler.ts');
+    }
+    const manifestPath = path.join(aiDir, 'manifest.adf');
+    if (!fs.existsSync(manifestPath)) {
+        throw new index_1.CLIError(`manifest.adf not found at ${manifestPath}. Run: charter adf init`);
+    }
+    // Collect keywords from both sources
+    const allKeywords = [];
+    if (filesFlag) {
+        const filePaths = filesFlag.split(',').map(f => f.trim()).filter(Boolean);
+        allKeywords.push(...filePathToKeywords(filePaths));
+    }
+    if (keywordsFlag) {
+        allKeywords.push(...(0, flags_1.tokenizeTask)(keywordsFlag));
+    }
+    const dedupKeywords = [...new Set(allKeywords)];
+    const manifestContent = fs.readFileSync(manifestPath, 'utf-8');
+    const manifestDoc = (0, adf_1.parseAdf)(manifestContent);
+    const manifest = (0, adf_1.parseManifest)(manifestDoc);
+    const resolvedModules = (0, adf_1.resolveModules)(manifest, dedupKeywords);
+    if (bundle) {
+        // Full bundle output
+        const readFile = (modulePath) => {
+            const fullPath = path.join(aiDir, modulePath);
+            return fs.readFileSync(fullPath, 'utf-8');
+        };
+        const result = (0, adf_1.bundleModules)(aiDir, resolvedModules, readFile, dedupKeywords, manifest);
+        if (options.format === 'json') {
+            console.log(JSON.stringify({
+                keywords: dedupKeywords,
+                resolvedModules: result.resolvedModules,
+                tokenEstimate: result.tokenEstimate,
+                triggerMatches: result.triggerMatches,
+                content: (0, adf_1.formatAdf)(result.mergedDocument),
+            }, null, 2));
+        }
+        else {
+            console.log((0, adf_1.formatAdf)(result.mergedDocument));
+        }
+    }
+    else {
+        // Module list only
+        if (options.format === 'json') {
+            console.log(JSON.stringify({
+                keywords: dedupKeywords,
+                resolvedModules,
+            }, null, 2));
+        }
+        else {
+            console.log(`  Keywords: ${dedupKeywords.join(', ')}`);
+            console.log(`  Resolved modules:`);
+            for (const mod of resolvedModules) {
+                const isDefault = manifest.defaultLoad.includes(mod);
+                console.log(`    ${mod} (${isDefault ? 'DEFAULT' : 'ON_DEMAND'})`);
+            }
+        }
+    }
+    return index_1.EXIT_CODE.SUCCESS;
+}
+//# sourceMappingURL=adf-context.js.map