@slope-dev/slope 1.5.1

package/dist/cli/guards/compaction.js.map

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

package/dist/cli/guards/explore.d.ts

@@ -0,0 +1,8 @@
+import type { HookInput, GuardResult } from '../../core/index.js';
+/**
+ * Explore guard: fires on Read|Glob|Grep (PreToolUse).
+ * Suggests checking codebase map before deep exploration.
+ * Includes staleness awareness when CODEBASE.md has YAML frontmatter.
+ */
+export declare function exploreGuard(input: HookInput, cwd: string): Promise<GuardResult>;
+//# sourceMappingURL=explore.d.ts.map

package/dist/cli/guards/explore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore.d.ts","sourceRoot":"","sources":["../../../src/cli/guards/explore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKlE;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAyCtF"}

package/dist/cli/guards/explore.js

@@ -0,0 +1,78 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { loadConfig } from '../config.js';
+const DEFAULT_INDEX_PATHS = ['CODEBASE.md', '.slope/index.json', 'docs/architecture.md'];
+/**
+ * Explore guard: fires on Read|Glob|Grep (PreToolUse).
+ * Suggests checking codebase map before deep exploration.
+ * Includes staleness awareness when CODEBASE.md has YAML frontmatter.
+ */
+export async function exploreGuard(input, cwd) {
+    const config = loadConfig();
+    const indexPaths = config.guidance?.indexPaths ?? DEFAULT_INDEX_PATHS;
+    // Find which index files exist
+    const found = [];
+    for (const p of indexPaths) {
+        const full = join(cwd, p);
+        if (existsSync(full)) {
+            found.push(p);
+        }
+    }
+    if (found.length === 0) {
+        return {}; // No index — passthrough
+    }
+    // Check if CODEBASE.md exists and assess staleness
+    const mapPath = join(cwd, 'CODEBASE.md');
+    if (existsSync(mapPath)) {
+        const staleness = checkMapStaleness(mapPath, cwd);
+        if (staleness === 'stale') {
+            return {
+                context: `SLOPE: Codebase map at CODEBASE.md is stale (${getStalenessDetail(mapPath, cwd)}). Run 'slope map' to refresh, or explore if needed.`,
+            };
+        }
+        // Current map — estimate token size
+        const content = readFileSync(mapPath, 'utf8');
+        const approxTokens = Math.round(content.length / 4 / 1000);
+        return {
+            context: `SLOPE: Codebase map at CODEBASE.md (~${approxTokens}k tokens). Read it or use search({ module: 'map' }) before exploring.`,
+        };
+    }
+    // Fallback: other index files found but no CODEBASE.md
+    return {
+        context: `SLOPE: Codebase index available at: ${found.join(', ')} — check before deep exploration.`,
+    };
+}
+function checkMapStaleness(mapPath, cwd) {
+    try {
+        const content = readFileSync(mapPath, 'utf8');
+        const metaMatch = content.match(/^---\n([\s\S]*?)\n---/m);
+        if (!metaMatch)
+            return 'current'; // No metadata — can't check
+        const gitShaMatch = metaMatch[1].match(/git_sha:\s*"?([^"\n]+)"?/);
+        if (!gitShaMatch)
+            return 'current';
+        const distance = parseInt(execSync(`git rev-list --count ${gitShaMatch[1]}..HEAD 2>/dev/null`, { cwd, encoding: 'utf8', timeout: 5000 }).trim() || '0', 10);
+        return distance > 50 ? 'stale' : 'current';
+    }
+    catch {
+        return 'current'; // Can't determine — assume current
+    }
+}
+function getStalenessDetail(mapPath, cwd) {
+    try {
+        const content = readFileSync(mapPath, 'utf8');
+        const metaMatch = content.match(/^---\n([\s\S]*?)\n---/m);
+        if (!metaMatch)
+            return 'unknown';
+        const gitShaMatch = metaMatch[1].match(/git_sha:\s*"?([^"\n]+)"?/);
+        if (!gitShaMatch)
+            return 'unknown';
+        const distance = execSync(`git rev-list --count ${gitShaMatch[1]}..HEAD 2>/dev/null`, { cwd, encoding: 'utf8', timeout: 5000 }).trim();
+        return `${distance} commits behind`;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=explore.js.map

package/dist/cli/guards/explore.js.map

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

package/dist/cli/guards/hazard.d.ts

@@ -0,0 +1,7 @@
+import type { HookInput, GuardResult } from '../../core/index.js';
+/**
+ * Hazard guard: fires on Edit|Write (PreToolUse).
+ * Warns about known issues in the file area being edited.
+ */
+export declare function hazardGuard(input: HookInput, cwd: string): Promise<GuardResult>;
+//# sourceMappingURL=hazard.d.ts.map

package/dist/cli/guards/hazard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hazard.d.ts","sourceRoot":"","sources":["../../../src/cli/guards/hazard.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIlE;;;GAGG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAqCrF"}

package/dist/cli/guards/hazard.js

@@ -0,0 +1,43 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { loadConfig } from '../config.js';
+/**
+ * Hazard guard: fires on Edit|Write (PreToolUse).
+ * Warns about known issues in the file area being edited.
+ */
+export async function hazardGuard(input, cwd) {
+    const filePath = input.tool_input?.file_path;
+    if (!filePath)
+        return {};
+    const config = loadConfig();
+    const recency = config.guidance?.hazardRecency ?? 5;
+    // Determine the area from the file path (use directory)
+    const area = dirname(filePath).replace(cwd + '/', '').replace(cwd, '');
+    if (!area || area === '.')
+        return {};
+    // Load common issues and find matches
+    const warnings = [];
+    try {
+        const issuesPath = join(cwd, config.commonIssuesPath);
+        if (existsSync(issuesPath)) {
+            const issues = JSON.parse(readFileSync(issuesPath, 'utf8'));
+            const areaLower = area.toLowerCase();
+            for (const pattern of issues.recurring_patterns) {
+                // Check if pattern is relevant to this area
+                const text = `${pattern.title} ${pattern.description} ${pattern.prevention}`.toLowerCase();
+                if (text.includes(areaLower) || areaLower.split('/').some(seg => text.includes(seg))) {
+                    const lastSprint = Math.max(...pattern.sprints_hit);
+                    warnings.push(`[${pattern.category}] ${pattern.title} (last: S${lastSprint}) — ${pattern.prevention.slice(0, 100)}`);
+                }
+            }
+        }
+    }
+    catch { /* skip — common issues are optional */ }
+    if (warnings.length === 0)
+        return {};
+    const header = `SLOPE hazard warning for ${area}:`;
+    return {
+        context: [header, ...warnings.map(w => `  ${w}`)].join('\n'),
+    };
+}
+//# sourceMappingURL=hazard.js.map

package/dist/cli/guards/hazard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hazard.js","sourceRoot":"","sources":["../../../src/cli/guards/hazard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAgB,EAAE,GAAW;IAC7D,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,EAAE,SAA+B,CAAC;IACnE,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,aAAa,IAAI,CAAC,CAAC;IAEpD,wDAAwD;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC;IAErC,sCAAsC;IACtC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACtD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAqB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;YAC9E,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAErC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBAChD,4CAA4C;gBAC5C,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,CAAC;gBAC3F,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;oBACrF,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;oBACpD,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,KAAK,YAAY,UAAU,OAAO,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;gBACvH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,uCAAuC,CAAC,CAAC;IAEnD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,MAAM,GAAG,4BAA4B,IAAI,GAAG,CAAC;IACnD,OAAO;QACL,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/cli/guards/next-action.d.ts

@@ -0,0 +1,28 @@
+import type { HookInput, GuardResult } from '../../core/index.js';
+/** Sprint state types for next-action detection */
+type SprintState = {
+    type: 'mid-sprint';
+    sprintNumber: number;
+    claimCount: number;
+    targets: string[];
+} | {
+    type: 'sprint-complete';
+    sprintNumber: number;
+} | {
+    type: 'needs-review';
+    sprintNumber: number;
+} | {
+    type: 'between-sprints';
+    roadmapContext?: string;
+};
+/**
+ * Next-action guard: fires on Stop.
+ * Suggests next actions before session end based on sprint state.
+ */
+export declare function nextActionGuard(input: HookInput, cwd: string): Promise<GuardResult>;
+/** Detect current sprint state via store then filesystem fallback */
+export declare function detectSprintState(cwd: string): Promise<SprintState>;
+/** Build block reason text from sprint state */
+export declare function buildSuggestions(state: SprintState): string;
+export {};
+//# sourceMappingURL=next-action.d.ts.map

package/dist/cli/guards/next-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-action.d.ts","sourceRoot":"","sources":["../../../src/cli/guards/next-action.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAe,MAAM,qBAAqB,CAAC;AAI/E,mDAAmD;AACnD,KAAK,WAAW,GACZ;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GACnF;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAmCzF;AAED,qEAAqE;AACrE,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAiEzE;AAuBD,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAqE3D"}

package/dist/cli/guards/next-action.js

@@ -0,0 +1,196 @@
+import { existsSync, readFileSync, writeFileSync, renameSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadConfig, detectLatestSprint, parseRoadmap, formatStrategicContext } from '../../core/index.js';
+import { resolveStore } from '../store.js';
+/**
+ * Next-action guard: fires on Stop.
+ * Suggests next actions before session end based on sprint state.
+ */
+export async function nextActionGuard(input, cwd) {
+    // Re-prompt prevention: check if we already prompted this session
+    const slopeDir = join(cwd, '.slope');
+    const stateFile = join(slopeDir, '.next-action-prompted');
+    if (input.session_id) {
+        try {
+            if (existsSync(stateFile)) {
+                const raw = JSON.parse(readFileSync(stateFile, 'utf8'));
+                if (raw.session_id === input.session_id) {
+                    return {};
+                }
+            }
+        }
+        catch { /* corrupted state file — proceed */ }
+    }
+    // Detect sprint state
+    const state = await detectSprintState(cwd);
+    // Build suggestion text
+    const suggestion = buildSuggestions(state);
+    // Write state file atomically
+    try {
+        mkdirSync(slopeDir, { recursive: true });
+        const tmpPath = join(slopeDir, '.next-action-prompted.tmp');
+        const json = JSON.stringify({
+            session_id: input.session_id,
+            prompted_at: new Date().toISOString(),
+        });
+        writeFileSync(tmpPath, json);
+        renameSync(tmpPath, stateFile);
+    }
+    catch { /* best-effort — don't fail the guard */ }
+    return { blockReason: suggestion };
+}
+/** Detect current sprint state via store then filesystem fallback */
+export async function detectSprintState(cwd) {
+    // Try store first for active claims
+    let claimsFromStore = null;
+    try {
+        const store = await resolveStore(cwd);
+        try {
+            const claims = await store.getActiveClaims();
+            if (claims.length > 0) {
+                const sprintNumber = Math.max(...claims.map(c => c.sprint_number));
+                return {
+                    type: 'mid-sprint',
+                    sprintNumber,
+                    claimCount: claims.length,
+                    targets: claims.map(c => c.target),
+                };
+            }
+            claimsFromStore = claims;
+        }
+        finally {
+            store.close();
+        }
+    }
+    catch {
+        // Store unavailable — try filesystem fallback
+        try {
+            const claimsPath = join(cwd, '.slope', 'claims.json');
+            if (existsSync(claimsPath)) {
+                const raw = JSON.parse(readFileSync(claimsPath, 'utf8'));
+                if (Array.isArray(raw) && raw.length > 0) {
+                    const sprintNumber = Math.max(...raw.map((c) => c.sprint_number ?? 0));
+                    return {
+                        type: 'mid-sprint',
+                        sprintNumber,
+                        claimCount: raw.length,
+                        targets: raw.map((c) => c.target ?? 'unknown'),
+                    };
+                }
+            }
+        }
+        catch { /* filesystem fallback failed */ }
+    }
+    // Load config and scorecards for remaining checks
+    let config;
+    try {
+        config = loadConfig(cwd);
+    }
+    catch {
+        return { type: 'between-sprints' };
+    }
+    const latestScoredSprint = detectLatestSprint(config, cwd);
+    // If no claims and no scorecards, we're between sprints
+    if (latestScoredSprint === 0 && (claimsFromStore === null || claimsFromStore.length === 0)) {
+        return buildBetweenSprints(config, cwd, 0);
+    }
+    // Check if the latest sprint has a review
+    if (latestScoredSprint > 0) {
+        const retrosDir = join(cwd, config.scorecardDir);
+        const reviewPath = join(retrosDir, `sprint-${latestScoredSprint}-review.md`);
+        if (!existsSync(reviewPath)) {
+            return { type: 'needs-review', sprintNumber: latestScoredSprint };
+        }
+    }
+    // Default: between sprints
+    return buildBetweenSprints(config, cwd, latestScoredSprint);
+}
+/** Build between-sprints state with optional roadmap context */
+function buildBetweenSprints(config, cwd, latestSprint) {
+    let roadmapContext;
+    try {
+        if (config.roadmapPath) {
+            const roadmapFile = join(cwd, config.roadmapPath);
+            if (existsSync(roadmapFile)) {
+                const raw = JSON.parse(readFileSync(roadmapFile, 'utf8'));
+                const { roadmap } = parseRoadmap(raw);
+                if (roadmap) {
+                    const nextSprint = latestSprint + 1;
+                    const ctx = formatStrategicContext(roadmap, nextSprint);
+                    if (ctx)
+                        roadmapContext = ctx;
+                }
+            }
+        }
+    }
+    catch { /* roadmap parsing failed — proceed without context */ }
+    return { type: 'between-sprints', roadmapContext };
+}
+/** Build block reason text from sprint state */
+export function buildSuggestions(state) {
+    const header = 'SLOPE next-action: Before ending this session, present the user with options for what to do next.';
+    switch (state.type) {
+        case 'mid-sprint': {
+            const targetList = state.targets.join(', ');
+            return [
+                header,
+                '',
+                `Current state: Mid-sprint — ${state.claimCount} active claim(s) for sprint ${state.sprintNumber}: ${targetList}`,
+                '',
+                'Suggested options:',
+                '1. Continue with the next ticket',
+                '2. Push and take a break — resume later',
+                '3. End session — nothing more to do right now',
+                '',
+                'Present these using AskUserQuestion. If the user chooses to end the session, stop without further action.',
+            ].join('\n');
+        }
+        case 'sprint-complete':
+            return [
+                header,
+                '',
+                `Current state: Sprint ${state.sprintNumber} is complete but unscored`,
+                '',
+                'Suggested options:',
+                '1. Score the sprint — run post-hole routine',
+                '2. Run `slope validate` on the scorecard',
+                '3. Distill learnings into common issues',
+                '4. End session — nothing more to do right now',
+                '',
+                'Present these using AskUserQuestion. If the user chooses to end the session, stop without further action.',
+            ].join('\n');
+        case 'needs-review': {
+            return [
+                header,
+                '',
+                `Current state: Sprint ${state.sprintNumber} has a scorecard but no review`,
+                '',
+                'Suggested options:',
+                '1. Generate sprint review',
+                '2. Distill learnings and update common issues',
+                '3. Run `slope review` for the full sprint review',
+                '4. End session — nothing more to do right now',
+                '',
+                'Present these using AskUserQuestion. If the user chooses to end the session, stop without further action.',
+            ].join('\n');
+        }
+        case 'between-sprints': {
+            const contextLine = state.roadmapContext
+                ? `\n${state.roadmapContext}\n`
+                : '';
+            return [
+                header,
+                '',
+                `Current state: No active sprint${contextLine}`,
+                'Suggested options:',
+                '1. Check next sprint candidates from the roadmap',
+                '2. Start a new sprint',
+                '3. Run `slope briefing` for a status overview',
+                '4. End session — nothing more to do right now',
+                '',
+                'Present these using AskUserQuestion. If the user chooses to end the session, stop without further action.',
+            ].join('\n');
+        }
+    }
+}
+//# sourceMappingURL=next-action.js.map

package/dist/cli/guards/next-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-action.js","sourceRoot":"","sources":["../../../src/cli/guards/next-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,IAAI,EAAW,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAkB,kBAAkB,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC3H,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAS3C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAgB,EAAE,GAAW;IACjE,kEAAkE;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;IAE1D,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;gBACxD,IAAI,GAAG,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC;oBACxC,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,oCAAoC,CAAC,CAAC;IAClD,CAAC;IAED,sBAAsB;IACtB,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAE3C,wBAAwB;IACxB,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAE3C,8BAA8B;IAC9B,IAAI,CAAC;QACH,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC,CAAC;QACH,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC7B,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC,CAAC,wCAAwC,CAAC,CAAC;IAEpD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AACrC,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,oCAAoC;IACpC,IAAI,eAAe,GAAuD,IAAI,CAAC;IAC/E,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;YAC7C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;gBACnE,OAAO;oBACL,IAAI,EAAE,YAAY;oBAClB,YAAY;oBACZ,UAAU,EAAE,MAAM,CAAC,MAAM;oBACzB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;iBACnC,CAAC;YACJ,CAAC;YACD,eAAe,GAAG,MAAM,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;QAC9C,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;YACtD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;gBACzD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAA6B,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC;oBACnG,OAAO;wBACL,IAAI,EAAE,YAAY;wBAClB,YAAY;wBACZ,UAAU,EAAE,GAAG,CAAC,MAAM;wBACtB,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAsB,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC;qBACpE,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,gCAAgC,CAAC,CAAC;IAC9C,CAAC;IAED,kDAAkD;IAClD,IAAI,MAAmB,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE3D,wDAAwD;IACxD,IAAI,kBAAkB,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,IAAI,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAC3F,OAAO,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,0CAA0C;IAC1C,IAAI,kBAAkB,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,kBAAkB,YAAY,CAAC,CAAC;QAC7E,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAC;QACpE,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,OAAO,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAC;AAC9D,CAAC;AAED,gEAAgE;AAChE,SAAS,mBAAmB,CAAC,MAAmB,EAAE,GAAW,EAAE,YAAoB;IACjF,IAAI,cAAkC,CAAC;IACvC,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;YAClD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC1D,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;gBACtC,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,UAAU,GAAG,YAAY,GAAG,CAAC,CAAC;oBACpC,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;oBACxD,IAAI,GAAG;wBAAE,cAAc,GAAG,GAAG,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,sDAAsD,CAAC,CAAC;IAElE,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC;AACrD,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,gBAAgB,CAAC,KAAkB;IACjD,MAAM,MAAM,GAAG,mGAAmG,CAAC;IAEnH,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO;gBACL,MAAM;gBACN,EAAE;gBACF,+BAA+B,KAAK,CAAC,UAAU,+BAA+B,KAAK,CAAC,YAAY,KAAK,UAAU,EAAE;gBACjH,EAAE;gBACF,oBAAoB;gBACpB,kCAAkC;gBAClC,yCAAyC;gBACzC,+CAA+C;gBAC/C,EAAE;gBACF,2GAA2G;aAC5G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QAED,KAAK,iBAAiB;YACpB,OAAO;gBACL,MAAM;gBACN,EAAE;gBACF,yBAAyB,KAAK,CAAC,YAAY,2BAA2B;gBACtE,EAAE;gBACF,oBAAoB;gBACpB,6CAA6C;gBAC7C,0CAA0C;gBAC1C,yCAAyC;gBACzC,+CAA+C;gBAC/C,EAAE;gBACF,2GAA2G;aAC5G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEf,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,OAAO;gBACL,MAAM;gBACN,EAAE;gBACF,yBAAyB,KAAK,CAAC,YAAY,gCAAgC;gBAC3E,EAAE;gBACF,oBAAoB;gBACpB,2BAA2B;gBAC3B,+CAA+C;gBAC/C,kDAAkD;gBAClD,+CAA+C;gBAC/C,EAAE;gBACF,2GAA2G;aAC5G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QAED,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc;gBACtC,CAAC,CAAC,KAAK,KAAK,CAAC,cAAc,IAAI;gBAC/B,CAAC,CAAC,EAAE,CAAC;YACP,OAAO;gBACL,MAAM;gBACN,EAAE;gBACF,kCAAkC,WAAW,EAAE;gBAC/C,oBAAoB;gBACpB,kDAAkD;gBAClD,uBAAuB;gBACvB,+CAA+C;gBAC/C,+CAA+C;gBAC/C,EAAE;gBACF,2GAA2G;aAC5G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cli/guards/push-nudge.d.ts

@@ -0,0 +1,7 @@
+import type { HookInput, GuardResult } from '../../core/index.js';
+/**
+ * Push nudge guard: fires PostToolUse on Bash.
+ * Nudges to push after git commit commands when unpushed count or time is high.
+ */
+export declare function pushNudgeGuard(input: HookInput, cwd: string): Promise<GuardResult>;
+//# sourceMappingURL=push-nudge.d.ts.map

package/dist/cli/guards/push-nudge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-nudge.d.ts","sourceRoot":"","sources":["../../../src/cli/guards/push-nudge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlE;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAgDxF"}

package/dist/cli/guards/push-nudge.js

@@ -0,0 +1,53 @@
+import { execSync } from 'node:child_process';
+import { loadConfig } from '../config.js';
+/**
+ * Push nudge guard: fires PostToolUse on Bash.
+ * Nudges to push after git commit commands when unpushed count or time is high.
+ */
+export async function pushNudgeGuard(input, cwd) {
+    const command = input.tool_input?.command ?? '';
+    // Only fire after git commit commands
+    if (!command.includes('git commit'))
+        return {};
+    const config = loadConfig();
+    const guidance = config.guidance ?? {};
+    const pushCommitThreshold = guidance.pushCommitThreshold ?? 5;
+    const pushInterval = guidance.pushInterval ?? 30;
+    const nudges = [];
+    // Check if on main/master — always nudge (should push or switch branch)
+    try {
+        const branch = execSync('git rev-parse --abbrev-ref HEAD 2>/dev/null', { cwd, encoding: 'utf8' }).trim();
+        if (branch === 'main' || branch === 'master') {
+            nudges.push(`Committing directly on ${branch} — consider pushing or switching to a feature branch.`);
+        }
+    }
+    catch { /* not a git repo */ }
+    // Check unpushed commit count
+    try {
+        const unpushed = execSync('git log @{u}..HEAD --oneline 2>/dev/null', { cwd, encoding: 'utf8' }).trim();
+        if (unpushed) {
+            const count = unpushed.split('\n').filter(Boolean).length;
+            if (count >= pushCommitThreshold) {
+                nudges.push(`${count} unpushed commits — push to preserve your recovery point.`);
+            }
+        }
+    }
+    catch { /* no upstream */ }
+    // Check time since oldest unpushed commit
+    try {
+        const oldest = execSync('git log @{u}..HEAD --format=%ct --reverse 2>/dev/null', { cwd, encoding: 'utf8' }).trim().split('\n')[0];
+        if (oldest) {
+            const minutesSince = (Date.now() / 1000 - parseInt(oldest, 10)) / 60;
+            if (minutesSince >= pushInterval) {
+                nudges.push(`~${Math.round(minutesSince)} minutes since oldest unpushed commit — push now.`);
+            }
+        }
+    }
+    catch { /* no upstream */ }
+    if (nudges.length === 0)
+        return {};
+    return {
+        context: `SLOPE push discipline:\n${nudges.map(n => `  ${n}`).join('\n')}`,
+    };
+}
+//# sourceMappingURL=push-nudge.js.map

package/dist/cli/guards/push-nudge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-nudge.js","sourceRoot":"","sources":["../../../src/cli/guards/push-nudge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAgB,EAAE,GAAW;IAChE,MAAM,OAAO,GAAI,KAAK,CAAC,UAAU,EAAE,OAAkB,IAAI,EAAE,CAAC;IAE5D,sCAAsC;IACtC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,CAAC;IAE/C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IACvC,MAAM,mBAAmB,GAAG,QAAQ,CAAC,mBAAmB,IAAI,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC;IAEjD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,wEAAwE;IACxE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,6CAA6C,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACzG,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,0BAA0B,MAAM,uDAAuD,CAAC,CAAC;QACvG,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAEhC,8BAA8B;IAC9B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,0CAA0C,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxG,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YAC1D,IAAI,KAAK,IAAI,mBAAmB,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,2DAA2D,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAE7B,0CAA0C;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,uDAAuD,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClI,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;YACrE,IAAI,YAAY,IAAI,YAAY,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,mDAAmD,CAAC,CAAC;YAC/F,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAE7B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,OAAO;QACL,OAAO,EAAE,2BAA2B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KAC3E,CAAC;AACJ,CAAC"}

package/dist/cli/guards/review-tier.d.ts

@@ -0,0 +1,7 @@
+import type { HookInput, GuardResult } from '../../core/index.js';
+/**
+ * Review-tier guard: fires PreToolUse on ExitPlanMode.
+ * Recommends a review tier based on plan scope (context-only, never deny).
+ */
+export declare function reviewTierGuard(input: HookInput, cwd: string): Promise<GuardResult>;
+//# sourceMappingURL=review-tier.d.ts.map

package/dist/cli/guards/review-tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-tier.d.ts","sourceRoot":"","sources":["../../../src/cli/guards/review-tier.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAQlE;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAuDzF"}

package/dist/cli/guards/review-tier.js

@@ -0,0 +1,108 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Review-tier guard: fires PreToolUse on ExitPlanMode.
+ * Recommends a review tier based on plan scope (context-only, never deny).
+ */
+export async function reviewTierGuard(input, cwd) {
+    // Find the plan file
+    const planContent = findPlanContent(input, cwd);
+    if (!planContent)
+        return {};
+    // Analyze the plan
+    const ticketCount = countTickets(planContent);
+    const packageRefs = countPackageRefs(planContent);
+    const hasSchemaOrApi = /\b(schema|migration|api|endpoint)\b/i.test(planContent);
+    const hasInfra = /\b(infrastructure|new package|new service|architect)\b/i.test(planContent);
+    const isResearchOrDocs = /^#+\s*(research|docs|documentation|infra|spike)\b/im.test(planContent)
+        && ticketCount === 0;
+    // Determine recommended tier
+    let tier;
+    let rounds;
+    if (isResearchOrDocs || ticketCount === 0) {
+        tier = 'Skip';
+        rounds = 0;
+    }
+    else if (ticketCount <= 2 && packageRefs <= 1) {
+        tier = 'Light';
+        rounds = 1;
+    }
+    else if (ticketCount >= 5 || hasInfra) {
+        tier = 'Deep';
+        rounds = 3;
+    }
+    else {
+        // 3-4 tickets, or multi-package, or schema/API changes
+        tier = 'Standard';
+        rounds = 2;
+    }
+    // Check if review-state.json already matches
+    const statePath = join(cwd, '.slope', 'review-state.json');
+    if (existsSync(statePath)) {
+        try {
+            const state = JSON.parse(readFileSync(statePath, 'utf8'));
+            if (state.rounds_required >= rounds) {
+                // Already set to at least the recommended level — silent passthrough
+                return {};
+            }
+        }
+        catch { /* malformed — proceed with recommendation */ }
+    }
+    // Build context message
+    const scopeDesc = [
+        `${ticketCount} ticket${ticketCount !== 1 ? 's' : ''}`,
+        packageRefs > 1 ? `${packageRefs} packages` : null,
+        hasSchemaOrApi ? 'schema/API changes' : null,
+        hasInfra ? 'new infrastructure' : null,
+    ].filter(Boolean).join(', ');
+    return {
+        context: `SLOPE review-tier: Plan has ${scopeDesc} — recommend ${tier} review (${rounds} round${rounds !== 1 ? 's' : ''}). Set rounds_required: ${rounds} in .slope/review-state.json`,
+    };
+}
+function findPlanContent(input, cwd) {
+    // Try to find plan file from tool_input (ExitPlanMode context)
+    // Claude Code stores plans in .claude/plans/
+    const plansDir = join(cwd, '.claude', 'plans');
+    if (existsSync(plansDir)) {
+        // Find the most recently modified .md file
+        try {
+            const files = readdirSync(plansDir)
+                .filter(f => f.endsWith('.md'))
+                .map(f => ({
+                name: f,
+                path: join(plansDir, f),
+                mtime: (() => { try {
+                    return statSync(join(plansDir, f)).mtimeMs;
+                }
+                catch {
+                    return 0;
+                } })(),
+            }))
+                .sort((a, b) => b.mtime - a.mtime);
+            if (files.length > 0) {
+                return readFileSync(files[0].path, 'utf8');
+            }
+        }
+        catch { /* no plans dir or can't read */ }
+    }
+    return null;
+}
+function countTickets(content) {
+    // Match ticket patterns: ### S\d+-\d+, ### Ticket, numbered ticket headers
+    const ticketHeaders = content.match(/^###\s+S\d+-\d+/gm) ?? [];
+    if (ticketHeaders.length > 0)
+        return ticketHeaders.length;
+    // Fallback: count ### level headers that look like tickets
+    const h3Headers = content.match(/^###\s+/gm) ?? [];
+    return h3Headers.length;
+}
+function countPackageRefs(content) {
+    // Count distinct packages/ references
+    const refs = new Set();
+    const matches = content.matchAll(/packages\/(\w[\w-]*)/g);
+    for (const m of matches) {
+        refs.add(m[1]);
+    }
+    return refs.size;
+}
+//# sourceMappingURL=review-tier.js.map

package/dist/cli/guards/review-tier.js.map

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

package/dist/cli/guards/scope-drift.d.ts

@@ -0,0 +1,7 @@
+import type { HookInput, GuardResult } from '../../core/index.js';
+/**
+ * Scope drift guard: fires PreToolUse on Edit|Write.
+ * Warns when editing files outside the claimed ticket's scope.
+ */
+export declare function scopeDriftGuard(input: HookInput, cwd: string): Promise<GuardResult>;
+//# sourceMappingURL=scope-drift.d.ts.map

package/dist/cli/guards/scope-drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-drift.d.ts","sourceRoot":"","sources":["../../../src/cli/guards/scope-drift.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIlE;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwCzF"}