@seanmars/tospec 0.14.1 → 0.14.2

package/dist/core/skill-metrics.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Skill duration metrics, derived from Claude Code transcripts.
+ *
+ * There is no tospec-side event to measure. The CLI is stateless by design
+ * (status comes from file existence), so it never learns when a workflow
+ * starts or ends — and CLI-call telemetry would miss the workflows that
+ * barely touch the CLI at all: `grill` only ever runs `tospec list`, and
+ * `explore` only an optional `tospec decision new`.
+ *
+ * Claude Code already records what we need. Every transcript entry in
+ * `<config>/projects/<encoded-cwd>/<session>.jsonl` carries an
+ * `attributionSkill` field naming the skill that entry belongs to, so skill
+ * timing is a read-only analysis of data that already exists — retroactively,
+ * with nothing to install. The cost is that the field is recent: sessions
+ * predating it yield no runs, which is reported rather than hidden.
+ *
+ * Two durations are reported per run because they answer different questions
+ * and diverge sharply in conversational workflows:
+ *
+ * - `span`    — wall clock, first to last entry. "How long did this take?"
+ * - `engaged` — span minus gaps over `idleGapMs`. "How much of that was work?"
+ *
+ * An interview loop like `grill` idles while the user thinks, so its span runs
+ * well above its engaged time; a continuous `apply` pass has the two nearly
+ * equal. Reporting only one of them would silently answer the other question.
+ *
+ * Pure parsing/aggregation is split from the directory-reading wrapper so
+ * vitest can exercise it without a transcript store on disk.
+ */
+/** Gap above which the user is considered away, excluded from `engaged`. */
+export declare const DEFAULT_IDLE_GAP_MS: number;
+/**
+ * Gap above which one skill's entries are treated as a second, separate run
+ * rather than one very long one. Without this, resuming `apply` the next
+ * morning reads as a single 14-hour run.
+ */
+export declare const DEFAULT_SPLIT_GAP_MS: number;
+/** One timestamped transcript line, reduced to what timing needs. */
+export interface TranscriptEntry {
+    timeMs: number;
+    /** Normalized skill name, or null for entries Claude Code did not attribute. */
+    skill: string | null;
+}
+/**
+ * Which tool a run's timing was derived from. Claude Code's `attributionSkill`
+ * is read directly from recorded data; Codex's is inferred by a heuristic
+ * (see codex-metrics.ts) — the two are never combined into one figure because
+ * they carry different confidence.
+ */
+export type MetricsSourceKind = 'claude-code' | 'codex';
+export interface SkillRun {
+    skill: string;
+    source: MetricsSourceKind;
+    /** Transcript file stem (the Claude Code session id, or the Codex rollout id). */
+    session: string;
+    startMs: number;
+    endMs: number;
+    spanMs: number;
+    engagedMs: number;
+    /** Entries inside the run window, including unattributed ones. */
+    entries: number;
+}
+export interface DurationStats {
+    medianMs: number;
+    maxMs: number;
+    totalMs: number;
+}
+export interface SkillAggregate {
+    skill: string;
+    source: MetricsSourceKind;
+    /** True when the skill is one of tospec's own generated workflows. */
+    workflow: boolean;
+    runs: number;
+    entries: number;
+    span: DurationStats;
+    engaged: DurationStats;
+}
+export interface MetricsThresholds {
+    idleGapMs: number;
+    splitGapMs: number;
+}
+export interface MetricsSource {
+    transcriptDir: string;
+    /** Null when the directory does not exist (no Claude Code history here). */
+    available: boolean;
+    sessions: number;
+    attributedSessions: number;
+    firstSeen: string | null;
+    lastSeen: string | null;
+}
+export interface SkillMetrics {
+    source: MetricsSource;
+    thresholds: MetricsThresholds;
+    skills: SkillAggregate[];
+    runs: SkillRun[];
+}
+export interface RunGroupingOptions {
+    idleGapMs?: number;
+    splitGapMs?: number;
+    /** Defaults to `'claude-code'` — every existing caller is that source. */
+    source?: MetricsSourceKind;
+}
+/**
+ * Claude Code's per-project transcript directory name: the absolute cwd with
+ * every non-alphanumeric character replaced by `-`. `D:\workspace\a.b` becomes
+ * `D--workspace-a-b` (the drive colon and the separator each contribute a dash,
+ * which is why the doubled dash is correct and not a bug).
+ */
+export declare function encodeProjectDirName(rootPath: string): string;
+export interface TranscriptDirOptions {
+    env?: NodeJS.ProcessEnv;
+    homedir?: string;
+}
+/**
+ * Locates the transcript directory for a project root. `CLAUDE_CONFIG_DIR` is
+ * honoured because Claude Code itself does; without it the default is
+ * `~/.claude`. Injectable env/homedir follows global-config.ts so path
+ * resolution stays testable.
+ */
+export declare function resolveTranscriptDir(rootPath: string, options?: TranscriptDirOptions): string;
+/**
+ * Collapses the two names one workflow is recorded under — the slash command
+ * (`tosx:apply`) and the skill (`tospec-apply`) — onto the workflow id. Without
+ * this every workflow's history is split across two unrelated-looking rows.
+ */
+export declare function normalizeSkillName(raw: string): string;
+export declare function isWorkflowSkill(skill: string): boolean;
+/**
+ * Parses one `.jsonl` transcript into timestamped entries, sorted by time.
+ * Malformed lines are skipped rather than fatal: transcripts are an append-only
+ * log written by another process and can be torn at the tail while a session
+ * is live.
+ */
+export declare function parseTranscript(text: string): TranscriptEntry[];
+/**
+ * Groups one session's entries into runs.
+ *
+ * Two rules carry the whole design:
+ *
+ * - An **unattributed** entry does not end a run. Tool results and the user's
+ *   own messages carry no `attributionSkill`, so treating them as boundaries
+ *   shatters a single 30-minute `apply` into a hundred two-entry fragments.
+ *   They are folded into the open run instead, because they are its work.
+ * - A **different skill** does end a run. Grouping all of one skill's entries
+ *   by min/max instead would make an A → B → A sequence count B's elapsed time
+ *   inside A's engaged total. Splitting keeps run windows disjoint, at the cost
+ *   of reporting a re-entered skill as several runs.
+ *
+ * A run is additionally split at any internal gap over `splitGapMs`.
+ */
+export declare function buildRuns(entries: TranscriptEntry[], session: string, options?: RunGroupingOptions): SkillRun[];
+/**
+ * The composite key identifying one report row: a skill under one source.
+ * Shared by aggregation, the daily/weekly/monthly series, and the frontend
+ * (which reproduces this exact format in JS, since it cannot import a TS
+ * module) — one definition of "row" everywhere a skill and its source must
+ * be kept apart rather than merged.
+ */
+export declare function skillRowKey(skill: string, source: MetricsSourceKind): string;
+/**
+ * Aggregates runs per skill-and-source pair, ordered by total engaged time
+ * (descending). Grouping by source too, not by skill alone, is what keeps a
+ * skill run under both tools from being summed into one figure — Claude
+ * Code's attribution and Codex's heuristic one carry different confidence and
+ * must stay distinguishable everywhere a skill is reported.
+ */
+export declare function aggregateRuns(runs: SkillRun[]): SkillAggregate[];
+export interface CollectMetricsOptions extends RunGroupingOptions, TranscriptDirOptions {
+    /** Drop runs that ended before this instant. */
+    sinceMs?: number;
+}
+/**
+ * Reads every transcript for a project root and derives skill timings.
+ *
+ * Every skill found is reported, tospec's own workflows and unrelated ones
+ * alike — there is deliberately no filtering by skill name. `workflow` on each
+ * aggregate labels which is which, so a caller that cares can tell them apart
+ * without this function deciding for it.
+ *
+ * A missing transcript directory is a reportable state (`available: false`),
+ * not an error: the project may simply never have been opened in Claude Code,
+ * and the caller renders that far better than a stack trace.
+ */
+export declare function collectSkillMetrics(rootPath: string, options?: CollectMetricsOptions): Promise<SkillMetrics>;
+//# sourceMappingURL=skill-metrics.d.ts.map

package/dist/core/skill-metrics.d.ts.map

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

package/dist/core/skill-metrics.js

@@ -0,0 +1,321 @@
+/**
+ * Skill duration metrics, derived from Claude Code transcripts.
+ *
+ * There is no tospec-side event to measure. The CLI is stateless by design
+ * (status comes from file existence), so it never learns when a workflow
+ * starts or ends — and CLI-call telemetry would miss the workflows that
+ * barely touch the CLI at all: `grill` only ever runs `tospec list`, and
+ * `explore` only an optional `tospec decision new`.
+ *
+ * Claude Code already records what we need. Every transcript entry in
+ * `<config>/projects/<encoded-cwd>/<session>.jsonl` carries an
+ * `attributionSkill` field naming the skill that entry belongs to, so skill
+ * timing is a read-only analysis of data that already exists — retroactively,
+ * with nothing to install. The cost is that the field is recent: sessions
+ * predating it yield no runs, which is reported rather than hidden.
+ *
+ * Two durations are reported per run because they answer different questions
+ * and diverge sharply in conversational workflows:
+ *
+ * - `span`    — wall clock, first to last entry. "How long did this take?"
+ * - `engaged` — span minus gaps over `idleGapMs`. "How much of that was work?"
+ *
+ * An interview loop like `grill` idles while the user thinks, so its span runs
+ * well above its engaged time; a continuous `apply` pass has the two nearly
+ * equal. Reporting only one of them would silently answer the other question.
+ *
+ * Pure parsing/aggregation is split from the directory-reading wrapper so
+ * vitest can exercise it without a transcript store on disk.
+ */
+import { promises as fs } from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { ALL_WORKFLOWS } from './shared/skill-generation.js';
+/** Gap above which the user is considered away, excluded from `engaged`. */
+export const DEFAULT_IDLE_GAP_MS = 5 * 60 * 1000;
+/**
+ * Gap above which one skill's entries are treated as a second, separate run
+ * rather than one very long one. Without this, resuming `apply` the next
+ * morning reads as a single 14-hour run.
+ */
+export const DEFAULT_SPLIT_GAP_MS = 30 * 60 * 1000;
+const CLAUDE_CONFIG_DIR_NAME = '.claude';
+// -----------------------------------------------------------------------------
+// Pure: paths
+// -----------------------------------------------------------------------------
+/**
+ * Claude Code's per-project transcript directory name: the absolute cwd with
+ * every non-alphanumeric character replaced by `-`. `D:\workspace\a.b` becomes
+ * `D--workspace-a-b` (the drive colon and the separator each contribute a dash,
+ * which is why the doubled dash is correct and not a bug).
+ */
+export function encodeProjectDirName(rootPath) {
+    return path.resolve(rootPath).replace(/[^a-zA-Z0-9]/g, '-');
+}
+/**
+ * Locates the transcript directory for a project root. `CLAUDE_CONFIG_DIR` is
+ * honoured because Claude Code itself does; without it the default is
+ * `~/.claude`. Injectable env/homedir follows global-config.ts so path
+ * resolution stays testable.
+ */
+export function resolveTranscriptDir(rootPath, options = {}) {
+    const env = options.env ?? process.env;
+    const configDir = env.CLAUDE_CONFIG_DIR
+        ? path.resolve(env.CLAUDE_CONFIG_DIR)
+        : path.join(options.homedir ?? os.homedir(), CLAUDE_CONFIG_DIR_NAME);
+    return path.join(configDir, 'projects', encodeProjectDirName(rootPath));
+}
+// -----------------------------------------------------------------------------
+// Pure: parsing
+// -----------------------------------------------------------------------------
+const WORKFLOW_IDS = new Set(ALL_WORKFLOWS);
+/**
+ * Collapses the two names one workflow is recorded under — the slash command
+ * (`tosx:apply`) and the skill (`tospec-apply`) — onto the workflow id. Without
+ * this every workflow's history is split across two unrelated-looking rows.
+ */
+export function normalizeSkillName(raw) {
+    return raw.replace(/^tosx:/, '').replace(/^tospec-/, '');
+}
+export function isWorkflowSkill(skill) {
+    return WORKFLOW_IDS.has(skill);
+}
+/**
+ * Parses one `.jsonl` transcript into timestamped entries, sorted by time.
+ * Malformed lines are skipped rather than fatal: transcripts are an append-only
+ * log written by another process and can be torn at the tail while a session
+ * is live.
+ */
+export function parseTranscript(text) {
+    const entries = [];
+    for (const line of text.split(/\r?\n/)) {
+        if (!line.trim())
+            continue;
+        let record;
+        try {
+            record = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (typeof record.timestamp !== 'string')
+            continue;
+        const timeMs = Date.parse(record.timestamp);
+        if (Number.isNaN(timeMs))
+            continue;
+        entries.push({
+            timeMs,
+            skill: typeof record.attributionSkill === 'string' && record.attributionSkill
+                ? normalizeSkillName(record.attributionSkill)
+                : null,
+        });
+    }
+    return entries.sort((a, b) => a.timeMs - b.timeMs);
+}
+// -----------------------------------------------------------------------------
+// Pure: run grouping
+// -----------------------------------------------------------------------------
+/**
+ * Groups one session's entries into runs.
+ *
+ * Two rules carry the whole design:
+ *
+ * - An **unattributed** entry does not end a run. Tool results and the user's
+ *   own messages carry no `attributionSkill`, so treating them as boundaries
+ *   shatters a single 30-minute `apply` into a hundred two-entry fragments.
+ *   They are folded into the open run instead, because they are its work.
+ * - A **different skill** does end a run. Grouping all of one skill's entries
+ *   by min/max instead would make an A → B → A sequence count B's elapsed time
+ *   inside A's engaged total. Splitting keeps run windows disjoint, at the cost
+ *   of reporting a re-entered skill as several runs.
+ *
+ * A run is additionally split at any internal gap over `splitGapMs`.
+ */
+export function buildRuns(entries, session, options = {}) {
+    const idleGapMs = options.idleGapMs ?? DEFAULT_IDLE_GAP_MS;
+    const splitGapMs = options.splitGapMs ?? DEFAULT_SPLIT_GAP_MS;
+    const source = options.source ?? 'claude-code';
+    const runs = [];
+    let skill = null;
+    let window = [];
+    const flush = () => {
+        if (skill === null || window.length === 0) {
+            window = [];
+            return;
+        }
+        let engagedMs = 0;
+        for (let i = 1; i < window.length; i++) {
+            const gap = window[i] - window[i - 1];
+            if (gap < idleGapMs)
+                engagedMs += gap;
+        }
+        const startMs = window[0];
+        const endMs = window[window.length - 1];
+        runs.push({
+            skill,
+            source,
+            session,
+            startMs,
+            endMs,
+            spanMs: endMs - startMs,
+            engagedMs,
+            entries: window.length,
+        });
+        window = [];
+    };
+    for (const entry of entries) {
+        if (entry.skill !== null && entry.skill !== skill) {
+            flush();
+            skill = entry.skill;
+        }
+        else if (window.length > 0 &&
+            entry.timeMs - window[window.length - 1] > splitGapMs) {
+            // Long silence: the same skill resumed later is a second run, not one
+            // run spanning the intervening hours.
+            flush();
+        }
+        // Entries before any attributed one belong to no skill; drop them.
+        if (skill === null)
+            continue;
+        window.push(entry.timeMs);
+    }
+    flush();
+    return runs;
+}
+// -----------------------------------------------------------------------------
+// Pure: aggregation
+// -----------------------------------------------------------------------------
+/** Lower median: for an even count, the lower of the two middle values. */
+function median(values) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    return sorted[Math.floor((sorted.length - 1) / 2)];
+}
+/**
+ * The composite key identifying one report row: a skill under one source.
+ * Shared by aggregation, the daily/weekly/monthly series, and the frontend
+ * (which reproduces this exact format in JS, since it cannot import a TS
+ * module) — one definition of "row" everywhere a skill and its source must
+ * be kept apart rather than merged.
+ */
+export function skillRowKey(skill, source) {
+    return `${skill}::${source}`;
+}
+function describe(values) {
+    return {
+        medianMs: median(values),
+        maxMs: values.length === 0 ? 0 : Math.max(...values),
+        totalMs: values.reduce((sum, v) => sum + v, 0),
+    };
+}
+/**
+ * Aggregates runs per skill-and-source pair, ordered by total engaged time
+ * (descending). Grouping by source too, not by skill alone, is what keeps a
+ * skill run under both tools from being summed into one figure — Claude
+ * Code's attribution and Codex's heuristic one carry different confidence and
+ * must stay distinguishable everywhere a skill is reported.
+ */
+export function aggregateRuns(runs) {
+    const bySkillSource = new Map();
+    for (const run of runs) {
+        const key = skillRowKey(run.skill, run.source);
+        const bucket = bySkillSource.get(key);
+        if (bucket)
+            bucket.push(run);
+        else
+            bySkillSource.set(key, [run]);
+    }
+    const aggregates = [];
+    for (const skillRuns of bySkillSource.values()) {
+        const skill = skillRuns[0].skill;
+        aggregates.push({
+            skill,
+            source: skillRuns[0].source,
+            workflow: isWorkflowSkill(skill),
+            runs: skillRuns.length,
+            entries: skillRuns.reduce((sum, r) => sum + r.entries, 0),
+            span: describe(skillRuns.map((r) => r.spanMs)),
+            engaged: describe(skillRuns.map((r) => r.engagedMs)),
+        });
+    }
+    return aggregates.sort((a, b) => b.engaged.totalMs - a.engaged.totalMs);
+}
+/**
+ * Reads every transcript for a project root and derives skill timings.
+ *
+ * Every skill found is reported, tospec's own workflows and unrelated ones
+ * alike — there is deliberately no filtering by skill name. `workflow` on each
+ * aggregate labels which is which, so a caller that cares can tell them apart
+ * without this function deciding for it.
+ *
+ * A missing transcript directory is a reportable state (`available: false`),
+ * not an error: the project may simply never have been opened in Claude Code,
+ * and the caller renders that far better than a stack trace.
+ */
+export async function collectSkillMetrics(rootPath, options = {}) {
+    const transcriptDir = resolveTranscriptDir(rootPath, options);
+    const thresholds = {
+        idleGapMs: options.idleGapMs ?? DEFAULT_IDLE_GAP_MS,
+        splitGapMs: options.splitGapMs ?? DEFAULT_SPLIT_GAP_MS,
+    };
+    const empty = {
+        source: {
+            transcriptDir,
+            available: false,
+            sessions: 0,
+            attributedSessions: 0,
+            firstSeen: null,
+            lastSeen: null,
+        },
+        thresholds,
+        skills: [],
+        runs: [],
+    };
+    let fileNames;
+    try {
+        fileNames = (await fs.readdir(transcriptDir)).filter((f) => f.endsWith('.jsonl'));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return empty;
+        throw error;
+    }
+    const allRuns = [];
+    let attributedSessions = 0;
+    for (const fileName of fileNames) {
+        let text;
+        try {
+            text = await fs.readFile(path.join(transcriptDir, fileName), 'utf8');
+        }
+        catch {
+            // A session file can vanish between readdir and read; skip it.
+            continue;
+        }
+        const runs = buildRuns(parseTranscript(text), path.basename(fileName, '.jsonl'), thresholds);
+        if (runs.length > 0)
+            attributedSessions++;
+        for (const run of runs) {
+            if (options.sinceMs !== undefined && run.endMs < options.sinceMs)
+                continue;
+            allRuns.push(run);
+        }
+    }
+    allRuns.sort((a, b) => a.startMs - b.startMs);
+    return {
+        source: {
+            transcriptDir,
+            available: true,
+            sessions: fileNames.length,
+            attributedSessions,
+            firstSeen: allRuns.length > 0 ? new Date(allRuns[0].startMs).toISOString() : null,
+            lastSeen: allRuns.length > 0
+                ? new Date(Math.max(...allRuns.map((r) => r.endMs))).toISOString()
+                : null,
+        },
+        thresholds,
+        skills: aggregateRuns(allRuns),
+        runs: allRuns,
+    };
+}
+//# sourceMappingURL=skill-metrics.js.map

package/dist/core/skill-metrics.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seanmars/tospec",
-  "version": "0.14.1",
+  "version": "0.14.2",
   "description": "Spec-driven development CLI for structured requirements and issue workflows",
   "license": "MIT",
   "homepage": "https://www.npmjs.com/package/@seanmars/tospec",