@skillsmith/cli 0.7.2 → 0.7.4

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

@@ -1,55 +0,0 @@
-/**
- * sync command helpers (SMI-4287)
- *
- * Extracted from `sync.ts` to keep the main command file under the 500-line
- * governance ceiling. Covers local-skill adapter scanning and warning
- * formatting for the `sync status` subcommand.
- */
-import { type AdapterError, type SyncResult } from '@skillsmith/core';
-/**
- * SMI-4482: Detect whether a failed sync was caused by exhausted/absent
- * credentials rather than a transient network or server error.
- *
- * Root cause: on a fresh install (`skillsmith sync` before `skillsmith login`,
- * no `SKILLSMITH_API_KEY`) the API client correctly falls back to the public
- * Supabase anon key and reaches the anonymous IP-trial path. Once the per-IP
- * free-trial limit is exhausted the `skills-search` edge function returns
- * HTTP 401 with body `{"error":"Authentication required", ...}`. `SyncEngine`
- * surfaces that raw string in `SyncResult.errors`, so the CLI used to print a
- * bare `Authentication required` with `Σ Total: 0` and no next step.
- *
- * This matches the 401 auth signal so `sync.ts` can replace the bare error
- * with actionable guidance.
- *
- * @param result - The `SyncResult` returned by the sync engine.
- * @returns `true` when the sync failed solely because no usable credentials
- *   were available (anonymous trial exhausted or auth rejected).
- */
-export declare function isAuthFailure(result: SyncResult): boolean;
-/**
- * SMI-4482: Actionable, multi-line guidance shown when `sync` fails because
- * no credentials are available. Replaces the previous bare
- * `Error: Authentication required` so the user always has a clear next step.
- *
- * @returns Lines to print to stderr, in order.
- */
-export declare function formatAuthGuidance(): string[];
-/**
- * Scan `~/.claude/skills` for non-fatal adapter warnings.
- *
- * Pulls `SourceSearchResult.warnings[]` from a fresh LocalFilesystemAdapter
- * so `sync status` surfaces symlink-escape / permission / loop issues.
- * Returns an empty array if the skills dir does not exist (e.g. fresh
- * install) or the adapter fails to initialise — `sync status` must not
- * crash just because local skills couldn't be scanned.
- */
-export declare function scanLocalSkillsForWarnings(): Promise<AdapterError[]>;
-/**
- * Format adapter warnings for stderr display.
- *
- * One `chalk.yellow` line per warning with a machine-readable prefix the
- * user can grep for: `[symlink-guard]`, `[permission]`, `[loop]`,
- * `[not-found]`, `[io]`.
- */
-export declare function formatAdapterWarnings(warnings: AdapterError[]): string[];
-//# sourceMappingURL=sync.helpers.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"sync.helpers.d.ts","sourceRoot":"","sources":["../../../src/commands/sync.helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAgC,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAGnG;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAKzD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAK7C;AAED;;;;;;;;GAQG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAiB1E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAKxE"}

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

@@ -1,90 +0,0 @@
-/**
- * sync command helpers (SMI-4287)
- *
- * Extracted from `sync.ts` to keep the main command file under the 500-line
- * governance ceiling. Covers local-skill adapter scanning and warning
- * formatting for the `sync status` subcommand.
- */
-import chalk from 'chalk';
-import { createLocalFilesystemAdapter } from '@skillsmith/core';
-import { DEFAULT_SKILLS_DIR } from '../config.js';
-/**
- * SMI-4482: Detect whether a failed sync was caused by exhausted/absent
- * credentials rather than a transient network or server error.
- *
- * Root cause: on a fresh install (`skillsmith sync` before `skillsmith login`,
- * no `SKILLSMITH_API_KEY`) the API client correctly falls back to the public
- * Supabase anon key and reaches the anonymous IP-trial path. Once the per-IP
- * free-trial limit is exhausted the `skills-search` edge function returns
- * HTTP 401 with body `{"error":"Authentication required", ...}`. `SyncEngine`
- * surfaces that raw string in `SyncResult.errors`, so the CLI used to print a
- * bare `Authentication required` with `Σ Total: 0` and no next step.
- *
- * This matches the 401 auth signal so `sync.ts` can replace the bare error
- * with actionable guidance.
- *
- * @param result - The `SyncResult` returned by the sync engine.
- * @returns `true` when the sync failed solely because no usable credentials
- *   were available (anonymous trial exhausted or auth rejected).
- */
-export function isAuthFailure(result) {
-    if (result.success || result.totalProcessed > 0) {
-        return false;
-    }
-    return result.errors.some((error) => /authentication required|unauthorized/i.test(error));
-}
-/**
- * SMI-4482: Actionable, multi-line guidance shown when `sync` fails because
- * no credentials are available. Replaces the previous bare
- * `Error: Authentication required` so the user always has a clear next step.
- *
- * @returns Lines to print to stderr, in order.
- */
-export function formatAuthGuidance() {
-    return [
-        chalk.yellow('Sync requires authentication. Run: ') + chalk.cyan('skillsmith login'),
-        chalk.dim('Or set SKILLSMITH_API_KEY for headless/CI use.'),
-    ];
-}
-/**
- * Scan `~/.claude/skills` for non-fatal adapter warnings.
- *
- * Pulls `SourceSearchResult.warnings[]` from a fresh LocalFilesystemAdapter
- * so `sync status` surfaces symlink-escape / permission / loop issues.
- * Returns an empty array if the skills dir does not exist (e.g. fresh
- * install) or the adapter fails to initialise — `sync status` must not
- * crash just because local skills couldn't be scanned.
- */
-export async function scanLocalSkillsForWarnings() {
-    try {
-        const adapter = createLocalFilesystemAdapter({
-            id: 'sync-status-local',
-            name: 'Local Skills',
-            type: 'local',
-            baseUrl: 'file://',
-            enabled: true,
-            rootDir: DEFAULT_SKILLS_DIR,
-            followSymlinks: true,
-        });
-        await adapter.initialize();
-        const result = await adapter.search({});
-        return result.warnings ?? [];
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Format adapter warnings for stderr display.
- *
- * One `chalk.yellow` line per warning with a machine-readable prefix the
- * user can grep for: `[symlink-guard]`, `[permission]`, `[loop]`,
- * `[not-found]`, `[io]`.
- */
-export function formatAdapterWarnings(warnings) {
-    return warnings.map((warning) => {
-        const prefix = warning.code === 'symlink-escape' ? 'symlink-guard' : warning.code;
-        return chalk.yellow(`  [${prefix}] ${warning.message}`);
-    });
-}
-//# sourceMappingURL=sync.helpers.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"sync.helpers.js","sourceRoot":"","sources":["../../../src/commands/sync.helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,4BAA4B,EAAsC,MAAM,kBAAkB,CAAA;AACnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC9C,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;QAChD,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,uCAAuC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;AAC3F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,qCAAqC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC;QACpF,KAAK,CAAC,GAAG,CAAC,gDAAgD,CAAC;KAC5D,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B;IAC9C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,4BAA4B,CAAC;YAC3C,EAAE,EAAE,mBAAmB;YACvB,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,kBAAkB;YAC3B,cAAc,EAAE,IAAI;SACrB,CAAC,CAAA;QACF,MAAM,OAAO,CAAC,UAAU,EAAE,CAAA;QAC1B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACvC,OAAO,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAwB;IAC5D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAA;QACjF,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/src/commands/sync.js

@@ -1,101 +0,0 @@
-/**
- * Sync Command - Registry synchronization CLI
- *
- * Provides commands for syncing the local skill database with the
- * live Skillsmith registry.
- *
- * Usage:
- *   skillsmith sync              # Run sync (differential)
- *   skillsmith sync --force      # Run full sync
- *   skillsmith sync --dry-run    # Preview what would sync
- *   skillsmith sync status       # Show sync status
- *   skillsmith sync history      # Show sync history
- *   skillsmith sync config       # Configure auto-sync
- *
- * SMI-5127: Action implementations moved to sync.action.ts.
- * This file retains only the commander factory functions.
- */
-import { Command } from 'commander';
-import { DEFAULT_DB_PATH } from '../config.js';
-import { syncAction, syncStatusAction, syncHistoryAction, syncConfigAction } from './sync.action.js';
-/**
- * Create sync status subcommand
- */
-function createStatusCommand() {
-    return new Command('status')
-        .description('Show sync status and statistics')
-        .option('-d, --db <path>', 'Database file path', DEFAULT_DB_PATH)
-        .option('--json', 'Output as JSON')
-        .action(async (opts) => {
-        await syncStatusAction({
-            dbPath: opts['db'],
-            json: opts['json'] ?? false,
-        });
-    });
-}
-/**
- * Create sync history subcommand
- */
-function createHistoryCommand() {
-    return new Command('history')
-        .description('Show sync history')
-        .option('-d, --db <path>', 'Database file path', DEFAULT_DB_PATH)
-        .option('-l, --limit <number>', 'Number of entries to show', '10')
-        .option('--json', 'Output as JSON')
-        .action(async (opts) => {
-        await syncHistoryAction({
-            dbPath: opts['db'],
-            limit: parseInt(opts['limit'], 10),
-            json: opts['json'] ?? false,
-        });
-    });
-}
-/**
- * Create sync config subcommand
- */
-function createConfigCommand() {
-    return new Command('config')
-        .description('Configure automatic sync settings')
-        .option('-d, --db <path>', 'Database file path', DEFAULT_DB_PATH)
-        .option('--enable', 'Enable automatic background sync')
-        .option('--disable', 'Disable automatic background sync')
-        .option('--frequency <freq>', 'Set sync frequency (daily|weekly)')
-        .option('--show', 'Show current configuration')
-        .option('--json', 'Output as JSON')
-        .action(async (opts) => {
-        await syncConfigAction({
-            dbPath: opts['db'],
-            enable: opts['enable'],
-            disable: opts['disable'],
-            frequency: opts['frequency'],
-            show: opts['show'],
-            json: opts['json'] ?? false,
-        });
-    });
-}
-/**
- * Create sync command with subcommands
- */
-export function createSyncCommand() {
-    const cmd = new Command('sync')
-        .description('Synchronize skills from the Skillsmith registry')
-        .option('-d, --db <path>', 'Database file path', DEFAULT_DB_PATH)
-        .option('-f, --force', 'Force full sync (ignore last sync time)')
-        .option('--dry-run', 'Show what would be synced without making changes')
-        .option('--json', 'Output results as JSON')
-        .action(async (opts) => {
-        await syncAction({
-            dbPath: opts['db'],
-            force: opts['force'] ?? false,
-            dryRun: opts['dry-run'] ?? false,
-            json: opts['json'] ?? false,
-        });
-    });
-    // Add subcommands
-    cmd.addCommand(createStatusCommand());
-    cmd.addCommand(createHistoryCommand());
-    cmd.addCommand(createConfigCommand());
-    return cmd;
-}
-export default createSyncCommand;
-//# sourceMappingURL=sync.js.map

package/dist/src/commands/sync.js.map

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

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

@@ -1,38 +0,0 @@
-/**
- * @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.
- */
-declare function idTail(id: string | undefined): string;
-declare function runEnable(): Promise<void>;
-declare function runDisable(): Promise<void>;
-declare function runStatus(): Promise<void>;
-declare function runInstallHook(options: {
-    scope: 'user' | 'project';
-    endpoint?: string;
-}): Promise<void>;
-declare function runUninstallHook(options: {
-    scope: 'user' | 'project';
-}): Promise<void>;
-declare function runResetId(): Promise<void>;
-export declare const telemetryEnableAction: () => Promise<void>;
-export declare const telemetryDisableAction: () => Promise<void>;
-export declare const telemetryStatusAction: () => Promise<void>;
-export declare const telemetryInstallHookAction: (options: {
-    scope: string;
-    endpoint?: string;
-}) => Promise<void>;
-export declare const telemetryUninstallHookAction: (options: {
-    scope: string;
-}) => Promise<void>;
-export declare const telemetryResetIdAction: () => Promise<void>;
-export { runEnable, runDisable, runStatus, runInstallHook, runUninstallHook, runResetId, idTail };
-//# sourceMappingURL=telemetry.action.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"telemetry.action.d.ts","sourceRoot":"","sources":["../../../src/commands/telemetry.action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAmDH,iBAAS,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG9C;AA8BD,iBAAe,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAgCxC;AAMD,iBAAe,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAkBzC;AAMD,iBAAe,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAyDxC;AAMD,iBAAe,cAAc,CAAC,OAAO,EAAE;IACrC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDhB;AAMD,iBAAe,gBAAgB,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBrF;AAMD,iBAAe,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAezC;AAeD,eAAO,MAAM,qBAAqB,qBAIhC,CAAA;AAWF,eAAO,MAAM,sBAAsB,qBAIjC,CAAA;AAWF,eAAO,MAAM,qBAAqB,qBAIhC,CAAA;AAsBF,eAAO,MAAM,0BAA0B;WAnB9B,MAAM;eACF,MAAM;mBAsBjB,CAAA;AAYF,eAAO,MAAM,4BAA4B;WAVyB,MAAM;mBActE,CAAA;AAWF,eAAO,MAAM,sBAAsB,qBAIjC,CAAA;AAGF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,CAAA"}

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

@@ -1,350 +0,0 @@
-/**
- * @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