@know-graph/cli 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KnowGraph Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,47 @@
+# @know-graph/cli
+
+Command-line interface for [KnowGraph](https://github.com/idosams/know-know) — make your codebase AI-navigable.
+
+## Installation
+
+```bash
+npm install -g @know-graph/cli
+# or
+npx @know-graph/cli <command>
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `knowgraph init` | Initialize KnowGraph in a project (creates `.knowgraph.yml`) |
+| `knowgraph parse <path>` | Parse annotated files and output extracted entities |
+| `knowgraph index [path]` | Build the SQLite index from annotated source files |
+| `knowgraph query <term>` | Search the index with full-text search and filters |
+| `knowgraph serve` | Start the MCP server for AI assistant integration |
+
+## Quick Start
+
+```bash
+# Initialize in your project
+knowgraph init
+
+# Add @knowgraph annotations to your code, then index
+knowgraph index ./src
+
+# Search your codebase
+knowgraph query "authentication"
+knowgraph query --owner "auth-team"
+knowgraph query --tags "security,auth"
+
+# Start MCP server for Claude integration
+knowgraph serve
+```
+
+## Documentation
+
+See the [main repository](https://github.com/idosams/know-know) for full documentation, annotation format, and examples.
+
+## License
+
+MIT

package/dist/commands/coverage.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerCoverageCommand(program: Command): void;
+//# sourceMappingURL=coverage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../../src/commands/coverage.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqHzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkB9D"}

package/dist/commands/coverage.js

@@ -0,0 +1,98 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: CLI command that reports documentation coverage for @knowgraph annotations
+ * owner: knowgraph-cli
+ * status: experimental
+ * tags: [cli, command, coverage, reporting]
+ * context:
+ *   business_goal: Let developers measure and enforce annotation coverage in CI
+ *   domain: cli
+ */
+import { resolve } from 'node:path';
+import { statSync } from 'node:fs';
+import chalk from 'chalk';
+import { calculateCoverage } from '@know-graph/core';
+import { formatJson } from '../utils/format.js';
+function formatPercentage(pct) {
+    if (pct >= 80)
+        return chalk.green(`${pct}%`);
+    if (pct >= 50)
+        return chalk.yellow(`${pct}%`);
+    return chalk.red(`${pct}%`);
+}
+function printBreakdownTable(title, breakdowns) {
+    console.log('');
+    console.log(chalk.bold(title));
+    console.log(`  ${'Category'.padEnd(40)} ${'Annotated'.padStart(10)} ${'Total'.padStart(10)} ${'Coverage'.padStart(10)}`);
+    console.log(`  ${'─'.repeat(70)}`);
+    for (const b of breakdowns) {
+        const category = b.category.length > 38 ? `${b.category.slice(0, 35)}...` : b.category;
+        console.log(`  ${category.padEnd(40)} ${String(b.annotatedCount).padStart(10)} ${String(b.totalCount).padStart(10)} ${formatPercentage(b.percentage).padStart(19)}`);
+    }
+}
+function printTableOutput(result, byDimension) {
+    console.log('');
+    console.log(chalk.bold('Documentation Coverage Report'));
+    console.log(`  Total files:     ${chalk.cyan(String(result.totalFiles))}`);
+    console.log(`  Annotated files: ${chalk.cyan(String(result.annotatedFiles))}`);
+    console.log(`  Coverage:        ${formatPercentage(result.percentage)}`);
+    if (!byDimension || byDimension === 'language') {
+        printBreakdownTable('By Language:', result.byLanguage);
+    }
+    if (!byDimension || byDimension === 'directory') {
+        printBreakdownTable('By Directory:', result.byDirectory);
+    }
+    if (!byDimension || byDimension === 'owner') {
+        printBreakdownTable('By Owner:', result.byOwner);
+    }
+}
+function runCoverage(targetPath, options) {
+    const absPath = resolve(targetPath);
+    try {
+        statSync(absPath);
+    }
+    catch {
+        console.error(chalk.red(`Error: Path not found: ${absPath}`));
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        const result = calculateCoverage({ rootDir: absPath });
+        if (options.format === 'json') {
+            console.log(formatJson(result, true));
+        }
+        else {
+            printTableOutput(result, options.by);
+        }
+        if (options.threshold !== undefined) {
+            const threshold = Number(options.threshold);
+            if (Number.isNaN(threshold)) {
+                console.error(chalk.red(`Error: Invalid threshold value: ${options.threshold}`));
+                process.exitCode = 1;
+                return;
+            }
+            if (result.percentage < threshold) {
+                console.error('');
+                console.error(chalk.red(`Coverage ${result.percentage}% is below threshold ${threshold}%`));
+                process.exitCode = 1;
+            }
+        }
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+        process.exitCode = 1;
+    }
+}
+export function registerCoverageCommand(program) {
+    program
+        .command('coverage [path]')
+        .description('Report documentation coverage for @knowgraph annotations')
+        .option('--format <format>', 'Output format (table|json)', 'table')
+        .option('--threshold <number>', 'Exit with code 1 if coverage is below this percentage')
+        .option('--by <dimension>', 'Breakdown dimension (language|directory|owner)')
+        .action((path, opts) => {
+        runCoverage(path ?? '.', opts);
+    });
+}
+//# sourceMappingURL=coverage.js.map

package/dist/commands/coverage.js.map

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

package/dist/commands/export.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from 'commander';
+import type { StoredEntity } from '@know-graph/core';
+type ExportFormat = 'cursorrules' | 'markdown';
+export declare function formatExport(entities: readonly StoredEntity[], format: ExportFormat): string;
+export declare function registerExportCommand(program: Command): void;
+export {};
+//# sourceMappingURL=export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,KAAK,YAAY,GAAG,aAAa,GAAG,UAAU,CAAC;AAuH/C,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,MAAM,EAAE,YAAY,GACnB,MAAM,CA8DR;AA2ED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAe5D"}

package/dist/commands/export.js

@@ -0,0 +1,193 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: CLI command to export knowledge graph as .cursorrules or markdown
+ * owner: knowgraph-cli
+ * status: experimental
+ * tags: [cli, command, export, cursorrules]
+ * context:
+ *   business_goal: Enable AI coding tools beyond MCP to leverage KnowGraph data
+ *   domain: cli
+ */
+import { resolve } from 'node:path';
+import { existsSync, writeFileSync } from 'node:fs';
+import chalk from 'chalk';
+import { createDatabaseManager, createQueryEngine, } from '@know-graph/core';
+function getBusinessGoal(entity) {
+    const metadata = entity.metadata;
+    const context = metadata.context;
+    if (!context)
+        return undefined;
+    const goal = context.business_goal;
+    return typeof goal === 'string' ? goal : undefined;
+}
+function groupByOwner(entities) {
+    const ownerMap = new Map();
+    for (const entity of entities) {
+        const owner = entity.owner ?? '';
+        const existing = ownerMap.get(owner) ?? [];
+        ownerMap.set(owner, [...existing, entity]);
+    }
+    const groups = [];
+    for (const [owner, groupEntities] of ownerMap) {
+        if (owner !== '') {
+            groups.push({ owner, entities: groupEntities });
+        }
+    }
+    // Sort owner groups alphabetically
+    groups.sort((a, b) => a.owner.localeCompare(b.owner));
+    // Add unowned group at the end if it exists
+    const unowned = ownerMap.get('');
+    if (unowned && unowned.length > 0) {
+        groups.push({ owner: '', entities: unowned });
+    }
+    return groups;
+}
+function groupByEntityType(entities) {
+    const typeMap = new Map();
+    for (const entity of entities) {
+        const existing = typeMap.get(entity.entityType) ?? [];
+        typeMap.set(entity.entityType, [...existing, entity]);
+    }
+    const groups = [];
+    for (const [entityType, groupEntities] of typeMap) {
+        groups.push({ entityType, entities: groupEntities });
+    }
+    return groups.sort((a, b) => a.entityType.localeCompare(b.entityType));
+}
+function formatEntityLine(entity) {
+    const location = `${entity.filePath}:${entity.line}`;
+    return `- **${entity.name}** (${entity.entityType}) - ${entity.description} [${location}]`;
+}
+function formatEntityDetails(entity) {
+    const lines = [];
+    const status = entity.status ?? 'unknown';
+    lines.push(`### ${entity.name} (${entity.entityType}) - ${status}`);
+    lines.push(`**File:** ${entity.filePath}:${entity.line}`);
+    lines.push(`**Owner:** ${entity.owner ?? 'unowned'}`);
+    lines.push(`**Description:** ${entity.description}`);
+    if (entity.tags.length > 0) {
+        lines.push(`**Tags:** ${entity.tags.join(', ')}`);
+    }
+    const businessGoal = getBusinessGoal(entity);
+    if (businessGoal) {
+        lines.push(`**Business Goal:** ${businessGoal}`);
+    }
+    return lines.join('\n');
+}
+function getFormatHeader(format) {
+    if (format === 'markdown') {
+        return [
+            '# Project Knowledge Graph',
+            '> Auto-generated by KnowGraph. Do not edit manually.',
+            '> Regenerate with: knowgraph export --format markdown',
+            '',
+            '> This file provides AI-readable context about the codebase.',
+        ].join('\n');
+    }
+    return [
+        '# Project Knowledge Graph',
+        '> Auto-generated by KnowGraph. Do not edit manually.',
+        '> Regenerate with: knowgraph export --format cursorrules',
+    ].join('\n');
+}
+export function formatExport(entities, format) {
+    const sections = [];
+    // Header
+    sections.push(getFormatHeader(format));
+    if (entities.length === 0) {
+        sections.push('## Architecture Overview');
+        sections.push('This project contains 0 annotated code entities. Run `knowgraph index .` to populate the knowledge graph.');
+        return sections.join('\n\n');
+    }
+    // Architecture Overview
+    const ownerGroups = groupByOwner(entities);
+    const namedOwners = ownerGroups.filter((g) => g.owner !== '');
+    const ownerCount = namedOwners.length;
+    sections.push('## Architecture Overview');
+    sections.push(`This project contains ${entities.length} annotated code entities across ${ownerCount} owners.`);
+    // Code Ownership section
+    sections.push('## Code Ownership');
+    for (const group of ownerGroups) {
+        if (group.owner === '')
+            continue;
+        const ownerLines = [];
+        ownerLines.push(`### ${group.owner}`);
+        const byType = groupByEntityType(group.entities);
+        for (const typeGroup of byType) {
+            for (const entity of typeGroup.entities) {
+                ownerLines.push(formatEntityLine(entity));
+            }
+        }
+        sections.push(ownerLines.join('\n'));
+    }
+    // Unowned entities
+    const unownedGroup = ownerGroups.find((g) => g.owner === '');
+    if (unownedGroup) {
+        const unownedLines = [];
+        unownedLines.push('## Unowned Entities');
+        for (const entity of unownedGroup.entities) {
+            unownedLines.push(formatEntityLine(entity));
+        }
+        sections.push(unownedLines.join('\n'));
+    }
+    // Entity Details section
+    sections.push('## Entity Details');
+    for (const entity of entities) {
+        sections.push(formatEntityDetails(entity));
+    }
+    return sections.join('\n\n');
+}
+function getDefaultOutputFile(format) {
+    return format === 'cursorrules' ? '.cursorrules' : 'CODEBASE.md';
+}
+function runExport(targetPath, options) {
+    const absPath = resolve(targetPath);
+    const dbPath = resolve(absPath, '.knowgraph', 'knowgraph.db');
+    if (!existsSync(dbPath)) {
+        console.error(chalk.red(`Error: Database not found at ${dbPath}. Run 'knowgraph index ${targetPath}' first.`));
+        process.exitCode = 1;
+        return;
+    }
+    const format = options.format;
+    if (format !== 'cursorrules' && format !== 'markdown') {
+        console.error(chalk.red(`Error: Invalid format '${format}'. Use 'cursorrules' or 'markdown'.`));
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        const dbManager = createDatabaseManager(dbPath);
+        try {
+            const queryEngine = createQueryEngine(dbManager);
+            const result = queryEngine.search({ query: '', limit: 10000 });
+            const entities = result.entities;
+            const content = formatExport(entities, format);
+            const outputFile = resolve(absPath, options.output ?? getDefaultOutputFile(format));
+            writeFileSync(outputFile, content, 'utf-8');
+            if (entities.length === 0) {
+                console.log(chalk.yellow(`Warning: No entities found in the index. Exported empty template to ${outputFile}`));
+            }
+            else {
+                console.log(chalk.green(`Exported ${entities.length} entities to ${outputFile}`));
+            }
+        }
+        finally {
+            dbManager.close();
+        }
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+        process.exitCode = 1;
+    }
+}
+export function registerExportCommand(program) {
+    program
+        .command('export [path]')
+        .description('Export knowledge graph as .cursorrules or markdown file')
+        .option('--format <format>', 'Output format (cursorrules|markdown)', 'cursorrules')
+        .option('--output <file>', 'Output file path')
+        .action((path, opts) => {
+        runExport(path ?? '.', opts);
+    });
+}
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

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

package/dist/commands/hook.d.ts

@@ -0,0 +1,30 @@
+import type { Command } from 'commander';
+export declare const HOOK_MARKER_START = "# >>> KnowGraph pre-commit hook >>>";
+export declare const HOOK_MARKER_END = "# <<< KnowGraph pre-commit hook <<<";
+interface InstallOptions {
+    readonly force?: boolean;
+}
+interface InstallResult {
+    readonly success: boolean;
+    readonly appended?: boolean;
+    readonly alreadyInstalled?: boolean;
+    readonly error?: string;
+}
+interface UninstallResult {
+    readonly success: boolean;
+    readonly removed?: boolean;
+    readonly error?: string;
+}
+interface HookStatus {
+    readonly installed: boolean;
+    readonly hookPath?: string;
+    readonly error?: string;
+}
+export declare function getHookPath(): string | null;
+export declare function buildHookScript(): string;
+export declare function installHook(options?: InstallOptions): InstallResult;
+export declare function uninstallHook(): UninstallResult;
+export declare function getHookStatus(): HookStatus;
+export declare function registerHookCommand(program: Command): void;
+export {};
+//# sourceMappingURL=hook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/commands/hook.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,eAAO,MAAM,iBAAiB,wCAAwC,CAAC;AACvE,eAAO,MAAM,eAAe,wCAAwC,CAAC;AAErE,UAAU,cAAc;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,aAAa;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,eAAe;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,UAAU;IAClB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAS3C;AAED,wBAAgB,eAAe,IAAI,MAAM,CA+BxC;AA2CD,wBAAgB,WAAW,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CAsCvE;AAED,wBAAgB,aAAa,IAAI,eAAe,CA0B/C;AAED,wBAAgB,aAAa,IAAI,UAAU,CAmB1C;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgF1D"}

package/dist/commands/hook.js

@@ -0,0 +1,224 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: CLI command for managing git pre-commit hooks that validate @knowgraph annotations
+ * owner: knowgraph-cli
+ * status: stable
+ * tags: [cli, command, hook, pre-commit, git]
+ * context:
+ *   business_goal: Automate annotation validation on every commit via git hooks
+ *   domain: cli
+ */
+import { existsSync, readFileSync, writeFileSync, chmodSync, mkdirSync, unlinkSync, } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import chalk from 'chalk';
+export const HOOK_MARKER_START = '# >>> KnowGraph pre-commit hook >>>';
+export const HOOK_MARKER_END = '# <<< KnowGraph pre-commit hook <<<';
+export function getHookPath() {
+    try {
+        const gitRoot = execSync('git rev-parse --show-toplevel', {
+            encoding: 'utf-8',
+        }).trim();
+        return join(gitRoot, '.git', 'hooks', 'pre-commit');
+    }
+    catch {
+        return null;
+    }
+}
+export function buildHookScript() {
+    return [
+        '#!/bin/sh',
+        HOOK_MARKER_START,
+        '# Validates @knowgraph annotations in staged files',
+        '',
+        'STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E "\\.(ts|tsx|js|jsx|py)$")',
+        '',
+        'if [ -z "$STAGED_FILES" ]; then',
+        '  exit 0',
+        'fi',
+        '',
+        'echo "KnowGraph: Validating annotations in staged files..."',
+        '',
+        'echo "$STAGED_FILES" | while IFS= read -r file; do',
+        '  npx knowgraph parse "$file" --validate 2>&1',
+        '  if [ $? -ne 0 ]; then',
+        '    echo "KnowGraph: Validation failed for $file"',
+        '    exit 1',
+        '  fi',
+        'done',
+        '',
+        '# Propagate validation failure from subshell',
+        'if [ $? -ne 0 ]; then',
+        '  exit 1',
+        'fi',
+        '',
+        'echo "KnowGraph: All annotations valid"',
+        HOOK_MARKER_END,
+        '',
+    ].join('\n');
+}
+function getGitRoot() {
+    try {
+        return execSync('git rev-parse --show-toplevel', {
+            encoding: 'utf-8',
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function hasKnowgraphSection(content) {
+    return (content.includes(HOOK_MARKER_START) && content.includes(HOOK_MARKER_END));
+}
+function removeKnowgraphSection(content) {
+    const startIdx = content.indexOf(HOOK_MARKER_START);
+    const endIdx = content.indexOf(HOOK_MARKER_END);
+    if (startIdx === -1 || endIdx === -1) {
+        return content;
+    }
+    const before = content.slice(0, startIdx);
+    const after = content.slice(endIdx + HOOK_MARKER_END.length);
+    return (before + after).replace(/\n{3,}/g, '\n\n');
+}
+function extractKnowgraphSection() {
+    const full = buildHookScript();
+    const startIdx = full.indexOf(HOOK_MARKER_START);
+    const endIdx = full.indexOf(HOOK_MARKER_END) + HOOK_MARKER_END.length;
+    return full.slice(startIdx, endIdx);
+}
+function isOnlyKnowgraphContent(content) {
+    const stripped = removeKnowgraphSection(content)
+        .replace(/^#!\/bin\/sh\s*/, '')
+        .trim();
+    return stripped.length === 0;
+}
+export function installHook(options = {}) {
+    const { force = false } = options;
+    const gitRoot = getGitRoot();
+    if (gitRoot === null) {
+        return { success: false, error: 'Not in a git repository' };
+    }
+    const hooksDir = join(gitRoot, '.git', 'hooks');
+    const hookPath = join(hooksDir, 'pre-commit');
+    mkdirSync(hooksDir, { recursive: true });
+    if (existsSync(hookPath)) {
+        const existingContent = readFileSync(hookPath, 'utf-8');
+        if (hasKnowgraphSection(existingContent)) {
+            if (!force) {
+                return { success: false, alreadyInstalled: true };
+            }
+            const updated = removeKnowgraphSection(existingContent);
+            const newContent = updated.trimEnd() + '\n\n' + extractKnowgraphSection() + '\n';
+            writeFileSync(hookPath, newContent);
+            chmodSync(hookPath, 0o755);
+            return { success: true, appended: false };
+        }
+        const newContent = existingContent.trimEnd() + '\n\n' + extractKnowgraphSection() + '\n';
+        writeFileSync(hookPath, newContent);
+        chmodSync(hookPath, 0o755);
+        return { success: true, appended: true };
+    }
+    writeFileSync(hookPath, buildHookScript());
+    chmodSync(hookPath, 0o755);
+    return { success: true };
+}
+export function uninstallHook() {
+    const gitRoot = getGitRoot();
+    if (gitRoot === null) {
+        return { success: false, error: 'Not in a git repository' };
+    }
+    const hookPath = join(gitRoot, '.git', 'hooks', 'pre-commit');
+    if (!existsSync(hookPath)) {
+        return { success: false, error: 'KnowGraph hook is not installed' };
+    }
+    const content = readFileSync(hookPath, 'utf-8');
+    if (!hasKnowgraphSection(content)) {
+        return { success: false, error: 'KnowGraph hook is not installed' };
+    }
+    if (isOnlyKnowgraphContent(content)) {
+        unlinkSync(hookPath);
+        return { success: true, removed: true };
+    }
+    const updated = removeKnowgraphSection(content);
+    writeFileSync(hookPath, updated);
+    return { success: true, removed: false };
+}
+export function getHookStatus() {
+    const gitRoot = getGitRoot();
+    if (gitRoot === null) {
+        return { installed: false, error: 'Not in a git repository' };
+    }
+    const hookPath = join(gitRoot, '.git', 'hooks', 'pre-commit');
+    if (!existsSync(hookPath)) {
+        return { installed: false, hookPath };
+    }
+    const content = readFileSync(hookPath, 'utf-8');
+    if (hasKnowgraphSection(content)) {
+        return { installed: true, hookPath };
+    }
+    return { installed: false, hookPath };
+}
+export function registerHookCommand(program) {
+    const hookCmd = program
+        .command('hook')
+        .description('Manage KnowGraph git pre-commit hooks');
+    hookCmd
+        .command('install')
+        .description('Install the KnowGraph pre-commit hook')
+        .option('--force', 'Overwrite existing KnowGraph hook section', false)
+        .action((options) => {
+        const result = installHook({ force: options.force });
+        if (result.alreadyInstalled) {
+            console.log(chalk.yellow('KnowGraph hook is already installed. Use --force to reinstall.'));
+            return;
+        }
+        if (!result.success) {
+            console.error(chalk.red(`Error: ${result.error}`));
+            process.exitCode = 1;
+            return;
+        }
+        if (result.appended) {
+            console.log(chalk.green('KnowGraph hook appended to existing pre-commit hook.'));
+        }
+        else {
+            console.log(chalk.green('KnowGraph pre-commit hook installed.'));
+        }
+    });
+    hookCmd
+        .command('uninstall')
+        .description('Remove the KnowGraph pre-commit hook')
+        .action(() => {
+        const result = uninstallHook();
+        if (!result.success) {
+            console.error(chalk.red(`Error: ${result.error}`));
+            process.exitCode = 1;
+            return;
+        }
+        if (result.removed) {
+            console.log(chalk.green('KnowGraph pre-commit hook removed.'));
+        }
+        else {
+            console.log(chalk.green('KnowGraph section removed from pre-commit hook (other hooks preserved).'));
+        }
+    });
+    hookCmd
+        .command('status')
+        .description('Check if the KnowGraph pre-commit hook is installed')
+        .action(() => {
+        const status = getHookStatus();
+        if (status.error) {
+            console.error(chalk.red(`Error: ${status.error}`));
+            process.exitCode = 1;
+            return;
+        }
+        if (status.installed) {
+            console.log(chalk.green(`KnowGraph hook is installed at ${status.hookPath}`));
+        }
+        else {
+            console.log(chalk.yellow('KnowGraph hook is not installed.'));
+            console.log(chalk.dim('Run `knowgraph hook install` to install it.'));
+        }
+    });
+}
+//# sourceMappingURL=hook.js.map