specweave 1.0.569 → 1.0.571

package/bin/specweave.js

@@ -857,6 +857,28 @@ program
     });
   });
 
+// Analytics push command - Record analytics events (replaces PostToolUse analytics hook)
+program
+  .command('analytics-push')
+  .description('Record a skill or agent analytics event (replaces PostToolUse analytics hook)')
+  .requiredOption('--type <type>', 'Event type: skill or agent')
+  .requiredOption('--name <name>', 'Skill or agent name')
+  .option('--plugin <plugin>', 'Source plugin name')
+  .option('--json', 'Output as JSON')
+  .option('--silent', 'Suppress output')
+  .action(async (options) => {
+    const { analyticsPushCommand } = await import('../dist/src/cli/commands/analytics-push.js');
+    const result = await analyticsPushCommand({
+      projectRoot: process.cwd(),
+      type: options.type,
+      name: options.name,
+      plugin: options.plugin,
+      json: options.json,
+      silent: options.silent,
+    });
+    if (!result.success) process.exit(1);
+  });
+
 // LSP command - Code intelligence operations
 const lspCmd = program
   .command('lsp')
@@ -945,6 +967,30 @@ program
     await commitsCommand();
   });
 
+// Sync flush command - Flush or queue sync events (replaces PostToolUse/stop-sync hooks)
+const syncFlushCmd = program
+  .command('sync')
+  .description('Sync operations');
+
+syncFlushCmd
+  .command('flush')
+  .description('Flush pending sync events or queue new ones (replaces PostToolUse hook)')
+  .option('--queue <json>', 'Queue a new event instead of flushing')
+  .option('--dry-run', 'Report what would be flushed without clearing')
+  .option('--json', 'Output as JSON')
+  .option('--silent', 'Suppress output')
+  .action(async (options) => {
+    const { syncFlushCommand } = await import('../dist/src/cli/commands/sync-flush.js');
+    const result = await syncFlushCommand({
+      projectRoot: process.cwd(),
+      queue: options.queue,
+      dryRun: options.dryRun,
+      json: options.json,
+      silent: options.silent,
+    });
+    if (!result.success) process.exit(1);
+  });
+
 // Sync-scheduled command - Execute due scheduled sync jobs (for cron/CI)
 program
   .command('sync-scheduled')
@@ -1244,6 +1290,43 @@ program
     }
   });
 
+// Session command - Session lifecycle management (replaces SessionStart/Stop hooks)
+const sessionCmd = program
+  .command('session')
+  .description('Session lifecycle management (start, end)');
+
+sessionCmd
+  .command('start')
+  .description('Initialize session (replaces SessionStart hook)')
+  .option('--session-id <id>', 'Session identifier for isolated state')
+  .option('--json', 'Output as JSON')
+  .option('--silent', 'Suppress output')
+  .action(async (options) => {
+    const { sessionStartCommand } = await import('../dist/src/cli/commands/session.js');
+    const result = await sessionStartCommand({
+      projectRoot: process.cwd(),
+      sessionId: options.sessionId,
+      json: options.json,
+      silent: options.silent,
+    });
+    if (!result.success) process.exit(1);
+  });
+
+sessionCmd
+  .command('end')
+  .description('End session: reflect check, auto scan, sync flush (replaces Stop hooks)')
+  .option('--json', 'Output as JSON')
+  .option('--silent', 'Suppress output')
+  .action(async (options) => {
+    const { sessionEndCommand } = await import('../dist/src/cli/commands/session.js');
+    const result = await sessionEndCommand({
+      projectRoot: process.cwd(),
+      json: options.json,
+      silent: options.silent,
+    });
+    if (!result.success) process.exit(1);
+  });
+
 // Hook command - CLI delegation entry point for Claude Code hooks (internal)
 program
   .command('hook <event-type>')

package/dist/src/cli/commands/analytics-push.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Analytics push CLI command.
+ *
+ * Replaces PostToolUse analytics hook with explicit CLI invocation.
+ *
+ *   specweave analytics push --type skill --name sw:pm
+ *   specweave analytics push --type agent --name general
+ *
+ * @module cli/commands/analytics-push
+ */
+export interface AnalyticsPushResult {
+    success: boolean;
+    eventsWritten: number;
+}
+export interface AnalyticsPushOptions {
+    type?: 'skill' | 'agent';
+    name?: string;
+    plugin?: string;
+    projectRoot?: string;
+    json?: boolean;
+    silent?: boolean;
+}
+/**
+ * Execute `specweave analytics push`.
+ */
+export declare function analyticsPushCommand(options?: AnalyticsPushOptions): Promise<AnalyticsPushResult>;
+//# sourceMappingURL=analytics-push.d.ts.map

package/dist/src/cli/commands/analytics-push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-push.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/analytics-push.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AASD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAgD9B"}

package/dist/src/cli/commands/analytics-push.js

@@ -0,0 +1,74 @@
+/**
+ * Analytics push CLI command.
+ *
+ * Replaces PostToolUse analytics hook with explicit CLI invocation.
+ *
+ *   specweave analytics push --type skill --name sw:pm
+ *   specweave analytics push --type agent --name general
+ *
+ * @module cli/commands/analytics-push
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { writeSkillEvent, writeAgentEvent, } from '../../core/analytics/event-writer.js';
+function resolveProjectRoot(provided) {
+    const root = provided ?? process.cwd();
+    const configPath = path.join(root, '.specweave', 'config.json');
+    if (!fs.existsSync(configPath))
+        return null;
+    return root;
+}
+/**
+ * Execute `specweave analytics push`.
+ */
+export async function analyticsPushCommand(options = {}) {
+    // Validate required flags
+    if (!options.type) {
+        if (!options.silent)
+            console.error('Missing required flag: --type <skill|agent>');
+        return { success: false, eventsWritten: 0 };
+    }
+    if (!options.name) {
+        if (!options.silent)
+            console.error('Missing required flag: --name <string>');
+        return { success: false, eventsWritten: 0 };
+    }
+    if (options.type !== 'skill' && options.type !== 'agent') {
+        if (!options.silent)
+            console.error('--type must be "skill" or "agent"');
+        return { success: false, eventsWritten: 0 };
+    }
+    const projectRoot = resolveProjectRoot(options.projectRoot);
+    if (!projectRoot) {
+        const msg = 'Not a SpecWeave project (no .specweave/config.json found)';
+        if (!options.silent)
+            console.error(msg);
+        return { success: false, eventsWritten: 0 };
+    }
+    const analyticsDir = path.join(projectRoot, '.specweave', 'state', 'analytics');
+    const timestamp = new Date().toISOString();
+    let writeResult;
+    if (options.type === 'skill') {
+        writeResult = writeSkillEvent(analyticsDir, options.name, options.plugin, timestamp);
+    }
+    else {
+        writeResult = writeAgentEvent(analyticsDir, options.name, timestamp);
+    }
+    const result = {
+        success: writeResult.written > 0,
+        eventsWritten: writeResult.written,
+    };
+    if (!options.silent) {
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else if (result.success) {
+            console.log(`Recorded ${options.type} event: ${options.name}`);
+        }
+        else {
+            console.error('Failed to write analytics event');
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=analytics-push.js.map

package/dist/src/cli/commands/analytics-push.js.map

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

package/dist/src/cli/commands/session.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Session lifecycle CLI command.
+ *
+ * Replaces SessionStart and Stop hooks with explicit CLI subcommands:
+ *   specweave session start  — session initialization
+ *   specweave session end    — session cleanup (reflect + auto + sync flush)
+ *
+ * @module cli/commands/session
+ */
+export interface SessionCommandResult {
+    success: boolean;
+    action: 'start' | 'end';
+    details: Record<string, unknown>;
+}
+export interface SessionStartOptions {
+    projectRoot?: string;
+    sessionId?: string;
+    silent?: boolean;
+    json?: boolean;
+}
+export interface SessionEndOptions {
+    projectRoot?: string;
+    silent?: boolean;
+    json?: boolean;
+}
+/**
+ * Execute `specweave session start`.
+ */
+export declare function sessionStartCommand(options?: SessionStartOptions): Promise<SessionCommandResult>;
+/**
+ * Execute `specweave session end`.
+ */
+export declare function sessionEndCommand(options?: SessionEndOptions): Promise<SessionCommandResult>;
+//# sourceMappingURL=session.d.ts.map

package/dist/src/cli/commands/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAeH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,GAAG,KAAK,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AASD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,oBAAoB,CAAC,CA0D/B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAuD/B"}

package/dist/src/cli/commands/session.js

@@ -0,0 +1,142 @@
+/**
+ * Session lifecycle CLI command.
+ *
+ * Replaces SessionStart and Stop hooks with explicit CLI subcommands:
+ *   specweave session start  — session initialization
+ *   specweave session end    — session cleanup (reflect + auto + sync flush)
+ *
+ * @module cli/commands/session
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { clearStaleAutoFiles, resetPressureFiles, writeBaselineHealth, cleanOrphaned, } from '../../core/session/session-lifecycle.js';
+import { checkReflectConfig } from '../../core/session/reflect-checker.js';
+import { scanAutoSession } from '../../core/session/auto-scanner.js';
+import { flushEventQueue } from '../../core/sync/event-queue-ops.js';
+import { createSessionDir } from '../../core/session/session-state-manager.js';
+function resolveProjectRoot(provided) {
+    const root = provided ?? process.cwd();
+    const configPath = path.join(root, '.specweave', 'config.json');
+    if (!fs.existsSync(configPath))
+        return null;
+    return root;
+}
+/**
+ * Execute `specweave session start`.
+ */
+export async function sessionStartCommand(options = {}) {
+    const projectRoot = resolveProjectRoot(options.projectRoot);
+    if (!projectRoot) {
+        const msg = 'Not a SpecWeave project (no .specweave/config.json found)';
+        if (!options.silent)
+            console.error(msg);
+        return { success: false, action: 'start', details: { error: msg } };
+    }
+    const stateDir = path.join(projectRoot, '.specweave', 'state');
+    const timestamp = new Date().toISOString();
+    try {
+        fs.mkdirSync(stateDir, { recursive: true });
+    }
+    catch {
+        return { success: false, action: 'start', details: { error: 'Cannot create state directory' } };
+    }
+    const details = {};
+    // 1. Clear stale auto files
+    details.staleFilesCleaned = clearStaleAutoFiles(stateDir);
+    // 2. Reset pressure files
+    details.pressureReset = resetPressureFiles(stateDir);
+    // 3. Baseline health check
+    const health = writeBaselineHealth(projectRoot, stateDir, timestamp);
+    details.healthWritten = health !== null;
+    if (health)
+        details.warningLevel = health.warningLevel;
+    // 4. Session directory
+    if (options.sessionId) {
+        try {
+            createSessionDir(options.sessionId, projectRoot);
+            details.sessionDirCreated = true;
+            details.sessionId = options.sessionId;
+        }
+        catch {
+            details.sessionDirCreated = false;
+        }
+    }
+    // 5. Clean orphaned state files
+    details.orphansCleaned = cleanOrphaned(stateDir);
+    const result = { success: true, action: 'start', details };
+    if (!options.silent) {
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log('Session started');
+            if (details.staleFilesCleaned)
+                console.log(`  Cleaned ${details.staleFilesCleaned} stale auto-mode files`);
+            if (health)
+                console.log(`  Prompt health: ${health.warningLevel} (baseline: ${health.baseline})`);
+            if (options.sessionId)
+                console.log(`  Session ID: ${options.sessionId}`);
+        }
+    }
+    return result;
+}
+/**
+ * Execute `specweave session end`.
+ */
+export async function sessionEndCommand(options = {}) {
+    const projectRoot = resolveProjectRoot(options.projectRoot);
+    if (!projectRoot) {
+        const msg = 'Not a SpecWeave project (no .specweave/config.json found)';
+        if (!options.silent)
+            console.error(msg);
+        return { success: false, action: 'end', details: { error: msg } };
+    }
+    const stateDir = path.join(projectRoot, '.specweave', 'state');
+    const configPath = path.join(projectRoot, '.specweave', 'config.json');
+    const details = {};
+    // 1. Reflect check — errors do not abort other operations
+    try {
+        const reflectResult = checkReflectConfig(configPath);
+        details.reflect = reflectResult;
+    }
+    catch (err) {
+        details.reflect = { error: String(err) };
+    }
+    // 2. Auto-mode scan — errors do not abort other operations
+    try {
+        const autoResult = scanAutoSession(stateDir, projectRoot, configPath);
+        details.auto = autoResult;
+    }
+    catch (err) {
+        details.auto = { error: String(err) };
+    }
+    // 3. Event queue flush — errors do not abort other operations
+    try {
+        const flushResult = flushEventQueue(stateDir);
+        details.sync = flushResult;
+    }
+    catch (err) {
+        details.sync = { error: String(err) };
+    }
+    const result = { success: true, action: 'end', details };
+    if (!options.silent) {
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log('Session ended');
+            const reflect = details.reflect;
+            if (reflect?.enabled)
+                console.log('  Reflection requested');
+            const auto = details.auto;
+            if (auto?.active && auto?.pendingTasks?.pending) {
+                console.log(`  Auto-mode: ${auto.pendingTasks.pending} pending tasks`);
+            }
+            const sync = details.sync;
+            if (sync?.flushed)
+                console.log(`  Flushed ${sync.flushed} unique increment(s)`);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=session.js.map

package/dist/src/cli/commands/session.js.map

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

package/dist/src/cli/commands/sync-flush.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Sync flush CLI command.
+ *
+ * Replaces PostToolUse event queuing (--queue mode) and
+ * stop-sync event flushing (default mode).
+ *
+ *   specweave sync flush              — flush pending events
+ *   specweave sync flush --queue JSON — append event to queue
+ *   specweave sync flush --dry-run    — report without clearing
+ *
+ * @module cli/commands/sync-flush
+ */
+export interface SyncFlushResult {
+    success: boolean;
+    mode: 'queue' | 'flush';
+    eventsQueued?: number;
+    eventsFlushed?: number;
+    incrementIds?: string[];
+}
+export interface SyncFlushOptions {
+    queue?: string;
+    projectRoot?: string;
+    silent?: boolean;
+    json?: boolean;
+    dryRun?: boolean;
+}
+/**
+ * Execute `specweave sync flush`.
+ */
+export declare function syncFlushCommand(options?: SyncFlushOptions): Promise<SyncFlushResult>;
+//# sourceMappingURL=sync-flush.d.ts.map

package/dist/src/cli/commands/sync-flush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-flush.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/sync-flush.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AASD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA2F1B"}

package/dist/src/cli/commands/sync-flush.js

@@ -0,0 +1,114 @@
+/**
+ * Sync flush CLI command.
+ *
+ * Replaces PostToolUse event queuing (--queue mode) and
+ * stop-sync event flushing (default mode).
+ *
+ *   specweave sync flush              — flush pending events
+ *   specweave sync flush --queue JSON — append event to queue
+ *   specweave sync flush --dry-run    — report without clearing
+ *
+ * @module cli/commands/sync-flush
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { queueEvent, flushEventQueue, readPendingEvents, } from '../../core/sync/event-queue-ops.js';
+function resolveProjectRoot(provided) {
+    const root = provided ?? process.cwd();
+    const configPath = path.join(root, '.specweave', 'config.json');
+    if (!fs.existsSync(configPath))
+        return null;
+    return root;
+}
+/**
+ * Execute `specweave sync flush`.
+ */
+export async function syncFlushCommand(options = {}) {
+    const projectRoot = resolveProjectRoot(options.projectRoot);
+    if (!projectRoot) {
+        const msg = 'Not a SpecWeave project (no .specweave/config.json found)';
+        if (!options.silent)
+            console.error(msg);
+        return { success: false, mode: options.queue ? 'queue' : 'flush' };
+    }
+    const stateDir = path.join(projectRoot, '.specweave', 'state');
+    // Queue mode
+    if (options.queue) {
+        try {
+            const parsed = JSON.parse(options.queue);
+            const event = parsed.event ?? 'unknown';
+            const incrementId = parsed.incrementId ?? 'unknown';
+            const timestamp = parsed.timestamp ?? new Date().toISOString();
+            const data = parsed.data;
+            const qResult = queueEvent(stateDir, event, incrementId, timestamp, data);
+            const result = {
+                success: qResult.queued > 0,
+                mode: 'queue',
+                eventsQueued: qResult.queued,
+            };
+            if (!options.silent) {
+                if (options.json) {
+                    console.log(JSON.stringify(result, null, 2));
+                }
+                else {
+                    console.log(`Queued event: ${event} for increment ${incrementId}`);
+                }
+            }
+            return result;
+        }
+        catch {
+            const msg = 'Invalid JSON in --queue argument';
+            if (!options.silent)
+                console.error(msg);
+            return { success: false, mode: 'queue', eventsQueued: 0 };
+        }
+    }
+    // Dry-run mode
+    if (options.dryRun) {
+        const events = readPendingEvents(stateDir);
+        const uniqueIds = [...new Set(events.map((e) => e.incrementId).filter(Boolean))];
+        const result = {
+            success: true,
+            mode: 'flush',
+            eventsFlushed: uniqueIds.length,
+            incrementIds: uniqueIds,
+        };
+        if (!options.silent) {
+            if (options.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else if (uniqueIds.length === 0) {
+                console.log('No pending events to flush');
+            }
+            else {
+                console.log(`Would flush ${uniqueIds.length} unique increment(s):`);
+                for (const id of uniqueIds)
+                    console.log(`  - ${id}`);
+            }
+        }
+        return result;
+    }
+    // Flush mode (default)
+    const fResult = flushEventQueue(stateDir);
+    const result = {
+        success: true,
+        mode: 'flush',
+        eventsFlushed: fResult.flushed,
+        incrementIds: fResult.incrementIds,
+    };
+    if (!options.silent) {
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else if (fResult.flushed === 0) {
+            console.log('No pending events to flush');
+        }
+        else {
+            console.log(`Flushed ${fResult.flushed} unique increment(s):`);
+            for (const id of fResult.incrementIds)
+                console.log(`  - ${id}`);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=sync-flush.js.map

package/dist/src/cli/commands/sync-flush.js.map

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

package/dist/src/core/analytics/event-writer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Analytics event writer core module.
+ *
+ * Extracted from hooks/handlers/post-tool-use-analytics.ts.
+ * Appends analytics events to events.jsonl.
+ *
+ * Never throws.
+ *
+ * @module core/analytics/event-writer
+ */
+import type { AnalyticsEvent } from './types.js';
+export interface WriteResult {
+    written: number;
+}
+/**
+ * Extract plugin name from a skill name.
+ * "sw:pm" → "specweave", "frontend-design:component" → "frontend-design", "my-skill" → "specweave"
+ */
+export declare function extractPlugin(skillName: string): string;
+/**
+ * Append an analytics event to events.jsonl.
+ * Creates the analytics directory if it does not exist.
+ */
+export declare function appendAnalyticsEvent(analyticsDir: string, event: AnalyticsEvent): WriteResult;
+/**
+ * Build and append a skill analytics event.
+ */
+export declare function writeSkillEvent(analyticsDir: string, name: string, plugin?: string, timestamp?: string): WriteResult;
+/**
+ * Build and append an agent analytics event.
+ */
+export declare function writeAgentEvent(analyticsDir: string, name: string, timestamp?: string): WriteResult;
+//# sourceMappingURL=event-writer.d.ts.map

package/dist/src/core/analytics/event-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-writer.d.ts","sourceRoot":"","sources":["../../../../src/core/analytics/event-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,cAAc,GACpB,WAAW,CAWb;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,CASb;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,CASb"}

package/dist/src/core/analytics/event-writer.js

@@ -0,0 +1,63 @@
+/**
+ * Analytics event writer core module.
+ *
+ * Extracted from hooks/handlers/post-tool-use-analytics.ts.
+ * Appends analytics events to events.jsonl.
+ *
+ * Never throws.
+ *
+ * @module core/analytics/event-writer
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Extract plugin name from a skill name.
+ * "sw:pm" → "specweave", "frontend-design:component" → "frontend-design", "my-skill" → "specweave"
+ */
+export function extractPlugin(skillName) {
+    if (!skillName.includes(':'))
+        return 'specweave';
+    const prefix = skillName.split(':')[0];
+    return prefix === 'sw' ? 'specweave' : prefix;
+}
+/**
+ * Append an analytics event to events.jsonl.
+ * Creates the analytics directory if it does not exist.
+ */
+export function appendAnalyticsEvent(analyticsDir, event) {
+    try {
+        fs.mkdirSync(analyticsDir, { recursive: true });
+        fs.appendFileSync(path.join(analyticsDir, 'events.jsonl'), JSON.stringify(event) + '\n');
+        return { written: 1 };
+    }
+    catch {
+        return { written: 0 };
+    }
+}
+/**
+ * Build and append a skill analytics event.
+ */
+export function writeSkillEvent(analyticsDir, name, plugin, timestamp) {
+    const event = {
+        timestamp: timestamp ?? new Date().toISOString(),
+        type: 'skill',
+        name,
+        success: true,
+        plugin: plugin ?? extractPlugin(name),
+    };
+    return appendAnalyticsEvent(analyticsDir, event);
+}
+/**
+ * Build and append an agent analytics event.
+ */
+export function writeAgentEvent(analyticsDir, name, timestamp) {
+    const event = {
+        timestamp: timestamp ?? new Date().toISOString(),
+        type: 'agent',
+        name,
+        success: true,
+        plugin: 'specweave',
+    };
+    return appendAnalyticsEvent(analyticsDir, event);
+}
+//# sourceMappingURL=event-writer.js.map