@pennyfarthing/cyclist 10.0.3 → 10.2.0

package/src/public/utils/messageFilters.ts

@@ -3,8 +3,10 @@
  *
  * Story MSSCI-12783 - Bug: Skill Content Displayed as User Message
  *
- * Functions to detect and filter skill/command content from user messages.
+ * Functions to detect and filter skill content from user messages.
  * Skill content is meant for Claude's context, not for display in the UI.
+ * Detected skill invocations are replaced with a short label (e.g. "reviewer")
+ * so the user sees what happened without the raw skill dump.
  */
 
 /**
@@ -18,6 +20,36 @@ const SKILL_CONTENT_MARKERS = [
   'Launching skill:',
 ] as const;
 
+/**
+ * Patterns that detect skill body content leaked as separate user messages.
+ * These are the raw skill markdown bodies that Claude Code sends as user messages
+ * after the initial <command-message> wrapper.
+ */
+const SKILL_BODY_PATTERNS = [
+  /^```bash\s*\npf agent start\b/,      // Agent activation bash block
+  /^pf agent start\b/,                   // Bare agent start command
+  /^<purpose>/,                           // Skill body XML tags
+  /^<when-to-use>/,
+  /^<execution>/,
+  /^<critical>\s*\n/,                     // Skill body starting with critical block
+] as const;
+
+/**
+ * Agent name to human-readable label mapping.
+ */
+const AGENT_LABELS: Record<string, string> = {
+  sm: 'Scrum Master',
+  tea: 'Test Engineer',
+  dev: 'Developer',
+  reviewer: 'Reviewer',
+  architect: 'Architect',
+  pm: 'Product Manager',
+  'tech-writer': 'Tech Writer',
+  'ux-designer': 'UX Designer',
+  devops: 'DevOps',
+  orchestrator: 'Orchestrator',
+};
+
 /**
  * Check if a message content string contains skill/command content
  * that should be filtered from user message display.
@@ -26,13 +58,54 @@ const SKILL_CONTENT_MARKERS = [
  * @returns true if the content contains skill markers and should be filtered
  */
 export function isSkillContent(content: string | null | undefined): boolean {
-  // Handle null/undefined/empty gracefully
   if (!content || typeof content !== 'string') {
     return false;
   }
 
-  // Check for any skill content marker
-  return SKILL_CONTENT_MARKERS.some(marker => content.includes(marker));
+  if (SKILL_CONTENT_MARKERS.some(marker => content.includes(marker))) {
+    return true;
+  }
+
+  const trimmed = content.trimStart();
+  return SKILL_BODY_PATTERNS.some(pattern => pattern.test(trimmed));
+}
+
+/**
+ * Extract the skill/agent name from skill content for labeling.
+ * Returns a human-readable label like "Scrum Master" or the raw skill name.
+ */
+export function extractSkillLabel(content: string | null | undefined): string | null {
+  if (!content || typeof content !== 'string') return null;
+
+  // Match <command-name>/foo</command-name>
+  const cmdMatch = content.match(/<command-name>\/?([^<]+)<\/command-name>/);
+  if (cmdMatch) {
+    const name = cmdMatch[1].trim();
+    return AGENT_LABELS[name] || name;
+  }
+
+  // Match <command-message>foo</command-message>
+  const msgMatch = content.match(/<command-message>([^<]+)<\/command-message>/);
+  if (msgMatch) {
+    const name = msgMatch[1].trim();
+    return AGENT_LABELS[name] || name;
+  }
+
+  // Match pf agent start "foo"
+  const agentMatch = content.match(/pf agent start\s+"([^"]+)"/);
+  if (agentMatch) {
+    const name = agentMatch[1].trim();
+    return AGENT_LABELS[name] || name;
+  }
+
+  // Match "Launching skill: foo"
+  const launchMatch = content.match(/Launching skill:\s*(\S+)/);
+  if (launchMatch) {
+    const name = launchMatch[1].trim();
+    return AGENT_LABELS[name] || name;
+  }
+
+  return null;
 }
 
 /**
@@ -46,11 +119,9 @@ export function filterSkillContentMessages<T extends { type: string; content?: s
   messages: T[]
 ): T[] {
   return messages.filter(msg => {
-    // Only filter user messages
     if (msg.type !== 'user') {
       return true;
     }
-    // Filter out skill content
     return !isSkillContent(msg.content);
   });
 }

package/src/public/utils/slash-commands.ts

@@ -36,14 +36,6 @@ export const SLASH_COMMANDS: SlashCommand[] = [
     "name": "/architect",
     "description": "System Architect - Technical design and architecture"
   },
-  {
-    "name": "/benchmark",
-    "description": "Compare an agent's performance against a stored baseline"
-  },
-  {
-    "name": "/benchmark-control",
-    "description": "Create control baseline for a scenario (shortcut for /benchmark control <agent>)"
-  },
   {
     "name": "/brainstorming",
     "description": "Structured problem-solving brainstorm session"
@@ -88,10 +80,6 @@ export const SLASH_COMMANDS: SlashCommand[] = [
     "name": "/create-branches-from-story",
     "description": "Create feature branches in both repos from a story"
   },
-  {
-    "name": "/create-theme",
-    "description": "Create a new custom persona theme"
-  },
   {
     "name": "/dev",
     "description": "Developer - Feature implementation and coding"
@@ -124,14 +112,6 @@ export const SLASH_COMMANDS: SlashCommand[] = [
     "name": "/init",
     "description": "Initialize CLAUDE.md"
   },
-  {
-    "name": "/job-fair",
-    "description": "Discover which characters in a theme excel at each role"
-  },
-  {
-    "name": "/list-themes",
-    "description": "List all available persona themes"
-  },
   {
     "name": "/login",
     "description": "Authenticate with Anthropic"
@@ -208,26 +188,14 @@ export const SLASH_COMMANDS: SlashCommand[] = [
     "name": "/run-ci",
     "description": "Detect and run CI locally"
   },
-  {
-    "name": "/set-theme",
-    "description": "Set the active persona theme"
-  },
   {
     "name": "/setup",
-    "description": "setup"
-  },
-  {
-    "name": "/show-theme",
-    "description": "Show details of a theme including all agent personas"
+    "description": "/setup - Interactive Project Setup"
   },
   {
     "name": "/sm",
     "description": "Scrum Master - Story coordination and sprint management"
   },
-  {
-    "name": "/solo",
-    "description": "Run a single agent on a scenario with absolute rubric scoring"
-  },
   {
     "name": "/sprint",
     "description": "Sprint status, backlog, and story management - check status, find work, archive completed stories"
@@ -269,8 +237,8 @@ export const SLASH_COMMANDS: SlashCommand[] = [
     "description": "Configure terminal"
   },
   {
-    "name": "/theme-maker",
-    "description": "Interactive wizard for creating custom persona themes"
+    "name": "/theme",
+    "description": "Manage persona themes - list, show, set, create, or interactive wizard"
   },
   {
     "name": "/update-domain-docs",

package/dist/hooks/cyclist-pretooluse-hook.d.ts

@@ -1,60 +0,0 @@
-/**
- * Cyclist PreToolUse Hook - Core Logic
- *
- * Testable module containing all hook logic. Invoked via cyclist-pretooluse-hook.sh
- * which calls `npx tsx` on this file, matching the .sh wrapper pattern used by
- * all other hooks in .claude/settings.local.json.
- *
- * Flow:
- * 1. Claude Code calls cyclist-pretooluse-hook.sh with tool info via stdin (JSON)
- * 2. Shell wrapper invokes this module via npx tsx
- * 3. Script reads port from .cyclist-port in project directory
- * 4. Script sends request to WheelHub's /api/hook-request endpoint
- * 5. WheelHub checks grants / shows approval modal, user decides
- * 6. Script receives response, outputs JSON decision to stdout
- * 7. Claude Code proceeds or blocks based on decision
- *
- * Per ADR-0004: All communication converges through WheelHub.
- *
- * Story: MSSCI-14320 - Update and register PreToolUse hook
- */
-export declare const DEFAULT_PORT = 7432;
-export declare const HOST = "127.0.0.1";
-export declare const TIMEOUT_MS = 120000;
-export declare const PORT_FILE = ".cyclist-port";
-export declare const LEGACY_PORT_FILE = ".cyclist-approval-port";
-export declare const ENDPOINT = "/api/hook-request";
-export interface ToolData {
-    tool_name: string;
-    tool_use_id: string;
-    tool_input: Record<string, unknown>;
-    session_id?: string;
-}
-export interface ApprovalRequest {
-    toolName: string;
-    toolId: string;
-    input: Record<string, unknown>;
-    sessionId?: string;
-}
-export interface ApprovalResponse {
-    decision: 'allow' | 'deny' | 'ask';
-    reason?: string;
-    data?: Record<string, unknown>;
-}
-export interface HookOutput {
-    hookSpecificOutput: {
-        hookEventName: 'PreToolUse';
-        permissionDecision: string;
-        permissionDecisionReason: string;
-        updatedInput?: Record<string, unknown>;
-    };
-}
-export declare function findProjectRoot(startDir?: string): string | null;
-export declare function getPort(projectRoot?: string | null): number;
-export declare function readPortFile(filePath: string): number | null;
-export declare function readStdin(): Promise<ToolData>;
-export declare function requestApproval(toolData: ApprovalRequest, port?: number): Promise<ApprovalResponse>;
-export declare function buildOutput(decision: string, reason: string, updatedInput?: Record<string, unknown> | null): HookOutput;
-export declare function outputDecision(decision: string, reason: string, updatedInput?: Record<string, unknown> | null): void;
-export declare function main(): Promise<void>;
-//# sourceMappingURL=cyclist-pretooluse-hook.d.ts.map

package/dist/hooks/cyclist-pretooluse-hook.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cyclist-pretooluse-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/cyclist-pretooluse-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAUH,eAAO,MAAM,YAAY,OAAO,CAAC;AACjC,eAAO,MAAM,IAAI,cAAc,CAAC;AAChC,eAAO,MAAM,UAAU,SAAU,CAAC;AAClC,eAAO,MAAM,SAAS,kBAAkB,CAAC;AACzC,eAAO,MAAM,gBAAgB,2BAA2B,CAAC;AACzD,eAAO,MAAM,QAAQ,sBAAsB,CAAC;AAM5C,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,kBAAkB,EAAE;QAClB,aAAa,EAAE,YAAY,CAAC;QAC5B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,wBAAwB,EAAE,MAAM,CAAC;QACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACxC,CAAC;CACH;AAMD,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEhE;AAED,wBAAgB,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE3D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE5D;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,CAEnD;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,eAAe,EACzB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC5C,UAAU,CAEZ;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC5C,IAAI,CAEN;AAED,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1C"}

package/dist/hooks/cyclist-pretooluse-hook.js

@@ -1,57 +0,0 @@
-/**
- * Cyclist PreToolUse Hook - Core Logic
- *
- * Testable module containing all hook logic. Invoked via cyclist-pretooluse-hook.sh
- * which calls `npx tsx` on this file, matching the .sh wrapper pattern used by
- * all other hooks in .claude/settings.local.json.
- *
- * Flow:
- * 1. Claude Code calls cyclist-pretooluse-hook.sh with tool info via stdin (JSON)
- * 2. Shell wrapper invokes this module via npx tsx
- * 3. Script reads port from .cyclist-port in project directory
- * 4. Script sends request to WheelHub's /api/hook-request endpoint
- * 5. WheelHub checks grants / shows approval modal, user decides
- * 6. Script receives response, outputs JSON decision to stdout
- * 7. Claude Code proceeds or blocks based on decision
- *
- * Per ADR-0004: All communication converges through WheelHub.
- *
- * Story: MSSCI-14320 - Update and register PreToolUse hook
- */
-// =============================================================================
-// Constants
-// =============================================================================
-export const DEFAULT_PORT = 7432;
-export const HOST = '127.0.0.1';
-export const TIMEOUT_MS = 120_000; // 2 minutes for user to decide
-export const PORT_FILE = '.cyclist-port';
-export const LEGACY_PORT_FILE = '.cyclist-approval-port';
-export const ENDPOINT = '/api/hook-request';
-// =============================================================================
-// Stubs - Dev implements these to GREEN
-// =============================================================================
-export function findProjectRoot(startDir) {
-    throw new Error('findProjectRoot not implemented');
-}
-export function getPort(projectRoot) {
-    throw new Error('getPort not implemented');
-}
-export function readPortFile(filePath) {
-    throw new Error('readPortFile not implemented');
-}
-export async function readStdin() {
-    throw new Error('readStdin not implemented');
-}
-export async function requestApproval(toolData, port) {
-    throw new Error('requestApproval not implemented');
-}
-export function buildOutput(decision, reason, updatedInput) {
-    throw new Error('buildOutput not implemented');
-}
-export function outputDecision(decision, reason, updatedInput) {
-    throw new Error('outputDecision not implemented');
-}
-export async function main() {
-    throw new Error('main not implemented');
-}
-//# sourceMappingURL=cyclist-pretooluse-hook.js.map

package/dist/hooks/cyclist-pretooluse-hook.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cyclist-pretooluse-hook.js","sourceRoot":"","sources":["../../src/hooks/cyclist-pretooluse-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AACjC,MAAM,CAAC,MAAM,IAAI,GAAG,WAAW,CAAC;AAChC,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,+BAA+B;AAClE,MAAM,CAAC,MAAM,SAAS,GAAG,eAAe,CAAC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AACzD,MAAM,CAAC,MAAM,QAAQ,GAAG,mBAAmB,CAAC;AAmC5C,gFAAgF;AAChF,wCAAwC;AACxC,gFAAgF;AAEhF,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,WAA2B;IACjD,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAyB,EACzB,IAAa;IAEb,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,MAAc,EACd,YAA6C;IAE7C,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,MAAc,EACd,YAA6C;IAE7C,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAC1C,CAAC"}

package/dist/hooks/pretooluse-hook.d.ts

@@ -1,89 +0,0 @@
-/**
- * Cyclist PreToolUse Hook - Core Logic
- *
- * Testable module containing all hook logic. The companion runner script
- * (cyclist-pretooluse-hook.js) imports from the compiled output and invokes main().
- *
- * Flow:
- * 1. Claude Code calls the runner script with tool info via stdin (JSON)
- * 2. Script reads port from .cyclist-port in project directory
- * 3. Script sends request to WheelHub's /api/hook-request endpoint
- * 4. WheelHub checks grants / shows approval modal, user decides
- * 5. Script receives response, outputs JSON decision to stdout
- * 6. Claude Code proceeds or blocks based on decision
- *
- * Per ADR-0004: All communication converges through WheelHub.
- *
- * Story: MSSCI-14320 - Update and register PreToolUse hook
- */
-export declare const DEFAULT_PORT = 7432;
-export declare const HOST = "127.0.0.1";
-export declare const TIMEOUT_MS = 120000;
-export declare const PORT_FILE = ".cyclist-port";
-export declare const LEGACY_PORT_FILE = ".cyclist-approval-port";
-export declare const ENDPOINT = "/api/hook-request";
-export interface ToolData {
-    tool_name: string;
-    tool_use_id: string;
-    tool_input: Record<string, unknown>;
-    session_id?: string;
-}
-export interface ApprovalRequest {
-    toolName: string;
-    toolId: string;
-    input: Record<string, unknown>;
-    sessionId?: string;
-}
-export interface ApprovalResponse {
-    decision: 'allow' | 'deny' | 'ask';
-    reason?: string;
-    data?: Record<string, unknown>;
-}
-export interface HookOutput {
-    hookSpecificOutput: {
-        hookEventName: 'PreToolUse';
-        permissionDecision: string;
-        permissionDecisionReason: string;
-        updatedInput?: Record<string, unknown>;
-    };
-}
-/**
- * Find the project root by looking for port files or .claude directory.
- * Walks up from startDir (defaults to cwd) until found or reaches filesystem root.
- */
-export declare function findProjectRoot(startDir?: string): string | null;
-/**
- * Read the WheelHub server port. Prefers .cyclist-port, falls back to
- * .cyclist-approval-port for migration compatibility, then default port.
- *
- * Mirrors hooks.py:get_cyclist_port() behavior.
- */
-export declare function getPort(projectRoot?: string | null): number;
-/**
- * Read a port number from a file. Returns null if file doesn't exist or is invalid.
- */
-export declare function readPortFile(filePath: string): number | null;
-/**
- * Read all stdin as JSON.
- */
-export declare function readStdin(): Promise<ToolData>;
-/**
- * Send approval request to WheelHub and wait for response.
- * Returns { decision: "ask" } when WheelHub is unreachable (ECONNREFUSED).
- */
-export declare function requestApproval(toolData: ApprovalRequest, port?: number): Promise<ApprovalResponse>;
-/**
- * Build the Claude Code hook output object.
- * MSSCI-11947: Supports updatedInput passthrough for interactive tools.
- */
-export declare function buildOutput(decision: string, reason: string, updatedInput?: Record<string, unknown> | null): HookOutput;
-/**
- * Output decision to stdout in Claude Code hook format.
- */
-export declare function outputDecision(decision: string, reason: string, updatedInput?: Record<string, unknown> | null): void;
-/**
- * Main hook logic. Reads stdin, sends to WheelHub, outputs decision.
- * MSSCI-11947: Handles data field passthrough for interactive tools.
- */
-export declare function main(): Promise<void>;
-//# sourceMappingURL=pretooluse-hook.d.ts.map

package/dist/hooks/pretooluse-hook.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pretooluse-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/pretooluse-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAUH,eAAO,MAAM,YAAY,OAAO,CAAC;AACjC,eAAO,MAAM,IAAI,cAAc,CAAC;AAChC,eAAO,MAAM,UAAU,SAAU,CAAC;AAClC,eAAO,MAAM,SAAS,kBAAkB,CAAC;AACzC,eAAO,MAAM,gBAAgB,2BAA2B,CAAC;AACzD,eAAO,MAAM,QAAQ,sBAAsB,CAAC;AAM5C,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,kBAAkB,EAAE;QAClB,aAAa,EAAE,YAAY,CAAC;QAC5B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,wBAAwB,EAAE,MAAM,CAAC;QACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACxC,CAAC;CACH;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBhE;AAMD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAmB3D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgB5D;AAMD;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,CAcnD;AAMD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,eAAe,EACzB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,CAAC,CA6C3B;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC5C,UAAU,CAcZ;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC5C,IAAI,CAEN;AAMD;;;GAGG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA2B1C"}

package/dist/hooks/pretooluse-hook.js

@@ -1,235 +0,0 @@
-/**
- * Cyclist PreToolUse Hook - Core Logic
- *
- * Testable module containing all hook logic. The companion runner script
- * (cyclist-pretooluse-hook.js) imports from the compiled output and invokes main().
- *
- * Flow:
- * 1. Claude Code calls the runner script with tool info via stdin (JSON)
- * 2. Script reads port from .cyclist-port in project directory
- * 3. Script sends request to WheelHub's /api/hook-request endpoint
- * 4. WheelHub checks grants / shows approval modal, user decides
- * 5. Script receives response, outputs JSON decision to stdout
- * 6. Claude Code proceeds or blocks based on decision
- *
- * Per ADR-0004: All communication converges through WheelHub.
- *
- * Story: MSSCI-14320 - Update and register PreToolUse hook
- */
-import http from 'node:http';
-import fs from 'node:fs';
-import path from 'node:path';
-// =============================================================================
-// Constants
-// =============================================================================
-export const DEFAULT_PORT = 7432;
-export const HOST = '127.0.0.1';
-export const TIMEOUT_MS = 120_000; // 2 minutes for user to decide
-export const PORT_FILE = '.cyclist-port';
-export const LEGACY_PORT_FILE = '.cyclist-approval-port';
-export const ENDPOINT = '/api/hook-request';
-// =============================================================================
-// Project Root Detection
-// =============================================================================
-/**
- * Find the project root by looking for port files or .claude directory.
- * Walks up from startDir (defaults to cwd) until found or reaches filesystem root.
- */
-export function findProjectRoot(startDir) {
-    let dir = startDir ?? process.cwd();
-    const root = path.parse(dir).root;
-    while (dir !== root) {
-        if (fs.existsSync(path.join(dir, PORT_FILE))) {
-            return dir;
-        }
-        if (fs.existsSync(path.join(dir, LEGACY_PORT_FILE))) {
-            return dir;
-        }
-        if (fs.existsSync(path.join(dir, '.claude'))) {
-            return dir;
-        }
-        dir = path.dirname(dir);
-    }
-    return null;
-}
-// =============================================================================
-// Port Discovery
-// =============================================================================
-/**
- * Read the WheelHub server port. Prefers .cyclist-port, falls back to
- * .cyclist-approval-port for migration compatibility, then default port.
- *
- * Mirrors hooks.py:get_cyclist_port() behavior.
- */
-export function getPort(projectRoot) {
-    const root = projectRoot ?? findProjectRoot();
-    if (!root) {
-        return DEFAULT_PORT;
-    }
-    // Try canonical port file first
-    const port = readPortFile(path.join(root, PORT_FILE));
-    if (port !== null) {
-        return port;
-    }
-    // Fall back to legacy port file
-    const legacyPort = readPortFile(path.join(root, LEGACY_PORT_FILE));
-    if (legacyPort !== null) {
-        return legacyPort;
-    }
-    return DEFAULT_PORT;
-}
-/**
- * Read a port number from a file. Returns null if file doesn't exist or is invalid.
- */
-export function readPortFile(filePath) {
-    if (!fs.existsSync(filePath)) {
-        return null;
-    }
-    try {
-        const content = fs.readFileSync(filePath, 'utf-8').trim();
-        const port = parseInt(content, 10);
-        if (!isNaN(port) && port > 0 && port < 65536) {
-            return port;
-        }
-    }
-    catch {
-        // Fall through
-    }
-    return null;
-}
-// =============================================================================
-// Stdin Reading
-// =============================================================================
-/**
- * Read all stdin as JSON.
- */
-export async function readStdin() {
-    return new Promise((resolve, reject) => {
-        let data = '';
-        process.stdin.setEncoding('utf8');
-        process.stdin.on('data', (chunk) => { data += chunk; });
-        process.stdin.on('end', () => {
-            try {
-                resolve(JSON.parse(data));
-            }
-            catch (e) {
-                reject(new Error(`Invalid JSON input: ${e.message}`));
-            }
-        });
-        process.stdin.on('error', reject);
-    });
-}
-// =============================================================================
-// HTTP Request
-// =============================================================================
-/**
- * Send approval request to WheelHub and wait for response.
- * Returns { decision: "ask" } when WheelHub is unreachable (ECONNREFUSED).
- */
-export async function requestApproval(toolData, port) {
-    const resolvedPort = port ?? getPort();
-    const postData = JSON.stringify(toolData);
-    return new Promise((resolve, reject) => {
-        const options = {
-            hostname: HOST,
-            port: resolvedPort,
-            path: ENDPOINT,
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'Content-Length': Buffer.byteLength(postData),
-            },
-            timeout: TIMEOUT_MS,
-        };
-        const req = http.request(options, (res) => {
-            let data = '';
-            res.on('data', (chunk) => { data += chunk; });
-            res.on('end', () => {
-                try {
-                    resolve(JSON.parse(data));
-                }
-                catch (e) {
-                    reject(new Error(`Invalid response from WheelHub: ${e.message}`));
-                }
-            });
-        });
-        req.on('error', (e) => {
-            if (e.code === 'ECONNREFUSED') {
-                resolve({ decision: 'ask', reason: 'WheelHub not running, deferring to Claude Code' });
-            }
-            else {
-                reject(e);
-            }
-        });
-        req.on('timeout', () => {
-            req.destroy();
-            reject(new Error('Approval request timed out'));
-        });
-        req.write(postData);
-        req.end();
-    });
-}
-// =============================================================================
-// Output Formatting
-// =============================================================================
-/**
- * Build the Claude Code hook output object.
- * MSSCI-11947: Supports updatedInput passthrough for interactive tools.
- */
-export function buildOutput(decision, reason, updatedInput) {
-    const output = {
-        hookSpecificOutput: {
-            hookEventName: 'PreToolUse',
-            permissionDecision: decision,
-            permissionDecisionReason: reason,
-        },
-    };
-    if (updatedInput) {
-        output.hookSpecificOutput.updatedInput = updatedInput;
-    }
-    return output;
-}
-/**
- * Output decision to stdout in Claude Code hook format.
- */
-export function outputDecision(decision, reason, updatedInput) {
-    console.log(JSON.stringify(buildOutput(decision, reason, updatedInput)));
-}
-// =============================================================================
-// Main Entry Point
-// =============================================================================
-/**
- * Main hook logic. Reads stdin, sends to WheelHub, outputs decision.
- * MSSCI-11947: Handles data field passthrough for interactive tools.
- */
-export async function main() {
-    try {
-        const toolData = await readStdin();
-        const { tool_name, tool_input, tool_use_id, session_id } = toolData;
-        const response = await requestApproval({
-            toolName: tool_name,
-            toolId: tool_use_id,
-            input: tool_input,
-            sessionId: session_id,
-        });
-        if (response.decision === 'allow') {
-            outputDecision('allow', response.reason || 'Approved by user', response.data || null);
-        }
-        else if (response.decision === 'deny') {
-            outputDecision('deny', response.reason || 'Rejected by user', response.data || null);
-        }
-        else if (response.decision === 'ask') {
-            outputDecision('ask', response.reason || 'Deferred to Claude Code');
-        }
-        else {
-            // Unknown decision - defer to Claude Code rather than silently allowing
-            outputDecision('ask', 'Unknown response from WheelHub');
-        }
-    }
-    catch (error) {
-        console.error(`[cyclist-hook] Error: ${error.message}`);
-        // Output ask so Claude Code shows its built-in dialog, don't silently allow
-        outputDecision('ask', 'Hook error, deferring to Claude Code');
-    }
-}
-//# sourceMappingURL=pretooluse-hook.js.map

package/dist/hooks/pretooluse-hook.js.map

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