@hidden-leaf/x-skill 1.0.0

package/dist/index.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * @hidden-leaf/x-skill
+ *
+ * X (Twitter) bookmark intelligence skill for Claude Code.
+ * Turns curated X bookmarks into structured research briefs.
+ *
+ * v1: Bookmark intelligence (list, fetch, brief)
+ * v2: Search, threads, profile (planned)
+ * v3: Publish, schedule, reply (planned)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = exports.createLogger = exports.createStoreFromEnv = exports.BookmarkStore = exports.generateBrief = exports.buildBriefPrompt = exports.createBookmarksSkillFromEnv = exports.BookmarksSkill = exports.DEFAULT_EXPANSIONS = exports.DEFAULT_USER_FIELDS = exports.DEFAULT_TWEET_FIELDS = exports.XNotFoundError = exports.XRateLimitError = exports.XAuthenticationError = exports.XApiRequestError = exports.createXClientFromEnv = exports.XClient = void 0;
+// ============================================================================
+// Client
+// ============================================================================
+var x_client_js_1 = require("./clients/x-client.js");
+Object.defineProperty(exports, "XClient", { enumerable: true, get: function () { return x_client_js_1.XClient; } });
+Object.defineProperty(exports, "createXClientFromEnv", { enumerable: true, get: function () { return x_client_js_1.createXClientFromEnv; } });
+var types_js_1 = require("./clients/types.js");
+Object.defineProperty(exports, "XApiRequestError", { enumerable: true, get: function () { return types_js_1.XApiRequestError; } });
+Object.defineProperty(exports, "XAuthenticationError", { enumerable: true, get: function () { return types_js_1.XAuthenticationError; } });
+Object.defineProperty(exports, "XRateLimitError", { enumerable: true, get: function () { return types_js_1.XRateLimitError; } });
+Object.defineProperty(exports, "XNotFoundError", { enumerable: true, get: function () { return types_js_1.XNotFoundError; } });
+Object.defineProperty(exports, "DEFAULT_TWEET_FIELDS", { enumerable: true, get: function () { return types_js_1.DEFAULT_TWEET_FIELDS; } });
+Object.defineProperty(exports, "DEFAULT_USER_FIELDS", { enumerable: true, get: function () { return types_js_1.DEFAULT_USER_FIELDS; } });
+Object.defineProperty(exports, "DEFAULT_EXPANSIONS", { enumerable: true, get: function () { return types_js_1.DEFAULT_EXPANSIONS; } });
+// ============================================================================
+// Bookmarks Skill
+// ============================================================================
+var index_js_1 = require("./skills/bookmarks/index.js");
+Object.defineProperty(exports, "BookmarksSkill", { enumerable: true, get: function () { return index_js_1.BookmarksSkill; } });
+Object.defineProperty(exports, "createBookmarksSkillFromEnv", { enumerable: true, get: function () { return index_js_1.createBookmarksSkillFromEnv; } });
+var synthesize_js_1 = require("./skills/bookmarks/synthesize.js");
+Object.defineProperty(exports, "buildBriefPrompt", { enumerable: true, get: function () { return synthesize_js_1.buildBriefPrompt; } });
+Object.defineProperty(exports, "generateBrief", { enumerable: true, get: function () { return synthesize_js_1.generateBrief; } });
+// ============================================================================
+// Cache
+// ============================================================================
+var store_js_1 = require("./cache/store.js");
+Object.defineProperty(exports, "BookmarkStore", { enumerable: true, get: function () { return store_js_1.BookmarkStore; } });
+Object.defineProperty(exports, "createStoreFromEnv", { enumerable: true, get: function () { return store_js_1.createStoreFromEnv; } });
+// ============================================================================
+// Utilities
+// ============================================================================
+var logger_js_1 = require("./utils/logger.js");
+Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_js_1.createLogger; } });
+// ============================================================================
+// Version
+// ============================================================================
+exports.VERSION = '1.0.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,qDAAsE;AAA7D,sGAAA,OAAO,OAAA;AAAE,mHAAA,oBAAoB,OAAA;AAiCtC,+CAQ4B;AAP1B,4GAAA,gBAAgB,OAAA;AAChB,gHAAA,oBAAoB,OAAA;AACpB,2GAAA,eAAe,OAAA;AACf,0GAAA,cAAc,OAAA;AACd,gHAAA,oBAAoB,OAAA;AACpB,+GAAA,mBAAmB,OAAA;AACnB,8GAAA,kBAAkB,OAAA;AAGpB,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,wDAA0F;AAAjF,0GAAA,cAAc,OAAA;AAAE,uHAAA,2BAA2B,OAAA;AACpD,kEAAmF;AAA1E,iHAAA,gBAAgB,OAAA;AAAE,8GAAA,aAAa,OAAA;AAExC,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E,6CAAqE;AAA5D,yGAAA,aAAa,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAiB1C,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,+CAAiD;AAAxC,yGAAA,YAAY,OAAA;AAErB,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAElE,QAAA,OAAO,GAAG,OAAO,CAAC"}

package/dist/skills/bookmarks/index.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Bookmarks skill — sync, list, fetch, brief.
+ *
+ * Architecture: sync pulls from X API → upserts into SQLite cache.
+ * All reads (list, fetch, brief) hit the cache, not the API.
+ * You only pay when you sync.
+ *
+ * v1 commands:
+ *   x bookmarks sync                         → pull latest from X API into cache
+ *   x bookmarks sync --folder "Robotics"     → sync a single folder
+ *   x bookmarks list                         → list all bookmark folders (from cache)
+ *   x bookmarks fetch --folder "Robotics"    → pull cached posts from a folder
+ *   x bookmarks brief --folder "Robotics"    → synthesize a research brief (from cache)
+ */
+import { XClient } from '../../clients/x-client.js';
+import { BookmarkStore } from '../../cache/store.js';
+import type { BookmarkListOutput, BookmarkFetchOutput, BriefOptions, BookmarkBriefOutput, SyncResult } from './types.js';
+export declare class BookmarksSkill {
+    private readonly client;
+    private readonly store;
+    constructor(client: XClient, store?: BookmarkStore);
+    /**
+     * Sync all bookmark folders and their tweets from X API into local cache.
+     * This is the only command that hits the X API and costs money.
+     *
+     * Strategy (minimizes API calls):
+     *   1. Fetch folder list + tweet IDs per folder (lightweight, IDs only)
+     *   2. Fetch ALL bookmarks with full data from main endpoint (paginated)
+     *   3. Hydrate any missing tweets via GET /2/tweets lookup (100 per call)
+     *   4. Cross-reference IDs to assign tweets to folders in the cache
+     */
+    syncAll(): Promise<SyncResult>;
+    /**
+     * Sync a single folder by name.
+     * Fetches folder IDs, then hydrates via tweet lookup.
+     */
+    syncFolder(folderName: string): Promise<SyncResult>;
+    /**
+     * List all bookmark folders from local cache.
+     * Run `sync` first if cache is empty.
+     */
+    listFolders(): BookmarkListOutput;
+    /**
+     * Fetch cached bookmarked tweets from a folder by name.
+     */
+    fetchByFolderName(folderName: string): BookmarkFetchOutput;
+    /**
+     * Fetch cached bookmarked tweets from a folder by ID.
+     */
+    fetchByFolderId(folderId: string, folderName?: string): BookmarkFetchOutput;
+    /**
+     * Fetch ALL cached bookmarks across all folders.
+     */
+    fetchAll(): BookmarkFetchOutput;
+    /**
+     * Generate a research brief from cached bookmarks.
+     */
+    brief(options?: BriefOptions): Promise<BookmarkBriefOutput>;
+    /**
+     * Get cache statistics.
+     */
+    stats(): {
+        folders: number;
+        tweets: number;
+        users: number;
+        lastSync: string | null;
+    };
+    private toEnrichedBookmark;
+    /**
+     * Close the underlying database connection.
+     */
+    close(): void;
+}
+/**
+ * Create a BookmarksSkill from environment variables.
+ * Reads X_BEARER_TOKEN, X_USER_ID, and optionally X_CACHE_DB_PATH from .env.
+ */
+export declare function createBookmarksSkillFromEnv(): BookmarksSkill;
+//# sourceMappingURL=index.d.ts.map

package/dist/skills/bookmarks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/skills/bookmarks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAwB,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAsB,MAAM,sBAAsB,CAAC;AAEzE,OAAO,KAAK,EAEV,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACX,MAAM,YAAY,CAAC;AAGpB,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;gBAGnB,MAAM,EAAE,OAAO,EAChC,KAAK,CAAC,EAAE,aAAa;IASvB;;;;;;;;;OASG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IA+EpC;;;OAGG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAgEzD;;;OAGG;IACH,WAAW,IAAI,kBAAkB;IAajC;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB;IAa1D;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,mBAAmB;IAgB3E;;OAEG;IACH,QAAQ,IAAI,mBAAmB;IAoB/B;;OAEG;IACG,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAoCrE;;OAEG;IACH,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAQpF,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAMD;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,cAAc,CAI5D"}

package/dist/skills/bookmarks/index.js

@@ -0,0 +1,288 @@
+"use strict";
+/**
+ * Bookmarks skill — sync, list, fetch, brief.
+ *
+ * Architecture: sync pulls from X API → upserts into SQLite cache.
+ * All reads (list, fetch, brief) hit the cache, not the API.
+ * You only pay when you sync.
+ *
+ * v1 commands:
+ *   x bookmarks sync                         → pull latest from X API into cache
+ *   x bookmarks sync --folder "Robotics"     → sync a single folder
+ *   x bookmarks list                         → list all bookmark folders (from cache)
+ *   x bookmarks fetch --folder "Robotics"    → pull cached posts from a folder
+ *   x bookmarks brief --folder "Robotics"    → synthesize a research brief (from cache)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BookmarksSkill = void 0;
+exports.createBookmarksSkillFromEnv = createBookmarksSkillFromEnv;
+const x_client_js_1 = require("../../clients/x-client.js");
+const store_js_1 = require("../../cache/store.js");
+const synthesize_js_1 = require("./synthesize.js");
+class BookmarksSkill {
+    client;
+    store;
+    constructor(client, store) {
+        this.client = client;
+        this.store = store ?? (0, store_js_1.createStoreFromEnv)();
+    }
+    // ==========================================================================
+    // x bookmarks sync
+    // ==========================================================================
+    /**
+     * Sync all bookmark folders and their tweets from X API into local cache.
+     * This is the only command that hits the X API and costs money.
+     *
+     * Strategy (minimizes API calls):
+     *   1. Fetch folder list + tweet IDs per folder (lightweight, IDs only)
+     *   2. Fetch ALL bookmarks with full data from main endpoint (paginated)
+     *   3. Hydrate any missing tweets via GET /2/tweets lookup (100 per call)
+     *   4. Cross-reference IDs to assign tweets to folders in the cache
+     */
+    async syncAll() {
+        const logId = this.store.logSyncStart('all');
+        try {
+            const { tweets, users, folders, folderTweetIds } = await this.client.getBookmarksWithFolders();
+            // Build a tweet lookup map from main bookmarks endpoint
+            const tweetMap = new Map(tweets.map((t) => [t.id, t]));
+            // Collect all folder tweet IDs that are NOT in the main bookmarks response
+            const allFolderIds = new Set();
+            for (const ids of folderTweetIds.values()) {
+                for (const id of ids) {
+                    allFolderIds.add(id);
+                }
+            }
+            const missingIds = [...allFolderIds].filter((id) => !tweetMap.has(id));
+            // Hydrate missing tweets via lookup endpoint
+            if (missingIds.length > 0) {
+                const { tweets: hydrated, users: hydratedUsers } = await this.client.getTweetsByIds(missingIds);
+                for (const tweet of hydrated) {
+                    tweetMap.set(tweet.id, tweet);
+                }
+                for (const [id, user] of hydratedUsers) {
+                    users.set(id, user);
+                }
+            }
+            // Upsert all users
+            for (const user of users.values()) {
+                this.store.upsertUser(user);
+            }
+            // Upsert all tweets
+            for (const tweet of tweetMap.values()) {
+                this.store.upsertTweet(tweet);
+            }
+            // Upsert folders and link tweets
+            const folderResults = [];
+            for (const folder of folders) {
+                const tweetIds = folderTweetIds.get(folder.id) ?? [];
+                this.store.upsertFolder({ ...folder, tweet_count: tweetIds.length });
+                // Link tweets to folder (only those we have data for)
+                let linkedCount = 0;
+                for (let i = 0; i < tweetIds.length; i++) {
+                    if (tweetMap.has(tweetIds[i])) {
+                        this.store.linkTweetToFolder(folder.id, tweetIds[i], i);
+                        linkedCount++;
+                    }
+                }
+                folderResults.push({
+                    name: folder.name,
+                    id: folder.id,
+                    tweetCount: linkedCount,
+                });
+            }
+            const totalTweets = tweetMap.size;
+            this.store.logSyncComplete(logId, totalTweets);
+            return {
+                syncedAt: new Date().toISOString(),
+                totalFolders: folders.length,
+                totalTweets,
+                folders: folderResults,
+            };
+        }
+        catch (error) {
+            this.store.logSyncError(logId, String(error));
+            throw error;
+        }
+    }
+    /**
+     * Sync a single folder by name.
+     * Fetches folder IDs, then hydrates via tweet lookup.
+     */
+    async syncFolder(folderName) {
+        const logId = this.store.logSyncStart('folder');
+        try {
+            const folders = await this.client.getAllBookmarkFolders();
+            const normalizedName = folderName.toLowerCase().trim();
+            const folder = folders.find((f) => f.name.toLowerCase().trim() === normalizedName);
+            if (!folder) {
+                const available = folders.map((f) => f.name).join(', ');
+                throw new Error(`Bookmark folder "${folderName}" not found. Available: ${available}`);
+            }
+            // Get IDs for this folder
+            const tweetIds = await this.client.getBookmarkFolderTweetIds(folder.id);
+            // Hydrate all via tweet lookup (full data, 100 per call)
+            const { tweets, users } = await this.client.getTweetsByIds(tweetIds);
+            const tweetMap = new Map(tweets.map((t) => [t.id, t]));
+            // Upsert users + tweets
+            for (const user of users.values()) {
+                this.store.upsertUser(user);
+            }
+            for (const tweet of tweets) {
+                this.store.upsertTweet(tweet);
+            }
+            // Upsert all folders (keeps list current) + link target folder tweets
+            for (const f of folders) {
+                this.store.upsertFolder(f);
+            }
+            this.store.upsertFolder({ ...folder, tweet_count: tweetIds.length });
+            let linkedCount = 0;
+            for (let i = 0; i < tweetIds.length; i++) {
+                if (tweetMap.has(tweetIds[i])) {
+                    this.store.linkTweetToFolder(folder.id, tweetIds[i], i);
+                    linkedCount++;
+                }
+            }
+            this.store.logSyncComplete(logId, linkedCount);
+            return {
+                syncedAt: new Date().toISOString(),
+                totalFolders: 1,
+                totalTweets: linkedCount,
+                folders: [{ name: folder.name, id: folder.id, tweetCount: linkedCount }],
+            };
+        }
+        catch (error) {
+            this.store.logSyncError(logId, String(error));
+            throw error;
+        }
+    }
+    // ==========================================================================
+    // x bookmarks list (reads from cache)
+    // ==========================================================================
+    /**
+     * List all bookmark folders from local cache.
+     * Run `sync` first if cache is empty.
+     */
+    listFolders() {
+        const folders = this.store.getFolders();
+        return {
+            folders,
+            totalFolders: folders.length,
+        };
+    }
+    // ==========================================================================
+    // x bookmarks fetch (reads from cache)
+    // ==========================================================================
+    /**
+     * Fetch cached bookmarked tweets from a folder by name.
+     */
+    fetchByFolderName(folderName) {
+        const folder = this.store.getFolderByName(folderName);
+        if (!folder) {
+            const available = this.store.getFolders().map((f) => f.name).join(', ');
+            throw new Error(`Folder "${folderName}" not found in cache. Available: ${available || 'none (run sync first)'}`);
+        }
+        return this.fetchByFolderId(folder.id, folder.name);
+    }
+    /**
+     * Fetch cached bookmarked tweets from a folder by ID.
+     */
+    fetchByFolderId(folderId, folderName) {
+        const rows = this.store.getTweetsByFolder(folderId);
+        const bookmarks = rows.map((r) => this.toEnrichedBookmark(r.tweet, r.author));
+        const uniqueAuthors = new Set(bookmarks.map((b) => b.author?.username).filter(Boolean));
+        return {
+            folder: folderName ?? folderId,
+            bookmarks,
+            totalTweets: bookmarks.length,
+            uniqueAuthors: uniqueAuthors.size,
+        };
+    }
+    /**
+     * Fetch ALL cached bookmarks across all folders.
+     */
+    fetchAll() {
+        const rows = this.store.getAllTweets();
+        const bookmarks = rows.map((r) => this.toEnrichedBookmark(r.tweet, r.author));
+        const uniqueAuthors = new Set(bookmarks.map((b) => b.author?.username).filter(Boolean));
+        return {
+            folder: 'All Bookmarks',
+            bookmarks,
+            totalTweets: bookmarks.length,
+            uniqueAuthors: uniqueAuthors.size,
+        };
+    }
+    // ==========================================================================
+    // x bookmarks brief (reads from cache)
+    // ==========================================================================
+    /**
+     * Generate a research brief from cached bookmarks.
+     */
+    async brief(options = {}) {
+        let fetchResult;
+        if (options.folderId) {
+            fetchResult = this.fetchByFolderId(options.folderId, options.folderName);
+        }
+        else if (options.folderName) {
+            fetchResult = this.fetchByFolderName(options.folderName);
+        }
+        else {
+            fetchResult = this.fetchAll();
+        }
+        if (fetchResult.totalTweets === 0) {
+            throw new Error(`No bookmarks found in cache for "${options.folderName ?? 'all'}". Run sync first.`);
+        }
+        const maxTweets = options.maxTweets ?? 50;
+        const sourceTweets = fetchResult.bookmarks.slice(0, maxTweets);
+        const brief = await (0, synthesize_js_1.generateBrief)(sourceTweets, {
+            topic: fetchResult.folder,
+            customPrompt: options.customPrompt,
+            hlnContext: options.hlnContext,
+        });
+        return {
+            brief,
+            sourceBookmarks: sourceTweets,
+        };
+    }
+    // ==========================================================================
+    // x bookmarks stats
+    // ==========================================================================
+    /**
+     * Get cache statistics.
+     */
+    stats() {
+        return this.store.getStats();
+    }
+    // ==========================================================================
+    // Helpers
+    // ==========================================================================
+    toEnrichedBookmark(tweet, author) {
+        const metrics = tweet.public_metrics;
+        const handle = author ? `@${author.username}` : 'unknown';
+        const stats = metrics
+            ? ` (${metrics.like_count} likes, ${metrics.retweet_count} RTs)`
+            : '';
+        const text = tweet.note_tweet?.text ?? tweet.text;
+        const formatted = `${handle}: ${text}${stats}`;
+        return { tweet, author, formatted };
+    }
+    /**
+     * Close the underlying database connection.
+     */
+    close() {
+        this.store.close();
+    }
+}
+exports.BookmarksSkill = BookmarksSkill;
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a BookmarksSkill from environment variables.
+ * Reads X_BEARER_TOKEN, X_USER_ID, and optionally X_CACHE_DB_PATH from .env.
+ */
+function createBookmarksSkillFromEnv() {
+    const client = (0, x_client_js_1.createXClientFromEnv)();
+    const store = (0, store_js_1.createStoreFromEnv)();
+    return new BookmarksSkill(client, store);
+}
+//# sourceMappingURL=index.js.map

package/dist/skills/bookmarks/index.js.map

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

package/dist/skills/bookmarks/synthesize.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Brief synthesis — pipes bookmark posts through Claude and outputs
+ * structured markdown covering themes, notable voices, signal vs. noise,
+ * and HLN-specific relevance.
+ *
+ * This module is designed to be called by Claude Code itself. The output
+ * is a structured ResearchBrief object that can be piped downstream to:
+ *   - Jira tickets (via atlassian-skill)
+ *   - ARIA context / planning prompts
+ *   - Scroll training data corpus
+ *   - Applied AI Studio client research
+ */
+import type { EnrichedBookmark, ResearchBrief } from './types.js';
+interface SynthesizeOptions {
+    topic: string;
+    customPrompt?: string;
+    hlnContext?: string[];
+}
+/**
+ * Build the synthesis prompt from enriched bookmarks.
+ * Returns the full prompt string — caller is responsible for sending to Claude.
+ *
+ * Design decision: this skill does NOT call the Claude API directly.
+ * Instead, it builds a prompt + structured input that Claude Code can execute.
+ * This keeps the skill stateless and avoids requiring a separate API key.
+ */
+export declare function buildBriefPrompt(bookmarks: EnrichedBookmark[], options: SynthesizeOptions): string;
+/**
+ * Generate a research brief from enriched bookmarks.
+ *
+ * This function builds the prompt and parses the response into a structured
+ * ResearchBrief object. The actual Claude call happens inline — when this
+ * skill is invoked from Claude Code, the model is already available.
+ *
+ * For programmatic use outside Claude Code, the caller should use
+ * buildBriefPrompt() and send it to the Claude API themselves.
+ */
+export declare function generateBrief(bookmarks: EnrichedBookmark[], options: SynthesizeOptions): Promise<ResearchBrief>;
+export {};
+//# sourceMappingURL=synthesize.d.ts.map

package/dist/skills/bookmarks/synthesize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../../src/skills/bookmarks/synthesize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAElE,UAAU,iBAAiB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,gBAAgB,EAAE,EAC7B,OAAO,EAAE,iBAAiB,GACzB,MAAM,CA0ER;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,gBAAgB,EAAE,EAC7B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CAgBxB"}

package/dist/skills/bookmarks/synthesize.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Brief synthesis — pipes bookmark posts through Claude and outputs
+ * structured markdown covering themes, notable voices, signal vs. noise,
+ * and HLN-specific relevance.
+ *
+ * This module is designed to be called by Claude Code itself. The output
+ * is a structured ResearchBrief object that can be piped downstream to:
+ *   - Jira tickets (via atlassian-skill)
+ *   - ARIA context / planning prompts
+ *   - Scroll training data corpus
+ *   - Applied AI Studio client research
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBriefPrompt = buildBriefPrompt;
+exports.generateBrief = generateBrief;
+/**
+ * Build the synthesis prompt from enriched bookmarks.
+ * Returns the full prompt string — caller is responsible for sending to Claude.
+ *
+ * Design decision: this skill does NOT call the Claude API directly.
+ * Instead, it builds a prompt + structured input that Claude Code can execute.
+ * This keeps the skill stateless and avoids requiring a separate API key.
+ */
+function buildBriefPrompt(bookmarks, options) {
+    const { topic, customPrompt, hlnContext } = options;
+    const postsBlock = bookmarks
+        .map((b, i) => {
+        const handle = b.author ? `@${b.author.username}` : 'unknown';
+        const name = b.author?.name ?? 'Unknown';
+        const text = b.tweet.note_tweet?.text ?? b.tweet.text;
+        const date = b.tweet.created_at ?? 'unknown date';
+        const metrics = b.tweet.public_metrics;
+        const stats = metrics
+            ? `Likes: ${metrics.like_count} | RTs: ${metrics.retweet_count} | Quotes: ${metrics.quote_count}`
+            : 'no metrics';
+        const urls = b.tweet.entities?.urls
+            ?.map((u) => u.expanded_url)
+            .join(', ') ?? '';
+        return [
+            `--- Post ${i + 1} ---`,
+            `Author: ${name} (${handle})`,
+            `Date: ${date}`,
+            `Engagement: ${stats}`,
+            urls ? `Links: ${urls}` : '',
+            `Text: ${text}`,
+        ]
+            .filter(Boolean)
+            .join('\n');
+    })
+        .join('\n\n');
+    const hlnSection = hlnContext?.length
+        ? `\n## HLN Context\nRelate findings to these HLN ventures/initiatives: ${hlnContext.join(', ')}`
+        : '';
+    const customSection = customPrompt
+        ? `\n## Additional Instructions\n${customPrompt}`
+        : '';
+    return `You are a research analyst for Hidden Leaf Networks (HLN). Analyze the following ${bookmarks.length} bookmarked X posts from the "${topic}" folder and produce a structured research brief.
+
+## Output Format
+
+Produce a markdown document with these sections:
+
+### Key Themes
+- Identify 3-7 major themes or trends across the posts
+- For each theme, cite 1-2 specific posts as evidence
+
+### Notable Voices
+- List the most influential or insightful accounts in this set
+- Note their area of expertise and why they're worth following
+
+### Signal vs. Noise
+- **High signal:** Posts with genuine insight, data, or novel perspective
+- **Low signal:** Posts that are hype, repetitive, or lack substance
+- Assign a signal quality score (1-10) for the overall folder
+
+### Actionable Intelligence
+- What should HLN act on based on these posts?
+- Any emerging opportunities, risks, or inflection points?
+
+### HLN Relevance
+- Which HLN ventures or initiatives does this research impact?
+- Specific recommendations for how to use this intelligence
+${hlnSection}
+${customSection}
+
+## Bookmarked Posts
+
+${postsBlock}
+
+---
+Produce the brief now. Be concise but thorough. Prioritize actionable intelligence over summary.`;
+}
+/**
+ * Generate a research brief from enriched bookmarks.
+ *
+ * This function builds the prompt and parses the response into a structured
+ * ResearchBrief object. The actual Claude call happens inline — when this
+ * skill is invoked from Claude Code, the model is already available.
+ *
+ * For programmatic use outside Claude Code, the caller should use
+ * buildBriefPrompt() and send it to the Claude API themselves.
+ */
+async function generateBrief(bookmarks, options) {
+    const prompt = buildBriefPrompt(bookmarks, options);
+    // Extract structured metadata from bookmarks for the brief envelope
+    const notableVoices = extractNotableVoices(bookmarks);
+    const themes = extractThemes(bookmarks);
+    return {
+        topic: options.topic,
+        generatedAt: new Date().toISOString(),
+        tweetCount: bookmarks.length,
+        content: prompt, // The prompt itself — Claude Code will synthesize when invoked
+        notableVoices,
+        themes,
+        hlnRelevance: options.hlnContext ?? [],
+    };
+}
+/**
+ * Extract notable voices — accounts with highest engagement across bookmarks.
+ */
+function extractNotableVoices(bookmarks) {
+    const authorEngagement = new Map();
+    for (const b of bookmarks) {
+        if (!b.author)
+            continue;
+        const handle = `@${b.author.username}`;
+        const engagement = (b.tweet.public_metrics?.like_count ?? 0) +
+            (b.tweet.public_metrics?.retweet_count ?? 0) * 2 +
+            (b.tweet.public_metrics?.quote_count ?? 0) * 3;
+        authorEngagement.set(handle, (authorEngagement.get(handle) ?? 0) + engagement);
+    }
+    return [...authorEngagement.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 10)
+        .map(([handle]) => handle);
+}
+/**
+ * Extract preliminary themes from context annotations and hashtags.
+ */
+function extractThemes(bookmarks) {
+    const themeCount = new Map();
+    for (const b of bookmarks) {
+        // Context annotations (X's ML-derived topics)
+        if (b.tweet.context_annotations) {
+            for (const ann of b.tweet.context_annotations) {
+                const name = ann.entity.name;
+                themeCount.set(name, (themeCount.get(name) ?? 0) + 1);
+            }
+        }
+        // Hashtags
+        if (b.tweet.entities?.hashtags) {
+            for (const ht of b.tweet.entities.hashtags) {
+                const tag = `#${ht.tag}`;
+                themeCount.set(tag, (themeCount.get(tag) ?? 0) + 1);
+            }
+        }
+    }
+    return [...themeCount.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 15)
+        .map(([theme]) => theme);
+}
+//# sourceMappingURL=synthesize.js.map

package/dist/skills/bookmarks/synthesize.js.map

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