claude-spp 0.1.0

package/dist/stats.js

@@ -0,0 +1,146 @@
+import { loadConfig, isSppInitialized } from "./config/loader.js";
+import { getEffectiveRatio, getCurrentMode, getStatsWindowCutoff, STATS_WINDOW_LABELS, TRACKING_MODE_LABELS, } from "./config/schema.js";
+import { getLineCountsWithWindow, getCommitInfo } from "./git/history.js";
+/**
+ * Calculate the current human work ratio from line counts
+ * Returns 1.0 if no work has been done yet (human is at 100% until Claude does something)
+ */
+export function calculateRatio(humanLines, claudeLines) {
+    const total = humanLines + claudeLines;
+    if (total === 0) {
+        return 1.0; // No work yet, human is at 100%
+    }
+    return humanLines / total;
+}
+/**
+ * Check if the human work ratio meets the target
+ */
+export function isRatioHealthy(humanLines, claudeLines, targetRatio) {
+    return calculateRatio(humanLines, claudeLines) >= targetRatio;
+}
+/**
+ * Get current SPP statistics
+ */
+export function getStats(projectPath) {
+    if (!isSppInitialized(projectPath)) {
+        return { initialized: false };
+    }
+    const config = loadConfig(projectPath);
+    const statsWindow = config.statsWindow ?? "oneWeek";
+    const trackingMode = config.trackingMode ?? "commits";
+    const targetRatio = getEffectiveRatio(config);
+    const mode = getCurrentMode(config);
+    // Get counts for ratio calculation
+    // Filter by trackingStartCommit (if set) and statsWindow cutoff
+    const statsWindowCutoff = getStatsWindowCutoff(statsWindow);
+    const lineCounts = getLineCountsWithWindow(projectPath, {
+        since: statsWindowCutoff,
+        afterCommit: config.trackingStartCommit,
+    });
+    // Calculate ratio based on tracking mode
+    const humanValue = trackingMode === "commits" ? lineCounts.humanCommits : lineCounts.humanLines;
+    const claudeValue = trackingMode === "commits" ? lineCounts.claudeCommits : lineCounts.claudeLines;
+    const currentRatio = calculateRatio(humanValue, claudeValue);
+    const ratioHealthy = isRatioHealthy(humanValue, claudeValue, targetRatio);
+    return {
+        initialized: true,
+        enabled: config.enabled,
+        mode,
+        targetRatio,
+        currentRatio,
+        ratioHealthy,
+        statsWindow,
+        trackingMode,
+        lines: lineCounts,
+    };
+}
+/**
+ * Format stats for display
+ */
+export function formatStats(stats) {
+    if (!stats.initialized) {
+        return "SPP is not initialized in this project. Run `spp init` to get started.";
+    }
+    const trackingMode = stats.trackingMode ?? "commits";
+    const target = stats.targetRatio ?? 0;
+    const ratio = stats.currentRatio ?? 1;
+    const windowLabel = stats.statsWindow ? STATS_WINDOW_LABELS[stats.statsWindow] : "All time";
+    const trackingLabel = TRACKING_MODE_LABELS[trackingMode];
+    // Get values based on tracking mode for catch-up calculation
+    const humanValue = trackingMode === "commits"
+        ? (stats.lines?.humanCommits ?? 0)
+        : (stats.lines?.humanLines ?? 0);
+    const claudeValue = trackingMode === "commits"
+        ? (stats.lines?.claudeCommits ?? 0)
+        : (stats.lines?.claudeLines ?? 0);
+    const unit = trackingMode === "commits" ? "commits" : "lines";
+    // Build status line
+    let statusLine;
+    if (claudeValue + humanValue === 0) {
+        statusLine = `✅ 🐒 No ${trackingMode} tracked yet. Go commit some code and check again.`;
+    }
+    else if (stats.ratioHealthy) {
+        statusLine = `✅ 🐒 Human coding on target. Current: ${(ratio * 100).toFixed(0)}% Target: ${(target * 100).toFixed(0)}%. Keep up the great work!`;
+    }
+    else {
+        // Calculate how many more commits/lines needed to catch up
+        const total = humanValue + claudeValue;
+        if (target >= 1) {
+            statusLine = `⚠️ 🙉 Human coding below target. Current: ${(ratio * 100).toFixed(0)}% Target: ${(target * 100).toFixed(0)}%. Claude has written ${claudeValue} ${unit}.`;
+        }
+        else {
+            const needed = Math.ceil((target * total - humanValue) / (1 - target));
+            statusLine = `⚠️ 🙉  Human coding below target. Current: ${(ratio * 100).toFixed(0)}% Target: ${(target * 100).toFixed(0)}%. Write ${needed} more ${unit} to catch up. You can do it!`;
+        }
+    }
+    // Format counts with alignment
+    const humanLinesStr = String(stats.lines?.humanLines ?? 0);
+    const claudeLinesStr = String(stats.lines?.claudeLines ?? 0);
+    const humanCommitsStr = String(stats.lines?.humanCommits ?? 0);
+    const claudeCommitsStr = String(stats.lines?.claudeCommits ?? 0);
+    const maxLines = Math.max(humanLinesStr.length, claudeLinesStr.length);
+    const maxCommits = Math.max(humanCommitsStr.length, claudeCommitsStr.length);
+    // Build aligned table (no borders)
+    const labelWidth = 10;
+    const modeValue = `${stats.mode?.name} (${stats.mode?.description})`;
+    // Determine tracking window display
+    // If trackingStartCommit is set and within the stats window, show commit info instead
+    const config = loadConfig(process.cwd());
+    let trackingValue = `${trackingLabel} (${windowLabel})`;
+    if (config.trackingStartCommit) {
+        const commitInfo = getCommitInfo(process.cwd(), config.trackingStartCommit);
+        if (commitInfo) {
+            const statsWindowCutoff = getStatsWindowCutoff(stats.statsWindow ?? "oneWeek");
+            // If no cutoff (allTime) or commit is within the window, show commit info
+            if (!statsWindowCutoff || commitInfo.date >= statsWindowCutoff) {
+                const truncatedTitle = commitInfo.title.length > 16
+                    ? commitInfo.title.substring(0, 16) + "..."
+                    : commitInfo.title;
+                const dateStr = commitInfo.date.toLocaleDateString();
+                trackingValue = `${trackingLabel} since: ${commitInfo.shortHash} "${truncatedTitle}" ${dateStr}`;
+            }
+        }
+    }
+    const lines = [
+        "",
+        statusLine,
+        "",
+        `  ${"Mode".padEnd(labelWidth)} ${modeValue}`,
+        `  ${"Tracking".padEnd(labelWidth)} ${trackingValue}`,
+        "",
+        `  ${"Human".padEnd(labelWidth)} ${humanCommitsStr.padStart(maxCommits)} commits   ${humanLinesStr.padStart(maxLines)} lines`,
+        `  ${"Claude".padEnd(labelWidth)} ${claudeCommitsStr.padStart(maxCommits)} commits   ${claudeLinesStr.padStart(maxLines)} lines`,
+        "",
+    ];
+    if (!stats.enabled) {
+        const config = loadConfig(process.cwd());
+        let pauseMsg = "SPP is disabled";
+        if (config.pausedUntil) {
+            const pausedUntilDate = new Date(config.pausedUntil);
+            pauseMsg = `⏸️  SPP enforcement is paused until ${pausedUntilDate.toLocaleString()}. Claude may write code freely. Run 'spp resume' to unpause.`;
+        }
+        lines.splice(1, 0, pauseMsg, "");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=stats.js.map

package/dist/stats.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "claude-spp",
+  "version": "0.1.0",
+  "description": "Claude Code plugin for maintaining programming skills through guided learning",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "spp": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "learning",
+    "teaching",
+    "programming"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^14.0.2",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  }
+}