@pkprosol/coach 1.0.6 → 1.0.8

package/dist/bin/coach.js

@@ -3,8 +3,8 @@ import { createInterface } from "node:readline";
 import ora from "ora";
 import chalk from "chalk";
 import { collectToday } from "../src/collector.js";
-import { analyze, runClaude, buildHandoffPrompt, buildFocusPrompt, buildCostsPrompt, estimateCosts } from "../src/analyzer.js";
-import { renderInsight, renderStreak, renderHistory, renderNoData, renderError, renderHandoff, renderFocus, renderRecap, renderGoals, renderCompare, renderWelcome, renderCosts, } from "../src/display.js";
+import { analyze, runClaude, buildHandoffPrompt, buildFocusPrompt, buildCostsPrompt, buildStrategizePrompt, estimateCosts } from "../src/analyzer.js";
+import { renderInsight, renderStreak, renderHistory, renderNoData, renderError, renderHandoff, renderFocus, renderRecap, renderGoals, renderCompare, renderWelcome, renderCosts, renderStrategize, renderCostNote, } from "../src/display.js";
 import { isFirstRun, loadState, saveState, loadInsights, appendInsight, updateLastInsightRating, updateStreak, recordDimension, addGoal, completeGoal, clearCompletedGoals, recordDailyStat, } from "../src/storage.js";
 function askQuestion(prompt) {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -61,6 +61,12 @@ async function handleDefault() {
     // Display
     console.log("");
     console.log(renderInsight(insight, state));
+    // Cost note
+    const costs = estimateCosts(data);
+    const totalCost = costs.reduce((s, c) => s + c.totalCost, 0);
+    if (totalCost > 0 || data.totalTokens > 0) {
+        console.log(renderCostNote(totalCost, data.sessions.length, data.totalTokens));
+    }
     console.log("");
     // Save insight (without rating yet)
     const storedInsight = {
@@ -297,24 +303,66 @@ function handleCompare() {
     console.log(renderCompare(todayStat, avg));
     console.log("");
 }
+async function handleStrategize() {
+    const spinner = ora({ text: "Collecting recent sessions...", color: "cyan" }).start();
+    // Collect data for the last 5 days
+    const recentDays = [];
+    for (let i = 0; i < 5; i++) {
+        const date = new Date();
+        date.setDate(date.getDate() - i);
+        const dateStr = `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
+        const dayData = collectToday(dateStr);
+        if (dayData.prompts.length > 0) {
+            recentDays.push(dayData);
+        }
+    }
+    if (recentDays.length === 0) {
+        spinner.stop();
+        console.log(renderNoData());
+        return;
+    }
+    spinner.text = `Found data across ${recentDays.length} day${recentDays.length !== 1 ? "s" : ""}. Building strategy...`;
+    const state = loadState();
+    const pastInsights = loadInsights();
+    try {
+        const prompt = buildStrategizePrompt(recentDays, state.dailyStats, pastInsights, state.goals);
+        const text = await runClaude(prompt);
+        spinner.stop();
+        const cleaned = text.replace(/^```json?\s*/, "").replace(/\s*```$/, "").trim();
+        const analysis = JSON.parse(cleaned);
+        console.log("");
+        console.log(renderStrategize(analysis));
+        console.log("");
+    }
+    catch (err) {
+        spinner.stop();
+        if (err.message?.includes("claude CLI not found")) {
+            console.log(renderError("claude CLI not found. Install Claude Code first: https://docs.anthropic.com/en/docs/claude-code"));
+        }
+        else {
+            console.log(renderError(err.message ?? "Strategy analysis failed."));
+        }
+    }
+}
 function handleHelp() {
     console.log(`
 ${chalk.bold("coach")} — Daily AI Work Coach
 
 ${chalk.bold("Usage:")}
-  coach            Today's lesson + tip (default)
-  coach handoff    Generate a handoff note for your current work
-  coach focus      Analyze context-switching and focus patterns
-  coach costs      Token costs, prompt engineering tips & LLM insights
-  coach recap      Quick summary of today's stats (no AI)
-  coach goals      Show current goals
-  coach goals set  Add a goal: coach goals set "finish auth"
-  coach goals done Mark complete: coach goals done 1
+  coach             Today's lesson + tip (default)
+  coach strategize  Plan tomorrow based on recent work patterns
+  coach handoff     Generate a handoff note for your current work
+  coach focus       Analyze context-switching and focus patterns
+  coach costs       Token costs, prompt engineering tips & LLM insights
+  coach recap       Quick summary of today's stats (no AI)
+  coach goals       Show current goals
+  coach goals set   Add a goal: coach goals set "finish auth"
+  coach goals done  Mark complete: coach goals done 1
   coach goals clear Clear completed goals
-  coach compare    Compare today vs recent averages
-  coach history    Browse past insights
-  coach streak     Show current streak + stats
-  coach help       Show this help message
+  coach compare     Compare today vs recent averages
+  coach history     Browse past insights
+  coach streak      Show current streak + stats
+  coach help        Show this help message
 `);
 }
 // --- Main ---
@@ -325,6 +373,8 @@ async function main() {
         console.log("");
         console.log(renderWelcome());
         console.log("");
+        // Save initial state so isFirstRun() returns false next time
+        saveState(loadState());
         return;
     }
     switch (command) {
@@ -337,6 +387,9 @@ async function main() {
         case "costs":
             await handleCosts();
             break;
+        case "strategize":
+            await handleStrategize();
+            break;
         case "recap":
             handleRecap();
             break;

package/dist/src/analyzer.d.ts

@@ -1,7 +1,8 @@
-import type { CollectedData, CostEstimate, Dimension, Insight, StoredInsight } from "./types.js";
+import type { CollectedData, CostEstimate, Dimension, Insight, StoredInsight, DailyStat, Goal } from "./types.js";
 export declare function estimateCosts(data: CollectedData): CostEstimate[];
 export declare function runClaude(prompt: string): Promise<string>;
 export declare function buildHandoffPrompt(data: CollectedData): string;
 export declare function buildFocusPrompt(data: CollectedData): string;
 export declare function buildCostsPrompt(data: CollectedData, costs: CostEstimate[]): string;
+export declare function buildStrategizePrompt(recentDays: CollectedData[], dailyStats: DailyStat[], pastInsights: StoredInsight[], goals: Goal[]): string;
 export declare function analyze(data: CollectedData, recentDimensions: Dimension[], pastInsights: StoredInsight[]): Promise<Insight>;

package/dist/src/analyzer.js

@@ -333,6 +333,85 @@ Guidelines:
 - Keep costs in perspective — compare to a cup of coffee, a SaaS subscription, etc.
 - If tool calls are a significant portion of the work, explain how tool use affects costs (each tool result is input tokens on the next turn).
 
+Respond with ONLY the JSON object, no markdown fences or other text.`;
+}
+export function buildStrategizePrompt(recentDays, dailyStats, pastInsights, goals) {
+    const daySummaries = recentDays.map((day) => {
+        const costs = estimateCosts(day);
+        const totalCost = costs.reduce((s, c) => s + c.totalCost, 0);
+        return {
+            date: day.date,
+            projects: day.projectsWorkedOn,
+            sessions: day.sessions.length,
+            prompts: day.prompts.length,
+            tokens: day.totalTokens,
+            toolCalls: day.totalToolCalls,
+            estimatedCost: `$${totalCost.toFixed(4)}`,
+            samplePrompts: day.prompts.slice(0, 15).map((p) => ({
+                text: p.text.slice(0, 300),
+                project: p.project,
+            })),
+            sessionDetails: day.sessions.map((s) => ({
+                project: s.project,
+                branch: s.gitBranch,
+                messages: s.messageCount,
+                toolCalls: s.toolCallCount,
+                tools: s.toolNames,
+                duration: s.startTime && s.endTime
+                    ? `${Math.round((new Date(s.endTime).getTime() - new Date(s.startTime).getTime()) / 60000)}min`
+                    : "unknown",
+            })),
+        };
+    });
+    const recentInsights = pastInsights.slice(-7).map((i) => ({
+        date: i.date,
+        dimension: i.dimension,
+        lesson: i.lesson.slice(0, 200),
+        tip: i.tip.slice(0, 200),
+        rating: i.rating,
+    }));
+    const activeGoals = goals.filter((g) => !g.completedDate);
+    return `You are Coach, a strategic planning assistant. Analyze this developer's recent days of Claude Code usage to recommend where their time is best spent tomorrow.
+
+## Recent Days of Work
+${JSON.stringify(daySummaries, null, 2)}
+
+## Daily Stats Trend (last ${dailyStats.length} days)
+${JSON.stringify(dailyStats, null, 2)}
+
+## Recent Coaching Insights
+${JSON.stringify(recentInsights, null, 2)}
+
+${activeGoals.length > 0 ? `## Active Goals
+${activeGoals.map((g) => `- #${g.id}: ${g.text} (set ${g.createdDate})`).join("\n")}` : ""}
+
+## Your Task
+
+Analyze the patterns across multiple days — what projects are getting attention, what's been neglected, where momentum is building, where they might be stuck — and return a JSON object:
+
+{
+  "recentPatterns": "2-3 sentences summarizing what you see across the recent days. What projects are hot? Any context-switching patterns? Is effort concentrated or scattered?",
+  "highImpactAreas": [
+    {
+      "area": "Project or task name",
+      "why": "Why this is the highest-impact use of time tomorrow (1-2 sentences)",
+      "suggestedAction": "Specific action to take (1 sentence)"
+    }
+  ],
+  "tomorrowPlan": ["Ordered list of 3-5 concrete things to do tomorrow, phrased as actions"],
+  "avoidTomorrow": "One thing to consciously avoid or deprioritize tomorrow and why (1-2 sentences)",
+  "motivationalNote": "One genuine, grounded sentence connecting their recent work to a bigger picture"
+}
+
+Guidelines:
+- highImpactAreas should have 2-4 items, ranked by impact
+- Reference actual project names, branches, and patterns from the data
+- The tomorrowPlan should be concrete and actionable, not generic
+- If they have active goals, factor those into your recommendations
+- If a project seems stuck (lots of prompts, little progress), call it out
+- If a project has momentum (recent commits, clear direction), suggest riding that wave
+- Be specific. "Continue working on auth" is too vague. "Finish the JWT refresh token flow in coach, then write integration tests" is better.
+
 Respond with ONLY the JSON object, no markdown fences or other text.`;
 }
 export async function analyze(data, recentDimensions, pastInsights) {

package/dist/src/display.d.ts

@@ -1,4 +1,4 @@
-import type { Insight, CoachState, StoredInsight, Goal, CollectedData, DailyStat, CostAnalysis } from "./types.js";
+import type { Insight, CoachState, StoredInsight, Goal, CollectedData, DailyStat, CostAnalysis, StrategizeAnalysis } from "./types.js";
 export declare function renderInsight(insight: Insight, state: CoachState): string;
 export declare function renderStreak(state: CoachState): string;
 export declare function renderHistory(insights: StoredInsight[]): string;
@@ -23,3 +23,5 @@ export declare function renderRecap(data: CollectedData): string;
 export declare function renderGoals(goals: Goal[]): string;
 export declare function renderCompare(today: DailyStat, avg: DailyStat): string;
 export declare function renderCosts(analysis: CostAnalysis): string;
+export declare function renderStrategize(analysis: StrategizeAnalysis): string;
+export declare function renderCostNote(totalCost: number, sessions: number, tokens: number): string;

package/dist/src/display.js

@@ -142,14 +142,15 @@ export function renderWelcome() {
     out.push(padLine("  3. Get a personalized insight + tip"));
     out.push(padLine(""));
     out.push(padLine(chalk.bold("  Commands:")));
-    out.push(padLine("  " + chalk.cyan("coach") + "           Today's lesson + tip"));
-    out.push(padLine("  " + chalk.cyan("coach handoff") + "   Handoff note for your work"));
-    out.push(padLine("  " + chalk.cyan("coach focus") + "     Focus & context-switching"));
-    out.push(padLine("  " + chalk.cyan("coach costs") + "     Cost analysis & LLM tips"));
-    out.push(padLine("  " + chalk.cyan("coach recap") + "     Quick stats (no AI)"));
-    out.push(padLine("  " + chalk.cyan("coach goals") + "     Track your goals"));
-    out.push(padLine("  " + chalk.cyan("coach compare") + "   Today vs recent averages"));
-    out.push(padLine("  " + chalk.cyan("coach help") + "      All commands"));
+    out.push(padLine("  " + chalk.cyan("coach") + "            Today's lesson + tip"));
+    out.push(padLine("  " + chalk.cyan("coach strategize") + " Plan tomorrow's focus"));
+    out.push(padLine("  " + chalk.cyan("coach handoff") + "    Handoff note for your work"));
+    out.push(padLine("  " + chalk.cyan("coach focus") + "      Focus & context-switching"));
+    out.push(padLine("  " + chalk.cyan("coach costs") + "      Cost analysis & LLM tips"));
+    out.push(padLine("  " + chalk.cyan("coach recap") + "      Quick stats (no AI)"));
+    out.push(padLine("  " + chalk.cyan("coach goals") + "      Track your goals"));
+    out.push(padLine("  " + chalk.cyan("coach compare") + "    Today vs recent averages"));
+    out.push(padLine("  " + chalk.cyan("coach help") + "       All commands"));
     out.push(padLine(""));
     out.push(padLine(chalk.bold("  Requirements:")));
     out.push(padLine("  " + chalk.dim("Claude Code CLI must be installed and")));
@@ -354,3 +355,54 @@ export function renderCosts(analysis) {
     out.push(boxBot());
     return out.join("\n");
 }
+// === Strategize ===
+export function renderStrategize(analysis) {
+    const out = [];
+    out.push(boxTop());
+    out.push(padLine(chalk.bold.white("  STRATEGIZE — TOMORROW'S PLAN")));
+    out.push(boxMid());
+    // Recent patterns
+    out.push(...renderSection("  📊 Recent Patterns", analysis.recentPatterns));
+    // High impact areas
+    if (analysis.highImpactAreas.length > 0) {
+        out.push(padLine(""));
+        out.push(padLine(chalk.bold("  🎯 High-Impact Areas")));
+        for (let i = 0; i < analysis.highImpactAreas.length; i++) {
+            const area = analysis.highImpactAreas[i];
+            out.push(padLine(""));
+            out.push(padLine(`  ${chalk.bold.cyan(`${i + 1}. ${area.area}`)}`));
+            for (const line of wrapText(area.why, WIDTH - 6)) {
+                out.push(padLine("    " + line));
+            }
+            for (const line of wrapText(`→ ${area.suggestedAction}`, WIDTH - 6)) {
+                out.push(padLine("    " + chalk.green(line)));
+            }
+        }
+    }
+    // Tomorrow plan
+    if (analysis.tomorrowPlan.length > 0) {
+        out.push(padLine(""));
+        out.push(padLine(chalk.bold("  📋 Tomorrow's Action Plan")));
+        for (let i = 0; i < analysis.tomorrowPlan.length; i++) {
+            for (const line of wrapText(`${i + 1}. ${analysis.tomorrowPlan[i]}`, WIDTH - 6)) {
+                out.push(padLine("    " + line));
+            }
+        }
+    }
+    // Avoid
+    out.push(...renderSection("  🚫 Deprioritize", analysis.avoidTomorrow));
+    // Motivation
+    out.push(padLine(""));
+    out.push(padLine("  🌱 " + chalk.italic(analysis.motivationalNote)));
+    out.push(padLine(""));
+    out.push(boxBot());
+    return out.join("\n");
+}
+// === Cost Note (inline for default command) ===
+export function renderCostNote(totalCost, sessions, tokens) {
+    const costStr = totalCost < 0.01 ? "<$0.01" : `~$${totalCost.toFixed(2)}`;
+    const tokStr = tokens >= 1_000_000
+        ? `${(tokens / 1_000_000).toFixed(1)}M`
+        : `${(tokens / 1000).toFixed(0)}k`;
+    return chalk.dim(`  💰 Today so far: ${costStr} across ${sessions} session${sessions !== 1 ? "s" : ""} (${tokStr} tokens). Run \`coach costs\` for details.`);
+}

package/dist/src/types.d.ts

@@ -87,6 +87,18 @@ export interface CostAnalysis {
     efficiencyTips: string[];
     promptEngineeringInsight: string;
 }
+export interface StrategizeArea {
+    area: string;
+    why: string;
+    suggestedAction: string;
+}
+export interface StrategizeAnalysis {
+    recentPatterns: string;
+    highImpactAreas: StrategizeArea[];
+    tomorrowPlan: string[];
+    avoidTomorrow: string;
+    motivationalNote: string;
+}
 export interface HistoryEntry {
     display: string;
     pastedContents: Record<string, unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pkprosol/coach",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "Daily AI work coach — analyzes your Claude Code & Claude App sessions to deliver one lesson + one tip daily",
   "type": "module",
   "bin": {