ghagga 2.0.1 → 2.2.0

package/README.md

@@ -3,8 +3,8 @@
 AI-powered code review from the command line. **Free** with GitHub Models.
 
 ```bash
-npx @ghagga/cli login
-npx @ghagga/cli review
+npx ghagga login
+npx ghagga review
 ```
 
 That's it. Zero config, zero cost.
@@ -24,7 +24,7 @@ GHAGGA is a multi-agent AI code reviewer that analyzes your code changes using L
 ### 1. Login (one time)
 
 ```bash
-npx @ghagga/cli login
+npx ghagga login
 ```
 
 This authenticates with GitHub using Device Flow. Your GitHub token gives you **free access** to AI models via [GitHub Models](https://github.com/marketplace/models).
@@ -33,23 +33,39 @@ This authenticates with GitHub using Device Flow. Your GitHub token gives you **
 
 ```bash
 # Review staged/uncommitted changes (simple mode)
-npx @ghagga/cli review
+npx ghagga review
 
 # Thorough review with 5 specialist agents
-npx @ghagga/cli review --mode workflow
+npx ghagga review --mode workflow
 
 # Balanced review with for/against/neutral voting
-npx @ghagga/cli review --mode consensus
+npx ghagga review --mode consensus
 
 # See detailed progress of each step
-npx @ghagga/cli review --mode workflow --verbose
+npx ghagga review --mode workflow --verbose
 ```
 
 ### 3. Check your status
 
 ```bash
-npx @ghagga/cli status    # Show auth & config
-npx @ghagga/cli logout    # Clear credentials
+npx ghagga status    # Show auth & config
+npx ghagga logout    # Clear credentials
+```
+
+### 4. Install git hooks (optional)
+
+```bash
+npx ghagga hooks install    # Auto-review on every commit
+npx ghagga hooks status     # Check hook status
+npx ghagga hooks uninstall  # Remove hooks
+```
+
+### 5. Manage review memory
+
+```bash
+npx ghagga memory list                    # List stored observations
+npx ghagga memory search "error handling" # Search by content
+npx ghagga memory stats                   # Database statistics
 ```
 
 ## Global Installation
@@ -57,21 +73,31 @@ npx @ghagga/cli logout    # Clear credentials
 If you use it frequently:
 
 ```bash
-npm install -g @ghagga/cli
+npm install -g ghagga
 
 ghagga login
 ghagga review
 ghagga review -m workflow -v
 ```
 
-## Options
+## Global Options
+
+```
+  --plain     Disable styled terminal output (auto-enabled in non-TTY/CI)
+  --version   Show version number
+  --help      Show help
+```
+
+> The CLI uses [`@clack/prompts`](https://github.com/natemoo-re/clack) for styled terminal output (spinners, colored headers). In non-TTY or CI environments, output automatically falls back to plain `console.log`.
+
+## Review Options
 
 ```
 Usage: ghagga review [options] [path]
 
 Options:
   -m, --mode <mode>          Review mode: simple, workflow, consensus (default: "simple")
-  -p, --provider <provider>  LLM provider: github, openai, anthropic, google
+  -p, --provider <provider>  LLM provider: github, anthropic, openai, google, ollama, qwen
   --model <model>            LLM model identifier
   --api-key <key>            LLM provider API key
   -f, --format <format>      Output format: markdown, json (default: "markdown")
@@ -79,9 +105,43 @@ Options:
   --no-semgrep               Disable Semgrep static analysis
   --no-trivy                 Disable Trivy vulnerability scanning
   --no-cpd                   Disable CPD duplicate detection
+  --no-memory                Disable review memory (skip search and persist)
+  --memory-backend <type>    Memory backend: sqlite (default) or engram
+  --staged                   Review only staged files (for pre-commit hook)
+  --quick                    Static analysis only, skip AI review (~5-10s)
+  --commit-msg <file>        Validate commit message from file
+  --exit-on-issues           Exit with code 1 if critical/high issues found
   -c, --config <path>        Path to .ghagga.json config file
 ```
 
+## Git Hooks
+
+Install git hooks for automatic code review on every commit:
+
+```bash
+ghagga hooks install                  # Install pre-commit + commit-msg hooks
+ghagga hooks install --force          # Overwrite existing hooks (backs up originals)
+ghagga hooks install --pre-commit     # Only pre-commit hook
+ghagga hooks install --commit-msg     # Only commit-msg hook
+ghagga hooks uninstall                # Remove GHAGGA-managed hooks
+ghagga hooks status                   # Show hook status
+```
+
+Hooks auto-detect `ghagga` in PATH and fail gracefully if not found. Installed hooks use `--plain --exit-on-issues` automatically.
+
+## Memory Subcommands
+
+```bash
+ghagga memory list [--repo <owner/repo>] [--type <type>] [--limit <n>]
+ghagga memory search [--repo <owner/repo>] [--limit <n>] <query>
+ghagga memory show <id>
+ghagga memory delete [--force] <id>
+ghagga memory stats
+ghagga memory clear [--repo <owner/repo>] [--force]
+```
+
+Memory is stored locally at `~/.config/ghagga/memory.db` (SQLite + FTS5). Observations are automatically extracted from reviews and used to provide context in future reviews.
+
 ## BYOK (Bring Your Own Key)
 
 Use any supported LLM provider:
@@ -102,6 +162,9 @@ ghagga review --provider anthropic --api-key sk-ant-...
 
 # Google
 ghagga review --provider google --api-key AIza...
+
+# Qwen (Alibaba Cloud)
+ghagga review --provider qwen --api-key sk-...
 ```
 
 ## Local Models with Ollama
@@ -125,10 +188,13 @@ ghagga review --provider ollama
 ## Environment Variables
 
 ```bash
-GHAGGA_API_KEY=<key>       # API key for the LLM provider
-GHAGGA_PROVIDER=<provider> # LLM provider override
-GHAGGA_MODEL=<model>       # Model identifier override
-GITHUB_TOKEN=<token>       # GitHub token (fallback for github provider)
+GHAGGA_API_KEY=<key>              # API key for the LLM provider
+GHAGGA_PROVIDER=<provider>        # LLM provider override
+GHAGGA_MODEL=<model>              # Model identifier override
+GHAGGA_MEMORY_BACKEND=<type>      # Memory backend: sqlite (default) or engram
+GHAGGA_ENGRAM_HOST=<url>          # Engram server URL (default: http://localhost:7437)
+GHAGGA_ENGRAM_TIMEOUT=<seconds>   # Engram connection timeout (default: 5)
+GITHUB_TOKEN=<token>              # GitHub token (fallback for github provider)
 ```
 
 ## Config File
@@ -148,11 +214,15 @@ Create a `.ghagga.json` in your project root:
 
 ## How It Works
 
-1. Gets your `git diff` (staged or uncommitted changes)
+1. Gets your `git diff` (staged or uncommitted changes; `--staged` uses `git diff --cached`)
 2. Parses the diff and detects tech stacks
 3. Runs static analysis (Semgrep, Trivy, CPD) if available
-4. Sends the diff + context to the AI review agent
-5. Returns findings with severity, file, line, and suggestions
+4. Searches memory for relevant past observations (SQLite + FTS5 at `~/.config/ghagga/memory.db`, or Engram if `--memory-backend engram`)
+5. Sends the diff + static findings + memory context to the AI review agent (skipped with `--quick`)
+6. Returns findings with severity, file, line, and suggestions
+7. Persists new observations (decisions, patterns, bug fixes) to local memory for future reviews
+
+With `ghagga hooks install`, steps 1-7 run automatically on every commit via pre-commit and commit-msg hooks.
 
 ## Requirements
 
@@ -167,5 +237,6 @@ MIT
 ## Links
 
 - [GitHub Repository](https://github.com/JNZader/ghagga)
+- [Full CLI Guide](https://jnzader.github.io/ghagga/docs/#/cli) — Complete setup guide with troubleshooting
 - [Documentation](https://jnzader.github.io/ghagga/docs/)
 - [Landing Page](https://jnzader.github.io/ghagga/)

package/dist/commands/hooks/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Hooks command group barrel.
+ *
+ * Registers the `ghagga hooks` subcommands (install, uninstall, status)
+ * and exports the parent Command for registration in the CLI entry point.
+ */
+import { Command } from 'commander';
+export declare const hooksCommand: Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,YAAY,SACmC,CAAC"}

package/dist/commands/hooks/index.js

@@ -0,0 +1,16 @@
+/**
+ * Hooks command group barrel.
+ *
+ * Registers the `ghagga hooks` subcommands (install, uninstall, status)
+ * and exports the parent Command for registration in the CLI entry point.
+ */
+import { Command } from 'commander';
+import { registerInstallCommand } from './install.js';
+import { registerUninstallCommand } from './uninstall.js';
+import { registerStatusCommand } from './status.js';
+export const hooksCommand = new Command('hooks')
+    .description('Manage git hooks for automated code review');
+registerInstallCommand(hooksCommand);
+registerUninstallCommand(hooksCommand);
+registerStatusCommand(hooksCommand);
+//# sourceMappingURL=index.js.map

package/dist/commands/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,4CAA4C,CAAC,CAAC;AAE7D,sBAAsB,CAAC,YAAY,CAAC,CAAC;AACrC,wBAAwB,CAAC,YAAY,CAAC,CAAC;AACvC,qBAAqB,CAAC,YAAY,CAAC,CAAC"}

package/dist/commands/hooks/install.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `ghagga hooks install` subcommand.
+ *
+ * Installs GHAGGA-managed pre-commit and/or commit-msg hooks into the
+ * current git repository. Handles backup of existing non-GHAGGA hooks,
+ * idempotent reinstall of GHAGGA hooks, and the --force flag for
+ * overwriting external hooks.
+ *
+ * @see Phase 3, Task 3.2
+ */
+import { Command } from 'commander';
+export declare function registerInstallCommand(parent: Command): void;
+//# sourceMappingURL=install.d.ts.map

package/dist/commands/hooks/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAwD5D"}

package/dist/commands/hooks/install.js

@@ -0,0 +1,64 @@
+/**
+ * `ghagga hooks install` subcommand.
+ *
+ * Installs GHAGGA-managed pre-commit and/or commit-msg hooks into the
+ * current git repository. Handles backup of existing non-GHAGGA hooks,
+ * idempotent reinstall of GHAGGA hooks, and the --force flag for
+ * overwriting external hooks.
+ *
+ * @see Phase 3, Task 3.2
+ */
+import { isGitRepo, getHooksDir, installHook } from '../../lib/git-hooks.js';
+import { generatePreCommitHook, generateCommitMsgHook } from '../../lib/hook-templates.js';
+import * as tui from '../../ui/tui.js';
+export function registerInstallCommand(parent) {
+    parent
+        .command('install')
+        .description('Install git hooks for automated code review')
+        .option('--force', 'Overwrite existing non-GHAGGA hooks (with backup)')
+        .option('--pre-commit', 'Install only the pre-commit hook')
+        .option('--commit-msg', 'Install only the commit-msg hook')
+        .action((opts) => {
+        if (!isGitRepo()) {
+            tui.log.error('Not a git repository. Run this command from inside a git repo.');
+            process.exit(1);
+        }
+        const hooksDir = getHooksDir();
+        const force = opts.force ?? false;
+        // Determine which hooks to install.
+        // If neither flag is set, install both. If one or both are set, install only those.
+        const installPreCommit = opts.preCommit || (!opts.preCommit && !opts.commitMsg);
+        const installCommitMsg = opts.commitMsg || (!opts.preCommit && !opts.commitMsg);
+        const hooks = [];
+        if (installPreCommit) {
+            hooks.push({
+                type: 'pre-commit',
+                content: generatePreCommitHook(),
+            });
+        }
+        if (installCommitMsg) {
+            hooks.push({
+                type: 'commit-msg',
+                content: generateCommitMsgHook(),
+            });
+        }
+        let installed = 0;
+        for (const hook of hooks) {
+            const result = installHook(hooksDir, hook.type, hook.content, force);
+            if (result.success) {
+                tui.log.success(result.message);
+                installed++;
+            }
+            else {
+                tui.log.error(result.message);
+            }
+        }
+        if (installed > 0) {
+            tui.log.info(`\nInstalled ${installed} hook(s) to ${hooksDir}`);
+        }
+        else {
+            tui.log.warn('No hooks were installed.');
+        }
+    });
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/hooks/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/commands/hooks/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAE3F,OAAO,KAAK,GAAG,MAAM,iBAAiB,CAAC;AAQvC,MAAM,UAAU,sBAAsB,CAAC,MAAe;IACpD,MAAM;SACH,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,SAAS,EAAE,mDAAmD,CAAC;SACtE,MAAM,CAAC,cAAc,EAAE,kCAAkC,CAAC;SAC1D,MAAM,CAAC,cAAc,EAAE,kCAAkC,CAAC;SAC1D,MAAM,CAAC,CAAC,IAAoB,EAAE,EAAE;QAC/B,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACjB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;YAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;QAElC,oCAAoC;QACpC,oFAAoF;QACpF,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChF,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEhF,MAAM,KAAK,GAA+C,EAAE,CAAC;QAE7D,IAAI,gBAAgB,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,qBAAqB,EAAE;aACjC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,gBAAgB,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,qBAAqB,EAAE;aACjC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAErE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAChC,SAAS,EAAE,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,SAAS,eAAe,QAAQ,EAAE,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/hooks/install.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tests for `ghagga hooks install` subcommand.
+ *
+ * Mocks git-hooks utilities, hook-templates, and the TUI layer.
+ * Tests hook selection (both, --pre-commit, --commit-msg),
+ * --force flag, non-git-repo error, and success/failure messages.
+ *
+ * @see Phase 4, Test 4
+ */
+export {};
+//# sourceMappingURL=install.test.d.ts.map

package/dist/commands/hooks/install.test.d.ts.map

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

package/dist/commands/hooks/install.test.js

@@ -0,0 +1,157 @@
+/**
+ * Tests for `ghagga hooks install` subcommand.
+ *
+ * Mocks git-hooks utilities, hook-templates, and the TUI layer.
+ * Tests hook selection (both, --pre-commit, --commit-msg),
+ * --force flag, non-git-repo error, and success/failure messages.
+ *
+ * @see Phase 4, Test 4
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { Command } from 'commander';
+// ─── Mocks ──────────────────────────────────────────────────────
+const { mockIsGitRepo, mockGetHooksDir, mockInstallHook, mockGenPreCommit, mockGenCommitMsg } = vi.hoisted(() => ({
+    mockIsGitRepo: vi.fn(),
+    mockGetHooksDir: vi.fn(),
+    mockInstallHook: vi.fn(),
+    mockGenPreCommit: vi.fn(),
+    mockGenCommitMsg: vi.fn(),
+}));
+vi.mock('../../lib/git-hooks.js', () => ({
+    isGitRepo: (...args) => mockIsGitRepo(...args),
+    getHooksDir: (...args) => mockGetHooksDir(...args),
+    installHook: (...args) => mockInstallHook(...args),
+}));
+vi.mock('../../lib/hook-templates.js', () => ({
+    generatePreCommitHook: (...args) => mockGenPreCommit(...args),
+    generateCommitMsgHook: (...args) => mockGenCommitMsg(...args),
+}));
+vi.mock('../../ui/tui.js', () => ({
+    log: {
+        success: vi.fn(),
+        error: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+    },
+}));
+import { registerInstallCommand } from './install.js';
+import * as tui from '../../ui/tui.js';
+// ─── Helpers ────────────────────────────────────────────────────
+class ProcessExitError extends Error {
+    code;
+    constructor(code) {
+        super(`process.exit(${code})`);
+        this.code = code;
+    }
+}
+async function runInstallCommand(args = []) {
+    const parent = new Command('hooks');
+    registerInstallCommand(parent);
+    try {
+        await parent.parseAsync(['install', ...args], { from: 'user' });
+    }
+    catch (err) {
+        if (!(err instanceof ProcessExitError))
+            throw err;
+    }
+}
+// ─── Setup ──────────────────────────────────────────────────────
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let exitSpy;
+beforeEach(() => {
+    vi.clearAllMocks();
+    exitSpy = vi
+        .spyOn(process, 'exit')
+        .mockImplementation(((code) => {
+        throw new ProcessExitError(code);
+    }));
+    // Defaults: in a git repo, hooks dir exists
+    mockIsGitRepo.mockReturnValue(true);
+    mockGetHooksDir.mockReturnValue('/repo/.git/hooks');
+    mockGenPreCommit.mockReturnValue('pre-commit-content');
+    mockGenCommitMsg.mockReturnValue('commit-msg-content');
+    mockInstallHook.mockReturnValue({
+        type: 'pre-commit',
+        success: true,
+        message: 'Installed pre-commit hook',
+    });
+});
+afterEach(() => {
+    exitSpy.mockRestore();
+});
+// ─── Tests ──────────────────────────────────────────────────────
+describe('ghagga hooks install', () => {
+    it('installs both hooks by default', async () => {
+        mockInstallHook
+            .mockReturnValueOnce({ type: 'pre-commit', success: true, message: 'Installed pre-commit hook' })
+            .mockReturnValueOnce({ type: 'commit-msg', success: true, message: 'Installed commit-msg hook' });
+        await runInstallCommand();
+        expect(mockInstallHook).toHaveBeenCalledTimes(2);
+        expect(mockInstallHook).toHaveBeenCalledWith('/repo/.git/hooks', 'pre-commit', 'pre-commit-content', false);
+        expect(mockInstallHook).toHaveBeenCalledWith('/repo/.git/hooks', 'commit-msg', 'commit-msg-content', false);
+        expect(tui.log.success).toHaveBeenCalledTimes(2);
+    });
+    it('installs only pre-commit when --pre-commit is passed', async () => {
+        mockInstallHook.mockReturnValue({
+            type: 'pre-commit', success: true, message: 'Installed pre-commit hook',
+        });
+        await runInstallCommand(['--pre-commit']);
+        expect(mockInstallHook).toHaveBeenCalledTimes(1);
+        expect(mockInstallHook).toHaveBeenCalledWith('/repo/.git/hooks', 'pre-commit', 'pre-commit-content', false);
+    });
+    it('installs only commit-msg when --commit-msg is passed', async () => {
+        mockInstallHook.mockReturnValue({
+            type: 'commit-msg', success: true, message: 'Installed commit-msg hook',
+        });
+        await runInstallCommand(['--commit-msg']);
+        expect(mockInstallHook).toHaveBeenCalledTimes(1);
+        expect(mockInstallHook).toHaveBeenCalledWith('/repo/.git/hooks', 'commit-msg', 'commit-msg-content', false);
+    });
+    it('passes force flag when --force is used', async () => {
+        mockInstallHook.mockReturnValue({
+            type: 'pre-commit', success: true, message: 'Installed',
+        });
+        await runInstallCommand(['--force', '--pre-commit']);
+        expect(mockInstallHook).toHaveBeenCalledWith('/repo/.git/hooks', 'pre-commit', 'pre-commit-content', true);
+    });
+    it('exits with error when not in a git repo', async () => {
+        mockIsGitRepo.mockReturnValue(false);
+        await runInstallCommand();
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        expect(tui.log.error).toHaveBeenCalledWith(expect.stringContaining('Not a git repository'));
+        expect(mockInstallHook).not.toHaveBeenCalled();
+    });
+    it('shows error message when install fails', async () => {
+        mockInstallHook
+            .mockReturnValueOnce({
+            type: 'pre-commit',
+            success: false,
+            message: 'Hook pre-commit already exists (not managed by GHAGGA). Use --force to overwrite.',
+        })
+            .mockReturnValueOnce({
+            type: 'commit-msg',
+            success: true,
+            message: 'Installed commit-msg hook',
+        });
+        await runInstallCommand();
+        expect(tui.log.error).toHaveBeenCalledWith(expect.stringContaining('--force'));
+        expect(tui.log.success).toHaveBeenCalledWith(expect.stringContaining('Installed commit-msg'));
+    });
+    it('shows "no hooks installed" warning when all installs fail', async () => {
+        mockInstallHook.mockReturnValue({
+            type: 'pre-commit',
+            success: false,
+            message: 'Failed',
+        });
+        await runInstallCommand();
+        expect(tui.log.warn).toHaveBeenCalledWith(expect.stringContaining('No hooks were installed'));
+    });
+    it('shows install count summary on success', async () => {
+        mockInstallHook
+            .mockReturnValueOnce({ type: 'pre-commit', success: true, message: 'ok' })
+            .mockReturnValueOnce({ type: 'commit-msg', success: true, message: 'ok' });
+        await runInstallCommand();
+        expect(tui.log.info).toHaveBeenCalledWith(expect.stringContaining('Installed 2 hook(s)'));
+    });
+});
+//# sourceMappingURL=install.test.js.map

package/dist/commands/hooks/install.test.js.map

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

package/dist/commands/hooks/status.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `ghagga hooks status` subcommand.
+ *
+ * Shows the status of pre-commit and commit-msg hooks in the
+ * current git repository: not installed, installed (GHAGGA-managed),
+ * or installed (external).
+ *
+ * @see Phase 3, Task 3.4
+ */
+import { Command } from 'commander';
+export declare function registerStatusCommand(parent: Command): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/hooks/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA0B3D"}

package/dist/commands/hooks/status.js

@@ -0,0 +1,38 @@
+/**
+ * `ghagga hooks status` subcommand.
+ *
+ * Shows the status of pre-commit and commit-msg hooks in the
+ * current git repository: not installed, installed (GHAGGA-managed),
+ * or installed (external).
+ *
+ * @see Phase 3, Task 3.4
+ */
+import { isGitRepo, getHooksDir, getHookStatus } from '../../lib/git-hooks.js';
+import * as tui from '../../ui/tui.js';
+const HOOK_TYPES = ['pre-commit', 'commit-msg'];
+export function registerStatusCommand(parent) {
+    parent
+        .command('status')
+        .description('Show status of git hooks')
+        .action(() => {
+        if (!isGitRepo()) {
+            tui.log.error('Not a git repository. Run this command from inside a git repo.');
+            process.exit(1);
+        }
+        const hooksDir = getHooksDir();
+        tui.log.info(`Hooks directory: ${hooksDir}\n`);
+        for (const hookType of HOOK_TYPES) {
+            const status = getHookStatus(hooksDir, hookType);
+            if (!status.installed) {
+                tui.log.info(`  ${hookType}: not installed`);
+            }
+            else if (status.managedByGhagga) {
+                tui.log.success(`  ${hookType}: installed (GHAGGA-managed)`);
+            }
+            else {
+                tui.log.warn(`  ${hookType}: installed (external — not managed by GHAGGA)`);
+            }
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/hooks/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/commands/hooks/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE/E,OAAO,KAAK,GAAG,MAAM,iBAAiB,CAAC;AAEvC,MAAM,UAAU,GAAe,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AAE5D,MAAM,UAAU,qBAAqB,CAAC,MAAe;IACnD,MAAM;SACH,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACjB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;YAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAE/B,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,QAAQ,IAAI,CAAC,CAAC;QAE/C,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAEjD,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,QAAQ,iBAAiB,CAAC,CAAC;YAC/C,CAAC;iBAAM,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;gBAClC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ,8BAA8B,CAAC,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,QAAQ,gDAAgD,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/hooks/status.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tests for `ghagga hooks status` subcommand.
+ *
+ * Mocks git-hooks utilities and the TUI layer.
+ * Tests display of hook status for both hooks, non-git-repo error,
+ * and correct labels for not-installed / GHAGGA / external hooks.
+ *
+ * @see Phase 4, Test 6
+ */
+export {};
+//# sourceMappingURL=status.test.d.ts.map

package/dist/commands/hooks/status.test.d.ts.map

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