@slope-dev/slope 1.5.1

package/dist/cli/template-generator.js

@@ -0,0 +1,562 @@
+// SLOPE Template Generator
+// Generates platform-specific templates with metaphor-aware vocabulary.
+// When metaphor=golf, output matches the existing static templates in templates/.
+const titleCase = (s) => s.replace(/\b\w/g, c => c.toUpperCase());
+// --- Derived routine names from vocabulary ---
+function routineNames(m) {
+    const sprint = titleCase(m.vocabulary.sprint); // "Hole", "Level", "Set"
+    const ticket = titleCase(m.vocabulary.ticket); // "Shot", "Quest", "Point"
+    const briefing = titleCase(m.vocabulary.briefing); // "Pre-Round Briefing", "Quest Log"
+    const review = titleCase(m.vocabulary.review); // "19th Hole", "Save Point"
+    const scorecard = titleCase(m.vocabulary.scorecard);
+    const handicapCard = titleCase(m.vocabulary.handicapCard);
+    const onTarget = titleCase(m.vocabulary.onTarget);
+    return { sprint, ticket, briefing, review, scorecard, handicapCard, onTarget };
+}
+// --- Project context file (CLAUDE.md / AGENTS.md) ---
+export function generateProjectContext(m) {
+    const r = routineNames(m);
+    return `# SLOPE Project
+
+This project uses the SLOPE framework for sprint tracking.
+
+## Commands
+- \`slope card\` — view ${r.handicapCard.toLowerCase()}
+- \`slope validate\` — validate ${r.scorecard.toLowerCase()}s
+- \`slope review\` — generate sprint review
+- \`slope briefing\` — ${r.briefing.toLowerCase()}
+
+## MCP Tools
+A SLOPE MCP server is configured in \`.mcp.json\`. Two tools:
+- \`search\` — discover API functions, types, constants
+- \`execute\` — run JS with full SLOPE API in sandbox
+
+## Sprint Workflow
+- **Pre-${r.sprint}:** \`slope briefing\` for handicap, hazards, gotchas
+- **Per-${r.ticket}:** classify each ticket with approach + result + hazards
+- **Post-${r.sprint}:** \`slope validate\` ${r.scorecard.toLowerCase()}, \`slope review\`, update common-issues
+
+See .claude/rules/ for detailed checklists.
+
+## ${r.scorecard}s
+Stored in docs/retros/sprint-N.json. See .slope/config.json for configuration.
+`;
+}
+// --- Sprint checklist rule ---
+export function generateSprintChecklist(m) {
+    const r = routineNames(m);
+    const clubs = m.clubs;
+    const results = m.shotResults;
+    return `# Sprint Checklists (SLOPE Routine Hierarchy)
+
+The SLOPE framework organizes sprint work into a hierarchy of routines${m.id === 'golf' ? ", mirroring golf's structured approach to each shot, hole, and round" : `, using ${m.name.toLowerCase()} terminology`}.
+
+## Pre-Tournament Routine (Course Strategy)
+
+Before starting a new phase or project:
+
+1. **Define the vision** — What does the end state look like? Document in a vision doc
+2. **Build the roadmap** — Create \`docs/backlog/roadmap.json\` with sprints, dependencies, and phases
+3. **Run \`slope roadmap validate\`** — Check for structural issues, dependency cycles, numbering gaps
+4. **Run \`slope roadmap review\`** — Automated architect review: scope balance, critical path, bottlenecks
+5. **Identify the critical path** — Run \`slope roadmap show\` to see the dependency graph and parallel tracks
+6. **Plan parallel tracks** — If sprints can run concurrently, plan for multi-agent execution
+
+## Pre-${r.sprint} Routine (Sprint Start)
+
+Before writing any code in a new sprint:
+
+1. **Run \`slope briefing\`** — Single command that outputs handicap snapshot, hazard index, nutrition alerts, filtered gotchas, and session continuity
+   - Use \`--categories=testing,api\` or \`--keywords=migration\` to filter for the sprint's work area
+2. **Verify previous ${r.scorecard.toLowerCase()} exists** — If the last sprint's ${r.scorecard.toLowerCase()} wasn't created, create it now
+3. **Branch hygiene check** — \`git branch -a\` to confirm no stale branches remain
+4. **Gap analysis** (if touching API or schema) — Read relevant docs and compare against implementation before writing code
+5. **Set ${r.onTarget.toLowerCase()} and slope** — ${r.onTarget} from ticket count (1-2=3, 3-4=4, 5+=5), slope from complexity factors
+
+## Pre-${r.ticket} Routine (Per-Ticket, Before Code)
+
+Before starting each ticket:
+
+1. **Select your approach** — Declare complexity: ${clubs.driver} (risky/new), ${clubs.long_iron} (multi-package), ${clubs.short_iron} (standard), ${clubs.wedge} (small), ${clubs.putter} (trivial)
+2. **Check the codebase** — Review relevant codebase sections for files you'll modify
+3. **Scan for hazards** — Check known hazards from recent ${r.scorecard.toLowerCase()}s and common issues for known gotchas
+4. **Commit the approach selection** — Note it in your sprint tracking before writing code
+
+## Post-${r.ticket} Routine (Per-Ticket, After Completion)
+
+After completing each ticket:
+
+1. **Score the ${r.ticket.toLowerCase()}** — Determine result: ${results.fairway} (clean start), ${results.green} (landed correctly), ${results.in_the_hole} (perfect), or miss direction (over/under/wrong approach/drift)
+2. **Record hazards** — Note any gotchas encountered
+3. **Check for penalties** — Tests break? Reverts needed? Each penalty adds to the score
+4. **Update sprint tracking** — Mark ticket status
+5. **Push** — The last push is the recovery point
+
+## Post-${r.sprint} Routine (Sprint Completion)
+
+After all tickets are complete:
+
+1. **Score the sprint** — Audit commits, compute final score vs ${r.onTarget.toLowerCase()}
+2. **Build the SLOPE ${r.scorecard.toLowerCase()}** — Create ${r.scorecard.toLowerCase()} JSON in your retros directory. Run \`slope validate\` to confirm no errors
+3. **Distill learnings** — Update common-issues with new recurring patterns
+4. **Create PR and merge** — All artifacts travel with the PR
+5. **Review** — Run \`slope review\` to generate the sprint review markdown
+
+## Post-Phase Routine (Per-Phase)
+
+At the end of each development phase:
+
+1. **Compute ${r.handicapCard.toLowerCase()}** — Run \`slope card\` to see trending stats
+2. **Review miss patterns** — Identify systemic issues from the ${r.handicapCard.toLowerCase()}
+3. **Training program** — Based on trends, identify areas for focused practice sprints
+`;
+}
+// --- Commit discipline rule ---
+export function generateCommitDiscipline(m) {
+    const r = routineNames(m);
+    return `# Commit Discipline
+
+**Commit early, commit often.** Lost context from uncommitted work is the #1 risk.
+The last push is the recovery point — everything since the last push is lost on crash or context loss.
+
+## Commit triggers:
+
+Commit immediately after ANY of these:
+1. **Each new file** — route, migration, config, component, test. Don't batch file creations.
+2. **Each endpoint or feature** — one feature implemented = one commit.
+3. **Each migration** — commit each separately.
+4. **Each doc update** — spec change, README edit.
+5. **Each bug fix** — no matter how small.
+6. **Before switching context** — moving to a different area? Commit first.
+7. **Before risky operations** — large refactor, dependency upgrade.
+8. **Time check** — if ~15 minutes have passed since the last commit, commit what works.
+9. **Session end** — never leave uncommitted changes. Use a \`wip:\` prefix if incomplete.
+
+## Push triggers:
+
+Push immediately after ANY of these:
+1. **After each completed ticket (Post-${r.ticket} Routine)** — all commits pushed before merging. Score the ${r.ticket.toLowerCase()}.
+2. **Every 30 minutes** — never go longer without a push.
+3. **Before context compaction** — if context is running low, push first.
+4. **Before switching tickets** — push current branch before starting a new one.
+5. **Session end** — never leave unpushed commits.
+
+## Commit message format:
+
+\`\`\`
+<type>(<ticket>): <short summary in imperative mood>
+
+<optional body explaining why, not what>
+\`\`\`
+
+Types: \`feat\`, \`fix\`, \`refactor\`, \`docs\`, \`test\`, \`chore\`, \`wip\`
+`;
+}
+// --- Review loop rule ---
+export function generateReviewLoop() {
+    return `# Sprint Plan Review Loop
+
+After creating a sprint plan, run a structured review to catch issues before implementation.
+
+## Review Tier Selection
+
+| Tier | Rounds | When to use |
+|------|--------|-------------|
+| **Skip** | 0 | Research, infra, or docs-only sprints |
+| **Light** | 1 | 1-2 tickets, familiar patterns, single-package |
+| **Standard** | 2 | 3-4 tickets, multi-package, or schema/API changes |
+| **Deep** | 3 | 5+ tickets, new infrastructure, architectural changes |
+
+## Review Process
+
+### Round 1 — Deep Review
+
+Check the plan against the codebase:
+- Does the plan duplicate existing infrastructure?
+- Are dependencies correct and ordering optimal?
+- Does the approach match codebase patterns?
+- Are there scope gaps or underscoped complexity?
+- Does it introduce unnecessary complexity?
+
+### Round 2 — Delta Review (Standard+)
+
+Review **only what changed** since Round 1:
+- Were Round 1 findings addressed correctly?
+- Did revisions introduce new issues?
+
+### Round 3 — Final Sign-off (Deep only)
+
+Delta review of Round 2 changes. Expected outcome: approval with minor notes.
+
+## Tool Priority
+
+1. **Search** to check function signatures, type definitions, patterns
+2. **Find** to verify file existence and related files
+3. **Read** only when search can't answer (complex multi-line logic)
+`;
+}
+// --- Codebase context rule ---
+export function generateCodebaseContextRule() {
+    return `# Codebase Context — Map vs Explore
+
+SLOPE maintains a codebase map at \`CODEBASE.md\` (~5k tokens) with auto-generated sections covering packages, API surface, CLI commands, guards, MCP tools, tests, sprint history, and known gotchas.
+
+## When to use the map (default)
+
+- Starting a new sprint — read the map first
+- Understanding feature areas and file locations
+- Finding which package owns a feature
+- Looking up CLI commands, guards, or MCP tools
+- Checking recent sprint history and known gotchas
+
+**Access methods:**
+- \`Read CODEBASE.md\` — full map in one read
+- \`search({ module: 'map' })\` — full map via MCP
+- \`search({ module: 'map', query: 'guards' })\` — specific section via MCP
+
+## When to explore beyond the map
+
+- The map doesn't cover a new package or feature you need detail on
+- You need implementation-level detail (function signatures, complex logic)
+- The map metadata shows it's stale (explore guard will warn you)
+- You're debugging a specific issue that requires reading source code
+
+## Keeping the map current
+
+- Run \`slope map\` after adding new files, commands, or guards
+- Run \`slope map --check\` to verify staleness before a sprint
+- The map auto-updates only auto-generated sections; manual content is preserved
+`;
+}
+export function generateCursorCodebaseContextRule() {
+    return `---
+description: When to use the SLOPE codebase map vs exploring the codebase directly
+globs:
+alwaysApply: true
+---
+
+# Codebase Context — Map vs Explore
+
+SLOPE maintains a codebase map at \`CODEBASE.md\` (~5k tokens) with auto-generated sections covering packages, API surface, CLI commands, guards, MCP tools, tests, sprint history, and known gotchas.
+
+## When to use the map (default)
+
+- Starting a new sprint — read the map first
+- Understanding feature areas and file locations
+- Finding which package owns a feature
+- Looking up CLI commands, guards, or MCP tools
+
+**Access methods:**
+- Read \`CODEBASE.md\` — full map in one read
+- \`search({ module: 'map' })\` — full map via MCP
+- \`search({ module: 'map', query: 'guards' })\` — specific section via MCP
+
+## When to explore beyond the map
+
+- The map doesn't cover a new package or feature
+- You need implementation-level detail (function signatures, complex logic)
+- The map metadata shows it's stale
+- You're debugging a specific issue
+
+## Keeping the map current
+
+- Run \`slope map\` after adding new files, commands, or guards
+- Run \`slope map --check\` to verify staleness before a sprint
+`;
+}
+// --- OpenCode AGENTS.md ---
+export function generateAgentsMd(m) {
+    const r = routineNames(m);
+    const clubs = m.clubs;
+    const results = m.shotResults;
+    return `# SLOPE Project
+
+This project uses the SLOPE framework for sprint tracking.
+
+## Commands
+- \`slope card\` — view ${r.handicapCard.toLowerCase()}
+- \`slope validate\` — validate ${r.scorecard.toLowerCase()}s
+- \`slope review\` — generate sprint review
+- \`slope briefing\` — ${r.briefing.toLowerCase()}
+
+## MCP Tools
+A SLOPE MCP server is configured in \`opencode.json\`. Two tools:
+- \`search\` — discover API functions, types, constants
+- \`execute\` — run JS with full SLOPE API in sandbox
+
+## Sprint Workflow
+- **Pre-${r.sprint}:** \`slope briefing\` for handicap, hazards, gotchas
+- **Per-${r.ticket}:** classify each ticket with approach + result + hazards
+- **Post-${r.sprint}:** \`slope validate\` ${r.scorecard.toLowerCase()}, \`slope review\`, update common-issues
+
+## Approach Complexity
+- ${clubs.driver}: risky/new territory
+- ${clubs.long_iron}: multi-package changes
+- ${clubs.short_iron}: standard work
+- ${clubs.wedge}: small tasks
+- ${clubs.putter}: trivial changes
+
+## ${r.ticket} Results
+- ${results.in_the_hole}: perfect execution
+- ${results.green}: landed correctly
+- ${results.fairway}: clean start, needs finishing
+- Miss directions: over-scoped, under-scoped, wrong approach, drift
+
+## Commit Discipline
+- Commit after each file, feature, migration, or bug fix
+- Push after each ticket and every 30 minutes
+- Format: \`<type>(<ticket>): <summary>\` (feat/fix/refactor/docs/test/chore)
+
+## Codebase Map
+
+SLOPE maintains a codebase map at \`CODEBASE.md\` (~5k tokens). Read it before exploring.
+- Run \`slope map\` to generate/update
+- Run \`slope map --check\` to verify staleness
+- Use \`search({ module: 'map' })\` via MCP for targeted queries
+
+## ${r.scorecard}s
+Stored in docs/retros/sprint-N.json. See .slope/config.json for configuration.
+`;
+}
+// --- OpenCode plugin ---
+export function generateOpenCodePlugin() {
+    return `// SLOPE Plugin for OpenCode
+// Auto-generated by \`slope init --opencode\`
+// Logs session lifecycle events to SLOPE's SQLite store.
+
+export default async ({ $ }) => {
+  return {
+    event: async ({ event }) => {
+      switch (event.type) {
+        case 'session.created':
+          await $\`slope session start --ide=opencode --role=primary\`;
+          await $\`slope briefing --compact\`;
+          break;
+
+        case 'session.idle':
+        case 'session.deleted':
+          if (process.env.SLOPE_SESSION_ID) {
+            await $\`slope session end --session-id=\${process.env.SLOPE_SESSION_ID}\`;
+          }
+          break;
+
+        case 'session.compacted':
+          if (process.env.SLOPE_SESSION_ID) {
+            await $\`slope session heartbeat --session-id=\${process.env.SLOPE_SESSION_ID}\`;
+          }
+          break;
+      }
+    },
+  };
+};
+`;
+}
+// --- Cursor .mdc wrappers ---
+export function generateCursorSprintChecklist(m) {
+    const r = routineNames(m);
+    const clubs = m.clubs;
+    const results = m.shotResults;
+    return `---
+description: SLOPE sprint lifecycle checklist — routines for pre-sprint, per-ticket, and post-sprint
+globs:
+alwaysApply: true
+---
+
+# Sprint Checklists (SLOPE Routine Hierarchy)
+
+The SLOPE framework organizes sprint work into a hierarchy of routines${m.id === 'golf' ? ", mirroring golf's structured approach to each shot, hole, and round" : `, using ${m.name.toLowerCase()} terminology`}.
+
+## Pre-Tournament Routine (Course Strategy)
+
+Before starting a new phase or project:
+
+1. **Build the roadmap** — Create \`docs/backlog/roadmap.json\` with sprints, dependencies, and phases
+2. **Run \`slope roadmap validate\`** — Check for dependency cycles, numbering gaps
+3. **Run \`slope roadmap review\`** — Scope balance, critical path, bottlenecks
+4. **Run \`slope roadmap show\`** — Dependency graph and parallel tracks
+
+## Pre-${r.sprint} Routine (Sprint Start)
+
+Before writing any code in a new sprint:
+
+1. **Run \`slope briefing\`** — Outputs handicap snapshot, hazard index, nutrition alerts, filtered gotchas, and session continuity
+   - Use \`--categories=testing,api\` or \`--keywords=migration\` to filter for the sprint's work area
+2. **Verify previous ${r.scorecard.toLowerCase()} exists** — If the last sprint's ${r.scorecard.toLowerCase()} wasn't created, create it now
+3. **Branch hygiene check** — \`git branch -a\` to confirm no stale branches remain
+4. **Set ${r.onTarget.toLowerCase()} and slope** — ${r.onTarget} from ticket count (1-2=3, 3-4=4, 5+=5), slope from complexity factors
+
+## Pre-${r.ticket} Routine (Per-Ticket, Before Code)
+
+1. **Select your approach** — ${clubs.driver} (risky/new), ${clubs.long_iron} (multi-package), ${clubs.short_iron} (standard), ${clubs.wedge} (small), ${clubs.putter} (trivial)
+2. **Check the codebase** — Review relevant codebase sections for files you'll modify
+3. **Scan for hazards** — Check known hazards from recent ${r.scorecard.toLowerCase()}s and common issues
+
+## Post-${r.ticket} Routine (Per-Ticket, After Completion)
+
+1. **Score the ${r.ticket.toLowerCase()}** — ${results.in_the_hole} (perfect), ${results.green} (landed), ${results.fairway} (clean start), or miss direction
+2. **Record hazards** — Note any gotchas encountered
+3. **Check for penalties** — Tests break? Reverts needed?
+4. **Push** — The last push is the recovery point
+
+## Post-${r.sprint} Routine (Sprint Completion)
+
+1. **Build the SLOPE ${r.scorecard.toLowerCase()}** — Create ${r.scorecard.toLowerCase()} JSON. Run \`slope validate\`
+2. **Distill learnings** — Update common-issues with new recurring patterns
+3. **Review** — Run \`slope review\` to generate the sprint review markdown
+4. **Compute ${r.handicapCard.toLowerCase()}** — Run \`slope card\` to see trending stats
+`;
+}
+export function generateCursorCommitDiscipline(m) {
+    const r = routineNames(m);
+    return `---
+description: Commit and push discipline for SLOPE-managed sprints
+globs:
+alwaysApply: true
+---
+
+# Commit Discipline
+
+**Commit early, commit often.** The last push is the recovery point.
+
+## Commit triggers:
+
+Commit immediately after ANY of these:
+1. Each new file — route, migration, config, component, test
+2. Each endpoint or feature implemented
+3. Each migration — commit separately
+4. Each bug fix — no matter how small
+5. Before switching context to a different area
+6. Before risky operations — large refactor, dependency upgrade
+7. Time check — if ~15 minutes since last commit, commit what works
+8. Session end — never leave uncommitted changes (use \`wip:\` prefix if incomplete)
+
+## Push triggers:
+
+Push immediately after ANY of these:
+1. After each completed ticket (Post-${r.ticket} Routine)
+2. Every 30 minutes
+3. Before switching tickets
+4. Session end — never leave unpushed commits
+
+## Commit message format:
+
+\`\`\`
+<type>(<ticket>): <short summary in imperative mood>
+\`\`\`
+
+Types: \`feat\`, \`fix\`, \`refactor\`, \`docs\`, \`test\`, \`chore\`, \`wip\`
+`;
+}
+export function generateCursorReviewLoop() {
+    return `---
+description: Sprint plan review tiers for catching issues before implementation
+globs:
+alwaysApply: false
+---
+
+# Sprint Plan Review Loop
+
+After creating a sprint plan, run a structured review.
+
+## Review Tier Selection
+
+| Tier | Rounds | When to use |
+|------|--------|-------------|
+| **Skip** | 0 | Research, infra, or docs-only sprints |
+| **Light** | 1 | 1-2 tickets, familiar patterns, single-package |
+| **Standard** | 2 | 3-4 tickets, multi-package, or schema/API changes |
+| **Deep** | 3 | 5+ tickets, new infrastructure, architectural changes |
+
+## Round 1 — Deep Review
+
+- Does the plan duplicate existing infrastructure?
+- Are dependencies correct and ordering optimal?
+- Does the approach match codebase patterns?
+- Are there scope gaps or underscoped complexity?
+
+## Round 2 — Delta Review (Standard+)
+
+Review **only what changed** since Round 1.
+
+## Round 3 — Final Sign-off (Deep only)
+
+Delta review of Round 2 changes. Expected outcome: approval with minor notes.
+`;
+}
+// --- Cursor .cursorrules (project root context file) ---
+export function generateCursorrules(m) {
+    const r = routineNames(m);
+    const clubs = m.clubs;
+    const results = m.shotResults;
+    return `# SLOPE Project
+
+This project uses the SLOPE framework for sprint tracking.
+
+## Commands
+- \`slope card\` — view ${r.handicapCard.toLowerCase()}
+- \`slope validate\` — validate ${r.scorecard.toLowerCase()}s
+- \`slope review\` — generate sprint review
+- \`slope briefing\` — ${r.briefing.toLowerCase()}
+
+## MCP Tools
+A SLOPE MCP server is configured in \`.cursor/mcp.json\`. Two tools:
+- \`search\` — discover API functions, types, constants
+- \`execute\` — run JS with full SLOPE API in sandbox
+
+## Sprint Workflow
+- **Pre-${r.sprint}:** \`slope briefing\` for handicap, hazards, gotchas
+- **Per-${r.ticket}:** classify each ticket with approach + result + hazards
+- **Post-${r.sprint}:** \`slope validate\` ${r.scorecard.toLowerCase()}, \`slope review\`, update common-issues
+
+## Approach Complexity
+- ${clubs.driver}: risky/new territory
+- ${clubs.long_iron}: multi-package changes
+- ${clubs.short_iron}: standard work
+- ${clubs.wedge}: small tasks
+- ${clubs.putter}: trivial changes
+
+## ${r.ticket} Results
+- ${results.in_the_hole}: perfect execution
+- ${results.green}: landed correctly
+- ${results.fairway}: clean start, needs finishing
+- Miss directions: over-scoped, under-scoped, wrong approach, drift
+
+## ${r.scorecard}s
+Stored in docs/retros/sprint-N.json. See .slope/config.json for configuration.
+See .cursor/rules/ for detailed checklists.
+`;
+}
+// --- Generic checklist ---
+export function generateGenericChecklist(m) {
+    const r = routineNames(m);
+    const clubs = m.clubs;
+    return `# SLOPE Sprint Checklist
+
+## Pre-Tournament (Course Strategy)
+1. Build roadmap in \`docs/backlog/roadmap.json\`
+2. Run \`slope roadmap validate\` — check dependencies and structure
+3. Run \`slope roadmap review\` — scope balance, critical path, bottlenecks
+4. Run \`slope roadmap show\` — view dependency graph
+
+## Pre-${r.sprint} (Sprint Start)
+1. Run \`slope briefing\` — handicap, hazards, gotchas, session continuity
+2. Verify previous ${r.scorecard.toLowerCase()} exists
+3. Set ${r.onTarget.toLowerCase()} (1-2 tickets=3, 3-4=4, 5+=5) and slope factors
+
+## Per-Ticket
+- **Before:** Select approach (${clubs.driver}/${clubs.long_iron}/${clubs.short_iron}/${clubs.wedge}/${clubs.putter}), scan hazards
+- **After:** Score ${r.ticket.toLowerCase()}, record hazards, check penalties, commit + push
+
+## Post-${r.sprint} (Sprint End)
+1. Build ${r.scorecard.toLowerCase()} JSON, run \`slope validate\`
+2. Update common-issues with new patterns
+3. Run \`slope review\` for markdown output
+4. Run \`slope card\` for ${r.handicapCard.toLowerCase()} trends
+
+## Commit Discipline
+- Commit after each file, feature, migration, or bug fix
+- Push after each ticket and every 30 minutes
+- Format: \`<type>(<ticket>): <summary>\` (feat/fix/refactor/docs/test/chore)
+`;
+}
+//# sourceMappingURL=template-generator.js.map

package/dist/cli/template-generator.js.map

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

package/dist/core/advisor.d.ts

@@ -0,0 +1,63 @@
+import type { GolfScorecard, ClubRecommendation, ShotClassification, ExecutionTrace, TrainingRecommendation, HandicapCard, DispersionReport, CISignal, PRSignal, SlopeEvent } from './types.js';
+export interface RecommendClubInput {
+    ticketComplexity: 'trivial' | 'small' | 'medium' | 'large';
+    scorecards: GolfScorecard[];
+    slopeFactors?: string[];
+}
+/**
+ * Recommend a club (approach complexity) for an upcoming ticket.
+ *
+ * Logic:
+ * 1. Map ticket complexity to default club (large → long_iron, never driver)
+ * 2. Check historical performance — if default club miss_rate > 30%, downgrade one level
+ * 3. Check dispersion for dominant miss — add provisional suggestion if ≥3 total misses
+ * 4. Confidence: 1.0 with ≥5 scorecards for that club, 0.5 with 1-4, 0.3 with 0
+ */
+export declare function recommendClub(input: RecommendClubInput): ClubRecommendation;
+/**
+ * Classify a shot result from an execution trace.
+ *
+ * Rules:
+ * - All files in scope, no failures, no reverts → in_the_hole
+ * - Has hazards, all resolved before first green suite → in_the_hole (in-pass fix)
+ * - Has hazards, resolved after initial pass → green (required rework)
+ * - Files outside scope modified → missed_long (over-engineering)
+ * - Planned files not modified → missed_short (under-scoping)
+ * - Reverts > 0 or approach changed → missed_left (wrong approach)
+ * - Some test suites fail despite others passing → missed_right (wrong execution)
+ */
+export declare function classifyShot(trace: ExecutionTrace): ShotClassification;
+/** Combined signal sources for enhanced shot classification */
+export interface CombinedSignals {
+    trace: ExecutionTrace;
+    ci?: CISignal;
+    pr?: PRSignal;
+    events?: SlopeEvent[];
+}
+/**
+ * Enhanced shot classification using multiple signal sources.
+ *
+ * Key difference from classifyShot():
+ * - Git-only (no CI, no events) defaults to `green` instead of `in_the_hole`
+ * - CI signals can upgrade to `in_the_hole` (all tests pass, no retries, no failures)
+ * - CI test failures add miss signals (missed_right)
+ * - CI retries reduce confidence
+ * - Events (failure, dead_end, scope_change) add miss signals
+ */
+export declare function classifyShotFromSignals(input: CombinedSignals): ShotClassification;
+export interface TrainingPlanInput {
+    handicap: HandicapCard;
+    dispersion: DispersionReport;
+    recentScorecards: GolfScorecard[];
+}
+/**
+ * Generate training recommendations from handicap trends and dispersion data.
+ *
+ * Checks:
+ * 1. Dominant miss direction → targeted practice (high)
+ * 2. Worsening trend (last_5 > all_time) → review (high)
+ * 3. Club-specific issues (miss_rate > 50%) → adjustment (medium)
+ * 4. Recurring hazard types in 3+ consecutive sprints → attention (medium)
+ */
+export declare function generateTrainingPlan(input: TrainingPlanInput): TrainingRecommendation[];
+//# sourceMappingURL=advisor.d.ts.map

package/dist/core/advisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advisor.d.ts","sourceRoot":"","sources":["../../src/core/advisor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,kBAAkB,EAClB,kBAAkB,EAGlB,cAAc,EACd,sBAAsB,EAEtB,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,UAAU,EACX,MAAM,YAAY,CAAC;AA6BpB,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3D,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,kBAAkB,CAkD3E;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,kBAAkB,CAgFtE;AAMD,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,cAAc,CAAC;IACtB,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,kBAAkB,CAmIlF;AA0CD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,gBAAgB,EAAE,aAAa,EAAE,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,sBAAsB,EAAE,CA6FvF"}