glancey 2.0.0

package/dist/tools/clustering-handlers.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Tool handlers for clustering operations.
+ */
+import type { CodeIndexer, CodeChunk, CodebaseSummary } from '../search/indexer.js';
+import type { ConceptCluster } from '../search/clustering.js';
+import type { ToolResponse } from './types.js';
+/**
+ * Context for clustering tools.
+ */
+export interface ClusteringToolContext {
+    indexer: CodeIndexer;
+    toolGuidance: string;
+}
+/**
+ * Arguments for summarize_codebase tool.
+ */
+export interface SummarizeCodebaseArgs {
+    numClusters?: number;
+}
+/**
+ * Parse and validate summarize_codebase arguments.
+ */
+export declare function parseSummarizeCodebaseArgs(args: Record<string, unknown> | undefined): SummarizeCodebaseArgs;
+/**
+ * Format codebase summary for display.
+ */
+export declare function formatCodebaseSummary(summary: CodebaseSummary): string;
+/**
+ * Handle summarize_codebase tool.
+ */
+export declare function handleSummarizeCodebase(args: SummarizeCodebaseArgs, context: ClusteringToolContext): Promise<ToolResponse>;
+/**
+ * Arguments for list_concepts tool.
+ */
+export interface ListConceptsArgs {
+    forceRecluster?: boolean;
+}
+/**
+ * Parse and validate list_concepts arguments.
+ */
+export declare function parseListConceptsArgs(args: Record<string, unknown> | undefined): ListConceptsArgs;
+/**
+ * Format concept clusters for display.
+ */
+export declare function formatConceptClusters(concepts: ConceptCluster[]): string;
+/**
+ * Handle list_concepts tool.
+ */
+export declare function handleListConcepts(args: ListConceptsArgs, context: ClusteringToolContext): Promise<ToolResponse>;
+/**
+ * Arguments for search_by_concept tool.
+ */
+export interface SearchByConceptArgs {
+    conceptId: number;
+    query?: string;
+    limit?: number;
+}
+/**
+ * Parse and validate search_by_concept arguments.
+ */
+export declare function parseSearchByConceptArgs(args: Record<string, unknown> | undefined): SearchByConceptArgs;
+/**
+ * Format concept search results for display.
+ */
+export declare function formatConceptSearchResults(results: CodeChunk[], conceptId: number): string;
+/**
+ * Handle search_by_concept tool.
+ */
+export declare function handleSearchByConcept(args: SearchByConceptArgs, context: ClusteringToolContext): Promise<ToolResponse>;
+//# sourceMappingURL=clustering-handlers.d.ts.map

package/dist/tools/clustering-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clustering-handlers.d.ts","sourceRoot":"","sources":["../../src/tools/clustering-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,WAAW,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,qBAAqB,CAIvB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CA0BtE;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAiBvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,gBAAgB,CAIjG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CAgBxE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAYvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,mBAAmB,CAerB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAe1F;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAgBvB"}

package/dist/tools/clustering-handlers.js

@@ -0,0 +1,150 @@
+/**
+ * Tool handlers for clustering operations.
+ */
+import { createToolResponse } from './types.js';
+import { isNumber, isBoolean, isString } from '../utils/type-guards.js';
+import { GlanceyError } from '../utils/errors.js';
+import { dashboardState } from '../dashboard/state.js';
+/**
+ * Parse and validate summarize_codebase arguments.
+ */
+export function parseSummarizeCodebaseArgs(args) {
+    return {
+        numClusters: isNumber(args?.numClusters) ? args.numClusters : undefined,
+    };
+}
+/**
+ * Format codebase summary for display.
+ */
+export function formatCodebaseSummary(summary) {
+    const languageList = summary.languages
+        .map((l) => `- **${l.language}**: ${l.fileCount} files, ${l.chunkCount} chunks`)
+        .join('\n');
+    const conceptList = summary.concepts
+        .map((c) => {
+        const keywords = c.keywords.slice(0, 5).join(', ');
+        return `- **Cluster ${c.id}: ${c.label}** (${c.size} chunks)\n  Keywords: ${keywords}`;
+    })
+        .join('\n');
+    return `# Codebase Summary
+
+## Overview
+- **Total Files**: ${summary.totalFiles}
+- **Total Chunks**: ${summary.totalChunks}
+- **Concept Clusters**: ${summary.concepts.length}
+- **Clustering Quality**: ${(summary.clusteringQuality * 100).toFixed(1)}% (silhouette score)
+- **Generated At**: ${summary.generatedAt}
+
+## Languages
+${languageList}
+
+## Concept Areas
+${conceptList}`;
+}
+/**
+ * Handle summarize_codebase tool.
+ */
+export async function handleSummarizeCodebase(args, context) {
+    const summary = await context.indexer.summarizeCodebase(args.numClusters ? { numClusters: args.numClusters } : undefined);
+    const formatted = formatCodebaseSummary(summary);
+    // Track token savings (optional)
+    try {
+        const status = await context.indexer.getStatus();
+        dashboardState
+            .getTokenTracker()
+            .recordSummarizeCodebase(formatted.length, status.fileCount ?? 0);
+    }
+    catch {
+        // Token tracking not available
+    }
+    return createToolResponse(formatted, context.toolGuidance);
+}
+/**
+ * Parse and validate list_concepts arguments.
+ */
+export function parseListConceptsArgs(args) {
+    return {
+        forceRecluster: isBoolean(args?.forceRecluster) ? args.forceRecluster : false,
+    };
+}
+/**
+ * Format concept clusters for display.
+ */
+export function formatConceptClusters(concepts) {
+    if (concepts.length === 0) {
+        return 'No concept clusters found. Make sure the codebase is indexed first.';
+    }
+    const formatted = concepts
+        .map((c) => {
+        const keywords = c.keywords.slice(0, 5).join(', ');
+        return `## Cluster ${c.id}: ${c.label}
+- **Size**: ${c.size} code chunks
+- **Keywords**: ${keywords}
+- **Representatives**: ${c.representativeChunks.slice(0, 3).join(', ')}`;
+    })
+        .join('\n\n');
+    return `# Concept Clusters\n\n${formatted}`;
+}
+/**
+ * Handle list_concepts tool.
+ */
+export async function handleListConcepts(args, context) {
+    const concepts = await context.indexer.listConcepts(args.forceRecluster ?? false);
+    const formatted = formatConceptClusters(concepts);
+    // Track token savings (optional)
+    try {
+        dashboardState.getTokenTracker().recordListConcepts(formatted.length, concepts.length);
+    }
+    catch {
+        // Token tracking not available
+    }
+    return createToolResponse(formatted, context.toolGuidance);
+}
+/**
+ * Parse and validate search_by_concept arguments.
+ */
+export function parseSearchByConceptArgs(args) {
+    const conceptId = isNumber(args?.conceptId) ? args.conceptId : -1;
+    if (conceptId < 0) {
+        throw new GlanceyError('conceptId is required and must be a non-negative number', 'validation', { tool: 'search_by_concept' });
+    }
+    return {
+        conceptId,
+        query: isString(args?.query) ? args.query : undefined,
+        limit: isNumber(args?.limit) ? args.limit : 10,
+    };
+}
+/**
+ * Format concept search results for display.
+ */
+export function formatConceptSearchResults(results, conceptId) {
+    if (results.length === 0) {
+        return `No code found in concept cluster ${conceptId}. Try list_concepts to see available clusters.`;
+    }
+    return results
+        .map((r, i) => {
+        let header = `## Result ${i + 1}: ${r.filepath}:${r.startLine}-${r.endLine}`;
+        if (r.symbolName) {
+            const typeLabel = r.symbolType ? ` (${r.symbolType})` : '';
+            header += `\n**Symbol:** \`${r.symbolName}\`${typeLabel}`;
+        }
+        return `${header}\n\`\`\`${r.language}\n${r.content}\n\`\`\``;
+    })
+        .join('\n\n');
+}
+/**
+ * Handle search_by_concept tool.
+ */
+export async function handleSearchByConcept(args, context) {
+    const results = await context.indexer.searchByConcept(args.conceptId, args.query, args.limit ?? 10);
+    const formatted = formatConceptSearchResults(results, args.conceptId);
+    // Track token savings (optional)
+    try {
+        dashboardState.getTokenTracker().recordSearchByConcept(formatted.length, results.length);
+    }
+    catch {
+        // Token tracking not available
+    }
+    return createToolResponse(formatted, context.toolGuidance);
+}
+//# sourceMappingURL=clustering-handlers.js.map

package/dist/tools/clustering-handlers.js.map

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

package/dist/tools/commit-handlers.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Tool handlers for git commit operations.
+ */
+import type { ToolResponse } from './types.js';
+/**
+ * Commit rules reminder text.
+ */
+export declare const COMMIT_RULES = "\n## Commit Rules Reminder\n\n1. **Branch**: Must be on a feature branch, not main/master\n2. **Message length**: Subject line must be \u226472 characters\n3. **Imperative mood**: \"Add feature\" not \"Added feature\"\n4. **Single responsibility**: One logical change per commit\n5. **Body format**: Only \"Co-Authored-By: Claude <noreply@anthropic.com>\"\n\n**Signs of multi-responsibility** (split into separate commits):\n- Message contains \"and\" connecting actions\n- Message lists multiple changes with commas\n- Changes span unrelated files/features\n";
+/**
+ * Execute a git command safely using spawn with array arguments.
+ */
+export declare function gitSpawn(args: string[], options: {
+    cwd: string;
+    stdin?: string;
+}): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+/**
+ * Interface for git operations (for testability).
+ */
+export interface IGitOperations {
+    getCurrentBranch(cwd: string): Promise<string>;
+    stageFiles(cwd: string, files: string[]): Promise<void>;
+    getStagedFiles(cwd: string): Promise<string[]>;
+    commit(cwd: string, message: string): Promise<string>;
+    unstageFiles(cwd: string, files: string[]): Promise<void>;
+    writeMarkerFile(projectPath: string): void;
+}
+/**
+ * Default git operations implementation.
+ */
+export declare const defaultGitOperations: IGitOperations;
+/**
+ * Context for commit tools.
+ */
+export interface CommitToolContext {
+    projectPath: string;
+    /** Optional git operations (for testing). */
+    gitOperations?: IGitOperations;
+}
+/**
+ * Arguments for commit tool.
+ */
+export interface CommitArgs {
+    message: string;
+    files?: string[];
+}
+/**
+ * Parse and validate commit arguments.
+ */
+export declare function parseCommitArgs(args: Record<string, unknown> | undefined): CommitArgs;
+/**
+ * Validation result for commit message.
+ */
+export interface CommitValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate commit message and branch.
+ */
+export declare function validateCommit(message: string, context: CommitToolContext): Promise<CommitValidationResult>;
+/**
+ * Format validation errors for response.
+ */
+export declare function formatValidationErrors(errors: string[], warnings: string[]): string;
+/**
+ * Format successful commit response.
+ */
+export declare function formatCommitSuccess(output: string, warnings: string[]): string;
+/**
+ * Handle commit tool.
+ */
+export declare function handleCommit(args: CommitArgs, context: CommitToolContext): Promise<ToolResponse>;
+//# sourceMappingURL=commit-handlers.d.ts.map

package/dist/tools/commit-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-handlers.d.ts","sourceRoot":"","sources":["../../src/tools/commit-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C;;GAEG;AACH,eAAO,MAAM,YAAY,ojBAaxB,CAAC;AAEF;;GAEG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA0C7C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,cAiClC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,cAAc,CAAC;CAChC;AASD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,UAAU,CASrF;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CA4CjC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAOnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAO9E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,YAAY,CAAC,CAuEvB"}

package/dist/tools/commit-handlers.js

@@ -0,0 +1,251 @@
+/**
+ * Tool handlers for git commit operations.
+ */
+import { spawn } from 'child_process';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import * as fs from 'fs';
+import * as path from 'path';
+import { isString, isStringArray } from '../utils/type-guards.js';
+import { GlanceyError, wrapError } from '../utils/errors.js';
+const execAsync = promisify(exec);
+/**
+ * Commit rules reminder text.
+ */
+export const COMMIT_RULES = `
+## Commit Rules Reminder
+
+1. **Branch**: Must be on a feature branch, not main/master
+2. **Message length**: Subject line must be ≤72 characters
+3. **Imperative mood**: "Add feature" not "Added feature"
+4. **Single responsibility**: One logical change per commit
+5. **Body format**: Only "Co-Authored-By: Claude <noreply@anthropic.com>"
+
+**Signs of multi-responsibility** (split into separate commits):
+- Message contains "and" connecting actions
+- Message lists multiple changes with commas
+- Changes span unrelated files/features
+`;
+/**
+ * Execute a git command safely using spawn with array arguments.
+ */
+export function gitSpawn(args, options) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn('git', args, {
+            cwd: options.cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        proc.on('error', (err) => {
+            reject(err);
+        });
+        proc.on('close', (code) => {
+            if (code === 0) {
+                resolve({ stdout, stderr });
+            }
+            else {
+                const exitCode = code ?? 1;
+                const error = new Error(`git ${args[0]} failed with code ${exitCode}: ${stderr}`);
+                error.code = exitCode;
+                error.stdout = stdout;
+                error.stderr = stderr;
+                reject(error);
+            }
+        });
+        if (options.stdin !== undefined) {
+            proc.stdin.write(options.stdin);
+            proc.stdin.end();
+        }
+        else {
+            proc.stdin.end();
+        }
+    });
+}
+/**
+ * Default git operations implementation.
+ */
+export const defaultGitOperations = {
+    async getCurrentBranch(cwd) {
+        const { stdout } = await execAsync('git branch --show-current', { cwd });
+        return stdout.trim();
+    },
+    async stageFiles(cwd, files) {
+        await gitSpawn(['add', '--', ...files], { cwd });
+    },
+    async getStagedFiles(cwd) {
+        const { stdout } = await gitSpawn(['diff', '--cached', '--name-only'], { cwd });
+        return stdout.trim().split('\n').filter(Boolean);
+    },
+    async commit(cwd, message) {
+        const fullMessage = `${message}\n\nCo-Authored-By: Claude <noreply@anthropic.com>`;
+        const { stdout } = await gitSpawn(['commit', '-F', '-'], { cwd, stdin: fullMessage });
+        return stdout.trim();
+    },
+    async unstageFiles(cwd, files) {
+        await gitSpawn(['reset', 'HEAD', '--', ...files], { cwd });
+    },
+    writeMarkerFile(projectPath) {
+        const markerPath = path.join(projectPath, '.git', 'MCP_COMMIT_MARKER');
+        try {
+            fs.writeFileSync(markerPath, Date.now().toString());
+        }
+        catch {
+            // Ignore marker write failures - non-critical
+        }
+    },
+};
+/**
+ * Get git operations instance.
+ */
+function getGitOperations(context) {
+    return context.gitOperations ?? defaultGitOperations;
+}
+/**
+ * Parse and validate commit arguments.
+ */
+export function parseCommitArgs(args) {
+    const message = isString(args?.message) ? args.message : '';
+    const files = isStringArray(args?.files) ? args.files : [];
+    if (!message) {
+        throw new GlanceyError('message is required', 'validation', { tool: 'commit' });
+    }
+    return { message, files };
+}
+/**
+ * Validate commit message and branch.
+ */
+export async function validateCommit(message, context) {
+    const git = getGitOperations(context);
+    const errors = [];
+    const warnings = [];
+    // Check 1: Not on main/master branch
+    try {
+        const currentBranch = await git.getCurrentBranch(context.projectPath);
+        if (currentBranch === 'main' || currentBranch === 'master') {
+            errors.push(`Cannot commit directly to ${currentBranch}. Create a feature branch first:\n  git checkout -b feature/your-feature-name`);
+        }
+    }
+    catch {
+        errors.push('Failed to determine current branch. Are you in a git repository?');
+    }
+    // Check 2: Message length
+    const subjectLine = message.split('\n')[0];
+    if (subjectLine.length > 72) {
+        errors.push(`Subject line is ${subjectLine.length} characters (max 72). Shorten it.`);
+    }
+    // Check 3: Imperative mood (heuristic)
+    const pastTensePatterns = /^(Added|Fixed|Updated|Changed|Removed|Implemented|Created|Deleted|Modified|Refactored|Merged)\b/i;
+    if (pastTensePatterns.test(subjectLine)) {
+        warnings.push(`Subject may not be imperative mood. Use "Add" not "Added", "Fix" not "Fixed", etc.`);
+    }
+    // Check 4: Single responsibility (heuristic)
+    const multiResponsibilityPatterns = /\b(and|,)\s+(add|fix|update|change|remove|implement|create|delete|modify|refactor)\b/i;
+    if (multiResponsibilityPatterns.test(subjectLine)) {
+        errors.push(`Message suggests multiple responsibilities. Split into separate commits.`);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Format validation errors for response.
+ */
+export function formatValidationErrors(errors, warnings) {
+    let text = `## Commit Blocked\n\n**Errors:**\n${errors.map((e) => `- ${e}`).join('\n')}`;
+    if (warnings.length > 0) {
+        text += `\n\n**Warnings:**\n${warnings.map((w) => `- ${w}`).join('\n')}`;
+    }
+    text += `\n${COMMIT_RULES}`;
+    return text;
+}
+/**
+ * Format successful commit response.
+ */
+export function formatCommitSuccess(output, warnings) {
+    let response = `## Commit Successful\n\n${output}`;
+    if (warnings.length > 0) {
+        response += `\n\n**Warnings:**\n${warnings.map((w) => `- ${w}`).join('\n')}`;
+    }
+    response += `\n${COMMIT_RULES}`;
+    return response;
+}
+/**
+ * Handle commit tool.
+ */
+export async function handleCommit(args, context) {
+    const git = getGitOperations(context);
+    // Validate commit message and branch
+    const validation = await validateCommit(args.message, context);
+    if (!validation.valid) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: formatValidationErrors(validation.errors, validation.warnings),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Track files we staged for potential rollback
+    const stagedByUs = [];
+    // Stage files if provided
+    if (args.files && args.files.length > 0) {
+        try {
+            await git.stageFiles(context.projectPath, args.files);
+            stagedByUs.push(...args.files);
+        }
+        catch (e) {
+            throw wrapError('Failed to stage files', 'git', e, { files: args.files });
+        }
+    }
+    // Check if there are staged changes
+    try {
+        const stagedFiles = await git.getStagedFiles(context.projectPath);
+        if (stagedFiles.length === 0) {
+            throw new GlanceyError('No staged changes to commit. Stage files first or pass files parameter.', 'git');
+        }
+    }
+    catch (e) {
+        if (e instanceof GlanceyError) {
+            throw e;
+        }
+        throw wrapError('Failed to check staged changes', 'git', e);
+    }
+    // Write marker file
+    git.writeMarkerFile(context.projectPath);
+    // Execute commit
+    try {
+        const output = await git.commit(context.projectPath, args.message);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: formatCommitSuccess(output, validation.warnings),
+                },
+            ],
+        };
+    }
+    catch (e) {
+        // Rollback: unstage files we staged if commit failed
+        if (stagedByUs.length > 0) {
+            try {
+                await git.unstageFiles(context.projectPath, stagedByUs);
+            }
+            catch {
+                // Ignore rollback failures - best effort
+            }
+        }
+        throw wrapError('Git commit failed', 'git', e, { message: args.message });
+    }
+}
+//# sourceMappingURL=commit-handlers.js.map

package/dist/tools/commit-handlers.js.map

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

package/dist/tools/index-handlers.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Tool handlers for index operations.
+ */
+import type { IndexProgress } from '../search/indexer.js';
+import type { ToolContext, ToolResponse } from './types.js';
+/**
+ * Arguments for index_codebase tool.
+ */
+export interface IndexCodebaseArgs {
+    patterns?: string[];
+    excludePatterns?: string[];
+    forceReindex?: boolean;
+    autoRepair?: boolean;
+}
+/**
+ * Parse and validate index_codebase arguments.
+ */
+export declare function parseIndexCodebaseArgs(args: Record<string, unknown> | undefined): IndexCodebaseArgs;
+/**
+ * Handle index_codebase tool.
+ */
+export declare function handleIndexCodebase(args: IndexCodebaseArgs, context: ToolContext, onProgress?: (progress: IndexProgress) => void): Promise<ToolResponse>;
+/**
+ * Handle get_index_status tool.
+ */
+export declare function handleGetIndexStatus(context: ToolContext): Promise<ToolResponse>;
+/**
+ * Handle clear_index tool.
+ */
+export declare function handleClearIndex(context: ToolContext): Promise<ToolResponse>;
+//# sourceMappingURL=index-handlers.d.ts.map

package/dist/tools/index-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-handlers.d.ts","sourceRoot":"","sources":["../../src/tools/index-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI5D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,iBAAiB,CAOnB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,GAC7C,OAAO,CAAC,YAAY,CAAC,CAmBvB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAetF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAGlF"}

package/dist/tools/index-handlers.js

@@ -0,0 +1,53 @@
+/**
+ * Tool handlers for index operations.
+ */
+import { createToolResponse } from './types.js';
+import { isStringArray, isBoolean } from '../utils/type-guards.js';
+/**
+ * Parse and validate index_codebase arguments.
+ */
+export function parseIndexCodebaseArgs(args) {
+    return {
+        patterns: isStringArray(args?.patterns) ? args.patterns : undefined,
+        excludePatterns: isStringArray(args?.excludePatterns) ? args.excludePatterns : undefined,
+        forceReindex: isBoolean(args?.forceReindex) ? args.forceReindex : false,
+        autoRepair: isBoolean(args?.autoRepair) ? args.autoRepair : false,
+    };
+}
+/**
+ * Handle index_codebase tool.
+ */
+export async function handleIndexCodebase(args, context, onProgress) {
+    const result = await context.indexer.indexCodebase(args.patterns, args.excludePatterns, args.forceReindex ?? false, onProgress, args.autoRepair ?? false);
+    const mode = result.repaired
+        ? 'Repaired (corruption detected)'
+        : result.incremental
+            ? 'Incremental update'
+            : 'Full reindex';
+    return createToolResponse(`${mode}: Indexed ${result.filesIndexed} files, total ${result.chunksCreated} chunks.`, context.toolGuidance);
+}
+/**
+ * Handle get_index_status tool.
+ */
+export async function handleGetIndexStatus(context) {
+    const status = await context.indexer.getStatus();
+    let statusText = JSON.stringify(status, null, 2);
+    if (status.corrupted) {
+        statusText =
+            `**WARNING: Index corruption detected!**\n` +
+                `Reason: ${status.corruptionReason}\n` +
+                `\nTo repair, either:\n` +
+                `1. Run \`index_codebase\` with \`autoRepair: true\`\n` +
+                `2. Run \`clear_index\` followed by \`index_codebase\`\n\n` +
+                statusText;
+    }
+    return createToolResponse(statusText, context.toolGuidance);
+}
+/**
+ * Handle clear_index tool.
+ */
+export async function handleClearIndex(context) {
+    await context.indexer.clearIndex();
+    return createToolResponse('Index cleared.', context.toolGuidance);
+}
+//# sourceMappingURL=index-handlers.js.map