@slope-dev/slope 1.5.1

package/dist/cli/commands/plan.d.ts

@@ -0,0 +1,2 @@
+export declare function planCommand(args: string[]): void;
+//# sourceMappingURL=plan.d.ts.map

package/dist/cli/commands/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/plan.ts"],"names":[],"mappings":"AAWA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAuDhD"}

package/dist/cli/commands/plan.js

@@ -0,0 +1,54 @@
+import { recommendClub, computeHandicapCard, computeDispersion, generateTrainingPlan, hazardBriefing, formatAdvisorReport, } from '../../core/index.js';
+import { loadConfig } from '../config.js';
+import { loadScorecards } from '../loader.js';
+export function planCommand(args) {
+    let complexity;
+    const slopeFactors = [];
+    const areas = [];
+    for (const arg of args) {
+        if (arg.startsWith('--complexity=')) {
+            complexity = arg.slice('--complexity='.length);
+        }
+        else if (arg.startsWith('--slope-factors=')) {
+            slopeFactors.push(...arg.slice('--slope-factors='.length).split(',').map(s => s.trim()).filter(Boolean));
+        }
+        else if (arg.startsWith('--areas=')) {
+            areas.push(...arg.slice('--areas='.length).split(',').map(s => s.trim()).filter(Boolean));
+        }
+    }
+    if (!complexity) {
+        console.error('\nUsage: slope plan --complexity=<trivial|small|medium|large> [--slope-factors=a,b] [--areas=x,y]\n');
+        process.exit(1);
+        return;
+    }
+    const validComplexities = ['trivial', 'small', 'medium', 'large'];
+    if (!validComplexities.includes(complexity)) {
+        console.error(`\nInvalid complexity "${complexity}". Must be one of: ${validComplexities.join(', ')}\n`);
+        process.exit(1);
+        return;
+    }
+    const config = loadConfig();
+    const scorecards = loadScorecards(config);
+    // Club recommendation
+    const clubRec = recommendClub({
+        ticketComplexity: complexity,
+        scorecards,
+        slopeFactors,
+    });
+    // Training plan
+    let trainingPlan = [];
+    if (scorecards.length > 0) {
+        const handicap = computeHandicapCard(scorecards);
+        const dispersion = computeDispersion(scorecards);
+        trainingPlan = generateTrainingPlan({ handicap, dispersion, recentScorecards: scorecards });
+    }
+    // Hazard warnings
+    let hazardWarnings = [];
+    if (areas.length > 0 && scorecards.length > 0) {
+        hazardWarnings = hazardBriefing({ areas, scorecards });
+    }
+    const report = formatAdvisorReport({ clubRecommendation: clubRec, trainingPlan, hazardWarnings });
+    console.log('');
+    console.log(report);
+}
+//# sourceMappingURL=plan.js.map

package/dist/cli/commands/plan.js.map

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

package/dist/cli/commands/plugin.d.ts

@@ -0,0 +1,2 @@
+export declare function pluginCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/cli/commands/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/plugin.ts"],"names":[],"mappings":"AAcA,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAcjE"}

package/dist/cli/commands/plugin.js

@@ -0,0 +1,118 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { listMetaphors, GUARD_DEFINITIONS, getAllGuardDefinitions, validatePluginManifest, validateMetaphor, loadPluginMetaphors, loadPluginGuards, } from '../../core/index.js';
+import { loadConfig } from '../config.js';
+export async function pluginCommand(args) {
+    const sub = args[0];
+    switch (sub) {
+        case 'list':
+            listPlugins();
+            break;
+        case 'validate':
+            validatePlugin(args[1]);
+            break;
+        default:
+            printUsage();
+            if (sub)
+                process.exit(1);
+    }
+}
+function listPlugins() {
+    const cwd = process.cwd();
+    const config = loadConfig();
+    // Load custom plugins
+    const metaphorResult = loadPluginMetaphors(cwd, config.plugins);
+    const guardResult = loadPluginGuards(cwd, config.plugins);
+    // Built-in metaphors
+    const builtinMetaphorIds = ['golf', 'tennis', 'baseball', 'gaming', 'dnd', 'matrix'];
+    const builtinGuardNames = GUARD_DEFINITIONS.map(d => d.name);
+    console.log('\nSLOPE Plugins:\n');
+    // Metaphors
+    console.log('  Metaphors:');
+    for (const m of listMetaphors()) {
+        const isCustom = !builtinMetaphorIds.includes(m.id);
+        const tag = isCustom ? ' [custom]' : '';
+        console.log(`    ${m.id.padEnd(16)} ${m.name}${tag}`);
+    }
+    // Guards
+    console.log('\n  Guards:');
+    const allGuards = getAllGuardDefinitions();
+    for (const g of allGuards) {
+        const isCustom = !builtinGuardNames.includes(g.name);
+        const tag = isCustom ? ' [custom]' : '';
+        console.log(`    ${g.name.padEnd(16)} [${g.hookEvent}] ${g.description}${tag}`);
+    }
+    // Errors
+    const allErrors = [...metaphorResult.errors, ...guardResult.errors];
+    if (allErrors.length > 0) {
+        console.log('\n  Errors:');
+        for (const err of allErrors) {
+            console.log(`    ${err.filePath}: ${err.error}`);
+        }
+    }
+    console.log('');
+}
+function validatePlugin(path) {
+    if (!path) {
+        console.error('Error: path is required. Usage: slope plugin validate <path>');
+        process.exit(1);
+    }
+    if (!existsSync(path)) {
+        console.error(`Error: file not found: ${path}`);
+        process.exit(1);
+    }
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        console.error(`Error: invalid JSON in ${path}`);
+        process.exit(1);
+    }
+    const obj = raw;
+    // Check manifest fields
+    const manifest = validatePluginManifest(raw);
+    if (!manifest.valid) {
+        console.log(`\nValidation FAILED for ${path}:\n`);
+        for (const err of manifest.errors) {
+            console.log(`  - ${err}`);
+        }
+        process.exit(1);
+    }
+    // Type-specific validation
+    const errors = [];
+    if (obj.type === 'metaphor') {
+        const metaphorErrors = validateMetaphor(raw);
+        errors.push(...metaphorErrors);
+    }
+    else if (obj.type === 'guard') {
+        if (!obj.hookEvent)
+            errors.push('Missing "hookEvent"');
+        if (!obj.command)
+            errors.push('Missing "command"');
+        if (!obj.level || (obj.level !== 'scoring' && obj.level !== 'full')) {
+            errors.push('Missing or invalid "level" (must be "scoring" or "full")');
+        }
+    }
+    if (errors.length > 0) {
+        console.log(`\nValidation FAILED for ${path}:\n`);
+        for (const err of errors) {
+            console.log(`  - ${err}`);
+        }
+        process.exit(1);
+    }
+    console.log(`\nValid ${obj.type} plugin: ${obj.name ?? obj.id} (${path})\n`);
+}
+function printUsage() {
+    console.log(`
+slope plugin — Manage SLOPE plugins
+
+Usage:
+  slope plugin list               Show all plugins (built-in + custom)
+  slope plugin validate <path>    Validate a plugin file
+
+Plugin directories:
+  .slope/plugins/metaphors/       Custom metaphor definitions (JSON)
+  .slope/plugins/guards/          Custom guard definitions (JSON)
+`);
+}
+//# sourceMappingURL=plugin.js.map

package/dist/cli/commands/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/cli/commands/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,GAEjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAEpB,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,MAAM;YACT,WAAW,EAAE,CAAC;YACd,MAAM;QACR,KAAK,UAAU;YACb,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACxB,MAAM;QACR;YACE,UAAU,EAAE,CAAC;YACb,IAAI,GAAG;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,sBAAsB;IACtB,MAAM,cAAc,GAAG,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAE1D,qBAAqB;IACrB,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrF,MAAM,iBAAiB,GAAa,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEvE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAElC,YAAY;IACZ,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,SAAS;IACT,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3B,MAAM,SAAS,GAAG,sBAAsB,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,SAAS;IACT,MAAM,SAAS,GAAG,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACpE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,cAAc,CAAC,IAAwB;IAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,GAA8B,CAAC;IAE3C,wBAAwB;IACxB,MAAM,QAAQ,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,KAAK,CAAC,CAAC;QAClD,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,2BAA2B;IAC3B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC5B,MAAM,cAAc,GAAG,gBAAgB,CAAC,GAAyB,CAAC,CAAC;QACnE,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;IACjC,CAAC;SAAM,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACvD,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACnD,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC,EAAE,CAAC;YACpE,MAAM,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,KAAK,CAAC,CAAC;QAClD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,IAAI,YAAY,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,KAAK,IAAI,KAAK,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;CAUb,CAAC,CAAC;AACH,CAAC"}

package/dist/cli/commands/release.d.ts

@@ -0,0 +1,2 @@
+export declare function releaseCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=release.d.ts.map

package/dist/cli/commands/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/release.ts"],"names":[],"mappings":"AAwBA,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyClE"}

package/dist/cli/commands/release.js

@@ -0,0 +1,64 @@
+import { loadConfig } from '../config.js';
+import { loadScorecards } from '../loader.js';
+import { resolveStore } from '../store.js';
+function parseArgs(args) {
+    const result = {};
+    for (const arg of args) {
+        const match = arg.match(/^--(\w[\w-]*)=(.+)$/);
+        if (match)
+            result[match[1]] = match[2];
+    }
+    return result;
+}
+function resolveSprintRange(flags, cwd) {
+    const config = loadConfig(cwd);
+    if (flags.sprint)
+        return [parseInt(flags.sprint, 10)];
+    if (config.currentSprint)
+        return [config.currentSprint];
+    const scorecards = loadScorecards(config, cwd);
+    if (scorecards.length === 0)
+        return [1];
+    const maxSprint = Math.max(...scorecards.map(s => s.sprint_number));
+    // Check the current and next sprint (most likely locations)
+    return Array.from({ length: maxSprint + 1 }, (_, i) => i + 1);
+}
+export async function releaseCommand(args) {
+    const flags = parseArgs(args);
+    const cwd = process.cwd();
+    const store = await resolveStore(cwd);
+    // Release by ID
+    if (flags.id) {
+        const released = await store.release(flags.id);
+        if (released) {
+            console.log(`\nClaim ${flags.id} released.\n`);
+        }
+        else {
+            console.error(`\nClaim ${flags.id} not found.\n`);
+            process.exit(1);
+        }
+        return;
+    }
+    // Release by target + player lookup
+    if (flags.target) {
+        const player = flags.player || process.env.USER || 'unknown';
+        const sprints = resolveSprintRange(flags, cwd);
+        for (const sprint of sprints) {
+            const claims = await store.list(sprint);
+            const match = claims.find(c => c.target === flags.target && c.player === player);
+            if (match) {
+                const released = await store.release(match.id);
+                if (released) {
+                    console.log(`\nClaim ${match.id} (${match.target} by ${match.player}, sprint ${match.sprint_number}) released.\n`);
+                    return;
+                }
+            }
+        }
+        console.error(`\nNo claim found for target "${flags.target}" by player "${player}".\n`);
+        process.exit(1);
+        return;
+    }
+    console.error('Error: --id or --target is required');
+    process.exit(1);
+}
+//# sourceMappingURL=release.js.map

package/dist/cli/commands/release.js.map

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

package/dist/cli/commands/report.d.ts

@@ -0,0 +1,2 @@
+export declare function reportCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=report.d.ts.map

package/dist/cli/commands/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/report.ts"],"names":[],"mappings":"AAKA,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDjE"}

package/dist/cli/commands/report.js

@@ -0,0 +1,68 @@
+import { mkdirSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadConfig } from '../config.js';
+import { loadScorecards, buildReportData, generateHtmlReport, getMetaphor } from '../../core/index.js';
+export async function reportCommand(args) {
+    if (args.includes('--help') || args.includes('-h')) {
+        printUsage();
+        return;
+    }
+    const config = loadConfig();
+    const cwd = process.cwd();
+    // Parse flags
+    const htmlFlag = args.includes('--html');
+    const outputArg = args.find(a => a.startsWith('--output='));
+    const metaphorArg = args.find(a => a.startsWith('--metaphor='));
+    if (!htmlFlag) {
+        console.log('Error: --html flag is required. Other formats coming soon.');
+        console.log('Usage: slope report --html [--output=path]');
+        process.exit(1);
+    }
+    // Load scorecards
+    const scorecards = loadScorecards(config, cwd);
+    if (scorecards.length === 0) {
+        console.error('No scorecards found. Nothing to report.');
+        process.exit(1);
+    }
+    // Build report data
+    const data = buildReportData(scorecards);
+    // Resolve metaphor
+    const metaphorId = metaphorArg?.slice('--metaphor='.length) ?? config.metaphor ?? 'golf';
+    let metaphor;
+    try {
+        metaphor = getMetaphor(metaphorId);
+    }
+    catch {
+        console.error(`Unknown metaphor: "${metaphorId}". Using golf.`);
+        metaphor = getMetaphor('golf');
+    }
+    // Generate HTML
+    const html = generateHtmlReport(data, metaphor);
+    // Write output
+    const reportsDir = join(cwd, '.slope', 'reports');
+    if (!existsSync(reportsDir)) {
+        mkdirSync(reportsDir, { recursive: true });
+    }
+    const dateStr = new Date().toISOString().split('T')[0];
+    const outputPath = outputArg?.slice('--output='.length) ?? join(reportsDir, `report-${dateStr}.html`);
+    writeFileSync(outputPath, html, 'utf8');
+    console.log(`\nSLOPE Report generated: ${outputPath}`);
+    console.log(`  ${scorecards.length} scorecards analyzed`);
+    console.log(`  Metaphor: ${metaphorId}`);
+}
+function printUsage() {
+    console.log(`
+slope report — Generate SLOPE performance reports
+
+Usage:
+  slope report --html                  Generate HTML report (default output: .slope/reports/)
+  slope report --html --output=<path>  Generate to specific path
+  slope report --html --metaphor=<id>  Use specific metaphor for labels
+
+Examples:
+  slope report --html
+  slope report --html --output=my-report.html
+  slope report --html --metaphor=gaming
+`);
+}
+//# sourceMappingURL=report.js.map

package/dist/cli/commands/report.js.map

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

package/dist/cli/commands/review-state.d.ts

@@ -0,0 +1,11 @@
+export interface ReviewState {
+    rounds_required: number;
+    rounds_completed: number;
+    plan_file?: string;
+    tier: string;
+    started_at: string;
+}
+export declare function loadReviewState(cwd: string): ReviewState | null;
+export declare function saveReviewState(cwd: string, state: ReviewState): void;
+export declare function reviewStateCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=review-state.d.ts.map

package/dist/cli/commands/review-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-state.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/review-state.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAWD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAQ/D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAIrE;AAuJD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBtE"}

package/dist/cli/commands/review-state.js

@@ -0,0 +1,193 @@
+import { readFileSync, writeFileSync, existsSync, unlinkSync, mkdirSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+const REVIEW_STATE_FILE = '.slope/review-state.json';
+const TIER_ROUNDS = {
+    skip: 0,
+    light: 1,
+    standard: 2,
+    deep: 3,
+};
+export function loadReviewState(cwd) {
+    const statePath = join(cwd, REVIEW_STATE_FILE);
+    if (!existsSync(statePath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(statePath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function saveReviewState(cwd, state) {
+    const dir = join(cwd, '.slope');
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(cwd, REVIEW_STATE_FILE), JSON.stringify(state, null, 2) + '\n');
+}
+function findPlanFile(cwd) {
+    const plansDir = join(cwd, '.claude', 'plans');
+    if (!existsSync(plansDir))
+        return null;
+    try {
+        const files = readdirSync(plansDir)
+            .filter(f => f.endsWith('.md'))
+            .map(f => ({
+            name: f,
+            path: join('.claude', 'plans', f),
+            fullPath: 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 { path: files[0].path, content: readFileSync(files[0].fullPath, 'utf8') };
+        }
+    }
+    catch { /* can't read plans dir */ }
+    return null;
+}
+function countTickets(content) {
+    const ticketHeaders = content.match(/^###\s+S\d+-\d+/gm) ?? [];
+    if (ticketHeaders.length > 0)
+        return ticketHeaders.length;
+    const h3Headers = content.match(/^###\s+/gm) ?? [];
+    return h3Headers.length;
+}
+function countPackageRefs(content) {
+    const refs = new Set();
+    const matches = content.matchAll(/packages\/(\w[\w-]*)/g);
+    for (const m of matches)
+        refs.add(m[1]);
+    return refs.size;
+}
+function detectTier(content) {
+    const ticketCount = countTickets(content);
+    const packageRefs = countPackageRefs(content);
+    const hasInfra = /\b(infrastructure|new package|new service|architect)\b/i.test(content);
+    const isResearchOrDocs = /^#+\s*(research|docs|documentation|infra|spike)\b/im.test(content)
+        && ticketCount === 0;
+    if (isResearchOrDocs || ticketCount === 0)
+        return { tier: 'skip', rounds: 0 };
+    if (ticketCount <= 2 && packageRefs <= 1)
+        return { tier: 'light', rounds: 1 };
+    if (ticketCount >= 5 || hasInfra)
+        return { tier: 'deep', rounds: 3 };
+    return { tier: 'standard', rounds: 2 };
+}
+function tierLabel(tier) {
+    return tier.charAt(0).toUpperCase() + tier.slice(1);
+}
+function startCommand(args, cwd) {
+    const roundsArg = args.find(a => a.startsWith('--rounds='));
+    const tierArg = args.find(a => a.startsWith('--tier='));
+    let rounds;
+    let tier;
+    let planFile;
+    if (roundsArg) {
+        rounds = parseInt(roundsArg.slice('--rounds='.length), 10);
+        if (isNaN(rounds) || rounds < 0) {
+            console.error('Error: --rounds must be a non-negative integer.');
+            process.exit(1);
+        }
+        // Reverse-map rounds to tier name
+        const entry = Object.entries(TIER_ROUNDS).find(([, r]) => r === rounds);
+        tier = entry ? entry[0] : 'custom';
+    }
+    else if (tierArg) {
+        tier = tierArg.slice('--tier='.length).toLowerCase();
+        if (!(tier in TIER_ROUNDS)) {
+            console.error(`Error: Unknown tier "${tier}". Use skip, light, standard, or deep.`);
+            process.exit(1);
+        }
+        rounds = TIER_ROUNDS[tier];
+    }
+    else {
+        // Auto-detect from plan file
+        const plan = findPlanFile(cwd);
+        if (plan) {
+            const detected = detectTier(plan.content);
+            tier = detected.tier;
+            rounds = detected.rounds;
+            planFile = plan.path;
+        }
+        else {
+            console.error('Error: No plan file found in .claude/plans/. Use --rounds=N or --tier=<tier>.');
+            process.exit(1);
+        }
+    }
+    // Find plan file if not already set
+    if (!planFile) {
+        const plan = findPlanFile(cwd);
+        if (plan)
+            planFile = plan.path;
+    }
+    const state = {
+        rounds_required: rounds,
+        rounds_completed: 0,
+        plan_file: planFile,
+        tier,
+        started_at: new Date().toISOString(),
+    };
+    saveReviewState(cwd, state);
+    console.log(`Review started: ${tierLabel(tier)} (${rounds} round${rounds !== 1 ? 's' : ''}). Run 'slope review round' after each review round.`);
+}
+function roundCommand(cwd) {
+    const state = loadReviewState(cwd);
+    if (!state) {
+        console.error("No active review. Run 'slope review start' to begin.");
+        process.exit(1);
+    }
+    state.rounds_completed += 1;
+    saveReviewState(cwd, state);
+    if (state.rounds_completed >= state.rounds_required) {
+        console.log(`Round ${state.rounds_completed}/${state.rounds_required} complete. Review done — ExitPlanMode is unblocked.`);
+    }
+    else {
+        const remaining = state.rounds_required - state.rounds_completed;
+        console.log(`Round ${state.rounds_completed}/${state.rounds_required} complete. ${remaining} round${remaining !== 1 ? 's' : ''} remaining.`);
+    }
+}
+function statusCommand(cwd) {
+    const state = loadReviewState(cwd);
+    if (!state) {
+        console.log("No active review. Run 'slope review start' to begin.");
+        return;
+    }
+    const done = state.rounds_completed >= state.rounds_required;
+    console.log(`Review: ${tierLabel(state.tier)} (${state.rounds_completed}/${state.rounds_required} rounds${done ? ' — complete' : ''})`);
+    if (state.plan_file)
+        console.log(`Plan: ${state.plan_file}`);
+    console.log(`Started: ${state.started_at}`);
+}
+function resetCommand(cwd) {
+    const statePath = join(cwd, REVIEW_STATE_FILE);
+    if (existsSync(statePath)) {
+        unlinkSync(statePath);
+    }
+    console.log('Review state cleared.');
+}
+export async function reviewStateCommand(args) {
+    const cwd = process.cwd();
+    const sub = args[0];
+    switch (sub) {
+        case 'start':
+            startCommand(args.slice(1), cwd);
+            break;
+        case 'round':
+            roundCommand(cwd);
+            break;
+        case 'status':
+            statusCommand(cwd);
+            break;
+        case 'reset':
+            resetCommand(cwd);
+            break;
+        default:
+            console.error(`Unknown review subcommand: ${sub}. Use start, round, status, or reset.`);
+            process.exit(1);
+    }
+}
+//# sourceMappingURL=review-state.js.map

package/dist/cli/commands/review-state.js.map

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

package/dist/cli/commands/review.d.ts

@@ -0,0 +1,2 @@
+export declare function reviewCommand(path?: string, mode?: string, metaphorFlag?: string): void;
+//# sourceMappingURL=review.d.ts.map

package/dist/cli/commands/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/review.ts"],"names":[],"mappings":"AAOA,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAiDvF"}

package/dist/cli/commands/review.js

@@ -0,0 +1,53 @@
+import { readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { formatSprintReview } from '../../core/index.js';
+import { loadConfig } from '../config.js';
+import { resolveMetaphor } from '../metaphor.js';
+export function reviewCommand(path, mode, metaphorFlag) {
+    const config = loadConfig();
+    const cwd = process.cwd();
+    const metaphor = resolveMetaphor(metaphorFlag ? [`--metaphor=${metaphorFlag}`] : [], config.metaphor);
+    if (!path) {
+        // Default to latest scorecard
+        const dir = join(cwd, config.scorecardDir);
+        const patternParts = config.scorecardPattern.split('*');
+        const prefix = patternParts[0] ?? '';
+        const suffix = patternParts[1] ?? '';
+        const regex = new RegExp(`^${prefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}(\\d+)${suffix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}$`);
+        try {
+            const files = readdirSync(dir)
+                .filter((f) => {
+                const m = f.match(regex);
+                return m && parseInt(m[1], 10) >= config.minSprint;
+            })
+                .sort((a, b) => {
+                const na = parseInt(a.match(regex)?.[1] ?? '0', 10);
+                const nb = parseInt(b.match(regex)?.[1] ?? '0', 10);
+                return na - nb;
+            });
+            if (files.length === 0) {
+                console.log('\nNo scorecards found.\n');
+                process.exit(1);
+            }
+            path = join(dir, files[files.length - 1]);
+        }
+        catch {
+            console.log('\nScorecard directory not found.\n');
+            process.exit(1);
+        }
+    }
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        console.error(`\nFailed to parse ${path}\n`);
+        process.exit(1);
+    }
+    const card = { ...raw, sprint_number: raw.sprint_number ?? raw.sprint };
+    const reviewMode = mode === 'plain' ? 'plain' : 'technical';
+    const review = formatSprintReview(card, undefined, undefined, reviewMode, metaphor);
+    console.log('');
+    console.log(review);
+}
+//# sourceMappingURL=review.js.map