@bike4mind/cli 0.2.5-ja-fix-confluence-table-data-5752.17103 → 0.2.7-ja-fix-confluence-table-data-5752.17142

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-6IAPZV52.js}

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

package/dist/{chunk-ZYMOZ2IB.js → chunk-6ATNPERY.js}

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

package/dist/{chunk-QCULHLGT.js → chunk-F2LBB4TN.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
@@ -5510,8 +5541,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 +5556,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 +6174,7 @@ export {
   API_SERVICE_GROUPS,
   settingsMap,
   StringBooleanSchema,
+  CitableSourceSchema,
   PromptMetaZodSchema,
   AiEvents,
   ApiKeyEvents,

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

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

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

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

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

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

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

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