@boshu2/vibe-check 1.6.1 → 1.7.0

package/Makefile

@@ -0,0 +1,173 @@
+# vibe-check Makefile
+# All npm commands and development shortcuts
+
+.PHONY: help build dev start test test-coverage lint clean install publish dashboard watch profile analyze session-start session-end
+
+# Default target
+help:
+	@echo "vibe-check Development Commands"
+	@echo "================================"
+	@echo ""
+	@echo "Build & Run:"
+	@echo "  make build          - Compile TypeScript to dist/"
+	@echo "  make dev            - Run with ts-node (no compile)"
+	@echo "  make start          - Run compiled version"
+	@echo "  make clean          - Remove dist/ directory"
+	@echo ""
+	@echo "Testing:"
+	@echo "  make test           - Run all tests"
+	@echo "  make test-coverage  - Run tests with coverage report"
+	@echo "  make test-watch     - Run tests in watch mode"
+	@echo ""
+	@echo "Publishing:"
+	@echo "  make install        - Install dependencies"
+	@echo "  make publish        - Build, test, and publish to npm"
+	@echo "  make version-patch  - Bump patch version (1.0.x)"
+	@echo "  make version-minor  - Bump minor version (1.x.0)"
+	@echo "  make version-major  - Bump major version (x.0.0)"
+	@echo ""
+	@echo "Vibe-Check Commands:"
+	@echo "  make dashboard      - Open visual dashboard"
+	@echo "  make watch          - Real-time spiral detection"
+	@echo "  make profile        - Show XP, streaks, achievements"
+	@echo "  make analyze        - Analyze last week"
+	@echo "  make analyze-today  - Analyze today only"
+	@echo "  make timeline       - Show coding timeline"
+	@echo ""
+	@echo "Session Commands:"
+	@echo "  make session-start  - Start session (prompts for level)"
+	@echo "  make session-end    - End session and get metrics"
+	@echo "  make session-status - Show active session info"
+	@echo ""
+
+# ============================================
+# Build & Run
+# ============================================
+
+build:
+	npm run build
+
+dev:
+	npm run dev
+
+start:
+	npm run start
+
+clean:
+	rm -rf dist/
+
+# ============================================
+# Testing
+# ============================================
+
+test:
+	npm test
+
+test-coverage:
+	npm run test:coverage
+
+test-watch:
+	npx vitest watch
+
+# ============================================
+# Publishing
+# ============================================
+
+install:
+	npm install
+
+publish: build test
+	npm publish --access=public
+
+version-patch:
+	npm version patch
+
+version-minor:
+	npm version minor
+
+version-major:
+	npm version major
+
+# ============================================
+# Vibe-Check Commands
+# ============================================
+
+dashboard:
+	node dist/cli.js dashboard
+
+watch:
+	node dist/cli.js watch
+
+profile:
+	node dist/cli.js profile
+
+analyze:
+	node dist/cli.js --since "1 week ago" --score
+
+analyze-today:
+	node dist/cli.js --since "today" --score
+
+analyze-json:
+	node dist/cli.js --since "1 week ago" --score --format json
+
+timeline:
+	node dist/cli.js timeline --since "1 week ago"
+
+timeline-expand:
+	node dist/cli.js timeline --since "1 week ago" --expand
+
+# ============================================
+# Session Commands
+# ============================================
+
+session-start:
+	@read -p "Vibe Level (0-5): " level; \
+	node dist/cli.js session start --level $$level
+
+session-start-json:
+	@read -p "Vibe Level (0-5): " level; \
+	node dist/cli.js session start --level $$level --format json
+
+session-end:
+	node dist/cli.js session end
+
+session-end-json:
+	node dist/cli.js session end --format json
+
+session-status:
+	node dist/cli.js session status
+
+# ============================================
+# Learning Commands
+# ============================================
+
+learn:
+	node dist/cli.js learn
+
+lessons:
+	node dist/cli.js lesson --list
+
+lesson-stats:
+	node dist/cli.js lesson --stats
+
+# ============================================
+# Shortcuts
+# ============================================
+
+# Quick check (alias for analyze)
+check: analyze
+
+# Full analysis with all features
+full:
+	node dist/cli.js --since "1 week ago" --score --verbose
+
+# Export dashboard data without opening browser
+export-dashboard:
+	node dist/cli.js dashboard --no-open
+
+# Cache management
+cache-stats:
+	node dist/cli.js cache --stats
+
+cache-clear:
+	node dist/cli.js cache --clear

package/README.md

@@ -1,11 +1,11 @@
 # vibe-check
 
-![Vibe-Check Dashboard](docs/images/dashboard.png)
-
 [![npm version](https://img.shields.io/npm/v/@boshu2/vibe-check.svg)](https://www.npmjs.com/package/@boshu2/vibe-check)
 [![CI](https://github.com/boshu2/vibe-check/actions/workflows/ci.yml/badge.svg)](https://github.com/boshu2/vibe-check/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+![Vibe-Check Dashboard](docs/images/dashboard.png)
+
 **Git-powered metrics for AI-assisted coding.** Catch debug spirals before they catch you.
 
 ```bash
@@ -191,6 +191,34 @@ jobs:
 
 ---
 
+## Session Integration
+
+Integrate with Claude Code's `/session-start` and `/session-end` commands:
+
+```bash
+# At session start - capture baseline
+vibe-check session start --level 3
+
+# At session end - get metrics for claude-progress.json
+vibe-check session end --format json
+```
+
+Output includes failure pattern detection:
+```json
+{
+  "metrics": { "trust_pass_rate": 92, "rework_ratio": 11, ... },
+  "retro": {
+    "failure_patterns_hit": [],
+    "failure_patterns_avoided": ["Debug Spiral", "Context Amnesia"],
+    "learnings": ["Test-first approach prevented spirals"]
+  }
+}
+```
+
+Used by the [AgentOps session-management plugin](https://github.com/boshu2/agentops).
+
+---
+
 ## All Commands
 
 ```
@@ -200,7 +228,12 @@ vibe-check dashboard           Visual dashboard + insights
 vibe-check profile             XP, streaks, achievements
 vibe-check timeline            Coding journey visualization
 vibe-check start --level <n>   Declare vibe level (0-5)
+vibe-check session start       Capture baseline for session
+vibe-check session end         Get session metrics + patterns
+vibe-check session status      Show active session info
 vibe-check intervene           Record spiral intervention
+vibe-check learn               Extract learnings from patterns
+vibe-check lesson              Manage synthesized lessons
 vibe-check init-hook           Install git hook
 vibe-check cache               Manage local storage
 ```

package/claude-progress.json

@@ -161,15 +161,44 @@
     }
   ],
   "current_state": {
-    "working_on": null,
+    "phase": "brainstorming",
+    "working_on": "Feature audit - cut/enhance/add analysis",
     "blockers": [],
     "next_steps": [
-      "Implement insight-dashboard-plan-2025-11-30.md (vibe-check dashboard command)",
-      "npm version minor && npm publish (v1.6.0)",
-      "Consider multi-repo aggregation for v2.0"
+      "Decide: Cut learning system (10 files, ~1500 lines)?",
+      "Decide: Cut advanced gamification (challenges, leaderboards, badges)?",
+      "Decide: Add `vibe-check now` quick check?",
+      "Consider npm publish for v1.7.0"
     ],
-    "resume_summary": "Storage hardening + cross-session queries + regression detection complete. Research + plan done for insight engine and dashboard. Ready to implement dashboard command."
+    "resume_summary": "Session integration complete. Ran feature audit: 78 files is bloated, recommend cutting to ~35. Learning system (10 files) and advanced gamification (5 files) are over-engineered. Core value is analyze + watch + basic gamification."
   },
+  "sessions": [
+    {
+      "session_id": "2025-12-02-001",
+      "started": "2025-12-02T13:00:00Z",
+      "ended": "2025-12-02T19:10:00Z",
+      "vibe_level": 4,
+      "summary": "Session integration + docs: Built vibe-check session commands, updated AgentOps plugin, added 14 tests, created Makefile, ran feature audit",
+      "commits": ["0a2198f", "7e11c27", "e35f39a", "b0b7567", "a949ed4", "16c73f2"],
+      "features_completed": [],
+      "metrics": {
+        "trust_pass_rate": 100,
+        "rework_ratio": 0,
+        "iteration_velocity": 6,
+        "flow_efficiency": 100,
+        "vibe_score": 88
+      },
+      "retro": {
+        "failure_patterns_hit": [],
+        "failure_patterns_avoided": ["Debug Spiral", "Context Amnesia", "Velocity Crash"],
+        "learnings": [
+          "Session command integration enables automatic metrics capture",
+          "Feature audit reveals 50% of codebase is speculative features",
+          "Learning system has zero adoption evidence - candidate for removal"
+        ]
+      }
+    }
+  ],
   "sessions_continued": [
     {
       "session_id": "2025-11-30-005",

package/claude-progress.txt

@@ -3,6 +3,42 @@ Created: 2025-11-29
 
 ## Session Log
 
+--- 2025-12-02 - Automatic Learning Cadence Research & Planning ---
+
+VIBE LEVEL: 4 (Research/Planning, exploratory)
+
+COMPLETED:
+- Research on automatic learning integration:
+  - Mapped 6 existing learning mechanisms in vibe-check
+  - Identified 4 natural trigger points (session boundary, streak, timeline, dashboard)
+  - Researched FSRS algorithm, behavioral nudges, retrospective tools
+- Created comprehensive implementation plan:
+  - 6 new files in src/learning/ module
+  - New `vibe-check learn` command (--retro, --status, --pattern)
+  - Auto-nudges displayed after gamification output
+  - Weekly retro reminders, pattern warnings, level-up hints
+- Added VIBE-032 to feature-list.json (planned, not implemented)
+
+COMMITS: None (planning session)
+
+ARTIFACTS:
+- .agents/bundles/automatic-learning-cadence-research-2025-12-02.md
+- .agents/bundles/automatic-learning-cadence-plan-2025-12-02.md
+
+REMAINING:
+- /implement automatic-learning-cadence-plan-2025-12-02.md
+- Test learn command and nudge display
+- Then implement ml-learning-loop-complete-plan-2025-11-28.md
+
+NEXT SESSION SHOULD:
+- Run /implement automatic-learning-cadence-plan-2025-12-02.md
+- Create 6 files: types.ts, storage.ts, cadence.ts, nudges.ts, retrospective.ts, index.ts
+- Add learn command to CLI
+- Integrate with recordSession() and analyze output
+- npm test && npm run dev learn --status
+
+================================================================================
+
 --- 2025-11-30 12:00 - Storage Enhancement Session ---
 
 VIBE LEVEL: 5 (Infrastructure, high trust)
@@ -456,3 +492,33 @@ NEXT SESSION COULD:
 
 ================================================================================
 
+
+--- 2025-12-02 12:10 - Session Integration + Feature Audit ---
+
+COMPLETED:
+- Built vibe-check session commands (start/end/status) with baseline capture
+- Updated AgentOps session-management plugin with vibe-check integration
+- Updated workspace slash commands (/session-start, /session-end)
+- Added 14 session tests (40 total tests passing)
+- Created Makefile with all npm commands
+- Updated CLAUDE.md with architecture and command docs
+- Ran comprehensive feature audit (78 files analyzed)
+
+METRICS:
+- Trust Pass Rate: 100%
+- Rework Ratio: 0%
+- VibeScore: 88%
+- Rating: ELITE
+
+FEATURE AUDIT FINDINGS:
+- KEEP: analyze, watch, profile, basic gamification, pattern memory
+- CUT CANDIDATES: learning system (10 files), intervention memory (2 files), 
+  advanced gamification (5 files), semantic-free metrics (4 files)
+- ADD CANDIDATES: vibe-check now (quick check), spiral notifications, pattern advice
+
+NEXT SESSION SHOULD:
+- Decide on feature cuts (learning system is biggest candidate)
+- Implement vibe-check now for ultra-fast spiral check
+- Consider npm publish v1.7.0
+
+================================================================================