promptup-plugin 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gabikreal1
+
+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,78 @@
+# promptup-plugin
+
+AI coding skill evaluator for Claude Code — 11-dimension scoring, decision intelligence, PR reports.
+
+Zero infrastructure. Just SQLite at `~/.promptup/`.
+
+## Install
+
+```bash
+npx promptup-plugin
+```
+
+This installs everything: MCP server, skills, hooks, statusline, and default config. Restart Claude Code to activate.
+
+## What it does
+
+**4 MCP Tools:**
+
+| Tool | What |
+|------|------|
+| `evaluate_session` | Score a coding session across 11 skill dimensions |
+| `generate_pr_report` | Decision Quality Score (DQS) report for a git branch |
+| `get_status` | Sessions tracked, evaluations, decision counts |
+| `configure` | View/modify all PromptUp settings |
+
+**3 Skills:**
+- `/eval` — Run an evaluation
+- `/pr-report` — Generate PR report (optionally post to GitHub)
+- `/status` — Check tracking status
+
+**Statusline:** `pupmeter` shows your latest score in the Claude Code status bar.
+
+**Hooks:** Passive tracking via PostToolUse + session capture on Stop. Auto-eval on prompt count (configurable). Update check on SessionStart.
+
+## Requirements
+
+- Node.js >= 20
+- Claude Code
+
+## Manual setup (alternative)
+
+If you prefer not to use the installer:
+
+```json
+{
+  "mcpServers": {
+    "promptup": {
+      "command": "node",
+      "args": ["~/.promptup/plugin/dist/index.js"]
+    }
+  }
+}
+```
+
+## Configuration
+
+Run `configure` with no args to see all settings:
+
+```
+evaluation.auto_trigger    off | prompt_count | session_end
+evaluation.interval        prompts between auto-evals (default: 10)
+evaluation.weight_profile  balanced | greenfield | bugfix | refactor | security_review
+evaluation.feedback_detail brief | standard | detailed
+decisions.signal_filter    high | high+medium | all
+pr_report.auto_post        true | false
+```
+
+Config file: `~/.promptup/config.json`
+
+## Uninstall
+
+```bash
+npx promptup-plugin --uninstall
+```
+
+## License
+
+MIT

package/bin/install.cjs

@@ -0,0 +1,306 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// Colors
+const cyan = '\x1b[36m';
+const green = '\x1b[32m';
+const yellow = '\x1b[33m';
+const red = '\x1b[31m';
+const bold = '\x1b[1m';
+const dim = '\x1b[2m';
+const reset = '\x1b[0m';
+
+const pkg = require('../package.json');
+const args = process.argv.slice(2);
+const hasGlobal = args.includes('--global') || args.includes('-g');
+const hasLocal = args.includes('--local') || args.includes('-l');
+const hasUninstall = args.includes('--uninstall') || args.includes('-u');
+
+const HOME = os.homedir();
+const PLUGIN_DIR = path.join(HOME, '.promptup', 'plugin');
+const DATA_DIR = path.join(HOME, '.promptup');
+const CLAUDE_DIR = path.join(HOME, '.claude');
+
+// ─── Banner ─────────────────────────────────────────────────────────────────
+
+console.log(`
+${bold}${cyan}  ┌─────────────────────────────────────┐${reset}
+${bold}${cyan}  │         ${green}PROMPTUP${cyan}  v${pkg.version}            │${reset}
+${bold}${cyan}  │   AI coding skill evaluator for      │${reset}
+${bold}${cyan}  │   Claude Code                         │${reset}
+${bold}${cyan}  └─────────────────────────────────────┘${reset}
+`);
+
+// ─── Uninstall ──────────────────────────────────────────────────────────────
+
+if (hasUninstall) {
+  console.log(`${yellow}Uninstalling PromptUp...${reset}\n`);
+
+  // Remove skills
+  const skillsDir = path.join(CLAUDE_DIR, 'skills');
+  for (const skill of ['eval', 'pr-report', 'status']) {
+    const dest = path.join(skillsDir, skill);
+    if (fs.existsSync(dest)) {
+      fs.rmSync(dest, { recursive: true });
+      console.log(`  ${red}✗${reset} Removed skill: ${skill}`);
+    }
+  }
+
+  // Remove MCP from global settings
+  const settingsLocal = path.join(CLAUDE_DIR, 'settings.local.json');
+  if (fs.existsSync(settingsLocal)) {
+    try {
+      const settings = JSON.parse(fs.readFileSync(settingsLocal, 'utf-8'));
+      if (settings.mcpServers?.promptup) {
+        delete settings.mcpServers.promptup;
+        fs.writeFileSync(settingsLocal, JSON.stringify(settings, null, 2) + '\n');
+        console.log(`  ${red}✗${reset} Removed MCP server from settings.local.json`);
+      }
+    } catch {}
+  }
+
+  console.log(`\n${green}PromptUp uninstalled.${reset}`);
+  console.log(`${dim}Data preserved at ${DATA_DIR} — delete manually if desired.${reset}\n`);
+  process.exit(0);
+}
+
+// ─── Detect scope ───────────────────────────────────────────────────────────
+
+let scope = 'global';
+if (hasLocal) scope = 'local';
+if (hasGlobal) scope = 'global';
+
+if (!hasLocal && !hasGlobal) {
+  // Default to global
+  scope = 'global';
+  console.log(`${dim}Installing globally (use --local for project-only)${reset}\n`);
+}
+
+// ─── Find package root (where npx extracted us) ────────────────────────────
+
+const packageRoot = path.resolve(__dirname, '..');
+
+// ─── Step 1: Copy plugin to ~/.promptup/plugin ─────────────────────────────
+
+console.log(`${bold}Setting up PromptUp...${reset}\n`);
+
+// Ensure dirs exist
+fs.mkdirSync(PLUGIN_DIR, { recursive: true });
+fs.mkdirSync(DATA_DIR, { recursive: true });
+
+// Copy dist/
+copyDirSync(path.join(packageRoot, 'dist'), path.join(PLUGIN_DIR, 'dist'));
+console.log(`  ${green}✓${reset} Installed plugin runtime`);
+
+// Copy hooks/
+copyDirSync(path.join(packageRoot, 'hooks'), path.join(PLUGIN_DIR, 'hooks'));
+// Make hooks executable
+for (const f of fs.readdirSync(path.join(PLUGIN_DIR, 'hooks'))) {
+  if (f.endsWith('.sh')) {
+    fs.chmodSync(path.join(PLUGIN_DIR, 'hooks', f), 0o755);
+  }
+}
+console.log(`  ${green}✓${reset} Installed hooks`);
+
+// Copy skills/
+copyDirSync(path.join(packageRoot, 'skills'), path.join(PLUGIN_DIR, 'skills'));
+console.log(`  ${green}✓${reset} Installed skills`);
+
+// Copy statusline
+if (fs.existsSync(path.join(packageRoot, 'statusline.sh'))) {
+  fs.copyFileSync(
+    path.join(packageRoot, 'statusline.sh'),
+    path.join(PLUGIN_DIR, 'statusline.sh'),
+  );
+  fs.chmodSync(path.join(PLUGIN_DIR, 'statusline.sh'), 0o755);
+  console.log(`  ${green}✓${reset} Installed statusline`);
+}
+
+// Copy package.json for version tracking
+fs.copyFileSync(
+  path.join(packageRoot, 'package.json'),
+  path.join(PLUGIN_DIR, 'package.json'),
+);
+
+// ─── Step 2: Install skills to ~/.claude/skills/ ────────────────────────────
+
+const skillsDir = path.join(CLAUDE_DIR, 'skills');
+fs.mkdirSync(skillsDir, { recursive: true });
+
+for (const skill of ['eval', 'pr-report', 'status']) {
+  const src = path.join(PLUGIN_DIR, 'skills', skill);
+  const dest = path.join(skillsDir, skill);
+  if (fs.existsSync(src)) {
+    copyDirSync(src, dest);
+    console.log(`  ${green}✓${reset} Skill: /${skill}`);
+  }
+}
+
+// ─── Step 3: Configure MCP server ───────────────────────────────────────────
+
+const mcpEntry = {
+  command: 'node',
+  args: [path.join(PLUGIN_DIR, 'dist', 'index.js')],
+};
+
+if (scope === 'global') {
+  // Add to ~/.claude/.mcp.json (global MCP config)
+  const mcpPath = path.join(CLAUDE_DIR, '.mcp.json');
+  const mcp = fs.existsSync(mcpPath)
+    ? JSON.parse(fs.readFileSync(mcpPath, 'utf-8'))
+    : {};
+
+  if (!mcp.mcpServers) mcp.mcpServers = {};
+  mcp.mcpServers.promptup = mcpEntry;
+  fs.writeFileSync(mcpPath, JSON.stringify(mcp, null, 2) + '\n');
+  console.log(`  ${green}✓${reset} MCP server → ~/.claude/.mcp.json (global)`);
+} else {
+  // Add to .mcp.json in current directory
+  const mcpPath = path.join(process.cwd(), '.mcp.json');
+  const mcp = fs.existsSync(mcpPath)
+    ? JSON.parse(fs.readFileSync(mcpPath, 'utf-8'))
+    : {};
+
+  if (!mcp.mcpServers) mcp.mcpServers = {};
+  mcp.mcpServers.promptup = mcpEntry;
+  fs.writeFileSync(mcpPath, JSON.stringify(mcp, null, 2) + '\n');
+  console.log(`  ${green}✓${reset} MCP server → .mcp.json (local)`);
+}
+
+// ─── Step 4: Configure hooks ────────────────────────────────────────────────
+
+const settingsPath = path.join(CLAUDE_DIR, 'settings.local.json');
+const settings = fs.existsSync(settingsPath)
+  ? JSON.parse(fs.readFileSync(settingsPath, 'utf-8'))
+  : {};
+
+if (!settings.hooks) settings.hooks = {};
+
+// SessionStart: update check
+if (!settings.hooks.SessionStart) settings.hooks.SessionStart = [];
+const hasUpdateHook = settings.hooks.SessionStart.some(
+  (h) => h.hooks?.some((hk) => hk.command?.includes('check-update.sh')),
+);
+if (!hasUpdateHook) {
+  settings.hooks.SessionStart.push({
+    matcher: '',
+    hooks: [
+      {
+        type: 'command',
+        command: `bash ${path.join(PLUGIN_DIR, 'hooks', 'check-update.sh')}`,
+        async: true,
+      },
+    ],
+  });
+  console.log(`  ${green}✓${reset} Hook: SessionStart → update check`);
+}
+
+// UserPromptSubmit: auto-eval
+if (!settings.hooks.UserPromptSubmit) settings.hooks.UserPromptSubmit = [];
+const hasAutoEval = settings.hooks.UserPromptSubmit.some(
+  (h) => h.hooks?.some((hk) => hk.command?.includes('auto-eval.sh')),
+);
+if (!hasAutoEval) {
+  settings.hooks.UserPromptSubmit.push({
+    matcher: '',
+    hooks: [
+      {
+        type: 'command',
+        command: `bash ${path.join(PLUGIN_DIR, 'hooks', 'auto-eval.sh')}`,
+        async: true,
+      },
+    ],
+  });
+  console.log(`  ${green}✓${reset} Hook: UserPromptSubmit → auto-eval`);
+}
+
+// Statusline
+if (!settings.statusLine) {
+  settings.statusLine = {
+    type: 'command',
+    command: `bash ${path.join(PLUGIN_DIR, 'statusline.sh')}`,
+    padding: 2,
+  };
+  console.log(`  ${green}✓${reset} Statusline: pupmeter`);
+}
+
+fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+
+// ─── Step 5: Create default config ─────────────────────────────────────────
+
+const configPath = path.join(DATA_DIR, 'config.json');
+if (!fs.existsSync(configPath)) {
+  const defaultConfig = {
+    evaluation: {
+      auto_trigger: 'off',
+      interval: 10,
+      weight_profile: 'balanced',
+      timeout_seconds: 120,
+      feedback_detail: 'standard',
+    },
+    dimensions: {
+      enabled: ['all'],
+      custom_weights: null,
+    },
+    decisions: {
+      signal_filter: 'high+medium',
+      show_routine_count: true,
+    },
+    pr_report: {
+      auto_post: false,
+      base_branch: 'auto',
+    },
+    classification: {
+      bands: { junior: [0, 40], middle: [41, 70], senior: [71, 100] },
+    },
+    statusline: {
+      enabled: true,
+      show_recommendation: true,
+    },
+  };
+  fs.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2) + '\n');
+  console.log(`  ${green}✓${reset} Config: ~/.promptup/config.json`);
+}
+
+// ─── Done ───────────────────────────────────────────────────────────────────
+
+console.log(`
+${bold}${green}PromptUp installed!${reset}
+
+  ${bold}Tools:${reset}
+    evaluate_session    — Evaluate coding sessions (11 dimensions)
+    generate_pr_report  — DQS reports for git branches
+    get_status          — Tracking status & activity
+    configure           — View/modify settings
+
+  ${bold}Skills:${reset}
+    /eval               — Run an evaluation
+    /pr-report          — Generate PR report
+    /status             — Check status
+
+  ${bold}Statusline:${reset}
+    pupmeter shows your latest score in the status bar
+
+  ${bold}Config:${reset}
+    ~/.promptup/config.json
+
+${dim}Restart Claude Code to activate. Run with --uninstall to remove.${reset}
+`);
+
+// ─── Helpers ────────────────────────────────────────────────────────────────
+
+function copyDirSync(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirSync(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}

package/bin/promptup-plugin

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+const require = createRequire(import.meta.url);
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// Load the CJS installer
+require(join(__dirname, 'install.cjs'));

package/dist/config.d.ts

@@ -0,0 +1,40 @@
+/**
+ * PromptUp configuration manager.
+ *
+ * Manages ~/.promptup/config.json with defaults.
+ * First run creates the file with recommended settings.
+ * Users override what they want — the file IS the documentation.
+ */
+export interface PromptUpConfig {
+    evaluation: {
+        auto_trigger: 'off' | 'prompt_count' | 'session_end';
+        interval: number;
+        weight_profile: 'balanced' | 'greenfield' | 'bugfix' | 'refactor' | 'security_review';
+        timeout_seconds: number;
+        feedback_detail: 'brief' | 'standard' | 'detailed';
+    };
+    dimensions: {
+        enabled: string[];
+        custom_weights: Record<string, number> | null;
+    };
+    decisions: {
+        signal_filter: 'high' | 'high+medium' | 'all';
+        show_routine_count: boolean;
+    };
+    pr_report: {
+        auto_post: boolean;
+        base_branch: string;
+    };
+    classification: {
+        bands: Record<string, [number, number]>;
+    };
+    statusline: {
+        enabled: boolean;
+        show_recommendation: boolean;
+    };
+}
+export declare const DEFAULT_CONFIG: PromptUpConfig;
+export declare function loadConfig(): PromptUpConfig;
+export declare function saveConfig(config: PromptUpConfig): void;
+export declare function updateConfig(updates: Record<string, unknown>): PromptUpConfig;
+export declare function getConfigValue(path: string): unknown;

package/dist/config.js

@@ -0,0 +1,123 @@
+/**
+ * PromptUp configuration manager.
+ *
+ * Manages ~/.promptup/config.json with defaults.
+ * First run creates the file with recommended settings.
+ * Users override what they want — the file IS the documentation.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+// ─── Defaults (the PromptUp opinion) ────────────────────────────────────────
+export const DEFAULT_CONFIG = {
+    evaluation: {
+        auto_trigger: 'off',
+        interval: 10,
+        weight_profile: 'balanced',
+        timeout_seconds: 120,
+        feedback_detail: 'standard',
+    },
+    dimensions: {
+        enabled: ['all'],
+        custom_weights: null,
+    },
+    decisions: {
+        signal_filter: 'high+medium',
+        show_routine_count: true,
+    },
+    pr_report: {
+        auto_post: false,
+        base_branch: 'auto',
+    },
+    classification: {
+        bands: {
+            junior: [0, 40],
+            middle: [41, 70],
+            senior: [71, 100],
+        },
+    },
+    statusline: {
+        enabled: true,
+        show_recommendation: true,
+    },
+};
+// ─── Config path ────────────────────────────────────────────────────────────
+function getConfigPath() {
+    const dir = process.env.CLAUDE_PLUGIN_DATA ?? join(homedir(), '.promptup');
+    return join(dir, 'config.json');
+}
+// ─── Read / Write ───────────────────────────────────────────────────────────
+export function loadConfig() {
+    const path = getConfigPath();
+    if (!existsSync(path)) {
+        // First run — create with defaults
+        saveConfig(DEFAULT_CONFIG);
+        return { ...DEFAULT_CONFIG };
+    }
+    try {
+        const raw = JSON.parse(readFileSync(path, 'utf-8'));
+        // Deep merge with defaults so new fields get populated on upgrade
+        return deepMerge(DEFAULT_CONFIG, raw);
+    }
+    catch {
+        return { ...DEFAULT_CONFIG };
+    }
+}
+export function saveConfig(config) {
+    const path = getConfigPath();
+    const dir = dirname(path);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(path, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+export function updateConfig(updates) {
+    const config = loadConfig();
+    // Apply dot-path updates: "evaluation.interval" = 5
+    for (const [key, value] of Object.entries(updates)) {
+        setNestedValue(config, key, value);
+    }
+    saveConfig(config);
+    return config;
+}
+export function getConfigValue(path) {
+    const config = loadConfig();
+    return getNestedValue(config, path);
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function deepMerge(defaults, overrides) {
+    const result = { ...defaults };
+    for (const key of Object.keys(overrides)) {
+        if (typeof defaults[key] === 'object' &&
+            defaults[key] !== null &&
+            !Array.isArray(defaults[key]) &&
+            typeof overrides[key] === 'object' &&
+            overrides[key] !== null &&
+            !Array.isArray(overrides[key])) {
+            result[key] = deepMerge(defaults[key], overrides[key]);
+        }
+        else {
+            result[key] = overrides[key];
+        }
+    }
+    return result;
+}
+function setNestedValue(obj, path, value) {
+    const parts = path.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (current[parts[i]] === undefined)
+            current[parts[i]] = {};
+        current = current[parts[i]];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+function getNestedValue(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === undefined || current === null)
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}

package/dist/db.d.ts

@@ -0,0 +1,35 @@
+/**
+ * SQLite database layer for the standalone PromptUp plugin.
+ *
+ * Fully self-contained — no imports from @promptup/shared or any workspace package.
+ * Database lives at ${CLAUDE_PLUGIN_DATA}/promptup.db or ~/.promptup/promptup.db.
+ * WAL mode enabled for concurrent reads.
+ */
+import Database from 'better-sqlite3';
+import type { SessionRow, EvaluationRow, DecisionRow, GitActivityRow, PRReportRow, MessageRow } from './shared/types.js';
+export declare function getDb(): Database.Database;
+export declare function initDatabase(): void;
+export declare function closeDatabase(): void;
+export declare function insertSession(session: SessionRow): void;
+export declare function getSession(id: string): SessionRow | null;
+export declare function updateSession(id: string, updates: Partial<SessionRow>): void;
+export declare function getRecentSessions(limit?: number): SessionRow[];
+export declare function insertMessages(messages: MessageRow[]): void;
+export declare function getMessagesBySession(sessionId: string, limit?: number, offset?: number): MessageRow[];
+export declare function insertEvaluation(evaluation: EvaluationRow): void;
+export declare function getLatestEvaluation(sessionId?: string): EvaluationRow | null;
+export declare function getEvaluationsBySession(sessionId: string): EvaluationRow[];
+export declare function getRecentEvaluations(limit?: number): EvaluationRow[];
+export declare function insertDecision(decision: DecisionRow): void;
+export declare function getDecisionsBySession(sessionId: string): DecisionRow[];
+export declare function getDecisionsBySessions(sessionIds: string[]): DecisionRow[];
+export declare function insertGitActivity(activity: GitActivityRow): void;
+export declare function getSessionsByBranch(branch: string): string[];
+export declare function getSessionsByTimeRange(from: string, to: string, projectPath?: string): SessionRow[];
+export declare function insertPRReport(report: PRReportRow): void;
+export declare function getPRReportByBranch(branch: string, repo: string): PRReportRow | null;
+export declare function getStats(): {
+    sessions: number;
+    evaluations: number;
+    decisions: number;
+};