@slope-dev/slope 1.13.1 → 1.15.0

package/README.md

@@ -2,218 +2,162 @@
 
 **Sprint Lifecycle & Operational Performance Engine**
 
-A framework for measuring and improving sprint execution quality. Replace subjective retrospectives with objective, quantifiable metrics. Works with Claude Code, Cursor, and OpenCode.
+Replace subjective retrospectives with quantified sprint metrics. Track every ticket's approach, outcome, and hazards — then use rolling analytics to spot patterns and improve over time.
+
+## Why SLOPE?
+
+- **Quantified retros** — structured scorecards with objective scoring instead of "how did it feel?"
+- **Pattern detection** — rolling handicap windows reveal if you consistently over-engineer, under-scope, or pick the wrong approach
+- **AI agent guidance** — 16 guard hooks give real-time hints to Claude Code, Cursor, Windsurf, Cline, and OpenCode
+- **Pluggable metaphors** — golf, tennis, baseball, gaming, D&D, matrix, or agile terminology — same math, your vocabulary
+- **Zero infrastructure** — SQLite store, CLI-driven, lives in your repo
 
 ## Quick Start
 
 ```bash
-# Install globally (makes `slope` available everywhere)
+# Install
 npm install -g @slope-dev/slope
 
-# Or install locally in your project and use npx
-npm install @slope-dev/slope
-npx slope init
-
-# Initialize in your project (auto-detects your AI tool)
+# Initialize (auto-detects your AI coding tool)
 slope init
 
-# Or specify your platform
-slope init --claude-code
-slope init --cursor
-slope init --opencode
-
 # View your handicap card
 slope card
-
-# Get a pre-sprint briefing
-slope briefing
-
-# Generate an HTML performance report
-slope report --html
 ```
 
-> **Note:** If installed locally (without `-g`), prefix commands with `npx` — e.g., `npx slope card`.
+> Installed locally? Use `npx slope` instead.
 
-## What is SLOPE?
+## Core Concepts
 
-SLOPE maps sprint execution to a scoring metaphor. Every sprint has a **par** (expected ticket count), every ticket is a **shot** with an approach complexity and outcome. Over time, your **handicap** reveals patterns: Do you over-engineer? Under-scope? Pick the wrong approach?
+Every sprint has a **par** (expected baseline from ticket count: 1–2 → par 3, 3–4 → par 4, 5+ → par 5). Each ticket is a **shot** with an approach complexity (**club**: driver → putter) and an outcome (**result**: in_the_hole → missed). Over time, your **handicap card** shows rolling averages, miss patterns, and trend direction.
 
-SLOPE provides:
-- **Scorecards** — structured sprint retros with quantified outcomes
-- **Handicap tracking** — rolling performance windows (last 5, 10, all-time)
-- **Dispersion analysis** — miss pattern detection and systemic issue identification
-- **Training recommendations** — data-driven improvement suggestions
-- **Agent guidance hooks** — real-time hints for AI coding agents
-- **HTML reports** — self-contained visual performance dashboards
-- **Multi-platform support** — Claude Code, Cursor, OpenCode
+| Concept | What it measures |
+|---------|-----------------|
+| Par     | Expected sprint baseline (from ticket count) |
+| Slope   | Difficulty modifier (cross-package, migrations, etc.) |
+| Club    | Approach complexity (driver = risky, putter = trivial) |
+| Result  | Outcome (in_the_hole = perfect, missed_long = over-engineered) |
+| Hazard  | Gotchas encountered (bunker, water, rough, trees) |
+| Handicap| Rolling performance trend across sprints |
 
-## Metaphors
-
-SLOPE ships with 6 built-in metaphors. The scoring math is identical — only the terminology changes.
-
-| Metaphor | Sprint | Ticket | Perfect | Par | Miss |
-|----------|--------|--------|---------|-----|------|
-| **Golf** (default) | Sprint | Shot | Hole-in-One | Par | Missed Long/Short/Left/Right |
-| **Tennis** | Set | Point | Ace | Deuce | Wide/Net/Long/Out |
-| **Baseball** | Inning | At-Bat | Home Run | Single | Foul/Strike/Pop/Ground |
-| **Gaming** | Level | Quest | S-Rank | B-Rank | Over-leveled/Under-leveled/Wrong Path/Side-tracked |
-| **D&D** | Quest | Encounter | Natural 20 | DC Met | Fumble/Misfire/Detour/Distraction |
-| **Matrix** | Simulation | Anomaly | The One | Stable | Overclocked/Underclocked/Drift/Noise |
+## Features
 
-Configure in `.slope/config.json`:
+### Scoring & Analysis
+- **Scorecards** — structured JSON retros with shot-by-shot tracking
+- **Handicap card** — rolling windows (last 5, 10, all-time) with trend arrows
+- **Dispersion analysis** — miss pattern heatmaps and area performance
+- **HTML reports** — self-contained visual dashboards with charts
+- **Auto-card** — generate draft scorecards from git commits + CI signals
+
+### Planning & Workflow
+- **Briefings** — pre-sprint hazard index, nutrition alerts, filtered gotchas
+- **Sessions & claims** — track who's working on what, detect conflicts
+- **Roadmap tools** — validate dependencies, find critical path, parallel opportunities
+- **Club advisor** — complexity recommendations based on historical performance
+
+### AI Agent Guidance
+- **16 guard hooks** — real-time hints injected into agent context
+- **MCP server** — search API functions and execute SLOPE commands from your agent
+- **5 platform adapters** — Claude Code, Cursor, Windsurf, Cline, OpenCode
+- **Codebase map** — auto-generated index for agent navigation
+
+### Team & Multi-Developer
+- **Team handicap** — aggregate performance across team members
+- **Leaderboard** — multi-developer performance ranking
+- **Standups** — structured standup reports with handoff tracking
+- **Escalation** — severity-based alerts for blocked work
+
+## Platform Compatibility
+
+| Platform    | Rules | Hooks | MCP | Session Tracking |
+|-------------|-------|-------|-----|------------------|
+| Claude Code | .claude/rules/ | .claude/hooks/ | .mcp.json | Auto (hooks) |
+| Cursor      | .cursor/rules/ | .cursor/hooks/ | .cursor/mcp.json | Auto (hooks) |
+| Windsurf    | .windsurf/rules/ | .windsurf/hooks/ | .windsurf/mcp.json | Auto (hooks) |
+| Cline       | .clinerules/ | .clinerules/hooks/ | Manual setup | Auto (hooks) |
+| OpenCode    | AGENTS.md | Plugin | opencode.json | Auto (plugin) |
 
-```json
-{ "metaphor": "gaming" }
+```bash
+slope init --claude-code   # or --cursor, --windsurf, --cline, --opencode, --all
 ```
 
-Or per-command: `slope review --metaphor=tennis`
+## CLI Quick Reference
 
-## Package
+### Setup & Config
 
-Published as a single package: [`@slope-dev/slope`](https://www.npmjs.com/package/@slope-dev/slope)
-
-Includes the core scoring engine, SQLite store, CLI (30 commands), and MCP server.
-
-## CLI Commands
+| Command | Description |
+|---------|-------------|
+| `slope init` | Initialize SLOPE (auto-detects platform) |
+| `slope init --interactive --smart` | Guided setup with repo analysis |
+| `slope hook add --level=full` | Install all guidance hooks |
+| `slope map` | Generate/update codebase map |
 
-### Scoring & Analysis
+### Scoring
 
 | Command | Description |
 |---------|-------------|
-| `slope card` | Display handicap card with rolling windows |
+| `slope card` | Display handicap card |
 | `slope validate [path]` | Validate scorecard(s) |
-| `slope review [path] [--plain] [--metaphor=id]` | Format sprint review as markdown |
-| `slope review recommend` | Recommend review types for current sprint |
-| `slope review findings add\|list\|clear` | Track implementation review findings |
-| `slope review amend [--sprint=N]` | Apply review findings as hazards and recalculate score |
-| `slope report --html [--output=path] [--metaphor=id]` | Generate HTML performance report |
-| `slope tournament --id=<id> --sprints=N..M` | Build tournament review from sprint range |
-| `slope auto-card --sprint=N [--ci=path]` | Generate scorecard from git + CI signals |
+| `slope review [path]` | Generate sprint review markdown |
+| `slope report --html` | Generate HTML performance report |
+| `slope auto-card --sprint=N` | Generate scorecard from git + CI |
+| `slope dashboard` | Live local performance dashboard |
 
-### Planning & Guidance
+### Planning
 
 | Command | Description |
 |---------|-------------|
-| `slope briefing [--sprint=N] [--categories=...] [--keywords=...]` | Pre-sprint briefing |
+| `slope briefing` | Pre-sprint briefing with hazards and gotchas |
 | `slope plan --complexity=<level>` | Club recommendation + training plan |
-| `slope classify --scope=... --modified=... --tests=pass` | Classify a shot from execution trace |
 | `slope next` | Show next sprint number |
-| `slope roadmap validate\|review\|status\|show` | Strategic planning tools |
-
-### Sessions & Claims
-
-| Command | Description |
-|---------|-------------|
-| `slope session start\|end\|heartbeat\|list` | Manage live sessions |
-| `slope claim --target=<t> [--scope=area] [--force]` | Claim a ticket or area |
-| `slope release --id=<id>` | Release a claim |
-| `slope status [--sprint=N]` | Show sprint course status + conflicts |
+| `slope roadmap validate` | Validate roadmap dependencies |
 
-### Agent Hooks
+### Sessions
 
 | Command | Description |
 |---------|-------------|
-| `slope hook add\|remove\|list\|show` | Manage lifecycle hooks |
-| `slope hook add --level=full` | Install all guidance hooks |
-| `slope guard list\|enable\|disable` | Manage guard activation |
-| `slope guard <name>` | Run a guard handler (stdin/stdout) |
+| `slope session start\|end\|list` | Manage live sessions |
+| `slope claim --target=<t>` | Claim a ticket or area |
+| `slope release --target=<t>` | Release a claim |
+| `slope status` | Sprint status + conflicts |
 
-### Setup
+### Maintenance
 
 | Command | Description |
 |---------|-------------|
-| `slope init` | Create `.slope/` directory with config |
-| `slope init --claude-code` | Install Claude Code rules, hooks, MCP config |
-| `slope init --cursor` | Install Cursor rules + MCP config |
-| `slope init --opencode` | Install OpenCode AGENTS.md + plugin |
-| `slope init --all` | Install for all detected platforms |
-| `slope extract --file=<path>` | Extract events into SLOPE store |
-| `slope distill [--auto]` | Promote event patterns to common issues |
-
-## Platform Setup
-
-### Claude Code
+| `slope extract --file=<path>` | Extract events into store |
+| `slope distill` | Promote patterns to common issues |
+| `slope store health\|backup\|restore` | Store diagnostics and management |
+| `slope flows init\|list\|check` | Manage user flow definitions |
 
-```bash
-slope init --claude-code
-```
+## Metaphors
 
-Installs:
-- `.claude/rules/` — Sprint checklist, commit discipline, review loop
-- `.claude/hooks/` — Guard dispatcher for real-time guidance
-- `.mcp.json` — SLOPE MCP server config
-- `CLAUDE.md` — Project context
+7 built-in metaphors — same scoring math, different vocabulary:
 
-### Cursor
+| Metaphor | Sprint | Ticket | Perfect | On Target |
+|----------|--------|--------|---------|-----------|
+| **Golf** (default) | Sprint | Shot | Hole-in-One | Par |
+| **Tennis** | Set | Point | Ace | Deuce |
+| **Baseball** | Inning | At-Bat | Home Run | Single |
+| **Gaming** | Level | Quest | S-Rank | B-Rank |
+| **D&D** | Quest | Encounter | Natural 20 | DC Met |
+| **Matrix** | Simulation | Anomaly | The One | Stable |
+| **Agile** | Sprint | Story | Shipped | Accepted |
 
 ```bash
-slope init --cursor
+slope init --metaphor=gaming          # Set during init
+slope card --metaphor=tennis          # Override per-command
 ```
 
-Installs:
-- `.cursor/rules/` — SLOPE methodology rules
-- `.cursor/mcp.json` — MCP server config
+## Documentation
 
-### OpenCode
-
-```bash
-slope init --opencode
-```
-
-Installs:
-- `AGENTS.md` — SLOPE methodology (OpenCode reads this format)
-- `.opencode/plugins/slope-plugin.ts` — Event capture plugin
-
-## Agent Guidance Hooks
-
-SLOPE can guide AI agents in real-time via hook integration. 15 guards provide contextual hints:
-
-| Guard | Trigger | What it does |
-|-------|---------|-------------|
-| `explore` | Before search/read | Suggests checking codebase index first |
-| `hazard` | Before file edit | Warns about known issues in the area |
-| `commit-nudge` | After file edit | Nudges commit/push after prolonged editing |
-| `scope-drift` | Before file edit | Warns when editing outside claimed scope |
-| `compaction` | Before context compact | Saves checkpoint to store |
-| `stop-check` | Before session end | Blocks if uncommitted/unpushed work exists |
-| `next-action` | Before session end | Suggests next actions based on sprint state |
-| `subagent-gate` | Before task spawn | Enforces model and turn limits on subagents |
-| `push-nudge` | After tool use | Nudges push after prolonged period without pushing |
-| `workflow-gate` | Before tool use | Enforces sprint workflow compliance |
-| `review-tier` | Before tool use | Suggests review tier based on sprint complexity |
-| `version-check` | Before tool use | Warns when SLOPE version is outdated |
-| `stale-flows` | Before file edit | Warns when editing files in stale flow definitions |
-| `pr-review` | After tool use | Suggests PR review actions |
-| `transcript` | After tool use | Captures session transcript data |
-
-Install all guards:
-
-```bash
-slope hook add --level=full
-```
-
-Guards are non-blocking hints (except `stop-check`) — they inject context, never deny actions.
-
-## Configuration
-
-After `slope init`, configure `.slope/config.json`:
-
-```json
-{
-  "scorecardDir": "docs/retros",
-  "scorecardPattern": "sprint-*.json",
-  "minSprint": 1,
-  "metaphor": "golf",
-  "commonIssuesPath": ".slope/common-issues.json",
-  "sessionsPath": ".slope/sessions.json",
-  "roadmapPath": "docs/backlog/roadmap.json",
-  "guidance": {
-    "disabled": [],
-    "commitInterval": 15,
-    "pushInterval": 30
-  }
-}
-```
+- **[Getting Started](docs/getting-started.md)** — installation, setup, core concepts, platform guides
+- **[Tutorial: First Sprint](docs/tutorial-first-sprint.md)** — end-to-end walkthrough with example scorecard
+- **[Framework Reference](docs/framework.md)** — full scoring system specification
+- **[Dashboard Guide](docs/guides/dashboard.md)** — live performance dashboard
+- **[Multi-Developer Guide](docs/guides/multi-developer.md)** — team handicap and leaderboard
+- **[Cline Setup](docs/guides/cline-setup.md)** — Cline-specific configuration
+- **[Scorecard Template](docs/scorecard-template.md)** — field-by-field reference
 
 ## Core API
 
@@ -224,38 +168,23 @@ import {
   computeHandicapCard,
   computeDispersion,
   formatSprintReview,
-  recommendClub,
-  classifyShot,
-  generateTrainingPlan,
   buildReportData,
   generateHtmlReport,
-  getMetaphor,
   loadScorecards,
-  recommendReviews,
-  findingToHazard,
-  amendScorecardWithFindings,
+  getMetaphor,
 } from '@slope-dev/slope';
-
-// Build a scorecard
-const card = buildScorecard({
-  sprint_number: 1,
-  theme: 'My First Sprint',
-  par: 3,
-  slope: 0,
-  date: '2026-02-22',
-  shots: [
-    { ticket_key: 'S1-1', title: 'Setup', club: 'short_iron', result: 'green', hazards: [] },
-    { ticket_key: 'S1-2', title: 'Feature', club: 'short_iron', result: 'in_the_hole', hazards: [] },
-    { ticket_key: 'S1-3', title: 'Tests', club: 'wedge', result: 'green', hazards: [] },
-  ],
-});
-
-// Generate HTML report with gaming metaphor
-const data = buildReportData([card]);
-const gaming = getMetaphor('gaming');
-const html = generateHtmlReport(data, gaming);
 ```
 
+Published as [`@slope-dev/slope`](https://www.npmjs.com/package/@slope-dev/slope) — includes the scoring engine, SQLite store, CLI (30 commands), and MCP server.
+
+## Contributing
+
+1. Fork and clone
+2. `pnpm install && pnpm build`
+3. `pnpm test` — runs all tests
+4. `pnpm typecheck` — type checking
+5. Create a feature branch, make changes, submit a PR
+
 ## License
 
 MIT

package/dist/adapters.d.ts

@@ -1,12 +1,15 @@
 import './core/adapters/claude-code.js';
 import './core/adapters/cursor.js';
 import './core/adapters/windsurf.js';
+import './core/adapters/cline.js';
 import './core/adapters/generic.js';
 export { registerAdapter, getAdapter, listAdapters, detectAdapter, clearAdapters, resolveToolMatcher, ADAPTER_PRIORITY, TOOL_CATEGORIES, CLAUDE_CODE_TOOLS } from './core/harness.js';
 export type { HarnessAdapter, HarnessId, ToolCategory, ToolNameMap } from './core/harness.js';
 export { ClaudeCodeAdapter, claudeCodeAdapter } from './core/adapters/claude-code.js';
 export { CursorAdapter, cursorAdapter } from './core/adapters/cursor.js';
 export { WindsurfAdapter, windsurfAdapter } from './core/adapters/windsurf.js';
+export { ClineAdapter, clineAdapter } from './core/adapters/cline.js';
 export { GenericAdapter, genericAdapter } from './core/adapters/generic.js';
+export type { ClineHookOutput } from './core/adapters/cline.js';
 export type { GuardManifestEntry } from './core/adapters/generic.js';
 //# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAIA,OAAO,gCAAgC,CAAC;AACxC,OAAO,2BAA2B,CAAC;AACnC,OAAO,6BAA6B,CAAC;AACrC,OAAO,4BAA4B,CAAC;AAGpC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtL,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG9F,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5E,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAIA,OAAO,gCAAgC,CAAC;AACxC,OAAO,2BAA2B,CAAC;AACnC,OAAO,6BAA6B,CAAC;AACrC,OAAO,0BAA0B,CAAC;AAClC,OAAO,4BAA4B,CAAC;AAGpC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtL,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG9F,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5E,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/adapters.js

@@ -4,6 +4,7 @@
 import './core/adapters/claude-code.js';
 import './core/adapters/cursor.js';
 import './core/adapters/windsurf.js';
+import './core/adapters/cline.js';
 import './core/adapters/generic.js';
 // Framework functions
 export { registerAdapter, getAdapter, listAdapters, detectAdapter, clearAdapters, resolveToolMatcher, ADAPTER_PRIORITY, TOOL_CATEGORIES, CLAUDE_CODE_TOOLS } from './core/harness.js';
@@ -11,5 +12,6 @@ export { registerAdapter, getAdapter, listAdapters, detectAdapter, clearAdapters
 export { ClaudeCodeAdapter, claudeCodeAdapter } from './core/adapters/claude-code.js';
 export { CursorAdapter, cursorAdapter } from './core/adapters/cursor.js';
 export { WindsurfAdapter, windsurfAdapter } from './core/adapters/windsurf.js';
+export { ClineAdapter, clineAdapter } from './core/adapters/cline.js';
 export { GenericAdapter, genericAdapter } from './core/adapters/generic.js';
 //# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,+FAA+F;AAE/F,0DAA0D;AAC1D,OAAO,gCAAgC,CAAC;AACxC,OAAO,2BAA2B,CAAC;AACnC,OAAO,6BAA6B,CAAC;AACrC,OAAO,4BAA4B,CAAC;AAEpC,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAKtL,+BAA+B;AAC/B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,+FAA+F;AAE/F,0DAA0D;AAC1D,OAAO,gCAAgC,CAAC;AACxC,OAAO,2BAA2B,CAAC;AACnC,OAAO,6BAA6B,CAAC;AACrC,OAAO,0BAA0B,CAAC;AAClC,OAAO,4BAA4B,CAAC;AAEpC,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAKtL,+BAA+B;AAC/B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC"}

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

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

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

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

package/dist/cli/commands/context.js

@@ -0,0 +1,190 @@
+// slope context — Semantic context search for agents
+// Usage: slope context "query" | --ticket=KEY | --file=PATH
+import { readFileSync, existsSync } from 'node:fs';
+import { loadConfig } from '../../core/config.js';
+import { embed } from '../../core/embedding-client.js';
+import { hasEmbeddingSupport } from '../../core/embedding-store.js';
+import { deduplicateByFile, formatContextForAgent } from '../../core/context.js';
+import { SqliteSlopeStore } from '../../store/index.js';
+function parseArgs(args) {
+    let query = null;
+    let ticket = null;
+    let file = null;
+    let top = 5;
+    let format = 'snippets';
+    let minScore = 0.0;
+    for (const arg of args) {
+        if (arg.startsWith('--ticket=')) {
+            ticket = arg.slice('--ticket='.length);
+        }
+        else if (arg.startsWith('--file=')) {
+            file = arg.slice('--file='.length);
+        }
+        else if (arg.startsWith('--top=')) {
+            top = parseInt(arg.slice('--top='.length), 10) || 5;
+        }
+        else if (arg.startsWith('--min-score=')) {
+            minScore = parseFloat(arg.slice('--min-score='.length)) || 0;
+        }
+        else if (arg.startsWith('--format=')) {
+            const f = arg.slice('--format='.length);
+            if (f === 'paths' || f === 'snippets' || f === 'full') {
+                format = f;
+            }
+        }
+        else if (!arg.startsWith('-')) {
+            query = arg;
+        }
+    }
+    return { query, ticket, file, top, format, minScore };
+}
+function resolveTicketQuery(ticketKey, cwd, config) {
+    // Try roadmap first
+    const roadmapPath = `${cwd}/${config.roadmapPath ?? 'docs/backlog/roadmap.json'}`;
+    if (existsSync(roadmapPath)) {
+        try {
+            const roadmap = JSON.parse(readFileSync(roadmapPath, 'utf8'));
+            for (const sprint of roadmap.sprints ?? []) {
+                for (const ticket of sprint.tickets ?? []) {
+                    if (ticket.key === ticketKey || ticket.id === ticketKey) {
+                        const parts = [ticket.title ?? '', ticket.description ?? ''];
+                        if (ticket.modules)
+                            parts.push(ticket.modules.join(' '));
+                        return parts.filter(Boolean).join(' ');
+                    }
+                }
+            }
+        }
+        catch {
+            // Fall through
+        }
+    }
+    // Try slope-loop backlog
+    const backlogPath = `${cwd}/slope-loop/backlog.json`;
+    if (existsSync(backlogPath)) {
+        try {
+            const backlog = JSON.parse(readFileSync(backlogPath, 'utf8'));
+            for (const sprint of backlog.sprints ?? []) {
+                for (const ticket of sprint.tickets ?? []) {
+                    if (ticket.key === ticketKey || ticket.id === ticketKey) {
+                        const parts = [ticket.title ?? '', ticket.description ?? ''];
+                        if (ticket.modules)
+                            parts.push(ticket.modules.join(' '));
+                        return parts.filter(Boolean).join(' ');
+                    }
+                }
+            }
+        }
+        catch {
+            // Fall through
+        }
+    }
+    // Fall back to ticket key as query
+    return ticketKey;
+}
+function resolveFileQuery(filePath, cwd) {
+    const fullPath = `${cwd}/${filePath}`;
+    if (existsSync(fullPath)) {
+        try {
+            const content = readFileSync(fullPath, 'utf8');
+            // Use first 500 chars as query
+            return content.slice(0, 500);
+        }
+        catch {
+            return filePath;
+        }
+    }
+    return filePath;
+}
+export async function contextCommand(args) {
+    const cwd = process.cwd();
+    const config = loadConfig(cwd);
+    if (args.includes('--help') || args.includes('-h')) {
+        printUsage();
+        return;
+    }
+    const flags = parseArgs(args);
+    // Determine query text
+    let queryText;
+    if (flags.ticket) {
+        queryText = resolveTicketQuery(flags.ticket, cwd, config);
+    }
+    else if (flags.file) {
+        queryText = resolveFileQuery(flags.file, cwd);
+    }
+    else if (flags.query) {
+        queryText = flags.query;
+    }
+    else {
+        console.error('Error: Provide a search query, --ticket=KEY, or --file=PATH');
+        process.exit(1);
+    }
+    // Resolve embedding config
+    const emb = config.embedding;
+    if (!emb) {
+        console.error('Error: No embedding config in .slope/config.json. Run `slope index` first.');
+        process.exit(1);
+    }
+    const embConfig = {
+        endpoint: emb.endpoint,
+        model: emb.model,
+        dimensions: emb.dimensions,
+        apiKey: emb.apiKey,
+    };
+    // Open store
+    const storePath = config.store_path ?? '.slope/slope.db';
+    const store = new SqliteSlopeStore(`${cwd}/${storePath}`);
+    try {
+        if (!hasEmbeddingSupport(store)) {
+            throw new Error('Store does not support embeddings. Run `slope index` first.');
+        }
+        // Check if index exists
+        const stats = await store.getEmbeddingStats();
+        if (stats.chunkCount === 0) {
+            throw new Error('Semantic index is empty. Run `slope index` first.');
+        }
+        // Embed the query
+        const [queryVector] = await embed([queryText], embConfig);
+        // Search — fetch more than topK to allow dedup
+        const rawResults = await store.searchEmbeddings(queryVector, flags.top * 3);
+        // Map to ContextResult
+        const contextResults = rawResults.map(r => ({
+            filePath: r.filePath,
+            chunkIndex: r.chunkIndex,
+            snippet: r.chunkText,
+            score: r.score,
+        }));
+        // Deduplicate by file, filter by min score, and limit
+        const threshold = flags.minScore > 0 ? flags.minScore : 0.4;
+        const deduped = deduplicateByFile(contextResults)
+            .filter(r => r.score >= threshold)
+            .slice(0, flags.top);
+        if (deduped.length === 0) {
+            // Output nothing — caller checks for empty
+            return;
+        }
+        // Format and output
+        const output = formatContextForAgent(deduped, flags.format, cwd);
+        console.log(output);
+    }
+    finally {
+        store.close();
+    }
+}
+function printUsage() {
+    console.log(`
+slope context — Semantic context search
+
+Usage:
+  slope context "search query"              Free-text semantic search
+  slope context --ticket=S46-1              Use ticket title as query
+  slope context --file=src/core/store.ts    Find files related to a given file
+  slope context --top=10                    Limit results (default: 5)
+  slope context --format=paths              Output file paths only
+  slope context --format=snippets           Output code snippets (default)
+  slope context --format=full               Output full file contents of matches
+
+Requires a built semantic index. Run \`slope index\` first.
+`);
+}
+//# sourceMappingURL=context.js.map

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

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

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

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