@m2015agg/git-skill 0.1.0

package/dist/commands/diff-summary.js

@@ -0,0 +1,151 @@
+import { Command } from "commander";
+import { openDb } from "../util/db.js";
+import { join } from "path";
+import { execSync } from "child_process";
+export function diffSummaryCommand() {
+    return new Command("diff-summary")
+        .description("LLM-friendly summary of a commit range")
+        .argument("<range>", "Commit range (e.g. v1.0..v1.1 or HEAD~10..HEAD)")
+        .option("--json", "Output as JSON")
+        .action((range, opts) => {
+        const historyDir = join(process.cwd(), ".git-history");
+        const db = openDb(historyDir);
+        try {
+            // Get hashes in range
+            let revListOutput;
+            try {
+                revListOutput = execSync(`git rev-list ${range}`, {
+                    cwd: process.cwd(),
+                    encoding: "utf-8",
+                });
+            }
+            catch {
+                process.stderr.write(`Could not resolve range: ${range}\n`);
+                process.exit(1);
+            }
+            const hashes = revListOutput
+                .split("\n")
+                .map((h) => h.trim())
+                .filter(Boolean);
+            if (hashes.length === 0) {
+                const empty = {
+                    range,
+                    commits: [],
+                    authors: [],
+                    added_files: [],
+                    modified_files: [],
+                    deleted_files: [],
+                    total_insertions: 0,
+                    total_deletions: 0,
+                    decision_points: 0,
+                };
+                if (opts.json) {
+                    process.stdout.write(JSON.stringify(empty, null, 2) + "\n");
+                }
+                else {
+                    process.stdout.write(`No commits found in range: ${range}\n`);
+                }
+                return;
+            }
+            const placeholders = hashes.map(() => "?").join(",");
+            // Query commits
+            const commitRows = db
+                .prepare(`SELECT hash, author, timestamp, message, insertions, deletions
+             FROM commits
+             WHERE hash IN (${placeholders})
+             ORDER BY timestamp ASC`)
+                .all(...hashes);
+            // Query files
+            const fileRows = db
+                .prepare(`SELECT file_path, status, insertions, deletions
+             FROM commit_files
+             WHERE commit_hash IN (${placeholders})`)
+                .all(...hashes);
+            // Decision points in range
+            const dpRow = db
+                .prepare(`SELECT COUNT(*) AS cnt FROM decision_points WHERE commit_hash IN (${placeholders})`)
+                .get(...hashes);
+            // Compute stats
+            const authorSet = new Set();
+            let totalInsertions = 0;
+            let totalDeletions = 0;
+            for (const c of commitRows) {
+                authorSet.add(c.author);
+                totalInsertions += c.insertions ?? 0;
+                totalDeletions += c.deletions ?? 0;
+            }
+            const addedFiles = [];
+            const modifiedFiles = [];
+            const deletedFiles = [];
+            const seenFiles = new Set();
+            for (const f of fileRows) {
+                if (seenFiles.has(f.file_path))
+                    continue;
+                seenFiles.add(f.file_path);
+                if (f.status === "A")
+                    addedFiles.push(f.file_path);
+                else if (f.status === "D")
+                    deletedFiles.push(f.file_path);
+                else
+                    modifiedFiles.push(f.file_path);
+            }
+            const result = {
+                range,
+                commits: commitRows.map((c) => ({
+                    hash: c.hash,
+                    author: c.author,
+                    timestamp: c.timestamp,
+                    message: c.message,
+                })),
+                authors: [...authorSet],
+                added_files: addedFiles,
+                modified_files: modifiedFiles,
+                deleted_files: deletedFiles,
+                total_insertions: totalInsertions,
+                total_deletions: totalDeletions,
+                decision_points: dpRow?.cnt ?? 0,
+            };
+            if (opts.json) {
+                process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+                return;
+            }
+            // Text output
+            process.stdout.write(`Diff Summary: ${range}\n`);
+            process.stdout.write(`${"─".repeat(80)}\n`);
+            process.stdout.write(`Commits:      ${commitRows.length}\n`);
+            process.stdout.write(`Authors:      ${[...authorSet].join(", ")}\n`);
+            process.stdout.write(`Insertions:   +${totalInsertions}\n`);
+            process.stdout.write(`Deletions:    -${totalDeletions}\n`);
+            process.stdout.write(`Decision pts: ${dpRow?.cnt ?? 0}\n`);
+            process.stdout.write(`\n`);
+            if (addedFiles.length > 0) {
+                process.stdout.write(`Added files (${addedFiles.length}):\n`);
+                for (const f of addedFiles)
+                    process.stdout.write(`  + ${f}\n`);
+                process.stdout.write(`\n`);
+            }
+            if (deletedFiles.length > 0) {
+                process.stdout.write(`Deleted files (${deletedFiles.length}):\n`);
+                for (const f of deletedFiles)
+                    process.stdout.write(`  - ${f}\n`);
+                process.stdout.write(`\n`);
+            }
+            if (modifiedFiles.length > 0) {
+                process.stdout.write(`Modified files (${modifiedFiles.length}):\n`);
+                for (const f of modifiedFiles)
+                    process.stdout.write(`  ~ ${f}\n`);
+                process.stdout.write(`\n`);
+            }
+            process.stdout.write(`Commits:\n`);
+            for (const c of commitRows) {
+                const date = c.timestamp.slice(0, 10);
+                const hash = c.hash.slice(0, 7);
+                process.stdout.write(`  ${date}  ${hash}  ${c.message}\n`);
+            }
+        }
+        finally {
+            db.close();
+        }
+    });
+}
+//# sourceMappingURL=diff-summary.js.map

package/dist/commands/diff-summary.js.map

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

package/dist/commands/docs.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function getSkillDoc(): string;
+export declare function docsCommand(): Command;

package/dist/commands/docs.js

@@ -0,0 +1,38 @@
+import { Command } from "commander";
+function write(msg) { process.stdout.write(msg); }
+export function getSkillDoc() {
+    return `## git-skill (Git History Intelligence)
+
+### Quick Reference
+| Command | Use For |
+|---------|---------|
+| \`git-skill search <query>\` | Search commit history |
+| \`git-skill timeline <path>\` | File/directory evolution |
+| \`git-skill blame <path>\` | Enhanced blame with enrichments |
+| \`git-skill trends\` | Metric trends dashboard |
+| \`git-skill hotspots\` | Files with most churn |
+| \`git-skill coupling <path>\` | Co-changed file analysis |
+| \`git-skill decisions\` | Major decision points |
+| \`git-skill experts <path>\` | Who has most context |
+| \`git-skill diff-summary <range>\` | Range summary |
+| \`git-skill why <hash>\` | Commit intent/reasoning |
+| \`git-skill regression\` | Change-point detection |
+| \`git-skill doctor\` | Health check |
+
+### Write Commands (require confirmation)
+| \`git-skill snapshot\` | Full re-index |
+| \`git-skill enrich [range]\` | Backfill LLM enrichments |
+| \`git-skill release-notes <range>\` | Generate release notes |
+| \`git-skill embed\` | Generate embeddings |
+
+### Global Flags
+- \`--json\` — structured output
+- \`--limit N\` — cap results
+- \`--since <date>\` / \`--until <date>\` — time filter`;
+}
+export function docsCommand() {
+    return new Command("docs")
+        .description("Output CLAUDE.md instruction snippet")
+        .action(() => { write(getSkillDoc() + "\n"); });
+}
+//# sourceMappingURL=docs.js.map

package/dist/commands/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,SAAS,KAAK,CAAC,GAAW,IAAU,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEhE,MAAM,UAAU,WAAW;IACzB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;wDA2B+C,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;SACvB,WAAW,CAAC,sCAAsC,CAAC;SACnD,MAAM,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function doctorCommand(): Command;

package/dist/commands/doctor.js

@@ -0,0 +1,60 @@
+import { Command } from "commander";
+import { join } from "path";
+import { existsSync, readFileSync } from "fs";
+import { isGitRepo } from "../util/git.js";
+import { hasHook } from "../util/hooks.js";
+import { hasDb, openDb } from "../util/db.js";
+function write(msg) { process.stdout.write(msg); }
+export function doctorCommand() {
+    return new Command("doctor")
+        .description("Health check — verify git-skill setup")
+        .option("--json", "Output as JSON")
+        .action((opts) => {
+        const cwd = process.cwd();
+        const checks = [];
+        // 1. Git repo
+        const isRepo = isGitRepo(cwd);
+        checks.push({ name: "git repo", status: isRepo ? "pass" : "fail", message: isRepo ? "Git repository detected" : "Not a git repository" });
+        // 2. Post-commit hook
+        const gitDir = join(cwd, ".git");
+        const hookOk = isRepo && hasHook(gitDir);
+        checks.push({ name: "post-commit hook", status: hookOk ? "pass" : "warn", message: hookOk ? "Hook installed" : "Hook not installed" });
+        // 3. Database
+        const historyDir = join(cwd, ".git-history");
+        const dbOk = hasDb(historyDir);
+        checks.push({ name: "history.db", status: dbOk ? "pass" : "fail", message: dbOk ? "Database exists" : "No database" });
+        // 4. Snapshot freshness + commit count
+        if (dbOk) {
+            const db = openDb(historyDir);
+            const meta = db.prepare("SELECT value FROM schema_meta WHERE key = 'last_snapshot'").get();
+            if (meta) {
+                const hoursAgo = (Date.now() - new Date(meta.value).getTime()) / 3600000;
+                checks.push({ name: "snapshot freshness", status: hoursAgo < 24 ? "pass" : "warn", message: `Last snapshot: ${Math.round(hoursAgo)}h ago` });
+                const count = db.prepare("SELECT COUNT(*) as c FROM commits").get().c;
+                checks.push({ name: "commit count", status: "pass", message: `${count} commits indexed` });
+            }
+            db.close();
+        }
+        // 5. .gitignore
+        const gitignorePath = join(cwd, ".gitignore");
+        if (existsSync(gitignorePath)) {
+            const hasEntry = readFileSync(gitignorePath, "utf-8").includes(".git-history");
+            checks.push({ name: ".gitignore", status: hasEntry ? "pass" : "warn", message: hasEntry ? ".git-history/ in .gitignore" : ".git-history/ not in .gitignore" });
+        }
+        // Output
+        if (opts.json) {
+            write(JSON.stringify({ checks }, null, 2) + "\n");
+            return;
+        }
+        write("\ngit-skill doctor\n");
+        write("─".repeat(40) + "\n");
+        for (const c of checks) {
+            const icon = c.status === "pass" ? "✓" : c.status === "warn" ? "!" : "✗";
+            write(`  ${icon} ${c.name}: ${c.message}\n`);
+        }
+        write("\n");
+        if (checks.some(c => c.status === "fail"))
+            process.exit(1);
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/embed.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function embedCommand(): Command;

package/dist/commands/embed.js

@@ -0,0 +1,81 @@
+import { Command } from "commander";
+import { join } from "path";
+import { openDb, hasDb } from "../util/db.js";
+import { readConfig } from "../util/config.js";
+import { generateEmbedding } from "../util/embedding.js";
+export function embedCommand() {
+    return new Command("embed")
+        .description("Generate/refresh embeddings for commit messages")
+        .option("--limit <n>", "Max commits to embed", "100")
+        .option("--force", "Re-embed commits that already have embeddings")
+        .action(async (opts) => {
+        const config = readConfig();
+        if (!config?.embedding?.enabled || !config.embedding.url) {
+            process.stdout.write("Embeddings not configured. Set embedding.enabled and embedding.url in ~/.config/git-skill/config.json\n");
+            return;
+        }
+        const historyDir = join(process.cwd(), ".git-history");
+        if (!hasDb(historyDir)) {
+            process.stdout.write("No .git-history/ database found. Run `git-skill snapshot` first.\n");
+            process.exit(1);
+        }
+        const db = openDb(historyDir);
+        try {
+            const limit = parseInt(opts.limit, 10) || 100;
+            let commits;
+            if (opts.force) {
+                commits = db
+                    .prepare("SELECT hash, message FROM commits ORDER BY timestamp DESC LIMIT ?")
+                    .all(limit);
+            }
+            else {
+                // Get commits that don't have embeddings yet
+                commits = db
+                    .prepare(`
+              SELECT c.hash, c.message
+              FROM commits c
+              LEFT JOIN embeddings e ON c.hash = e.commit_hash
+              WHERE e.commit_hash IS NULL
+              ORDER BY c.timestamp DESC
+              LIMIT ?
+            `)
+                    .all(limit);
+            }
+            if (commits.length === 0) {
+                process.stdout.write("No commits to embed.\n");
+                return;
+            }
+            process.stdout.write(`Embedding ${commits.length} commits...\n`);
+            const insertEmbed = db.prepare(`
+          INSERT OR REPLACE INTO embeddings (commit_hash, content_type, vector, model, created_at)
+          VALUES (@commitHash, @contentType, @vector, @model, @createdAt)
+        `);
+            let successCount = 0;
+            let failCount = 0;
+            for (const commit of commits) {
+                const result = await generateEmbedding(commit.message);
+                if (result) {
+                    const buf = Buffer.alloc(result.vector.length * 4);
+                    const arr = new Float32Array(result.vector);
+                    Buffer.from(arr.buffer).copy(buf);
+                    insertEmbed.run({
+                        commitHash: commit.hash,
+                        contentType: "message",
+                        vector: buf,
+                        model: result.model,
+                        createdAt: new Date().toISOString(),
+                    });
+                    successCount++;
+                }
+                else {
+                    failCount++;
+                }
+            }
+            process.stdout.write(`Done. Embedded: ${successCount}, Failed: ${failCount}\n`);
+        }
+        finally {
+            db.close();
+        }
+    });
+}
+//# sourceMappingURL=embed.js.map

package/dist/commands/embed.js.map

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

package/dist/commands/enrich.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function enrichCommand(): Command;

package/dist/commands/enrich.js

@@ -0,0 +1,148 @@
+import { Command } from "commander";
+import { join } from "path";
+import { execSync } from "child_process";
+import { openDb, hasDb } from "../util/db.js";
+import { readConfig } from "../util/config.js";
+async function callLlm(url, model, apiKey, commit) {
+    const prompt = `Analyze this git commit and respond with ONLY a JSON object (no markdown, no explanation):
+{
+  "intent": "one sentence describing what this commit does",
+  "reasoning": "why this change was likely made",
+  "category": "one of: feature, bugfix, refactor, docs, chore, test, style, perf",
+  "alternatives_considered": "brief note on alternatives (optional)",
+  "session_context": "broader context about what was being worked on (optional)"
+}
+
+Commit hash: ${commit.hash.slice(0, 7)}
+Author: ${commit.author}
+Date: ${commit.timestamp.slice(0, 10)}
+Message: ${commit.message}`;
+    const headers = { "Content-Type": "application/json" };
+    if (apiKey)
+        headers["Authorization"] = `Bearer ${apiKey}`;
+    try {
+        const response = await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({
+                model,
+                messages: [{ role: "user", content: prompt }],
+                max_tokens: 300,
+                temperature: 0,
+            }),
+        });
+        if (!response.ok)
+            return null;
+        const data = await response.json();
+        const text = data.choices?.[0]?.message?.content ?? data.content?.[0]?.text ?? "";
+        // Strip potential markdown code fences
+        const cleaned = text.replace(/^```(?:json)?\s*/i, "").replace(/\s*```\s*$/i, "").trim();
+        return JSON.parse(cleaned);
+    }
+    catch {
+        return null;
+    }
+}
+function resolveEnvVar(val) {
+    if (!val)
+        return undefined;
+    const match = val.match(/^\$\{(.+)\}$/);
+    return match ? process.env[match[1]] : val;
+}
+export function enrichCommand() {
+    return new Command("enrich")
+        .description("Backfill LLM enrichments for commit history")
+        .argument("[range]", "Git range to filter commits (e.g. v1.0..v1.1)")
+        .option("--dry-run", "Show what would be enriched without doing it")
+        .option("--limit <n>", "Max commits to enrich", "50")
+        .action(async (range, opts) => {
+        const historyDir = join(process.cwd(), ".git-history");
+        if (!hasDb(historyDir)) {
+            process.stdout.write("No .git-history/ database found. Run `git-skill snapshot` first.\n");
+            process.exit(1);
+        }
+        const db = openDb(historyDir);
+        try {
+            const limit = parseInt(opts.limit, 10) || 50;
+            // Get unenriched commits
+            let commits = db
+                .prepare(`
+            SELECT c.hash, c.message, c.author, c.timestamp
+            FROM commits c
+            LEFT JOIN enrichments e ON c.hash = e.commit_hash
+            WHERE e.commit_hash IS NULL
+            ORDER BY c.timestamp DESC
+            LIMIT ?
+          `)
+                .all(limit);
+            // Filter by range if provided
+            if (range) {
+                try {
+                    const rangeHashes = execSync(`git rev-list ${range}`, {
+                        cwd: process.cwd(),
+                        encoding: "utf-8",
+                        timeout: 10000,
+                    }).trim().split("\n").filter(Boolean);
+                    const rangeSet = new Set(rangeHashes);
+                    commits = commits.filter((c) => rangeSet.has(c.hash));
+                }
+                catch {
+                    process.stdout.write(`Warning: could not resolve range "${range}"\n`);
+                }
+            }
+            if (commits.length === 0) {
+                process.stdout.write("No commits to enrich.\n");
+                return;
+            }
+            const config = readConfig();
+            const enrichEnabled = config?.enrichment?.enabled && config.enrichment.url;
+            if (opts.dryRun) {
+                process.stdout.write(`Would enrich ${commits.length} commit${commits.length !== 1 ? "s" : ""}:\n`);
+                for (const c of commits.slice(0, 10)) {
+                    process.stdout.write(`  ${c.hash.slice(0, 7)}  ${c.message.slice(0, 60)}\n`);
+                }
+                if (commits.length > 10) {
+                    process.stdout.write(`  ... and ${commits.length - 10} more\n`);
+                }
+                return;
+            }
+            if (!enrichEnabled) {
+                process.stdout.write(`Enrichment not configured. Set enrichment.enabled and enrichment.url in ~/.config/git-skill/config.json\n`);
+                process.stdout.write(`${commits.length} commit${commits.length !== 1 ? "s" : ""} would be enriched.\n`);
+                return;
+            }
+            process.stdout.write(`Enriching ${commits.length} commits...\n`);
+            const apiKey = resolveEnvVar(config.enrichment.apiKey);
+            const insertEnrichment = db.prepare(`
+          INSERT OR REPLACE INTO enrichments
+            (commit_hash, intent, reasoning, category, alternatives_considered, session_context)
+          VALUES
+            (@commitHash, @intent, @reasoning, @category, @alternativesConsidered, @sessionContext)
+        `);
+            let successCount = 0;
+            let failCount = 0;
+            for (const commit of commits) {
+                const result = await callLlm(config.enrichment.url, config.enrichment.model, apiKey, commit);
+                if (result) {
+                    insertEnrichment.run({
+                        commitHash: commit.hash,
+                        intent: result.intent ?? null,
+                        reasoning: result.reasoning ?? null,
+                        category: result.category ?? null,
+                        alternativesConsidered: result.alternatives_considered ?? null,
+                        sessionContext: result.session_context ?? null,
+                    });
+                    successCount++;
+                }
+                else {
+                    failCount++;
+                }
+            }
+            process.stdout.write(`Done. Enriched: ${successCount}, Failed: ${failCount}\n`);
+        }
+        finally {
+            db.close();
+        }
+    });
+}
+//# sourceMappingURL=enrich.js.map

package/dist/commands/enrich.js.map

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

package/dist/commands/experts.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function expertsCommand(): Command;

package/dist/commands/experts.js

@@ -0,0 +1,55 @@
+import { Command } from "commander";
+import { openDb } from "../util/db.js";
+import { join } from "path";
+export function expertsCommand() {
+    return new Command("experts")
+        .description("Show who has most expertise in a path")
+        .argument("<path>", "File path or pattern to check expertise for")
+        .option("--limit <n>", "Max results", "10")
+        .option("--json", "Output as JSON")
+        .action((filePath, opts) => {
+        const historyDir = join(process.cwd(), ".git-history");
+        const db = openDb(historyDir);
+        try {
+            const limit = parseInt(opts.limit, 10);
+            // Normalize the path: strip trailing slash for matching
+            const normalizedPath = filePath.replace(/\/+$/, "");
+            // Match rows where file_pattern equals or starts with the given prefix
+            const pattern = `${normalizedPath}%`;
+            const sql = `
+          SELECT
+            author,
+            file_pattern,
+            commit_count,
+            last_touched,
+            expertise_score
+          FROM author_expertise
+          WHERE file_pattern LIKE ?
+          ORDER BY expertise_score DESC
+          LIMIT ?
+        `;
+            const rows = db.prepare(sql).all(pattern, limit);
+            if (opts.json) {
+                process.stdout.write(JSON.stringify(rows, null, 2) + "\n");
+                return;
+            }
+            if (rows.length === 0) {
+                process.stdout.write(`No expertise data found for: ${filePath}\n`);
+                return;
+            }
+            process.stdout.write(`Experts for: ${filePath}\n`);
+            process.stdout.write(`${"─".repeat(80)}\n`);
+            const colWidth = Math.max(...rows.map((r) => r.author.length), 10);
+            process.stdout.write(`${"Author".padEnd(colWidth)}  ${"Commits".padStart(7)}  ${"Last Touched".padStart(12)}  ${"Score".padStart(8)}\n`);
+            process.stdout.write(`${"─".repeat(colWidth + 32)}\n`);
+            for (const row of rows) {
+                const lastTouched = row.last_touched ? row.last_touched.slice(0, 10) : "unknown";
+                process.stdout.write(`${row.author.padEnd(colWidth)}  ${String(row.commit_count).padStart(7)}  ${lastTouched.padStart(12)}  ${row.expertise_score.toFixed(3).padStart(8)}\n`);
+            }
+        }
+        finally {
+            db.close();
+        }
+    });
+}
+//# sourceMappingURL=experts.js.map

package/dist/commands/experts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"experts.js","sourceRoot":"","sources":["../../src/commands/experts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC;SAC1B,WAAW,CAAC,uCAAuC,CAAC;SACpD,QAAQ,CAAC,QAAQ,EAAE,6CAA6C,CAAC;SACjE,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC;SAC1C,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,CAAC,QAAgB,EAAE,IAAuC,EAAE,EAAE;QACpE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACvD,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAEvC,wDAAwD;YACxD,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACpD,uEAAuE;YACvE,MAAM,OAAO,GAAG,GAAG,cAAc,GAAG,CAAC;YAErC,MAAM,GAAG,GAAG;;;;;;;;;;;SAWX,CAAC;YAEF,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAM7C,CAAC;YAEH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC3D,OAAO;YACT,CAAC;YAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,QAAQ,IAAI,CAAC,CAAC;gBACnE,OAAO;YACT,CAAC;YAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,QAAQ,IAAI,CAAC,CAAC;YACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CACnH,CAAC;YACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACvD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACjF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CACxJ,CAAC;YACJ,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/hotspots.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function hotspotsCommand(): Command;