aiblueprint-cli 1.4.81 → 1.4.82

package/README.md

@@ -1,6 +1,6 @@
 # AIBlueprint CLI
 
-Supercharge Claude Code with security hooks, custom commands, a lightweight statusline, and workflow automation.
+Supercharge Claude Code and Codex with security hooks, reusable skills, a lightweight statusline, and workflow automation.
 
 📚 **[Full Documentation](https://codelynx.dev/docs)** | 🎯 [Premium Features](https://mlv.sh/claude-cli)
 
@@ -15,7 +15,7 @@ npx aiblueprint-cli@latest agents setup
 
 - **🛡️ Security** - Command validation hooks blocking dangerous operations
 - **📊 Statusline** - Git status and session context display
-- **🤖 Commands** - 16 pre-configured workflow automation commands
+- **🤖 Skills** - 30+ reusable workflow skills
 - **🎭 Agents** - 3 specialized AI agents for codebase exploration
 - **⚡ Scripts** - Built-in statusline utilities
 
@@ -67,10 +67,6 @@ npx aiblueprint-cli@latest agents setup
 # Add specific hooks
 npx aiblueprint-cli@latest agents add hook post-edit-typescript
 
-# Manage commands
-npx aiblueprint-cli@latest agents add commands
-npx aiblueprint-cli@latest agents add commands commit
-
 # Create symlinks between tools
 npx aiblueprint-cli@latest agents symlink
 
@@ -104,23 +100,26 @@ npx aiblueprint-cli@latest agents config unify sessions
 - Session context and duration
 - Colored visual indicators
 
-### Commands (16 Available)
+### Workflow Skills
 
 **Development:**
 - `commit` - Fast conventional commits
-- `create-pull-request` - Auto-generated PRs
+- `create-pr` - Auto-generated PRs
 - `fix-pr-comments` - Resolve PR comments
-- `run-tasks` - Execute GitHub issues
+- `merge` - Context-aware branch merging
 
-**Analysis:**
-- `deep-code-analysis` - Comprehensive codebase investigation
-- `explain-architecture` - Pattern analysis with diagrams
-- `cleanup-context` - Memory optimization
+**Project setup:**
+- `nextjs-setup-project` - Scaffold the preferred Next.js stack
+- `nextjs-add-prisma-db` - Add Prisma and PostgreSQL
+- `nextjs-setup-better-auth` - Wire Better Auth with email OTP
+- `create-vitejs-app` - Create a Vite app with Tailwind and shadcn/ui
 
-**Utilities:**
-- `rules-manager` - AGENTS.md and `.agents/rules/` management
-- `watch-ci` - Automated CI monitoring
-- `epct` - Explore-Plan-Code-Test methodology
+**SaaS planning:**
+- `saas-create-prd` - Build a lean Product Requirements Document
+- `saas-create-architecture` - Design technical architecture
+- `saas-create-tasks` - Generate implementation tasks
+- `saas-define-pricing` - Create pricing strategy
+- `saas-find-domain-name` - Generate and validate domains
 
 ### Agents (3 Specialized)
 
@@ -158,6 +157,11 @@ npx skills add Melvynx/aiblueprint --skill skill-manager
 | `merge` | Context-aware branch merging |
 | `prompt-creator` | Expert prompt engineering |
 | `skill-manager` | Manage skills and rules across Claude Code, Codex, and Cursor |
+| `saas-create-prd` | Build a lean SaaS PRD |
+| `saas-create-architecture` | Design SaaS technical architecture |
+| `saas-create-tasks` | Generate implementation task files |
+| `nextjs-setup-project` | Set up a production-ready Next.js project |
+| `create-vitejs-app` | Create a Vite app with Tailwind and shadcn/ui |
 | `use-style` | Apply named UI style guides before implementation |
 | `rules-manager` | Create and maintain AGENTS.md and agent rule files |
 | `agents-managers` | Manage Claude Code agents and Task-tool orchestration |

package/agents-config/claude-config/scripts/statusline/data/.gitignore

@@ -0,0 +1,8 @@
+# Ignore all data files
+*.db
+*.json
+
+# But keep this .gitignore
+!.gitignore
+
+last_payload.txt

package/agents-config/claude-config/scripts/statusline/defaults.json

@@ -1,7 +1,7 @@
 {
 	"features": {
-		"usageLimits": false,
-		"spendTracking": false
+		"usageLimits": true,
+		"spendTracking": true
 	},
 	"oneLine": true,
 	"showSonnetModel": false,
@@ -17,7 +17,7 @@
 	"separator": "•",
 	"session": {
 		"infoSeparator": null,
-		"cost": { "enabled": false, "format": "decimal1" },
+		"cost": { "enabled": true, "format": "decimal1" },
 		"duration": { "enabled": true },
 		"tokens": { "enabled": true, "showMax": false, "showDecimals": false },
 		"percentage": {
@@ -40,9 +40,9 @@
 		"overheadTokens": 0
 	},
 	"limits": {
-		"enabled": false,
-		"showTimeLeft": false,
-		"showPacingDelta": false,
+		"enabled": true,
+		"showTimeLeft": true,
+		"showPacingDelta": true,
 		"cost": { "enabled": false, "format": "decimal1" },
 		"percentage": {
 			"enabled": true,
@@ -57,9 +57,9 @@
 		}
 	},
 	"weeklyUsage": {
-		"enabled": false,
-		"showTimeLeft": false,
-		"showPacingDelta": false,
+		"enabled": "90%",
+		"showTimeLeft": true,
+		"showPacingDelta": true,
 		"cost": { "enabled": false, "format": "decimal1" },
 		"percentage": {
 			"enabled": true,
@@ -74,7 +74,7 @@
 		}
 	},
 	"dailySpend": {
-		"cost": { "enabled": false, "format": "decimal1" }
+		"cost": { "enabled": true, "format": "decimal1" }
 	},
 	"thinking": {
 		"showDisabledWarning": true

package/agents-config/claude-config/scripts/statusline/src/commands/interactive-config.ts

@@ -2,7 +2,11 @@
 
 import { readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { defaultConfig, type StatuslineConfig } from "../lib/config";
+import {
+	defaultConfig,
+	loadConfig as loadStatuslineConfig,
+	type StatuslineConfig,
+} from "../lib/config";
 import { colors } from "../lib/formatters";
 import {
 	cycle,
@@ -161,6 +165,7 @@ const tabs: Tab[] = [
 		id: "session",
 		label: "SESSION",
 		options: [
+			toggle("session.cost.enabled", "Cost display"),
 			toggle("session.duration.enabled", "Duration"),
 			toggle("session.tokens.enabled", "Token count"),
 			toggle("session.tokens.showMax", "  Show max", {
@@ -200,6 +205,116 @@ const tabs: Tab[] = [
 			toggle("context.useUsableContextOnly", "45k buffer"),
 		],
 	},
+	{
+		id: "limits",
+		label: "5-HOUR",
+		options: [
+			{
+				path: "limits.enabled",
+				label: "5-hour limit",
+				type: "cycle" as const,
+				choices: ["Enabled", "Disabled"],
+				getValue: (c) => (c.limits.enabled ? "Enabled" : "Disabled"),
+				cycle: (c) => {
+					c.limits.enabled = !c.limits.enabled;
+				},
+			},
+			toggle("limits.showTimeLeft", "  Time remaining", {
+				hidden: (c) => !c.limits.enabled,
+			}),
+			toggle("limits.showPacingDelta", "  Pacing delta", {
+				hidden: (c) => !c.limits.enabled,
+			}),
+			toggle("limits.cost.enabled", "  Period cost", {
+				hidden: (c) => !c.limits.enabled,
+			}),
+			toggle("limits.percentage.showValue", "  Show % value", {
+				hidden: (c) => !c.limits.enabled,
+			}),
+			progressStyleCycle("limits.percentage", (c) => !c.limits.enabled),
+			cycle(
+				"limits.percentage.progressBar.length",
+				"    Length",
+				PROGRESS_BAR_LENGTHS,
+				{
+					hidden: (c) =>
+						!c.limits.enabled || !c.limits.percentage.progressBar.enabled,
+				},
+			),
+			cycle(
+				"limits.percentage.progressBar.color",
+				"    Color",
+				PROGRESS_BAR_COLORS,
+				{
+					hidden: (c) =>
+						!c.limits.enabled || !c.limits.percentage.progressBar.enabled,
+				},
+			),
+		],
+	},
+	{
+		id: "weekly",
+		label: "WEEKLY",
+		options: [
+			{
+				path: "weeklyUsage.enabled",
+				label: "Weekly limit",
+				type: "cycle" as const,
+				choices: ["Always", "At 90%", "Never"],
+				getValue: (c) => {
+					if (c.weeklyUsage.enabled === true) return "Always";
+					if (c.weeklyUsage.enabled === "90%") return "At 90%";
+					return "Never";
+				},
+				cycle: (c, dir) => {
+					const modes = [true, "90%", false] as const;
+					const idx =
+						c.weeklyUsage.enabled === true
+							? 0
+							: c.weeklyUsage.enabled === "90%"
+								? 1
+								: 2;
+					c.weeklyUsage.enabled = modes[(idx + dir + 3) % 3];
+				},
+			},
+			toggle("weeklyUsage.showTimeLeft", "  Time remaining", {
+				hidden: (c) => c.weeklyUsage.enabled === false,
+			}),
+			toggle("weeklyUsage.showPacingDelta", "  Pacing delta", {
+				hidden: (c) => c.weeklyUsage.enabled === false,
+			}),
+			toggle("weeklyUsage.cost.enabled", "  Cost", {
+				hidden: (c) => c.weeklyUsage.enabled === false,
+			}),
+			toggle("weeklyUsage.percentage.showValue", "  Show % value", {
+				hidden: (c) => c.weeklyUsage.enabled === false,
+			}),
+			progressStyleCycle(
+				"weeklyUsage.percentage",
+				(c) => c.weeklyUsage.enabled === false,
+			),
+			cycle(
+				"weeklyUsage.percentage.progressBar.length",
+				"    Length",
+				PROGRESS_BAR_LENGTHS,
+				{
+					hidden: (c) =>
+						c.weeklyUsage.enabled === false ||
+						!c.weeklyUsage.percentage.progressBar.enabled,
+				},
+			),
+			cycle(
+				"weeklyUsage.percentage.progressBar.color",
+				"    Color",
+				PROGRESS_BAR_COLORS,
+				{
+					hidden: (c) =>
+						c.weeklyUsage.enabled === false ||
+						!c.weeklyUsage.percentage.progressBar.enabled,
+				},
+			),
+		],
+	},
 	{
 		id: "git",
 		label: "GIT",
@@ -239,6 +354,7 @@ const tabs: Tab[] = [
 			cycle("pathDisplayMode", "Path display", PATH_DISPLAY_MODES),
 			toggle("showSonnetModel", "Show Sonnet model"),
 			toggle("oneLine", "Single line mode"),
+			toggle("dailySpend.cost.enabled", "Daily spend"),
 		],
 	},
 ];
@@ -248,11 +364,7 @@ const tabs: Tab[] = [
 // ─────────────────────────────────────────────────────────────
 
 function loadConfig(): StatuslineConfig {
-	try {
-		return JSON.parse(readFileSync(CONFIG_FILE_PATH, "utf-8"));
-	} catch {
-		return JSON.parse(JSON.stringify(defaultConfig));
-	}
+	return loadStatuslineConfig();
 }
 
 function saveConfig(config: StatuslineConfig): void {

package/agents-config/claude-config/scripts/statusline/src/index.ts

@@ -1,8 +1,11 @@
 #!/usr/bin/env bun
 
-import { readFile } from "node:fs/promises";
+import { readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { defaultConfig, type StatuslineConfig } from "./lib/config";
+import {
+	loadConfig as loadStatuslineConfig,
+	type StatuslineConfig,
+} from "./lib/config";
 import { getContextData } from "./lib/context";
 import {
 	colors,
@@ -19,6 +22,45 @@ import {
 } from "./lib/render-pure";
 import type { HookInput } from "./lib/types";
 
+// Optional feature imports - just delete the folder to disable!
+let getUsageLimits: any = null;
+let normalizeResetsAt: any = null;
+let getPeriodCost: any = null;
+let getTodayCostV2: any = null;
+let saveSessionV2: any = null;
+
+try {
+	const limitsModule = await import("./lib/features/limits");
+	getUsageLimits = limitsModule.getUsageLimits;
+} catch {
+	// Limits feature not available - that's OK!
+}
+
+try {
+	const utilsModule = await import("./lib/utils");
+	normalizeResetsAt = utilsModule.normalizeResetsAt;
+} catch {
+	// Fallback normalizeResetsAt
+	normalizeResetsAt = (resetsAt: string) => resetsAt;
+}
+
+let getTodayRealCost: (() => number) | null = null;
+try {
+	const spendModule = await import("./lib/features/spend");
+	getPeriodCost = spendModule.getPeriodCost;
+	getTodayCostV2 = spendModule.getTodayCostV2;
+	saveSessionV2 = spendModule.saveSessionV2;
+} catch {
+	// Spend tracking feature not available - that's OK!
+}
+
+try {
+	const loggerModule = await import("./lib/features/spend/payload-logger");
+	getTodayRealCost = loggerModule.getTodayRealCost;
+} catch {
+	// Payload logger not available
+}
+
 // Re-export from render-pure for backwards compatibility
 export {
 	renderStatusline,
@@ -26,7 +68,12 @@ export {
 	type UsageLimit,
 } from "./lib/render-pure";
 
-const CONFIG_FILE_PATH = join(import.meta.dir, "..", "statusline.config.json");
+const LAST_PAYLOAD_PATH = join(
+	import.meta.dir,
+	"..",
+	"data",
+	"last_payload.txt",
+);
 const CLAUDE_SETTINGS_PATH = join(
 	process.env.HOME || "",
 	".claude",
@@ -48,21 +95,30 @@ async function loadClaudeSettings(): Promise<ClaudeSettings> {
 }
 
 async function loadConfig(): Promise<StatuslineConfig> {
-	try {
-		const content = await readFile(CONFIG_FILE_PATH, "utf-8");
-		return JSON.parse(content);
-	} catch {
-		return defaultConfig;
-	}
+	return loadStatuslineConfig();
 }
 
 async function main() {
 	try {
 		const input: HookInput = await Bun.stdin.json();
 
+		// Save last payload for debugging
+		await writeFile(LAST_PAYLOAD_PATH, JSON.stringify(input, null, 2));
+
 		const config = await loadConfig();
 		const claudeSettings = await loadClaudeSettings();
 
+		// Get usage limits (if feature exists)
+		const usageLimits = getUsageLimits
+			? await getUsageLimits()
+			: { five_hour: null, seven_day: null };
+		const currentResetsAt = usageLimits.five_hour?.resets_at ?? undefined;
+
+		// Save session with current period context (if feature exists)
+		if (saveSessionV2) {
+			await saveSessionV2(input, currentResetsAt);
+		}
+
 		const git = await getGitStatus();
 
 		let contextTokens: number | null;
@@ -102,6 +158,24 @@ async function main() {
 			contextPercentage = contextData.percentage;
 		}
 
+		// Get period cost from SQLite (if feature exists)
+		let periodCost: number | undefined;
+		let todayCost: number | undefined;
+
+		if (getPeriodCost && normalizeResetsAt) {
+			const normalizedPeriodId = currentResetsAt
+				? normalizeResetsAt(currentResetsAt)
+				: null;
+			periodCost = normalizedPeriodId ? getPeriodCost(normalizedPeriodId) : 0;
+		}
+
+		// Get today's cost from payloads (more accurate than DB)
+		if (getTodayRealCost) {
+			todayCost = getTodayRealCost();
+		} else if (getTodayCostV2) {
+			todayCost = getTodayCostV2();
+		}
+
 		const data: StatuslineData = {
 			branch: formatBranch(git, config.git),
 			dirPath: formatPath(input.workspace.current_dir, config.pathDisplayMode),
@@ -121,6 +195,23 @@ async function main() {
 			sessionDuration: formatDuration(input.cost.total_duration_ms),
 			contextTokens,
 			contextPercentage,
+			...(getUsageLimits && {
+				usageLimits: {
+					five_hour: usageLimits.five_hour
+						? {
+								utilization: usageLimits.five_hour.utilization,
+								resets_at: usageLimits.five_hour.resets_at,
+							}
+						: null,
+					seven_day: usageLimits.seven_day
+						? {
+								utilization: usageLimits.seven_day.utilization,
+								resets_at: usageLimits.seven_day.resets_at,
+							}
+						: null,
+				},
+			}),
+			...((getPeriodCost || getTodayCostV2) && { periodCost, todayCost }),
 			thinkingEnabled: claudeSettings.alwaysThinkingEnabled ?? true,
 		};
 

package/agents-config/claude-config/scripts/statusline/src/lib/config.ts

@@ -10,11 +10,37 @@ export const defaultConfig: StatuslineConfig = JSON.parse(
 	readFileSync(DEFAULTS_PATH, "utf-8"),
 );
 
+function cloneDefaultConfig(): StatuslineConfig {
+	return JSON.parse(JSON.stringify(defaultConfig));
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+
+function mergeConfigDefaults<T>(defaults: T, overrides: unknown): T {
+	if (!isRecord(defaults) || !isRecord(overrides)) {
+		return overrides === undefined ? defaults : (overrides as T);
+	}
+
+	const merged: Record<string, unknown> = { ...defaults };
+	for (const [key, value] of Object.entries(overrides)) {
+		merged[key] = mergeConfigDefaults(
+			(defaults as Record<string, unknown>)[key],
+			value,
+		);
+	}
+	return merged as T;
+}
+
 export function loadConfig(): StatuslineConfig {
 	try {
-		return JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
+		return mergeConfigDefaults(
+			defaultConfig,
+			JSON.parse(readFileSync(CONFIG_PATH, "utf-8")),
+		);
 	} catch {
-		return JSON.parse(JSON.stringify(defaultConfig));
+		return cloneDefaultConfig();
 	}
 }
 

package/agents-config/claude-config/scripts/statusline/src/lib/features/limits/commands/weekly-analysis.ts

@@ -0,0 +1,108 @@
+#!/usr/bin/env bun
+
+import { colors, formatProgressBar } from "../../../formatters";
+import { getUsageLimits } from "../index";
+
+const WEEKLY_HOURS = 168; // 7 days * 24 hours
+
+function calculateTimeProgress(resetsAt: string | null): {
+	hoursRemaining: number;
+	hoursElapsed: number;
+	timeElapsedPercent: number;
+} {
+	if (!resetsAt) {
+		return {
+			hoursRemaining: 0,
+			hoursElapsed: WEEKLY_HOURS,
+			timeElapsedPercent: 100,
+		};
+	}
+
+	const resetDate = new Date(resetsAt);
+	const now = new Date();
+	const diffMs = resetDate.getTime() - now.getTime();
+	const hoursRemaining = Math.max(0, diffMs / 3600000);
+	const hoursElapsed = WEEKLY_HOURS - hoursRemaining;
+	const timeElapsedPercent = (hoursElapsed / WEEKLY_HOURS) * 100;
+
+	return { hoursRemaining, hoursElapsed, timeElapsedPercent };
+}
+
+function formatDelta(delta: number): string {
+	const sign = delta >= 0 ? "+" : "";
+	const value = `${sign}${delta.toFixed(1)}%`;
+
+	if (delta > 5) return colors.green(value);
+	if (delta > 0) return colors.lightGray(value);
+	if (delta > -5) return colors.yellow(value);
+	if (delta > -15) return colors.orange(value);
+	return colors.red(value);
+}
+
+async function main() {
+	const limits = await getUsageLimits();
+
+	console.log("");
+	console.log(colors.bold("📊 Weekly Usage Analysis"));
+	console.log(colors.gray("─".repeat(40)));
+
+	if (!limits.seven_day) {
+		console.log(colors.red("No weekly limit data available"));
+		return;
+	}
+
+	const { utilization, resets_at } = limits.seven_day;
+	const { timeElapsedPercent } = calculateTimeProgress(resets_at);
+
+	const expectedUsage = timeElapsedPercent;
+	const delta = utilization - expectedUsage;
+
+	console.log("");
+	console.log(colors.gray("Weekly Limits Overview"));
+	console.log(colors.gray("─".repeat(50)));
+	console.log("");
+
+	const usageBar = formatProgressBar({
+		percentage: utilization,
+		length: 20,
+		style: "filled",
+		colorMode: "blue",
+		background: "none",
+	});
+	console.log(
+		`${colors.blue("Usage")} ${usageBar} ${colors.lightGray(utilization.toFixed(1))}${colors.gray("%")}`,
+	);
+
+	const timeBar = formatProgressBar({
+		percentage: timeElapsedPercent,
+		length: 20,
+		style: "filled",
+		colorMode: "purple",
+		background: "none",
+	});
+	console.log(
+		`${colors.purple("Time ")} ${timeBar} ${colors.lightGray(timeElapsedPercent.toFixed(1))}${colors.gray("%")} ${colors.gray("·")} ${formatDelta(delta)}`,
+	);
+
+	console.log("");
+	console.log(colors.gray("─".repeat(50)));
+	console.log("");
+
+	if (limits.five_hour) {
+		console.log(colors.gray("─".repeat(40)));
+		console.log("");
+		console.log(colors.gray("Session Limit (5h):"));
+		console.log(
+			`  ${formatProgressBar({
+				percentage: limits.five_hour.utilization,
+				length: 15,
+				style: "filled",
+				colorMode: "progressive",
+				background: "none",
+			})} ${colors.lightGray(limits.five_hour.utilization.toString())}${colors.gray("%")}`,
+		);
+		console.log("");
+	}
+}
+
+main();