free-coding-models 0.3.42 → 0.3.44

package/src/telemetry.js

@@ -7,7 +7,8 @@
  *   All telemetry is strictly opt-in-by-default, fire-and-forget, and anonymous:
  *   - A stable `anonymousId` (UUID prefixed with "anon_") is generated once and stored
  *     in ~/.free-coding-models.json.  No personal data is ever collected.
- *   - PostHog is used for product analytics (app_start events, mode, platform).
+ *   - PostHog is used for product analytics (`app_start`, `app_use`, and lightweight
+ *     `app_action` events covering launches and key product actions).
  *   - Discord webhooks carry anonymous feature requests (J key) and bug reports (I key).
  *   - `isTelemetryEnabled()` checks: CLI flag → env var → default (enabled).
  *   - `telemetryDebug()` writes to stderr only when FREE_CODING_MODELS_TELEMETRY_DEBUG=1.
@@ -29,6 +30,7 @@
  *   → getTelemetrySystem()                        — Convert platform to human label
  *   → getTelemetryTerminal()                      — Infer terminal family from env hints
  *   → isTelemetryEnabled(config, cliArgs)         — Resolve effective enabled state
+ *   → buildTelemetryProperties(payload)           — Build sanitized PostHog event properties
  *   → sendUsageTelemetry(config, cliArgs, payload)— Fire-and-forget PostHog ping
  *   → sendFeatureRequest(message)                 — Post anonymous feature request to Discord
  *   → sendBugReport(message)                      — Post anonymous bug report to Discord
@@ -37,7 +39,7 @@
  *   parseTelemetryEnv, isTelemetryDebugEnabled, telemetryDebug,
  *   ensureTelemetryConfig, getTelemetryDistinctId,
  *   getTelemetrySystem, getTelemetryTerminal,
- *   isTelemetryEnabled, sendUsageTelemetry,
+ *   isTelemetryEnabled, buildTelemetryProperties, sendUsageTelemetry,
  *   sendFeatureRequest, sendBugReport
  *
  * @see src/config.js  — saveConfig is imported here to persist the generated anonymousId
@@ -205,11 +207,37 @@ export function isTelemetryEnabled(config, cliArgs) {
   return true
 }
 
+/**
+ * 📖 Build the final analytics properties object while keeping the base schema
+ * 📖 stable and stripping undefined values from optional action-specific fields.
+ * @param {{ version?: string, mode?: string, properties?: Record<string, unknown> } | undefined} payload
+ * @returns {Record<string, unknown>}
+ */
+export function buildTelemetryProperties(payload) {
+  const extraProperties = payload?.properties && typeof payload.properties === 'object' && !Array.isArray(payload.properties)
+    ? payload.properties
+    : {}
+
+  const merged = {
+    ...extraProperties,
+    $process_person_profile: false,
+    source: 'cli',
+    app: 'free-coding-models',
+    version: payload?.version || LOCAL_VERSION,
+    app_version: payload?.version || LOCAL_VERSION,
+    mode: payload?.mode || 'opencode',
+    system: getTelemetrySystem(),
+    terminal: getTelemetryTerminal(),
+  }
+
+  return Object.fromEntries(Object.entries(merged).filter(([, value]) => value !== undefined))
+}
+
 /**
  * 📖 Fire-and-forget analytics ping: never blocks UX, never throws.
  * @param {Record<string, unknown>} config
  * @param {{ noTelemetry?: boolean }} cliArgs
- * @param {{ event?: string, version?: string, mode?: string, ts?: string }} payload
+ * @param {{ event?: string, version?: string, mode?: string, ts?: string, properties?: Record<string, unknown> }} payload
  */
 export async function sendUsageTelemetry(config, cliArgs, payload) {
   if (!isTelemetryEnabled(config, cliArgs)) {
@@ -256,16 +284,7 @@ export async function sendUsageTelemetry(config, cliArgs, payload) {
       event: payload?.event || 'app_start',
       distinct_id: distinctId,
       timestamp,
-      properties: {
-        $process_person_profile: false,
-        source: 'cli',
-        app: 'free-coding-models',
-        version: payload?.version || LOCAL_VERSION,
-        app_version: payload?.version || LOCAL_VERSION,
-        mode: payload?.mode || 'opencode',
-        system: getTelemetrySystem(),
-        terminal: getTelemetryTerminal(),
-      },
+      properties: buildTelemetryProperties(payload),
     }
 
     await fetch(endpoint, {

package/src/tool-bootstrap.js

@@ -280,6 +280,20 @@ export const TOOL_BOOTSTRAP_METADATA = {
       },
     },
   },
+  jcode: {
+    binary: 'jcode',
+    docsUrl: 'https://github.com/1jehuang/jcode',
+    install: {
+      default: {
+        shellCommand: 'curl -fsSL https://raw.githubusercontent.com/1jehuang/jcode/master/scripts/install.sh | bash',
+        summary: 'Install jcode via the official installer script.',
+      },
+      win32: {
+        shellCommand: 'irm https://raw.githubusercontent.com/1jehuang/jcode/master/scripts/install.ps1 | iex',
+        summary: 'Install jcode via the official PowerShell installer.',
+      },
+    },
+  },
 }
 
 export function getToolBootstrapMeta(mode) {

package/src/tool-launchers.js

@@ -272,7 +272,7 @@ function writePiConfig(model, apiKey, baseUrl, paths = getDefaultToolPaths()) {
   const modelsBackupPath = backupIfExists(modelsFilePath)
   const modelsConfig = readJson(modelsFilePath, { providers: {} })
   if (!modelsConfig.providers || typeof modelsConfig.providers !== 'object') modelsConfig.providers = {}
-  modelsConfig.providers.freeCodingModels = {
+  modelsConfig.providers[model.providerKey] = {
     baseUrl,
     api: 'openai-completions',
     apiKey,
@@ -284,7 +284,7 @@ function writePiConfig(model, apiKey, baseUrl, paths = getDefaultToolPaths()) {
   const settingsFilePath = paths.piSettingsPath
   const settingsBackupPath = backupIfExists(settingsFilePath)
   const settingsConfig = readJson(settingsFilePath, {})
-  settingsConfig.defaultProvider = 'freeCodingModels'
+  settingsConfig.defaultProvider = model.providerKey
   settingsConfig.defaultModel = model.modelId
   writeJson(settingsFilePath, settingsConfig)
 
@@ -667,7 +667,7 @@ export function prepareExternalToolLaunch(mode, model, config, options = {}) {
     const result = writePiConfig(model, apiKey, baseUrl, paths)
     return {
       command: 'pi',
-      args: ['--provider', 'freeCodingModels', '--model', model.modelId, '--api-key', apiKey],
+      args: ['--provider', model.providerKey, '--model', model.modelId, '--api-key', apiKey],
       env,
       apiKey,
       baseUrl,
@@ -758,6 +758,19 @@ export function prepareExternalToolLaunch(mode, model, config, options = {}) {
     }
   }
 
+  if (mode === 'jcode') {
+    console.log(chalk.dim(`  📖 jcode will use provider: ${model.providerKey} / model: ${model.modelId}`))
+    return {
+      command: 'jcode',
+      args: ['run', '--provider', model.providerKey, '--model', model.modelId, '--api-key', apiKey],
+      env,
+      apiKey,
+      baseUrl,
+      meta,
+      configArtifacts: [],
+    }
+  }
+
   return {
     blocked: true,
     exitCode: 1,
@@ -854,6 +867,11 @@ export async function startExternalTool(mode, model, config) {
     return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
   }
 
+  if (mode === 'jcode') {
+    console.log(chalk.dim(`  📖 Launching jcode...`))
+    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
+  }
+
   console.log(chalk.red(`  X Unsupported external tool mode: ${mode}`))
   return 1
 }

package/src/tool-metadata.js

@@ -41,6 +41,7 @@ export const TOOL_METADATA = {
   cline:             { label: 'Cline',             emoji: '🧠', flag: '--cline',            color: [100, 220, 180] },
   rovo:              { label: 'Rovo Dev CLI',      emoji: '🦘', flag: '--rovo',             color: [148, 163, 184], cliOnly: true },
   gemini:            { label: 'Gemini CLI',        emoji: '♊', flag: '--gemini',           color: [66, 165, 245],  cliOnly: true },
+  jcode:             { label: 'jcode',              emoji: '🪼', flag: '--jcode',             color: [255, 140, 0]  },
   xcode:             { label: 'Xcode Intelligence',emoji: '🛠️', flag: '--xcode',            color: [20, 126, 251] },
 }
 
@@ -62,16 +63,17 @@ export const COMPAT_COLUMN_SLOTS = [
   { emoji: '🧠', toolKeys: ['cline'],                        color: [100, 220, 180] },
   { emoji: '🦘', toolKeys: ['rovo'],                         color: [148, 163, 184] },
   { emoji: '♊', toolKeys: ['gemini'],                       color: [66, 165, 245] },
+  { emoji: '🪼', toolKeys: ['jcode'],                        color: [255, 140, 0]  },
   { emoji: '🛠️', toolKeys: ['xcode'],                        color: [20, 126, 251] },
 ]
 
 export const TOOL_MODE_ORDER = [
   'opencode',
+  'pi',
   'opencode-desktop',
   'openclaw',
   'crush',
   'goose',
-  'pi',
   'aider',
   'qwen',
   'openhands',
@@ -82,6 +84,7 @@ export const TOOL_MODE_ORDER = [
   'xcode',
   'rovo',
   'gemini',
+  'jcode',
 ]
 
 export function getToolMeta(mode) {

package/src/utils.js

@@ -392,10 +392,10 @@ export function findBestModel(results) {
 //     --openhands, --amp, --pi, --no-telemetry, --json, --help/-h (case-insensitive)
 //   - Value flag: --tier <letter> (the next non-flag arg is the tier value)
 //
-// 📖 Returns:
+// Returns:
 //   { apiKey, bestMode, fiableMode, openCodeMode, openCodeDesktopMode, openClawMode,
 //     aiderMode, crushMode, gooseMode, qwenMode, openHandsMode, ampMode,
-//     piMode, noTelemetry, jsonMode, helpMode, tierFilter }
+//     piMode, jcodeMode, noTelemetry, jsonMode, helpMode, tierFilter }
 //
 // 📖 Note: apiKey may be null here — the main CLI falls back to env vars and saved config.
 export function parseArgs(argv) {
@@ -460,6 +460,7 @@ export function parseArgs(argv) {
   const clineMode = flags.includes('--cline')
   const xcodeMode = flags.includes('--xcode')
   const geminiMode = flags.includes('--gemini')
+  const jcodeMode = flags.includes('--jcode')
   const noTelemetry = flags.includes('--no-telemetry')
   const jsonMode = flags.includes('--json')
   const helpMode = flags.includes('--help') || flags.includes('-h')
@@ -505,6 +506,7 @@ export function parseArgs(argv) {
     xcodeMode,
     rovoMode,
     geminiMode,
+    jcodeMode,
     noTelemetry,
     jsonMode,
     helpMode,