beth-copilot 1.0.18 → 2.0.0

package/dist/cli/commands/pre-push-guard.test.js

@@ -0,0 +1,314 @@
+/**
+ * Pre-Push Guard Tests
+ *
+ * Tests branch discipline enforcement:
+ * - Push ref parsing from Git stdin
+ * - Branch name extraction from refs
+ * - Protected branch detection
+ * - Epic branch convention validation
+ * - Release branch recognition
+ * - Guard logic: errors vs warnings
+ * - Hook script generation
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import { parsePushRefs, extractBranchName, isProtectedBranch, isEpicBranch, isReleaseBranch, isRecognizedBranch, runGuard, generateHookScript, BETH_GUARD_BEGIN, BETH_GUARD_END, } from './pre-push-guard.js';
+beforeEach(() => {
+});
+// ─── parsePushRefs ─────────────────────────────────────────────────────────────
+describe('parsePushRefs', () => {
+    it('parses a single push ref line', () => {
+        const stdin = 'refs/heads/epic/beth-abc 1234567 refs/heads/epic/beth-abc 0000000';
+        const refs = parsePushRefs(stdin);
+        expect(refs).toHaveLength(1);
+        expect(refs[0]).toEqual({
+            localRef: 'refs/heads/epic/beth-abc',
+            localSha: '1234567',
+            remoteRef: 'refs/heads/epic/beth-abc',
+            remoteSha: '0000000',
+        });
+    });
+    it('parses multiple push ref lines', () => {
+        const stdin = [
+            'refs/heads/epic/beth-abc 1111111 refs/heads/epic/beth-abc 0000000',
+            'refs/heads/epic/beth-def 2222222 refs/heads/epic/beth-def 0000000',
+        ].join('\n');
+        const refs = parsePushRefs(stdin);
+        expect(refs).toHaveLength(2);
+        expect(refs[0].localRef).toBe('refs/heads/epic/beth-abc');
+        expect(refs[1].localRef).toBe('refs/heads/epic/beth-def');
+    });
+    it('handles empty stdin', () => {
+        expect(parsePushRefs('')).toHaveLength(0);
+        expect(parsePushRefs('  ')).toHaveLength(0);
+        expect(parsePushRefs('\n')).toHaveLength(0);
+    });
+    it('handles trailing newlines', () => {
+        const stdin = 'refs/heads/epic/beth-abc 1234567 refs/heads/epic/beth-abc 0000000\n\n';
+        const refs = parsePushRefs(stdin);
+        expect(refs).toHaveLength(1);
+    });
+    it('handles partial lines gracefully', () => {
+        const stdin = 'refs/heads/main';
+        const refs = parsePushRefs(stdin);
+        expect(refs).toHaveLength(1);
+        expect(refs[0].localRef).toBe('refs/heads/main');
+        expect(refs[0].localSha).toBe('');
+    });
+});
+// ─── extractBranchName ─────────────────────────────────────────────────────────
+describe('extractBranchName', () => {
+    it('strips refs/heads/ prefix', () => {
+        expect(extractBranchName('refs/heads/main')).toBe('main');
+        expect(extractBranchName('refs/heads/epic/beth-abc')).toBe('epic/beth-abc');
+    });
+    it('returns ref as-is when no prefix', () => {
+        expect(extractBranchName('main')).toBe('main');
+        expect(extractBranchName('epic/beth-abc')).toBe('epic/beth-abc');
+    });
+    it('handles refs/tags (not stripped)', () => {
+        expect(extractBranchName('refs/tags/v1.0.0')).toBe('refs/tags/v1.0.0');
+    });
+    it('handles empty string', () => {
+        expect(extractBranchName('')).toBe('');
+    });
+});
+// ─── isProtectedBranch ─────────────────────────────────────────────────────────
+describe('isProtectedBranch', () => {
+    it('identifies main as protected', () => {
+        expect(isProtectedBranch('main')).toBe(true);
+    });
+    it('identifies master as protected', () => {
+        expect(isProtectedBranch('master')).toBe(true);
+    });
+    it('rejects epic branches', () => {
+        expect(isProtectedBranch('epic/beth-abc')).toBe(false);
+    });
+    it('rejects release branches', () => {
+        expect(isProtectedBranch('release/v1.0.0')).toBe(false);
+    });
+    it('rejects random branches', () => {
+        expect(isProtectedBranch('feature/foo')).toBe(false);
+        expect(isProtectedBranch('')).toBe(false);
+    });
+});
+// ─── isEpicBranch ──────────────────────────────────────────────────────────────
+describe('isEpicBranch', () => {
+    it('accepts valid epic branches', () => {
+        expect(isEpicBranch('epic/beth-abc')).toBe(true);
+        expect(isEpicBranch('epic/beth-abc123')).toBe(true);
+        expect(isEpicBranch('epic/hq-xyz')).toBe(true);
+        expect(isEpicBranch('epic/beth-bdh')).toBe(true);
+    });
+    it('rejects branches without epic/ prefix', () => {
+        expect(isEpicBranch('beth-abc')).toBe(false);
+        expect(isEpicBranch('feature/beth-abc')).toBe(false);
+    });
+    it('rejects branches with uppercase', () => {
+        expect(isEpicBranch('epic/BETH-abc')).toBe(false);
+        expect(isEpicBranch('epic/Beth-Abc')).toBe(false);
+    });
+    it('rejects branches without rig-hash format', () => {
+        expect(isEpicBranch('epic/justwords')).toBe(false);
+        expect(isEpicBranch('epic/')).toBe(false);
+        expect(isEpicBranch('epic/a-')).toBe(false);
+    });
+    it('rejects branches with special characters', () => {
+        expect(isEpicBranch('epic/beth-abc; rm -rf /')).toBe(false);
+        expect(isEpicBranch('epic/beth-abc$(whoami)')).toBe(false);
+    });
+});
+// ─── isReleaseBranch ───────────────────────────────────────────────────────────
+describe('isReleaseBranch', () => {
+    it('accepts release branches with v prefix', () => {
+        expect(isReleaseBranch('release/v1.0.0')).toBe(true);
+        expect(isReleaseBranch('release/v2')).toBe(true);
+        expect(isReleaseBranch('release/v1.0.15')).toBe(true);
+    });
+    it('accepts release branches without v prefix', () => {
+        expect(isReleaseBranch('release/1.0.0')).toBe(true);
+        expect(isReleaseBranch('release/2')).toBe(true);
+    });
+    it('rejects non-release branches', () => {
+        expect(isReleaseBranch('main')).toBe(false);
+        expect(isReleaseBranch('epic/beth-abc')).toBe(false);
+        expect(isReleaseBranch('release/')).toBe(false);
+        expect(isReleaseBranch('release/abc')).toBe(false);
+    });
+});
+// ─── isRecognizedBranch ────────────────────────────────────────────────────────
+describe('isRecognizedBranch', () => {
+    it('recognizes epic branches', () => {
+        expect(isRecognizedBranch('epic/beth-abc')).toBe(true);
+    });
+    it('recognizes release branches', () => {
+        expect(isRecognizedBranch('release/v1.0.0')).toBe(true);
+    });
+    it('recognizes protected branches', () => {
+        expect(isRecognizedBranch('main')).toBe(true);
+        expect(isRecognizedBranch('master')).toBe(true);
+    });
+    it('rejects unrecognized branches', () => {
+        expect(isRecognizedBranch('feature/foo')).toBe(false);
+        expect(isRecognizedBranch('bugfix/bar')).toBe(false);
+        expect(isRecognizedBranch('dev')).toBe(false);
+        expect(isRecognizedBranch('')).toBe(false);
+    });
+});
+// ─── runGuard ──────────────────────────────────────────────────────────────────
+describe('runGuard', () => {
+    describe('protected branch blocking', () => {
+        it('blocks push when current branch is main', () => {
+            const result = runGuard('main');
+            expect(result.allowed).toBe(false);
+            expect(result.errors).toHaveLength(1);
+            expect(result.errors[0]).toContain('main');
+            expect(result.errors[0]).toContain('blocked');
+        });
+        it('blocks push when current branch is master', () => {
+            const result = runGuard('master');
+            expect(result.allowed).toBe(false);
+            expect(result.errors[0]).toContain('master');
+        });
+        it('blocks push when remote ref targets main', () => {
+            const refs = [
+                {
+                    localRef: 'refs/heads/feature/x',
+                    localSha: '111',
+                    remoteRef: 'refs/heads/main',
+                    remoteSha: '000',
+                },
+            ];
+            const result = runGuard('feature/x', refs);
+            expect(result.allowed).toBe(false);
+            expect(result.errors[0]).toContain("'main'");
+        });
+        it('blocks push when remote ref targets master', () => {
+            const refs = [
+                {
+                    localRef: 'refs/heads/feature/x',
+                    localSha: '111',
+                    remoteRef: 'refs/heads/master',
+                    remoteSha: '000',
+                },
+            ];
+            const result = runGuard('feature/x', refs);
+            expect(result.allowed).toBe(false);
+        });
+        it('deduplicates error when both current branch and ref target main', () => {
+            const refs = [
+                {
+                    localRef: 'refs/heads/main',
+                    localSha: '111',
+                    remoteRef: 'refs/heads/main',
+                    remoteSha: '000',
+                },
+            ];
+            const result = runGuard('main', refs);
+            expect(result.allowed).toBe(false);
+            // Should have error about remote ref + error about pushing from main
+            // The current-branch check deduplicates if the branch name is already in errors
+            expect(result.errors.length).toBeGreaterThanOrEqual(1);
+        });
+    });
+    describe('branch convention warnings', () => {
+        it('does not warn on epic branches', () => {
+            const result = runGuard('epic/beth-abc');
+            expect(result.allowed).toBe(true);
+            expect(result.warnings).toHaveLength(0);
+        });
+        it('does not warn on release branches', () => {
+            const result = runGuard('release/v1.0.0');
+            expect(result.allowed).toBe(true);
+            expect(result.warnings).toHaveLength(0);
+        });
+        it('warns on unrecognized branch names', () => {
+            const result = runGuard('feature/random');
+            expect(result.allowed).toBe(true);
+            expect(result.warnings).toHaveLength(1);
+            expect(result.warnings[0]).toContain('feature/random');
+            expect(result.warnings[0]).toContain('epic/<id>');
+        });
+        it('warns on branches like dev or staging', () => {
+            const result = runGuard('dev');
+            expect(result.allowed).toBe(true);
+            expect(result.warnings[0]).toContain('dev');
+        });
+        it('handles null currentBranch (detached HEAD)', () => {
+            const result = runGuard(null);
+            expect(result.allowed).toBe(true);
+            expect(result.warnings).toHaveLength(0);
+            expect(result.errors).toHaveLength(0);
+        });
+    });
+    describe('happy path', () => {
+        it('allows push from epic branch to epic remote', () => {
+            const refs = [
+                {
+                    localRef: 'refs/heads/epic/beth-abc',
+                    localSha: '111',
+                    remoteRef: 'refs/heads/epic/beth-abc',
+                    remoteSha: '000',
+                },
+            ];
+            const result = runGuard('epic/beth-abc', refs);
+            expect(result.allowed).toBe(true);
+            expect(result.errors).toHaveLength(0);
+            expect(result.warnings).toHaveLength(0);
+        });
+        it('allows push from release branch', () => {
+            const refs = [
+                {
+                    localRef: 'refs/heads/release/v1.0.15',
+                    localSha: '111',
+                    remoteRef: 'refs/heads/release/v1.0.15',
+                    remoteSha: '000',
+                },
+            ];
+            const result = runGuard('release/v1.0.15', refs);
+            expect(result.allowed).toBe(true);
+        });
+        it('allows push with no refs (branch deletion)', () => {
+            const result = runGuard('epic/beth-abc', []);
+            expect(result.allowed).toBe(true);
+        });
+    });
+});
+// ─── generateHookScript ────────────────────────────────────────────────────────
+describe('generateHookScript', () => {
+    it('contains begin and end markers', () => {
+        const script = generateHookScript();
+        expect(script).toContain(BETH_GUARD_BEGIN);
+        expect(script).toContain(BETH_GUARD_END);
+    });
+    it('contains bypass check', () => {
+        const script = generateHookScript();
+        expect(script).toContain('BETH_SKIP_PUSH_GUARD');
+    });
+    it('blocks main and master', () => {
+        const script = generateHookScript();
+        expect(script).toContain('main|master');
+    });
+    it('checks for epic branch pattern', () => {
+        const script = generateHookScript();
+        expect(script).toContain('epic/*');
+    });
+    it('checks for release branch pattern', () => {
+        const script = generateHookScript();
+        expect(script).toContain('release/*');
+    });
+    it('outputs to stderr', () => {
+        const script = generateHookScript();
+        // All echo statements should go to stderr (>&2)
+        const echoLines = script
+            .split('\n')
+            .filter((line) => line.trim().startsWith('echo '));
+        for (const line of echoLines) {
+            expect(line).toContain('>&2');
+        }
+    });
+    it('exits 1 when blocked', () => {
+        const script = generateHookScript();
+        expect(script).toContain('exit 1');
+    });
+});
+//# sourceMappingURL=pre-push-guard.test.js.map

package/dist/cli/commands/pre-push-guard.test.js.map

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

package/dist/cli/commands/quickstart-expanded.e2e.test.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Expanded tests for quickstart command.
+ *
+ * beth-ywg.3: quickstart only had 13 tests, many conditional. This adds
+ * non-conditional tests for output format, error paths, and edge cases.
+ *
+ * Repro steps:
+ *   1. Build: npm run build
+ *   2. Run: npx vitest run src/cli/commands/quickstart-expanded.e2e.test.ts
+ *
+ * Test cases (non-conditional):
+ *   - Empty directory → exit 1, clear error about missing Beth
+ *   - Beth initialized but no skills → still runs doctor, reports warning
+ *   - Output contains "Quick Start Guide" heading or equivalent guidance
+ *   - Output mentions @Beth for starting sessions
+ *   - Exit code is numeric in all scenarios (no crashes)
+ *   - --verbose flag is accepted and produces more output
+ *   - Non-existent flag → graceful handling
+ *
+ * Expected outcomes documented inline per test case.
+ */
+export {};
+//# sourceMappingURL=quickstart-expanded.e2e.test.d.ts.map

package/dist/cli/commands/quickstart-expanded.e2e.test.d.ts.map

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

package/dist/cli/commands/quickstart-expanded.e2e.test.js

@@ -0,0 +1,152 @@
+/**
+ * Expanded tests for quickstart command.
+ *
+ * beth-ywg.3: quickstart only had 13 tests, many conditional. This adds
+ * non-conditional tests for output format, error paths, and edge cases.
+ *
+ * Repro steps:
+ *   1. Build: npm run build
+ *   2. Run: npx vitest run src/cli/commands/quickstart-expanded.e2e.test.ts
+ *
+ * Test cases (non-conditional):
+ *   - Empty directory → exit 1, clear error about missing Beth
+ *   - Beth initialized but no skills → still runs doctor, reports warning
+ *   - Output contains "Quick Start Guide" heading or equivalent guidance
+ *   - Output mentions @Beth for starting sessions
+ *   - Exit code is numeric in all scenarios (no crashes)
+ *   - --verbose flag is accepted and produces more output
+ *   - Non-existent flag → graceful handling
+ *
+ * Expected outcomes documented inline per test case.
+ */
+import { describe, it, beforeEach, afterEach } from 'vitest';
+import assert from 'node:assert';
+import { spawnSync } from 'child_process';
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'fs';
+import { delimiter, join, resolve } from 'path';
+import { tmpdir } from 'os';
+const CLI_PATH = resolve(join(import.meta.dirname, '..', '..', '..', 'bin', 'cli.js'));
+function runQuickstart(cwd, mockBinDir, args = []) {
+    const result = spawnSync('node', [CLI_PATH, 'quickstart', ...args], {
+        cwd,
+        encoding: 'utf-8',
+        env: {
+            ...process.env,
+            NO_COLOR: '1',
+            FORCE_COLOR: '0',
+            PATH: `${mockBinDir}${delimiter}${process.env.PATH ?? ''}`,
+        },
+        timeout: 30000,
+    });
+    return {
+        stdout: result.stdout || '',
+        stderr: result.stderr || '',
+        code: result.status ?? 1,
+    };
+}
+function createMinimalBethProject(dir) {
+    const agentsDir = join(dir, '.github', 'agents');
+    mkdirSync(agentsDir, { recursive: true });
+    writeFileSync(join(agentsDir, 'beth.agent.md'), '---\nname: Beth\ndescription: Test\nmodel: gpt-4\ntools:\n  - readFile\n---\n# Beth\n');
+}
+function createFullBethProject(dir) {
+    createMinimalBethProject(dir);
+    // Add skills directory
+    const skillDir = join(dir, '.github', 'skills', 'test-skill');
+    mkdirSync(skillDir, { recursive: true });
+    writeFileSync(join(skillDir, 'SKILL.md'), '# Test Skill\nTest content');
+}
+describe('quickstart expanded E2E tests', () => {
+    let testDir;
+    let mockBinDir;
+    beforeEach(() => {
+        testDir = join(tmpdir(), `beth-qs-expanded-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        mkdirSync(testDir, { recursive: true });
+        mockBinDir = join(testDir, 'mock-bin');
+        mkdirSync(mockBinDir, { recursive: true });
+    });
+    afterEach(() => {
+        if (existsSync(testDir)) {
+            rmSync(testDir, { recursive: true, force: true });
+        }
+    });
+    describe('empty directory (Beth not initialized)', () => {
+        // Expected: exit 1, clear error about Beth not being set up
+        it('should exit 1 in an empty directory', () => {
+            const result = runQuickstart(testDir, mockBinDir);
+            assert.strictEqual(result.code, 1, 'Should exit 1 when Beth is not initialized');
+        });
+        it('should tell user to run init first', () => {
+            const result = runQuickstart(testDir, mockBinDir);
+            const combined = result.stdout + result.stderr;
+            assert.ok(combined.includes('init') || combined.includes('not initialized'), 'Should suggest running init');
+        });
+        it('should not crash with unhandled exception', () => {
+            const result = runQuickstart(testDir, mockBinDir);
+            assert.ok(!result.stderr.includes('TypeError') && !result.stderr.includes('ReferenceError'), 'Should not have unhandled JS errors');
+        });
+    });
+    describe('Beth initialized without skills', () => {
+        // Expected: quickstart proceeds past Beth check, may warn about missing skills
+        it('should detect Beth is initialized even without skills', () => {
+            createMinimalBethProject(testDir);
+            const result = runQuickstart(testDir, mockBinDir);
+            const combined = result.stdout + result.stderr;
+            assert.ok(combined.includes('initialized') || combined.includes('✓') || combined.includes('Beth'), 'Should acknowledge Beth is present');
+        });
+    });
+    describe('Beth fully initialized', () => {
+        it('should proceed past Beth initialization check', () => {
+            createFullBethProject(testDir);
+            const result = runQuickstart(testDir, mockBinDir);
+            const combined = result.stdout + result.stderr;
+            // Should get past the "not initialized" gate
+            assert.ok(!combined.includes('not initialized') || combined.includes('✓'), 'Should not show "not initialized" error');
+        });
+    });
+    describe('output format and content', () => {
+        it('should produce non-empty stdout', () => {
+            createFullBethProject(testDir);
+            const result = runQuickstart(testDir, mockBinDir);
+            assert.ok(result.stdout.length > 0 || result.stderr.length > 0, 'Should produce some output');
+        });
+        it('should mention @Beth or VS Code in guidance', () => {
+            createFullBethProject(testDir);
+            const result = runQuickstart(testDir, mockBinDir);
+            const combined = result.stdout + result.stderr;
+            assert.ok(combined.includes('@Beth') || combined.includes('VS Code') || combined.includes('Copilot'), 'Should include actionable guidance mentioning @Beth or VS Code');
+        });
+    });
+    describe('--verbose flag', () => {
+        it('should accept --verbose without error', () => {
+            createFullBethProject(testDir);
+            const result = runQuickstart(testDir, mockBinDir, ['--verbose']);
+            // Should not reject the flag
+            assert.ok(!result.stderr.includes('Unknown flag'), '--verbose should be accepted');
+        });
+        it('should produce equal or more output with --verbose', () => {
+            createFullBethProject(testDir);
+            const normal = runQuickstart(testDir, mockBinDir);
+            const verbose = runQuickstart(testDir, mockBinDir, ['--verbose']);
+            assert.ok(verbose.stdout.length >= normal.stdout.length || verbose.stderr.length >= normal.stderr.length, '--verbose should produce at least as much output');
+        });
+    });
+    describe('resilience', () => {
+        it('should handle directory with no permissions gracefully', () => {
+            // Create a directory structure that exists but has weird contents
+            createMinimalBethProject(testDir);
+            // Write a corrupt agent file
+            writeFileSync(join(testDir, '.github', 'agents', 'broken.agent.md'), 'this is not valid frontmatter at all {{{');
+            const result = runQuickstart(testDir, mockBinDir);
+            // Should not crash — may warn or fail gracefully
+            assert.ok(typeof result.code === 'number', 'Should exit with a numeric code, not crash');
+        });
+        it('should handle very deep nested directories', () => {
+            const deepDir = join(testDir, 'a', 'b', 'c', 'd', 'e');
+            mkdirSync(deepDir, { recursive: true });
+            const result = runQuickstart(deepDir, mockBinDir);
+            assert.strictEqual(result.code, 1, 'Should exit 1 (no Beth project in deep dir)');
+        });
+    });
+});
+//# sourceMappingURL=quickstart-expanded.e2e.test.js.map

package/dist/cli/commands/quickstart-expanded.e2e.test.js.map

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

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

@@ -4,7 +4,6 @@
  * Streamlined setup for Beth:
  * - Checks if Beth is already initialized
  * - Runs doctor to validate setup
- * - Initializes beads if needed
  * - Prints "what's next" guidance
  */
 interface QuickstartOptions {

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

@@ -1 +1 @@
-{"version":3,"file":"quickstart.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/quickstart.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAiED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuF/E"}
+{"version":3,"file":"quickstart.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/quickstart.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA0BD;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4C/E"}