@slope-dev/slope 1.25.3 → 1.26.0

package/dist/cli/commands/prep.js

@@ -3,16 +3,20 @@
 import { loadConfig } from '../../core/config.js';
 import { hasEmbeddingSupport } from '../../core/embedding-store.js';
 import { loadScorecards } from '../../core/loader.js';
-import { generatePrepPlan, formatPrepPlan } from '../../core/prep.js';
+import { generatePrepPlan, formatPrepPlan, resolveTicket, findSimilarTickets, extractHazards, formatLitePrepPlan } from '../../core/prep.js';
 import { SqliteSlopeStore } from '../../store/index.js';
 function parseArgs(args) {
     let ticketId = null;
     let json = false;
+    let lite = false;
     let top = 5;
     for (const arg of args) {
         if (arg === '--json') {
             json = true;
         }
+        else if (arg === '--lite') {
+            lite = true;
+        }
         else if (arg.startsWith('--top=')) {
             top = parseInt(arg.slice('--top='.length), 10) || 5;
         }
@@ -20,7 +24,7 @@ function parseArgs(args) {
             ticketId = arg;
         }
     }
-    return { ticketId, json, top };
+    return { ticketId, json, lite, top };
 }
 export async function prepCommand(args) {
     const cwd = process.cwd();
@@ -34,6 +38,19 @@ export async function prepCommand(args) {
         console.error('Error: Provide a ticket ID. Usage: slope prep <ticket-id>');
         process.exit(1);
     }
+    // --lite mode: hazards + similar tickets only (no embedding required)
+    if (flags.lite) {
+        const ticket = resolveTicket(flags.ticketId, cwd, undefined, config.roadmapPath);
+        if (!ticket) {
+            console.error(`Ticket not found: ${flags.ticketId}`);
+            process.exit(1);
+        }
+        const scorecards = loadScorecards(config, cwd);
+        const similarTickets = findSimilarTickets(ticket.title, scorecards);
+        const hazards = extractHazards(ticket.modules, scorecards);
+        console.log(formatLitePrepPlan(flags.ticketId, ticket.title, similarTickets, hazards));
+        return;
+    }
     // Resolve embedding config
     const emb = config.embedding;
     if (!emb) {
@@ -85,9 +102,11 @@ slope prep — Generate execution plan for a ticket
 Usage:
   slope prep <ticket-id>              Generate execution plan
   slope prep <ticket-id> --json       Output as JSON
+  slope prep <ticket-id> --lite       Hazards + similar tickets only (no embedding)
   slope prep <ticket-id> --top=5      Max context files (default: 5)
 
-Requires a built semantic index. Run \`slope index\` first.
+Full mode requires a built semantic index. Run \`slope index\` first.
+--lite mode works without embeddings (uses scorecard keyword matching).
 Looks up ticket in roadmap.json and slope-loop/backlog.json.
 `);
 }

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * slope quickstart — Interactive tutorial for new users.
+ * Walks through the core SLOPE workflow, checking current state along the way.
+ */
+export declare function quickstartCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=quickstart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/quickstart.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiIrE"}

package/dist/cli/commands/quickstart.js

@@ -0,0 +1,103 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import * as p from '@clack/prompts';
+/**
+ * slope quickstart — Interactive tutorial for new users.
+ * Walks through the core SLOPE workflow, checking current state along the way.
+ */
+export async function quickstartCommand(args) {
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(`
+slope quickstart — Interactive SLOPE tutorial
+
+Usage:
+  slope quickstart    Walk through the core SLOPE workflow step by step
+
+Non-destructive — shows commands to run, does not modify your project.
+`);
+        return;
+    }
+    const cwd = process.cwd();
+    p.intro('SLOPE Quickstart');
+    console.log(`
+  SLOPE (Sprint Lifecycle & Operational Performance Engine) helps you
+  track, score, and improve your sprint execution over time.
+
+  This guide walks through the core workflow. No files will be modified.
+`);
+    // ── Step 0: Check prerequisites ──────────────────────────────────
+    const slopeDir = join(cwd, '.slope');
+    const hasSlope = existsSync(join(slopeDir, 'config.json'));
+    const retrosDir = join(cwd, 'docs', 'retros');
+    const hasScorecards = existsSync(retrosDir) && readdirSync(retrosDir).some(f => f.endsWith('.json'));
+    if (!hasSlope) {
+        p.note('Your project has not been initialized with SLOPE yet.\n\n' +
+            'Run one of:\n' +
+            '  slope init                       Basic setup\n' +
+            '  slope init --interactive         Guided wizard\n' +
+            '  slope init --claude-code         Setup with Claude Code hooks\n' +
+            '  slope init --cursor              Setup with Cursor IDE rules', 'Step 0 — Initialize');
+        const shouldContinue = await p.confirm({
+            message: 'Continue the tutorial anyway?',
+            initialValue: true,
+        });
+        if (p.isCancel(shouldContinue) || !shouldContinue) {
+            p.outro('Run `slope init` first, then `slope quickstart` again.');
+            return;
+        }
+    }
+    else {
+        p.log.success('Project initialized — .slope/config.json found');
+    }
+    // ── Step 1: Pre-Sprint Briefing ──────────────────────────────────
+    p.note('Before starting a sprint, get a briefing on your current state:\n\n' +
+        '  slope briefing\n\n' +
+        'This shows:\n' +
+        '  - Handicap snapshot (trending performance)\n' +
+        '  - Hazard index (known gotchas in your code areas)\n' +
+        '  - Session continuity (active claims, unfinished work)\n\n' +
+        'Filter by area:  slope briefing --categories=testing,api\n' +
+        'Filter by keyword: slope briefing --keywords=migration', 'Step 1 — Pre-Sprint Briefing');
+    // ── Step 2: Sprint Planning ──────────────────────────────────────
+    p.note('Plan each ticket before writing code:\n\n' +
+        '  slope plan --complexity=medium\n\n' +
+        'This recommends:\n' +
+        '  - Club selection (approach complexity: putter → driver)\n' +
+        '  - Known hazards for the code areas you\'ll touch\n' +
+        '  - Training tips based on your miss patterns\n\n' +
+        'Claim tickets to avoid conflicts in multi-agent setups:\n' +
+        '  slope claim --target=S1-1 --sprint=1', 'Step 2 — Planning & Claims');
+    // ── Step 3: Scoring ──────────────────────────────────────────────
+    p.note('After completing sprint work, score and validate:\n\n' +
+        '  slope validate docs/retros/sprint-1.json\n' +
+        '  slope review docs/retros/sprint-1.json\n\n' +
+        'Or auto-generate a scorecard from git history:\n' +
+        '  slope auto-card --sprint=1\n\n' +
+        'View your performance trend:\n' +
+        '  slope card', 'Step 3 — Scoring & Review');
+    // ── Step 4: Guards & Hooks ───────────────────────────────────────
+    p.note('Guards are hooks that guide your agent during coding:\n\n' +
+        '  slope hook add --level=full     Install all guards\n' +
+        '  slope guard list                See available guards\n' +
+        '  slope guard status              Check installation state\n' +
+        '  slope guard docs                Detailed guard documentation\n\n' +
+        'Guards can:\n' +
+        '  - Nudge you to commit/push regularly\n' +
+        '  - Warn about known hazards in files you\'re editing\n' +
+        '  - Block commits on main (branch discipline)\n' +
+        '  - Detect scope drift outside your claimed tickets', 'Step 4 — Guards & Hooks');
+    // ── Next Steps ───────────────────────────────────────────────────
+    const nextSteps = [];
+    if (!hasSlope) {
+        nextSteps.push('slope init --interactive     Initialize SLOPE for this project');
+    }
+    if (!hasScorecards) {
+        nextSteps.push('slope auto-card --sprint=1   Generate your first scorecard from git');
+    }
+    nextSteps.push('slope briefing               Get a pre-sprint briefing');
+    nextSteps.push('slope help                   Browse all commands');
+    nextSteps.push('slope doctor                 Check repo health');
+    p.note(nextSteps.join('\n'), 'Next Steps');
+    p.outro('Ready to score your sprints!');
+}
+//# sourceMappingURL=quickstart.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.js","sourceRoot":"","sources":["../../../src/cli/commands/quickstart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAc;IACpD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC;;;;;;;CAOf,CAAC,CAAC;QACC,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1B,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAE5B,OAAO,CAAC,GAAG,CAAC;;;;;CAKb,CAAC,CAAC;IAED,oEAAoE;IAEpE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAErG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,CAAC,CAAC,IAAI,CACJ,2DAA2D;YAC3D,eAAe;YACf,kDAAkD;YAClD,oDAAoD;YACpD,mEAAmE;YACnE,gEAAgE,EAChE,qBAAqB,CACtB,CAAC;QAEF,MAAM,cAAc,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC;YACrC,OAAO,EAAE,+BAA+B;YACxC,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YAClD,CAAC,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;YAClE,OAAO;QACT,CAAC;IACH,CAAC;SAAM,CAAC;QACN,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC;IAClE,CAAC;IAED,oEAAoE;IAEpE,CAAC,CAAC,IAAI,CACJ,qEAAqE;QACrE,sBAAsB;QACtB,eAAe;QACf,gDAAgD;QAChD,uDAAuD;QACvD,6DAA6D;QAC7D,4DAA4D;QAC5D,wDAAwD,EACxD,8BAA8B,CAC/B,CAAC;IAEF,oEAAoE;IAEpE,CAAC,CAAC,IAAI,CACJ,2CAA2C;QAC3C,sCAAsC;QACtC,oBAAoB;QACpB,6DAA6D;QAC7D,sDAAsD;QACtD,mDAAmD;QACnD,2DAA2D;QAC3D,wCAAwC,EACxC,4BAA4B,CAC7B,CAAC;IAEF,oEAAoE;IAEpE,CAAC,CAAC,IAAI,CACJ,uDAAuD;QACvD,8CAA8C;QAC9C,8CAA8C;QAC9C,kDAAkD;QAClD,kCAAkC;QAClC,gCAAgC;QAChC,cAAc,EACd,2BAA2B,CAC5B,CAAC;IAEF,oEAAoE;IAEpE,CAAC,CAAC,IAAI,CACJ,2DAA2D;QAC3D,wDAAwD;QACxD,0DAA0D;QAC1D,8DAA8D;QAC9D,oEAAoE;QACpE,eAAe;QACf,0CAA0C;QAC1C,yDAAyD;QACzD,iDAAiD;QACjD,qDAAqD,EACrD,yBAAyB,CAC1B,CAAC;IAEF,oEAAoE;IAEpE,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,SAAS,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,SAAS,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IACxF,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IACzE,SAAS,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IACnE,SAAS,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAEjE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;IAE3C,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;AAC1C,CAAC"}

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

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

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

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

package/dist/cli/commands/worktree.js

@@ -0,0 +1,224 @@
+// slope worktree cleanup — Clean up stale git worktrees
+// Usage: slope worktree cleanup [--path=<path>] [--all] [--dry-run]
+import { execSync } from 'node:child_process';
+function parseArgs(args) {
+    let subcommand = null;
+    let targetPath = null;
+    let all = false;
+    let dryRun = false;
+    for (const arg of args) {
+        if (arg === '--all') {
+            all = true;
+        }
+        else if (arg === '--dry-run') {
+            dryRun = true;
+        }
+        else if (arg.startsWith('--path=')) {
+            targetPath = arg.slice('--path='.length);
+        }
+        else if (!arg.startsWith('-')) {
+            subcommand = arg;
+        }
+    }
+    return { subcommand, targetPath, all, dryRun };
+}
+/** Parse `git worktree list --porcelain` output */
+function listWorktrees(cwd) {
+    let output;
+    try {
+        output = execSync('git worktree list --porcelain', { cwd, encoding: 'utf8' });
+    }
+    catch {
+        return [];
+    }
+    const worktrees = [];
+    let current = {};
+    for (const line of output.split('\n')) {
+        if (line.startsWith('worktree ')) {
+            if (current.path)
+                worktrees.push(current);
+            current = { path: line.slice('worktree '.length) };
+        }
+        else if (line.startsWith('HEAD ')) {
+            current.head = line.slice('HEAD '.length);
+        }
+        else if (line.startsWith('branch ')) {
+            // refs/heads/feat/foo → feat/foo
+            current.branch = line.slice('branch '.length).replace('refs/heads/', '');
+        }
+        else if (line === '') {
+            if (current.path)
+                worktrees.push(current);
+            current = {};
+        }
+    }
+    if (current.path)
+        worktrees.push(current);
+    return worktrees;
+}
+/** Check if we're currently inside a worktree */
+function isInsideWorktree(cwd) {
+    try {
+        const commonDir = execSync('git rev-parse --git-common-dir 2>/dev/null', { cwd, encoding: 'utf8' }).trim();
+        const gitDir = execSync('git rev-parse --git-dir 2>/dev/null', { cwd, encoding: 'utf8' }).trim();
+        return gitDir !== commonDir && gitDir !== '.git';
+    }
+    catch {
+        return false;
+    }
+}
+/** Check if gh CLI is available */
+function hasGhCli() {
+    try {
+        execSync('gh --version', { encoding: 'utf8', stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Check if a branch's PR is merged */
+function isPrMerged(branch) {
+    try {
+        const result = execSync(`gh pr list --head "${branch}" --state merged --json url --limit 1`, { encoding: 'utf8', stdio: 'pipe' });
+        const prs = JSON.parse(result);
+        return Array.isArray(prs) && prs.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+function cleanupWorktree(wt, dryRun, ghAvailable) {
+    const branch = wt.branch || '';
+    if (ghAvailable && branch) {
+        const merged = isPrMerged(branch);
+        if (!merged) {
+            console.log(`  Skip: ${wt.path} (branch "${branch}" — PR not merged)`);
+            return false;
+        }
+    }
+    if (dryRun) {
+        console.log(`  [dry-run] Would remove worktree: ${wt.path}`);
+        if (branch) {
+            console.log(`  [dry-run] Would delete branch: ${branch}`);
+            console.log(`  [dry-run] Would delete remote branch: origin/${branch}`);
+        }
+        return true;
+    }
+    // Remove worktree
+    try {
+        execSync(`git worktree remove "${wt.path}" --force`, { encoding: 'utf8', stdio: 'pipe' });
+        console.log(`  Removed worktree: ${wt.path}`);
+    }
+    catch (err) {
+        console.error(`  Error removing worktree ${wt.path}: ${err.message}`);
+        return false;
+    }
+    // Delete local branch
+    if (branch) {
+        try {
+            execSync(`git branch -d "${branch}"`, { encoding: 'utf8', stdio: 'pipe' });
+            console.log(`  Deleted branch: ${branch}`);
+        }
+        catch { /* branch already deleted or not fully merged — ignore */ }
+        // Delete remote branch
+        try {
+            execSync(`git push origin --delete "${branch}"`, { encoding: 'utf8', stdio: 'pipe' });
+            console.log(`  Deleted remote branch: origin/${branch}`);
+        }
+        catch { /* remote branch already gone — ignore */ }
+    }
+    return true;
+}
+async function cleanupCommand(args) {
+    const flags = parseArgs(args);
+    const cwd = process.cwd();
+    // Safety: block if running from inside a worktree
+    if (isInsideWorktree(cwd)) {
+        console.error('Error: Cannot run worktree cleanup from inside a worktree.');
+        console.error('Call ExitWorktree first to return to the main repo, then retry.');
+        process.exit(1);
+    }
+    const allWorktrees = listWorktrees(cwd);
+    if (allWorktrees.length === 0) {
+        console.log('No worktrees found.');
+        return;
+    }
+    // First entry is the main worktree — skip it
+    const mainPath = allWorktrees[0]?.path;
+    const secondaryWorktrees = allWorktrees.filter(wt => wt.path !== mainPath);
+    if (secondaryWorktrees.length === 0) {
+        console.log('No secondary worktrees to clean up.');
+        return;
+    }
+    // Determine targets
+    let targets;
+    if (flags.targetPath) {
+        const found = secondaryWorktrees.find(wt => wt.path === flags.targetPath || wt.path.endsWith(flags.targetPath));
+        if (!found) {
+            console.error(`Worktree not found: ${flags.targetPath}`);
+            console.error('Available worktrees:');
+            for (const wt of secondaryWorktrees) {
+                console.error(`  ${wt.path} [${wt.branch || 'detached'}]`);
+            }
+            process.exit(1);
+        }
+        targets = [found];
+    }
+    else if (flags.all) {
+        targets = secondaryWorktrees;
+    }
+    else {
+        console.error('Error: Specify --path=<path> or --all');
+        console.error('Available worktrees:');
+        for (const wt of secondaryWorktrees) {
+            console.error(`  ${wt.path} [${wt.branch || 'detached'}]`);
+        }
+        process.exit(1);
+    }
+    const ghAvailable = hasGhCli();
+    if (!ghAvailable) {
+        console.log('Note: gh CLI not found — skipping PR merge checks');
+    }
+    let cleaned = 0;
+    for (const wt of targets) {
+        if (cleanupWorktree(wt, flags.dryRun, ghAvailable)) {
+            cleaned++;
+        }
+    }
+    if (flags.dryRun) {
+        console.log(`\n${cleaned} worktree(s) would be cleaned.`);
+    }
+    else {
+        console.log(`\nCleaned ${cleaned} worktree(s).`);
+    }
+}
+export async function worktreeCommand(args) {
+    const sub = args[0];
+    if (sub === 'cleanup') {
+        return cleanupCommand(args.slice(1));
+    }
+    if (args.includes('--help') || args.includes('-h') || !sub) {
+        console.log(`
+slope worktree — Manage git worktrees
+
+Usage:
+  slope worktree cleanup [--path=<path>] [--all] [--dry-run]
+
+Options:
+  --path=<path>  Target a specific worktree
+  --all          Clean up all secondary worktrees
+  --dry-run      Preview what would happen without making changes
+
+For each worktree, cleanup will:
+  1. Check if the branch's PR is merged (requires gh CLI)
+  2. Remove the worktree (git worktree remove)
+  3. Delete the local branch (git branch -d)
+  4. Delete the remote branch (git push origin --delete)
+`);
+        return;
+    }
+    console.error(`Unknown subcommand: ${sub}. Run slope worktree --help for usage.`);
+    process.exit(1);
+}
+//# sourceMappingURL=worktree.js.map

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

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

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

@@ -0,0 +1,19 @@
+export interface GuardDoc {
+    /** What problem this guard solves */
+    purpose: string;
+    /** Hook event + matcher (what tools/actions fire it) */
+    triggers: string;
+    /** What it does when fired (block vs advisory vs context injection) */
+    behavior: string;
+    /** How to enable/disable, relevant config.json fields */
+    configuration: string;
+    /** Which --level installs it */
+    level: 'scoring' | 'full';
+}
+export declare const GUARD_DOCS: Record<string, GuardDoc>;
+/**
+ * Format guard documentation for console output.
+ * @param name — specific guard name, or undefined for all guards
+ */
+export declare function formatGuardDocs(name?: string): void;
+//# sourceMappingURL=docs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/cli/guards/docs.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAsI/C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAuCnD"}