@girardmedia/bootspring 3.3.0 → 3.3.2

package/dist/cli-launcher.js

@@ -1,134 +1,10 @@
-"use strict";
-
-// publish-shell/bootspring.ts
-var path = require("path");
-var fs = require("fs");
-function resolveExistingPath(relativeCandidates) {
-  for (const relativePath of relativeCandidates) {
-    const absolutePath = path.resolve(__dirname, relativePath);
-    if (fs.existsSync(absolutePath)) {
-      return absolutePath;
-    }
-  }
-  return path.resolve(__dirname, relativeCandidates[0]);
-}
-var packageJsonPath = resolveExistingPath(["../package.json"]);
-var VERSION = require(packageJsonPath).version;
-var CLI_DIST = resolveExistingPath(["cli/index.js"]);
-var CORE_DIST = resolveExistingPath(["core.js", "core/index.js"]);
-var C = {
-  reset: "\x1B[0m",
-  bold: "\x1B[1m",
-  dim: "\x1B[2m",
-  cyan: "\x1B[36m",
-  green: "\x1B[32m",
-  yellow: "\x1B[33m",
-  red: "\x1B[31m"
-};
-var PRIMARY_COMMANDS = ["auth", "build", "seed", "init", "go", "mcp", "doctor", "deploy", "agent", "observe", "commands"];
-var HELP_GROUPS = {
-  "Core": ["auth", "build", "seed", "init", "go", "mcp"],
-  "Project": ["project", "workspace", "org", "switch", "checkpoint"],
-  "Dev Tools": ["doctor", "health", "setup", "validate", "watch", "dashboard", "update", "hook"],
-  "Analysis": ["analyze", "audit", "quality", "security", "diff", "report"],
-  "AI & Agents": ["agent", "skill", "context", "prompt", "flow", "brain"],
-  "Observe": ["observe", "autopilot", "monitor", "session", "metrics", "telemetry"],
-  "Docs": ["docs", "generate", "prd", "content", "plan", "suggest"],
-  "Deploy & Ops": ["deploy", "sync", "cloud-sync", "github", "undo", "history", "changes", "log"],
-  "Business": ["business", "marketing", "sales", "geo", "fundraise", "legal", "jobs"],
-  "Tasks": ["todo", "task", "memory", "learn", "issue", "loop"],
-  "Other": [
-    "billing",
-    "onboard",
-    "visualize",
-    "mvp",
-    "plugin",
-    "manager",
-    "harness",
-    "pipeline",
-    "workflow",
-    "orchestrator",
-    "marketplace",
-    "swarm"
-  ]
-};
-function showHelp() {
-  console.log(`${C.cyan}${C.bold}\u26A1 Bootspring${C.reset} ${C.dim}v${VERSION}${C.reset}`);
-  console.log(`${C.dim}AI-assisted development platform${C.reset}
-`);
-  console.log(`${C.bold}Usage:${C.reset} bootspring <command> [options]
-`);
-  console.log(`${C.cyan}${C.bold}COMMANDS${C.reset}`);
-  console.log(`  ${C.green}go${C.reset}            ${C.dim}One command to set up everything${C.reset}`);
-  console.log(`  ${C.green}auth${C.reset}          ${C.dim}Login, logout, status${C.reset}`);
-  console.log(`  ${C.green}init${C.reset}          ${C.dim}Initialize a new project${C.reset}`);
-  console.log(`  ${C.green}seed${C.reset}          ${C.dim}Create and refine context documents${C.reset}`);
-  console.log(`  ${C.green}build${C.reset}         ${C.dim}Build loop \u2014 next, done, status, auto${C.reset}`);
-  console.log(`  ${C.green}deploy${C.reset}        ${C.dim}Validate and deploy${C.reset}`);
-  console.log(`  ${C.green}mcp${C.reset}           ${C.dim}MCP server management${C.reset}`);
-  console.log(`  ${C.green}agent${C.reset}         ${C.dim}AI agent proxy${C.reset}`);
-  console.log(`  ${C.green}observe${C.reset}       ${C.dim}Session intelligence and analytics${C.reset}`);
-  console.log(`  ${C.green}doctor${C.reset}        ${C.dim}Diagnose project issues${C.reset}`);
-  console.log("");
-  const total = Object.values(HELP_GROUPS).flat().length;
-  console.log(`  ${C.green}commands${C.reset}      ${C.dim}Show all ${total} commands${C.reset}`);
-  console.log(`
-${C.dim}Run "bootspring <command> --help" for details${C.reset}`);
-  console.log(`${C.dim}Docs: https://bootspring.com/docs${C.reset}
-`);
-}
-function showFullCommands() {
-  const total = Object.values(HELP_GROUPS).flat().length;
-  const primarySet = new Set(PRIMARY_COMMANDS);
-  console.log(`${C.cyan}${C.bold}\u26A1 Bootspring${C.reset} ${C.dim}v${VERSION} \u2014 ${total} commands (${PRIMARY_COMMANDS.length - 1} primary)${C.reset}
-`);
-  for (const [group, cmds] of Object.entries(HELP_GROUPS)) {
-    const formatted = cmds.map(
-      (command) => primarySet.has(command) ? `${C.green}${C.bold}${command}${C.reset}` : `${C.dim}${command}${C.reset}`
-    ).join(", ");
-    console.log(`${C.bold}${group}:${C.reset}  ${formatted}`);
-  }
-  console.log(`
-${C.dim}Bold = primary commands shown in help${C.reset}`);
-  console.log(`${C.dim}Run "bootspring <command> --help" for command details${C.reset}`);
-  console.log(`${C.dim}Docs: https://bootspring.com/docs${C.reset}
-`);
-}
-function runCli(args) {
-  if (!fs.existsSync(CLI_DIST)) {
-    console.error(`${C.red}Error: CLI build not found at ${CLI_DIST}${C.reset}`);
-    console.error(`${C.dim}Please run 'npm run build' first.${C.reset}`);
-    process.exit(1);
-  }
-  process.env.BOOTSPRING_BRIDGE = "true";
-  process.argv = [process.argv[0], CLI_DIST, ...args];
-  require(CLI_DIST);
-}
-async function main() {
-  const args = process.argv.slice(2);
-  const command = args[0];
-  if (!command || command === "--help" || command === "-h" || command === "help") {
-    showHelp();
-    return;
-  }
-  if (command === "commands") {
-    showFullCommands();
-    return;
-  }
-  if (command === "--version" || command === "-v") {
-    console.log(`Bootspring v${VERSION}`);
-    return;
-  }
-  try {
-    const { selfUpdate } = require(CORE_DIST);
-    selfUpdate.ensureLatestVersion(args);
-  } catch {
-  }
-  runCli(args);
-}
-main().catch((error) => {
-  console.error(`
-${C.red}Error: ${error.message}${C.reset}
-`);
-  process.exit(1);
-});
+"use strict";var a=require("path"),d=require("fs");function i(o){for(let s of o){let t=a.resolve(__dirname,s);if(d.existsSync(t))return t}return a.resolve(__dirname,o[0])}var p=i(["../package.json"]),c=require(p).version,n=i(["cli/index.js"]),u=i(["core.js","core/index.js"]),e={reset:"\x1B[0m",bold:"\x1B[1m",dim:"\x1B[2m",cyan:"\x1B[36m",green:"\x1B[32m",yellow:"\x1B[33m",red:"\x1B[31m"},$=["auth","build","seed","init","go","mcp","doctor","deploy","agent","observe","commands"],l={Core:["auth","build","seed","init","go","mcp"],Project:["project","workspace","org","switch","checkpoint"],"Dev Tools":["doctor","health","setup","validate","watch","dashboard","update","hook"],Analysis:["analyze","audit","quality","security","diff","report","policy"],"AI & Agents":["agent","skill","context","prompt","flow","brain","sprint"],Observe:["observe","autopilot","monitor","session","metrics","telemetry"],Docs:["docs","generate","prd","content","plan","suggest"],"Deploy & Ops":["deploy","sync","cloud-sync","github","undo","history","changes","log"],Business:["business","marketing","sales","geo","fundraise","legal","jobs"],Tasks:["todo","task","memory","learn","issue","loop"],Other:["billing","onboard","visualize","mvp","plugin","manager","harness","pipeline","workflow","orchestrator","marketplace","swarm"]};function h(){console.log(`${e.cyan}${e.bold}\u26A1 Bootspring${e.reset} ${e.dim}v${c}${e.reset}`),console.log(`${e.dim}AI-assisted development platform${e.reset}
+`),console.log(`${e.bold}Usage:${e.reset} bootspring <command> [options]
+`),console.log(`${e.cyan}${e.bold}COMMANDS${e.reset}`),console.log(`  ${e.green}go${e.reset}            ${e.dim}One command to set up everything${e.reset}`),console.log(`  ${e.green}auth${e.reset}          ${e.dim}Login, logout, status${e.reset}`),console.log(`  ${e.green}init${e.reset}          ${e.dim}Initialize a new project${e.reset}`),console.log(`  ${e.green}seed${e.reset}          ${e.dim}Create and refine context documents${e.reset}`),console.log(`  ${e.green}build${e.reset}         ${e.dim}Build loop \u2014 next, done, status, auto${e.reset}`),console.log(`  ${e.green}deploy${e.reset}        ${e.dim}Validate and deploy${e.reset}`),console.log(`  ${e.green}mcp${e.reset}           ${e.dim}MCP server management${e.reset}`),console.log(`  ${e.green}agent${e.reset}         ${e.dim}AI agent proxy${e.reset}`),console.log(`  ${e.green}observe${e.reset}       ${e.dim}Session intelligence and analytics${e.reset}`),console.log(`  ${e.green}doctor${e.reset}        ${e.dim}Diagnose project issues${e.reset}`),console.log("");let o=Object.values(l).flat().length;console.log(`  ${e.green}commands${e.reset}      ${e.dim}Show all ${o} commands${e.reset}`),console.log(`
+${e.dim}Run "bootspring <command> --help" for details${e.reset}`),console.log(`${e.dim}Docs: https://bootspring.com/docs${e.reset}
+`)}function b(){let o=Object.values(l).flat().length,s=new Set($);console.log(`${e.cyan}${e.bold}\u26A1 Bootspring${e.reset} ${e.dim}v${c} \u2014 ${o} commands (${$.length-1} primary)${e.reset}
+`);for(let[t,g]of Object.entries(l)){let m=g.map(r=>s.has(r)?`${e.green}${e.bold}${r}${e.reset}`:`${e.dim}${r}${e.reset}`).join(", ");console.log(`${e.bold}${t}:${e.reset}  ${m}`)}console.log(`
+${e.dim}Bold = primary commands shown in help${e.reset}`),console.log(`${e.dim}Run "bootspring <command> --help" for command details${e.reset}`),console.log(`${e.dim}Docs: https://bootspring.com/docs${e.reset}
+`)}function f(o){d.existsSync(n)||(console.error(`${e.red}Error: CLI build not found at ${n}${e.reset}`),console.error(`${e.dim}Please run 'npm run build' first.${e.reset}`),process.exit(1)),process.env.BOOTSPRING_BRIDGE="true",process.argv=[process.argv[0],n,...o],require(n)}async function y(){let o=process.argv.slice(2),s=o[0];if(!s||s==="--help"||s==="-h"||s==="help"){h();return}if(s==="commands"){b();return}if(s==="--version"||s==="-v"){console.log(`Bootspring v${c}`);return}try{let{selfUpdate:t}=require(u);t.ensureLatestVersion(o)}catch{}f(o)}y().catch(o=>{console.error(`
+${e.red}Error: ${o.message}${e.reset}
+`),process.exit(1)});

package/dist/core/index.d.ts

@@ -457,6 +457,16 @@ declare function sendHealthReport(payload: {
     grade: string;
     data: any;
 }): Promise<void>;
+/**
+ * Track an MCP tool call to the dashboard for usage metering.
+ * Fire-and-forget: returns immediately, network call happens in background.
+ *
+ * Maps tool names to usage types:
+ * - bootspring_agent → agents_invoked
+ * - bootspring_skill → skills_accessed
+ * - bootspring_build/seed/context/quality/orchestrator/todo/sprint → mcp_calls
+ */
+declare function trackToolUsage(toolName: string): void;
 /**
  * Maybe auto-upload accumulated telemetry events.
  * Triggers when >10 events accumulated or last upload was >1hr ago.
@@ -466,8 +476,9 @@ declare function maybeAutoUploadTelemetry(): void;
 declare const presence_maybeAutoUploadTelemetry: typeof maybeAutoUploadTelemetry;
 declare const presence_sendHealthReport: typeof sendHealthReport;
 declare const presence_sendHeartbeat: typeof sendHeartbeat;
+declare const presence_trackToolUsage: typeof trackToolUsage;
 declare namespace presence {
-  export { presence_maybeAutoUploadTelemetry as maybeAutoUploadTelemetry, presence_sendHealthReport as sendHealthReport, presence_sendHeartbeat as sendHeartbeat };
+  export { presence_maybeAutoUploadTelemetry as maybeAutoUploadTelemetry, presence_sendHealthReport as sendHealthReport, presence_sendHeartbeat as sendHeartbeat, presence_trackToolUsage as trackToolUsage };
 }
 
 interface InstallContext {
@@ -477,7 +488,7 @@ interface InstallContext {
     scriptPath: string;
 }
 declare const PACKAGE_NAME = "@girardmedia/bootspring";
-declare const CURRENT_VERSION = "3.2.0";
+declare const CURRENT_VERSION = "3.3.2";
 declare const DEFAULT_INTERVAL_MS: number;
 declare const STATE_PATH: string;
 declare function compareVersions(a: string, b: string): number;
@@ -2410,4 +2421,4 @@ declare namespace telemetry {
   export { telemetry_ASSISTANTS as ASSISTANTS, telemetry_ASSISTANT_FIRST_SUCCESS_EVENT as ASSISTANT_FIRST_SUCCESS_EVENT, telemetry_ASSISTANT_RETURN_EVENT as ASSISTANT_RETURN_EVENT, telemetry_ASSISTANT_SETUP_EVENT as ASSISTANT_SETUP_EVENT, type telemetry_AssistantFunnelEntry as AssistantFunnelEntry, type telemetry_AssistantFunnelSummary as AssistantFunnelSummary, type telemetry_AssistantId as AssistantId, type telemetry_AssistantTrackOptions as AssistantTrackOptions, type telemetry_AssistantUsageTrackResult as AssistantUsageTrackResult, telemetry_BILLING_UPGRADE_STARTED_EVENT as BILLING_UPGRADE_STARTED_EVENT, type telemetry_ClearResult as ClearResult, type telemetry_EmitOptions as EmitOptions, type telemetry_FailedBatch as FailedBatch, type telemetry_ListEventsOptions as ListEventsOptions, telemetry_MAX_EVENTS_LIMIT as MAX_EVENTS_LIMIT, type telemetry_TelemetryRecord as TelemetryRecord, type telemetry_TelemetryStatus as TelemetryStatus, telemetry_UPGRADE_COMPLETED_EVENT as UPGRADE_COMPLETED_EVENT, telemetry_UPGRADE_PROMPT_EVENT as UPGRADE_PROMPT_EVENT, type telemetry_UpgradeFunnelEntry as UpgradeFunnelEntry, type telemetry_UpgradeFunnelSummary as UpgradeFunnelSummary, type telemetry_UploadOptions as UploadOptions, type telemetry_UploadResult as UploadResult, telemetry_clearEvents as clearEvents, telemetry_emitEvent as emitEvent, telemetry_ensureTelemetryDir as ensureTelemetryDir, telemetry_getAssistantActivationFunnel as getAssistantActivationFunnel, telemetry_getStatus as getStatus, telemetry_getTelemetryDir as getTelemetryDir, telemetry_getTelemetryFile as getTelemetryFile, telemetry_getUpgradeConversionFunnel as getUpgradeConversionFunnel, telemetry_inferAssistantFromEnvironment as inferAssistantFromEnvironment, telemetry_listEvents as listEvents, telemetry_track as track, telemetry_trackAssistantSetup as trackAssistantSetup, telemetry_trackAssistantUsageSuccess as trackAssistantUsageSuccess, telemetry_uploadEvents as uploadEvents };
 }
 
-export { API_BASE, API_VERSION, type AssistantTarget, BOOTSPRING_DIR, type BootspringConfig, COMMANDS_SOURCE, CONFIG_FILE, CREDENTIALS_FILE, CURRENT_VERSION, type Credentials, DEFAULT_INTERVAL_MS, DEFAULT_POLICY_PROFILE, DEVICE_FILE, type DeviceContext, type DeviceInfo, type DiagnosticResult, type ExpiryStatus, type HealResult, type Issue, LIMITS, LOCAL_CONFIG_NAME, type LoginResponse, PACKAGE_NAME, PATTERNS, POLICY_PROFILES, type PolicyOptions, type PolicyProfile, type ProjectAuth, type ProjectConfig, type ProjectContext$1 as ProjectContext, SESSION_FILE, SHELL_DANGEROUS_CHARS, STATE_PATH, type SessionData, type SessionOptions, TARGET_DIRS, type UserProfile, type ValidationResult$1 as ValidationResult, type Workflow, addRecentProject, apiClient as api, apiLogin, applyUpdate, auth, callMcpTool, checkForUpdates, checkInstallation, classifyError, clearCredentials, clearDeviceInfo, clearProjectApiKey, clearProjectScopedSession, clearSession, compareVersions, config, context, createLocalConfig, decrypt, encrypt, ensureBootspringDir, ensureLatestVersion, entitlements, findLocalConfig, findNearestProjectConfigPath, generateDeviceFingerprint, getApiKey, getCommandFiles, getConfig, getCredentials, getCredentialsPath, getCurrentProject, getDeviceContext, getDeviceId, getDeviceInfo, getEffectiveProject, getInstallContext, getLatestVersion, getLegacyProjectApiKey, getMcpResource, getPolicyProfile, getProjectScopedSessionState, getProjectScopedToken, getRecentProjects, getRefreshToken, getSession, getSessionState, getStoredApiKey, getTier$1 as getTier, getToken, getTokenExpiryStatus, getUser, healthCheck, installAll, installToTarget, isApiKeyAuth, isAuthenticated, isWorkflowBlocked, listMcpResources, listMcpTools, login, loginWithApiKey, logout, maybeAutoUploadTelemetry, normalizeProfile, policies, pollDeviceToken, presence, readNearestProjectConfig, refreshSession, registerMcpForAssistant, remoteLogout, request, resolvePolicyProfile, runDiagnostics, saveApiKeyToProject, saveConfig, saveCredentials, saveProjectScopedSession, saveSession, selfHeal, selfUpdate, sendHealthReport, sendHeartbeat, session, setAuthFailureHandler, setCurrentProject, setupCommands, startDeviceFlow, stripUnsafeControlChars, telemetry, tierEnforcement, tryHeal, uninstallAll, updateTokens, validateNumericId, validateSlug, validateStringLength, validateTodoText, writeNearestProjectConfig };
+export { API_BASE, API_VERSION, type AssistantTarget, BOOTSPRING_DIR, type BootspringConfig, COMMANDS_SOURCE, CONFIG_FILE, CREDENTIALS_FILE, CURRENT_VERSION, type Credentials, DEFAULT_INTERVAL_MS, DEFAULT_POLICY_PROFILE, DEVICE_FILE, type DeviceContext, type DeviceInfo, type DiagnosticResult, type ExpiryStatus, type HealResult, type Issue, LIMITS, LOCAL_CONFIG_NAME, type LoginResponse, PACKAGE_NAME, PATTERNS, POLICY_PROFILES, type PolicyOptions, type PolicyProfile, type ProjectAuth, type ProjectConfig, type ProjectContext$1 as ProjectContext, SESSION_FILE, SHELL_DANGEROUS_CHARS, STATE_PATH, type SessionData, type SessionOptions, TARGET_DIRS, type UserProfile, type ValidationResult$1 as ValidationResult, type Workflow, addRecentProject, apiClient as api, apiLogin, applyUpdate, auth, callMcpTool, checkForUpdates, checkInstallation, classifyError, clearCredentials, clearDeviceInfo, clearProjectApiKey, clearProjectScopedSession, clearSession, compareVersions, config, context, createLocalConfig, decrypt, encrypt, ensureBootspringDir, ensureLatestVersion, entitlements, findLocalConfig, findNearestProjectConfigPath, generateDeviceFingerprint, getApiKey, getCommandFiles, getConfig, getCredentials, getCredentialsPath, getCurrentProject, getDeviceContext, getDeviceId, getDeviceInfo, getEffectiveProject, getInstallContext, getLatestVersion, getLegacyProjectApiKey, getMcpResource, getPolicyProfile, getProjectScopedSessionState, getProjectScopedToken, getRecentProjects, getRefreshToken, getSession, getSessionState, getStoredApiKey, getTier$1 as getTier, getToken, getTokenExpiryStatus, getUser, healthCheck, installAll, installToTarget, isApiKeyAuth, isAuthenticated, isWorkflowBlocked, listMcpResources, listMcpTools, login, loginWithApiKey, logout, maybeAutoUploadTelemetry, normalizeProfile, policies, pollDeviceToken, presence, readNearestProjectConfig, refreshSession, registerMcpForAssistant, remoteLogout, request, resolvePolicyProfile, runDiagnostics, saveApiKeyToProject, saveConfig, saveCredentials, saveProjectScopedSession, saveSession, selfHeal, selfUpdate, sendHealthReport, sendHeartbeat, session, setAuthFailureHandler, setCurrentProject, setupCommands, startDeviceFlow, stripUnsafeControlChars, telemetry, tierEnforcement, trackToolUsage, tryHeal, uninstallAll, updateTokens, validateNumericId, validateSlug, validateStringLength, validateTodoText, writeNearestProjectConfig };