@10et/cli 1.0.0

package/dist/lib/telemetry.js

@@ -0,0 +1,376 @@
+/**
+ * @purpose Lightweight telemetry client with batched HTTP flush, spillover queue, and opt-out consent
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, appendFileSync, truncateSync } from 'fs';
+import { join, dirname } from 'path';
+import { platform } from 'os';
+import { fileURLToPath } from 'url';
+import { JFL_FILES } from '../utils/jfl-paths.js';
+import { physicalWorldCollector } from './telemetry/physical-world-collector.js';
+import { tenetEnv, TENET_PLATFORM_URL } from '../utils/tenet-env.js';
+const BATCH_SIZE = 25;
+const FLUSH_INTERVAL_MS = 10_000;
+const FLUSH_TIMEOUT_MS = 2_000;
+const INGEST_URL_DEFAULT = (TENET_PLATFORM_URL || 'https://tenet.ai') + '/api/v1/telemetry/ingest';
+let jflVersion;
+function getJflVersion() {
+    if (jflVersion)
+        return jflVersion;
+    try {
+        // Try multiple strategies to find package.json
+        let pkgPath;
+        // Strategy 1: CommonJS __dirname (Jest test environment)
+        if (typeof __dirname !== 'undefined') {
+            pkgPath = join(__dirname, '../../package.json');
+        }
+        // Strategy 2: process.cwd() fallback
+        if (!pkgPath || !existsSync(pkgPath)) {
+            pkgPath = join(process.cwd(), 'package.json');
+        }
+        // Strategy 3: ESM import.meta.url (production) - wrapped to avoid parse errors
+        if (!existsSync(pkgPath)) {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-implied-eval
+                const metaUrl = new Function('return import.meta.url')();
+                pkgPath = fileURLToPath(new URL('../../package.json', metaUrl));
+            }
+            catch {
+                // import.meta not available
+            }
+        }
+        if (pkgPath && existsSync(pkgPath)) {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            jflVersion = pkg.version || 'unknown';
+        }
+        else {
+            jflVersion = 'unknown';
+        }
+    }
+    catch {
+        jflVersion = 'unknown';
+    }
+    return jflVersion;
+}
+class TelemetryClient {
+    queue = [];
+    timer = null;
+    initialized = false;
+    disabled = false;
+    sessionId = '';
+    installId = '';
+    flushing = false;
+    exitHandlerRegistered = false;
+    async track(partial) {
+        if (this.disabled)
+            return;
+        if (!this.initialized) {
+            this.init();
+            if (this.disabled)
+                return;
+        }
+        // Base event data
+        const baseEvent = {
+            event_id: crypto.randomUUID(),
+            ts: new Date().toISOString(),
+            session_id: this.sessionId,
+            install_id: this.installId,
+            jfl_version: getJflVersion(),
+            node_version: process.versions.node,
+            os: platform(),
+            ...partial,
+        };
+        // Physical-world data collection is expensive (execSync calls).
+        // Enqueue the base event immediately; enrich in background if needed.
+        this.queue.push(baseEvent);
+        if (this.shouldCollectPhysicalWorldData(partial)) {
+            const idx = this.queue.length - 1;
+            physicalWorldCollector.collect(baseEvent).then(enriched => {
+                // Replace the base event with enriched version if still in queue
+                if (this.queue[idx] === baseEvent) {
+                    this.queue[idx] = enriched;
+                }
+            }).catch(() => {
+                // Physical-world collection failed — base event stays as-is
+            });
+        }
+        if (this.queue.length >= BATCH_SIZE) {
+            this.flush();
+        }
+    }
+    shouldCollectPhysicalWorldData(partial) {
+        // Collect physical-world data for these high-value events
+        const collectForCategories = ['command', 'performance', 'session'];
+        const collectForEvents = ['context_hub_started', 'agent_executed', 'eval_completed'];
+        return collectForCategories.includes(partial.category || '') ||
+            collectForEvents.includes(partial.event || '');
+    }
+    init() {
+        this.initialized = true;
+        // Env var override — highest priority (reads TENET_TELEMETRY then JFL_TELEMETRY)
+        const envVar = tenetEnv('TELEMETRY');
+        if (envVar === '0' || envVar === 'false' || envVar === 'off') {
+            this.disabled = true;
+            return;
+        }
+        const envForceEnable = envVar === '1' || envVar === 'true' || envVar === 'on';
+        const config = this.getConfig();
+        if (!envForceEnable) {
+            // First-time consent notice
+            if (config.consent_shown !== true) {
+                if (process.stdout.isTTY) {
+                    this.showConsentNotice();
+                    config.consent_shown = true;
+                    if (config.enabled === undefined) {
+                        config.enabled = true;
+                    }
+                    this.saveConfig(config);
+                }
+                else {
+                    // Non-TTY: default disabled until explicitly enabled
+                    this.disabled = true;
+                    return;
+                }
+            }
+            if (config.enabled === false) {
+                this.disabled = true;
+                return;
+            }
+        }
+        // Install ID
+        if (!config.install_id) {
+            config.install_id = crypto.randomUUID();
+            this.saveConfig(config);
+        }
+        this.installId = config.install_id;
+        // Session ID (random per process)
+        this.sessionId = crypto.randomUUID();
+        // Start flush timer
+        this.timer = setInterval(() => this.flush(), FLUSH_INTERVAL_MS);
+        this.timer.unref();
+        // Register exit handler
+        if (!this.exitHandlerRegistered) {
+            this.exitHandlerRegistered = true;
+            const onExit = () => this.flushSync();
+            process.on('beforeExit', onExit);
+            process.on('SIGINT', () => { this.flushSync(); process.exit(0); });
+            process.on('SIGTERM', () => { this.flushSync(); process.exit(0); });
+        }
+        // Load spillover from previous run
+        this.loadSpillover();
+    }
+    showConsentNotice() {
+        const notice = `
+  JFL Telemetry Notice
+
+  JFL collects anonymous usage data to improve the tool.
+  No file paths, arguments, usernames, or content are collected.
+
+  Disable anytime:  jfl preferences --no-telemetry
+  Or set:           JFL_TELEMETRY=0
+`;
+        process.stderr.write(notice);
+    }
+    getConfig() {
+        try {
+            const configPath = JFL_FILES.config;
+            if (existsSync(configPath)) {
+                const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+                return config.telemetry || {};
+            }
+        }
+        catch {
+            // ignore
+        }
+        return {};
+    }
+    saveConfig(telemetryConfig) {
+        try {
+            const configPath = JFL_FILES.config;
+            const configDir = dirname(configPath);
+            if (!existsSync(configDir)) {
+                mkdirSync(configDir, { recursive: true });
+            }
+            let config = {};
+            if (existsSync(configPath)) {
+                try {
+                    config = JSON.parse(readFileSync(configPath, 'utf-8'));
+                }
+                catch {
+                    config = {};
+                }
+            }
+            config.telemetry = telemetryConfig;
+            writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+        }
+        catch {
+            // ignore — config write is best-effort
+        }
+    }
+    async flush() {
+        if (this.flushing || this.queue.length === 0)
+            return;
+        this.flushing = true;
+        const batch = this.queue.splice(0, BATCH_SIZE);
+        this.archiveLocally(batch);
+        const url = TENET_PLATFORM_URL
+            ? `${TENET_PLATFORM_URL}/api/v1/telemetry/ingest`
+            : INGEST_URL_DEFAULT;
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-JFL-Install-Id': this.installId,
+                },
+                body: JSON.stringify({ events: batch }),
+                signal: AbortSignal.timeout(5_000),
+            });
+            if (response.status === 401) {
+                this.disabled = true;
+                return;
+            }
+            if (response.status === 429) {
+                this.queue.unshift(...batch);
+                return;
+            }
+            if (!response.ok) {
+                this.spillToDisk(batch);
+            }
+        }
+        catch {
+            this.spillToDisk(batch);
+        }
+        finally {
+            this.flushing = false;
+        }
+    }
+    flushSync() {
+        if (this.queue.length === 0)
+            return;
+        const batch = this.queue.splice(0);
+        this.archiveLocally(batch);
+        this.spillToDisk(batch);
+    }
+    get spilloverPath() {
+        return JFL_FILES.telemetryQueue;
+    }
+    archiveLocally(events) {
+        try {
+            const archivePath = JFL_FILES.telemetryArchive;
+            const dir = dirname(archivePath);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            const lines = events.map(e => JSON.stringify(e)).join('\n') + '\n';
+            appendFileSync(archivePath, lines);
+        }
+        catch { }
+    }
+    spillToDisk(events) {
+        try {
+            const dir = dirname(this.spilloverPath);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            const lines = events.map(e => JSON.stringify(e)).join('\n') + '\n';
+            appendFileSync(this.spilloverPath, lines);
+        }
+        catch {
+            // Last resort — drop events silently
+        }
+    }
+    loadSpillover() {
+        try {
+            if (!existsSync(this.spilloverPath))
+                return;
+            const content = readFileSync(this.spilloverPath, 'utf-8').trim();
+            if (!content)
+                return;
+            const events = [];
+            for (const line of content.split('\n')) {
+                try {
+                    events.push(JSON.parse(line));
+                }
+                catch {
+                    // skip bad lines
+                }
+            }
+            if (events.length > 0) {
+                this.queue.unshift(...events);
+                // Truncate file after loading
+                truncateSync(this.spilloverPath, 0);
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    isEnabled() {
+        if (!this.initialized)
+            this.init();
+        return !this.disabled;
+    }
+    getInstallId() {
+        if (!this.initialized)
+            this.init();
+        return this.installId;
+    }
+    getSessionId() {
+        if (!this.initialized)
+            this.init();
+        return this.sessionId;
+    }
+    getQueueSize() {
+        return this.queue.length;
+    }
+    getSpilloverEvents() {
+        try {
+            if (!existsSync(this.spilloverPath))
+                return [];
+            const content = readFileSync(this.spilloverPath, 'utf-8').trim();
+            if (!content)
+                return [];
+            return content.split('\n').map(line => {
+                try {
+                    return JSON.parse(line);
+                }
+                catch {
+                    return null;
+                }
+            }).filter(Boolean);
+        }
+        catch {
+            return [];
+        }
+    }
+    disable() {
+        this.disabled = true;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        const config = this.getConfig();
+        config.enabled = false;
+        this.saveConfig(config);
+    }
+    enable() {
+        const config = this.getConfig();
+        config.enabled = true;
+        config.consent_shown = true;
+        if (!config.install_id) {
+            config.install_id = crypto.randomUUID();
+        }
+        this.saveConfig(config);
+        this.disabled = false;
+        this.initialized = false; // Re-init on next track()
+    }
+    resetInstallId() {
+        const config = this.getConfig();
+        config.install_id = crypto.randomUUID();
+        this.saveConfig(config);
+        this.installId = config.install_id;
+    }
+}
+// Singleton
+export const telemetry = new TelemetryClient();
+//# sourceMappingURL=telemetry.js.map

package/dist/lib/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/lib/telemetry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AACrG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAA;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAA;AAEnC,OAAO,EAAa,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAA;AAChF,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAmB,MAAM,uBAAuB,CAAA;AAErF,MAAM,UAAU,GAAG,EAAE,CAAA;AACrB,MAAM,iBAAiB,GAAG,MAAM,CAAA;AAChC,MAAM,gBAAgB,GAAG,KAAK,CAAA;AAC9B,MAAM,kBAAkB,GAAG,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,GAAG,0BAA0B,CAAA;AAElG,IAAI,UAA8B,CAAA;AAElC,SAAS,aAAa;IACpB,IAAI,UAAU;QAAE,OAAO,UAAU,CAAA;IACjC,IAAI,CAAC;QACH,+CAA+C;QAC/C,IAAI,OAA2B,CAAA;QAE/B,yDAAyD;QACzD,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;YACrC,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAA;QACjD,CAAC;QAED,qCAAqC;QACrC,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAA;QAC/C,CAAC;QAED,+EAA+E;QAC/E,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,8DAA8D;gBAC9D,MAAM,OAAO,GAAG,IAAI,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAA;gBACxD,OAAO,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,CAAA;YACjE,CAAC;YAAC,MAAM,CAAC;gBACP,4BAA4B;YAC9B,CAAC;QACH,CAAC;QAED,IAAI,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;YACtD,UAAU,GAAG,GAAG,CAAC,OAAO,IAAI,SAAS,CAAA;QACvC,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,SAAS,CAAA;QACxB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,GAAG,SAAS,CAAA;IACxB,CAAC;IACD,OAAO,UAAW,CAAA;AACpB,CAAC;AAED,MAAM,eAAe;IACX,KAAK,GAAqB,EAAE,CAAA;IAC5B,KAAK,GAA0C,IAAI,CAAA;IACnD,WAAW,GAAG,KAAK,CAAA;IACnB,QAAQ,GAAG,KAAK,CAAA;IAChB,SAAS,GAAW,EAAE,CAAA;IACtB,SAAS,GAAW,EAAE,CAAA;IACtB,QAAQ,GAAG,KAAK,CAAA;IAChB,qBAAqB,GAAG,KAAK,CAAA;IAErC,KAAK,CAAC,KAAK,CAAC,OAA6E;QACvF,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAM;QAEzB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,EAAE,CAAA;YACX,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAM;QAC3B,CAAC;QAED,kBAAkB;QAClB,MAAM,SAAS,GAAmB;YAChC,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE;YAC7B,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,WAAW,EAAE,aAAa,EAAE;YAC5B,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;YACnC,EAAE,EAAE,QAAQ,EAAE;YACd,GAAG,OAAO;SACO,CAAA;QAEnB,gEAAgE;QAChE,sEAAsE;QACtE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAE1B,IAAI,IAAI,CAAC,8BAA8B,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;YACjC,sBAAsB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBACxD,iEAAiE;gBACjE,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;oBAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,QAA0B,CAAA;gBAC9C,CAAC;YACH,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBACZ,4DAA4D;YAC9D,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,EAAE,CAAA;QACd,CAAC;IACH,CAAC;IAEO,8BAA8B,CAAC,OAAgC;QACrE,0DAA0D;QAC1D,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,CAAC,CAAA;QAClE,MAAM,gBAAgB,GAAG,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAA;QAEpF,OAAO,oBAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;YACrD,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;IACvD,CAAC;IAEO,IAAI;QACV,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QAEvB,iFAAiF;QACjF,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAA;QACpC,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAC7D,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;YACpB,OAAM;QACR,CAAC;QACD,MAAM,cAAc,GAAG,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,IAAI,CAAA;QAE7E,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;QAE/B,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,4BAA4B;YAC5B,IAAI,MAAM,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;gBAClC,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;oBACzB,IAAI,CAAC,iBAAiB,EAAE,CAAA;oBACxB,MAAM,CAAC,aAAa,GAAG,IAAI,CAAA;oBAC3B,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;wBACjC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;oBACvB,CAAC;oBACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;gBACzB,CAAC;qBAAM,CAAC;oBACN,qDAAqD;oBACrD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;oBACpB,OAAM;gBACR,CAAC;YACH,CAAC;YAED,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;gBAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;gBACpB,OAAM;YACR,CAAC;QACH,CAAC;QAED,aAAa;QACb,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,EAAE,CAAA;YACvC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;QACzB,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,UAAU,CAAA;QAElC,kCAAkC;QAClC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,CAAA;QAEpC,oBAAoB;QACpB,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,iBAAiB,CAAC,CAAA;QAC/D,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;QAElB,wBAAwB;QACxB,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChC,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAA;YACjC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;YACrC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;YAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;YACjE,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;QACpE,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,aAAa,EAAE,CAAA;IACtB,CAAC;IAEO,iBAAiB;QACvB,MAAM,MAAM,GAAG;;;;;;;;CAQlB,CAAA;QACG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC9B,CAAC;IAEO,SAAS;QACf,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAA;YACnC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA;gBAC5D,OAAO,MAAM,CAAC,SAAS,IAAI,EAAE,CAAA;YAC/B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,OAAO,EAAE,CAAA;IACX,CAAC;IAEO,UAAU,CAAC,eAAgC;QACjD,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAA;YACnC,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;YACrC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YAC3C,CAAC;YACD,IAAI,MAAM,GAAwB,EAAE,CAAA;YACpC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC;oBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA;gBACxD,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,GAAG,EAAE,CAAA;gBACb,CAAC;YACH,CAAC;YACD,MAAM,CAAC,SAAS,GAAG,eAAe,CAAA;YAClC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QACpD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QAEpB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,CAAA;QAE9C,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;QAE1B,MAAM,GAAG,GAAG,kBAAkB;YAC5B,CAAC,CAAC,GAAG,kBAAkB,0BAA0B;YACjD,CAAC,CAAC,kBAAkB,CAAA;QAEtB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,kBAAkB,EAAE,IAAI,CAAC,SAAS;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;gBACvC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;aACnC,CAAC,CAAA;YAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;gBACpB,OAAM;YACR,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAA;gBAC5B,OAAM;YACR,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;YACzB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QACzB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;QACvB,CAAC;IACH,CAAC;IAEO,SAAS;QACf,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QAClC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;QAC1B,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;IAED,IAAY,aAAa;QACvB,OAAO,SAAS,CAAC,cAAc,CAAA;IACjC,CAAC;IAEO,cAAc,CAAC,MAAwB;QAC7C,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,SAAS,CAAC,gBAAgB,CAAA;YAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;YAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YACrC,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;YAClE,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;QACpC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAEO,WAAW,CAAC,MAAwB;QAC1C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;YACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YACrC,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;YAClE,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC;gBAAE,OAAM;YAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAA;YAChE,IAAI,CAAC,OAAO;gBAAE,OAAM;YAEpB,MAAM,MAAM,GAAqB,EAAE,CAAA;YACnC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvC,IAAI,CAAC;oBACH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;gBAC/B,CAAC;gBAAC,MAAM,CAAC;oBACP,iBAAiB;gBACnB,CAAC;YACH,CAAC;YAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAA;gBAC7B,8BAA8B;gBAC9B,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAA;YACrC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,IAAI,CAAC,IAAI,EAAE,CAAA;QAClC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAA;IACvB,CAAC;IAED,YAAY;QACV,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,IAAI,CAAC,IAAI,EAAE,CAAA;QAClC,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;IAED,YAAY;QACV,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,IAAI,CAAC,IAAI,EAAE,CAAA;QAClC,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;IAC1B,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC;gBAAE,OAAO,EAAE,CAAA;YAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAA;YAChE,IAAI,CAAC,OAAO;gBAAE,OAAO,EAAE,CAAA;YACvB,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;gBACpC,IAAI,CAAC;oBAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;gBAAC,CAAC;gBAAC,MAAM,CAAC;oBAAC,OAAO,IAAI,CAAA;gBAAC,CAAC;YACvD,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAqB,CAAA;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAA;QACX,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;QAC/B,MAAM,CAAC,OAAO,GAAG,KAAK,CAAA;QACtB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;IACzB,CAAC;IAED,MAAM;QACJ,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;QAC/B,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;QACrB,MAAM,CAAC,aAAa,GAAG,IAAI,CAAA;QAC3B,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,EAAE,CAAA;QACzC,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;QACvB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;QACrB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAA,CAAC,0BAA0B;IACrD,CAAC;IAED,cAAc;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;QAC/B,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,EAAE,CAAA;QACvC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;QACvB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,UAAW,CAAA;IACrC,CAAC;CACF;AAED,YAAY;AACZ,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,eAAe,EAAE,CAAA"}

package/dist/lib/tenet-board-agent.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @purpose Tenet Board Surface Agent - Manages smart project management
+ *
+ * Coordinates: peter-parker, issue-optimizer, pr-quality RL agents
+ * Learns: Project management patterns, team coordination
+ * Collaborates: With tenet-ide.relay for technical fixes
+ */
+import { SurfaceAgent, SurfaceContext, SurfaceAction } from './surface-agent.js';
+export declare class TenetBoardAgent extends SurfaceAgent {
+    constructor();
+    /**
+     * Main decision loop for board surface
+     */
+    decide(context: SurfaceContext): Promise<SurfaceAction>;
+    /**
+     * Handle events from other surfaces
+     */
+    handleCrossSurfaceEvent(event: string, data: any): Promise<void>;
+    /**
+     * Handle agent assignment from IDE
+     */
+    private handleAgentAssignment;
+    /**
+     * Handle fix completion from IDE
+     */
+    private handleFixCompletion;
+    /**
+     * Handle build failure notification
+     */
+    private handleBuildFailure;
+    /**
+     * Handle PR ready for review
+     */
+    private handlePRReview;
+    /**
+     * Update issue status in project management system
+     */
+    private updateIssueStatus;
+    /**
+     * Create urgent issue for critical problems
+     */
+    private createUrgentIssue;
+    /**
+     * Calculate velocity improvement from automation
+     */
+    private calculateVelocityImpact;
+    /**
+     * Board-specific learning from user interactions
+     */
+    learnFromBoardUsage(action: string, context: SurfaceContext): Promise<void>;
+}
+//# sourceMappingURL=tenet-board-agent.d.ts.map

package/dist/lib/tenet-board-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenet-board-agent.d.ts","sourceRoot":"","sources":["../../src/lib/tenet-board-agent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEhF,qBAAa,eAAgB,SAAQ,YAAY;;IAY/C;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAqD7D;;OAEG;IACG,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBtE;;OAEG;YACW,qBAAqB;IAoBnC;;OAEG;YACW,mBAAmB;IAsBjC;;OAEG;YACW,kBAAkB;IAmBhC;;OAEG;YACW,cAAc;IAY5B;;OAEG;YACW,iBAAiB;IAgB/B;;OAEG;YACW,iBAAiB;IAQ/B;;OAEG;YACW,uBAAuB;IAWrC;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAwBlF"}

package/dist/lib/tenet-board-agent.js

@@ -0,0 +1,226 @@
+/**
+ * @purpose Tenet Board Surface Agent - Manages smart project management
+ *
+ * Coordinates: peter-parker, issue-optimizer, pr-quality RL agents
+ * Learns: Project management patterns, team coordination
+ * Collaborates: With tenet-ide.relay for technical fixes
+ */
+import { SurfaceAgent } from './surface-agent.js';
+export class TenetBoardAgent extends SurfaceAgent {
+    constructor() {
+        super('board', 'tenet-board.relay');
+        this.associatedRLAgents = [
+            'peter-parker',
+            'issue-optimizer',
+            'pr-quality',
+            'sprint-planner',
+            'velocity-tracker'
+        ];
+    }
+    /**
+     * Main decision loop for board surface
+     */
+    async decide(context) {
+        const metrics = await this.getSurfaceMetrics();
+        // Check for high-priority backlog items
+        if (context.crossSurfaceData.backlogItems > 10) {
+            return {
+                type: 'prioritize_backlog',
+                surface: 'board',
+                data: {
+                    itemCount: context.crossSurfaceData.backlogItems,
+                    strategy: 'impact_urgency_matrix'
+                }
+            };
+        }
+        // Check for stale in-progress items
+        if (context.crossSurfaceData.staleInProgress > 0) {
+            return {
+                type: 'coordinate_stale_fixes',
+                surface: 'board',
+                data: {
+                    staleCount: context.crossSurfaceData.staleInProgress
+                },
+                coordination: {
+                    targetSurface: 'tenet-ide.relay',
+                    method: 'analyze_stuck_issues',
+                    payload: { threshold: '7days' }
+                }
+            };
+        }
+        // Check if Peter Parker should pick up new issues
+        if (context.crossSurfaceData.availableIssues > 0) {
+            return {
+                type: 'dispatch_peter_parker',
+                surface: 'board',
+                data: {
+                    availableIssues: context.crossSurfaceData.availableIssues,
+                    capacity: 'normal'
+                }
+            };
+        }
+        // Default: optimize board flow
+        return {
+            type: 'optimize_flow',
+            surface: 'board',
+            data: {
+                focus: 'throughput_velocity'
+            }
+        };
+    }
+    /**
+     * Handle events from other surfaces
+     */
+    async handleCrossSurfaceEvent(event, data) {
+        switch (event) {
+            case 'agent_assigned':
+                await this.handleAgentAssignment(data);
+                break;
+            case 'fix_completed':
+                await this.handleFixCompletion(data);
+                break;
+            case 'build_failure':
+                await this.handleBuildFailure(data);
+                break;
+            case 'pr_ready_review':
+                await this.handlePRReview(data);
+                break;
+            default:
+                console.log(`[${this.subwayId}] Unhandled event: ${event}`);
+        }
+    }
+    /**
+     * Handle agent assignment from IDE
+     */
+    async handleAgentAssignment(data) {
+        console.log(`[${this.subwayId}] Agent ${data.agent} assigned to issue ${data.issue}`);
+        // Update issue status to "in-progress" 
+        await this.updateIssueStatus(data.issue, 'in_progress', {
+            assignedAgent: data.agent,
+            estimatedTime: data.estimatedTime,
+            startTime: new Date().toISOString()
+        });
+        // Learn from assignment patterns
+        await this.broadcastLearning({
+            pattern: 'cross_surface_assignment',
+            surfaces: ['board', 'ide'],
+            optimization: '+25% faster issue resolution',
+            confidence: 0.8,
+            userImpact: '+12% faster'
+        });
+    }
+    /**
+     * Handle fix completion from IDE
+     */
+    async handleFixCompletion(data) {
+        console.log(`[${this.subwayId}] Fix completed for issue ${data.issue}`);
+        // Move to eval column for review
+        await this.updateIssueStatus(data.issue, 'eval', {
+            completedBy: data.agent,
+            prLink: data.prUrl,
+            completionTime: new Date().toISOString()
+        });
+        // Calculate velocity impact
+        const velocityImprovement = await this.calculateVelocityImpact(data);
+        await this.broadcastLearning({
+            pattern: 'automated_resolution',
+            surfaces: ['board', 'ide'],
+            optimization: `+${velocityImprovement}% team velocity`,
+            confidence: 0.9,
+            userImpact: '+20% engagement'
+        });
+    }
+    /**
+     * Handle build failure notification
+     */
+    async handleBuildFailure(data) {
+        console.log(`[${this.subwayId}] Build failure: ${data.build.id}`);
+        // Create urgent issue for build failure
+        const urgentIssue = await this.createUrgentIssue({
+            title: `Build Failure: ${data.build.branch}`,
+            priority: 'critical',
+            assignedTo: data.healthAgent,
+            buildId: data.build.id
+        });
+        // Immediately dispatch Peter Parker
+        await this.spawnRLAgent('peter-parker', {
+            issue: urgentIssue,
+            priority: 'critical',
+            context: 'build_failure'
+        });
+    }
+    /**
+     * Handle PR ready for review
+     */
+    async handlePRReview(data) {
+        console.log(`[${this.subwayId}] PR ready for review: ${data.pr.title}`);
+        // Move associated issue to eval
+        if (data.pr.linkedIssue) {
+            await this.updateIssueStatus(data.pr.linkedIssue, 'eval', {
+                prUrl: data.pr.url,
+                readyForReview: true
+            });
+        }
+    }
+    /**
+     * Update issue status in project management system
+     */
+    async updateIssueStatus(issueId, status, metadata) {
+        console.log(`[${this.subwayId}] Updating issue ${issueId} to ${status}`);
+        // This would integrate with GitHub Issues, Linear, etc.
+        // For now just log the transition
+        await this.updateLearning(`issue_${status}`, 'positive', {
+            surfaceType: 'board',
+            userId: 'system',
+            sessionId: 'auto',
+            capabilities: ['issue_tracking'],
+            userPreferences: {},
+            crossSurfaceData: { issueId, status, metadata }
+        });
+    }
+    /**
+     * Create urgent issue for critical problems
+     */
+    async createUrgentIssue(issue) {
+        const issueId = `urgent_${Date.now()}`;
+        console.log(`[${this.subwayId}] Creating urgent issue: ${issueId}`);
+        // This would create actual GitHub issue
+        return issueId;
+    }
+    /**
+     * Calculate velocity improvement from automation
+     */
+    async calculateVelocityImpact(data) {
+        // Simple calculation for demo
+        const baseVelocity = 8; // issues per week
+        const automationSaving = 2; // hours saved per issue
+        const teamHoursPerWeek = 40;
+        const velocityIncrease = (automationSaving / teamHoursPerWeek) * baseVelocity * 100;
+        return Math.round(velocityIncrease);
+    }
+    /**
+     * Board-specific learning from user interactions
+     */
+    async learnFromBoardUsage(action, context) {
+        const boardPatterns = {
+            'issue_created': 'User adding work to backlog',
+            'issue_prioritized': 'User managing priorities',
+            'status_updated': 'User tracking progress',
+            'sprint_planned': 'User organizing work cycles',
+            'velocity_reviewed': 'User analyzing team performance'
+        };
+        const pattern = boardPatterns[action] || 'unknown_board_action';
+        await this.updateLearning(action, 'positive', context);
+        // Share board-specific insights
+        if (action === 'sprint_planned') {
+            await this.broadcastLearning({
+                pattern: 'effective_sprint_planning',
+                surfaces: ['board'],
+                optimization: '+10% sprint completion rate',
+                confidence: 0.75,
+                userImpact: '+12% faster'
+            });
+        }
+    }
+}
+//# sourceMappingURL=tenet-board-agent.js.map