@decibelsystems/tools 2.0.0

package/dist/tools/velocity/index.js

@@ -0,0 +1,306 @@
+// ============================================================================
+// Velocity Domain Tools
+// ============================================================================
+// Tools for tracking contributor velocity across time periods.
+// Captures commits, line counts, and issue metrics.
+// DOJO-PROP-0006 Implementation
+// ============================================================================
+import { toolSuccess, toolError, requireFields } from '../shared/index.js';
+import { captureSnapshot, listSnapshots, getTrends, getContributorReport, installHook, uninstallHook, isVelocityError, } from '../velocity.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const VALID_PERIODS = ['daily', 'weekly', 'quarterly'];
+const VALID_METRICS = ['commits', 'lines', 'issues'];
+// ============================================================================
+// velocity_snapshot - Capture a velocity snapshot
+// ============================================================================
+export const velocitySnapshotTool = {
+    definition: {
+        name: 'velocity_snapshot',
+        description: 'Capture a velocity snapshot for a time period. Aggregates git commits (with line counts) and Sentinel issues by contributor. Use this to track productivity metrics over time.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses default project if not specified.',
+                },
+                period: {
+                    type: 'string',
+                    enum: ['daily', 'weekly', 'quarterly'],
+                    description: 'Time period for the snapshot: daily, weekly, or quarterly',
+                },
+                referenceDate: {
+                    type: 'string',
+                    description: 'Optional ISO date to use as reference (default: now). Useful for capturing historical snapshots.',
+                },
+            },
+            required: ['period'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'period');
+            if (!VALID_PERIODS.includes(input.period)) {
+                throw new Error(`Invalid period. Must be one of: ${VALID_PERIODS.join(', ')}`);
+            }
+            const result = await captureSnapshot(input);
+            if (isVelocityError(result)) {
+                return toolError(JSON.stringify(result, null, 2));
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// velocity_list - List snapshots
+// ============================================================================
+export const velocityListTool = {
+    definition: {
+        name: 'velocity_list',
+        description: 'List velocity snapshots for a project. Shows snapshot metadata including contributor count and totals.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses default project if not specified.',
+                },
+                period: {
+                    type: 'string',
+                    enum: ['daily', 'weekly', 'quarterly'],
+                    description: 'Optional filter by time period',
+                },
+                limit: {
+                    type: 'integer',
+                    description: 'Maximum number of snapshots to return (default: 20)',
+                },
+            },
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            if (input.period && !VALID_PERIODS.includes(input.period)) {
+                throw new Error(`Invalid period. Must be one of: ${VALID_PERIODS.join(', ')}`);
+            }
+            const result = await listSnapshots(input);
+            if (isVelocityError(result)) {
+                return toolError(JSON.stringify(result, null, 2));
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// velocity_trends - Get velocity trends
+// ============================================================================
+export const velocityTrendsTool = {
+    definition: {
+        name: 'velocity_trends',
+        description: 'Get velocity trends by comparing recent snapshots. Shows direction (up/down/stable) and percent change for commits, lines, and issues.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses default project if not specified.',
+                },
+                period: {
+                    type: 'string',
+                    enum: ['daily', 'weekly', 'quarterly'],
+                    description: 'Time period to analyze trends for',
+                },
+                metric: {
+                    type: 'string',
+                    enum: ['commits', 'lines', 'issues'],
+                    description: 'Optional: filter to specific metric type',
+                },
+            },
+            required: ['period'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'period');
+            if (!VALID_PERIODS.includes(input.period)) {
+                throw new Error(`Invalid period. Must be one of: ${VALID_PERIODS.join(', ')}`);
+            }
+            if (input.metric && !VALID_METRICS.includes(input.metric)) {
+                throw new Error(`Invalid metric. Must be one of: ${VALID_METRICS.join(', ')}`);
+            }
+            const result = await getTrends(input);
+            if (isVelocityError(result)) {
+                return toolError(JSON.stringify(result, null, 2));
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// velocity_contributor - Individual contributor report
+// ============================================================================
+export const velocityContributorTool = {
+    definition: {
+        name: 'velocity_contributor',
+        description: 'Get velocity report for a specific contributor. Shows their metrics across snapshots with totals.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses default project if not specified.',
+                },
+                contributorId: {
+                    type: 'string',
+                    description: 'Contributor ID to look up (full ID or partial match, e.g., email or name)',
+                },
+                period: {
+                    type: 'string',
+                    enum: ['daily', 'weekly', 'quarterly'],
+                    description: 'Optional filter by time period',
+                },
+                limit: {
+                    type: 'integer',
+                    description: 'Maximum number of snapshots to include (default: 10)',
+                },
+            },
+            required: ['contributorId'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'contributorId');
+            if (input.period && !VALID_PERIODS.includes(input.period)) {
+                throw new Error(`Invalid period. Must be one of: ${VALID_PERIODS.join(', ')}`);
+            }
+            const result = await getContributorReport(input);
+            if (isVelocityError(result)) {
+                return toolError(JSON.stringify(result, null, 2));
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// velocity_install_hook - Install auto-capture git hook
+// ============================================================================
+const VALID_HOOK_TYPES = ['post-commit', 'post-push'];
+export const velocityInstallHookTool = {
+    definition: {
+        name: 'velocity_install_hook',
+        description: 'Install a git hook to auto-capture velocity snapshots. The hook runs after commits and captures a daily snapshot if one doesn\'t exist for today. Idempotent - safe to run multiple times.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses default project if not specified.',
+                },
+                hookType: {
+                    type: 'string',
+                    enum: ['post-commit', 'post-push'],
+                    description: 'Git hook type to install (default: post-commit)',
+                },
+                periods: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        enum: ['daily', 'weekly', 'quarterly'],
+                    },
+                    description: 'Which snapshot periods to auto-capture (default: [\'daily\'])',
+                },
+            },
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            if (input.hookType && !VALID_HOOK_TYPES.includes(input.hookType)) {
+                throw new Error(`Invalid hookType. Must be one of: ${VALID_HOOK_TYPES.join(', ')}`);
+            }
+            if (input.periods) {
+                for (const period of input.periods) {
+                    if (!VALID_PERIODS.includes(period)) {
+                        throw new Error(`Invalid period "${period}". Must be one of: ${VALID_PERIODS.join(', ')}`);
+                    }
+                }
+            }
+            const result = await installHook(input);
+            if (isVelocityError(result)) {
+                return toolError(JSON.stringify(result, null, 2));
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// velocity_uninstall_hook - Remove auto-capture git hook
+// ============================================================================
+export const velocityUninstallHookTool = {
+    definition: {
+        name: 'velocity_uninstall_hook',
+        description: 'Remove the velocity auto-capture git hook. Preserves other hooks if present.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses default project if not specified.',
+                },
+                hookType: {
+                    type: 'string',
+                    enum: ['post-commit', 'post-push'],
+                    description: 'Git hook type to remove (default: post-commit)',
+                },
+            },
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            if (input.hookType && !VALID_HOOK_TYPES.includes(input.hookType)) {
+                throw new Error(`Invalid hookType. Must be one of: ${VALID_HOOK_TYPES.join(', ')}`);
+            }
+            const result = await uninstallHook(input);
+            if (isVelocityError(result)) {
+                return toolError(JSON.stringify(result, null, 2));
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Export All Tools
+// ============================================================================
+export const velocityTools = [
+    velocitySnapshotTool,
+    velocityListTool,
+    velocityTrendsTool,
+    velocityContributorTool,
+    velocityInstallHookTool,
+    velocityUninstallHookTool,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/velocity/index.js.map

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

package/dist/tools/velocity.d.ts

@@ -0,0 +1,143 @@
+export type VelocityPeriod = 'daily' | 'weekly' | 'quarterly';
+export interface ContributorMetrics {
+    id: string;
+    commits: number;
+    linesAdded: number;
+    linesDeleted: number;
+    issuesClosed: number;
+    issuesOpened: number;
+}
+export interface VelocitySnapshot {
+    period: VelocityPeriod;
+    date: string;
+    range: {
+        start: string;
+        end: string;
+    };
+    contributors: ContributorMetrics[];
+    projectTotals: {
+        commits: number;
+        linesAdded: number;
+        linesDeleted: number;
+        issuesClosed: number;
+        issuesOpened: number;
+    };
+    capturedAt: string;
+}
+export interface VelocitySnapshotInput {
+    projectId?: string;
+    period: VelocityPeriod;
+    referenceDate?: string;
+}
+export interface VelocitySnapshotOutput {
+    snapshotId: string;
+    path: string;
+    period: VelocityPeriod;
+    date: string;
+    range: {
+        start: string;
+        end: string;
+    };
+    contributorCount: number;
+    totals: {
+        commits: number;
+        linesAdded: number;
+        linesDeleted: number;
+    };
+}
+export interface VelocityListInput {
+    projectId?: string;
+    period?: VelocityPeriod;
+    limit?: number;
+}
+export interface VelocityListOutput {
+    snapshots: Array<{
+        id: string;
+        period: VelocityPeriod;
+        date: string;
+        contributorCount: number;
+        commits: number;
+        linesAdded: number;
+        linesDeleted: number;
+    }>;
+    total: number;
+}
+export interface VelocityTrend {
+    metric: string;
+    direction: 'up' | 'down' | 'stable';
+    changePercent: number;
+    current: number;
+    previous: number;
+}
+export interface VelocityTrendsInput {
+    projectId?: string;
+    period: VelocityPeriod;
+    metric?: 'commits' | 'lines' | 'issues';
+}
+export interface VelocityTrendsOutput {
+    period: VelocityPeriod;
+    trends: VelocityTrend[];
+    comparedSnapshots: {
+        current: string;
+        previous: string;
+    } | null;
+}
+export interface VelocityContributorInput {
+    projectId?: string;
+    contributorId: string;
+    period?: VelocityPeriod;
+    limit?: number;
+}
+export interface VelocityContributorOutput {
+    contributorId: string;
+    snapshots: Array<{
+        date: string;
+        period: VelocityPeriod;
+        commits: number;
+        linesAdded: number;
+        linesDeleted: number;
+        issuesClosed: number;
+        issuesOpened: number;
+    }>;
+    totals: {
+        commits: number;
+        linesAdded: number;
+        linesDeleted: number;
+        issuesClosed: number;
+        issuesOpened: number;
+    };
+}
+export interface VelocityError {
+    error: string;
+    message: string;
+    hint?: string;
+}
+export declare function captureSnapshot(input: VelocitySnapshotInput): Promise<VelocitySnapshotOutput | VelocityError>;
+export declare function listSnapshots(input: VelocityListInput): Promise<VelocityListOutput | VelocityError>;
+export declare function getTrends(input: VelocityTrendsInput): Promise<VelocityTrendsOutput | VelocityError>;
+export declare function getContributorReport(input: VelocityContributorInput): Promise<VelocityContributorOutput | VelocityError>;
+export declare function isVelocityError(result: unknown): result is VelocityError;
+export interface InstallHookInput {
+    projectId?: string;
+    hookType?: 'post-commit' | 'post-push';
+    periods?: VelocityPeriod[];
+}
+export interface InstallHookOutput {
+    installed: boolean;
+    hookPath: string;
+    hookType: string;
+    periods: VelocityPeriod[];
+    message: string;
+}
+export interface UninstallHookInput {
+    projectId?: string;
+    hookType?: 'post-commit' | 'post-push';
+}
+export interface UninstallHookOutput {
+    removed: boolean;
+    hookPath: string;
+    message: string;
+}
+export declare function installHook(input: InstallHookInput): Promise<InstallHookOutput | VelocityError>;
+export declare function uninstallHook(input: UninstallHookInput): Promise<UninstallHookOutput | VelocityError>;
+//# sourceMappingURL=velocity.d.ts.map

package/dist/tools/velocity.d.ts.map

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