cc-proficiency 0.2.3 → 0.2.5

package/dist/cli/services/publishing.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeAndPush = mergeAndPush;
+exports.pushToGist = pushToGist;
+const svg_js_1 = require("../../renderer/svg.js");
+const local_store_js_1 = require("../../store/local-store.js");
+const uploader_js_1 = require("../../gist/uploader.js");
+const remote_store_js_1 = require("../../store/remote-store.js");
+const achievements_js_1 = require("../../store/achievements.js");
+const public_profile_js_1 = require("../../store/public-profile.js");
+const locale_js_1 = require("../utils/locale.js");
+/**
+ * Read remote store, merge local data, check achievements, re-render badge,
+ * and push SVG + JSON atomically. Used by both cmdPush and cmdProcess.
+ */
+function mergeAndPush(store, result, gistId, username, verbose = false) {
+    const remoteJson = (0, uploader_js_1.readGistFile)(gistId, "cc-proficiency.json");
+    let remote = remoteJson ? (0, remote_store_js_1.parseRemoteStore)(remoteJson) : null;
+    if (!remote)
+        remote = (0, remote_store_js_1.emptyRemoteStore)(username);
+    const avgHours = result.features.totalHours / Math.max(store.processedSessionIds.length, 1);
+    const localSessions = store.processedSessionIds.map((id) => {
+        const snap = store.snapshots.find((s) => s.sessionId === id);
+        return {
+            id,
+            date: snap ? (0, remote_store_js_1.getUTCDate)(snap.timestamp) : new Date().toISOString().slice(0, 10),
+            hours: avgHours,
+        };
+    });
+    const merged = (0, remote_store_js_1.mergeIntoRemote)(remote, localSessions, result);
+    const totals = (0, remote_store_js_1.getTotalStats)(merged);
+    const cfg = (0, local_store_js_1.loadConfig)();
+    const ctx = {
+        totalSessions: totals.sessions,
+        totalHours: totals.hours,
+        totalProjects: totals.projects,
+        domains: merged.domains,
+        streak: merged.streak,
+        features: result.features,
+        activeDates: merged.streak.activeDates,
+        leaderboard: cfg.leaderboard ?? false,
+    };
+    const newAchievements = (0, achievements_js_1.checkAchievements)(ctx, merged.achievements.map((a) => a.id));
+    for (const id of newAchievements) {
+        merged.achievements.push({ id, unlockedAt: new Date().toISOString() });
+        const def = (0, achievements_js_1.getAchievementDef)(id);
+        if (def && verbose)
+            console.log(`  \uD83C\uDFC6 Achievement unlocked: ${def.icon} ${def.name}`);
+    }
+    const thisWeek = (0, remote_store_js_1.getWeekMonday)(new Date().toISOString());
+    const localTrend = {
+        week: thisWeek,
+        domains: Object.fromEntries(result.domains.map((d) => [d.id, d.score])),
+        hours: result.features.totalHours,
+        sessions: result.sessionCount,
+    };
+    merged.weeklyTrends = (0, remote_store_js_1.mergeWeeklyTrends)(merged.weeklyTrends, [localTrend]);
+    result.streak = merged.streak.current;
+    result.achievementCount = merged.achievements.length;
+    const finalSvg = (0, svg_js_1.renderBadge)(result, (0, locale_js_1.getConfigLocale)());
+    (0, local_store_js_1.saveBadge)(finalSvg);
+    const pushResult = (0, uploader_js_1.pushGistFiles)(gistId, {
+        "cc-proficiency.svg": finalSvg,
+        "cc-proficiency.json": JSON.stringify(merged, null, 2),
+    });
+    if (!pushResult.success) {
+        return { success: false, error: pushResult.error };
+    }
+    if (verbose) {
+        const rawUrl = (0, uploader_js_1.getGistRawUrl)(username, gistId);
+        console.log("\u2713 Badge + data pushed to Gist");
+        console.log(`  ${rawUrl}`);
+        console.log(`  ${totals.sessions} sessions \u00B7 ${totals.hours.toFixed(1)}h \u00B7 ${merged.achievements.length} achievements \u00B7 \uD83D\uDD25 ${merged.streak.current}d streak`);
+    }
+    // Auto-update public profile if leaderboard is enabled
+    if (cfg.leaderboard && cfg.publicGistId) {
+        const publicProfile = (0, public_profile_js_1.buildPublicProfile)(merged);
+        const publicResult = (0, uploader_js_1.pushGistFiles)(cfg.publicGistId, {
+            "cc-proficiency-public.json": JSON.stringify(publicProfile, null, 2),
+        });
+        if (!publicResult.success) {
+            (0, local_store_js_1.logError)(`Public profile update failed: ${publicResult.error}`);
+        }
+    }
+    return { success: true, merged, totals };
+}
+function pushToGist() {
+    const config = (0, local_store_js_1.loadConfig)();
+    const store = (0, local_store_js_1.loadStore)();
+    if (!store.lastResult) {
+        console.log("No analysis data. Run 'cc-proficiency analyze' first.");
+        return;
+    }
+    const svg = (0, svg_js_1.renderBadge)(store.lastResult, (0, locale_js_1.getConfigLocale)());
+    (0, local_store_js_1.saveBadge)(svg);
+    if (!(0, uploader_js_1.isGhAuthenticated)() || !config.gistId) {
+        if (!(0, uploader_js_1.isGhAuthenticated)()) {
+            console.log("\u26A0 GitHub CLI not authenticated.");
+            console.log("To enable: gh auth login && cc-proficiency init");
+        }
+        if (!config.gistId) {
+            console.log("No Gist configured. Run 'cc-proficiency init' first.");
+        }
+        console.log("Badge saved locally to: " + (0, local_store_js_1.getBadgePath)());
+        return;
+    }
+    const result = mergeAndPush(store, store.lastResult, config.gistId, config.username ?? "unknown", true);
+    if (!result.success) {
+        console.log(`\u2717 Push failed: ${result.error}`);
+    }
+}
+//# sourceMappingURL=publishing.js.map

package/dist/cli/services/publishing.js.map

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

package/dist/cli/services/sessions.d.ts

@@ -0,0 +1,11 @@
+import { computeProficiency } from "../../scoring/engine.js";
+import { loadStore } from "../../store/local-store.js";
+import type { ParsedSession } from "../../types.js";
+import type { ConfigSignals } from "../../parsers/config-parser.js";
+export declare function gatherData(full: boolean): Promise<{
+    sessions: ParsedSession[];
+    config: ConfigSignals;
+}>;
+export declare function gatherAllProcessedSessions(store: ReturnType<typeof loadStore>): Promise<ParsedSession[]>;
+export declare function runAnalysis(sessions: ParsedSession[], config: ConfigSignals, username: string): ReturnType<typeof computeProficiency>;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/cli/services/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/cli/services/sessions.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAsB,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAIpE,wBAAsB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC,CAmC7G;AAED,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAuB9G;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,aAAa,EAAE,EACzB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,GACf,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAGvC"}

package/dist/cli/services/sessions.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gatherData = gatherData;
+exports.gatherAllProcessedSessions = gatherAllProcessedSessions;
+exports.runAnalysis = runAnalysis;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+const transcript_parser_js_1 = require("../../parsers/transcript-parser.js");
+const config_parser_js_1 = require("../../parsers/config-parser.js");
+const engine_js_1 = require("../../scoring/engine.js");
+const local_store_js_1 = require("../../store/local-store.js");
+const CLAUDE_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude");
+async function gatherData(full) {
+    const realStore = (0, local_store_js_1.loadStore)();
+    const knownCwds = [...new Set([process.cwd(), ...(realStore.knownProjectCwds ?? [])])];
+    const config = (0, config_parser_js_1.parseClaudeConfig)(knownCwds);
+    const sessions = [];
+    const store = full ? { processedSessionIds: [] } : realStore;
+    const projectsDir = (0, node_path_1.join)(CLAUDE_DIR, "projects");
+    if (!(0, node_fs_1.existsSync)(projectsDir))
+        return { sessions, config };
+    const projects = (0, node_fs_1.readdirSync)(projectsDir);
+    for (const proj of projects) {
+        const projDir = (0, node_path_1.join)(projectsDir, proj);
+        try {
+            const files = (0, node_fs_1.readdirSync)(projDir).filter((f) => f.endsWith(".jsonl"));
+            for (const file of files) {
+                const sessionId = file.replace(".jsonl", "");
+                if (!full && (0, local_store_js_1.isSessionProcessed)(store, sessionId)) {
+                    continue;
+                }
+                try {
+                    const session = await (0, transcript_parser_js_1.parseTranscript)((0, node_path_1.join)(projDir, file));
+                    if (session.events.length > 0) {
+                        sessions.push(session);
+                    }
+                }
+                catch {
+                    // skip unreadable files
+                }
+            }
+        }
+        catch {
+            // skip unreadable project dirs
+        }
+    }
+    return { sessions, config };
+}
+async function gatherAllProcessedSessions(store) {
+    const sessions = [];
+    const projectsDir = (0, node_path_1.join)(CLAUDE_DIR, "projects");
+    if (!(0, node_fs_1.existsSync)(projectsDir))
+        return sessions;
+    const projects = (0, node_fs_1.readdirSync)(projectsDir);
+    for (const proj of projects) {
+        const projDir = (0, node_path_1.join)(projectsDir, proj);
+        try {
+            const files = (0, node_fs_1.readdirSync)(projDir).filter((f) => f.endsWith(".jsonl"));
+            for (const file of files) {
+                const sessionId = file.replace(".jsonl", "");
+                if (store.processedSessionIds.includes(sessionId)) {
+                    try {
+                        const session = await (0, transcript_parser_js_1.parseTranscript)((0, node_path_1.join)(projDir, file));
+                        if (session.events.length > 0)
+                            sessions.push(session);
+                    }
+                    catch { /* skip */ }
+                }
+            }
+        }
+        catch { /* skip */ }
+    }
+    return sessions;
+}
+function runAnalysis(sessions, config, username) {
+    const setupChecklist = (0, config_parser_js_1.buildSetupChecklist)(config);
+    return (0, engine_js_1.computeProficiency)(sessions, config, username, setupChecklist);
+}
+//# sourceMappingURL=sessions.js.map

package/dist/cli/services/sessions.js.map

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

package/dist/cli/utils/formatting.d.ts

@@ -0,0 +1,5 @@
+import type { ProficiencyResult, SetupChecklist } from "../../types.js";
+export declare function progressBar(score: number, width: number): string;
+export declare function printResult(result: ProficiencyResult): void;
+export declare function printSetupChecklist(cl: SetupChecklist): void;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/cli/utils/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/formatting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAExE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CA4C3D;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAgB5D"}

package/dist/cli/utils/formatting.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.progressBar = progressBar;
+exports.printResult = printResult;
+exports.printSetupChecklist = printSetupChecklist;
+function progressBar(score, width) {
+    const filled = Math.round((score / 100) * width);
+    const empty = width - filled;
+    return "\u2588".repeat(filled) + "\u2591".repeat(empty);
+}
+function printResult(result) {
+    console.log(`  Claude Code Proficiency \u2014 @${result.username}`);
+    console.log("  " + "\u2500".repeat(40));
+    if (result.phase === "calibrating") {
+        const needed = Math.max(0, 3 - result.sessionCount);
+        console.log(`  \u23F3 Calibrating... (${result.sessionCount} sessions, need ${needed} more)`);
+        console.log("");
+        printSetupChecklist(result.setupChecklist);
+        return;
+    }
+    for (const d of result.domains) {
+        const bar = progressBar(d.score, 20);
+        const conf = d.confidence === "high" ? "\u25CF" : d.confidence === "medium" ? "\u25D0" : "\u25CB";
+        console.log(`  ${d.label.padEnd(14)} ${bar}  ${String(d.score).padStart(3)}  ${conf}`);
+    }
+    console.log("  " + "\u2500".repeat(40));
+    const f = result.features;
+    if (f.hooks.length > 0) {
+        const shown = f.hooks.slice(0, 3).map((h) => `${h.name} (${h.count}x)`).join(", ");
+        const more = f.hooks.length > 3 ? ` +${f.hooks.length - 3}` : "";
+        console.log(`  Hooks   ${shown}${more}`);
+    }
+    if (f.skills.length > 0) {
+        const shown = f.skills.slice(0, 3).map((s) => `${s.name} (${s.count}x)`).join(", ");
+        const more = f.skills.length > 3 ? ` +${f.skills.length - 3}` : "";
+        console.log(`  Skills  ${shown}${more}`);
+    }
+    if (f.mcpServers.length > 0) {
+        console.log(`  MCP     ${f.mcpServers.join(", ")}`);
+    }
+    const toolSummary = f.topTools.slice(0, 4).map((t) => `${t.name} ${t.count}`).join(" \u00B7 ");
+    console.log(`  Tools   ${toolSummary} (+${f.uniqueToolCount - Math.min(4, f.topTools.length)} more)`);
+    console.log("  " + "\u2500".repeat(40));
+    const hrs = result.features.totalHours >= 1000 ? (result.features.totalHours / 1000).toFixed(1) + "kh" : result.features.totalHours + "h";
+    console.log(`  ${hrs} \u00B7 ${result.sessionCount} sessions \u00B7 ${result.projectCount} projects`);
+    if (result.phase === "early") {
+        console.log(`  (early results \u2014 stabilizes at 10 sessions)`);
+    }
+}
+function printSetupChecklist(cl) {
+    const items = [
+        ["CLAUDE.md", cl.hasClaudeMd],
+        ["Hooks", cl.hasHooks],
+        ["Plugins", cl.hasPlugins],
+        ["MCP Servers", cl.hasMcpServers],
+        ["Memory", cl.hasMemory],
+        ["Rules", cl.hasRules],
+        ["Agents", cl.hasAgents],
+        ["Skills", cl.hasSkills],
+    ];
+    console.log("  Setup:");
+    for (const [label, ok] of items) {
+        console.log(`    ${ok ? "\u2713" : "\u2717"} ${label}`);
+    }
+}
+//# sourceMappingURL=formatting.js.map

package/dist/cli/utils/formatting.js.map

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

package/dist/cli/utils/locale.d.ts

@@ -0,0 +1,3 @@
+import { type Locale } from "../../i18n/locales.js";
+export declare function getConfigLocale(): Locale;
+//# sourceMappingURL=locale.d.ts.map

package/dist/cli/utils/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/locale.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAElE,wBAAgB,eAAe,IAAI,MAAM,CAKxC"}

package/dist/cli/utils/locale.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfigLocale = getConfigLocale;
+const local_store_js_1 = require("../../store/local-store.js");
+const locales_js_1 = require("../../i18n/locales.js");
+function getConfigLocale() {
+    const config = (0, local_store_js_1.loadConfig)();
+    if (config.locale === "zh-CN")
+        return "zh-CN";
+    if (config.locale === "en")
+        return "en";
+    return (0, locales_js_1.detectLocale)();
+}
+//# sourceMappingURL=locale.js.map

package/dist/cli/utils/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.js","sourceRoot":"","sources":["../../../src/cli/utils/locale.ts"],"names":[],"mappings":";;AAGA,0CAKC;AARD,+DAAwD;AACxD,sDAAkE;AAElE,SAAgB,eAAe;IAC7B,MAAM,MAAM,GAAG,IAAA,2BAAU,GAAE,CAAC;IAC5B,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,IAAA,yBAAY,GAAE,CAAC;AACxB,CAAC"}

package/dist/cli/utils/update-check.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Check for updates and print a notice if a newer version is available.
+ * Non-blocking: fetches in background, resolves quickly from cache.
+ * Call after CLI output is complete.
+ */
+export declare function checkForUpdates(currentVersion: string): Promise<void>;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/cli/utils/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/update-check.ts"],"names":[],"mappings":"AAwFA;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B3E"}

package/dist/cli/utils/update-check.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkForUpdates = checkForUpdates;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+const node_https_1 = require("node:https");
+const queue_js_1 = require("../../store/queue.js");
+const STORE_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), ".cc-proficiency");
+const CACHE_FILE = (0, node_path_1.join)(STORE_DIR, "version-check.json");
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const FETCH_TIMEOUT_MS = 3000; // 3 seconds
+function loadCache() {
+    if (!(0, node_fs_1.existsSync)(CACHE_FILE))
+        return null;
+    try {
+        return JSON.parse((0, node_fs_1.readFileSync)(CACHE_FILE, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function saveCache(cache) {
+    (0, queue_js_1.ensureStoreDir)();
+    try {
+        (0, node_fs_1.writeFileSync)(CACHE_FILE, JSON.stringify(cache), "utf-8");
+    }
+    catch {
+        // non-critical
+    }
+}
+function compareVersions(a, b) {
+    // Strip prerelease/build metadata, compare major.minor.patch only
+    const pa = a.split("-")[0].split(".").map(Number);
+    const pb = b.split("-")[0].split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        const va = pa[i] ?? 0;
+        const vb = pb[i] ?? 0;
+        if (isNaN(va) || isNaN(vb))
+            return 0; // can't compare, skip
+        if (va !== vb)
+            return va - vb;
+    }
+    return 0;
+}
+function fetchLatestVersion() {
+    return new Promise((resolve) => {
+        let resolved = false;
+        const done = (val) => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearTimeout(timer);
+            resolve(val);
+        };
+        const timer = setTimeout(() => {
+            req.destroy();
+            done(null);
+        }, FETCH_TIMEOUT_MS);
+        const req = (0, node_https_1.get)("https://registry.npmjs.org/cc-proficiency/latest", {
+            headers: { "Accept": "application/json" },
+            timeout: FETCH_TIMEOUT_MS,
+        }, (res) => {
+            if (res.statusCode !== 200) {
+                res.resume();
+                done(null);
+                return;
+            }
+            let data = "";
+            res.on("data", (chunk) => { data += chunk.toString(); });
+            res.on("end", () => {
+                try {
+                    const pkg = JSON.parse(data);
+                    done(typeof pkg.version === "string" ? pkg.version : null);
+                }
+                catch {
+                    done(null);
+                }
+            });
+        });
+        req.on("error", () => done(null));
+        req.on("timeout", () => { req.destroy(); done(null); });
+    });
+}
+/**
+ * Check for updates and print a notice if a newer version is available.
+ * Non-blocking: fetches in background, resolves quickly from cache.
+ * Call after CLI output is complete.
+ */
+async function checkForUpdates(currentVersion) {
+    // Skip in non-interactive contexts
+    if (process.env.CC_PROFICIENCY_NO_UPDATE_CHECK === "1")
+        return;
+    if (process.env.CI)
+        return;
+    if (!process.stdout.isTTY)
+        return;
+    const cache = loadCache();
+    // Use cache if fresh
+    if (cache) {
+        const age = Date.now() - new Date(cache.checkedAt).getTime();
+        if (age >= 0 && age < CHECK_INTERVAL_MS) {
+            if (compareVersions(cache.latestVersion, currentVersion) > 0) {
+                printNotice(currentVersion, cache.latestVersion);
+            }
+            return;
+        }
+    }
+    // Fetch in background — don't block
+    const latest = await fetchLatestVersion();
+    if (!latest)
+        return;
+    saveCache({ latestVersion: latest, checkedAt: new Date().toISOString() });
+    if (compareVersions(latest, currentVersion) > 0) {
+        printNotice(currentVersion, latest);
+    }
+}
+function printNotice(current, latest) {
+    console.log(`\n  Update available: v${current} \u2192 v${latest}`);
+    console.log("  Run: npm update -g cc-proficiency\n");
+}
+//# sourceMappingURL=update-check.js.map

package/dist/cli/utils/update-check.js.map

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

package/dist/gist/registry.d.ts

@@ -0,0 +1,26 @@
+import type { LeaderboardRegistry, PublicProfile } from "../types.js";
+/**
+ * Read the leaderboard registry from the owner's public gist.
+ */
+export declare function readRegistry(): LeaderboardRegistry | null;
+/**
+ * Read a public profile from a user's public gist.
+ */
+export declare function readPublicProfileFromGist(publicGistId: string): PublicProfile | null;
+/**
+ * Open a GitHub Issue to join the leaderboard.
+ */
+export declare function openJoinIssue(username: string, publicGistId: string): {
+    success: boolean;
+    issueUrl?: string;
+    error?: string;
+};
+/**
+ * Open a GitHub Issue to leave the leaderboard.
+ */
+export declare function openLeaveIssue(username: string): {
+    success: boolean;
+    issueUrl?: string;
+    error?: string;
+};
+//# sourceMappingURL=registry.d.ts.map

package/dist/gist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/gist/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAUtE;;GAEG;AACH,wBAAgB,YAAY,IAAI,mBAAmB,GAAG,IAAI,CAUzD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAIpF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA0BzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,GACf;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAyBzD"}

package/dist/gist/registry.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readRegistry = readRegistry;
+exports.readPublicProfileFromGist = readPublicProfileFromGist;
+exports.openJoinIssue = openJoinIssue;
+exports.openLeaveIssue = openLeaveIssue;
+const node_child_process_1 = require("node:child_process");
+const uploader_js_1 = require("./uploader.js");
+const public_profile_js_1 = require("../store/public-profile.js");
+// Must match vars.REGISTRY_GIST_ID in .github/workflows/leaderboard-registration.yml
+const REGISTRY_GIST_ID = "ce1b434355768cfa36c68e5dbe5aa982";
+const BOARD_REPO = "Z-M-Huang/cc-proficiency";
+// Known limitation: public profiles are trust-based. A user could handcraft a gist
+// with fake scores. Server-side verification or signed profiles would be needed to
+// prevent this. Acceptable for v1 community leaderboard.
+/**
+ * Read the leaderboard registry from the owner's public gist.
+ */
+function readRegistry() {
+    const json = (0, uploader_js_1.readGistFile)(REGISTRY_GIST_ID, "cc-proficiency-registry.json");
+    if (!json)
+        return null;
+    try {
+        const data = JSON.parse(json);
+        if (data?.version !== "1.0.0" || !Array.isArray(data.entries))
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read a public profile from a user's public gist.
+ */
+function readPublicProfileFromGist(publicGistId) {
+    const json = (0, uploader_js_1.readGistFile)(publicGistId, "cc-proficiency-public.json");
+    if (!json)
+        return null;
+    return (0, public_profile_js_1.parsePublicProfile)(json);
+}
+/**
+ * Open a GitHub Issue to join the leaderboard.
+ */
+function openJoinIssue(username, publicGistId) {
+    try {
+        const title = `[leaderboard] join @${username}`;
+        const body = [
+            `**Username:** ${username}`,
+            `**Public Gist ID:** ${publicGistId}`,
+            "",
+            "This issue was automatically created by `cc-proficiency share`.",
+            "A GitHub Action will validate and add this entry to the leaderboard registry.",
+        ].join("\n");
+        const result = (0, node_child_process_1.execFileSync)("gh", [
+            "issue", "create",
+            "--repo", BOARD_REPO,
+            "--title", title,
+            "--body", body,
+            "--label", "leaderboard",
+        ], {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+            timeout: 30_000,
+        });
+        return { success: true, issueUrl: result.trim() };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+/**
+ * Open a GitHub Issue to leave the leaderboard.
+ */
+function openLeaveIssue(username) {
+    try {
+        const title = `[leaderboard] leave @${username}`;
+        const body = [
+            `**Username:** ${username}`,
+            "",
+            "This issue was automatically created by `cc-proficiency share --remove`.",
+            "A GitHub Action will remove this entry from the leaderboard registry.",
+        ].join("\n");
+        const result = (0, node_child_process_1.execFileSync)("gh", [
+            "issue", "create",
+            "--repo", BOARD_REPO,
+            "--title", title,
+            "--body", body,
+            "--label", "leaderboard",
+        ], {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+            timeout: 30_000,
+        });
+        return { success: true, issueUrl: result.trim() };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/gist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/gist/registry.ts"],"names":[],"mappings":";;AAgBA,oCAUC;AAKD,8DAIC;AAKD,sCA6BC;AAKD,wCA2BC;AArGD,2DAAkD;AAClD,+CAA6C;AAC7C,kEAAgE;AAGhE,qFAAqF;AACrF,MAAM,gBAAgB,GAAG,kCAAkC,CAAC;AAC5D,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAE9C,mFAAmF;AACnF,mFAAmF;AACnF,yDAAyD;AAEzD;;GAEG;AACH,SAAgB,YAAY;IAC1B,MAAM,IAAI,GAAG,IAAA,0BAAY,EAAC,gBAAgB,EAAE,8BAA8B,CAAC,CAAC;IAC5E,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,IAAI,EAAE,OAAO,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3E,OAAO,IAA2B,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CAAC,YAAoB;IAC5D,MAAM,IAAI,GAAG,IAAA,0BAAY,EAAC,YAAY,EAAE,4BAA4B,CAAC,CAAC;IACtE,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,IAAA,sCAAkB,EAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAC3B,QAAgB,EAChB,YAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,uBAAuB,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG;YACX,iBAAiB,QAAQ,EAAE;YAC3B,uBAAuB,YAAY,EAAE;YACrC,EAAE;YACF,iEAAiE;YACjE,+EAA+E;SAChF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,IAAA,iCAAY,EAAC,IAAI,EAAE;YAChC,OAAO,EAAE,QAAQ;YACjB,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,aAAa;SACzB,EAAE;YACD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAChD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAC5B,QAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,wBAAwB,QAAQ,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG;YACX,iBAAiB,QAAQ,EAAE;YAC3B,EAAE;YACF,0EAA0E;YAC1E,uEAAuE;SACxE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,IAAA,iCAAY,EAAC,IAAI,EAAE;YAChC,OAAO,EAAE,QAAQ;YACjB,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,aAAa;SACzB,EAAE;YACD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/gist/uploader.d.ts

@@ -30,7 +30,15 @@ export declare function findExistingGist(): string | null;
 /**
  * Push multiple files to a Gist atomically via gh api PATCH.
  */
-export declare function pushGistFiles(gistId: string, files: Record<string, string>): GistResult;
+export declare function pushGistFiles(gistId: string, files: Record<string, string | null>): GistResult;
+/**
+ * Create a new public Gist with a public profile JSON.
+ */
+export declare function createPublicGist(content: string): GistResult;
+/**
+ * Delete a Gist by ID.
+ */
+export declare function deleteGist(gistId: string): GistResult;
 /**
  * Get the raw URL for a gist file.
  */