claude-spp 0.1.0

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matthew Olson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,147 @@
+# Simian Programmer Plugin (SPP) for Claude
+
+>  If you’re learning how to play the guitar, you can watch as many YouTube videos as you want, you’re not going to learn the guitar. You have to put your fingers on the strings to actually learn the motions. I think there is a parallel here to programming, where programming has to be learned in part by the actual typing.
+
+-[DHH on Lex Friedman](youtube.com/watch?v=vagyIcmIGOQ&t=5408)
+
+## How it works
+
+SPP is a Claude plugin that encourages you to keep writing code. It is configured per-project, and provides 5 modes:
+
+| Mode | Description |
+|------|-------------|
+| Lazy monkey | 100% AI coding |
+| Curious monkey | 10% human / 90% AI |
+| Clever monkey |  25% human / 75% AI |
+| Wise monkey | 50% human / 50% AI |
+| Crazy monkey | 100% human coding |
+
+### Code ratio tracking 
+The human/AI coding ratio is calculated by looking at commits that you have authored. Commits with "**Co-Authored-By: Claude**" in the message are counted as Claude commits, those without  are counted as human commits. 
+
+There is an option to track by lines of code (added+deleted) if you wish, but I find that tracking by commit and practicing good git hygeine and using small, well scoped commits works best. 
+
+Tracking starts from the latest commit when the plugin is initialized, so that only new work is counted. It looks back over a time window (default 7 days). 
+
+## Ratio enforcement and the help human code skill
+
+When the ratio of human/AI commits becomes too low, Claude is **blocked** from writing code. Instead, it uses a "help human code" skill to help **you** write the code, and then reviews your work. This skill instructs Claude to provide you with a high level over view of the task, code pointers, and test instructions. Example:
+
+```
+❯ Some tests are failing, can you fix them?
+
+⏺ I'd be happy to help, but I'm currently blocked from writing code due to SPP restrictions -
+your human coding ratio is below the 100% target. Let me use the spp-human-task skill to guide
+you through fixing the tests yourself.
+...
+---
+  High Level Goal
+
+  Fix 15 failing tests across 3 test files. The issues are:
+
+  1. tests/config.test.ts (2 failures) - Test expectations don't match the actual MODES array
+  2. tests/hooks.test.ts (6 failures) - Tests use wrong interface for calling preToolUseHook
+  3. tests/init.test.ts (7 failures) - Tests timeout because initializeStp prompts for user input via stdin
+
+  ---
+  File 1: tests/config.test.ts
+
+  Problem: The tests expect 6 modes with different ratios, but the actual MODES array only has 5 modes with different values.
+
+  Lines 97-109 need to be updated:
+
+  Fix 1: Line 98-99 - "returns custom ratio when set"
+
+  The test tries to set humanWorkRatio on the config, but Config doesn't have a humanWorkRatio field. The getEffectiveRatio function only looks at the mode. This test is invalid - you should either:
+  - Remove this test entirely, OR
+  - Change it to test setting a different mode
+
+  (etc...)
+
+  ---
+  Test Your Changes
+
+  After making the fixes, run:
+  npm test
+
+  All tests should pass.
+
+  ---
+  Would you like more detailed guidance on any of these fixes,
+  or do you want me to review your code after you make the changes?
+```
+
+After you make the fix, you can ask claude to review and commit your changes.
+
+### Pausing, resuming, and reseting
+
+Sometimes you gotta do what you gotta do.
+
+You may **pause** SPP to allow Claude to freely write code (`spp pause`). This pause expires after 24 hours, or you can unpause with `spp resume`.
+
+If you get way behind on your coding and want to declare bankruptcy, you can reset tracking from the current commit using:
+
+```bash
+spp reset
+```
+
+Don't feel bad, no one is keeping score!
+
+### git post commit hook shows stats
+
+After you commit, a post-commit hook prints out current stats:
+```bash
+% git commit -m "Adjust some wording"
+
+✅ 🐒 Human coding on target. Current: 100% Target: 25%. Keep up the great work!
+
+  Mode       Clever monkey (75% AI / 25% human)
+  Tracking   Commits since a4e1e8c "remove .spp" 1/22/2026
+
+  Human      1 commits   10 lines
+  Claude     0 commits    0 lines
+```
+
+
+### Getting started
+
+1. Add the plugin in claude:
+```bash
+# Start claude and run:
+/plugin marketplace add mlolson/claude-spp
+/plugin install spp@mlolson
+```
+
+2. Install the CLI globally
+```bash
+npm i -g git+https://github.com/mlolson/claude-spp.git
+```
+
+3. Initialize SPP in your project:
+```bash
+cd /path/to/your/project
+spp init
+```
+
+4. Bonus step: Turn off AI suggestions in your IDE. (It kind of of defeats the purpose)
+
+
+### CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `spp help` | Print help message
+| `spp init` | Initialize SPP in the current project |
+| `spp stats` | Show current ratio and statistics |
+| `spp modes` | List all available modes |
+| `spp mode [n]` | Show or change the current mode (1-5) |
+| `spp pause` | Pause enforcement for 24 hours |
+| `spp resume` | Resume enforcement immediately |
+| `spp reset` | Reset tracking to start from current commit |
+
+### Claude slash commands
+
+| Command | Description |
+|---------|-------------|
+| `/spp:stats` | Show current coding stats |
+| `/spp:help` | Get help with the CLI interface |

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { runPreToolUseHook } from "./hooks/pre-tool-use.js";
+import { generateSystemPrompt } from "./hooks/system-prompt.js";
+import { initializeSpp, isFullyInitialized, promptUser } from "./init.js";
+import { getHeadCommitHash } from "./git/history.js";
+import { loadConfig, saveConfig } from "./config/loader.js";
+import { getCurrentMode, getModeByNumber, getModeByName, MODES } from "./config/schema.js";
+import { getStats, formatStats } from "./stats.js";
+function getModesExplanation() {
+    const config = loadConfig(process.cwd());
+    const currentMode = getCurrentMode(config);
+    const lines = ["Coding modes:"];
+    for (const mode of MODES) {
+        const marker = mode.number === currentMode.number ? " <-- current" : "";
+        lines.push(`  ${mode.number}. ${mode.name} - ${mode.description}${marker}`);
+    }
+    return lines.join("\n");
+}
+const program = new Command();
+program
+    .name("spp")
+    .description("SPP CLI - Simian Programmer Plugin for Claude - https://github.com/mlolson/claude-spp")
+    .version("0.1.0");
+// User commands
+program
+    .command("init")
+    .argument("[mode]", "mode number 1-6")
+    .description("Initialize SPP")
+    .action(async (mode) => {
+    const modeNum = mode ? parseInt(mode, 10) : undefined;
+    const config = await initializeSpp(process.cwd(), modeNum);
+    saveConfig(process.cwd(), config);
+    const currentMode = getCurrentMode(config);
+    console.log("");
+    console.log(`✅ SPP initialized with mode ${currentMode.number}: ${currentMode.name}`);
+    console.log(`${currentMode.description}`);
+    console.log(`Install directory: .claude-spp/`);
+    console.log(`Git hook: .git/hooks/post-commit\n`);
+    console.log("Analyzing repo...");
+    const stats = getStats(process.cwd());
+    console.log(formatStats(stats));
+});
+program
+    .command("mode")
+    .argument("[value]", "mode number or name")
+    .description("Show or change the current mode")
+    .action(async (value) => {
+    if (!isFullyInitialized(process.cwd())) {
+        console.error("❌ SPP not initialized. Run: spp init");
+        process.exit(1);
+    }
+    const config = loadConfig(process.cwd());
+    // If no argument, show current mode
+    if (!value) {
+        const currentMode = getModeByNumber(config.mode);
+        if (!currentMode) {
+            console.log("Current mode: none");
+        }
+        else {
+            console.log(`Current mode: ${currentMode.number}, ${currentMode.name}, ${currentMode.description}`);
+        }
+        return;
+    }
+    // Try to parse as number first
+    let selectedMode = getModeByNumber(parseInt(value, 10));
+    // If not a number, try by name
+    if (!selectedMode) {
+        selectedMode = getModeByName(value);
+    }
+    if (!selectedMode) {
+        throw Error(`❌ Unknown mode: ${value}  Use a number 1-6 or a mode name`);
+    }
+    // Update config
+    config.mode = selectedMode.number;
+    saveConfig(process.cwd(), config);
+    console.log(`✅ Mode changed to ${selectedMode.number}: ${selectedMode.name}`);
+    console.log(`   ${selectedMode.description}`);
+});
+program
+    .command("modes")
+    .description("List available modes")
+    .action(() => {
+    if (!isFullyInitialized(process.cwd())) {
+        console.error("❌ SPP not initialized. Run: spp init");
+        process.exit(1);
+    }
+    console.log(getModesExplanation());
+    console.log("To change mode: spp mode <number>");
+});
+program
+    .command("stats")
+    .description("Show SPP status and statistics")
+    .action(() => {
+    const stats = getStats(process.cwd());
+    console.log(formatStats(stats));
+});
+program
+    .command("pause")
+    .description("Pause SPP for 24 hours (Claude writes freely)")
+    .action(() => {
+    if (!isFullyInitialized(process.cwd())) {
+        console.error("❌ SPP not initialized. Run: spp init");
+        process.exit(1);
+    }
+    const config = loadConfig(process.cwd());
+    config.enabled = false;
+    config.pausedUntil = new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString();
+    saveConfig(process.cwd(), config);
+    console.log("⏸️  SPP enforcement paused for 24 hours. Claude may write code freely.");
+    console.log("   Run 'spp resume' to resume SPP enforcement immediately.");
+});
+program
+    .command("resume")
+    .description("Resume SPP tracking")
+    .action(() => {
+    if (!isFullyInitialized(process.cwd())) {
+        console.error("❌ SPP not initialized. Run: spp init");
+        process.exit(1);
+    }
+    const config = loadConfig(process.cwd());
+    config.enabled = true;
+    delete config.pausedUntil;
+    saveConfig(process.cwd(), config);
+    console.log("▶️  SPP resumed. Coding enforcement is active.");
+});
+program
+    .command("reset")
+    .description("Reset tracking to start from current commit")
+    .action(async () => {
+    if (!isFullyInitialized(process.cwd())) {
+        console.error("❌ SPP not initialized. Run: spp init");
+        process.exit(1);
+    }
+    const answer = await promptUser("This will reset tracking to start from the current commit. All previous stats will be cleared. Are you sure? (y/N): ");
+    if (answer.toLowerCase() !== "y") {
+        console.log("Reset cancelled.");
+        return;
+    }
+    const headCommit = getHeadCommitHash(process.cwd());
+    if (!headCommit) {
+        console.error("❌ Could not get current commit hash.");
+        process.exit(1);
+    }
+    const config = loadConfig(process.cwd());
+    config.trackingStartCommit = headCommit;
+    saveConfig(process.cwd(), config);
+    console.log(`✅ Tracking reset. Stats will now start from commit ${headCommit.substring(0, 7)}.`);
+});
+// Hook commands (called by Claude Code)
+program
+    .command("hook:pre-tool-use")
+    .description("Pre-tool-use hook (internal, reads JSON from stdin)")
+    .action(async () => {
+    await runPreToolUseHook();
+});
+program
+    .command("hook:system-prompt")
+    .description("Output system prompt injection (internal)")
+    .action(() => {
+    console.log(generateSystemPrompt(process.cwd()));
+});
+program.parseAsync();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config/loader.d.ts

@@ -0,0 +1,29 @@
+import { type Config } from "./schema.js";
+/**
+ * Get the path to the .claude-spp directory for a project
+ */
+export declare function getSppDir(projectPath: string): string;
+/**
+ * Get the path to the config file
+ */
+export declare function getConfigPath(projectPath: string): string;
+/**
+ * Check if SPP is initialized in the project
+ */
+export declare function isSppInitialized(projectPath: string): boolean;
+/**
+ * Load and validate the config file
+ * Returns default config if file doesn't exist
+ * Throws if config is invalid
+ * Auto-unpauses if pausedUntil time has passed
+ */
+export declare function loadConfig(projectPath: string): Config;
+/**
+ * Save config to file
+ */
+export declare function saveConfig(projectPath: string, config: Config): void;
+/**
+ * Initialize SPP in a project with default config
+ */
+export declare function initializeConfig(projectPath: string): Config;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgC,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAKxE;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA6BtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAiBpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAO5D"}

package/dist/config/loader.js

@@ -0,0 +1,81 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { ConfigSchema, DEFAULT_CONFIG } from "./schema.js";
+const SPP_DIR = ".claude-spp";
+const CONFIG_FILE = "config.json";
+/**
+ * Get the path to the .claude-spp directory for a project
+ */
+export function getSppDir(projectPath) {
+    return path.join(projectPath, SPP_DIR);
+}
+/**
+ * Get the path to the config file
+ */
+export function getConfigPath(projectPath) {
+    return path.join(getSppDir(projectPath), CONFIG_FILE);
+}
+/**
+ * Check if SPP is initialized in the project
+ */
+export function isSppInitialized(projectPath) {
+    return fs.existsSync(getSppDir(projectPath));
+}
+/**
+ * Load and validate the config file
+ * Returns default config if file doesn't exist
+ * Throws if config is invalid
+ * Auto-unpauses if pausedUntil time has passed
+ */
+export function loadConfig(projectPath) {
+    const configPath = getConfigPath(projectPath);
+    if (!fs.existsSync(configPath)) {
+        return DEFAULT_CONFIG;
+    }
+    try {
+        const raw = fs.readFileSync(configPath, "utf-8");
+        const json = JSON.parse(raw);
+        const config = ConfigSchema.parse(json);
+        // Auto-unpause if pausedUntil time has passed
+        if (config.pausedUntil) {
+            const unpauseTime = new Date(config.pausedUntil).getTime();
+            if (Date.now() > unpauseTime) {
+                config.enabled = true;
+                delete config.pausedUntil;
+                saveConfig(projectPath, config);
+            }
+        }
+        return config;
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new Error(`Invalid JSON in ${configPath}: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Save config to file
+ */
+export function saveConfig(projectPath, config) {
+    const sppDir = getSppDir(projectPath);
+    const configPath = getConfigPath(projectPath);
+    // Ensure .claude-spp directory exists
+    if (!fs.existsSync(sppDir)) {
+        fs.mkdirSync(sppDir, { recursive: true });
+    }
+    // Validate before saving
+    const validated = ConfigSchema.parse(config);
+    fs.writeFileSync(configPath, JSON.stringify(validated, null, 2) + "\n", "utf-8");
+}
+/**
+ * Initialize SPP in a project with default config
+ */
+export function initializeConfig(projectPath) {
+    const config = {
+        ...DEFAULT_CONFIG,
+    };
+    saveConfig(projectPath, config);
+    return config;
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAe,MAAM,aAAa,CAAC;AAExE,MAAM,OAAO,GAAG,aAAa,CAAC;AAC9B,MAAM,WAAW,GAAG,aAAa,CAAC;AAElC;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,WAAmB;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,OAAO,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAE9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAExC,8CAA8C;QAC9C,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;YAC3D,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;gBAC7B,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;gBACtB,OAAO,MAAM,CAAC,WAAW,CAAC;gBAC1B,UAAU,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,mBAAmB,UAAU,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,MAAc;IAC5D,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAE9C,sCAAsC;IACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,yBAAyB;IACzB,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE7C,EAAE,CAAC,aAAa,CACd,UAAU,EACV,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EACzC,OAAO,CACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,MAAM,GAAW;QACrB,GAAG,cAAc;KAClB,CAAC;IAEF,UAAU,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/config/schema.d.ts

@@ -0,0 +1,84 @@
+import { z } from "zod";
+/**
+ * Mode definition
+ */
+export interface Mode {
+    number: number;
+    name: string;
+    humanRatio: number;
+    description: string;
+}
+/**
+ * Available modes for work distribution
+ */
+export declare const MODES: Mode[];
+/**
+ * Get mode by number
+ */
+export declare function getModeByNumber(num: number): Mode | undefined;
+/**
+ * Get mode by name (case-insensitive)
+ */
+export declare function getModeByName(name: string): Mode | undefined;
+/**
+ * Stats window options for filtering commit history
+ */
+export declare const StatsWindowSchema: z.ZodEnum<["oneDay", "oneWeek", "allTime"]>;
+export type StatsWindow = z.infer<typeof StatsWindowSchema>;
+/**
+ * Tracking mode options - what to count for ratio calculation
+ */
+export declare const TrackingModeSchema: z.ZodEnum<["commits", "lines"]>;
+export type TrackingMode = z.infer<typeof TrackingModeSchema>;
+/**
+ * Human-readable labels for tracking modes
+ */
+export declare const TRACKING_MODE_LABELS: Record<TrackingMode, string>;
+/**
+ * Human-readable labels for stats windows
+ */
+export declare const STATS_WINDOW_LABELS: Record<StatsWindow, string>;
+/**
+ * Get cutoff date for a stats window
+ * @returns Date for filtering or null for allTime (no filter)
+ */
+export declare function getStatsWindowCutoff(window: StatsWindow): Date | null;
+/**
+ * Main configuration schema for .dojo/config.json
+ */
+export declare const ConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    mode: z.ZodDefault<z.ZodNumber>;
+    statsWindow: z.ZodDefault<z.ZodEnum<["oneDay", "oneWeek", "allTime"]>>;
+    trackingMode: z.ZodDefault<z.ZodEnum<["commits", "lines"]>>;
+    pausedUntil: z.ZodOptional<z.ZodString>;
+    trackingStartCommit: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    mode: number;
+    statsWindow: "oneDay" | "oneWeek" | "allTime";
+    trackingMode: "commits" | "lines";
+    pausedUntil?: string | undefined;
+    trackingStartCommit?: string | undefined;
+}, {
+    enabled?: boolean | undefined;
+    mode?: number | undefined;
+    statsWindow?: "oneDay" | "oneWeek" | "allTime" | undefined;
+    trackingMode?: "commits" | "lines" | undefined;
+    pausedUntil?: string | undefined;
+    trackingStartCommit?: string | undefined;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: Config;
+/**
+ * Get the current mode from config
+ */
+export declare function getCurrentMode(config: Config): Mode;
+/**
+ * Get the effective human work ratio from config
+ */
+export declare function getEffectiveRatio(config: Config): number;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,KAAK,EAAE,IAAI,EAMvB,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE5D;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,6CAA2C,CAAC;AAC1E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,kBAAkB,iCAA+B,CAAC;AAC/D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAG7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAI3D,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAUrE;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;EAoBvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAK5B,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIxD"}

package/dist/config/schema.js

@@ -0,0 +1,104 @@
+import { z } from "zod";
+/**
+ * Available modes for work distribution
+ */
+export const MODES = [
+    { number: 1, name: "Lazy monkey", humanRatio: 0, description: "100% AI coding" },
+    { number: 2, name: "Curious monkey", humanRatio: 0.1, description: "90% AI / 10% human" },
+    { number: 3, name: "Clever monkey", humanRatio: 0.25, description: "75% AI / 25% human" },
+    { number: 4, name: "Wise monkey", humanRatio: 0.5, description: "50% AI / 50% human" },
+    { number: 5, name: "Crazy monkey", humanRatio: 1, description: "100% human coding" },
+];
+/**
+ * Get mode by number
+ */
+export function getModeByNumber(num) {
+    return MODES.find((m) => m.number === num);
+}
+/**
+ * Get mode by name (case-insensitive)
+ */
+export function getModeByName(name) {
+    return MODES.find((m) => m.name.toLowerCase() === name.toLowerCase());
+}
+/**
+ * Stats window options for filtering commit history
+ */
+export const StatsWindowSchema = z.enum(["oneDay", "oneWeek", "allTime"]);
+/**
+ * Tracking mode options - what to count for ratio calculation
+ */
+export const TrackingModeSchema = z.enum(["commits", "lines"]);
+/**
+ * Human-readable labels for tracking modes
+ */
+export const TRACKING_MODE_LABELS = {
+    commits: "Commits",
+    lines: "Lines of code",
+};
+/**
+ * Human-readable labels for stats windows
+ */
+export const STATS_WINDOW_LABELS = {
+    oneDay: "Last 24 hours",
+    oneWeek: "Last 7 days",
+    allTime: "All time",
+};
+/**
+ * Get cutoff date for a stats window
+ * @returns Date for filtering or null for allTime (no filter)
+ */
+export function getStatsWindowCutoff(window) {
+    const now = new Date();
+    switch (window) {
+        case "oneDay":
+            return new Date(now.getTime() - 24 * 60 * 60 * 1000);
+        case "oneWeek":
+            return new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+        case "allTime":
+            return null;
+    }
+}
+/**
+ * Main configuration schema for .dojo/config.json
+ */
+export const ConfigSchema = z.object({
+    // Whether Dojo is enabled for this project
+    enabled: z.boolean().default(true),
+    // Mode number (1-6)
+    mode: z.number().int().min(1).max(6).default(4),
+    // Stats window for filtering commit history
+    statsWindow: StatsWindowSchema.default("oneWeek"),
+    // Tracking mode - what to count for ratio calculation
+    trackingMode: TrackingModeSchema.default("commits"),
+    // ISO timestamp when SPP pause expires (set by pause command)
+    pausedUntil: z.string().optional(),
+    // Git commit hash of the last commit to exclude from tracking
+    // Set to the 10th commit hash once we reach MIN_COMMITS_FOR_TRACKING
+    // Stats only include commits after this one
+    trackingStartCommit: z.string().optional(),
+});
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    enabled: true,
+    mode: 3,
+    statsWindow: "oneWeek",
+    trackingMode: "commits",
+};
+/**
+ * Get the current mode from config
+ */
+export function getCurrentMode(config) {
+    return getModeByNumber(config.mode) ?? MODES[3]; // Default to 50-50
+}
+/**
+ * Get the effective human work ratio from config
+ */
+export function getEffectiveRatio(config) {
+    // Use mode
+    const mode = getCurrentMode(config);
+    return mode.humanRatio;
+}
+//# sourceMappingURL=schema.js.map