@stackbilt/cli 0.3.2 → 0.4.0

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

@@ -1 +1 @@
-{"version":3,"file":"adf.d.ts","sourceRoot":"","sources":["../../src/commands/adf.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAiD3C,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBrF"}
+{"version":3,"file":"adf.d.ts","sourceRoot":"","sources":["../../src/commands/adf.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAW3C,eAAO,MAAM,iBAAiB,0VAc7B,CAAC;AAEF,eAAO,MAAM,aAAa,k3BAmBzB,CAAC;AAEF,eAAO,MAAM,cAAc,mJAI1B,CAAC;AAMF,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BrF;AAeD,eAAO,MAAM,iBAAiB,2bAU7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,oSAO/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,8UAU7B,CAAC"}

package/dist/commands/adf.js

@@ -2,7 +2,7 @@
 /**
  * charter adf
  *
- * ADF (Attention-Directed Format) subcommands: init, fmt, patch, bundle, sync.
+ * ADF (Attention-Directed Format) subcommands: init, fmt, patch, bundle, sync, evidence, migrate.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -38,16 +38,20 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.POINTER_AGENTS_MD = exports.POINTER_CURSORRULES = exports.POINTER_CLAUDE_MD = exports.STATE_SCAFFOLD = exports.CORE_SCAFFOLD = exports.MANIFEST_SCAFFOLD = void 0;
 exports.adfCommand = adfCommand;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
-const crypto = __importStar(require("node:crypto"));
 const adf_1 = require("@stackbilt/adf");
 const index_1 = require("../index");
+const adf_migrate_1 = require("./adf-migrate");
+const adf_bundle_1 = require("./adf-bundle");
+const adf_sync_1 = require("./adf-sync");
+const adf_evidence_1 = require("./adf-evidence");
 // ============================================================================
 // Scaffold Content
 // ============================================================================
-const MANIFEST_SCAFFOLD = `ADF: 0.1
+exports.MANIFEST_SCAFFOLD = `ADF: 0.1
 \u{1F3AF} ROLE: Repo context router
 
 \u{1F4E6} DEFAULT_LOAD:
@@ -62,22 +66,27 @@ const MANIFEST_SCAFFOLD = `ADF: 0.1
   - Prefer smallest relevant module set.
   - Never assume unseen modules were loaded.
 `;
-const CORE_SCAFFOLD = `ADF: 0.1
-\u{1F3AF} TASK: Define universal repository rules
+exports.CORE_SCAFFOLD = `ADF: 0.1
 
-\u{2699}\u{FE0F} CONTEXT:
-  - This file is loaded by default for every task.
-  - Keep it lean — add domain-specific rules to on-demand modules.
+\u{1F4D6} GUIDE [advisory]:
+  - Pure runtime/environment? (OS, line endings) \u2192 CLAUDE.md, not ADF
+  - Universal architecture constraint? \u2192 core.adf CONSTRAINTS [load-bearing]
+  - Stack-specific operational rule? \u2192 domain .adf module (backend.adf, frontend.adf)
+  - Agent identity/behavior? \u2192 core.adf CONTEXT
+  - Language/tooling discipline? \u2192 core.adf CONSTRAINTS or dedicated section
+  - [load-bearing] = violation causes incorrect output
+  - [advisory] = best practice, not enforced
+  - Section types are open: CONTEXT, CONSTRAINTS, ADVISORY, METRICS, custom
 
-\u{26A0}\u{FE0F} CONSTRAINTS [load-bearing]:
-  - Follow conventional commits.
-  - No secrets in source code.
-  - Prefer pure functions in library code.
+\u26A0\uFE0F CONSTRAINTS [load-bearing]:
+  - Use Conventional Commits (feat, fix, docs, chore)
+  - Never commit secrets or credentials
+  - Pure functions in library code; side effects only in entry points
 
-\u{1F4CA} METRICS [load-bearing]:
+\uD83D\uDCCA METRICS:
   entry_loc: 0 / 500 [lines]
 `;
-const STATE_SCAFFOLD = `ADF: 0.1
+exports.STATE_SCAFFOLD = `ADF: 0.1
 \u{1F9E0} STATE:
   CURRENT: Repository initialized with ADF context system
   NEXT: Configure on-demand modules for your stack
@@ -100,15 +109,48 @@ async function adfCommand(options, args) {
         case 'patch':
             return adfPatch(options, restArgs);
         case 'bundle':
-            return adfBundle(options, restArgs);
+            return (0, adf_bundle_1.adfBundle)(options, restArgs);
         case 'sync':
-            return adfSync(options, restArgs);
+            return (0, adf_sync_1.adfSync)(options, restArgs);
         case 'evidence':
-            return adfEvidence(options, restArgs);
+            return (0, adf_evidence_1.adfEvidence)(options, restArgs);
+        case 'migrate':
+            return (0, adf_migrate_1.adfMigrateCommand)(options, restArgs);
         default:
-            throw new index_1.CLIError(`Unknown adf subcommand: ${subcommand}. Supported: init, fmt, patch, bundle, sync, evidence`);
+            throw new index_1.CLIError(`Unknown adf subcommand: ${subcommand}. Supported: init, fmt, patch, bundle, sync, evidence, migrate`);
     }
 }
+// -- Thin pointer file content --
+exports.POINTER_CLAUDE_MD = `# Project Context
+
+> This project uses [ADF](https://github.com/Stackbilt-dev/charter) for AI agent context management.
+> All stack rules, constraints, and architectural guidance live in \`.ai/\`.
+> **Do not duplicate ADF rules here.** Only pre-ADF bootstrap content belongs in this file.
+
+See \`.ai/manifest.adf\` for the module routing manifest.
+
+## Environment
+<!-- Add runtime/OS/shell-specific notes here (not stack rules) -->
+`;
+exports.POINTER_CURSORRULES = `# Cursor Rules
+
+This project uses ADF (Attention-Directed Format) for context management.
+All rules and constraints are in .ai/ \u2014 see .ai/manifest.adf for routing.
+
+Do not add stack rules here. This file exists only as a pointer.
+See: .ai/core.adf for universal constraints.
+`;
+exports.POINTER_AGENTS_MD = `# Agent Guidelines
+
+This project uses ADF for structured agent context.
+All architectural rules, constraints, and guidance live in \`.ai/\`.
+
+Module manifest: .ai/manifest.adf
+Universal rules: .ai/core.adf
+Current state: .ai/state.adf
+
+Do not duplicate rules from .ai/ modules into this file or other agent config files.
+`;
 function adfInit(options, args) {
     const force = options.yes || args.includes('--force');
     const aiDir = getFlag(args, '--ai-dir') || '.ai';
@@ -125,14 +167,45 @@ function adfInit(options, args) {
         return index_1.EXIT_CODE.SUCCESS;
     }
     fs.mkdirSync(aiDir, { recursive: true });
-    fs.writeFileSync(path.join(aiDir, 'manifest.adf'), MANIFEST_SCAFFOLD);
-    fs.writeFileSync(path.join(aiDir, 'core.adf'), CORE_SCAFFOLD);
-    fs.writeFileSync(path.join(aiDir, 'state.adf'), STATE_SCAFFOLD);
+    fs.writeFileSync(path.join(aiDir, 'manifest.adf'), exports.MANIFEST_SCAFFOLD);
+    fs.writeFileSync(path.join(aiDir, 'core.adf'), exports.CORE_SCAFFOLD);
+    fs.writeFileSync(path.join(aiDir, 'state.adf'), exports.STATE_SCAFFOLD);
     const result = {
         created: true,
         aiDir,
         files: ['manifest.adf', 'core.adf', 'state.adf'],
     };
+    // --emit-pointers: generate thin pointer files that redirect to .ai/
+    const emitPointers = args.includes('--emit-pointers') || args.includes('--pointers');
+    if (emitPointers) {
+        const pointerSpecs = [
+            { file: 'CLAUDE.md', content: exports.POINTER_CLAUDE_MD, label: 'CLAUDE.md (thin pointer)' },
+            { file: '.cursorrules', content: exports.POINTER_CURSORRULES, label: '.cursorrules (thin pointer)' },
+            { file: 'agents.md', content: exports.POINTER_AGENTS_MD, label: 'agents.md (thin pointer)' },
+        ];
+        const createdPointers = [];
+        const skippedPointers = [];
+        for (const spec of pointerSpecs) {
+            if (fs.existsSync(spec.file)) {
+                skippedPointers.push(spec.file);
+            }
+            else {
+                fs.writeFileSync(spec.file, spec.content);
+                createdPointers.push(spec.file);
+                result.files.push(spec.file);
+            }
+        }
+        result.pointers = createdPointers;
+        if (options.format !== 'json') {
+            for (const p of createdPointers) {
+                const label = pointerSpecs.find(s => s.file === p)?.label ?? p;
+                console.log(`  Generated ${label}`);
+            }
+            for (const p of skippedPointers) {
+                console.log(`  Skipped ${p} (already exists)`);
+            }
+        }
+    }
     if (options.format === 'json') {
         console.log(JSON.stringify({
             ...result,
@@ -258,456 +331,6 @@ function adfPatch(options, args) {
     }
 }
 // ============================================================================
-// adf bundle
-// ============================================================================
-function adfBundle(options, args) {
-    const task = getFlag(args, '--task');
-    if (!task) {
-        throw new index_1.CLIError('adf bundle requires --task "<prompt>". Usage: charter adf bundle --task "Fix React component"');
-    }
-    const aiDir = getFlag(args, '--ai-dir') || '.ai';
-    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`);
-    }
-    const manifestContent = fs.readFileSync(manifestPath, 'utf-8');
-    const manifestDoc = (0, adf_1.parseAdf)(manifestContent);
-    const manifest = (0, adf_1.parseManifest)(manifestDoc);
-    // Tokenize task into keywords (simple word split)
-    const keywords = task
-        .split(/[\s,;:()[\]{}]+/)
-        .filter(w => w.length > 1)
-        .map(w => w.replace(/[^a-zA-Z0-9]/g, ''));
-    const modulePaths = (0, adf_1.resolveModules)(manifest, keywords);
-    const readFile = (p) => fs.readFileSync(p, 'utf-8');
-    try {
-        const result = (0, adf_1.bundleModules)(aiDir, modulePaths, readFile, keywords);
-        if (options.format === 'json') {
-            const jsonOut = {
-                task,
-                keywords,
-                resolvedModules: result.resolvedModules,
-                tokenEstimate: result.tokenEstimate,
-                tokenBudget: result.tokenBudget,
-                tokenUtilization: result.tokenUtilization,
-                perModuleTokens: result.perModuleTokens,
-                triggerMatches: result.triggerMatches,
-            };
-            if (result.unmatchedModules.length > 0) {
-                jsonOut.unmatchedModules = result.unmatchedModules;
-            }
-            if (result.moduleBudgetOverruns.length > 0) {
-                jsonOut.moduleBudgetOverruns = result.moduleBudgetOverruns;
-            }
-            if (result.advisoryOnlyModules.length > 0) {
-                jsonOut.advisoryOnlyModules = result.advisoryOnlyModules;
-            }
-            if (result.manifest.cadence.length > 0) {
-                jsonOut.cadence = result.manifest.cadence;
-            }
-            console.log(JSON.stringify(jsonOut, null, 2));
-        }
-        else {
-            console.log(`  Task: "${task}"`);
-            console.log(`  Keywords: ${keywords.join(', ')}`);
-            console.log(`  Resolved modules: ${result.resolvedModules.join(', ')}`);
-            console.log(`  Token estimate: ~${result.tokenEstimate}`);
-            if (result.tokenBudget !== null) {
-                const pct = result.tokenUtilization !== null
-                    ? ` (${(result.tokenUtilization * 100).toFixed(0)}%)`
-                    : '';
-                console.log(`  Token budget: ${result.tokenBudget}${pct}`);
-            }
-            console.log('');
-            if (result.moduleBudgetOverruns.length > 0) {
-                console.log('  Module budget overruns:');
-                for (const o of result.moduleBudgetOverruns) {
-                    console.log(`    [!] ${o.module}: ~${o.tokens} tokens (budget: ${o.budget})`);
-                }
-                console.log('');
-            }
-            if (result.triggerMatches.length > 0) {
-                console.log('  Trigger report:');
-                for (const tm of result.triggerMatches) {
-                    const icon = tm.matched ? '+' : '-';
-                    const kw = tm.matchedKeywords.length > 0 ? ` [${tm.matchedKeywords.join(', ')}]` : '';
-                    console.log(`    [${icon}] ${tm.module} (${tm.trigger})${kw}`);
-                }
-                console.log('');
-            }
-            if (result.unmatchedModules.length > 0) {
-                console.log('  Unmatched modules (not loaded):');
-                for (const m of result.unmatchedModules) {
-                    console.log(`    [-] ${m}`);
-                }
-                console.log('');
-            }
-            if (result.advisoryOnlyModules.length > 0) {
-                console.log('  Advisory-only modules:');
-                for (const m of result.advisoryOnlyModules) {
-                    console.log(`    [!] ${m}: no load-bearing sections`);
-                }
-                console.log('');
-            }
-            if (result.manifest.cadence.length > 0) {
-                console.log('  Cadence schedule:');
-                for (const c of result.manifest.cadence) {
-                    console.log(`    ${c.check}: ${c.frequency}`);
-                }
-                console.log('');
-            }
-            // Output merged document
-            const output = (0, adf_1.formatAdf)(result.mergedDocument);
-            console.log('  --- Merged Context ---');
-            console.log(output);
-        }
-        return index_1.EXIT_CODE.SUCCESS;
-    }
-    catch (e) {
-        if (e instanceof Error && e.name === 'AdfBundleError') {
-            if (options.format === 'json') {
-                console.log(JSON.stringify({ error: e.message }, null, 2));
-            }
-            else {
-                console.error(`  [error] ${e.message}`);
-            }
-            return index_1.EXIT_CODE.RUNTIME_ERROR;
-        }
-        throw e;
-    }
-}
-function adfSync(options, args) {
-    const aiDir = getFlag(args, '--ai-dir') || '.ai';
-    const checkMode = args.includes('--check');
-    const writeMode = args.includes('--write');
-    if (!checkMode && !writeMode) {
-        throw new index_1.CLIError('adf sync requires --check or --write. Usage: charter adf sync --check');
-    }
-    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`);
-    }
-    const manifestContent = fs.readFileSync(manifestPath, 'utf-8');
-    const manifestDoc = (0, adf_1.parseAdf)(manifestContent);
-    const manifest = (0, adf_1.parseManifest)(manifestDoc);
-    if (manifest.sync.length === 0) {
-        const result = {
-            aiDir,
-            lockFile: path.join(aiDir, '.adf.lock'),
-            entries: [],
-            allInSync: true,
-            written: false,
-        };
-        if (options.format === 'json') {
-            console.log(JSON.stringify(result, null, 2));
-        }
-        else {
-            console.log('  No SYNC entries in manifest. Nothing to check.');
-        }
-        return index_1.EXIT_CODE.SUCCESS;
-    }
-    const lockFile = path.join(aiDir, '.adf.lock');
-    const locked = loadLockFile(lockFile);
-    const entries = [];
-    for (const entry of manifest.sync) {
-        const sourcePath = path.join(aiDir, entry.source);
-        if (!fs.existsSync(sourcePath)) {
-            throw new index_1.CLIError(`Sync source not found: ${sourcePath}`);
-        }
-        const sourceContent = fs.readFileSync(sourcePath, 'utf-8');
-        const sourceHash = hashContent(sourceContent);
-        const lockedHash = locked[entry.source] ?? null;
-        entries.push({
-            source: entry.source,
-            target: entry.target,
-            sourceHash,
-            lockedHash,
-            inSync: lockedHash === sourceHash,
-        });
-    }
-    const allInSync = entries.every(e => e.inSync);
-    if (writeMode) {
-        const newLock = {};
-        for (const e of entries) {
-            newLock[e.source] = e.sourceHash;
-        }
-        fs.writeFileSync(lockFile, JSON.stringify(newLock, null, 2) + '\n');
-        const result = {
-            aiDir,
-            lockFile,
-            entries,
-            allInSync: true,
-            written: true,
-        };
-        if (options.format === 'json') {
-            console.log(JSON.stringify(result, null, 2));
-        }
-        else {
-            console.log(`  [ok] Updated ${lockFile} with ${entries.length} hash${entries.length === 1 ? '' : 'es'}.`);
-        }
-        return index_1.EXIT_CODE.SUCCESS;
-    }
-    // --check mode
-    const result = {
-        aiDir,
-        lockFile,
-        entries,
-        allInSync,
-        written: false,
-    };
-    if (options.format === 'json') {
-        const syncOut = { ...result };
-        if (!allInSync) {
-            syncOut.nextActions = ['Regenerate targets from source .adf files', 'charter adf sync --write'];
-        }
-        console.log(JSON.stringify(syncOut, null, 2));
-    }
-    else {
-        for (const e of entries) {
-            if (e.inSync) {
-                console.log(`  [ok] ${e.source} -> ${e.target} (in sync)`);
-            }
-            else if (e.lockedHash === null) {
-                console.log(`  [warn] ${e.source} -> ${e.target} (no lock entry — run: charter adf sync --write)`);
-            }
-            else {
-                console.log(`  [fail] ${e.source} -> ${e.target} (source changed since last sync)`);
-            }
-        }
-        if (!allInSync) {
-            console.log('');
-            console.log('  Source .adf files have changed. Regenerate targets and run: charter adf sync --write');
-        }
-    }
-    return allInSync ? index_1.EXIT_CODE.SUCCESS : index_1.EXIT_CODE.POLICY_VIOLATION;
-}
-function hashContent(content) {
-    return crypto.createHash('sha256').update(content).digest('hex').slice(0, 16);
-}
-function loadLockFile(lockFile) {
-    if (!fs.existsSync(lockFile))
-        return {};
-    try {
-        return JSON.parse(fs.readFileSync(lockFile, 'utf-8'));
-    }
-    catch {
-        return {};
-    }
-}
-function adfEvidence(options, args) {
-    const task = getFlag(args, '--task');
-    const aiDir = getFlag(args, '--ai-dir') || '.ai';
-    const contextJson = getFlag(args, '--context');
-    const contextFile = getFlag(args, '--context-file');
-    const autoMeasure = args.includes('--auto-measure');
-    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`);
-    }
-    const manifestContent = fs.readFileSync(manifestPath, 'utf-8');
-    const manifestDoc = (0, adf_1.parseAdf)(manifestContent);
-    const manifest = (0, adf_1.parseManifest)(manifestDoc);
-    // Resolve modules
-    let modulePaths;
-    let keywords = [];
-    if (task) {
-        keywords = task
-            .split(/[\s,;:()[\]{}]+/)
-            .filter(w => w.length > 1)
-            .map(w => w.replace(/[^a-zA-Z0-9]/g, ''));
-        modulePaths = (0, adf_1.resolveModules)(manifest, keywords);
-    }
-    else {
-        modulePaths = [...manifest.defaultLoad];
-    }
-    const readFile = (p) => fs.readFileSync(p, 'utf-8');
-    let context;
-    const rawContext = contextFile ? readJsonFlag(contextFile, '--context-file') : contextJson;
-    if (rawContext) {
-        try {
-            const parsed = JSON.parse(rawContext);
-            if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
-                throw new Error('must be a JSON object');
-            }
-            context = parsed;
-        }
-        catch (e) {
-            const msg = e instanceof Error ? e.message : String(e);
-            throw new index_1.CLIError(`Invalid --context JSON: ${msg}`);
-        }
-    }
-    // Auto-measure: count lines in files referenced by manifest METRICS
-    // Manifest keys are UPPERCASE (parser map disambiguation), metric keys are lowercase.
-    const autoMeasured = [];
-    if (autoMeasure && manifest.metrics.length > 0) {
-        const measured = {};
-        for (const ms of manifest.metrics) {
-            const metricKey = ms.key.toLowerCase();
-            const filePath = path.resolve(ms.path);
-            if (fs.existsSync(filePath)) {
-                const content = fs.readFileSync(filePath, 'utf-8');
-                const lines = content.split('\n').length;
-                measured[metricKey] = lines;
-                autoMeasured.push({ metric: metricKey, path: ms.path, lines });
-            }
-            else {
-                autoMeasured.push({ metric: metricKey, path: ms.path, lines: null, error: 'file not found' });
-            }
-        }
-        // Merge: explicit --context wins over auto-measured
-        context = { ...measured, ...context };
-    }
-    try {
-        const bundle = (0, adf_1.bundleModules)(aiDir, modulePaths, readFile, keywords);
-        const evidence = (0, adf_1.validateConstraints)(bundle.mergedDocument, context);
-        // Check sync status
-        const lockFile = path.join(aiDir, '.adf.lock');
-        const locked = loadLockFile(lockFile);
-        const syncEntries = [];
-        for (const entry of manifest.sync) {
-            const sourcePath = path.join(aiDir, entry.source);
-            if (fs.existsSync(sourcePath)) {
-                const sourceContent = fs.readFileSync(sourcePath, 'utf-8');
-                const sourceHash = hashContent(sourceContent);
-                const lockedHash = locked[entry.source] ?? null;
-                syncEntries.push({ source: entry.source, inSync: lockedHash === sourceHash });
-            }
-        }
-        const allInSync = syncEntries.length === 0 || syncEntries.every(e => e.inSync);
-        const staleCount = syncEntries.filter(e => !e.inSync).length;
-        if (options.format === 'json') {
-            const jsonOut = {
-                aiDir,
-                resolvedModules: bundle.resolvedModules,
-                tokenEstimate: bundle.tokenEstimate,
-                tokenBudget: bundle.tokenBudget,
-                tokenUtilization: bundle.tokenUtilization,
-                constraints: evidence.constraints,
-                weightSummary: evidence.weightSummary,
-                allPassing: evidence.allPassing,
-                failCount: evidence.failCount,
-                warnCount: evidence.warnCount,
-                syncStatus: { allInSync, staleCount },
-            };
-            if (task) {
-                jsonOut.task = task;
-                jsonOut.keywords = keywords;
-            }
-            if (bundle.advisoryOnlyModules.length > 0) {
-                jsonOut.advisoryOnlyModules = bundle.advisoryOnlyModules;
-            }
-            if (autoMeasured.length > 0) {
-                jsonOut.autoMeasured = autoMeasured;
-            }
-            // Suggest logical next steps based on results
-            const nextActions = [];
-            if (!evidence.allPassing) {
-                nextActions.push('Fix failing constraints before merging');
-            }
-            if (!allInSync) {
-                nextActions.push('charter adf sync --write');
-            }
-            if (evidence.warnCount > 0) {
-                nextActions.push('Review metrics at ceiling boundary');
-            }
-            if (nextActions.length > 0) {
-                jsonOut.nextActions = nextActions;
-            }
-            console.log(JSON.stringify(jsonOut, null, 2));
-        }
-        else {
-            console.log('');
-            console.log('  ADF Evidence Report');
-            console.log('  ===================');
-            console.log(`  Modules loaded: ${bundle.resolvedModules.join(', ')}`);
-            console.log(`  Token estimate: ~${bundle.tokenEstimate}`);
-            if (bundle.tokenBudget !== null) {
-                const pct = bundle.tokenUtilization !== null
-                    ? ` (${(bundle.tokenUtilization * 100).toFixed(0)}%)`
-                    : '';
-                console.log(`  Token budget: ${bundle.tokenBudget}${pct}`);
-            }
-            console.log('');
-            // Auto-measured metrics
-            if (autoMeasured.length > 0) {
-                console.log('  Auto-measured:');
-                for (const m of autoMeasured) {
-                    if (m.lines !== null) {
-                        console.log(`    ${m.metric}: ${m.lines} lines (${m.path})`);
-                    }
-                    else {
-                        console.log(`    ${m.metric}: [file not found] (${m.path})`);
-                    }
-                }
-                console.log('');
-            }
-            // Weight summary
-            console.log('  Section weights:');
-            console.log(`    Load-bearing: ${evidence.weightSummary.loadBearing}`);
-            console.log(`    Advisory: ${evidence.weightSummary.advisory}`);
-            console.log(`    Unweighted: ${evidence.weightSummary.unweighted}`);
-            console.log('');
-            // Advisory-only module warnings
-            if (bundle.advisoryOnlyModules.length > 0) {
-                console.log('  Advisory-only modules:');
-                for (const m of bundle.advisoryOnlyModules) {
-                    console.log(`    [!] ${m}: no load-bearing sections`);
-                }
-                console.log('');
-            }
-            // Constraints
-            if (evidence.constraints.length > 0) {
-                console.log('  Constraints:');
-                for (const c of evidence.constraints) {
-                    const icon = c.status === 'pass' ? 'ok' : c.status === 'warn' ? 'WARN' : 'FAIL';
-                    console.log(`    [${icon}] ${c.message}`);
-                }
-            }
-            else {
-                console.log('  Constraints: (none)');
-            }
-            console.log('');
-            // Sync status
-            if (syncEntries.length > 0) {
-                if (allInSync) {
-                    console.log('  Sync: all sources in sync');
-                }
-                else {
-                    console.log(`  Sync: ${staleCount} source${staleCount === 1 ? '' : 's'} out of sync`);
-                }
-            }
-            else {
-                console.log('  Sync: no sync entries configured');
-            }
-            console.log('');
-            // Verdict
-            const verdict = evidence.allPassing ? 'PASS' : 'FAIL';
-            console.log(`  Verdict: ${verdict}`);
-            if (evidence.warnCount > 0) {
-                console.log(`  (${evidence.warnCount} warning${evidence.warnCount === 1 ? '' : 's'} — at ceiling boundary)`);
-            }
-            console.log('');
-        }
-        // CI mode: exit 1 on constraint failures
-        if (options.ciMode && !evidence.allPassing) {
-            return index_1.EXIT_CODE.POLICY_VIOLATION;
-        }
-        return index_1.EXIT_CODE.SUCCESS;
-    }
-    catch (e) {
-        if (e instanceof Error && e.name === 'AdfBundleError') {
-            if (options.format === 'json') {
-                console.log(JSON.stringify({ error: e.message }, null, 2));
-            }
-            else {
-                console.error(`  [error] ${e.message}`);
-            }
-            return index_1.EXIT_CODE.RUNTIME_ERROR;
-        }
-        throw e;
-    }
-}
-// ============================================================================
 // Helpers
 // ============================================================================
 function getFlag(args, flag) {
@@ -728,8 +351,9 @@ function printHelp() {
     console.log('  charter adf — Attention-Directed Format tools');
     console.log('');
     console.log('  Usage:');
-    console.log('    charter adf init [--ai-dir <dir>] [--force]');
+    console.log('    charter adf init [--ai-dir <dir>] [--force] [--emit-pointers]');
     console.log('      Scaffold .ai/ directory with manifest, core, and state modules.');
+    console.log('      --emit-pointers: also generate thin pointer files (CLAUDE.md, .cursorrules, agents.md)');
     console.log('');
     console.log('    charter adf fmt <file> [--check] [--write]');
     console.log('      Parse and reformat an ADF file to canonical form.');
@@ -750,6 +374,9 @@ function printHelp() {
     console.log('    charter adf sync --write [--ai-dir <dir>]');
     console.log('      Update .adf.lock with current source hashes.');
     console.log('');
+    console.log('    charter adf sync --explain');
+    console.log('      Show .adf.lock schema documentation.');
+    console.log('');
     console.log('    charter adf evidence [--task "<prompt>"] [--ai-dir <dir>] [--auto-measure]');
     console.log('                        [--context \'{"key": value}\']');
     console.log('      Validate metric constraints and produce a structured evidence report.');
@@ -759,5 +386,15 @@ function printHelp() {
     console.log('      --context-file: read --context JSON from a file instead.');
     console.log('      In --ci mode, exit 1 if any constraint fails.');
     console.log('');
+    console.log('    charter adf migrate [--dry-run] [--source <file>] [--no-backup]');
+    console.log('                        [--merge-strategy append|dedupe|replace] [--ai-dir <dir>]');
+    console.log('      Ingest existing agent config files (CLAUDE.md, .cursorrules, etc.) and');
+    console.log('      migrate their content into structured ADF modules. Replaces originals');
+    console.log('      with thin pointers that retain environment-specific rules.');
+    console.log('      --dry-run: preview migration plan without writing files');
+    console.log('      --source: migrate a single file instead of scanning all agent configs');
+    console.log('      --no-backup: skip creating .pre-adf-migrate.bak backups');
+    console.log('      --merge-strategy: append (always add), dedupe (skip duplicates, default), replace');
+    console.log('');
 }
 //# sourceMappingURL=adf.js.map