@bike4mind/cli 0.2.5-ja-fix-confluence-table-data-5752.17103 → 0.2.7-basic-cli-shortcuts.17131

package/README.md

@@ -172,13 +172,15 @@ export SERPER_API_KEY="your-key-here"
 
 MCP (Model Context Protocol) servers provide additional tools and capabilities. Configure them in `~/.bike4mind/config.json`:
 
+#### Internal MCP Servers (Node.js)
+
+For MCP servers bundled with the monorepo, you can omit `command` and `args` - the CLI will automatically discover them:
+
 ```json
 {
   "mcpServers": [
     {
       "name": "github",
-      "command": "node",
-      "args": ["path/to/mcp/server.js"],
       "env": {
         "GITHUB_ACCESS_TOKEN": "ghp_..."
       },
@@ -188,12 +190,56 @@ MCP (Model Context Protocol) servers provide additional tools and capabilities.
 }
 ```
 
-**Available MCP Servers:**
+#### External MCP Servers (Docker)
+
+You can run MCP servers in Docker containers for isolation and portability:
+
+```json
+{
+  "mcpServers": [
+    {
+      "name": "github",
+      "command": "docker",
+      "args": ["run", "-i", "--rm", "-e", "GITHUB_TOKEN", "ghcr.io/github/github-mcp-server"],
+      "env": {
+        "GITHUB_TOKEN": "ghp_..."
+      },
+      "enabled": true
+    }
+  ]
+}
+```
+
+**Docker Configuration Notes:**
+- The `-i` flag is required for stdin communication with the MCP server
+- Use `-e VAR_NAME` (without value) to pass environment variables from the host
+- The `--rm` flag ensures containers are cleaned up after use
+- Requires Docker to be installed and running
+
+#### External MCP Servers (npx/Custom Commands)
+
+You can also run any MCP server via npx or custom executables:
+
+```json
+{
+  "mcpServers": [
+    {
+      "name": "filesystem",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"],
+      "env": {},
+      "enabled": true
+    }
+  ]
+}
+```
+
+**Available Built-in MCP Servers:**
 - 🔧 **GitHub** - Repository management, issues, PRs (requires `GITHUB_ACCESS_TOKEN`)
 - 🔧 **LinkedIn** - Post management, analytics (requires `LINKEDIN_ACCESS_TOKEN`, `COMPANY_NAME`)
 - 🔧 **Atlassian** - Jira/Confluence integration (requires `ATLASSIAN_ACCESS_TOKEN`, `ATLASSIAN_CLOUD_ID`, `ATLASSIAN_SITE_URL`)
 
-**Note:** MCP servers must be built and available in the `b4m-core/packages/mcp/dist/src/` directory. The CLI will automatically find them if you're running from the monorepo.
+**Note:** Internal MCP servers must be built and available in the `b4m-core/packages/mcp/dist/src/` directory. The CLI will automatically find them if you're running from the monorepo. For Docker-based servers, ensure Docker is installed and the image is accessible.
 
 ## Session Storage
 

package/dist/ImageStore-RQZ7OF7P.js

@@ -0,0 +1,225 @@
+#!/usr/bin/env node
+import "./chunk-PDX44BCA.js";
+
+// src/storage/ImageStore.ts
+import { createHash } from "crypto";
+import { mkdirSync, writeFileSync, readFileSync, existsSync, unlinkSync } from "fs";
+import { join, extname, resolve } from "path";
+import { homedir } from "os";
+import Database from "better-sqlite3";
+import sharp from "sharp";
+var ImageStore = class _ImageStore {
+  static {
+    this.BASE_DIR = join(homedir(), ".bike4mind", "cli");
+  }
+  static {
+    this.IMAGES_DIR = join(_ImageStore.BASE_DIR, "images");
+  }
+  static {
+    this.DB_PATH = join(_ImageStore.BASE_DIR, "images.db");
+  }
+  static {
+    this.RETENTION_DAYS = 7;
+  }
+  static {
+    // Target max size before base64 encoding. Base64 adds ~33% overhead.
+    // To stay under 1MB after base64, we need images < 750KB
+    this.MAX_RAW_SIZE = 750 * 1024;
+  }
+  static {
+    // 750KB
+    // Maximum size before compression to prevent OOM with very large images
+    this.MAX_PRECOMPRESS_SIZE = 50 * 1024 * 1024;
+  }
+  constructor() {
+    this.ensureDirectories();
+    this.db = new Database(_ImageStore.DB_PATH);
+    this.initDatabase();
+    try {
+      this.cleanupOldImages();
+    } catch (err) {
+      console.warn("Failed to cleanup old images:", err);
+    }
+  }
+  ensureDirectories() {
+    mkdirSync(_ImageStore.BASE_DIR, { recursive: true });
+    mkdirSync(_ImageStore.IMAGES_DIR, { recursive: true });
+  }
+  initDatabase() {
+    this.db.exec(`
+			CREATE TABLE IF NOT EXISTS images (
+				hash TEXT PRIMARY KEY,
+				format TEXT NOT NULL,
+				size INTEGER NOT NULL,
+				timestamp INTEGER NOT NULL,
+				uploaded INTEGER NOT NULL DEFAULT 0,
+				s3_url TEXT,
+				original_filename TEXT
+			)
+		`);
+  }
+  /**
+   * Store an image locally with content-based hashing for deduplication
+   */
+  async store(imageData, originalFilename) {
+    const { buffer: processedData, format: processedFormat } = await this.processImage(imageData, originalFilename);
+    const hash = this.generateHash(processedData);
+    const format = processedFormat;
+    const ext = format.toLowerCase();
+    const localPath = join(_ImageStore.IMAGES_DIR, `${hash}.${ext}`);
+    const existing = this.getMetadata(hash);
+    if (existing) {
+      return {
+        hash,
+        placeholder: "",
+        // Will be set by caller
+        localPath,
+        metadata: existing
+      };
+    }
+    writeFileSync(localPath, processedData);
+    const metadata = {
+      hash,
+      format,
+      size: processedData.length,
+      timestamp: Date.now(),
+      uploaded: false,
+      originalFilename
+    };
+    this.db.prepare(
+      `INSERT INTO images (hash, format, size, timestamp, uploaded, original_filename)
+				 VALUES (?, ?, ?, ?, ?, ?)`
+    ).run(hash, format, metadata.size, metadata.timestamp, 0, originalFilename || null);
+    return {
+      hash,
+      placeholder: "",
+      localPath,
+      metadata
+    };
+  }
+  /**
+   * Get image metadata by hash
+   */
+  getMetadata(hash) {
+    const row = this.db.prepare("SELECT * FROM images WHERE hash = ?").get(hash);
+    if (!row) return null;
+    return {
+      hash: row.hash,
+      format: row.format,
+      size: row.size,
+      timestamp: row.timestamp,
+      uploaded: Boolean(row.uploaded),
+      s3Url: row.s3_url,
+      originalFilename: row.original_filename
+    };
+  }
+  /**
+   * Read image data from local cache
+   */
+  readImage(hash) {
+    const metadata = this.getMetadata(hash);
+    if (!metadata) return null;
+    const localPath = join(_ImageStore.IMAGES_DIR, `${hash}.${metadata.format.toLowerCase()}`);
+    const normalizedPath = resolve(localPath);
+    if (!normalizedPath.startsWith(resolve(_ImageStore.IMAGES_DIR))) {
+      throw new Error("Invalid image path");
+    }
+    if (!existsSync(localPath)) return null;
+    return readFileSync(localPath);
+  }
+  /**
+   * Generate content hash for deduplication
+   */
+  generateHash(data) {
+    return createHash("sha256").update(data).digest("hex").substring(0, 16);
+  }
+  /**
+   * Process image: compress if needed to stay under size limit
+   */
+  async processImage(data, originalFilename) {
+    if (data.length > _ImageStore.MAX_PRECOMPRESS_SIZE) {
+      throw new Error(
+        `Image too large to process (${Math.round(data.length / 1024 / 1024)}MB). Maximum size is ${_ImageStore.MAX_PRECOMPRESS_SIZE / 1024 / 1024}MB.`
+      );
+    }
+    const originalFormat = this.detectFormat(data, originalFilename);
+    if (data.length <= _ImageStore.MAX_RAW_SIZE) {
+      return { buffer: data, format: originalFormat };
+    }
+    let image = sharp(data);
+    const metadata = await image.metadata();
+    if (!metadata.width || !metadata.height) {
+      throw new Error("Unable to read image dimensions");
+    }
+    const maxDimension = 2048;
+    let width = metadata.width;
+    let height = metadata.height;
+    if (width > maxDimension || height > maxDimension) {
+      if (width > height) {
+        height = Math.round(height * maxDimension / width);
+        width = maxDimension;
+      } else {
+        width = Math.round(width * maxDimension / height);
+        height = maxDimension;
+      }
+    }
+    image = image.resize(width, height);
+    let quality = 85;
+    let buffer = await image.jpeg({ quality }).toBuffer();
+    while (buffer.length > _ImageStore.MAX_RAW_SIZE && quality > 30) {
+      quality -= 10;
+      buffer = await image.jpeg({ quality }).toBuffer();
+    }
+    if (buffer.length > _ImageStore.MAX_RAW_SIZE) {
+      throw new Error(`Unable to compress image below ${_ImageStore.MAX_RAW_SIZE / 1024}KB limit`);
+    }
+    return { buffer, format: "jpg" };
+  }
+  /**
+   * Detect image format from buffer or filename
+   */
+  detectFormat(data, filename) {
+    if (data[0] === 137 && data[1] === 80 && data[2] === 78 && data[3] === 71) {
+      return "png";
+    }
+    if (data[0] === 255 && data[1] === 216 && data[2] === 255) {
+      return "jpg";
+    }
+    if (data[0] === 71 && data[1] === 73 && data[2] === 70) {
+      return "gif";
+    }
+    if (data[0] === 82 && data[1] === 73 && data[2] === 70 && data[3] === 70) {
+      return "webp";
+    }
+    if (filename) {
+      const ext = extname(filename).substring(1).toLowerCase();
+      if (["png", "jpg", "jpeg", "gif", "webp"].includes(ext)) {
+        return ext === "jpeg" ? "jpg" : ext;
+      }
+    }
+    return "png";
+  }
+  /**
+   * Clean up images older than retention period
+   */
+  cleanupOldImages() {
+    const cutoffTime = Date.now() - _ImageStore.RETENTION_DAYS * 24 * 60 * 60 * 1e3;
+    const oldImages = this.db.prepare("SELECT hash, format FROM images WHERE timestamp < ?").all(cutoffTime);
+    for (const { hash, format } of oldImages) {
+      const localPath = join(_ImageStore.IMAGES_DIR, `${hash}.${format.toLowerCase()}`);
+      if (existsSync(localPath)) {
+        unlinkSync(localPath);
+      }
+    }
+    this.db.prepare("DELETE FROM images WHERE timestamp < ?").run(cutoffTime);
+  }
+  /**
+   * Close database connection
+   */
+  close() {
+    this.db.close();
+  }
+};
+export {
+  ImageStore
+};

package/dist/{artifactExtractor-ZU5BBMLI.js → artifactExtractor-DNE5C6DY.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CurationArtifactType
-} from "./chunk-QCULHLGT.js";
+} from "./chunk-H6SHASMZ.js";
 import "./chunk-PDX44BCA.js";
 
 // ../../b4m-core/packages/services/dist/src/notebookCurationService/artifactExtractor.js

package/dist/{chunk-3TADOGT5.js → chunk-3CCBDIFR.js}

@@ -6,12 +6,12 @@ import {
   getSettingsByNames,
   obfuscateApiKey,
   secureParameters
-} from "./chunk-WPD676KY.js";
+} from "./chunk-DNSBC3LO.js";
 import {
   ApiKeyType,
   MementoTier,
   isSupportedEmbeddingModel
-} from "./chunk-QCULHLGT.js";
+} from "./chunk-H6SHASMZ.js";
 
 // ../../b4m-core/packages/services/dist/src/apiKeyService/get.js
 import { z } from "zod";

package/dist/{chunk-WPD676KY.js → chunk-DNSBC3LO.js}

@@ -16,7 +16,7 @@ import {
   dayjsConfig_default,
   extractSnippetMeta,
   settingsMap
-} from "./chunk-QCULHLGT.js";
+} from "./chunk-H6SHASMZ.js";
 
 // ../../b4m-core/packages/utils/dist/src/storage/S3Storage.js
 import { S3Client, PutObjectCommand, DeleteObjectCommand, GetObjectCommand, HeadObjectCommand } from "@aws-sdk/client-s3";

package/dist/{chunk-QCULHLGT.js → chunk-H6SHASMZ.js}

@@ -3745,6 +3745,35 @@ var ToolHealthSchema = z21.object({
   lastExecutionTime: z21.number().optional(),
   successRate: z21.number().optional()
 });
+var CitableSourceSchema = z21.object({
+  /** Unique identifier - can be URL, UUID, or composite key */
+  id: z21.string(),
+  /** Source classification for UI rendering */
+  type: z21.enum(["web_url", "document", "dataset", "mcp"]),
+  /** Human-readable title/name */
+  title: z21.string(),
+  /** Navigation target (external URL, deep link, or hash route) */
+  url: z21.string().optional(),
+  /** Brief description or excerpt (1-2 sentences) */
+  description: z21.string().optional(),
+  /** ISO 8601 timestamp for freshness indication */
+  timestamp: z21.string().optional(),
+  /** Attribution for non-report sources */
+  author: z21.string().optional(),
+  /** Processing status for real-time updates */
+  status: z21.enum(["pending", "processing", "complete", "error"]).optional(),
+  /** Extensibility metadata */
+  metadata: z21.object({
+    sourceSystem: z21.string().optional(),
+    icon: z21.string().optional(),
+    tags: z21.array(z21.string()).optional(),
+    confidence: z21.number().optional(),
+    practiceAreas: z21.array(z21.string()).optional(),
+    chunkId: z21.string().optional(),
+    relevanceScore: z21.number().optional(),
+    fullContext: z21.string().optional()
+  }).passthrough().optional()
+});
 var PromptMetaZodSchema = z21.object({
   model: PromptMetaModelSchema.optional(),
   tokenUsage: PromptMetaTokenUsageSchema.optional(),
@@ -3787,7 +3816,9 @@ var PromptMetaZodSchema = z21.object({
     failedSteps: z21.array(z21.string()).optional()
   }).optional(),
   // Phase 2: Tool health tracking
-  toolHealth: z21.array(ToolHealthSchema).optional()
+  toolHealth: z21.array(ToolHealthSchema).optional(),
+  // Citable sources referenced in AI responses (from web_search, deep_research, RAG, MCP)
+  citables: z21.array(CitableSourceSchema).optional()
 });
 
 // ../../b4m-core/packages/common/dist/src/schemas/analytics/events/ai.js
@@ -5010,74 +5041,6 @@ function formatUserList(users) {
 }
 
 // ../../b4m-core/packages/common/dist/src/jira/api.js
-function wikiMarkupToAdf(text) {
-  const lines = text.split("\n");
-  const content = [];
-  let currentTableRows = [];
-  let inTable = false;
-  for (const line of lines) {
-    const trimmedLine = line.trim();
-    if (trimmedLine.startsWith("||") && trimmedLine.endsWith("||")) {
-      inTable = true;
-      const cells = trimmedLine.slice(2, -2).split("||").map((cell) => cell.trim());
-      const headerRow = {
-        type: "tableRow",
-        content: cells.map((cell) => ({
-          type: "tableHeader",
-          attrs: {},
-          content: [{ type: "paragraph", content: [{ type: "text", text: cell || " " }] }]
-        }))
-      };
-      currentTableRows.push(headerRow);
-      continue;
-    }
-    if (trimmedLine.startsWith("|") && trimmedLine.endsWith("|") && !trimmedLine.startsWith("||")) {
-      inTable = true;
-      const cells = trimmedLine.slice(1, -1).split("|").map((cell) => cell.trim());
-      const dataRow = {
-        type: "tableRow",
-        content: cells.map((cell) => ({
-          type: "tableCell",
-          attrs: {},
-          content: [{ type: "paragraph", content: [{ type: "text", text: cell || " " }] }]
-        }))
-      };
-      currentTableRows.push(dataRow);
-      continue;
-    }
-    if (inTable && currentTableRows.length > 0) {
-      const table = {
-        type: "table",
-        attrs: { isNumberColumnEnabled: false, layout: "default" },
-        content: currentTableRows
-      };
-      content.push(table);
-      currentTableRows = [];
-      inTable = false;
-    }
-    if (trimmedLine) {
-      content.push({
-        type: "paragraph",
-        content: [{ type: "text", text: trimmedLine }]
-      });
-    }
-  }
-  if (currentTableRows.length > 0) {
-    const table = {
-      type: "table",
-      attrs: { isNumberColumnEnabled: false, layout: "default" },
-      content: currentTableRows
-    };
-    content.push(table);
-  }
-  if (content.length === 0) {
-    content.push({ type: "paragraph", content: [{ type: "text", text: " " }] });
-  }
-  return { type: "doc", version: 1, content };
-}
-function containsWikiTable(text) {
-  return /^\|\|.+\|\|$/m.test(text) || /^\|(?!\|).+\|$/m.test(text);
-}
 var JiraApi = class {
   config;
   constructor(config) {
@@ -5157,21 +5120,16 @@ var JiraApi = class {
       ...customFields
     };
     if (description) {
-      if (containsWikiTable(description)) {
-        console.log("[JIRA-ADF] Converting wiki table to ADF", { length: description.length });
-        fields.description = wikiMarkupToAdf(description);
-      } else {
-        fields.description = {
-          type: "doc",
-          version: 1,
-          content: [
-            {
-              type: "paragraph",
-              content: [{ type: "text", text: description }]
-            }
-          ]
-        };
-      }
+      fields.description = {
+        type: "doc",
+        version: 1,
+        content: [
+          {
+            type: "paragraph",
+            content: [{ type: "text", text: description }]
+          }
+        ]
+      };
     }
     if (assignee) {
       fields.assignee = { id: assignee };
@@ -5197,21 +5155,16 @@ var JiraApi = class {
       fields.summary = summary;
     }
     if (description) {
-      if (containsWikiTable(description)) {
-        console.log("[JIRA-ADF] Converting wiki table to ADF (update)", { length: description.length });
-        fields.description = wikiMarkupToAdf(description);
-      } else {
-        fields.description = {
-          type: "doc",
-          version: 1,
-          content: [
-            {
-              type: "paragraph",
-              content: [{ type: "text", text: description }]
-            }
-          ]
-        };
-      }
+      fields.description = {
+        type: "doc",
+        version: 1,
+        content: [
+          {
+            type: "paragraph",
+            content: [{ type: "text", text: description }]
+          }
+        ]
+      };
     }
     if (labels) {
       fields.labels = labels;
@@ -5371,21 +5324,16 @@ var JiraApi = class {
         issuetype: { name: issueTypeName }
       };
       if (description) {
-        if (containsWikiTable(description)) {
-          console.log("[JIRA-ADF] Converting wiki table to ADF (bulk)", { length: description.length });
-          fields.description = wikiMarkupToAdf(description);
-        } else {
-          fields.description = {
-            type: "doc",
-            version: 1,
-            content: [
-              {
-                type: "paragraph",
-                content: [{ type: "text", text: description }]
-              }
-            ]
-          };
-        }
+        fields.description = {
+          type: "doc",
+          version: 1,
+          content: [
+            {
+              type: "paragraph",
+              content: [{ type: "text", text: description }]
+            }
+          ]
+        };
       }
       if (assignee) {
         fields.assignee = { id: assignee };
@@ -5510,8 +5458,8 @@ var MCP_PROVIDER_METADATA = {
     defaultToolDescriptions: {
       // Core GitHub tools (must match b4m-core/packages/mcp/src/github/index.ts)
       create_issue: "Create a new issue in a GitHub repository. Requires repository owner, repository name, issue title, and optional body, labels, and assignees.",
-      update_issue: "Update an existing GitHub issue. Can modify title, body, state (open/closed), labels, and assignees. Requires repository owner, repository name, and issue number.",
-      list_issues: "List issues for a GitHub repository with optional filters (state, labels, assignee). Returns issue details including title, body, status, and metadata.",
+      update_issue: "Update an existing GitHub issue. Can modify title, body, state (open/closed), labels, assignees, and issue type (native GitHub issue types like Bug/Feature/Task). Use list_org_issue_types to see available types. Requires repository owner, repository name, and issue number.",
+      list_issues: 'List issues for a GitHub repository with optional filters (state, labels, assignee, type). Can filter by native issue type like "Bug" or "Feature". Returns issue details including title, body, status, and metadata.',
       get_issue: "Get detailed information about a specific GitHub issue by number. Returns full issue details including body, comments count, milestone, and timestamps.",
       search_code: "Search for code across GitHub repositories using GitHub code search syntax. Returns matching code snippets with file paths, line numbers, and repository information.",
       // Repository discovery and management
@@ -5525,6 +5473,7 @@ var MCP_PROVIDER_METADATA = {
       // Commit tools
       list_commits: "List commit history for a GitHub repository with optional filters (branch, file path, author). Returns commit SHA, message, author, date, and statistics.",
       get_commit: "Get detailed information about a specific commit including full message, author, committer, file changes, and diff statistics.",
+      list_org_issue_types: "List available native GitHub issue types for an organization (Bug, Feature, Task, etc.). Use this to discover what issue types can be set on issues in the organization.",
       // Legacy tool names (for backwards compatibility)
       github_list_repositories: "List GitHub repositories accessible to the connected account.",
       github_get_repository: "Fetch detailed information about a specific GitHub repository.",
@@ -6142,6 +6091,7 @@ export {
   API_SERVICE_GROUPS,
   settingsMap,
   StringBooleanSchema,
+  CitableSourceSchema,
   PromptMetaZodSchema,
   AiEvents,
   ApiKeyEvents,
@@ -6199,8 +6149,6 @@ export {
   formatUser,
   formatTransitionResult,
   formatUserList,
-  wikiMarkupToAdf,
-  containsWikiTable,
   JiraApi,
   getErrorMessage,
   getAtlassianConfig,

package/dist/{chunk-ZYMOZ2IB.js → chunk-LIRY24M5.js}

@@ -2,7 +2,7 @@
 import {
   BadRequestError,
   secureParameters
-} from "./chunk-WPD676KY.js";
+} from "./chunk-DNSBC3LO.js";
 import {
   GenericCreditDeductTransaction,
   ImageEditUsageTransaction,
@@ -10,7 +10,7 @@ import {
   RealtimeVoiceUsageTransaction,
   TextGenerationUsageTransaction,
   TransferCreditTransaction
-} from "./chunk-QCULHLGT.js";
+} from "./chunk-H6SHASMZ.js";
 
 // ../../b4m-core/packages/services/dist/src/creditService/subtractCredits.js
 import { z } from "zod";

package/dist/{chunk-GVI2BQAN.js → chunk-YXHQN7SK.js}

@@ -7,11 +7,11 @@ import {
   getSettingsMap,
   getSettingsValue,
   secureParameters
-} from "./chunk-WPD676KY.js";
+} from "./chunk-DNSBC3LO.js";
 import {
   KnowledgeType,
   SupportedFabFileMimeTypes
-} from "./chunk-QCULHLGT.js";
+} from "./chunk-H6SHASMZ.js";
 
 // ../../b4m-core/packages/services/dist/src/fabFileService/create.js
 import { z } from "zod";

package/dist/{create-BLOW4E4S.js → create-PNU64QSF.js}

@@ -2,10 +2,10 @@
 import {
   createFabFile,
   createFabFileSchema
-} from "./chunk-GVI2BQAN.js";
-import "./chunk-WPD676KY.js";
+} from "./chunk-YXHQN7SK.js";
+import "./chunk-DNSBC3LO.js";
 import "./chunk-AMDXHL6S.js";
-import "./chunk-QCULHLGT.js";
+import "./chunk-H6SHASMZ.js";
 import "./chunk-PDX44BCA.js";
 export {
   createFabFile,