beth-copilot 1.0.17 → 1.1.0

package/dist/cli/commands/framework-isolation.test.js

@@ -0,0 +1,119 @@
+/**
+ * Dual-framework isolation audit tests.
+ *
+ * beth-ywg.6: beads.e2e.test.ts and quickstart.test.ts mix node:test and vitest
+ * imports. This file validates that the vitest config alias ('node:test' → 'vitest')
+ * works correctly and that lifecycle hooks fire in the expected order.
+ *
+ * Repro steps:
+ *   1. Run: npx vitest run src/cli/commands/framework-isolation.test.ts
+ *
+ * Background:
+ *   The vitest.config.ts has: resolve.alias['node:test'] = 'vitest'
+ *   This means `import { describe, it } from 'node:test'` actually imports from vitest.
+ *   But `import { beforeAll } from 'vitest'` is a direct vitest import.
+ *   Mixing both in the same file is risky — lifecycle hooks from different
+ *   module identities might not share state.
+ *
+ * Test cases:
+ *   - Verify the vitest alias resolves correctly
+ *   - Verify describe/it from 'node:test' work under vitest
+ *   - Verify beforeEach/afterEach from 'node:test' fire in order
+ *   - Verify beforeAll from 'vitest' runs before all tests
+ *   - Verify mixed imports don't create duplicate hook registrations
+ *   - Verify assert from 'node:assert' works alongside vitest expect
+ *   - Document which files currently mix frameworks
+ *
+ * Expected outcomes documented inline per test case.
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import { beforeAll } from 'vitest';
+import assert from 'node:assert';
+// Track execution order to detect lifecycle issues
+const executionLog = [];
+describe('framework isolation: node:test under vitest alias', () => {
+    beforeAll(() => {
+        executionLog.push('beforeAll');
+    });
+    beforeEach(() => {
+        executionLog.push('beforeEach');
+    });
+    afterEach(() => {
+        executionLog.push('afterEach');
+    });
+    describe('basic describe/it from node:test', () => {
+        it('should run it() blocks', () => {
+            executionLog.push('test:basic');
+            assert.ok(true, 'it() from node:test should execute');
+        });
+        it('should support assert from node:assert', () => {
+            assert.strictEqual(1 + 1, 2);
+            assert.deepStrictEqual([1, 2, 3], [1, 2, 3]);
+            assert.throws(() => { throw new Error('test'); }, /test/);
+        });
+        it('should support assert.match for regex', () => {
+            assert.match('hello world', /world/);
+        });
+    });
+    describe('lifecycle hook ordering', () => {
+        it('should have beforeAll fired before any test', () => {
+            assert.ok(executionLog.includes('beforeAll'), 'beforeAll should have fired before this test');
+        });
+        it('should have beforeEach fire before each test', () => {
+            // Count the beforeEach entries — should increase with each test
+            const beforeEachCount = executionLog.filter(e => e === 'beforeEach').length;
+            assert.ok(beforeEachCount > 0, 'beforeEach should have fired at least once');
+        });
+        it('should have afterEach fire after previous tests', () => {
+            // afterEach from previous tests should be in the log
+            // (won't see the afterEach for THIS test until after it completes)
+            const afterEachCount = executionLog.filter(e => e === 'afterEach').length;
+            assert.ok(afterEachCount > 0, 'afterEach from previous tests should have fired');
+        });
+    });
+});
+describe('framework isolation: direct vitest imports', () => {
+    // This tests that importing directly from 'vitest' alongside 'node:test'
+    // doesn't cause conflicts (since the alias maps them to the same module).
+    it('should coexist with node:test imports without conflict', () => {
+        // If this test runs at all, it means both import paths resolved
+        // to the same vitest module without errors.
+        assert.ok(true, 'Both import paths coexist');
+    });
+    it('should share the same describe/it registry', () => {
+        // If this test shows up in the same test report as the node:test tests above,
+        // they share the same registry. The test runner handles this correctly.
+        assert.ok(true, 'Test is visible in the same suite');
+    });
+});
+describe('framework isolation: audit of mixed-import files', () => {
+    /**
+     * These files currently import from both 'node:test' AND 'vitest' directly.
+     * The vitest alias makes this work, but it's fragile. Document for awareness.
+     */
+    const MIXED_FILES = [
+        'src/cli/commands/beads.e2e.test.ts',
+        'src/cli/commands/quickstart.test.ts',
+    ];
+    it('should document which files use mixed imports', () => {
+        // This is a documentation test — it asserts the known mixed files exist.
+        // If someone adds more mixed files, they should add them here too.
+        assert.ok(MIXED_FILES.length === 2, `Expected 2 mixed-import files, found ${MIXED_FILES.length}. ` +
+            'Update this test if new mixed-import files are added.');
+    });
+    it('should note the vitest config alias that makes this work', () => {
+        // vitest.config.ts and vitest.e2e.config.ts both have:
+        //   resolve.alias['node:test'] = 'vitest'
+        // Without this alias, importing from 'node:test' would use the real
+        // node:test runner, which has different lifecycle semantics.
+        assert.ok(true, 'Alias documented: node:test → vitest in vitest configs');
+    });
+    it('should note the risk: if alias is removed, mixed files break', () => {
+        // Risk: Removing the alias from vitest config would cause:
+        // - describe/it from 'node:test' to use Node's built-in test runner
+        // - beforeAll from 'vitest' to use vitest's lifecycle
+        // - These would NOT interact, causing hooks to not fire for some tests
+        assert.ok(true, 'Risk documented: removing alias breaks mixed-import files');
+    });
+});
+//# sourceMappingURL=framework-isolation.test.js.map

package/dist/cli/commands/framework-isolation.test.js.map

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

package/dist/cli/commands/init-logic.e2e.test.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Init logic unit-style E2E tests — exercises internal init behaviors.
+ *
+ * beth-ywg.7: bin/cli.js init logic is ~1200 lines inline with zero unit tests.
+ * Since the functions aren't exportable (inline CJS), these tests exercise
+ * specific behaviors through CLI invocations with controlled filesystem state.
+ *
+ * Repro steps:
+ *   1. Run: npx vitest run src/cli/commands/init-logic.e2e.test.ts
+ *
+ * Test cases — copyDirRecursive behavior:
+ *   - Fresh directory → all files created
+ *   - Existing files without --force → skipped (not overwritten)
+ *   - Existing files with --force → overwritten
+ *   - File exists where directory expected → UserError without --force
+ *   - File exists where directory expected + --force → converted to directory
+ *
+ * Test cases — validateArgs behavior:
+ *   - Arguments > 50 chars → exit 1, "input too long"
+ *   - Arguments with special chars → exit 1, "unexpected characters"
+ *   - Normal arguments → accepted
+ *
+ * Test cases — Template integrity:
+ *   - All 7 agent files copied from templates/
+ *   - All 6 skill directories copied
+ *   - AGENTS.md copied
+ *   - copilot-instructions.md generated/copied
+ *   - .vscode/settings.json created
+ *
+ * Test cases — UserError display:
+ *   - Path conflict shows problem/fix/command
+ *   - --verbose adds stack trace
+ *
+ * Expected outcomes documented inline per test case.
+ */
+export {};
+//# sourceMappingURL=init-logic.e2e.test.d.ts.map

package/dist/cli/commands/init-logic.e2e.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-logic.e2e.test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init-logic.e2e.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG"}

package/dist/cli/commands/init-logic.e2e.test.js

@@ -0,0 +1,305 @@
+/**
+ * Init logic unit-style E2E tests — exercises internal init behaviors.
+ *
+ * beth-ywg.7: bin/cli.js init logic is ~1200 lines inline with zero unit tests.
+ * Since the functions aren't exportable (inline CJS), these tests exercise
+ * specific behaviors through CLI invocations with controlled filesystem state.
+ *
+ * Repro steps:
+ *   1. Run: npx vitest run src/cli/commands/init-logic.e2e.test.ts
+ *
+ * Test cases — copyDirRecursive behavior:
+ *   - Fresh directory → all files created
+ *   - Existing files without --force → skipped (not overwritten)
+ *   - Existing files with --force → overwritten
+ *   - File exists where directory expected → UserError without --force
+ *   - File exists where directory expected + --force → converted to directory
+ *
+ * Test cases — validateArgs behavior:
+ *   - Arguments > 50 chars → exit 1, "input too long"
+ *   - Arguments with special chars → exit 1, "unexpected characters"
+ *   - Normal arguments → accepted
+ *
+ * Test cases — Template integrity:
+ *   - All 7 agent files copied from templates/
+ *   - All 6 skill directories copied
+ *   - AGENTS.md copied
+ *   - copilot-instructions.md generated/copied
+ *   - .vscode/settings.json created
+ *
+ * Test cases — UserError display:
+ *   - Path conflict shows problem/fix/command
+ *   - --verbose adds stack trace
+ *
+ * Expected outcomes documented inline per test case.
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { execSync } from 'child_process';
+import { existsSync, mkdirSync, writeFileSync, rmSync, readFileSync, readdirSync, statSync, } from 'fs';
+import { join, resolve } from 'path';
+import { tmpdir } from 'os';
+const CLI_PATH = resolve(join(import.meta.dirname, '..', '..', '..', 'bin', 'cli.js'));
+// Expected files that init should create
+const EXPECTED_AGENTS = [
+    'beth.agent.md',
+    'developer.agent.md',
+    'product-manager.agent.md',
+    'researcher.agent.md',
+    'security-reviewer.agent.md',
+    'tester.agent.md',
+    'ux-designer.agent.md',
+];
+const EXPECTED_SKILLS = [
+    'framer-components',
+    'prd',
+    'security-analysis',
+    'shadcn-ui',
+    'vercel-react-best-practices',
+    'web-design-guidelines',
+];
+function runInit(cwd, flags = []) {
+    const allFlags = ['--skip-beads', ...flags];
+    try {
+        const stdout = execSync(`node "${CLI_PATH}" init ${allFlags.join(' ')}`, {
+            cwd,
+            encoding: 'utf-8',
+            env: { ...process.env, NO_COLOR: '1' },
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 30000,
+        });
+        return { stdout, stderr: '', code: 0 };
+    }
+    catch (error) {
+        const e = error;
+        return { stdout: e.stdout || '', stderr: e.stderr || '', code: e.status || 1 };
+    }
+}
+describe('init logic: copyDirRecursive behavior', () => {
+    let testDir;
+    beforeEach(() => {
+        testDir = join(tmpdir(), `beth-init-logic-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        mkdirSync(testDir, { recursive: true });
+    });
+    afterEach(() => {
+        if (existsSync(testDir)) {
+            rmSync(testDir, { recursive: true, force: true });
+        }
+    });
+    describe('fresh directory (first install)', () => {
+        // Expected: all files created, exit 0
+        it('should create all agent files', () => {
+            const result = runInit(testDir);
+            assert.strictEqual(result.code, 0, 'Init should succeed in fresh directory');
+            const agentsDir = join(testDir, '.github', 'agents');
+            assert.ok(existsSync(agentsDir), '.github/agents should exist');
+            for (const agent of EXPECTED_AGENTS) {
+                assert.ok(existsSync(join(agentsDir, agent)), `Agent file ${agent} should be created`);
+            }
+        });
+        it('should create all skill directories', () => {
+            runInit(testDir);
+            const skillsDir = join(testDir, '.github', 'skills');
+            assert.ok(existsSync(skillsDir), '.github/skills should exist');
+            for (const skill of EXPECTED_SKILLS) {
+                const skillPath = join(skillsDir, skill);
+                assert.ok(existsSync(skillPath), `Skill directory ${skill} should exist`);
+                assert.ok(existsSync(join(skillPath, 'SKILL.md')), `${skill}/SKILL.md should exist`);
+            }
+        });
+        it('should create AGENTS.md at root', () => {
+            runInit(testDir);
+            assert.ok(existsSync(join(testDir, 'AGENTS.md')), 'AGENTS.md should be created at project root');
+        });
+        it('should create copilot-instructions.md', () => {
+            runInit(testDir);
+            const instrPath = join(testDir, '.github', 'copilot-instructions.md');
+            assert.ok(existsSync(instrPath), 'copilot-instructions.md should be created');
+            const content = readFileSync(instrPath, 'utf-8');
+            assert.ok(content.includes('Beth') || content.includes('beth'), 'copilot-instructions.md should reference Beth');
+        });
+    });
+    describe('overwrite protection (no --force)', () => {
+        // Expected: existing files preserved, new files created
+        it('should not overwrite existing agent files', () => {
+            // First init
+            runInit(testDir);
+            // Modify an agent file
+            const bethPath = join(testDir, '.github', 'agents', 'beth.agent.md');
+            writeFileSync(bethPath, 'CUSTOM CONTENT');
+            // Second init without --force
+            const result = runInit(testDir);
+            assert.strictEqual(result.code, 0, 'Second init should succeed');
+            // Verify custom content preserved
+            const content = readFileSync(bethPath, 'utf-8');
+            assert.strictEqual(content, 'CUSTOM CONTENT', 'Existing agent file should not be overwritten');
+        });
+        it('should report skipped files', () => {
+            runInit(testDir);
+            const result = runInit(testDir);
+            const combined = result.stdout + result.stderr;
+            assert.ok(combined.includes('Skipped') || combined.includes('exists') || combined.includes('skip'), 'Should report that files were skipped');
+        });
+    });
+    describe('--force overwrite', () => {
+        // Expected: all files overwritten with template versions
+        it('should overwrite existing files with --force', () => {
+            // First init
+            runInit(testDir);
+            // Modify an agent file
+            const bethPath = join(testDir, '.github', 'agents', 'beth.agent.md');
+            writeFileSync(bethPath, 'CUSTOM CONTENT');
+            // Second init with --force
+            const result = runInit(testDir, ['--force']);
+            assert.strictEqual(result.code, 0, 'Force init should succeed');
+            // Verify content was replaced
+            const content = readFileSync(bethPath, 'utf-8');
+            assert.notStrictEqual(content, 'CUSTOM CONTENT', 'File should be overwritten with --force');
+            assert.ok(content.includes('Beth') || content.includes('name:'), 'Overwritten content should be the template');
+        });
+    });
+    describe('path conflict: file exists where directory expected', () => {
+        // Expected: UserError without --force, handled with --force
+        it('should error when .github is a file not a directory', () => {
+            // Create .github as a file
+            writeFileSync(join(testDir, '.github'), 'not a directory');
+            const result = runInit(testDir);
+            assert.strictEqual(result.code, 1, 'Should exit 1 for path conflict');
+            const combined = result.stdout + result.stderr;
+            assert.ok(combined.includes('conflict') || combined.includes('exists as a file') || combined.includes('Error'), 'Should indicate path conflict');
+        });
+        it('should handle path conflict with --force', () => {
+            // Create .github as a file
+            writeFileSync(join(testDir, '.github'), 'not a directory');
+            const result = runInit(testDir, ['--force']);
+            assert.strictEqual(result.code, 0, 'Should succeed with --force converting file to directory');
+            assert.ok(statSync(join(testDir, '.github')).isDirectory(), '.github should be a directory after --force');
+        });
+    });
+    describe('--skip-backlog flag', () => {
+        // Expected: Backlog.md not created
+        it('should skip Backlog.md creation', () => {
+            const result = runInit(testDir, ['--skip-backlog']);
+            assert.strictEqual(result.code, 0);
+            assert.ok(!existsSync(join(testDir, 'Backlog.md')), 'Backlog.md should not be created with --skip-backlog');
+        });
+    });
+    describe('--skip-mcp flag', () => {
+        // Expected: mcp.json.example not created
+        it('should skip MCP config creation', () => {
+            const result = runInit(testDir, ['--skip-mcp']);
+            assert.strictEqual(result.code, 0);
+            assert.ok(!existsSync(join(testDir, 'mcp.json.example')), 'mcp.json.example should not be created with --skip-mcp');
+        });
+    });
+});
+describe('init logic: validateArgs behavior', () => {
+    // These test the input validation that runs before command dispatch
+    it('should reject arguments over 50 characters', () => {
+        const longArg = 'a'.repeat(51);
+        try {
+            execSync(`node "${CLI_PATH}" ${longArg}`, {
+                encoding: 'utf-8',
+                env: { ...process.env, NO_COLOR: '1' },
+                stdio: ['pipe', 'pipe', 'pipe'],
+                timeout: 15000,
+            });
+            assert.fail('Should have exited non-zero');
+        }
+        catch (error) {
+            const e = error;
+            assert.strictEqual(e.status, 1, 'Should exit 1 for oversized argument');
+            // logError uses console.log (stdout), not console.error
+            const combined = (e.stdout || '') + (e.stderr || '');
+            assert.ok(combined.includes('too long') || combined.includes('Invalid'), 'Should indicate input too long');
+        }
+    });
+    it('should reject arguments with special characters', () => {
+        try {
+            execSync(`node "${CLI_PATH}" "init;whoami"`, {
+                encoding: 'utf-8',
+                env: { ...process.env, NO_COLOR: '1' },
+                stdio: ['pipe', 'pipe', 'pipe'],
+                timeout: 15000,
+            });
+            assert.fail('Should have exited non-zero');
+        }
+        catch (error) {
+            const e = error;
+            assert.strictEqual(e.status, 1, 'Should exit 1 for special characters');
+        }
+    });
+    it('should accept normal alphanumeric arguments', () => {
+        // 'help' is clean — should pass validation
+        const stdout = execSync(`node "${CLI_PATH}" help`, {
+            encoding: 'utf-8',
+            env: { ...process.env, NO_COLOR: '1' },
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 15000,
+        });
+        assert.ok(stdout.length > 0, 'help should produce output');
+    });
+});
+describe('init logic: template integrity', () => {
+    let testDir;
+    beforeEach(() => {
+        testDir = join(tmpdir(), `beth-init-integrity-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        mkdirSync(testDir, { recursive: true });
+    });
+    afterEach(() => {
+        if (existsSync(testDir)) {
+            rmSync(testDir, { recursive: true, force: true });
+        }
+    });
+    it('should install exactly 7 agent files', () => {
+        runInit(testDir);
+        const agentsDir = join(testDir, '.github', 'agents');
+        if (!existsSync(agentsDir)) {
+            assert.fail('.github/agents directory should exist');
+            return;
+        }
+        const agents = readdirSync(agentsDir).filter((f) => f.endsWith('.agent.md'));
+        assert.strictEqual(agents.length, 7, `Expected 7 agents, got ${agents.length}: ${agents.join(', ')}`);
+    });
+    it('should install exactly 6 skill directories', () => {
+        runInit(testDir);
+        const skillsDir = join(testDir, '.github', 'skills');
+        if (!existsSync(skillsDir)) {
+            assert.fail('.github/skills directory should exist');
+            return;
+        }
+        const skills = readdirSync(skillsDir).filter((f) => statSync(join(skillsDir, f)).isDirectory());
+        assert.strictEqual(skills.length, 6, `Expected 6 skills, got ${skills.length}: ${skills.join(', ')}`);
+    });
+    it('should create .vscode/settings.json', () => {
+        runInit(testDir);
+        const settingsPath = join(testDir, '.vscode', 'settings.json');
+        assert.ok(existsSync(settingsPath), '.vscode/settings.json should be created');
+        // settings.json is JSONC (has comments) — verify it exists and has content
+        const content = readFileSync(settingsPath, 'utf-8');
+        assert.ok(content.length > 10, 'settings.json should have meaningful content');
+        assert.ok(content.includes('{'), 'settings.json should contain JSON structure');
+    });
+    it('should create agent files with valid YAML frontmatter', () => {
+        runInit(testDir);
+        const agentsDir = join(testDir, '.github', 'agents');
+        for (const agent of EXPECTED_AGENTS) {
+            const content = readFileSync(join(agentsDir, agent), 'utf-8');
+            assert.ok(content.startsWith('---'), `${agent} should start with YAML frontmatter delimiter`);
+            // Should have closing delimiter
+            const secondDelimiter = content.indexOf('---', 3);
+            assert.ok(secondDelimiter > 3, `${agent} should have closing YAML frontmatter delimiter`);
+        }
+    });
+    it('should create skill SKILL.md files with content', () => {
+        runInit(testDir);
+        const skillsDir = join(testDir, '.github', 'skills');
+        for (const skill of EXPECTED_SKILLS) {
+            const skillMd = join(skillsDir, skill, 'SKILL.md');
+            assert.ok(existsSync(skillMd), `${skill}/SKILL.md should exist`);
+            const content = readFileSync(skillMd, 'utf-8');
+            assert.ok(content.length > 10, `${skill}/SKILL.md should have meaningful content`);
+        }
+    });
+});
+//# sourceMappingURL=init-logic.e2e.test.js.map

package/dist/cli/commands/init-logic.e2e.test.js.map

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

package/dist/cli/commands/land.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Land Command — Partial session completion automation
+ *
+ * `npx beth-copilot land` automates the **git-mechanical** portion of the
+ * "Landing the Plane" checklist defined in AGENTS.md. It does NOT replace
+ * the full checklist — several steps require agent judgment and are left
+ * to the caller.
+ *
+ * What this command handles:
+ *   1. Verify we're on an epic branch (not main/master)
+ *   2. Run quality gates (npm test)
+ *   3. Backup beads data (bd backup)
+ *   4. Stage, commit, and push to origin
+ *   5. Report final status
+ *
+ * What this command does NOT handle (manual / agent responsibility):
+ *   - Closing beads issues          (`npx beth-copilot close <id>`)
+ *   - Creating follow-up issues     (`bd create`)
+ *   - Updating Backlog.md           (human-readable completed-work archive)
+ *   - Generating test gate report   (`npm run test:gate`)
+ *   - Creating a PR to main         (`gh pr create` or GitHub MCP)
+ *
+ * See AGENTS.md → "Landing the Plane (Session Completion)" for the full
+ * checklist. Agents should complete the manual steps before or after
+ * invoking this command.
+ *
+ * Options:
+ *   --skip-tests    Skip test execution (not recommended)
+ *   --skip-backup   Skip beads backup
+ *   --message, -m   Custom commit message (default: "<epic-id>: session work")
+ *   --force         Push even if tests fail (DANGEROUS)
+ *   --dry-run       Show what would happen without executing
+ */
+export interface LandOptions {
+    skipTests?: boolean;
+    skipBackup?: boolean;
+    message?: string;
+    force?: boolean;
+    dryRun?: boolean;
+}
+export interface LandStepResult {
+    step: string;
+    status: 'pass' | 'fail' | 'skip' | 'warn';
+    message: string;
+    details?: string;
+}
+export interface LandResult {
+    success: boolean;
+    steps: LandStepResult[];
+    branch?: string;
+    epicId?: string;
+}
+/**
+ * Parse land command arguments.
+ */
+export declare function parseLandArgs(rawArgs: string[]): LandOptions;
+/**
+ * Get the current git branch name.
+ * Returns null if not in a git repo or detached HEAD.
+ */
+export declare function getCurrentBranch(): string | null;
+/**
+ * Extract the epic ID from a branch name.
+ * e.g. "epic/beth-z9n" → "beth-z9n"
+ * Returns null if branch doesn't follow epic convention.
+ */
+export declare function extractEpicId(branch: string): string | null;
+/**
+ * Check if a branch is a protected branch (main/master).
+ */
+export declare function isProtectedBranch(branch: string): boolean;
+/**
+ * Check if there are uncommitted changes in the working tree.
+ */
+export declare function hasUncommittedChanges(): boolean;
+/**
+ * Check if there are staged changes ready to commit.
+ */
+export declare function hasStagedChanges(): boolean;
+/**
+ * Check if there are unpushed commits on the current branch.
+ */
+export declare function hasUnpushedCommits(branch: string): boolean;
+/**
+ * Run npm test and return pass/fail with output.
+ */
+export declare function runTests(): {
+    passed: boolean;
+    output: string;
+};
+/**
+ * Run beads backup (bd backup).
+ */
+export declare function runBeadsBackup(): {
+    success: boolean;
+    output: string;
+};
+/**
+ * Stage all changes (git add -A).
+ */
+export declare function gitAddAll(): boolean;
+/**
+ * Commit staged changes.
+ */
+export declare function gitCommit(message: string): boolean;
+/**
+ * Check if a remote tracking branch exists for the given branch.
+ */
+export declare function remoteBranchExists(branch: string): boolean;
+/**
+ * Abort an in-progress rebase.
+ */
+export declare function gitRebaseAbort(): void;
+/**
+ * Pull with rebase from origin.
+ */
+export declare function gitPullRebase(branch: string): {
+    success: boolean;
+    output: string;
+};
+/**
+ * Push to origin.
+ */
+export declare function gitPush(branch: string): {
+    success: boolean;
+    output: string;
+};
+/**
+ * Verify the current branch is up to date with origin.
+ */
+export declare function isUpToDateWithOrigin(branch: string): boolean;
+/**
+ * Execute the full landing sequence.
+ * Returns structured result for programmatic use.
+ */
+export declare function executeLanding(options?: LandOptions): LandResult;
+/**
+ * Main land command entry point.
+ * Called from CLI routing with raw args after 'land'.
+ */
+export declare function land(rawArgs: string[]): Promise<void>;
+//# sourceMappingURL=land.d.ts.map

package/dist/cli/commands/land.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"land.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/land.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAcH,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW,CAsB5D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAYhD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAW/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAe1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAmB1D;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAc9D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAarE;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAWnC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAWlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAW1D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAUrC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAalF;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAa5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAwB5D;AA6CD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,WAAgB,GAAG,UAAU,CA8RpE;AAED;;;GAGG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3D"}