@skillsmith/cli 0.6.2 → 0.6.4

package/dist/src/commands/telemetry.action.js

@@ -0,0 +1,350 @@
+/**
+ * @fileoverview `skillsmith telemetry` action implementations + telemetry wrappers.
+ * @module @skillsmith/cli/commands/telemetry.action
+ * @see SMI-5128 batch D — sibling-split of telemetry.ts so the 6 subcommand
+ *   handlers can be wrapped with withTelemetry without exceeding the 500-LOC
+ *   gate. Mirrors the sync.action.ts / search.action.ts convention (SMI-5127):
+ *   the run* business logic + the wrapped *Action exports live here; the
+ *   commander factory stays in telemetry.ts and imports the wrapped actions.
+ *
+ * Privacy invariants (plan line 719):
+ *   - anonymousId is NEVER printed in full. Only the last 8 hex chars appear in stdout.
+ *   - The full SHA-256 hex travels only to the events endpoint in hook payloads.
+ */
+import { existsSync, copyFileSync, chmodSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { readdirSync, unlinkSync, statSync } from 'node:fs';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+import chalk from 'chalk';
+import { loadManifest, saveManifest, generateAnonymousId, shouldRotateAnonymousId, rotateAnonymousId, sweepExpiredPreviousId, } from '../utils/manifest.js';
+import { loadClaudeSettings, addSkillHookEntries, removeSkillHookEntries, writeClaudeSettings, TelemetryHookError, } from './telemetry.helpers.js';
+import { sanitizeError } from '../utils/sanitize.js';
+import { withTelemetry } from '@skillsmith/core/telemetry';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const PRIVACY_URL = 'https://skillsmith.app/privacy#telemetry';
+const DEFAULT_ENDPOINT = 'https://vrcnzpmndtroqxxoqkzy.supabase.co/functions/v1/events';
+const ORPHAN_TTL_MS = 60 * 60 * 1000; // 1 hour
+// All path helpers resolved at call time so test harnesses that swap HOME work.
+function hookScriptPath() {
+    return join(homedir(), '.skillsmith', 'hooks', 'skill-telemetry.sh');
+}
+function runDir() {
+    return join(homedir(), '.skillsmith', 'run');
+}
+// ---------------------------------------------------------------------------
+// Privacy helper — NEVER print full anonymousId
+// ---------------------------------------------------------------------------
+function idTail(id) {
+    if (!id)
+        return '(none)';
+    return `...${id.slice(-8)}`;
+}
+// ---------------------------------------------------------------------------
+// Orphan GC (plan line 714)
+// ---------------------------------------------------------------------------
+function gcOrphanRunFiles() {
+    try {
+        const dir = runDir();
+        if (!existsSync(dir))
+            return;
+        const now = Date.now();
+        for (const f of readdirSync(dir)) {
+            if (!f.startsWith('skill-'))
+                continue;
+            const fp = join(dir, f);
+            try {
+                const st = statSync(fp);
+                if (now - st.mtimeMs > ORPHAN_TTL_MS)
+                    unlinkSync(fp);
+            }
+            catch {
+                // best-effort
+            }
+        }
+    }
+    catch {
+        // never throw from GC
+    }
+}
+// ---------------------------------------------------------------------------
+// enable
+// ---------------------------------------------------------------------------
+async function runEnable() {
+    const manifest = await loadManifest();
+    const t = manifest.telemetry ?? { enabled: false };
+    if (t.enabled) {
+        console.log(chalk.green('Telemetry is already enabled.'));
+        console.log(chalk.dim(`  Anonymous ID tail: ${idTail(t.anonymousId)}`));
+        return;
+    }
+    const now = new Date().toISOString();
+    const updated = {
+        ...t,
+        enabled: true,
+        anonymousId: t.anonymousId ?? generateAnonymousId(),
+        anonymousIdCreatedAt: t.anonymousIdCreatedAt ?? now,
+        scope: t.scope ?? 'personal',
+        endpoint: t.endpoint ?? DEFAULT_ENDPOINT,
+    };
+    await saveManifest({ ...manifest, telemetry: updated });
+    console.log(chalk.green('Telemetry enabled.'));
+    console.log();
+    console.log('Skillsmith telemetry collects anonymous skill-invocation counts to help improve\n' +
+        'the registry and surface stale skills. No personal data, file contents, or\n' +
+        `paths are captured. Full privacy policy: ${chalk.cyan(PRIVACY_URL)}`);
+    console.log();
+    console.log(chalk.dim(`  Anonymous ID tail: ${idTail(updated.anonymousId)}`));
+    console.log(chalk.dim('  Disable at any time: ') + chalk.cyan('skillsmith telemetry disable'));
+}
+// ---------------------------------------------------------------------------
+// disable
+// ---------------------------------------------------------------------------
+async function runDisable() {
+    const manifest = await loadManifest();
+    const t = manifest.telemetry ?? { enabled: false };
+    if (!t.enabled) {
+        console.log(chalk.dim('Telemetry is already disabled.'));
+        return;
+    }
+    await saveManifest({ ...manifest, telemetry: { ...t, enabled: false } });
+    console.log(chalk.yellow('Telemetry disabled.'));
+    console.log(chalk.dim('  The anonymous ID is retained in the local manifest for continuity if you re-enable.\n' +
+        '  To fully clear it: skillsmith telemetry reset-id'));
+}
+// ---------------------------------------------------------------------------
+// status
+// ---------------------------------------------------------------------------
+async function runStatus() {
+    let manifest = await loadManifest();
+    let rotationTriggered = false;
+    // Annual auto-rotation (plan line 706, 713)
+    if (shouldRotateAnonymousId(manifest)) {
+        const rotated = rotateAnonymousId(manifest);
+        manifest = { ...manifest, telemetry: rotated };
+        await saveManifest(manifest);
+        rotationTriggered = true;
+    }
+    // Sweep expired previous id
+    const swept = sweepExpiredPreviousId(manifest);
+    if (swept !== manifest.telemetry) {
+        manifest = { ...manifest, telemetry: swept };
+        await saveManifest(manifest);
+    }
+    // GC orphan run files (plan line 714)
+    gcOrphanRunFiles();
+    const t = manifest.telemetry ?? { enabled: false };
+    const endpoint = t.endpoint ?? DEFAULT_ENDPOINT;
+    let ageDays = null;
+    if (t.anonymousIdCreatedAt) {
+        ageDays = Math.floor((Date.now() - new Date(t.anonymousIdCreatedAt).getTime()) / 86_400_000);
+    }
+    console.log(chalk.bold('Skillsmith Telemetry Status'));
+    console.log();
+    console.log(`  Enabled:          ${t.enabled ? chalk.green('yes') : chalk.dim('no')}`);
+    console.log(`  Endpoint:         ${chalk.dim(endpoint)}`);
+    console.log(`  Anonymous ID:     ${chalk.dim(idTail(t.anonymousId))}`);
+    console.log(`  ID age (days):    ${ageDays !== null ? String(ageDays) : chalk.dim('n/a')}`);
+    console.log(`  Scope:            ${t.scope ?? chalk.dim('personal')}`);
+    if (t.installedAt) {
+        console.log(`  Hook installed:   ${chalk.dim(t.installedAt)}`);
+    }
+    if (rotationTriggered) {
+        console.log();
+        console.log(chalk.yellow('  Annual rotation triggered.') +
+            chalk.dim(' New ID tail: ') +
+            chalk.cyan(idTail(t.anonymousId)));
+        if (t.previousAnonymousId) {
+            console.log(chalk.dim(`  Previous ID retained for 7-day overlap window (retired: ${t.previousAnonymousIdRetiredAt ?? 'unknown'})`));
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// install-hook
+// ---------------------------------------------------------------------------
+async function runInstallHook(options) {
+    // Resolve the template source — relative to this file's compiled output.
+    // src/commands/telemetry.action.ts → ../../templates/skill-telemetry.sh (via dist/commands)
+    // and one level up for the src layout during tests.
+    const templateCandidates = [
+        join(__dirname, '..', '..', 'templates', 'skill-telemetry.sh'),
+        join(__dirname, '..', 'templates', 'skill-telemetry.sh'),
+    ];
+    const templateSrc = templateCandidates.find((p) => existsSync(p));
+    if (!templateSrc) {
+        throw new Error('skill-telemetry.sh template not found. ' +
+            'Ensure the CLI package is fully built: npm run build');
+    }
+    // Load + validate settings.json — throws TelemetryHookError on foreign Skill matcher
+    const scope = options.scope;
+    const settings = loadClaudeSettings(scope);
+    const hookPath = hookScriptPath();
+    const updated = addSkillHookEntries(settings, hookPath);
+    // Copy hook script to ~/.skillsmith/hooks/
+    const destPath = hookScriptPath();
+    const hooksDir = dirname(destPath);
+    mkdirSync(hooksDir, { recursive: true, mode: 0o700 });
+    copyFileSync(templateSrc, destPath);
+    try {
+        chmodSync(destPath, 0o755);
+    }
+    catch {
+        // best-effort on Windows
+    }
+    // Persist settings.json atomically
+    writeClaudeSettings(scope, updated);
+    // Record installation timestamp in manifest
+    const manifest = await loadManifest();
+    const t = manifest.telemetry ?? { enabled: false };
+    await saveManifest({ ...manifest, telemetry: { ...t, installedAt: new Date().toISOString() } });
+    // Update endpoint in manifest if provided
+    if (options.endpoint) {
+        const m2 = await loadManifest();
+        const t2 = m2.telemetry ?? { enabled: false };
+        await saveManifest({ ...m2, telemetry: { ...t2, endpoint: options.endpoint } });
+    }
+    const scopeLabel = scope === 'user' ? '~/.claude/settings.json' : './.claude/settings.json';
+    console.log(chalk.green('Skillsmith telemetry hook installed.'));
+    console.log(chalk.dim(`  Hook script:   ${destPath}`));
+    console.log(chalk.dim(`  Settings file: ${scopeLabel}`));
+    console.log();
+    console.log(chalk.dim('Enable telemetry to start collecting: ') + chalk.cyan('skillsmith telemetry enable'));
+}
+// ---------------------------------------------------------------------------
+// uninstall-hook
+// ---------------------------------------------------------------------------
+async function runUninstallHook(options) {
+    const scope = options.scope;
+    const hookPath = hookScriptPath();
+    const settings = loadClaudeSettings(scope);
+    const updated = removeSkillHookEntries(settings, hookPath);
+    writeClaudeSettings(scope, updated);
+    // Optionally remove the script file
+    try {
+        const scriptPath = hookScriptPath();
+        if (existsSync(scriptPath))
+            unlinkSync(scriptPath);
+    }
+    catch {
+        // best-effort
+    }
+    const scopeLabel = scope === 'user' ? '~/.claude/settings.json' : './.claude/settings.json';
+    console.log(chalk.yellow('Skillsmith telemetry hook removed.'));
+    console.log(chalk.dim(`  Removed from: ${scopeLabel}`));
+    console.log(chalk.dim('  Foreign hooks (if any) were not touched.'));
+}
+// ---------------------------------------------------------------------------
+// reset-id
+// ---------------------------------------------------------------------------
+async function runResetId() {
+    const manifest = await loadManifest();
+    const rotated = rotateAnonymousId(manifest); // unconditional rotation
+    await saveManifest({ ...manifest, telemetry: rotated });
+    console.log(chalk.green('Anonymous ID rotated.'));
+    console.log(chalk.dim(`  New ID tail:      ${idTail(rotated.anonymousId)}`));
+    if (rotated.previousAnonymousId) {
+        console.log(chalk.dim(`  Previous ID tail: ${idTail(rotated.previousAnonymousId)}`));
+        console.log(chalk.dim(`  Previous ID retirement: ${rotated.previousAnonymousIdRetiredAt ?? 'unknown'} (7-day overlap window)`));
+    }
+}
+// ---------------------------------------------------------------------------
+// withTelemetry-wrapped action handlers (SMI-5128)
+// ---------------------------------------------------------------------------
+async function telemetryEnableActionImpl() {
+    try {
+        await runEnable();
+    }
+    catch (err) {
+        console.error(chalk.red('Error:'), sanitizeError(err));
+        process.exit(1);
+    }
+}
+export const telemetryEnableAction = withTelemetry(telemetryEnableActionImpl, {
+    source: 'cli',
+    extractSkillId: () => 'telemetry enable',
+    extractFramework: () => 'cli',
+});
+async function telemetryDisableActionImpl() {
+    try {
+        await runDisable();
+    }
+    catch (err) {
+        console.error(chalk.red('Error:'), sanitizeError(err));
+        process.exit(1);
+    }
+}
+export const telemetryDisableAction = withTelemetry(telemetryDisableActionImpl, {
+    source: 'cli',
+    extractSkillId: () => 'telemetry disable',
+    extractFramework: () => 'cli',
+});
+async function telemetryStatusActionImpl() {
+    try {
+        await runStatus();
+    }
+    catch (err) {
+        console.error(chalk.red('Error:'), sanitizeError(err));
+        process.exit(1);
+    }
+}
+export const telemetryStatusAction = withTelemetry(telemetryStatusActionImpl, {
+    source: 'cli',
+    extractSkillId: () => 'telemetry status',
+    extractFramework: () => 'cli',
+});
+async function telemetryInstallHookActionImpl(options) {
+    const scope = options.scope === 'project' ? 'project' : 'user';
+    try {
+        await runInstallHook(options.endpoint !== undefined ? { scope, endpoint: options.endpoint } : { scope });
+    }
+    catch (err) {
+        if (err instanceof TelemetryHookError) {
+            console.error(chalk.red(`Error [${err.code}]:`));
+            console.error(err.message);
+        }
+        else {
+            console.error(chalk.red('Error:'), sanitizeError(err));
+        }
+        process.exit(1);
+    }
+}
+export const telemetryInstallHookAction = withTelemetry(telemetryInstallHookActionImpl, {
+    source: 'cli',
+    extractSkillId: () => 'telemetry install-hook',
+    extractFramework: () => 'cli',
+});
+async function telemetryUninstallHookActionImpl(options) {
+    const scope = options.scope === 'project' ? 'project' : 'user';
+    try {
+        await runUninstallHook({ scope });
+    }
+    catch (err) {
+        console.error(chalk.red('Error:'), sanitizeError(err));
+        process.exit(1);
+    }
+}
+export const telemetryUninstallHookAction = withTelemetry(telemetryUninstallHookActionImpl, {
+    source: 'cli',
+    extractSkillId: () => 'telemetry uninstall-hook',
+    extractFramework: () => 'cli',
+});
+async function telemetryResetIdActionImpl() {
+    try {
+        await runResetId();
+    }
+    catch (err) {
+        console.error(chalk.red('Error:'), sanitizeError(err));
+        process.exit(1);
+    }
+}
+export const telemetryResetIdAction = withTelemetry(telemetryResetIdActionImpl, {
+    source: 'cli',
+    extractSkillId: () => 'telemetry reset-id',
+    extractFramework: () => 'cli',
+});
+// Internal exports for tests (re-exported from telemetry.ts for back-compat).
+export { runEnable, runDisable, runStatus, runInstallHook, runUninstallHook, runResetId, idTail };
+//# sourceMappingURL=telemetry.action.js.map

package/dist/src/commands/telemetry.action.js.map

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

package/dist/src/commands/telemetry.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview `skillsmith telemetry` command group — opt-in telemetry management.
+ * @module @skillsmith/cli/commands/telemetry
+ * @see SMI-5021 Wave 3 Step 2 — CLI subcommands for telemetry (plan lines 195–196, 576)
+ * @see SMI-5128 batch D — action impls + run* logic moved to telemetry.action.ts
+ *   (sibling-split convention) so the 6 subcommand handlers are withTelemetry-
+ *   wrapped without this file exceeding the 500-LOC gate. This file retains the
+ *   commander factory and re-exports the run* test helpers for back-compat.
+ *
+ * Subcommands:
+ *   skillsmith telemetry enable
+ *   skillsmith telemetry disable
+ *   skillsmith telemetry status
+ *   skillsmith telemetry install-hook   [--scope user|project] [--endpoint <url>]
+ *   skillsmith telemetry uninstall-hook [--scope user|project]
+ *   skillsmith telemetry reset-id
+ *
+ * Privacy invariants (plan line 719):
+ *   - anonymousId is NEVER printed in full. Only the last 8 hex chars appear in stdout.
+ *   - The full SHA-256 hex travels only to the events endpoint in hook payloads.
+ *
+ * Shared-state coordination (plan line 717):
+ *   - install-hook reads then writes ~/.claude/settings.json via telemetry.helpers.ts
+ *   - Refuses on foreign Skill matcher (security gate)
+ *   - manifest read/write always via loadManifest / saveManifest (atomic rename)
+ */
+import { Command } from 'commander';
+export declare function createTelemetryCommand(): Command;
+export { runEnable, runDisable, runStatus, runInstallHook, runUninstallHook, runResetId, idTail, } from './telemetry.action.js';
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/src/commands/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/commands/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAenC,wBAAgB,sBAAsB,IAAI,OAAO,CA2ChD;AAGD,OAAO,EACL,SAAS,EACT,UAAU,EACV,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,MAAM,GACP,MAAM,uBAAuB,CAAA"}

package/dist/src/commands/telemetry.helpers.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Atomic ~/.claude/settings.json merger for telemetry hook entries.
+ * @module @skillsmith/cli/commands/telemetry.helpers
+ * @see SMI-5021 Wave 3 Step 2 — install-hook / uninstall-hook shared-state matrix (plan line 717)
+ *
+ * Public surface:
+ *   loadClaudeSettings  — reads user or project settings.json (returns {} on missing)
+ *   addSkillHookEntries — idempotent add; THROWS on foreign Skill matcher
+ *   removeSkillHookEntries — removes only Skillsmith entries; never foreign hooks
+ *   writeClaudeSettings — atomic temp-file rename (mirrors manifest.ts pattern)
+ *
+ * Hook schema (Claude Code settings.json):
+ *   hooks.PreToolUse  = Array<{ matcher: string; hooks: Array<{ type: 'command'; command: string }> }>
+ *   hooks.PostToolUse = same shape
+ *
+ * Deduplication is by command path, not by matcher value.  A foreign Skill
+ * matcher is one whose command path does NOT start with the Skillsmith hookPath.
+ */
+export interface HookEntry {
+    type: 'command';
+    command: string;
+}
+export interface HookMatcher {
+    matcher: string;
+    hooks: HookEntry[];
+}
+export interface ClaudeHooks {
+    PreToolUse?: HookMatcher[];
+    PostToolUse?: HookMatcher[];
+    [key: string]: unknown;
+}
+export interface ClaudeSettings {
+    hooks?: ClaudeHooks;
+    [key: string]: unknown;
+}
+export declare class TelemetryHookError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function resolveSettingsPath(scope: 'user' | 'project'): string;
+export declare function loadClaudeSettings(scope: 'user' | 'project'): ClaudeSettings;
+/**
+ * Adds PreToolUse + PostToolUse Skill matcher entries pointing at hookPath.
+ * Idempotent (dedupes by command path).
+ * THROWS TelemetryHookError if a foreign Skill matcher is detected.
+ */
+export declare function addSkillHookEntries(settings: ClaudeSettings, hookPath: string): ClaudeSettings;
+/**
+ * Removes Skillsmith Skill hook entries from settings.
+ * Never touches foreign hooks — only removes entries whose command starts with hookPath.
+ */
+export declare function removeSkillHookEntries(settings: ClaudeSettings, hookPath: string): ClaudeSettings;
+/**
+ * Atomic write of Claude settings.json: temp file → rename.
+ * Mirrors the manifest.ts atomic write pattern (plan line 120).
+ */
+export declare function writeClaudeSettings(scope: 'user' | 'project', settings: ClaudeSettings): void;
+//# sourceMappingURL=telemetry.helpers.d.ts.map

package/dist/src/commands/telemetry.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.helpers.d.ts","sourceRoot":"","sources":["../../../src/commands/telemetry.helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAWH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,SAAS,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,WAAW,EAAE,CAAA;IAC1B,WAAW,CAAC,EAAE,WAAW,EAAE,CAAA;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;CAKlB;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAMrE;AAMD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAW5E;AAmED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAS9F;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAwBjG;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAiB7F"}

package/dist/src/commands/telemetry.helpers.js

@@ -0,0 +1,173 @@
+/**
+ * @fileoverview Atomic ~/.claude/settings.json merger for telemetry hook entries.
+ * @module @skillsmith/cli/commands/telemetry.helpers
+ * @see SMI-5021 Wave 3 Step 2 — install-hook / uninstall-hook shared-state matrix (plan line 717)
+ *
+ * Public surface:
+ *   loadClaudeSettings  — reads user or project settings.json (returns {} on missing)
+ *   addSkillHookEntries — idempotent add; THROWS on foreign Skill matcher
+ *   removeSkillHookEntries — removes only Skillsmith entries; never foreign hooks
+ *   writeClaudeSettings — atomic temp-file rename (mirrors manifest.ts pattern)
+ *
+ * Hook schema (Claude Code settings.json):
+ *   hooks.PreToolUse  = Array<{ matcher: string; hooks: Array<{ type: 'command'; command: string }> }>
+ *   hooks.PostToolUse = same shape
+ *
+ * Deduplication is by command path, not by matcher value.  A foreign Skill
+ * matcher is one whose command path does NOT start with the Skillsmith hookPath.
+ */
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+export class TelemetryHookError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'TelemetryHookError';
+    }
+}
+// ---------------------------------------------------------------------------
+// Path resolution
+// ---------------------------------------------------------------------------
+export function resolveSettingsPath(scope) {
+    if (scope === 'user') {
+        return join(homedir(), '.claude', 'settings.json');
+    }
+    // project scope: relative to cwd
+    return join(process.cwd(), '.claude', 'settings.json');
+}
+// ---------------------------------------------------------------------------
+// Read
+// ---------------------------------------------------------------------------
+export function loadClaudeSettings(scope) {
+    const path = resolveSettingsPath(scope);
+    if (!fs.existsSync(path))
+        return {};
+    try {
+        const raw = fs.readFileSync(path, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+            return {};
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+// ---------------------------------------------------------------------------
+// Merge helpers
+// ---------------------------------------------------------------------------
+/**
+ * Returns true when a HookMatcher block uses the Skill matcher AND its first
+ * hook command starts with hookPath (our Skillsmith hook).
+ */
+function isSkillsmithSkillMatcher(entry, hookPath) {
+    return (entry.matcher === 'Skill' &&
+        Array.isArray(entry.hooks) &&
+        entry.hooks.length > 0 &&
+        entry.hooks[0].command.startsWith(hookPath));
+}
+/**
+ * Returns true when a HookMatcher block uses the Skill matcher AND its first
+ * hook command does NOT start with hookPath — i.e. a foreign Skill matcher.
+ */
+function isForeignSkillMatcher(entry, hookPath) {
+    return (entry.matcher === 'Skill' &&
+        Array.isArray(entry.hooks) &&
+        entry.hooks.length > 0 &&
+        !entry.hooks[0].command.startsWith(hookPath));
+}
+/**
+ * Idempotent add of Skillsmith Skill matcher entries to a hook array.
+ * Dedupes by command path. Throws if a foreign Skill matcher exists.
+ */
+function mergeHookArray(existing, hookPath, command) {
+    const arr = Array.isArray(existing) ? [...existing] : [];
+    // Check for foreign Skill matcher — security gate (plan line 717)
+    const foreign = arr.find((e) => isForeignSkillMatcher(e, hookPath));
+    if (foreign) {
+        const foreignCmd = foreign.hooks[0]?.command ?? '(unknown)';
+        throw new TelemetryHookError('hook.foreign_skill_matcher', `A foreign Skill hook already exists in settings.json:\n` +
+            `  command: ${foreignCmd}\n\n` +
+            `Remove it manually before installing the Skillsmith telemetry hook:\n` +
+            `  1. Open ~/.claude/settings.json (or .claude/settings.json for project scope)\n` +
+            `  2. Delete the PreToolUse and PostToolUse entries with matcher "Skill"\n` +
+            `  3. Re-run: skillsmith telemetry install-hook`);
+    }
+    // Check if our entry already exists (idempotent)
+    const alreadyPresent = arr.some((e) => isSkillsmithSkillMatcher(e, hookPath));
+    if (alreadyPresent)
+        return arr;
+    // Add new entry
+    arr.push({ matcher: 'Skill', hooks: [{ type: 'command', command }] });
+    return arr;
+}
+/**
+ * Adds PreToolUse + PostToolUse Skill matcher entries pointing at hookPath.
+ * Idempotent (dedupes by command path).
+ * THROWS TelemetryHookError if a foreign Skill matcher is detected.
+ */
+export function addSkillHookEntries(settings, hookPath) {
+    const preCommand = `${hookPath} pre`;
+    const postCommand = `${hookPath} post`;
+    const hooks = { ...(settings.hooks ?? {}) };
+    hooks.PreToolUse = mergeHookArray(hooks.PreToolUse, hookPath, preCommand);
+    hooks.PostToolUse = mergeHookArray(hooks.PostToolUse, hookPath, postCommand);
+    return { ...settings, hooks };
+}
+/**
+ * Removes Skillsmith Skill hook entries from settings.
+ * Never touches foreign hooks — only removes entries whose command starts with hookPath.
+ */
+export function removeSkillHookEntries(settings, hookPath) {
+    if (!settings.hooks)
+        return settings;
+    const filterOut = (arr) => {
+        if (!Array.isArray(arr))
+            return arr;
+        const filtered = arr.filter((e) => !isSkillsmithSkillMatcher(e, hookPath));
+        return filtered.length === 0 && arr.length > 0 ? [] : filtered;
+    };
+    const hooks = { ...settings.hooks };
+    const filteredPre = filterOut(hooks.PreToolUse);
+    if (filteredPre === undefined) {
+        delete hooks.PreToolUse;
+    }
+    else {
+        hooks.PreToolUse = filteredPre;
+    }
+    const filteredPost = filterOut(hooks.PostToolUse);
+    if (filteredPost === undefined) {
+        delete hooks.PostToolUse;
+    }
+    else {
+        hooks.PostToolUse = filteredPost;
+    }
+    return { ...settings, hooks };
+}
+// ---------------------------------------------------------------------------
+// Write
+// ---------------------------------------------------------------------------
+/**
+ * Atomic write of Claude settings.json: temp file → rename.
+ * Mirrors the manifest.ts atomic write pattern (plan line 120).
+ */
+export function writeClaudeSettings(scope, settings) {
+    const path = resolveSettingsPath(scope);
+    const dir = dirname(path);
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const tmpSuffix = crypto.randomBytes(6).toString('hex');
+    const tmpPath = `${path}.${tmpSuffix}.tmp`;
+    const json = JSON.stringify(settings, null, 2);
+    fs.writeFileSync(tmpPath, json, { encoding: 'utf-8', mode: 0o600 });
+    fs.renameSync(tmpPath, path);
+    try {
+        fs.chmodSync(path, 0o600);
+    }
+    catch {
+        // Best-effort; ignore on Windows / read-only FS.
+    }
+}
+//# sourceMappingURL=telemetry.helpers.js.map

package/dist/src/commands/telemetry.helpers.js.map

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