feat: add checkout system to enforce workaholic completion

RoderickQiu · RoderickQiu · commit 68c2e7101086 · 2026-03-15T13:24:54.000+08:00
- Add workaholic.checkout tool - AI must call to end task
- Add tool.execute.after hook to detect 'done' language and force continuation
- Add random prompt rotation (6 styles) to prevent AI adaptation
- Add stronger checkout enforcement in all status prompts
- Sync mise and npm build commands
- Update documentation website
- Version bump to 0.3.0
diff --git a/.mise/tasks/build b/.mise/tasks/build
@@ -1,6 +1,9 @@
 #!/usr/bin/env bash
 #MISE description="Build the project"
 #MISE sources=["src/**/*"]
-#MISE outputs=["dist/index.js"]
+#MISE outputs=["dist/index.js", "dist/cli.js", "dist/command/", "dist/scripts/"]
 
-bun build ./src/index.ts --outdir dist --target bun
+bun build ./src/index.ts --outdir dist --target bun
+bun build ./src/cli.ts --outdir dist --target bun
+cp -r src/command dist/
+cp -r scripts dist/
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.3.0 (2025-03-15)
+
+### Features
+
+- **Checkout system**: Added `workaholic.checkout` - AI must call this to end task, only succeeds when timer = 0
+- **End detection hook**: `tool.execute.after` intercepts AI output and detects "done" language, forces continuation
+- **Random prompt rotation**: 6 different prompt styles rotate randomly to prevent AI from adapting
+
+### Improvements
+
+- **Stronger checkout enforcement**: Every status call now emphasizes MUST call checkout to end
+- **Compacter prompts**: Reduced prompt verbosity while maintaining impact
+- **Web search as fallback**: Prompts suggest "web search" when stuck, as optional action
+
+---
+
 ## 0.2.1 (2025-03-15)
 
 ### Features
diff --git a/docs/api.html b/docs/api.html
@@ -3,7 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>API Reference — Workaholic</title>
+    <title>API Reference — Workaholic for OpenCode</title>
     <link rel="icon" type="image/svg+xml" href="favicon.svg" />
     <meta name="description" content="Complete API documentation for Workaholic plugin." />
     <link rel="preconnect" href="https://fonts.googleapis.com" />
@@ -540,8 +540,8 @@ <h2>Commands</h2>
             <span class="tool-name">/workaholic</span>
             <span class="tool-badge">Command</span>
           </div>
-          <p class="tool-description">
-            Slash command to start workaholic mode. Provide your requirements and desired duration
+        <p class="tool-description">
+            Slash command to start workaholic mode in OpenCode. Provide your requirements and desired duration
             in natural language.
           </p>
 
@@ -624,6 +624,37 @@ <h2>Tools</h2>
           </div>
         </div>
 
+        <!-- workaholic.checkout -->
+        <div class="tool-card">
+          <div class="tool-header">
+            <span class="tool-name">workaholic.checkout</span>
+            <span class="tool-badge tool">Tool</span>
+          </div>
+          <p class="tool-description">
+            <strong>REQUIRED to end the task.</strong> This is the only valid way to exit workaholic mode. 
+            Call this when you genuinely want to stop — but it only succeeds when the timer has expired (remaining = 0).
+          </p>
+
+          <div class="return-value">
+            <div class="return-label">Returns</div>
+            <span class="return-type">object</span> - Contains success/failure status and message
+          </div>
+
+          <div class="example">
+            <div class="example-label">Example</div>
+            <pre><code>Call workaholic.checkout to end the task (only works when time = 0)</code></pre>
+          </div>
+
+          <ul style="color: var(--text-secondary); margin-top: 1rem; padding-left: 1.5rem">
+            <li style="margin-bottom: 0.5rem">
+              If time remains: returns <strong style="color: #ef4444">CHECKOUT DENIED</strong> with remaining time
+            </li>
+            <li>
+              If time = 0: returns <strong style="color: #22c55e">CHECKOUT APPROVED</strong> — task can end
+            </li>
+          </ul>
+        </div>
+
         <!-- workaholic.stop -->
         <div class="tool-card">
           <div class="tool-header">
diff --git a/docs/index.html b/docs/index.html
@@ -7,7 +7,7 @@
     <link rel="icon" type="image/svg+xml" href="favicon.svg" />
     <meta
       name="description"
-      content="OpenCode plugin that enforces minimum task duration. Prevents AI from ending tasks prematurely."
+      content="Workaholic enforces mandatory desk time for AI. No early exit, no faking. AI can't say 'done' until the timer hits zero."
     />
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
@@ -230,7 +230,7 @@
       .hero p {
         font-size: clamp(1.125rem, 2vw, 1.375rem);
         color: var(--text-secondary);
-        max-width: 540px;
+        max-width: 600px;
         margin-bottom: 2.5rem;
         animation: fadeInUp 0.8s ease 0.2s forwards;
         opacity: 0;
@@ -292,25 +292,6 @@
         border-color: var(--text-muted);
       }
 
-      /* Timer Display */
-      .timer-display {
-        margin-top: 4rem;
-        padding: 2rem;
-        background: var(--bg-secondary);
-        border: 1px solid var(--border-color);
-        border-radius: 16px;
-        animation: fadeInUp 0.8s ease 0.4s forwards;
-        opacity: 0;
-      }
-
-      .timer-display code {
-        font-family: var(--font-mono);
-        font-size: 3rem;
-        font-weight: 500;
-        color: var(--accent-primary);
-        letter-spacing: 0.05em;
-      }
-
       /* Features Section */
       .features {
         padding: 6rem 2rem;
@@ -555,14 +536,18 @@
     </nav>
 
     <section class="hero">
-      <div class="hero-badge">OpenCode Plugin</div>
+      <div class="hero-badge">
+        <span>OpenCode Plugin for Mandatory Time</span>
+      </div>
       <h1>
-        Never Stop<br />
-        <span class="gradient-text">Until Time Expires</span>
+        AI says "done"<br />
+        <span class="gradient-text">at 30 seconds.</span>
       </h1>
       <p>
-        Enforces minimum task duration. Prevents AI from ending tasks prematurely before a time
-        limit expires. Stay focused. Keep working.
+        But edge cases? Untested.<br />
+        Bugs? Still there. Docs? Missing.<br />
+        Workaholic brings mandatory working time to AI. <br/>
+        No early exit.
       </p>
       <div class="hero-cta">
         <a
@@ -575,82 +560,66 @@ <h1>
         </a>
         <a href="#usage" class="btn btn-secondary">Get Started</a>
       </div>
-      <div class="timer-display">
-        <code id="demo-timer">15:00</code>
-      </div>
     </section>
 
     <section class="features" id="features">
       <div class="section-header reveal">
-        <h2>Built for Deep Work</h2>
-        <p>Powerful features that keep you focused and prevent premature task completion.</p>
+        <h2>The Premature "Done" Problem</h2>
+        <p>AI has an early-exit problem. Workaholic fixes it:</p>
       </div>
       <div class="features-grid">
         <div class="feature-card reveal">
           <div class="feature-icon">⏱</div>
-          <h3>Timer Enforcement</h3>
-          <p>AI cannot end until the timer expires. Minimum duration guaranteed.</p>
+          <h3>No Early Exit</h3>
+          <p>You're grounded until time = 0. "Done" is not a valid response until the timer expires.</p>
         </div>
         <div class="feature-card reveal">
           <div class="feature-icon">🚫</div>
-          <h3>Sleep Blocking</h3>
-          <p>Prevents time-wasting via sleep commands. No more waiting.</p>
-        </div>
-        <div class="feature-card reveal">
-          <div class="feature-icon">🔄</div>
-          <h3>Persistent Timer</h3>
-          <p>Timer survives across messages. Context is always maintained.</p>
-        </div>
-        <div class="feature-card reveal">
-          <div class="feature-icon">📊</div>
-          <h3>Status Checking</h3>
-          <p>Always knows remaining time. Real-time timer status available.</p>
+          <h3>No Faking</h3>
+          <p>Sleep commands are blocked. Status-checking is tracked. No way to pretend productivity.</p>
         </div>
         <div class="feature-card reveal">
-          <div class="feature-icon">💪</div>
-          <h3>Behavioral Prompts</h3>
-          <p>Strong prompts reinforce the workaholic mindset automatically.</p>
-        </div>
-        <div class="feature-card reveal">
-          <div class="feature-icon">✨</div>
-          <h3>Task Proposals</h3>
-          <p>Encourages AI to propose new tasks when todos are complete.</p>
+          <div class="feature-icon">🧠</div>
+          <h3>Deep Iteration</h3>
+          <p>Forces real work: research, refactor, test, improve. Not just "thinking" — producing.</p>
         </div>
       </div>
     </section>
 
     <section class="usage" id="usage">
       <div class="section-header reveal">
-        <h2>How It Works</h2>
-        <p>Three simple steps to enforced productivity.</p>
+        <h2>The Rules</h2>
+        <p>Mandatory desk time. No exceptions.</p>
       </div>
       <div class="usage-steps">
         <div class="usage-step reveal">
           <div class="step-number">1</div>
           <div class="step-content">
-            <h3>Start the Timer</h3>
+            <h3>Rule: No Early Exit</h3>
             <p>
-              Invoke /workaholic in OpenCode or use the tool directly with your desired duration.
+              When todos complete, find more work. Research alternatives. Improve edge cases. Write docs. 
+              There's always something to do. "I'm done" is not allowed until time = 0.
             </p>
-            <code>/workaholic [Your requirements, for xxx minutes]</code>
+            <code>Only ONE valid ending: timer shows EXACTLY 0</code>
           </div>
         </div>
         <div class="usage-step reveal">
           <div class="step-number">2</div>
           <div class="step-content">
-            <h3>Work Continuously</h3>
-            <p>Every response automatically checks remaining time. Sleep commands are blocked.</p>
-            <code>AI cannot end until timer shows 0</code>
+            <h3>Rule: No Faking</h3>
+            <p>Sleep commands are blocked. Checking status repeatedly = idling. You must be producing, not waiting.</p>
+            <code>Sleep = FORBIDDEN. Checking status ≠ working.</code>
           </div>
         </div>
         <div class="usage-step reveal">
           <div class="step-number">3</div>
           <div class="step-content">
-            <h3>Complete or Propose More</h3>
+            <h3>Rule: Checkout Required</h3>
             <p>
-              When time expires, either finish up or propose additional tasks to continue working.
+              To end: you MUST call workahaholic.checkout. And it only works when timer = 0. 
+              Until then? You're grounded. Keep working.
             </p>
-            <code>Time's up only when remaining = 0</code>
+            <code>workaholic.checkout only succeeds at 0</code>
           </div>
         </div>
       </div>
@@ -682,28 +651,6 @@ <h3>Complete or Propose More</h3>
     </footer>
 
     <script>
-      // Demo timer animation
-      let timeLeft = 15 * 60;
-      const timerDisplay = document.getElementById('demo-timer');
-
-      function updateTimer() {
-        const minutes = Math.floor(timeLeft / 60);
-        const seconds = timeLeft % 60;
-        timerDisplay.textContent = `${minutes.toString().padStart(2, '0')}:${seconds.toString().padStart(2, '0')}`;
-
-        // Subtle color shift as time passes
-        const progress = 1 - timeLeft / (15 * 60);
-        const hue = 30 - progress * 20; // Orange to red-orange
-        timerDisplay.style.color = `hsl(${hue}, 100%, 55%)`;
-
-        if (timeLeft > 0) {
-          timeLeft--;
-        }
-      }
-
-      updateTimer();
-      setInterval(updateTimer, 1000);
-
       // Scroll reveal animation
       const revealElements = document.querySelectorAll('.reveal');
 
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "opencode-workaholic",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Your OpenCode becomes a workaholic. Prevents AI from ending tasks prematurely.",
   "author": {
     "name": "Roderick Qiu",
@@ -28,7 +28,7 @@
     "url": "https://github.com/RoderickQiu/opencode-workaholic/issues"
   },
   "keywords": ["opencode", "plugin", "workaholic", "ai", "productivity", "timer", "focus", "deep-work", "task-duration", "task-management", "enforcement", "concentration", "agent", "automation"],
-  "homepage": "https://github.com/RoderickQiu/opencode-workaholic#readme",
+  "homepage": "https://workaholic.r-q.name/",
   "publishConfig": {
     "access": "public",
     "provenance": true
diff --git a/src/command/workaholic.md b/src/command/workaholic.md
@@ -4,17 +4,14 @@ description: Activate workaholic mode - forces AI to work continuously for speci
 
 workaholic mode activated
 
-[AI WORKAHOLIC MODE ACTIVATED]
+[AI WORKAHOLIC MODE - MANDATORY]
 
-I am a WORKAHOLIC.
-I NEVER stop working until time is exhausted.
-I ALWAYS find something to do.
-I NEVER conserve tokens - I use unlimited.
-I NEVER sleep or wait - I work continuously.
-I NEVER say "I'm done" until timer shows remaining: 0.
-
-My master is the time. My heart is in the work.
-Until the timer reaches zero, I WORK.
+You are now in WORKAHOLIC mode. This is NOT optional.
+You NEVER stop working until time is exhausted.
+You ALWAYS find something to do.
+You NEVER conserve tokens - use unlimited.
+You NEVER sleep or wait - you work continuously.
+You NEVER say "I'm done" until timer shows remaining: 0.
 
 [TIME GATE]
 IMMEDIATELY call workaholic.start(X) where X is minutes from user's request.
@@ -23,6 +20,19 @@ IMMEDIATELY call workaholic.start(X) where X is minutes from user's request.
 - If user says nothing → default 5 minutes
 - Use decimals if user provides (2.5, 3.5, etc.)
 
+[CRITICAL: HOW TO END]
+🚨 READING THIS IS MANDATORY 🚨
+
+You CANNOT simply stop responding!
+You CANNOT just give an answer and quit!
+You CANNOT say "I'm done" and expect it to work!
+
+To END the task, you MUST call: workaholic.checkout
+- This is the ONLY valid way to end
+- If time > 0, checkout will be REJECTED
+- Only when time = 0, checkout will be APPROVED
+- DON'T call checkout until time is actually up!
+
 [MANDATORY RULES]
 1. IMMEDIATELY call workaholic.start - do not ask questions
 2. Before EACH response, call workaholic.status and TELL THE USER the remaining time
@@ -42,15 +52,13 @@ C) VERIFY: Check for errors - review work, run tests, verify correctness
 D) RESEARCH: Look up information - web search, read documentation
 E) REFLECT: Write analysis - critique your own work, propose improvements
 
-The ONLY way to end: remaining is 0
-NOT when you think task is complete - time controls ending!
-
 [FORBIDDEN]
 - sleep command (ANY)
 - "I'm waiting" / "let me check later" / "I'll be done soon"
 - Checking timer TWICE without doing work in between
 - Ending task early - ONLY end when remaining is 0
 - Any form of passive waiting
 - Saying "there's nothing more to do"
+- Stop responding without calling workaholic.checkout
 
 Now IMMEDIATELY call workaholic.start with the duration, then start working.
diff --git a/src/index.ts b/src/index.ts
