@hidden-leaf/x-skill 1.0.0

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

@@ -0,0 +1,71 @@
+/**
+ * Bookmark intelligence types
+ */
+import type { Tweet, User, BookmarkFolder } from '../../clients/types.js';
+/** A tweet with its author resolved from includes */
+export interface EnrichedBookmark {
+    tweet: Tweet;
+    author: User | undefined;
+    /** Formatted display: "@username: text (likes, retweets)" */
+    formatted: string;
+}
+/** A folder with its tweets fetched and enriched */
+export interface BookmarkFolderContents {
+    folder: BookmarkFolder;
+    bookmarks: EnrichedBookmark[];
+    fetchedAt: string;
+}
+export interface BriefOptions {
+    /** Folder name to scope the brief (if not provided, uses all bookmarks) */
+    folderName?: string;
+    /** Folder ID (resolved from folderName if not provided) */
+    folderId?: string;
+    /** Maximum tweets to include in the brief context (default: 50) */
+    maxTweets?: number;
+    /** Custom prompt to append to the brief generation */
+    customPrompt?: string;
+    /** HLN venture context — which venture(s) this research relates to */
+    hlnContext?: string[];
+}
+export interface ResearchBrief {
+    /** Folder or category this brief covers */
+    topic: string;
+    /** ISO timestamp of generation */
+    generatedAt: string;
+    /** Number of tweets analyzed */
+    tweetCount: number;
+    /** The synthesized markdown brief */
+    content: string;
+    /** Notable accounts referenced */
+    notableVoices: string[];
+    /** Key themes extracted */
+    themes: string[];
+    /** HLN relevance notes (which ventures/initiatives) */
+    hlnRelevance: string[];
+}
+export interface BookmarkListOutput {
+    folders: BookmarkFolder[];
+    totalFolders: number;
+}
+export interface BookmarkFetchOutput {
+    folder: string;
+    bookmarks: EnrichedBookmark[];
+    totalTweets: number;
+    uniqueAuthors: number;
+}
+export interface BookmarkBriefOutput {
+    brief: ResearchBrief;
+    /** Raw enriched bookmarks used as input */
+    sourceBookmarks: EnrichedBookmark[];
+}
+export interface SyncResult {
+    syncedAt: string;
+    totalFolders: number;
+    totalTweets: number;
+    folders: Array<{
+        name: string;
+        id: string;
+        tweetCount: number;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/skills/bookmarks/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAM1E,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,SAAS,CAAC;IACzB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oDAAoD;AACpD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,uDAAuD;IACvD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,aAAa,CAAC;IACrB,2CAA2C;IAC3C,eAAe,EAAE,gBAAgB,EAAE,CAAC;CACrC;AAMD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ"}

package/dist/skills/bookmarks/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Bookmark intelligence types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/skills/bookmarks/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Structured logger for x-skill
+ */
+export declare function createLogger(module: string): {
+    debug: (message: string, data?: Record<string, unknown>) => void;
+    info: (message: string, data?: Record<string, unknown>) => void;
+    warn: (message: string, data?: Record<string, unknown>) => void;
+    error: (message: string, data?: Record<string, unknown>) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwBH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM;qBAEtB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBAGvC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBAGtC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;qBAGrC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAI1D"}

package/dist/utils/logger.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Structured logger for x-skill
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = createLogger;
+const LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+const currentLevel = process.env.LOG_LEVEL || 'info';
+function shouldLog(level) {
+    return LEVELS[level] >= LEVELS[currentLevel];
+}
+function formatMessage(level, module, message, data) {
+    const timestamp = new Date().toISOString();
+    const prefix = `[${timestamp}] [${level.toUpperCase()}] [@hidden-leaf/x-skill:${module}]`;
+    const dataStr = data ? ` ${JSON.stringify(data)}` : '';
+    return `${prefix} ${message}${dataStr}`;
+}
+function createLogger(module) {
+    return {
+        debug: (message, data) => {
+            if (shouldLog('debug'))
+                console.debug(formatMessage('debug', module, message, data));
+        },
+        info: (message, data) => {
+            if (shouldLog('info'))
+                console.info(formatMessage('info', module, message, data));
+        },
+        warn: (message, data) => {
+            if (shouldLog('warn'))
+                console.warn(formatMessage('warn', module, message, data));
+        },
+        error: (message, data) => {
+            if (shouldLog('error'))
+                console.error(formatMessage('error', module, message, data));
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAwBH,oCAeC;AAnCD,MAAM,MAAM,GAA6B;IACvC,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,YAAY,GAAI,OAAO,CAAC,GAAG,CAAC,SAAsB,IAAI,MAAM,CAAC;AAEnE,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,aAAa,CAAC,KAAe,EAAE,MAAc,EAAE,OAAe,EAAE,IAA8B;IACrG,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,2BAA2B,MAAM,GAAG,CAAC;IAC1F,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,OAAO,GAAG,MAAM,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;AAC1C,CAAC;AAED,SAAgB,YAAY,CAAC,MAAc;IACzC,OAAO;QACL,KAAK,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE;YACzD,IAAI,SAAS,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE;YACxD,IAAI,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE;YACxD,IAAI,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACpF,CAAC;QACD,KAAK,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE;YACzD,IAAI,SAAS,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACvF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@hidden-leaf/x-skill",
+  "version": "1.0.0",
+  "description": "X (Twitter) bookmark intelligence skill for Claude Code — turn curated bookmarks into structured research briefs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./SKILL.md": "./SKILL.md"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "SKILL.md",
+    "CLAUDE.snippet.md",
+    ".env.example"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "lint": "eslint 'src/**/*.ts'",
+    "test": "jest --passWithNoTests",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "keywords": [
+    "x",
+    "twitter",
+    "bookmarks",
+    "claude-code",
+    "skill",
+    "research",
+    "intelligence"
+  ],
+  "author": "Hidden Leaf Networks",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Hidden-Leaf-Networks/x-skill.git"
+  },
+  "homepage": "https://github.com/Hidden-Leaf-Networks/x-skill#readme",
+  "dependencies": {
+    "@hidden-leaf/atlassian-skill": "^1.2.0",
+    "axios": "^1.6.0",
+    "axios-retry": "^4.0.0",
+    "better-sqlite3": "^12.8.0",
+    "dotenv": "^17.3.1"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^6.13.0",
+    "@typescript-eslint/parser": "^6.13.0",
+    "eslint": "^8.55.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/scripts/cache-report.ts

@@ -0,0 +1,25 @@
+/**
+ * Report what's in the local cache vs what the folder IDs suggest.
+ */
+import { createStoreFromEnv } from '../src/cache/store.js';
+
+const store = createStoreFromEnv();
+const folders = store.getFolders();
+const stats = store.getStats();
+
+console.log(`Cache: ${stats.tweets} tweets, ${stats.users} users, ${stats.folders} folders`);
+console.log(`Last sync: ${stats.lastSync}\n`);
+
+let totalLinked = 0;
+for (const folder of folders) {
+  const tweets = store.getTweetsByFolder(folder.id);
+  const linked = tweets.length;
+  totalLinked += linked;
+  const hasTweet = tweets.filter(t => t.tweet.text && t.tweet.text.length > 0).length;
+  console.log(`  ${folder.name.padEnd(25)} ${String(folder.tweet_count ?? '?').padStart(3)} folder IDs | ${String(linked).padStart(3)} linked w/ data | ${String(hasTweet).padStart(3)} have text`);
+}
+
+console.log(`\nTotal linked tweet-folder pairs: ${totalLinked}`);
+console.log(`Unique tweets in DB: ${stats.tweets}`);
+
+store.close();

package/scripts/create-atlsk-ticket.ts

@@ -0,0 +1,68 @@
+/**
+ * Create ATLSK ticket for dotenv auto-loading bug.
+ */
+import * as dotenv from 'dotenv';
+dotenv.config();
+import { createJiraClientFromEnv, adf, text } from '@hidden-leaf/atlassian-skill';
+
+async function main() {
+  const jira = createJiraClientFromEnv();
+
+  const issue = await jira.createIssue({
+    project: 'ATLSK',
+    issuetype: 'Bug',
+    summary: 'Auto-load .env from consuming project on import',
+    description: adf()
+      .heading(3, 'Problem')
+      .paragraph(
+        text().text(
+          'When atlassian-skill is installed as a dependency in another project (e.g. x-skill), ' +
+          'scripts that import from @hidden-leaf/atlassian-skill fail with "ATLASSIAN_CLOUD_ID and ' +
+          'ATLASSIAN_SITE_URL are required" unless the consuming script manually calls dotenv.config() ' +
+          'BEFORE the atlassian-skill import.'
+        )
+      )
+      .heading(3, 'Current behavior')
+      .paragraph(
+        text().text(
+          'The factory functions (createJiraClientFromEnv, etc.) read process.env at call time, ' +
+          'but the consuming project\'s .env is not loaded automatically. The atlassian-skill ' +
+          'package calls dotenv.config() in its own modules, but that only finds .env relative ' +
+          'to node_modules/@hidden-leaf/atlassian-skill/, not the consuming project root.'
+        )
+      )
+      .heading(3, 'Expected behavior')
+      .paragraph(
+        text().text(
+          'Importing from @hidden-leaf/atlassian-skill should auto-resolve and load the .env ' +
+          'from the consuming project\'s root directory (walking up from node_modules). The ' +
+          'postinstall script already knows how to find the project root — the same logic should ' +
+          'be used at runtime to locate and load .env.'
+        )
+      )
+      .heading(3, 'Suggested fix')
+      .paragraph(
+        text().text(
+          'In src/index.ts or a new src/env.ts init module, detect if running inside node_modules ' +
+          'and walk up to find the consuming project\'s .env. Call dotenv.config({ path: resolved }) ' +
+          'before any factory functions read env vars. This is what x-skill had to work around by ' +
+          'adding `import dotenv; dotenv.config()` before every atlassian-skill import.'
+        )
+      )
+      .heading(3, 'Reproduction')
+      .codeBlock(
+        'typescript',
+        '// This FAILS:\nimport { createJiraClientFromEnv } from \'@hidden-leaf/atlassian-skill\';\nconst jira = createJiraClientFromEnv();\n// Error: ATLASSIAN_CLOUD_ID and ATLASSIAN_SITE_URL are required\n\n// This WORKS (but shouldn\'t be necessary):\nimport * as dotenv from \'dotenv\';\ndotenv.config();\nimport { createJiraClientFromEnv } from \'@hidden-leaf/atlassian-skill\';\nconst jira = createJiraClientFromEnv();'
+      )
+      .build(),
+    labels: ['bug', 'dx', 'dotenv'],
+  });
+
+  console.log(`Created: ${issue.key} — ${issue.self}`);
+}
+
+main().catch((err) => {
+  console.error('Failed:', err.message);
+  if (err.response?.data) console.error(JSON.stringify(err.response.data, null, 2));
+  process.exit(1);
+});

package/scripts/create-deep-dive-ticket.ts

@@ -0,0 +1,66 @@
+import * as dotenv from 'dotenv';
+dotenv.config();
+import { createJiraClientFromEnv, adf, text } from '@hidden-leaf/atlassian-skill';
+
+async function main() {
+  const jira = createJiraClientFromEnv();
+
+  const issue = await jira.createIssue({
+    project: 'XSKILL',
+    issuetype: 'Story',
+    summary: 'Deep dive: generate research briefs for all 20 bookmark categories',
+    description: adf()
+      .heading(3, 'Goal')
+      .paragraph(text().text(
+        'Systematically generate research briefs for each of the 20 cached bookmark folders. ' +
+        'Each brief feeds into a specific HLN initiative. This is the first real intelligence extraction pass.'
+      ))
+      .heading(3, 'Folder → HLN Initiative Mapping')
+      .paragraph(text().text(
+        'Priority folders (direct HLN IP relevance):\n' +
+        '• CHIPS → HLOS, Scroll (hardware substrate for HLN OS + training infra)\n' +
+        '• Robotics → HLOS, Asimov (humanoid robotics, embodied AI)\n' +
+        '• LLMs → Scroll, ARIA, Konoha Engine (fine-tuning, orchestration)\n' +
+        '• Claude → ARIA v4, Applied AI Studio (Claude ecosystem, skill patterns)\n' +
+        '• Agentic Skills → x-skill, atlassian-skill (competitive landscape, format validation)\n' +
+        '• AI HARDWARE → HLOS, Scroll (compute, edge inference, custom silicon)\n' +
+        '• AI MEDICINE → Orvex, Applied AI Studio (client vertical)\n' +
+        '• AI MONEY → HLN strategy, Orvex (AI monetization, market signals)\n' +
+        '• Cybersecurity → EmLink, HLOS (security posture for HLN products)\n' +
+        '• Quantum Computing → long-horizon R&D signal\n' +
+        '• AI TTS → ARIA v4 voice reintegration\n' +
+        '• AI GAME DEV → MoPlay (game AI, procedural generation)\n' +
+        '• 3D AI GEN → MoPlay, Applied AI Studio (3D asset generation)\n' +
+        '• AI Live Action → Applied AI Studio (video/VFX AI)\n' +
+        '• Web design → HLNW, EmLink (frontend patterns)\n' +
+        '• App Design → EmLink, MoPlay (UX patterns)\n' +
+        '• Automotive → HLOS (vehicle OS, autonomy)\n' +
+        '• Textiles → iSWAG Resale (AI in fashion/textiles)\n' +
+        '• Generators and Motors → HLOS, SUCO (electromechanical, utility)\n' +
+        '• Home Design → SUCO (smart home, utility AI)'
+      ))
+      .heading(3, 'Process')
+      .paragraph(text().text(
+        '1. Run brief() for each folder with appropriate hlnContext\n' +
+        '2. Review each brief for actionable intelligence\n' +
+        '3. Create follow-up Jira tickets in relevant projects (HLN, HLOS, SCROLL, etc.) for any actions identified\n' +
+        '4. Flag cross-folder convergence points (e.g., CHIPS + Robotics + AI HARDWARE overlap)\n' +
+        '5. Archive briefs to Confluence as living research documents'
+      ))
+      .heading(3, 'Priority Order')
+      .paragraph(text().text(
+        'Start with the goldmine folders: CHIPS, Robotics, AI HARDWARE, LLMs, Claude. ' +
+        'These directly feed HLOS and Scroll — the two ventures waiting on capital/GPU that need the strongest research foundation when they activate.'
+      ))
+      .build(),
+    labels: ['intelligence', 'research', 'deep-dive', 'v1'],
+  });
+
+  console.log(`Created: ${issue.key} — ${issue.summary}`);
+}
+
+main().catch((err) => {
+  console.error('Failed:', err.message);
+  if (err.response?.data) console.error(JSON.stringify(err.response.data, null, 2));
+  process.exit(1);
+});

package/scripts/create-jira-project.ts

@@ -0,0 +1,31 @@
+/**
+ * Create the XSKILL Jira project for tracking x-skill development.
+ */
+import * as dotenv from 'dotenv';
+dotenv.config();
+import { createJiraClientFromEnv } from '@hidden-leaf/atlassian-skill';
+
+async function main() {
+  const jira = createJiraClientFromEnv();
+
+  // Get lead account ID
+  const me = await jira.getCurrentUser();
+
+  // Create the project
+  const project = await jira.createProject({
+    key: 'XSKILL',
+    name: 'X Skill',
+    projectTypeKey: 'software',
+    projectTemplateKey: 'com.pyxis.greenhopper.jira:gh-simplified-scrum-classic',
+    description: '@hidden-leaf/x-skill — X bookmark intelligence skill for Claude Code. Turns curated X bookmarks into structured research briefs for the HLN stack.',
+    leadAccountId: me.accountId,
+  });
+
+  console.log('Created Jira project:', JSON.stringify(project, null, 2));
+}
+
+main().catch((err) => {
+  console.error('Failed:', err.message);
+  if (err.response?.data) console.error(JSON.stringify(err.response.data, null, 2));
+  process.exit(1);
+});

package/scripts/create-launch-and-roadmap.ts

@@ -0,0 +1,200 @@
+/**
+ * Create XSKILL launch plan + v2/v3 roadmap tickets.
+ */
+import * as dotenv from 'dotenv';
+dotenv.config();
+import { createJiraClientFromEnv, adf, text } from '@hidden-leaf/atlassian-skill';
+
+interface TicketDef {
+  summary: string;
+  type: string;
+  description: string;
+  labels: string[];
+}
+
+const tickets: TicketDef[] = [
+  // ========== LAUNCH PLAN ==========
+  {
+    summary: 'Write launch thread for @hlntre X announcement',
+    type: 'Task',
+    description:
+      'Write a launch thread for @hlntre announcing x-skill publicly. ' +
+      'Hook: quote-reply the original @lexi_labs thread ("X content is consumable, it sinks once posted") ' +
+      'with "I said I\'d build the open-source tooling. Here it is." ' +
+      'Thread structure:\n' +
+      '1. Quote-reply @lexi_labs with the hook\n' +
+      '2. What x-skill does (bookmark folders → structured research briefs via Claude)\n' +
+      '3. Demo GIF or screenshot showing sync + brief output\n' +
+      '4. Install command: npm install @hidden-leaf/x-skill\n' +
+      '5. Link to GitHub repo\n' +
+      '6. Tag @AnthropicAI @claudecode — this is a Claude Code skill\n' +
+      '7. Call to action: "What folders would you build briefs from?"\n\n' +
+      'Precedent: baoyu-youtube-transcript skill went viral with 1.9K likes, 521 RTs from a similar format post.',
+    labels: ['launch', 'marketing', 'v1'],
+  },
+  {
+    summary: 'Create demo GIF/video: sync → cache → brief pipeline',
+    type: 'Task',
+    description:
+      'Record a terminal demo showing the full x-skill pipeline:\n' +
+      '1. npx tsx sync.ts — folders populate with tweet counts\n' +
+      '2. npx tsx fetch.ts --folder "Robotics" — shows enriched posts\n' +
+      '3. npx tsx brief.ts --folder "Robotics" — Claude generates research brief\n' +
+      'Keep it under 30 seconds. Use asciinema or screen recording. ' +
+      'This is the centerpiece of the launch thread and README.',
+    labels: ['launch', 'marketing', 'v1'],
+  },
+  {
+    summary: 'Submit x-skill to Claude Code community skill directories',
+    type: 'Task',
+    description:
+      'After public launch, submit x-skill to:\n' +
+      '- Anthropic\'s Claude Code skill/extension listings (if any official directory exists)\n' +
+      '- The "Agentic Skills" community on X (where baoyu-youtube-transcript was featured)\n' +
+      '- awesome-claude-code or similar GitHub lists\n' +
+      '- npm package discovery (keywords already set)\n' +
+      'The baoyu skill got featured on X\'s "Agentic Skills" trending page — aim for the same.',
+    labels: ['launch', 'marketing', 'v1'],
+  },
+  {
+    summary: 'Cross-post launch to LinkedIn and dev communities',
+    type: 'Task',
+    description:
+      'Adapt the X launch thread for:\n' +
+      '- LinkedIn post (Tre\'s profile + HLN company page)\n' +
+      '- Reddit: r/ClaudeAI, r/artificial\n' +
+      '- Dev.to or Hashnode blog post: "I turned my X bookmarks into a research pipeline"\n' +
+      'Position as: open-source, bootstrapped, built in a day with Claude Code.',
+    labels: ['launch', 'marketing', 'v1'],
+  },
+  {
+    summary: 'Add Applied AI Studio branding to x-skill as showcase project',
+    type: 'Task',
+    description:
+      'x-skill is a showcase for what Applied AI Studio (post-MDAI) can build. ' +
+      'Add "Built by Applied AI Studio" to README footer. ' +
+      'Reference in studio portfolio/case studies. ' +
+      'This demonstrates the studio\'s capability: shipped an open-source npm package from concept to cache-backed intelligence pipeline in one session.',
+    labels: ['launch', 'branding', 'v1'],
+  },
+
+  // ========== v2: SEARCH, THREADS, PROFILE ==========
+  {
+    summary: '[v2] Search skill — query X for topics and keywords',
+    type: 'Story',
+    description:
+      'New sub-skill: src/skills/search/\n' +
+      'Commands:\n' +
+      '  x search query "humanoid robotics" --limit 50\n' +
+      '  x search recent "Claude Code" --since 7d\n\n' +
+      'Uses GET /2/tweets/search/recent (pay-per-use).\n' +
+      'Cache results in SQLite like bookmarks.\n' +
+      'Enables research beyond what the user has bookmarked — discover new signals.\n' +
+      'Brief command should work on search results too, not just bookmarks.',
+    labels: ['v2', 'search', 'planned'],
+  },
+  {
+    summary: '[v2] Threads skill — fetch and parse full thread context',
+    type: 'Story',
+    description:
+      'New sub-skill: src/skills/threads/\n' +
+      'Commands:\n' +
+      '  x threads fetch <tweet_url_or_id>\n' +
+      '  x threads brief <tweet_url_or_id>\n\n' +
+      'Uses conversation_id to reconstruct full threads.\n' +
+      'Many bookmarked posts are part of longer threads — the single tweet loses context.\n' +
+      'Thread-aware briefs will produce much higher quality intelligence.\n' +
+      'Store thread relationships in cache (parent/child tweet links).',
+    labels: ['v2', 'threads', 'planned'],
+  },
+  {
+    summary: '[v2] Profile skill — account and list management',
+    type: 'Story',
+    description:
+      'New sub-skill: src/skills/profile/\n' +
+      'Commands:\n' +
+      '  x profile info @username\n' +
+      '  x profile followers --notable\n' +
+      '  x lists show\n' +
+      '  x lists members "AI Researchers"\n\n' +
+      'Enables: "Who are the top voices in my Robotics bookmarks?" → profile lookup → follow recommendations.\n' +
+      'List management ties into curation workflow.',
+    labels: ['v2', 'profile', 'planned'],
+  },
+  {
+    summary: '[v2] Cross-folder intelligence and trend analysis',
+    type: 'Story',
+    description:
+      'New command:\n' +
+      '  x bookmarks trends\n' +
+      '  x bookmarks compare --folders "Robotics,AI HARDWARE,CHIPS"\n\n' +
+      'Analyze signals across multiple folders. Detect convergence points ' +
+      '(e.g., "CHIPS + Robotics overlap on NVIDIA robotics chips").\n' +
+      'Time-series analysis: what topics are accelerating in your bookmarks?\n' +
+      'This is where the cached data really pays off — cross-folder queries at zero API cost.',
+    labels: ['v2', 'intelligence', 'planned'],
+  },
+
+  // ========== v3: PUBLISH ==========
+  {
+    summary: '[v3] Publish skill — post, schedule, and reply from CLI',
+    type: 'Story',
+    description:
+      'New sub-skill: src/skills/publish/\n' +
+      'Commands:\n' +
+      '  x publish post "text here"\n' +
+      '  x publish thread ["post 1", "post 2", "post 3"]\n' +
+      '  x publish schedule "text" --at "2026-04-01 09:00"\n' +
+      '  x publish reply <tweet_id> "response"\n\n' +
+      'Requires OAuth 2.0 write scopes (tweet.write).\n' +
+      'Enables full content lifecycle: research (bookmarks) → synthesize (brief) → publish (post).\n' +
+      'Schedule feature needs a local cron or persistent process.\n' +
+      'IMPORTANT: This changes the skill from read-only to read-write. Requires careful scope management and user confirmation before posting.',
+    labels: ['v3', 'publish', 'planned'],
+  },
+  {
+    summary: '[v3] Brief-to-thread pipeline — auto-generate X threads from research',
+    type: 'Story',
+    description:
+      'Combine brief + publish:\n' +
+      '  x bookmarks brief --folder "Robotics" --output thread\n\n' +
+      'Takes a research brief and formats it as a publishable X thread.\n' +
+      'Claude rewrites the brief into thread-optimized format (hook, insights, CTA).\n' +
+      'User reviews before posting (never auto-post without confirmation).\n' +
+      'This closes the loop: consume X → synthesize → publish back to X.\n' +
+      'Directly addresses the @lexi_labs insight — turn consumable content into durable assets.',
+    labels: ['v3', 'publish', 'brief', 'planned'],
+  },
+];
+
+async function main() {
+  const jira = createJiraClientFromEnv();
+
+  console.log(`Creating ${tickets.length} tickets...\n`);
+
+  for (const ticket of tickets) {
+    const issue = await jira.createIssue({
+      project: 'XSKILL',
+      issuetype: ticket.type,
+      summary: ticket.summary,
+      description: adf()
+        .paragraph(text().text(ticket.description))
+        .build(),
+      labels: ticket.labels,
+    });
+
+    const phase = ticket.labels.includes('launch') ? 'LAUNCH'
+      : ticket.labels.includes('v2') ? 'v2'
+      : ticket.labels.includes('v3') ? 'v3'
+      : '???';
+    console.log(`  ${issue.key} [${phase}] ${ticket.summary}`);
+  }
+
+  console.log('\nDone!');
+}
+
+main().catch((err) => {
+  console.error('Failed:', err.message);
+  if (err.response?.data) console.error(JSON.stringify(err.response.data, null, 2));
+  process.exit(1);
+});