@ranger-testing/ranger-cli 1.1.6 → 2.0.0

package/build/commands/hooks/disable.js

@@ -1,12 +1,15 @@
 import { disableSession, disableBranch, getCurrentBranch, } from '../utils/sessionCache.js';
 import { printBlock } from './output.js';
 /**
- * Disable hook - disables Ranger hooks for this Claude session and current branch
+ * Disable hook - disables Ranger hooks for the current session and current branch.
+ * Session ID is resolved from the optional parameter (OpenCode --session-id),
+ * falling back to CLAUDE_SESSION_ID env var (Claude Code).
  */
-export async function disable() {
-    const sessionId = process.env.CLAUDE_SESSION_ID || '';
+export async function disable(sessionIdOverride) {
+    const sessionId = sessionIdOverride || process.env.CLAUDE_SESSION_ID || '';
     if (!sessionId) {
-        console.error('Error: CLAUDE_SESSION_ID not found in environment.');
+        console.error('Error: No session ID available.');
+        console.error('Provide --session-id or ensure CLAUDE_SESSION_ID is set.');
         process.exit(1);
     }
     // Disable hooks for this session
@@ -23,7 +26,7 @@ The user has expressly disabled Ranger hooks for this session${branch && branch
 **IMPORTANT INSTRUCTIONS:**
 - Do NOT use the /ranger skill
 - Do NOT use any \`ranger\` CLI commands
-- Proceed with your task without tracking features using the Ranger CLI
+- Proceed with your task without tracking feature reviews using the Ranger CLI
 
 To re-enable Ranger, run \`/ranger:enable\`.`);
 }

package/build/commands/hooks/disable.js.map

@@ -1 +1 @@
-{"version":3,"file":"disable.js","sourceRoot":"","sources":["../../../src/commands/hooks/disable.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,aAAa,EACb,gBAAgB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO;IACzB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAEtD,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,iCAAiC;IACjC,cAAc,CAAC,SAAS,CAAC,CAAC;IAE1B,wDAAwD;IACxD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,IAAI,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACrD,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,UAAU,CAAC;;+DAEgD,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE;;;;;;;6CAOrG,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"disable.js","sourceRoot":"","sources":["../../../src/commands/hooks/disable.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,aAAa,EACb,gBAAgB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,iBAA0B;IACpD,MAAM,SAAS,GAAG,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAE3E,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CACT,0DAA0D,CAC7D,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,iCAAiC;IACjC,cAAc,CAAC,SAAS,CAAC,CAAC;IAE1B,wDAAwD;IACxD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,IAAI,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACrD,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,UAAU,CAAC;;+DAEgD,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE;;;;;;;6CAOrG,CAAC,CAAC;AAC/C,CAAC"}

package/build/commands/hooks/enable.js

@@ -4,13 +4,15 @@ import { getRangerSkillContent } from '../utils/skillContent.js';
 import { printBlock } from './output.js';
 import { update } from '../update.js';
 /**
- * Enable hook - enables Ranger hooks for this Claude session
+ * Enable hook - enables Ranger hooks for the current session.
+ * Session ID is resolved from the optional parameter (OpenCode --session-id),
+ * falling back to CLAUDE_SESSION_ID env var (Claude Code).
  */
-export async function enable() {
-    const sessionId = process.env.CLAUDE_SESSION_ID || '';
+export async function enable(sessionIdOverride) {
+    const sessionId = sessionIdOverride || process.env.CLAUDE_SESSION_ID || '';
     if (!sessionId) {
-        console.error('Error: CLAUDE_SESSION_ID not found in environment.');
-        console.error('Make sure Ranger hooks are properly configured.');
+        console.error('Error: No session ID available.');
+        console.error('Provide --session-id or ensure CLAUDE_SESSION_ID is set.');
         process.exit(1);
     }
     // Check if CLI is configured (has token)
@@ -22,13 +24,18 @@ The Ranger CLI is not configured. To get started:
 
 1. Install: \`npm install -g @ranger-testing/ranger-cli\`
 2. Get token: https://dashboard.ranger.net/cli
-3. Initialize: \`ranger start <your-token>\`
+3. Initialize: \`ranger setup [token]\`
 
 Restart your Claude Code session after setup.`);
         return;
     }
     // Run ranger update to ensure CLI and skills are up to date
-    await update();
+    try {
+        await update();
+    }
+    catch {
+        // Non-fatal — don't block hook enablement if update check fails
+    }
     // Enable hooks for this session (and auto-enable branch if not on main)
     enableSession(sessionId);
     const branch = getCurrentBranch();
@@ -45,7 +52,7 @@ ${skillContent}
 
 ## Quick Reference
 
-**In plan mode:** Include Ranger Feature Specification at end of plan.
-**Not in plan mode:** Run \`ranger feature create\` FIRST, then verify with \`ranger verify-feature\`.`);
+**In plan mode:** Include Ranger Feature Review Specification at end of plan.
+**Not in plan mode:** Run \`ranger create\` FIRST, then verify with \`ranger go\`.`);
 }
 //# sourceMappingURL=enable.js.map

package/build/commands/hooks/enable.js.map

@@ -1 +1 @@
-{"version":3,"file":"enable.js","sourceRoot":"","sources":["../../../src/commands/hooks/enable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM;IACxB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAEtD,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACpE,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,yCAAyC;IACzC,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,UAAU,CAAC;;;;;;;;8CAQ2B,CAAC,CAAC;QACxC,OAAO;IACX,CAAC;IAED,4DAA4D;IAC5D,MAAM,MAAM,EAAE,CAAC;IAEf,wEAAwE;IACxE,aAAa,CAAC,SAAS,CAAC,CAAC;IAEzB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,UAAU,GACZ,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ;QAC9C,CAAC,CAAC,iBAAiB,MAAM,8EAA8E;QACvG,CAAC,CAAC,EAAE,CAAC;IAEb,0BAA0B;IAC1B,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;IAE7C,UAAU,CAAC,mBAAmB,UAAU;;;;EAI1C,YAAY;;;;;uGAKyF,CAAC,CAAC;AACzG,CAAC"}
+{"version":3,"file":"enable.js","sourceRoot":"","sources":["../../../src/commands/hooks/enable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,iBAA0B;IACnD,MAAM,SAAS,GAAG,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAE3E,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CACT,0DAA0D,CAC7D,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,yCAAyC;IACzC,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,UAAU,CAAC;;;;;;;;8CAQ2B,CAAC,CAAC;QACxC,OAAO;IACX,CAAC;IAED,4DAA4D;IAC5D,IAAI,CAAC;QACD,MAAM,MAAM,EAAE,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACL,gEAAgE;IACpE,CAAC;IAED,wEAAwE;IACxE,aAAa,CAAC,SAAS,CAAC,CAAC;IAEzB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,UAAU,GACZ,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ;QAC9C,CAAC,CAAC,iBAAiB,MAAM,8EAA8E;QACvG,CAAC,CAAC,EAAE,CAAC;IAEb,0BAA0B;IAC1B,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;IAE7C,UAAU,CAAC,mBAAmB,UAAU;;;;EAI1C,YAAY;;;;;mFAKqE,CAAC,CAAC;AACrF,CAAC"}

package/build/commands/hooks/exitPlanMode.js

@@ -3,32 +3,32 @@ import { printBlock, getEnabledSessionId } from './output.js';
  * PermissionRequest hook handler for ExitPlanMode
  *
  * This command is invoked when Claude requests permission to exit plan mode.
- * It reminds Claude to create a Ranger feature to track the work.
+ * It reminds Claude to create a Ranger feature review to track the work.
  */
-export async function exitPlanMode() {
-    const sessionId = await getEnabledSessionId();
+export async function exitPlanMode(sessionIdOverride) {
+    const sessionId = await getEnabledSessionId(sessionIdOverride);
     if (!sessionId) {
         return;
     }
-    printBlock(`=== RANGER: CREATE FEATURE NOW ===
+    printBlock(`=== RANGER: CREATE FEATURE REVIEW NOW ===
 
 You are about to exit plan mode. If your plan includes UI changes:
 
-**ACTION REQUIRED:** Create the Ranger feature using items from your Ranger Feature Specification:
+**ACTION REQUIRED:** Create the Ranger feature review using scenarios from your Ranger Feature Review Specification:
 
 \`\`\`
-ranger feature create "<Feature Name from plan>" \\
+ranger create "<Feature Review Name from plan>" \\
   -d "<Description from plan>" \\
-  -c "<Checklist item 1 from plan>" \\
-  -c "<Checklist item 2 from plan>"
+  -c "<Scenario 1 from plan>" \\
+  -c "<Scenario 2 from plan>"
 \`\`\`
 
-**REMINDER:** Checklist items must be E2E user flows, NOT implementation tasks.
+**REMINDER:** Scenarios must be E2E user flows, NOT implementation tasks.
 
 **Good:** "User can log in with valid credentials and see dashboard"
 **Bad:** "Add form validation" or "API returns 200"
 
-If you did NOT include a Ranger Feature Specification in your plan, go back and add one before proceeding. See /ranger and create.md for guidance.
+If you did NOT include a Ranger Feature Review Specification in your plan, go back and add one before proceeding. See /ranger and create.md for guidance.
 
 === END ===`);
 }

package/build/commands/hooks/exitPlanMode.js.map

@@ -1 +1 @@
-{"version":3,"file":"exitPlanMode.js","sourceRoot":"","sources":["../../../src/commands/hooks/exitPlanMode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAC9B,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO;IACX,CAAC;IAED,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;YAoBH,CAAC,CAAC;AACd,CAAC"}
+{"version":3,"file":"exitPlanMode.js","sourceRoot":"","sources":["../../../src/commands/hooks/exitPlanMode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,iBAA0B;IACzD,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO;IACX,CAAC;IAED,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;YAoBH,CAAC,CAAC;AACd,CAAC"}

package/build/commands/hooks/index.js

@@ -8,4 +8,5 @@ export { exitPlanMode } from './exitPlanMode.js';
 export { stopHook } from './stopHook.js';
 export { enable } from './enable.js';
 export { disable } from './disable.js';
+export { autoPrompt } from './autoPrompt.js';
 //# sourceMappingURL=index.js.map

package/build/commands/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/build/commands/hooks/output.js

@@ -29,8 +29,14 @@ export async function readHookInput() {
  * Read hook input and check if session is enabled.
  * Returns session_id if enabled, null otherwise.
  * Use this as the standard guard at the start of most hooks.
+ *
+ * When sessionIdOverride is provided (e.g. from --session-id flag for
+ * non-Claude integrations like OpenCode), stdin is not read.
  */
-export async function getEnabledSessionId() {
+export async function getEnabledSessionId(sessionIdOverride) {
+    if (sessionIdOverride) {
+        return isSessionEnabled(sessionIdOverride) ? sessionIdOverride : null;
+    }
     const input = await readHookInput();
     const sessionId = input?.session_id;
     if (!sessionId || !isSessionEnabled(sessionId)) {
@@ -41,8 +47,20 @@ export async function getEnabledSessionId() {
 /**
  * Read hook input and return full context for hooks that need more data.
  * Returns null if session not enabled.
+ *
+ * When sessionIdOverride is provided, stdin is not read and a synthetic
+ * HookInput is used (no permission_mode or other stdin-only fields).
  */
-export async function getEnabledHookContext() {
+export async function getEnabledHookContext(sessionIdOverride) {
+    if (sessionIdOverride) {
+        if (!isSessionEnabled(sessionIdOverride)) {
+            return null;
+        }
+        return {
+            sessionId: sessionIdOverride,
+            input: { session_id: sessionIdOverride },
+        };
+    }
     const input = await readHookInput();
     const sessionId = input?.session_id;
     if (!sessionId || !isSessionEnabled(sessionId)) {

package/build/commands/hooks/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/commands/hooks/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAWD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IAC/B,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACtC,KAAK,IAAI,KAAK,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAc,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACrC,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,KAAK,EAAE,UAAU,CAAC;IAEpC,IAAI,CAAC,SAAS,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IAIvC,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,KAAK,EAAE,UAAU,CAAC;IAEpC,IAAI,CAAC,SAAS,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC"}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/commands/hooks/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAWD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IAC/B,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACtC,KAAK,IAAI,KAAK,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAc,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,iBAA0B;IAE1B,IAAI,iBAAiB,EAAE,CAAC;QACpB,OAAO,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,KAAK,EAAE,UAAU,CAAC;IAEpC,IAAI,CAAC,SAAS,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,iBAA0B;IAK1B,IAAI,iBAAiB,EAAE,CAAC;QACpB,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO;YACH,SAAS,EAAE,iBAAiB;YAC5B,KAAK,EAAE,EAAE,UAAU,EAAE,iBAAiB,EAAE;SAC3C,CAAC;IACN,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,KAAK,EAAE,UAAU,CAAC;IAEpC,IAAI,CAAC,SAAS,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC"}

package/build/commands/hooks/planReminder.js

@@ -6,8 +6,8 @@ import { shouldShowPlanReminder } from '../utils/sessionCache.js';
  * This command is invoked on UserPromptSubmit, SubagentStop, and PostToolUse.
  * It checks if in plan mode and shows the Ranger reminder (max once per 5 mins per session).
  */
-export async function planReminder() {
-    const ctx = await getEnabledHookContext();
+export async function planReminder(sessionIdOverride) {
+    const ctx = await getEnabledHookContext(sessionIdOverride);
     if (!ctx) {
         return;
     }
@@ -24,22 +24,22 @@ export async function planReminder() {
 If this plan involves ANY UI changes, you MUST:
 
 1. **READ /ranger skill NOW** - specifically the create.md instructions
-2. **Add a Ranger Feature Specification** to the end of your plan
+2. **Add a Ranger Feature Review Specification** to the end of your plan
 
-DO NOT write checklist items without reading create.md first.
-Checklist items are E2E test scenarios, NOT implementation tasks.
+DO NOT write scenarios without reading create.md first.
+Scenarios are E2E test flows, NOT implementation tasks.
 
 Your plan must end with:
 \`\`\`
-### Ranger Feature Specification (create this first with \`ranger feature create\`)
-Feature Name: <name>
+### Ranger Feature Review Specification (create this first with \`ranger create\`)
+Feature Review Name: <name>
 Description: <description>
-Checklist:
+Scenarios:
 1. <E2E user flow that can be verified in browser>
 2. <another E2E user flow if needed>
 \`\`\`
 
-Then run: \`ranger feature create "<name>" -d "<desc>" -c "<item1>" -c "<item2>"\`
+Then run: \`ranger create "<name>" -d "<desc>" -c "<scenario1>" -c "<scenario2>"\`
 
 === END ===`);
 }

package/build/commands/hooks/planReminder.js.map

@@ -1 +1 @@
-{"version":3,"file":"planReminder.js","sourceRoot":"","sources":["../../../src/commands/hooks/planReminder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAC9B,MAAM,GAAG,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,OAAO;IACX,CAAC;IAED,yBAAyB;IACzB,IAAI,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,MAAM,EAAE,CAAC;QACvC,OAAO;IACX,CAAC;IAED,kEAAkE;IAClE,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,OAAO;IACX,CAAC;IAED,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;YAsBH,CAAC,CAAC;AACd,CAAC"}
+{"version":3,"file":"planReminder.js","sourceRoot":"","sources":["../../../src/commands/hooks/planReminder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,iBAA0B;IACzD,MAAM,GAAG,GAAG,MAAM,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;IAC3D,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,OAAO;IACX,CAAC;IAED,yBAAyB;IACzB,IAAI,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,MAAM,EAAE,CAAC;QACvC,OAAO;IACX,CAAC;IAED,kEAAkE;IAClE,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,OAAO;IACX,CAAC;IAED,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;YAsBH,CAAC,CAAC;AACd,CAAC"}

package/build/commands/hooks/planStart.js

@@ -3,10 +3,10 @@ import { printBlock, getEnabledSessionId } from './output.js';
  * SubagentStart hook handler for Plan mode
  *
  * This command is invoked when Claude enters plan mode (Plan subagent starts).
- * It reminds Claude to include Ranger checklist items as part of the planning process.
+ * It reminds Claude to include Ranger scenarios as part of the planning process.
  */
-export async function planStart() {
-    const sessionId = await getEnabledSessionId();
+export async function planStart(sessionIdOverride) {
+    const sessionId = await getEnabledSessionId(sessionIdOverride);
     if (!sessionId) {
         return;
     }
@@ -15,15 +15,15 @@ export async function planStart() {
 If this plan involves UI changes, you MUST:
 
 1. **READ /ranger skill** - specifically create.md
-2. **Add a Ranger Feature Specification** at the end of your plan
+2. **Add a Ranger Feature Review Specification** at the end of your plan
 
-Checklist items are E2E test scenarios, NOT implementation tasks.
+Scenarios are E2E test flows, NOT implementation tasks.
 
 **Good:** "User can log in with valid credentials and see dashboard"
 **Bad:** "Add form validation" or "Button is visible"
 
 After planning, run:
-\`ranger feature create "<name>" -d "<desc>" -c "<E2E flow 1>" -c "<E2E flow 2>"\`
+\`ranger create "<name>" -d "<desc>" -c "<E2E flow 1>" -c "<E2E flow 2>"\`
 
 === END ===`);
 }

package/build/commands/hooks/planStart.js.map

@@ -1 +1 @@
-{"version":3,"file":"planStart.js","sourceRoot":"","sources":["../../../src/commands/hooks/planStart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC3B,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO;IACX,CAAC;IAED,UAAU,CAAC;;;;;;;;;;;;;;;YAeH,CAAC,CAAC;AACd,CAAC"}
+{"version":3,"file":"planStart.js","sourceRoot":"","sources":["../../../src/commands/hooks/planStart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,iBAA0B;IACtD,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO;IACX,CAAC;IAED,UAAU,CAAC;;;;;;;;;;;;;;;YAeH,CAAC,CAAC;AACd,CAAC"}

package/build/commands/hooks/postEdit.js

@@ -5,10 +5,10 @@ import { getEnabledSessionId } from './output.js';
  * PostToolUse (Write/Edit) hook handler for Claude Code plugin
  *
  * This command is invoked automatically after Write or Edit tools are used.
- * If the session isn't registered with a Ranger feature, prompts to use /ranger.
+ * If the session isn't registered with a Ranger feature review, prompts to use /ranger.
  */
-export async function postEdit() {
-    const sessionId = await getEnabledSessionId();
+export async function postEdit(sessionIdOverride) {
+    const sessionId = await getEnabledSessionId(sessionIdOverride);
     if (!sessionId) {
         return;
     }
@@ -21,11 +21,11 @@ export async function postEdit() {
     // Check if this session is already registered
     const existingEntry = getSessionEntry(sessionId);
     if (existingEntry) {
-        // Already registered - remind about adding checklist items if scope expanded
+        // Already registered - remind about adding scenarios if scope expanded
         const response = {
             hookSpecificOutput: {
                 hookEventName: 'PostToolUse',
-                additionalContext: `RANGER: If this change expands the scope of the active feature, you may need to add a checklist item. See Workflow 1 in /ranger. If you decide to add a checklist item, you MUST read Workflow 1 IN DETAIL first.`,
+                additionalContext: `RANGER: If this change expands the scope of the active feature review, you may need to add a scenario. See Workflow 1 in /ranger. If you decide to add a scenario, you MUST read Workflow 1 IN DETAIL first.`,
             },
         };
         console.log(JSON.stringify(response));
@@ -35,7 +35,7 @@ export async function postEdit() {
     const response = {
         hookSpecificOutput: {
             hookEventName: 'PostToolUse',
-            additionalContext: `RANGER: If this is for a UI feature, you MUST use /ranger to either create a new feature or resume an existing one.`,
+            additionalContext: `RANGER: If this is for a UI feature, you MUST use /ranger to either create a new feature review or resume an existing one.`,
         },
     };
     console.log(JSON.stringify(response));

package/build/commands/hooks/postEdit.js.map

@@ -1 +1 @@
-{"version":3,"file":"postEdit.js","sourceRoot":"","sources":["../../../src/commands/hooks/postEdit.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,eAAe,EACf,oBAAoB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC1B,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO;IACX,CAAC;IAED,sFAAsF;IACtF,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO;IACX,CAAC;IAED,8CAA8C;IAC9C,MAAM,aAAa,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,aAAa,EAAE,CAAC;QAChB,6EAA6E;QAC7E,MAAM,QAAQ,GAAG;YACb,kBAAkB,EAAE;gBAChB,aAAa,EAAE,aAAa;gBAC5B,iBAAiB,EAAE,mNAAmN;aACzO;SACJ,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtC,OAAO;IACX,CAAC;IAED,qDAAqD;IACrD,MAAM,QAAQ,GAAG;QACb,kBAAkB,EAAE;YAChB,aAAa,EAAE,aAAa;YAC5B,iBAAiB,EAAE,qHAAqH;SAC3I;KACJ,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"postEdit.js","sourceRoot":"","sources":["../../../src/commands/hooks/postEdit.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,eAAe,EACf,oBAAoB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,iBAA0B;IACrD,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO;IACX,CAAC;IAED,sFAAsF;IACtF,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO;IACX,CAAC;IAED,8CAA8C;IAC9C,MAAM,aAAa,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,aAAa,EAAE,CAAC;QAChB,uEAAuE;QACvE,MAAM,QAAQ,GAAG;YACb,kBAAkB,EAAE;gBAChB,aAAa,EAAE,aAAa;gBAC5B,iBAAiB,EAAE,8MAA8M;aACpO;SACJ,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtC,OAAO;IACX,CAAC;IAED,qDAAqD;IACrD,MAAM,QAAQ,GAAG;QACb,kBAAkB,EAAE;YAChB,aAAa,EAAE,aAAa;YAC5B,iBAAiB,EAAE,4HAA4H;SAClJ;KACJ,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/build/commands/hooks/preCompact.js

@@ -4,10 +4,10 @@ import { printBlock, getEnabledSessionId } from './output.js';
  * PreCompact hook handler for Claude Code plugin
  *
  * This command is invoked automatically before Claude Code compacts the conversation.
- * It reminds Claude to preserve Ranger Feature Specification in the compaction summary.
+ * It reminds Claude to preserve Ranger Feature Review Specification in the compaction summary.
  */
-export async function preCompact() {
-    const sessionId = await getEnabledSessionId();
+export async function preCompact(sessionIdOverride) {
+    const sessionId = await getEnabledSessionId(sessionIdOverride);
     if (!sessionId) {
         return;
     }
@@ -19,9 +19,9 @@ export async function preCompact() {
         }
         printBlock(`=== RANGER: PRESERVE IN COMPACTION ===
 
-If you created a plan with a **Ranger Feature Specification**, you MUST preserve it in the compaction summary.
+If you created a plan with a **Ranger Feature Review Specification**, you MUST preserve it in the compaction summary.
 
-The specification contains checklist items that will be used with \`ranger feature create\`.`);
+The specification contains scenarios that will be used with \`ranger create\`.`);
     }
     catch {
         // Silently fail - don't interrupt compaction

package/build/commands/hooks/preCompact.js.map

@@ -1 +1 @@
-{"version":3,"file":"preCompact.js","sourceRoot":"","sources":["../../../src/commands/hooks/preCompact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC5B,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,gCAAgC;QAChC,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO;QACX,CAAC;QAED,UAAU,CAAC;;;;6FAI0E,CAAC,CAAC;IAC3F,CAAC;IAAC,MAAM,CAAC;QACL,6CAA6C;IACjD,CAAC;AACL,CAAC"}
+{"version":3,"file":"preCompact.js","sourceRoot":"","sources":["../../../src/commands/hooks/preCompact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,iBAA0B;IACvD,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,gCAAgC;QAChC,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO;QACX,CAAC;QAED,UAAU,CAAC;;;;+EAI4D,CAAC,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACL,6CAA6C;IACjD,CAAC;AACL,CAAC"}

package/build/commands/hooks/sessionEnd.js

@@ -6,10 +6,14 @@ import { readHookInput } from './output.js';
  * This command is invoked when a Claude Code session ends.
  * If reason is 'clear' and session was enabled, records timestamp for auto-enable.
  */
-export async function sessionEnd() {
-    const input = await readHookInput();
-    const sessionId = input?.session_id;
-    const reason = input?.reason;
+export async function sessionEnd(sessionIdOverride) {
+    let sessionId = sessionIdOverride;
+    let reason;
+    if (!sessionIdOverride) {
+        const input = await readHookInput();
+        sessionId = input?.session_id;
+        reason = input?.reason;
+    }
     if (!sessionId) {
         return;
     }

package/build/commands/hooks/sessionEnd.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessionEnd.js","sourceRoot":"","sources":["../../../src/commands/hooks/sessionEnd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC5B,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,KAAK,EAAE,UAAU,CAAC;IACpC,MAAM,MAAM,GAAG,KAAK,EAAE,MAA4B,CAAC;IAEnD,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO;IACX,CAAC;IAED,oEAAoE;IACpE,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACrB,2BAA2B,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;AACL,CAAC"}
+{"version":3,"file":"sessionEnd.js","sourceRoot":"","sources":["../../../src/commands/hooks/sessionEnd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,iBAA0B;IACvD,IAAI,SAAS,GAAG,iBAAiB,CAAC;IAClC,IAAI,MAA0B,CAAC;IAE/B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;QACpC,SAAS,GAAG,KAAK,EAAE,UAAU,CAAC;QAC9B,MAAM,GAAG,KAAK,EAAE,MAA4B,CAAC;IACjD,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO;IACX,CAAC;IAED,oEAAoE;IACpE,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACrB,2BAA2B,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;AACL,CAAC"}

package/build/commands/hooks/sessionStart.js

@@ -1,5 +1,6 @@
 import { appendFile } from 'fs/promises';
 import { initBranchTracking, shouldAutoEnableAfterClear, autoEnableAfterClear, isSessionEnabled, getCurrentBranch, } from '../utils/sessionCache.js';
+import { createTelemetryCollector } from '../utils/telemetry.js';
 const RANGER_AUTO_ENABLED_PROMPT = `=================================================================
                     🚨 RANGER IS ACTIVE 🚨
 =================================================================
@@ -8,13 +9,13 @@ This session has Ranger ENABLED. Before doing ANYTHING else:
 
 1. **READ the /ranger skill FIRST** - Run the skill to understand the required workflow for UI features
 
-2. **Check for existing features** - Run \`ranger feature list\` to see if there's an in-progress feature to resume
+2. **Check for existing feature reviews** - Run \`ranger list\` to see if there's an in-progress feature review to resume
 
 3. **For ANY UI work**: You MUST either:
-   - Resume an existing feature: \`ranger feature resume <id>\`
-   - Create a new feature: \`ranger feature create "<name>" -d "<desc>" -c "<checklist item>"\`
+   - Resume an existing feature review: \`ranger resume <id>\`
+   - Create a new feature review: \`ranger create "<name>" -d "<desc>" -c "<scenario>"\`
 
-4. **If resuming a feature with reviewer comments**: Run \`ranger feature get-feedback\` to see what reviewers want fixed before making code changes
+4. **If resuming a feature review with reviewer comments**: Run \`ranger get-review\` to see what reviewers want fixed before making code changes
 
 =================================================================`;
 /**
@@ -25,30 +26,32 @@ This session has Ranger ENABLED. Before doing ANYTHING else:
  *
  * Note: The skill prompt is now shown by the enable hook when user runs /enable.
  */
-export async function sessionStart() {
-    // Read JSON input from stdin to get session_id and source
-    let input = '';
-    for await (const chunk of process.stdin) {
-        input += chunk;
-    }
-    let sessionId = '';
+export async function sessionStart(sessionIdOverride) {
+    let sessionId = sessionIdOverride || '';
     let source;
-    try {
-        const data = JSON.parse(input);
-        sessionId = data['session_id'] || '';
-        source = data['source'];
-    }
-    catch {
-        // Ignore parse errors
-    }
-    // Export CLAUDE_SESSION_ID to env file if available
-    const envFile = process.env.CLAUDE_ENV_FILE;
-    if (envFile && sessionId) {
+    if (!sessionIdOverride) {
+        // Claude Code path: read JSON input from stdin to get session_id and source
+        let input = '';
+        for await (const chunk of process.stdin) {
+            input += chunk;
+        }
         try {
-            await appendFile(envFile, `export CLAUDE_SESSION_ID="${sessionId}"\n`);
+            const data = JSON.parse(input);
+            sessionId = data['session_id'] || '';
+            source = data['source'];
         }
         catch {
-            // Ignore errors writing to env file
+            // Ignore parse errors
+        }
+        // Export CLAUDE_SESSION_ID to env file if available (Claude Code only)
+        const envFile = process.env.CLAUDE_ENV_FILE;
+        if (envFile && sessionId) {
+            try {
+                await appendFile(envFile, `export CLAUDE_SESSION_ID="${sessionId}"\n`);
+            }
+            catch {
+                // Ignore errors writing to env file
+            }
         }
     }
     if (sessionId) {
@@ -58,8 +61,21 @@ export async function sessionStart() {
         }
         // Initialize branch tracking - auto-enable session if branch is already enabled
         initBranchTracking(sessionId);
+        const enabled = isSessionEnabled(sessionId);
+        // Telemetry: log session start with enabled status
+        try {
+            const telemetry = createTelemetryCollector('hook:session-start');
+            await telemetry.trackCommandStart({
+                sessionId,
+                hooksEnabled: enabled,
+            });
+            await telemetry.trackCommandEnd('success');
+        }
+        catch {
+            // Telemetry must never throw
+        }
         // If session is now enabled (via branch or clear), output strong prompting
-        if (isSessionEnabled(sessionId)) {
+        if (enabled) {
             const branch = getCurrentBranch();
             const branchInfo = branch && branch !== 'main' && branch !== 'master'
                 ? ` (Branch: ${branch})`

package/build/commands/hooks/sessionStart.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessionStart.js","sourceRoot":"","sources":["../../../src/commands/hooks/sessionStart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACH,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,0BAA0B,CAAC;AAElC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;kEAgB+B,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAC9B,0DAA0D;IAC1D,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACtC,KAAK,IAAI,KAAK,CAAC;IACnB,CAAC;IAED,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,MAA0B,CAAC;IAC/B,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACL,sBAAsB;IAC1B,CAAC;IAED,oDAAoD;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC5C,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC;YACD,MAAM,UAAU,CACZ,OAAO,EACP,6BAA6B,SAAS,KAAK,CAC9C,CAAC;QACN,CAAC;QAAC,MAAM,CAAC;YACL,oCAAoC;QACxC,CAAC;IACL,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACZ,mFAAmF;QACnF,IAAI,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,oBAAoB,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;QAED,gFAAgF;QAChF,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAE9B,2EAA2E;QAC3E,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;YAClC,MAAM,UAAU,GACZ,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ;gBAC9C,CAAC,CAAC,aAAa,MAAM,GAAG;gBACxB,CAAC,CAAC,EAAE,CAAC;YAEb,MAAM,QAAQ,GAAG;gBACb,kBAAkB,EAAE;oBAChB,aAAa,EAAE,cAAc;oBAC7B,iBAAiB,EAAE,0BAA0B,GAAG,UAAU;iBAC7D;aACJ,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;AACL,CAAC"}
+{"version":3,"file":"sessionStart.js","sourceRoot":"","sources":["../../../src/commands/hooks/sessionStart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACH,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;kEAgB+B,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,iBAA0B;IACzD,IAAI,SAAS,GAAG,iBAAiB,IAAI,EAAE,CAAC;IACxC,IAAI,MAA0B,CAAC;IAE/B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACrB,4EAA4E;QAC5E,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACtC,KAAK,IAAI,KAAK,CAAC;QACnB,CAAC;QAED,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC/B,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YACrC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACL,sBAAsB;QAC1B,CAAC;QAED,uEAAuE;QACvE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAC5C,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC;gBACD,MAAM,UAAU,CACZ,OAAO,EACP,6BAA6B,SAAS,KAAK,CAC9C,CAAC;YACN,CAAC;YAAC,MAAM,CAAC;gBACL,oCAAoC;YACxC,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACZ,mFAAmF;QACnF,IAAI,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,oBAAoB,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;QAED,gFAAgF;QAChF,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAE9B,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAE5C,mDAAmD;QACnD,IAAI,CAAC;YACD,MAAM,SAAS,GAAG,wBAAwB,CAAC,oBAAoB,CAAC,CAAC;YACjE,MAAM,SAAS,CAAC,iBAAiB,CAAC;gBAC9B,SAAS;gBACT,YAAY,EAAE,OAAO;aACxB,CAAC,CAAC;YACH,MAAM,SAAS,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACL,6BAA6B;QACjC,CAAC;QAED,2EAA2E;QAC3E,IAAI,OAAO,EAAE,CAAC;YACV,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;YAClC,MAAM,UAAU,GACZ,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ;gBAC9C,CAAC,CAAC,aAAa,MAAM,GAAG;gBACxB,CAAC,CAAC,EAAE,CAAC;YAEb,MAAM,QAAQ,GAAG;gBACb,kBAAkB,EAAE;oBAChB,aAAa,EAAE,cAAc;oBAC7B,iBAAiB,EAAE,0BAA0B,GAAG,UAAU;iBAC7D;aACJ,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;AACL,CAAC"}

package/build/commands/hooks/stopHook.js

@@ -2,53 +2,77 @@ import { getToken } from '../utils/keychain.js';
 import { getFeature, concludeSession } from '../utils/featureApi.js';
 import { getSessionEntry } from '../utils/sessionCache.js';
 import { getEnabledSessionId } from './output.js';
+import { createTelemetryCollector } from '../utils/telemetry.js';
 /**
  * Stop hook handler
  *
- * Only blocks stop for Claude sessions that have registered with a Ranger feature.
- * Attempts to conclude the feature session before allowing stop.
+ * Only blocks stop for Claude sessions that have registered with a Ranger feature review.
+ * Attempts to conclude the feature review session before allowing stop.
  */
-export async function stopHook() {
-    const sessionId = await getEnabledSessionId();
+export async function stopHook(sessionIdOverride) {
+    const sessionId = await getEnabledSessionId(sessionIdOverride);
+    let stopAllowed = true;
     if (!sessionId) {
+        await trackStop(sessionId, false, stopAllowed);
         return;
     }
     try {
-        // Check if this Claude session is registered with a Ranger feature
+        // Check if this Claude session is registered with a Ranger feature review
         const sessionEntry = getSessionEntry(sessionId);
         if (!sessionEntry) {
             // Not a Ranger session - allow stop
+            await trackStop(sessionId, true, stopAllowed);
             return;
         }
         const token = await getToken();
         if (!token) {
             // No token configured - allow stop
+            await trackStop(sessionId, true, stopAllowed);
             return;
         }
         // Get the feature
         const feature = await getFeature(sessionEntry.featureId);
         // If there's no current session, allow stop
         if (!feature.currentSessionId) {
+            await trackStop(sessionId, true, stopAllowed);
             return;
         }
         // Try to conclude the session
         try {
             await concludeSession(feature.id, feature.currentSessionId);
+            await trackStop(sessionId, true, stopAllowed);
             return;
         }
         catch (err) {
             // Failed to conclude - block with error message
+            stopAllowed = false;
             const errorMessage = err instanceof Error ? err.message : String(err);
             const output = {
                 decision: 'block',
-                reason: `Failed to conclude Ranger feature session for "${feature.name}":\n\n${errorMessage}\n\n. This is most likely due to pending checklist items that need to be attempted to be verified. Please resolve the issue or manually conclude with:\n  ranger feature conclude-session`,
+                reason: `Failed to conclude Ranger feature review session for "${feature.name}":\n\n${errorMessage}\n\nThis is most likely due to pending scenarios that need to be verified. Please resolve the issue or resume later with:\n  ranger resume`,
             };
             console.log(JSON.stringify(output));
+            await trackStop(sessionId, true, stopAllowed);
         }
     }
     catch {
         // On any error fetching feature, allow stop (fail open)
+        await trackStop(sessionId, true, stopAllowed);
         return;
     }
 }
+async function trackStop(sessionId, hooksEnabled, stopAllowed) {
+    try {
+        const telemetry = createTelemetryCollector('hook:stop');
+        await telemetry.trackCommandStart({
+            sessionId: sessionId ?? undefined,
+            hooksEnabled,
+            stopAllowed,
+        });
+        await telemetry.trackCommandEnd('success');
+    }
+    catch {
+        // Telemetry must never throw
+    }
+}
 //# sourceMappingURL=stopHook.js.map

package/build/commands/hooks/stopHook.js.map

@@ -1 +1 @@
-{"version":3,"file":"stopHook.js","sourceRoot":"","sources":["../../../src/commands/hooks/stopHook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC1B,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,mEAAmE;QACnE,MAAM,YAAY,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,YAAY,EAAE,CAAC;YAChB,oCAAoC;YACpC,OAAO;QACX,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,mCAAmC;YACnC,OAAO;QACX,CAAC;QAED,kBAAkB;QAClB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAEzD,4CAA4C;QAC5C,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC5B,OAAO;QACX,CAAC;QAED,8BAA8B;QAC9B,IAAI,CAAC;YACD,MAAM,eAAe,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;YAC5D,OAAO;QACX,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,gDAAgD;YAChD,MAAM,YAAY,GACd,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG;gBACX,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,kDAAkD,OAAO,CAAC,IAAI,SAAS,YAAY,2LAA2L;aACzR,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QACxC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,wDAAwD;QACxD,OAAO;IACX,CAAC;AACL,CAAC"}
+{"version":3,"file":"stopHook.js","sourceRoot":"","sources":["../../../src/commands/hooks/stopHook.ts"],"names":[],"mappings":"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"}