cc-proficiency 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,264 @@
+export interface RawTranscriptEntry {
+    parentUuid: string | null;
+    isSidechain: boolean;
+    type: string;
+    uuid: string;
+    timestamp: string;
+    sessionId: string;
+    cwd: string;
+    version: string;
+    gitBranch?: string;
+    slug?: string;
+    userType?: string;
+    permissionMode?: string;
+    promptId?: string;
+    message?: {
+        role: string;
+        model?: string;
+        content: string | ContentBlock[];
+        usage?: TokenUsage;
+        stop_reason?: string;
+    };
+    toolUseResult?: ToolUseResult;
+    data?: ProgressData;
+    subtype?: string;
+    hookCount?: number;
+    hookInfos?: Array<{
+        command: string;
+        durationMs: number;
+    }>;
+    preventedContinuation?: boolean;
+}
+export interface ContentBlock {
+    type: string;
+    text?: string;
+    id?: string;
+    name?: string;
+    input?: Record<string, unknown>;
+    tool_use_id?: string;
+    content?: string | ContentBlock[];
+    is_error?: boolean;
+    caller?: {
+        type: string;
+    };
+}
+export interface TokenUsage {
+    input_tokens?: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+    output_tokens?: number;
+}
+export interface ProgressData {
+    type: string;
+    hookEvent?: string;
+    hookName?: string;
+    command?: string;
+    prompt?: string;
+    agentId?: string;
+}
+export interface ToolUseResult {
+    type?: string;
+    filePath?: string;
+    oldString?: string;
+    newString?: string;
+    structuredPatch?: unknown[];
+    userModified?: boolean;
+    replaceAll?: boolean;
+}
+export type NormalizedEvent = UserPromptEvent | ToolCallEvent | ToolResultEvent | HookProgressEvent | SystemStopEvent | FileSnapshotEvent | UnknownEvent;
+export interface UserPromptEvent {
+    kind: "user_prompt";
+    sessionId: string;
+    timestamp: string;
+    content: string;
+    permissionMode?: string;
+}
+export interface ToolCallEvent {
+    kind: "tool_call";
+    sessionId: string;
+    timestamp: string;
+    toolName: string;
+    toolId: string;
+    input: Record<string, unknown>;
+    callerType?: string;
+}
+export interface ToolResultEvent {
+    kind: "tool_result";
+    sessionId: string;
+    timestamp: string;
+    toolId: string;
+    isError: boolean;
+}
+export interface HookProgressEvent {
+    kind: "hook_progress";
+    sessionId: string;
+    timestamp: string;
+    hookEvent: string;
+    hookName: string;
+    command: string;
+}
+export interface SystemStopEvent {
+    kind: "system_stop";
+    sessionId: string;
+    timestamp: string;
+    hookCount: number;
+    preventedContinuation: boolean;
+}
+export interface FileSnapshotEvent {
+    kind: "file_snapshot";
+    sessionId: string;
+    timestamp: string;
+}
+export interface UnknownEvent {
+    kind: "unknown";
+    sessionId: string;
+    timestamp: string;
+    rawType: string;
+}
+export interface ParsedSession {
+    sessionId: string;
+    startTime: string;
+    endTime: string;
+    project: string;
+    events: NormalizedEvent[];
+    version: string;
+}
+export interface ExtractedSignals {
+    ccMastery: CCMasterySignals;
+    toolMcp: ToolMcpSignals;
+    agentic: AgenticSignals;
+    promptCraft: PromptCraftSignals;
+    contextMgmt: ContextMgmtSignals;
+    outcomes: OutcomeSignals;
+}
+export interface CCMasterySignals {
+    hasGlobalClaudeMd: boolean;
+    globalClaudeMdHasImports: boolean;
+    projectClaudeMdCount: number;
+    hasCustomHooks: boolean;
+    hookWithMatcherCount: number;
+    pluginCount: number;
+    pluginsUsedInTranscripts: number;
+    uniqueSkillsUsed: number;
+    usedPlanMode: boolean;
+    hasRulesFiles: boolean;
+}
+export interface ToolMcpSignals {
+    uniqueToolsUsed: number;
+    uniqueMcpServersUsed: number;
+    lspToolCallCount: number;
+    deliberateWorkflowCount: number;
+    editSuccessRate: number;
+    totalToolCalls: number;
+}
+export interface AgenticSignals {
+    uniqueSubagentTypes: number;
+    totalSubagentCalls: number;
+    parallelToolCallCount: number;
+    usedWorktree: boolean;
+    multiSessionProjectCount: number;
+    usedTaskManagement: boolean;
+}
+export interface PromptCraftSignals {
+    structuredPromptRatio: number;
+    iterativeRefinementCount: number;
+    uniqueCommandsUsed: number;
+    contextProvisionCount: number;
+    totalPrompts: number;
+}
+export interface ContextMgmtSignals {
+    memoryFileCount: number;
+    activeMemoryFiles: number;
+    projectCount: number;
+    sessionCount: number;
+    sessionDurations: number[];
+}
+export interface OutcomeSignals {
+    editAcceptanceRate: number;
+    permissionModeProgression: number;
+    errorRecoveryRate: number;
+    repeatFailureRate: number;
+}
+export type DomainId = "cc-mastery" | "tool-mcp" | "agentic" | "prompt-craft" | "context-mgmt";
+export type ConfidenceLevel = "low" | "medium" | "high";
+export interface DomainScore {
+    id: DomainId;
+    label: string;
+    score: number;
+    weight: number;
+    confidence: ConfidenceLevel;
+    dataPoints: number;
+}
+export interface FeatureInventory {
+    hooks: Array<{
+        name: string;
+        count: number;
+    }>;
+    skills: Array<{
+        name: string;
+        count: number;
+    }>;
+    mcpServers: string[];
+    topTools: Array<{
+        name: string;
+        count: number;
+    }>;
+    totalToolCalls: number;
+    uniqueToolCount: number;
+    usedPlanMode: boolean;
+    hasMemory: boolean;
+    hasRules: boolean;
+    featureScores?: Record<string, number>;
+}
+export interface ProficiencyResult {
+    username: string;
+    timestamp: string;
+    domains: DomainScore[];
+    features: FeatureInventory;
+    sessionCount: number;
+    projectCount: number;
+    phase: "calibrating" | "early" | "full";
+    setupChecklist: SetupChecklist;
+}
+export interface SetupChecklist {
+    hasClaudeMd: boolean;
+    hasHooks: boolean;
+    hasPlugins: boolean;
+    hasMcpServers: boolean;
+    hasMemory: boolean;
+    hasRules: boolean;
+}
+export interface CCProficiencyConfig {
+    username?: string;
+    gistId?: string;
+    autoUpload: boolean;
+    public: boolean;
+    locale?: string;
+}
+export interface SessionSnapshot {
+    sessionId: string;
+    timestamp: string;
+    project: string;
+    signals: ExtractedSignals;
+    scoringVersion: string;
+}
+export interface LocalStore {
+    processedSessionIds: string[];
+    snapshots: SessionSnapshot[];
+    lastResult?: ProficiencyResult;
+    lastUpdated?: string;
+}
+export interface QueueEntry {
+    sessionId: string;
+    transcriptPath: string;
+    cwd: string;
+    timestamp: string;
+}
+export interface HistoryEntry {
+    display: string;
+    pastedContents: Record<string, unknown>;
+    timestamp: number;
+    project: string;
+    sessionId: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// ── Raw JSONL Entry (from Claude Code transcripts) ──
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,uDAAuD"}

package/dist/utils/ci-detect.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Detect if the current environment is CI/CD.
+ * CI sessions should be excluded from proficiency scoring.
+ */
+export declare function isCIEnvironment(): boolean;
+//# sourceMappingURL=ci-detect.d.ts.map

package/dist/utils/ci-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-detect.d.ts","sourceRoot":"","sources":["../../src/utils/ci-detect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAYzC"}

package/dist/utils/ci-detect.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCIEnvironment = isCIEnvironment;
+/**
+ * Detect if the current environment is CI/CD.
+ * CI sessions should be excluded from proficiency scoring.
+ */
+function isCIEnvironment() {
+    const env = process.env;
+    return !!(env.CI === "true" ||
+        env.GITHUB_ACTIONS === "true" ||
+        env.GITLAB_CI === "true" ||
+        env.JENKINS_URL ||
+        env.CODESPACES === "true" ||
+        env.BUILDKITE === "true" ||
+        env.CIRCLECI === "true" ||
+        env.TRAVIS === "true");
+}
+//# sourceMappingURL=ci-detect.js.map

package/dist/utils/ci-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-detect.js","sourceRoot":"","sources":["../../src/utils/ci-detect.ts"],"names":[],"mappings":";;AAIA,0CAYC;AAhBD;;;GAGG;AACH,SAAgB,eAAe;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,OAAO,CAAC,CAAC,CACP,GAAG,CAAC,EAAE,KAAK,MAAM;QACjB,GAAG,CAAC,cAAc,KAAK,MAAM;QAC7B,GAAG,CAAC,SAAS,KAAK,MAAM;QACxB,GAAG,CAAC,WAAW;QACf,GAAG,CAAC,UAAU,KAAK,MAAM;QACzB,GAAG,CAAC,SAAS,KAAK,MAAM;QACxB,GAAG,CAAC,QAAQ,KAAK,MAAM;QACvB,GAAG,CAAC,MAAM,KAAK,MAAM,CACtB,CAAC;AACJ,CAAC"}

package/hooks/hooks.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/session-end.js",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/session-end.ts

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+
+/**
+ * Stop hook for cc-proficiency.
+ * Reads session info from stdin, appends to queue, spawns processor.
+ * Must exit 0 in <1 second.
+ */
+
+import { spawn } from "node:child_process";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { appendFileSync, existsSync, mkdirSync } from "node:fs";
+
+const STORE_DIR = join(homedir(), ".cc-proficiency");
+const QUEUE_FILE = join(STORE_DIR, "queue.jsonl");
+
+// CI/CD detection — skip if non-interactive
+const CI_VARS = ["CI", "GITHUB_ACTIONS", "GITLAB_CI", "CODESPACES", "BUILDKITE", "CIRCLECI", "TRAVIS"];
+if (CI_VARS.some((v) => process.env[v] === "true") || process.env.JENKINS_URL) {
+  process.exit(0);
+}
+
+// Read stdin (hook payload)
+let input = "";
+process.stdin.setEncoding("utf-8");
+process.stdin.on("data", (chunk) => { input += chunk; });
+process.stdin.on("end", () => {
+  try {
+    const payload = JSON.parse(input);
+    const entry = {
+      sessionId: payload.session_id ?? "",
+      transcriptPath: payload.transcript_path ?? "",
+      cwd: payload.cwd ?? "",
+      timestamp: new Date().toISOString(),
+    };
+
+    if (!entry.sessionId || !entry.transcriptPath) {
+      process.exit(0);
+    }
+
+    // Ensure store dir
+    if (!existsSync(STORE_DIR)) {
+      mkdirSync(STORE_DIR, { recursive: true });
+    }
+
+    // Append to queue
+    appendFileSync(QUEUE_FILE, JSON.stringify(entry) + "\n", "utf-8");
+
+    // Spawn processor as detached child (fire-and-forget)
+    try {
+      // When compiled: dist/hooks/session-end.js → dist/cli.js is at ../cli.js
+      const processorPath = join(__dirname, "..", "cli.js");
+      if (existsSync(processorPath)) {
+        const child = spawn("node", [processorPath, "process"], {
+          detached: true,
+          stdio: "ignore",
+        });
+        child.unref();
+      }
+    } catch {
+      // Processor spawn failed — user can run manually
+    }
+  } catch {
+    // Invalid JSON or other error — exit cleanly
+  }
+
+  process.exit(0);
+});
+
+// Timeout safety — exit after 4 seconds regardless
+setTimeout(() => process.exit(0), 4000);

package/hooks/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "../dist/hooks",
+    "rootDir": ".",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["*.ts"]
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "cc-proficiency",
+  "version": "0.1.0",
+  "description": "Claude Code proficiency badge generator — analyze usage patterns across 5 domains aligned with Claude Certified Architect",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "cc-proficiency": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc && tsc -p hooks/tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/",
+    "hooks/",
+    ".claude-plugin/",
+    "skills/",
+    "README.md"
+  ],
+  "keywords": [
+    "claude-code",
+    "proficiency",
+    "badge",
+    "analytics",
+    "certification",
+    "architect",
+    "svg"
+  ],
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}

package/skills/proficiency/SKILL.md

@@ -0,0 +1,15 @@
+# Proficiency Badge
+
+Analyze your Claude Code usage and display proficiency scores.
+
+## Usage
+
+Run `/proficiency` to see your current proficiency scores across 5 domains aligned with the Claude Certified Architect exam.
+
+## Instructions
+
+1. Run `cc-proficiency analyze --full` via Bash to compute scores from all sessions
+2. Display the results to the user
+3. Run `cc-proficiency explain` via Bash to show improvement tips
+4. If the user wants to generate/update their badge, run `cc-proficiency badge`
+5. If the user wants to push to GitHub, run `cc-proficiency push`