ghagga 2.0.1 → 2.2.0

package/dist/lib/git-hooks.test.js

@@ -0,0 +1,178 @@
+/**
+ * Tests for git hook utilities (install, uninstall, status).
+ *
+ * Mocks node:fs, node:child_process, and node:path to test
+ * isGitRepo, getHooksDir, getHookStatus, installHook, and uninstallHook
+ * without touching the real filesystem or git.
+ *
+ * @see Phase 4, Test 2
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { HOOK_MARKER } from './hooks-types.js';
+// ─── Mocks ──────────────────────────────────────────────────────
+const { mockExecSync, mockExistsSync, mockReadFileSync, mockWriteFileSync, mockUnlinkSync, mockRenameSync, mockChmodSync, } = vi.hoisted(() => ({
+    mockExecSync: vi.fn(),
+    mockExistsSync: vi.fn(),
+    mockReadFileSync: vi.fn(),
+    mockWriteFileSync: vi.fn(),
+    mockUnlinkSync: vi.fn(),
+    mockRenameSync: vi.fn(),
+    mockChmodSync: vi.fn(),
+}));
+vi.mock('node:child_process', () => ({
+    execSync: (...args) => mockExecSync(...args),
+}));
+vi.mock('node:fs', () => ({
+    existsSync: (...args) => mockExistsSync(...args),
+    readFileSync: (...args) => mockReadFileSync(...args),
+    writeFileSync: (...args) => mockWriteFileSync(...args),
+    unlinkSync: (...args) => mockUnlinkSync(...args),
+    renameSync: (...args) => mockRenameSync(...args),
+    chmodSync: (...args) => mockChmodSync(...args),
+}));
+import { isGitRepo, getHooksDir, getHookStatus, installHook, uninstallHook, } from './git-hooks.js';
+// ─── Setup ──────────────────────────────────────────────────────
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+// ─── isGitRepo ──────────────────────────────────────────────────
+describe('isGitRepo', () => {
+    it('returns true when inside a git repository', () => {
+        mockExecSync.mockReturnValue('.git');
+        expect(isGitRepo()).toBe(true);
+        expect(mockExecSync).toHaveBeenCalledWith('git rev-parse --git-dir', { stdio: 'pipe' });
+    });
+    it('returns false when outside a git repository', () => {
+        mockExecSync.mockImplementation(() => {
+            throw new Error('not a git repository');
+        });
+        expect(isGitRepo()).toBe(false);
+    });
+});
+// ─── getHooksDir ────────────────────────────────────────────────
+describe('getHooksDir', () => {
+    it('returns default .git/hooks when no core.hooksPath is set', () => {
+        mockExecSync
+            .mockImplementationOnce(() => {
+            // core.hooksPath fails (not set)
+            throw new Error('key does not exist');
+        })
+            .mockReturnValueOnce('.git\n'); // git rev-parse --git-dir
+        const result = getHooksDir();
+        expect(result).toMatch(/\.git[/\\]hooks$/);
+    });
+    it('respects core.hooksPath config when set', () => {
+        mockExecSync.mockReturnValueOnce('/custom/hooks-dir\n'); // core.hooksPath
+        const result = getHooksDir();
+        expect(result).toBe('/custom/hooks-dir');
+    });
+});
+// ─── getHookStatus ──────────────────────────────────────────────
+describe('getHookStatus', () => {
+    it('returns not installed when hook file does not exist', () => {
+        mockExistsSync.mockReturnValue(false);
+        const status = getHookStatus('/repo/.git/hooks', 'pre-commit');
+        expect(status.installed).toBe(false);
+        expect(status.managedByGhagga).toBe(false);
+        expect(status.type).toBe('pre-commit');
+    });
+    it('returns managed when GHAGGA marker is found in hook file', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(`#!/bin/sh\n${HOOK_MARKER}\nexec ghagga review`);
+        const status = getHookStatus('/repo/.git/hooks', 'pre-commit');
+        expect(status.installed).toBe(true);
+        expect(status.managedByGhagga).toBe(true);
+    });
+    it('returns not managed when external hook exists (no marker)', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue('#!/bin/sh\necho "custom hook"');
+        const status = getHookStatus('/repo/.git/hooks', 'commit-msg');
+        expect(status.installed).toBe(true);
+        expect(status.managedByGhagga).toBe(false);
+        expect(status.type).toBe('commit-msg');
+    });
+});
+// ─── installHook ────────────────────────────────────────────────
+describe('installHook', () => {
+    const hookContent = `#!/bin/sh\n${HOOK_MARKER}\nexec ghagga review`;
+    it('creates a new hook file when none exists', () => {
+        mockExistsSync.mockReturnValue(false);
+        const result = installHook('/repo/.git/hooks', 'pre-commit', hookContent, false);
+        expect(result.success).toBe(true);
+        expect(result.type).toBe('pre-commit');
+        expect(result.message).toContain('Installed pre-commit hook');
+        expect(result.backedUp).toBeFalsy();
+        expect(mockWriteFileSync).toHaveBeenCalledWith(expect.stringContaining('pre-commit'), hookContent, { mode: 0o755 });
+        expect(mockChmodSync).toHaveBeenCalled();
+    });
+    it('overwrites GHAGGA-managed hooks without --force', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(`#!/bin/sh\n${HOOK_MARKER}\nold content`);
+        const result = installHook('/repo/.git/hooks', 'pre-commit', hookContent, false);
+        expect(result.success).toBe(true);
+        expect(result.backedUp).toBeFalsy();
+        expect(mockWriteFileSync).toHaveBeenCalled();
+        // Should NOT have been backed up (renamed)
+        expect(mockRenameSync).not.toHaveBeenCalled();
+    });
+    it('refuses to overwrite external hooks without --force', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue('#!/bin/sh\necho "external"');
+        const result = installHook('/repo/.git/hooks', 'pre-commit', hookContent, false);
+        expect(result.success).toBe(false);
+        expect(result.message).toContain('already exists');
+        expect(result.message).toContain('--force');
+        expect(mockWriteFileSync).not.toHaveBeenCalled();
+    });
+    it('backs up external hooks with --force and installs', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue('#!/bin/sh\necho "external"');
+        const result = installHook('/repo/.git/hooks', 'pre-commit', hookContent, true);
+        expect(result.success).toBe(true);
+        expect(result.backedUp).toBe(true);
+        expect(result.message).toContain('backed up');
+        expect(result.message).toContain('.ghagga-backup');
+        expect(mockRenameSync).toHaveBeenCalledWith(expect.stringContaining('pre-commit'), expect.stringContaining('pre-commit.ghagga-backup'));
+        expect(mockWriteFileSync).toHaveBeenCalled();
+    });
+});
+// ─── uninstallHook ──────────────────────────────────────────────
+describe('uninstallHook', () => {
+    it('removes GHAGGA-managed hooks', () => {
+        mockExistsSync
+            .mockReturnValueOnce(true) // hook exists
+            .mockReturnValueOnce(false); // no backup
+        mockReadFileSync.mockReturnValue(`#!/bin/sh\n${HOOK_MARKER}\nexec ghagga review`);
+        const result = uninstallHook('/repo/.git/hooks', 'pre-commit');
+        expect(result.success).toBe(true);
+        expect(result.message).toContain('Removed pre-commit hook');
+        expect(mockUnlinkSync).toHaveBeenCalled();
+    });
+    it('skips external hooks (not managed by GHAGGA)', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue('#!/bin/sh\necho "external"');
+        const result = uninstallHook('/repo/.git/hooks', 'commit-msg');
+        expect(result.success).toBe(false);
+        expect(result.message).toContain('not managed by GHAGGA');
+        expect(mockUnlinkSync).not.toHaveBeenCalled();
+    });
+    it('restores backup when present after removing GHAGGA hook', () => {
+        mockExistsSync
+            .mockReturnValueOnce(true) // hook exists
+            .mockReturnValueOnce(true); // backup exists
+        mockReadFileSync.mockReturnValue(`#!/bin/sh\n${HOOK_MARKER}\nexec ghagga review`);
+        const result = uninstallHook('/repo/.git/hooks', 'pre-commit');
+        expect(result.success).toBe(true);
+        expect(result.message).toContain('restored previous hook from backup');
+        expect(mockUnlinkSync).toHaveBeenCalled();
+        expect(mockRenameSync).toHaveBeenCalledWith(expect.stringContaining('.ghagga-backup'), expect.stringContaining('pre-commit'));
+    });
+    it('handles not-installed case gracefully', () => {
+        mockExistsSync.mockReturnValue(false);
+        const result = uninstallHook('/repo/.git/hooks', 'pre-commit');
+        expect(result.success).toBe(true);
+        expect(result.message).toContain('not installed');
+        expect(mockUnlinkSync).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=git-hooks.test.js.map

package/dist/lib/git-hooks.test.js.map

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

package/dist/lib/git.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Git remote utilities for project identification.
+ *
+ * Resolves the project identifier from the git remote origin URL,
+ * normalizing it to "owner/repo" format for memory scoping.
+ */
+/**
+ * Resolve the project identifier from the git remote origin.
+ * Normalizes various URL formats to "owner/repo".
+ * Falls back to "local/unknown" if no remote is configured.
+ */
+export declare function resolveProjectId(repoPath: string): string;
+/**
+ * Get diff of staged files only.
+ * Returns an empty string if there are no staged changes or on error.
+ */
+export declare function getStagedDiff(repoPath: string): string;
+/**
+ * Get list of staged file paths.
+ * Returns an empty array if there are no staged files or on error.
+ */
+export declare function getStagedFiles(repoPath: string): string[];
+/**
+ * Normalize a git remote URL to "owner/repo" format.
+ *
+ * Handles:
+ *   https://github.com/owner/repo.git  → owner/repo
+ *   git@github.com:owner/repo.git      → owner/repo
+ *   ssh://git@github.com/owner/repo    → owner/repo
+ *   https://gitlab.com/owner/repo.git  → owner/repo
+ */
+export declare function normalizeRemoteUrl(url: string): string;
+//# sourceMappingURL=git.d.ts.map

package/dist/lib/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/lib/git.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAUzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmBtD"}

package/dist/lib/git.js

@@ -0,0 +1,85 @@
+/**
+ * Git remote utilities for project identification.
+ *
+ * Resolves the project identifier from the git remote origin URL,
+ * normalizing it to "owner/repo" format for memory scoping.
+ */
+import { execSync } from 'node:child_process';
+/**
+ * Resolve the project identifier from the git remote origin.
+ * Normalizes various URL formats to "owner/repo".
+ * Falls back to "local/unknown" if no remote is configured.
+ */
+export function resolveProjectId(repoPath) {
+    try {
+        const remoteUrl = execSync('git remote get-url origin', {
+            cwd: repoPath,
+            encoding: 'utf-8',
+        }).trim();
+        return normalizeRemoteUrl(remoteUrl);
+    }
+    catch {
+        return 'local/unknown';
+    }
+}
+/**
+ * Get diff of staged files only.
+ * Returns an empty string if there are no staged changes or on error.
+ */
+export function getStagedDiff(repoPath) {
+    try {
+        return execSync('git diff --cached', {
+            cwd: repoPath,
+            encoding: 'utf-8',
+            maxBuffer: 10 * 1024 * 1024,
+        });
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Get list of staged file paths.
+ * Returns an empty array if there are no staged files or on error.
+ */
+export function getStagedFiles(repoPath) {
+    try {
+        const output = execSync('git diff --cached --name-only', {
+            cwd: repoPath,
+            encoding: 'utf-8',
+        });
+        return output.trim().split('\n').filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Normalize a git remote URL to "owner/repo" format.
+ *
+ * Handles:
+ *   https://github.com/owner/repo.git  → owner/repo
+ *   git@github.com:owner/repo.git      → owner/repo
+ *   ssh://git@github.com/owner/repo    → owner/repo
+ *   https://gitlab.com/owner/repo.git  → owner/repo
+ */
+export function normalizeRemoteUrl(url) {
+    let cleaned = url;
+    // Strip .git suffix
+    cleaned = cleaned.replace(/\.git$/, '');
+    // SSH format: git@host:owner/repo
+    const sshMatch = cleaned.match(/^[\w-]+@[\w.-]+:(.+)$/);
+    if (sshMatch)
+        return sshMatch[1];
+    // HTTPS / SSH protocol: extract path after host
+    try {
+        const parsed = new URL(cleaned);
+        // Remove leading slash
+        return parsed.pathname.replace(/^\//, '');
+    }
+    catch {
+        // Not a valid URL — return as-is or fallback
+        return 'local/unknown';
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/lib/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/lib/git.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,QAAQ,CAAC,2BAA2B,EAAE;YACtD,GAAG,EAAE,QAAQ;YACb,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,eAAe,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,mBAAmB,EAAE;YACnC,GAAG,EAAE,QAAQ;YACb,QAAQ,EAAE,OAAO;YACjB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SAC5B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,+BAA+B,EAAE;YACvD,GAAG,EAAE,QAAQ;YACb,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,OAAO,GAAG,GAAG,CAAC;IAElB,oBAAoB;IACpB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAExC,kCAAkC;IAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACxD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAE,CAAC;IAElC,gDAAgD;IAChD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAChC,uBAAuB;QACvB,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;QAC7C,OAAO,eAAe,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/lib/git.test.d.ts

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

package/dist/lib/git.test.d.ts.map

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

package/dist/lib/git.test.js

@@ -0,0 +1,65 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+// ─── Mocks ──────────────────────────────────────────────────────
+vi.mock('node:child_process', () => ({
+    execSync: vi.fn(),
+}));
+import { execSync } from 'node:child_process';
+import { resolveProjectId, normalizeRemoteUrl } from './git.js';
+const mockExecSync = vi.mocked(execSync);
+// ─── Tests ──────────────────────────────────────────────────────
+describe('normalizeRemoteUrl', () => {
+    it('normalizes HTTPS URL with .git suffix', () => {
+        expect(normalizeRemoteUrl('https://github.com/acme/widgets.git')).toBe('acme/widgets');
+    });
+    it('normalizes HTTPS URL without .git suffix', () => {
+        expect(normalizeRemoteUrl('https://github.com/acme/widgets')).toBe('acme/widgets');
+    });
+    it('normalizes SSH URL (git@host:owner/repo.git)', () => {
+        expect(normalizeRemoteUrl('git@github.com:acme/widgets.git')).toBe('acme/widgets');
+    });
+    it('normalizes SSH URL without .git suffix', () => {
+        expect(normalizeRemoteUrl('git@github.com:acme/widgets')).toBe('acme/widgets');
+    });
+    it('normalizes ssh:// protocol URL', () => {
+        expect(normalizeRemoteUrl('ssh://git@github.com/acme/widgets.git')).toBe('acme/widgets');
+    });
+    it('normalizes ssh:// protocol URL without .git suffix', () => {
+        expect(normalizeRemoteUrl('ssh://git@github.com/acme/widgets')).toBe('acme/widgets');
+    });
+    it('normalizes GitLab HTTPS URL', () => {
+        expect(normalizeRemoteUrl('https://gitlab.com/acme/widgets.git')).toBe('acme/widgets');
+    });
+    it('normalizes GitLab SSH URL', () => {
+        expect(normalizeRemoteUrl('git@gitlab.com:acme/widgets.git')).toBe('acme/widgets');
+    });
+    it('returns local/unknown for invalid URL', () => {
+        expect(normalizeRemoteUrl('not-a-valid-url')).toBe('local/unknown');
+    });
+});
+describe('resolveProjectId', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('resolves HTTPS remote to owner/repo', () => {
+        mockExecSync.mockReturnValue('https://github.com/acme/widgets.git\n');
+        expect(resolveProjectId('/path/to/repo')).toBe('acme/widgets');
+        expect(mockExecSync).toHaveBeenCalledWith('git remote get-url origin', {
+            cwd: '/path/to/repo',
+            encoding: 'utf-8',
+        });
+    });
+    it('resolves SSH remote to owner/repo', () => {
+        mockExecSync.mockReturnValue('git@github.com:acme/widgets.git\n');
+        expect(resolveProjectId('/path/to/repo')).toBe('acme/widgets');
+    });
+    it('falls back to local/unknown when no remote is configured', () => {
+        mockExecSync.mockImplementation(() => { throw new Error('fatal: No such remote'); });
+        expect(resolveProjectId('/path/to/repo')).toBe('local/unknown');
+    });
+    it('passes repoPath as cwd to execSync', () => {
+        mockExecSync.mockReturnValue('https://github.com/org/repo.git\n');
+        resolveProjectId('/custom/work/dir');
+        expect(mockExecSync).toHaveBeenCalledWith('git remote get-url origin', expect.objectContaining({ cwd: '/custom/work/dir' }));
+    });
+});
+//# sourceMappingURL=git.test.js.map

package/dist/lib/git.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.test.js","sourceRoot":"","sources":["../../src/lib/git.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE9D,mEAAmE;AAEnE,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC;IACnC,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;CAClB,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEhE,MAAM,YAAY,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEzC,mEAAmE;AAEnE,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,kBAAkB,CAAC,qCAAqC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,kBAAkB,CAAC,iCAAiC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,kBAAkB,CAAC,iCAAiC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,kBAAkB,CAAC,6BAA6B,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,kBAAkB,CAAC,uCAAuC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,kBAAkB,CAAC,mCAAmC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,kBAAkB,CAAC,qCAAqC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,kBAAkB,CAAC,iCAAiC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,YAAY,CAAC,eAAe,CAAC,uCAAuC,CAAC,CAAC;QAEtE,MAAM,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/D,MAAM,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,2BAA2B,EAAE;YACrE,GAAG,EAAE,eAAe;YACpB,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,YAAY,CAAC,eAAe,CAAC,mCAAmC,CAAC,CAAC;QAElE,MAAM,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,YAAY,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAErF,MAAM,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,YAAY,CAAC,eAAe,CAAC,mCAAmC,CAAC,CAAC;QAElE,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;QAErC,MAAM,CAAC,YAAY,CAAC,CAAC,oBAAoB,CACvC,2BAA2B,EAC3B,MAAM,CAAC,gBAAgB,CAAC,EAAE,GAAG,EAAE,kBAAkB,EAAE,CAAC,CACrD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/hook-templates.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Hook script templates for pre-commit and commit-msg hooks.
+ *
+ * Pure functions that return POSIX shell script strings.
+ * Each script includes the GHAGGA marker, a PATH check with
+ * graceful degradation, and the appropriate ghagga CLI invocation.
+ */
+/** Generate the pre-commit hook script */
+export declare function generatePreCommitHook(extraArgs?: string): string;
+/** Generate the commit-msg hook script */
+export declare function generateCommitMsgHook(extraArgs?: string): string;
+//# sourceMappingURL=hook-templates.d.ts.map

package/dist/lib/hook-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-templates.d.ts","sourceRoot":"","sources":["../../src/lib/hook-templates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,0CAA0C;AAC1C,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAsBhE;AAED,0CAA0C;AAC1C,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAiBhE"}

package/dist/lib/hook-templates.js

@@ -0,0 +1,52 @@
+/**
+ * Hook script templates for pre-commit and commit-msg hooks.
+ *
+ * Pure functions that return POSIX shell script strings.
+ * Each script includes the GHAGGA marker, a PATH check with
+ * graceful degradation, and the appropriate ghagga CLI invocation.
+ */
+import { HOOK_MARKER } from './hooks-types.js';
+/** Generate the pre-commit hook script */
+export function generatePreCommitHook(extraArgs) {
+    const args = extraArgs ? ` ${extraArgs}` : '';
+    return `#!/bin/sh
+${HOOK_MARKER}
+# Installed by: ghagga hooks install
+# To remove: ghagga hooks uninstall
+
+# Check if ghagga is available
+if ! command -v ghagga >/dev/null 2>&1; then
+  echo "Warning: ghagga not found in PATH. Skipping pre-commit review."
+  echo "Install: npm install -g ghagga"
+  exit 0
+fi
+
+# Check if there are staged changes
+if git diff --cached --quiet; then
+  exit 0
+fi
+
+# Run review on staged files
+exec ghagga review --staged --plain --exit-on-issues${args}
+`;
+}
+/** Generate the commit-msg hook script */
+export function generateCommitMsgHook(extraArgs) {
+    const args = extraArgs ? ` ${extraArgs}` : '';
+    return `#!/bin/sh
+${HOOK_MARKER}
+# Installed by: ghagga hooks install
+# To remove: ghagga hooks uninstall
+
+# Check if ghagga is available
+if ! command -v ghagga >/dev/null 2>&1; then
+  echo "Warning: ghagga not found in PATH. Skipping commit message review."
+  echo "Install: npm install -g ghagga"
+  exit 0
+fi
+
+# Validate commit message
+exec ghagga review --commit-msg "$1" --plain --exit-on-issues${args}
+`;
+}
+//# sourceMappingURL=hook-templates.js.map

package/dist/lib/hook-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-templates.js","sourceRoot":"","sources":["../../src/lib/hook-templates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,0CAA0C;AAC1C,MAAM,UAAU,qBAAqB,CAAC,SAAkB;IACtD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,OAAO;EACP,WAAW;;;;;;;;;;;;;;;;;sDAiByC,IAAI;CACzD,CAAC;AACF,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,qBAAqB,CAAC,SAAkB;IACtD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,OAAO;EACP,WAAW;;;;;;;;;;;;+DAYkD,IAAI;CAClE,CAAC;AACF,CAAC"}

package/dist/lib/hook-templates.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tests for hook script template generators.
+ *
+ * Validates that generatePreCommitHook() and generateCommitMsgHook()
+ * produce correct POSIX shell scripts with the GHAGGA marker,
+ * PATH checks, and appropriate CLI invocations.
+ *
+ * @see Phase 4, Test 1
+ */
+export {};
+//# sourceMappingURL=hook-templates.test.d.ts.map

package/dist/lib/hook-templates.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-templates.test.d.ts","sourceRoot":"","sources":["../../src/lib/hook-templates.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/lib/hook-templates.test.js

@@ -0,0 +1,76 @@
+/**
+ * Tests for hook script template generators.
+ *
+ * Validates that generatePreCommitHook() and generateCommitMsgHook()
+ * produce correct POSIX shell scripts with the GHAGGA marker,
+ * PATH checks, and appropriate CLI invocations.
+ *
+ * @see Phase 4, Test 1
+ */
+import { describe, it, expect } from 'vitest';
+import { generatePreCommitHook, generateCommitMsgHook } from './hook-templates.js';
+import { HOOK_MARKER } from './hooks-types.js';
+// ─── pre-commit template ────────────────────────────────────────
+describe('generatePreCommitHook', () => {
+    it('starts with #!/bin/sh shebang', () => {
+        const script = generatePreCommitHook();
+        expect(script.startsWith('#!/bin/sh\n')).toBe(true);
+    });
+    it('includes the GHAGGA marker comment', () => {
+        const script = generatePreCommitHook();
+        expect(script).toContain(HOOK_MARKER);
+    });
+    it('includes the ghagga review --staged command', () => {
+        const script = generatePreCommitHook();
+        expect(script).toContain('ghagga review --staged --plain --exit-on-issues');
+    });
+    it('includes PATH check with graceful fallback', () => {
+        const script = generatePreCommitHook();
+        expect(script).toContain('command -v ghagga');
+        expect(script).toContain('ghagga not found in PATH');
+        expect(script).toContain('exit 0');
+    });
+    it('includes empty staged check (git diff --cached --quiet)', () => {
+        const script = generatePreCommitHook();
+        expect(script).toContain('git diff --cached --quiet');
+    });
+    it('appends extra args when provided', () => {
+        const script = generatePreCommitHook('--quick');
+        expect(script).toContain('ghagga review --staged --plain --exit-on-issues --quick');
+    });
+    it('does not append extra args when not provided', () => {
+        const script = generatePreCommitHook();
+        // Should end the exec line without trailing args
+        expect(script).toContain('exec ghagga review --staged --plain --exit-on-issues\n');
+    });
+});
+// ─── commit-msg template ────────────────────────────────────────
+describe('generateCommitMsgHook', () => {
+    it('starts with #!/bin/sh shebang', () => {
+        const script = generateCommitMsgHook();
+        expect(script.startsWith('#!/bin/sh\n')).toBe(true);
+    });
+    it('includes the GHAGGA marker comment', () => {
+        const script = generateCommitMsgHook();
+        expect(script).toContain(HOOK_MARKER);
+    });
+    it('includes the ghagga review --commit-msg command', () => {
+        const script = generateCommitMsgHook();
+        expect(script).toContain('ghagga review --commit-msg "$1" --plain --exit-on-issues');
+    });
+    it('includes PATH check with graceful fallback', () => {
+        const script = generateCommitMsgHook();
+        expect(script).toContain('command -v ghagga');
+        expect(script).toContain('ghagga not found in PATH');
+        expect(script).toContain('exit 0');
+    });
+    it('appends extra args when provided', () => {
+        const script = generateCommitMsgHook('--quick');
+        expect(script).toContain('ghagga review --commit-msg "$1" --plain --exit-on-issues --quick');
+    });
+    it('does not append extra args when not provided', () => {
+        const script = generateCommitMsgHook();
+        expect(script).toContain('exec ghagga review --commit-msg "$1" --plain --exit-on-issues\n');
+    });
+});
+//# sourceMappingURL=hook-templates.test.js.map

package/dist/lib/hook-templates.test.js.map

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

package/dist/lib/hooks-types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Hook-related type definitions for the GHAGGA CLI.
+ *
+ * Used by git-hooks utilities, hook templates, and the hooks
+ * command group (install, uninstall, status).
+ */
+/** Marker comment identifying GHAGGA-managed hooks */
+export declare const HOOK_MARKER = "# GHAGGA-MANAGED-HOOK \u2014 do not edit";
+/** Supported git hook types */
+export type HookType = 'pre-commit' | 'commit-msg';
+/** Result of a hook status check */
+export interface HookStatus {
+    type: HookType;
+    installed: boolean;
+    managedByGhagga: boolean;
+    path: string;
+}
+/** Options for hook installation */
+export interface HookInstallOptions {
+    force?: boolean;
+}
+/** Result of install/uninstall operations */
+export interface HookOperationResult {
+    type: HookType;
+    success: boolean;
+    message: string;
+    /** Previous hook content if backed up */
+    backedUp?: boolean;
+}
+//# sourceMappingURL=hooks-types.d.ts.map

package/dist/lib/hooks-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-types.d.ts","sourceRoot":"","sources":["../../src/lib/hooks-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sDAAsD;AACtD,eAAO,MAAM,WAAW,6CAAwC,CAAC;AAEjE,+BAA+B;AAC/B,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,YAAY,CAAC;AAEnD,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oCAAoC;AACpC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/lib/hooks-types.js

@@ -0,0 +1,9 @@
+/**
+ * Hook-related type definitions for the GHAGGA CLI.
+ *
+ * Used by git-hooks utilities, hook templates, and the hooks
+ * command group (install, uninstall, status).
+ */
+/** Marker comment identifying GHAGGA-managed hooks */
+export const HOOK_MARKER = '# GHAGGA-MANAGED-HOOK — do not edit';
+//# sourceMappingURL=hooks-types.js.map

package/dist/lib/hooks-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-types.js","sourceRoot":"","sources":["../../src/lib/hooks-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sDAAsD;AACtD,MAAM,CAAC,MAAM,WAAW,GAAG,qCAAqC,CAAC"}

package/dist/lib/oauth.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * OAuth device flow tests.
+ *
+ * Tests requestDeviceCode(), pollForAccessToken(), and fetchGitHubUser()
+ * with mocked global fetch and fake timers for the polling loop.
+ */
+export {};
+//# sourceMappingURL=oauth.test.d.ts.map

package/dist/lib/oauth.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.test.d.ts","sourceRoot":"","sources":["../../src/lib/oauth.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}