@codeledger/cli 0.1.1

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2025 Intelligent Context AI, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Note: This license applies to the CLI wrapper, types, repository scanning,
+instrumentation, harness, and report packages (the "Plugin"). The scoring
+engine (packages/core-engine/bin/) is licensed separately under LICENSE-CORE.

package/dist/commands/activate.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `codeledger activate [--task "..."] [--session <id>]`
+ *
+ * All-in-one command: scan if stale -> generate bundle -> write active-bundle.md.
+ * Designed to be called by agent hooks (Claude Code, Cursor, Codex) so that
+ * context is ready before the agent starts working on a task.
+ *
+ * When called without --task (e.g. from SessionStart hook), only scans the
+ * repo index so it's warm for future bundle generation. No bundle is written
+ * because there's no real task to select context for.
+ *
+ * Multi-session: when a --session ID is provided (or resolved from env/PID),
+ * all state files are written to .codeledger/sessions/{id}/ instead of the
+ * shared .codeledger/ root. A copy is also written to the legacy fallback
+ * path for non-session-aware agents.
+ */
+export declare function runActivate(cwd: string, flags: Record<string, string>): Promise<void>;
+//# sourceMappingURL=activate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activate.d.ts","sourceRoot":"","sources":["../../src/commands/activate.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAyLf"}

package/dist/commands/activate.js

@@ -0,0 +1,326 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, statSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { execSync } from 'node:child_process';
+import { buildBundleViaEngine } from '@codeledger/core-engine';
+import { buildRepoIndex } from '@codeledger/repo';
+import { renderBundleMarkdown } from '@codeledger/harness';
+import { resolveSessionId } from '../session-id.js';
+import { sessionBundlePath, sessionActivateRef, sessionStartRef, legacyBundlePath, } from '../session-paths.js';
+import { updateSession, findOverlappingFiles } from '../session-registry.js';
+/**
+ * `codeledger activate [--task "..."] [--session <id>]`
+ *
+ * All-in-one command: scan if stale -> generate bundle -> write active-bundle.md.
+ * Designed to be called by agent hooks (Claude Code, Cursor, Codex) so that
+ * context is ready before the agent starts working on a task.
+ *
+ * When called without --task (e.g. from SessionStart hook), only scans the
+ * repo index so it's warm for future bundle generation. No bundle is written
+ * because there's no real task to select context for.
+ *
+ * Multi-session: when a --session ID is provided (or resolved from env/PID),
+ * all state files are written to .codeledger/sessions/{id}/ instead of the
+ * shared .codeledger/ root. A copy is also written to the legacy fallback
+ * path for non-session-aware agents.
+ */
+export async function runActivate(cwd, flags) {
+    const task = flags['task'];
+    const quiet = flags['quiet'] === 'true';
+    const log = quiet ? (..._args) => { } : console.log;
+    const sessionId = resolveSessionId({ session: flags['session'] });
+    const configPath = join(cwd, '.codeledger', 'config.json');
+    if (!existsSync(configPath)) {
+        console.error('No .codeledger/config.json found. Run "codeledger init" first.');
+        process.exit(1);
+    }
+    let config;
+    try {
+        config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+    catch {
+        console.error('Failed to parse .codeledger/config.json. Check for syntax errors.');
+        process.exit(1);
+    }
+    const indexPath = join(cwd, config.workspace.cache_dir, 'repo-index.json');
+    // -- Step 1: Scan if stale ------------------------------------------------
+    const staleSec = flags['stale-after']
+        ? parsePositiveInt(flags['stale-after'], 'stale-after')
+        : 3600; // default: re-scan if index is >1 hour old
+    if (isIndexStale(indexPath, staleSec)) {
+        log('Repo index is stale or missing -- rescanning...');
+        buildRepoIndex({
+            root: cwd,
+            repoConfig: config.repo,
+            outputPath: indexPath,
+            log,
+        });
+        log('   Scan complete.');
+    }
+    // -- Save session start ref for session-progress (full session view) ------
+    // Only write if no ref exists yet (first activate of the session)
+    saveSessionStartRef(cwd, sessionId);
+    // -- Scan-only mode: no task means just warm the index --------------------
+    if (!task) {
+        log('Index is warm. Run "codeledger activate --task ..." to generate a context bundle.');
+        // Write a placeholder active-bundle.md so the agent knows no bundle exists
+        const placeholderContent = [
+            '# CodeLedger Context Bundle',
+            '',
+            'No task specified yet. The repo index has been scanned and is ready.',
+            '',
+            'To generate a context bundle for your task, run:',
+            '',
+            '```',
+            'codeledger activate --task "describe your task here"',
+            '```',
+            '',
+            'The bundle will list the most relevant files ranked by score with',
+            'relevance reasons and code excerpts.',
+            '',
+        ].join('\n');
+        // Write to session-specific path (or legacy path if no session)
+        const bundlePath = sessionBundlePath(cwd, sessionId);
+        ensureDir(bundlePath);
+        writeFileSync(bundlePath, placeholderContent);
+        // Also update the legacy fallback for non-session-aware agents
+        if (sessionId) {
+            const fallback = legacyBundlePath(cwd);
+            ensureDir(fallback);
+            writeFileSync(fallback, placeholderContent);
+        }
+        return;
+    }
+    let repoIndex;
+    try {
+        repoIndex = JSON.parse(readFileSync(indexPath, 'utf-8'));
+    }
+    catch {
+        console.error('Failed to parse repo index. Try running "codeledger scan" to rebuild it.');
+        process.exit(1);
+    }
+    // -- Step 2: Generate bundle ----------------------------------------------
+    const budgetTokens = flags['budget']
+        ? parsePositiveInt(flags['budget'], 'budget')
+        : config.selector.default_budget.tokens;
+    const maxFiles = flags['max-files']
+        ? parsePositiveInt(flags['max-files'], 'max-files')
+        : config.selector.default_budget.max_files;
+    // -- Auto-close previous task: print mini-recap before overwriting ref ------
+    emitPreviousTaskRecap(cwd, config, sessionId, log);
+    // -- Save activate ref for session-summary (per-task scoping) --------------
+    saveActivateRef(cwd, sessionId);
+    log(`Generating context bundle for: "${truncate(task, 80)}"`);
+    const bundle = await buildBundleViaEngine({
+        taskText: task,
+        repoIndex,
+        selectorConfig: config.selector,
+        budget: { tokens: budgetTokens, max_files: maxFiles },
+        indexPath: indexPath,
+    });
+    // -- Step 3: Write active-bundle.md ----------------------------------------
+    const bundleMd = renderBundleMarkdown(bundle);
+    // Write to session-specific path
+    const bundlePath = sessionBundlePath(cwd, sessionId);
+    ensureDir(bundlePath);
+    writeFileSync(bundlePath, bundleMd);
+    // Also update the legacy fallback for non-session-aware agents
+    if (sessionId) {
+        const fallback = legacyBundlePath(cwd);
+        ensureDir(fallback);
+        writeFileSync(fallback, bundleMd);
+    }
+    // Also save the JSON artifact
+    const bundleDir = join(cwd, config.workspace.artifacts_dir, 'bundles');
+    if (!existsSync(bundleDir)) {
+        mkdirSync(bundleDir, { recursive: true });
+    }
+    writeFileSync(join(bundleDir, `${bundle.bundle_id}.json`), JSON.stringify(bundle, null, 2) + '\n');
+    // -- Update session registry with task and bundle files --------------------
+    if (sessionId) {
+        const bundleFiles = bundle.files.map((f) => f.path);
+        updateSession(cwd, sessionId, {
+            task,
+            last_active_at: new Date().toISOString(),
+            bundle_files: bundleFiles,
+        });
+        // -- Conflict detection: check for overlapping files with other sessions --
+        emitOverlapWarnings(cwd, sessionId, bundleFiles, log);
+    }
+    log(`\u{1F4E6} Bundle: ${bundle.files.length} files, ~${bundle.total_tokens} tokens`);
+    // Show confidence
+    if (bundle.confidence) {
+        const c = bundle.confidence;
+        const icon = c.level === 'high' ? '\u{1F7E2}' : c.level === 'medium' ? '\u{1F7E1}' : '\u{1F534}';
+        log(`   Confidence: ${icon} ${c.level.toUpperCase()}`);
+        if (c.level === 'low') {
+            for (const reason of c.reasons) {
+                log(`     - ${reason}`);
+            }
+        }
+    }
+    const displayPath = sessionId
+        ? `.codeledger/sessions/${sessionId}/active-bundle.md`
+        : config.injection.file_drop_path;
+    log(`\u{2705} Active bundle written to ${displayPath}`);
+    if (!quiet) {
+        const fullFiles = bundle.files.filter((f) => !f.is_stub);
+        log('\n   Top files:');
+        for (const f of fullFiles.slice(0, 5)) {
+            log(`     ${f.score.toFixed(3)}  ${f.path}  [${f.reasons.join(', ')}]`);
+        }
+        if (fullFiles.length > 5) {
+            log(`     ... and ${fullFiles.length - 5} more`);
+        }
+        const stubs = bundle.files.filter((f) => f.is_stub);
+        if (stubs.length > 0) {
+            log(`   + ${stubs.length} interface stubs`);
+        }
+        if (sessionId) {
+            log(`   Session: ${sessionId}`);
+        }
+    }
+}
+// ── Conflict Detection ────────────────────────────────────────────────────
+function emitOverlapWarnings(cwd, sessionId, bundleFiles, log) {
+    const overlaps = findOverlappingFiles(cwd, sessionId, bundleFiles);
+    if (overlaps.size === 0)
+        return;
+    for (const [otherSessionId, files] of overlaps) {
+        const severity = files.length >= 4 ? '\u{1F534}' : '\u{1F7E1}';
+        log('');
+        log(`${severity} Session ${otherSessionId} has ${files.length} overlapping file${files.length === 1 ? '' : 's'}:`);
+        for (const f of files.slice(0, 5)) {
+            log(`   ${f}`);
+        }
+        if (files.length > 5) {
+            log(`   ... and ${files.length - 5} more`);
+        }
+        if (files.length >= 4) {
+            log('   Concurrent edits to these files may cause conflicts.');
+        }
+    }
+}
+// ── Helpers ─────────────────────────────────────────────────────────────────
+function ensureDir(filePath) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+function isIndexStale(indexPath, maxAgeSec) {
+    if (!existsSync(indexPath))
+        return true;
+    try {
+        const stat = statSync(indexPath);
+        const ageMs = Date.now() - stat.mtimeMs;
+        return ageMs > maxAgeSec * 1000;
+    }
+    catch {
+        return true;
+    }
+}
+function parsePositiveInt(value, flagName) {
+    const n = parseInt(value, 10);
+    if (Number.isNaN(n) || n <= 0) {
+        console.error(`Invalid value for --${flagName}: "${value}" (expected a positive integer)`);
+        process.exit(1);
+    }
+    return n;
+}
+function truncate(s, max) {
+    return s.length <= max ? s : s.slice(0, max - 3) + '...';
+}
+/**
+ * Save the current HEAD sha for session-progress (full session view).
+ * Only writes once per session (first activate call).
+ */
+function saveSessionStartRef(cwd, sessionId) {
+    const refPath = sessionStartRef(cwd, sessionId);
+    if (existsSync(refPath))
+        return; // already saved this session
+    try {
+        const head = execSync('git rev-parse HEAD', {
+            cwd,
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        ensureDir(refPath);
+        writeFileSync(refPath, head + '\n');
+    }
+    catch {
+        // Non-fatal: fresh repo with no commits, or not a git repo
+    }
+}
+/**
+ * If a previous task's `.activate-ref` exists, print a mini-recap before
+ * overwriting it. This ensures no task's metrics are silently lost when the
+ * developer moves to a new task without manually calling session-summary.
+ */
+function emitPreviousTaskRecap(cwd, config, sessionId, log) {
+    const activateRefPath = sessionActivateRef(cwd, sessionId);
+    if (!existsSync(activateRefPath))
+        return;
+    const startRef = readFileSync(activateRefPath, 'utf-8').trim();
+    if (!startRef)
+        return;
+    // Load the latest bundle to get previous task info
+    const bundleDir = join(cwd, config.workspace.artifacts_dir, 'bundles');
+    if (!existsSync(bundleDir))
+        return;
+    const bundleFiles = readdirSync(bundleDir)
+        .filter((f) => f.endsWith('.json'))
+        .map((f) => ({ name: f, mtime: statSync(join(bundleDir, f)).mtimeMs }))
+        .sort((a, b) => b.mtime - a.mtime);
+    if (bundleFiles.length === 0)
+        return;
+    let bundle;
+    try {
+        bundle = JSON.parse(readFileSync(join(bundleDir, bundleFiles[0].name), 'utf-8'));
+    }
+    catch {
+        return;
+    }
+    // Get files changed since previous activate-ref
+    let changedFiles;
+    try {
+        const diff = execSync(`git diff --name-only ${startRef}..HEAD`, {
+            cwd,
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        changedFiles = diff ? diff.split('\n') : [];
+    }
+    catch {
+        return;
+    }
+    if (changedFiles.length === 0)
+        return;
+    const paths = bundle.files.map((f) => f.path);
+    const overlap = changedFiles.filter((f) => paths.includes(f));
+    const recall = changedFiles.length > 0 ? overlap.length / changedFiles.length : 0;
+    const recallPct = Math.round(recall * 100);
+    log('');
+    log('-- Previous task recap ----------------------------------------');
+    log(`   Task: "${truncate(bundle.task, 60)}"`);
+    log(`   Bundle predicted ${overlap.length}/${changedFiles.length} files changed (${recallPct}% recall)`);
+    log('-'.repeat(61));
+    log('');
+}
+function saveActivateRef(cwd, sessionId) {
+    const refPath = sessionActivateRef(cwd, sessionId);
+    try {
+        const head = execSync('git rev-parse HEAD', {
+            cwd,
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        ensureDir(refPath);
+        writeFileSync(refPath, head + '\n');
+    }
+    catch {
+        // Non-fatal: fresh repo with no commits, or not a git repo
+    }
+}
+//# sourceMappingURL=activate.js.map

package/dist/commands/activate.js.map

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

package/dist/commands/bundle.d.ts

@@ -0,0 +1,2 @@
+export declare function runBundle(cwd: string, flags: Record<string, string>): Promise<void>;
+//# sourceMappingURL=bundle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/commands/bundle.ts"],"names":[],"mappings":"AAMA,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAkJf"}

package/dist/commands/bundle.js

@@ -0,0 +1,144 @@
+import { readFileSync, existsSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { buildBundleViaEngine } from '@codeledger/core-engine';
+import { buildRepoIndex } from '@codeledger/repo';
+export async function runBundle(cwd, flags) {
+    const task = flags['task'];
+    if (!task) {
+        console.error('❌ --task is required. Usage: codeledger bundle --task "your task description"');
+        process.exit(1);
+    }
+    const jsonMode = flags['json'] === 'true';
+    // In --json mode, all human-readable output goes to stderr so stdout is pure JSON
+    const log = jsonMode
+        ? (...args) => { console.error(...args); }
+        : console.log.bind(console);
+    const configPath = join(cwd, '.codeledger', 'config.json');
+    if (!existsSync(configPath)) {
+        console.error('❌ No .codeledger/config.json found. Run "codeledger init" first.');
+        process.exit(1);
+    }
+    let config;
+    try {
+        config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+    catch {
+        console.error('Failed to parse .codeledger/config.json. Check for syntax errors.');
+        process.exit(1);
+    }
+    const indexPath = join(cwd, config.workspace.cache_dir, 'repo-index.json');
+    // Auto-scan if no index
+    if (!existsSync(indexPath)) {
+        log('⚠️  No repo index found. Running scan first...\n');
+        buildRepoIndex({
+            root: cwd,
+            repoConfig: config.repo,
+            outputPath: indexPath,
+            log,
+        });
+        log('');
+    }
+    let repoIndex;
+    try {
+        repoIndex = JSON.parse(readFileSync(indexPath, 'utf-8'));
+    }
+    catch {
+        console.error('Failed to parse repo index. Try running "codeledger scan" to rebuild it.');
+        process.exit(1);
+    }
+    // Parse budget
+    const budgetTokens = flags['budget']
+        ? parseBudget(flags['budget'])
+        : config.selector.default_budget.tokens;
+    const maxFiles = flags['max-files']
+        ? parsePositiveInt(flags['max-files'], 'max-files')
+        : config.selector.default_budget.max_files;
+    log(`🎯 Generating context bundle for: "${task}"\n`);
+    log(`   Budget: ${budgetTokens ?? 'unlimited'} tokens, ${maxFiles ?? 'unlimited'} max files`);
+    log(`   Sufficiency threshold: ${config.selector.sufficiency_threshold}\n`);
+    const explain = flags['explain'] === 'true';
+    const bundle = await buildBundleViaEngine({
+        taskText: task,
+        repoIndex,
+        selectorConfig: config.selector,
+        budget: { tokens: budgetTokens, max_files: maxFiles },
+        explain,
+        indexPath: indexPath,
+    });
+    // Write bundle artifact to disk
+    const bundleDir = join(cwd, config.workspace.artifacts_dir, 'bundles');
+    if (!existsSync(bundleDir)) {
+        mkdirSync(bundleDir, { recursive: true });
+    }
+    const bundlePath = join(bundleDir, `${bundle.bundle_id}.json`);
+    writeFileSync(bundlePath, JSON.stringify(bundle, null, 2) + '\n');
+    // --json mode: emit pure JSON to stdout and exit
+    if (jsonMode) {
+        process.stdout.write(JSON.stringify(bundle, null, 2) + '\n');
+        return;
+    }
+    // Print summary
+    log(`📦 Bundle: ${bundle.bundle_id}`);
+    log(`   Files selected: ${bundle.files.length}`);
+    log(`   Total tokens: ~${bundle.total_tokens}`);
+    log(`   Cumulative score: ${bundle.cumulative_score}`);
+    // Print confidence
+    if (bundle.confidence) {
+        const c = bundle.confidence;
+        const icon = c.level === 'high' ? '🟢' : c.level === 'medium' ? '🟡' : '🔴';
+        log(`   Confidence: ${icon} ${c.level.toUpperCase()} (${c.score})`);
+        if (c.level !== 'high') {
+            for (const reason of c.reasons) {
+                log(`     - ${reason}`);
+            }
+        }
+    }
+    log('');
+    // Print stubs count
+    const stubs = bundle.files.filter((f) => f.is_stub);
+    if (stubs.length > 0) {
+        log(`   Interface stubs: ${stubs.length} (adjacent dependency signatures)`);
+    }
+    // Print deprecation warnings count
+    const filesWithWarnings = bundle.files.filter((f) => f.deprecation_warnings && f.deprecation_warnings.length > 0);
+    if (filesWithWarnings.length > 0) {
+        const totalWarnings = filesWithWarnings.reduce((sum, f) => sum + (f.deprecation_warnings?.length ?? 0), 0);
+        log(`   Deprecation warnings: ${totalWarnings} across ${filesWithWarnings.length} files`);
+    }
+    log('\n   Top files:');
+    const top = bundle.files.filter((f) => !f.is_stub).slice(0, 10);
+    for (const f of top) {
+        const reasons = f.reasons.join(', ');
+        log(`     ${f.score.toFixed(3)}  ${f.path}  [${reasons}]`);
+    }
+    if (bundle.files.length > 10) {
+        log(`     ... and ${bundle.files.length - 10} more`);
+    }
+    // Print explain table if requested
+    if (explain && bundle.explain) {
+        log('\n   Scoring Breakdown (--explain):');
+        log('   %-40s  kw    cent  churn recnt test  szpen succ  fail  errin', 'File');
+        for (const f of bundle.files.filter((bf) => !bf.is_stub)) {
+            const feat = bundle.explain[f.path];
+            if (!feat)
+                continue;
+            const name = f.path.length > 40 ? '...' + f.path.slice(-37) : f.path.padEnd(40);
+            log(`   ${name}  ${feat.keyword.toFixed(2)}  ${feat.centrality.toFixed(2)}  ${feat.churn.toFixed(2)}  ${feat.recent_touch.toFixed(2)}  ${feat.test_relevance.toFixed(2)}  ${feat.size_penalty.toFixed(2)}  ${feat.success_prior.toFixed(2)}  ${feat.fail_prior.toFixed(2)}  ${feat.error_infrastructure.toFixed(2)}`);
+        }
+    }
+    log(`\n✅ Bundle written to ${bundlePath}`);
+}
+function parsePositiveInt(value, flagName) {
+    const n = parseInt(value, 10);
+    if (Number.isNaN(n) || n <= 0) {
+        console.error(`Invalid value for --${flagName}: "${value}" (expected a positive integer)`);
+        process.exit(1);
+    }
+    return n;
+}
+function parseBudget(budgetStr) {
+    // Supports: "tokens=6000" or just "6000"
+    const match = budgetStr.match(/(?:tokens=)?(\d+)/);
+    return match ? parseInt(match[1], 10) : undefined;
+}
+//# sourceMappingURL=bundle.js.map

package/dist/commands/bundle.js.map

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

package/dist/commands/clean.d.ts

@@ -0,0 +1,2 @@
+export declare function runClean(cwd: string): Promise<void>;
+//# sourceMappingURL=clean.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAKA,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBzD"}

package/dist/commands/clean.js

@@ -0,0 +1,28 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { cleanupAllWorktrees } from '@codeledger/harness';
+export async function runClean(cwd) {
+    const configPath = join(cwd, '.codeledger', 'config.json');
+    if (!existsSync(configPath)) {
+        console.error('❌ No .codeledger/config.json found. Run "codeledger init" first.');
+        process.exit(1);
+    }
+    let config;
+    try {
+        config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+    catch {
+        console.error('Failed to parse .codeledger/config.json. Check for syntax errors.');
+        process.exit(1);
+    }
+    const worktreeRoot = join(cwd, config.workspace.worktree_root);
+    console.log('🧹 Cleaning up orphaned worktrees...');
+    const removed = cleanupAllWorktrees(cwd, worktreeRoot);
+    if (removed > 0) {
+        console.log(`✅ Removed ${removed} orphaned worktree${removed > 1 ? 's' : ''}.`);
+    }
+    else {
+        console.log('✅ No orphaned worktrees found.');
+    }
+}
+//# sourceMappingURL=clean.js.map

package/dist/commands/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IAC3D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;QAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAqB,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;QACnF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAE/D,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAEvD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,qBAAqB,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/commands/compare.d.ts

@@ -0,0 +1,2 @@
+export declare function runCompare(cwd: string, flags: Record<string, string>): Promise<void>;
+//# sourceMappingURL=compare.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/commands/compare.ts"],"names":[],"mappings":"AA6EA,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAqGf"}