@decibelsystems/tools 2.0.0

package/dist/tools/friction/index.js

@@ -0,0 +1,265 @@
+// ============================================================================
+// Friction Domain Tools
+// ============================================================================
+// Tools for tracking persistent pain points and friction in workflows.
+// ============================================================================
+import { toolSuccess, toolError, requireFields, withRunTracking, summaryGenerators } from '../shared/index.js';
+import { logFriction, listFriction, resolveFriction, bumpFriction, } from '../friction.js';
+// ============================================================================
+// Types
+// ============================================================================
+const VALID_FREQUENCIES = ['once', 'occasional', 'frequent', 'constant'];
+const VALID_IMPACTS = ['low', 'medium', 'high', 'blocking'];
+const VALID_STATUSES = ['open', 'acknowledged', 'solving', 'resolved', 'wontfix'];
+// ============================================================================
+// Log Friction Tool
+// ============================================================================
+export const frictionLogTool = {
+    definition: {
+        name: 'friction_log',
+        description: 'Log a persistent friction point or pain point. Both humans and agents can call this to track recurring issues that erode productivity. Signal strength increases when similar friction is logged multiple times.',
+        annotations: {
+            title: 'Log Friction',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+                context: {
+                    type: 'string',
+                    description: 'Where the friction occurs (project name, repo, system, or workflow)',
+                },
+                description: {
+                    type: 'string',
+                    description: 'What the friction is - the pain point or recurring issue',
+                },
+                frequency: {
+                    type: 'string',
+                    enum: ['once', 'occasional', 'frequent', 'constant'],
+                    description: 'How often this friction is encountered (default: occasional)',
+                },
+                impact: {
+                    type: 'string',
+                    enum: ['low', 'medium', 'high', 'blocking'],
+                    description: 'How much this friction affects productivity (default: medium)',
+                },
+                source: {
+                    type: 'string',
+                    enum: ['human', 'agent'],
+                    description: 'Who is logging this friction (default: human)',
+                },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Tags for categorization and searchability',
+                },
+                workaround: {
+                    type: 'string',
+                    description: 'Any current workaround being used',
+                },
+            },
+            required: ['context', 'description'],
+        },
+    },
+    handler: withRunTracking(async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'context', 'description');
+            if (input.frequency && !VALID_FREQUENCIES.includes(input.frequency)) {
+                throw new Error(`Invalid frequency. Must be one of: ${VALID_FREQUENCIES.join(', ')}`);
+            }
+            if (input.impact && !VALID_IMPACTS.includes(input.impact)) {
+                throw new Error(`Invalid impact. Must be one of: ${VALID_IMPACTS.join(', ')}`);
+            }
+            const result = await logFriction(input);
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    }, {
+        toolName: 'friction_log',
+        getSummary: summaryGenerators.friction,
+    }),
+};
+// ============================================================================
+// List Friction Tool
+// ============================================================================
+export const frictionListTool = {
+    definition: {
+        name: 'friction_list',
+        description: 'List friction points, sorted by impact and signal count. High-signal friction should be prioritized for resolution.',
+        annotations: {
+            title: 'List Friction',
+            readOnlyHint: true,
+            destructiveHint: false,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+                context: {
+                    type: 'string',
+                    description: 'Filter by context (project, repo, system)',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['open', 'acknowledged', 'solving', 'resolved', 'wontfix'],
+                    description: 'Filter by status',
+                },
+                min_impact: {
+                    type: 'string',
+                    enum: ['low', 'medium', 'high', 'blocking'],
+                    description: 'Minimum impact level to include',
+                },
+                limit: {
+                    type: 'integer',
+                    description: 'Maximum number of results (default: 20)',
+                },
+            },
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            if (input.status && !VALID_STATUSES.includes(input.status)) {
+                throw new Error(`Invalid status. Must be one of: ${VALID_STATUSES.join(', ')}`);
+            }
+            if (input.min_impact && !VALID_IMPACTS.includes(input.min_impact)) {
+                throw new Error(`Invalid min_impact. Must be one of: ${VALID_IMPACTS.join(', ')}`);
+            }
+            const result = await listFriction(input);
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Resolve Friction Tool
+// ============================================================================
+export const frictionResolveTool = {
+    definition: {
+        name: 'friction_resolve',
+        description: 'Mark a friction point as resolved. Can include a resolution note and reference to the solution (issue, ADR, commit).',
+        annotations: {
+            title: 'Resolve Friction',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+                friction_id: {
+                    type: 'string',
+                    description: 'The friction ID (filename or partial match)',
+                },
+                resolution: {
+                    type: 'string',
+                    description: 'How the friction was resolved',
+                },
+                solution_ref: {
+                    type: 'string',
+                    description: 'Optional reference to the solution (issue ID, ADR, commit SHA, PR)',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['resolved', 'wontfix'],
+                    description: 'Resolution status (default: resolved)',
+                },
+            },
+            required: ['friction_id', 'resolution'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'friction_id', 'resolution');
+            const result = await resolveFriction(input);
+            if ('error' in result) {
+                return toolError(JSON.stringify(result, null, 2));
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Bump Friction Tool
+// ============================================================================
+export const frictionBumpTool = {
+    definition: {
+        name: 'friction_bump',
+        description: 'Bump the signal count on an existing friction point. Use when encountering the same friction again. Higher signal = higher priority.',
+        annotations: {
+            title: 'Bump Friction',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+                friction_id: {
+                    type: 'string',
+                    description: 'The friction ID (filename or partial match)',
+                },
+                source: {
+                    type: 'string',
+                    enum: ['human', 'agent'],
+                    description: 'Who is bumping this friction (default: human)',
+                },
+                note: {
+                    type: 'string',
+                    description: 'Optional note about this occurrence',
+                },
+            },
+            required: ['friction_id'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'friction_id');
+            const result = await bumpFriction(input);
+            if ('error' in 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 frictionTools = [
+    frictionLogTool,
+    frictionListTool,
+    frictionResolveTool,
+    frictionBumpTool,
+];
+//# sourceMappingURL=index.js.map

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

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

package/dist/tools/friction.d.ts

@@ -0,0 +1,82 @@
+export interface ProjectResolutionError {
+    error: 'project_resolution_failed';
+    message: string;
+    hint: string;
+}
+export type FrictionSource = 'human' | 'agent';
+export type FrictionFrequency = 'once' | 'occasional' | 'frequent' | 'constant';
+export type FrictionImpact = 'low' | 'medium' | 'high' | 'blocking';
+export type FrictionStatus = 'open' | 'acknowledged' | 'solving' | 'resolved' | 'wontfix';
+export interface LogFrictionInput {
+    projectId?: string;
+    context: string;
+    description: string;
+    frequency?: FrictionFrequency;
+    impact?: FrictionImpact;
+    source?: FrictionSource;
+    tags?: string[];
+    workaround?: string;
+}
+export interface LogFrictionOutput {
+    id: string;
+    timestamp: string;
+    path: string;
+    context: string;
+    signal_strength: number;
+}
+export interface ListFrictionInput {
+    projectId?: string;
+    context?: string;
+    status?: FrictionStatus;
+    min_impact?: FrictionImpact;
+    source?: FrictionSource;
+    limit?: number;
+}
+export interface FrictionSummary {
+    id: string;
+    context: string;
+    description: string;
+    frequency: FrictionFrequency;
+    impact: FrictionImpact;
+    status: FrictionStatus;
+    signal_count: number;
+    last_reported: string;
+    tags: string[];
+}
+export interface ListFrictionOutput {
+    friction: FrictionSummary[];
+    total_count: number;
+}
+export interface ResolveFrictionInput {
+    projectId?: string;
+    friction_id: string;
+    resolution: string;
+    solution_ref?: string;
+    status?: 'resolved' | 'wontfix';
+}
+export interface ResolveFrictionOutput {
+    id: string;
+    path: string;
+    status: FrictionStatus;
+    resolved_at: string;
+}
+export interface BumpFrictionInput {
+    projectId?: string;
+    friction_id: string;
+    source?: FrictionSource;
+    note?: string;
+}
+export interface BumpFrictionOutput {
+    id: string;
+    signal_count: number;
+    last_reported: string;
+}
+export declare function logFriction(input: LogFrictionInput): Promise<LogFrictionOutput | ProjectResolutionError>;
+export declare function listFriction(input: ListFrictionInput): Promise<ListFrictionOutput | ProjectResolutionError>;
+export declare function resolveFriction(input: ResolveFrictionInput): Promise<ResolveFrictionOutput | ProjectResolutionError | {
+    error: string;
+}>;
+export declare function bumpFriction(input: BumpFrictionInput): Promise<BumpFrictionOutput | ProjectResolutionError | {
+    error: string;
+}>;
+//# sourceMappingURL=friction.d.ts.map

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

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