trickle-cli 0.1.218 → 0.1.220

package/dist/commands/hints.d.ts

@@ -13,5 +13,6 @@
 export interface HintsOptions {
     values?: boolean;
     errors?: boolean;
+    show?: string;
 }
 export declare function hintsCommand(targetFile: string | undefined, opts: HintsOptions): Promise<void>;

package/dist/commands/hints.js

@@ -277,8 +277,11 @@ async function hintsCommand(targetFile, opts) {
                         const typeStr = typeToString(v.type);
                         const scope = v.funcName ? ` (in ${v.funcName})` : "";
                         const sampleStr = formatSample(v.sample);
-                        // In error mode, always show values (crash-time state)
-                        if ((opts.errors || opts.values) && v.sample !== undefined) {
+                        const nbShowMode = opts.show || (opts.errors ? "both" : (opts.values ? "both" : "types"));
+                        if (nbShowMode === "values" && v.sample !== undefined) {
+                            console.log(`${v.varName} = ${sampleStr}${scope}`);
+                        }
+                        else if (nbShowMode === "both" && v.sample !== undefined) {
                             console.log(`${v.varName}: ${typeStr} = ${sampleStr}${scope}`);
                         }
                         else {
@@ -371,9 +374,14 @@ async function hintsCommand(targetFile, opts) {
                     if (isFuncParam && afterVar.startsWith(":"))
                         continue;
                 }
-                // Build the hint string — error mode always shows values (crash-time state)
+                // Build the hint string based on --show mode
+                const showMode = opts.show || (opts.errors ? "both" : (opts.values ? "both" : "types"));
+                const hasSample = v.sample !== undefined && v.sample !== null;
                 let hint;
-                if ((opts.errors || opts.values) && v.sample !== undefined && v.sample !== null) {
+                if (showMode === "values" && hasSample) {
+                    hint = ` = ${formatSample(v.sample)}`;
+                }
+                else if (showMode === "both" && hasSample) {
                     const sampleStr = formatSample(v.sample);
                     hint = sampleStr ? `: ${typeStr} = ${sampleStr}` : `: ${typeStr}`;
                 }

package/dist/index.js

@@ -83,10 +83,23 @@ const next_1 = require("./commands/next");
 const python_1 = require("./commands/python");
 const hints_1 = require("./commands/hints");
 const program = new commander_1.Command();
+// Only these commands show in --help. All others still work but are hidden.
+const VISIBLE_COMMANDS = new Set(["run", "hints", "vars", "init", "help"]);
 program
     .name("trickle")
-    .description("CLI for trickle runtime type observability")
-    .version("0.1.0");
+    .description("Runtime type annotations for Python — see tensor shapes, variable types, and crash-time values as you code")
+    .version((() => { try {
+    return require("../package.json").version;
+}
+catch {
+    return "0.0.0";
+} })())
+    .configureHelp({
+    visibleCommands: (cmd) => {
+        return cmd.commands.filter(c => VISIBLE_COMMANDS.has(c.name()));
+    },
+})
+    .addHelpText("after", "\nAll other commands are available but hidden from this list. Run `trickle <command> --help` for any command.");
 // trickle init
 program
     .command("init")
@@ -540,6 +553,7 @@ program
     .description("Output source code with inline type hints from runtime observations (for AI agents)")
     .option("--values", "Include sample values alongside types")
     .option("--errors", "Show error mode — variables at crash time with values that caused the error")
+    .option("--show <mode>", "What to show inline: types, values, or both (default: both in error mode, types otherwise)")
     .action(async (file, opts) => {
     await (0, hints_1.hintsCommand)(file, opts);
 });
@@ -1043,23 +1057,5 @@ if (firstArg &&
     // Inject "run" before the file argument
     process.argv.splice(2, 0, "run");
 }
-// Custom help: show curated commands first, then full list
-program.addHelpText('before', `
-  ${chalk_1.default.bold('Quick Start')}
-    trickle init                Set up trickle in your project
-    trickle run <command>       Run with observability (zero code changes)
-    trickle test [command]      Run tests with structured results
-
-  ${chalk_1.default.bold('Analyze')}
-    trickle summary             Full overview: errors, queries, root causes
-    trickle explain <file>      Understand a file: functions, call graph, data flow
-    trickle flamegraph          Performance hotspots visualization
-    trickle doctor              Health check with recommended actions
-
-  ${chalk_1.default.bold('Fix & Verify')}
-    trickle verify --baseline   Save metrics before fixing
-    trickle verify              Compare after fixing
-
-  ${chalk_1.default.bold('All Commands')}
-`);
+// Help text removed — visibleCommands filter handles it
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trickle-cli",
-  "version": "0.1.218",
+  "version": "0.1.220",
   "description": "Zero-code runtime observability for JS/Python + AI agent debugging. Traces LangChain, CrewAI, OpenAI, Anthropic, Gemini. Eval, security, compliance, cost tracking. Free, local-first.",
   "keywords": [
     "observability",

package/src/commands/hints.ts

@@ -17,6 +17,7 @@ import * as path from "path";
 export interface HintsOptions {
   values?: boolean;
   errors?: boolean;
+  show?: string; // "types", "values", "both" (default: "both" in error mode, "types" otherwise)
 }
 
 interface TypeNode {
@@ -268,8 +269,10 @@ export async function hintsCommand(
             const typeStr = typeToString(v.type);
             const scope = v.funcName ? ` (in ${v.funcName})` : "";
             const sampleStr = formatSample(v.sample);
-            // In error mode, always show values (crash-time state)
-            if ((opts.errors || opts.values) && v.sample !== undefined) {
+            const nbShowMode = opts.show || (opts.errors ? "both" : (opts.values ? "both" : "types"));
+            if (nbShowMode === "values" && v.sample !== undefined) {
+              console.log(`${v.varName} = ${sampleStr}${scope}`);
+            } else if (nbShowMode === "both" && v.sample !== undefined) {
               console.log(`${v.varName}: ${typeStr} = ${sampleStr}${scope}`);
             } else {
               console.log(`${v.varName}: ${typeStr}${scope}`);
@@ -363,9 +366,13 @@ export async function hintsCommand(
           if (isFuncParam && afterVar.startsWith(":")) continue;
         }
 
-        // Build the hint string — error mode always shows values (crash-time state)
+        // Build the hint string based on --show mode
+        const showMode = opts.show || (opts.errors ? "both" : (opts.values ? "both" : "types"));
+        const hasSample = v.sample !== undefined && v.sample !== null;
         let hint: string;
-        if ((opts.errors || opts.values) && v.sample !== undefined && v.sample !== null) {
+        if (showMode === "values" && hasSample) {
+          hint = ` = ${formatSample(v.sample)}`;
+        } else if (showMode === "both" && hasSample) {
           const sampleStr = formatSample(v.sample);
           hint = sampleStr ? `: ${typeStr} = ${sampleStr}` : `: ${typeStr}`;
         } else {

package/src/index.ts

@@ -48,10 +48,19 @@ import { hintsCommand } from "./commands/hints";
 
 const program = new Command();
 
+// Only these commands show in --help. All others still work but are hidden.
+const VISIBLE_COMMANDS = new Set(["run", "hints", "vars", "init", "help"]);
+
 program
   .name("trickle")
-  .description("CLI for trickle runtime type observability")
-  .version("0.1.0");
+  .description("Runtime type annotations for Python — see tensor shapes, variable types, and crash-time values as you code")
+  .version((() => { try { return require("../package.json").version; } catch { return "0.0.0"; } })())
+  .configureHelp({
+    visibleCommands: (cmd: Command) => {
+      return cmd.commands.filter(c => VISIBLE_COMMANDS.has(c.name()));
+    },
+  })
+  .addHelpText("after", "\nAll other commands are available but hidden from this list. Run `trickle <command> --help` for any command.");
 
 // trickle init
 program
@@ -541,7 +550,8 @@ program
   .description("Output source code with inline type hints from runtime observations (for AI agents)")
   .option("--values", "Include sample values alongside types")
   .option("--errors", "Show error mode — variables at crash time with values that caused the error")
-  .action(async (file: string | undefined, opts: { values?: boolean; errors?: boolean }) => {
+  .option("--show <mode>", "What to show inline: types, values, or both (default: both in error mode, types otherwise)")
+  .action(async (file: string | undefined, opts: { values?: boolean; errors?: boolean; show?: string }) => {
     await hintsCommand(file, opts);
   });
 
@@ -1089,24 +1099,6 @@ if (
   process.argv.splice(2, 0, "run");
 }
 
-// Custom help: show curated commands first, then full list
-program.addHelpText('before', `
-  ${chalk.bold('Quick Start')}
-    trickle init                Set up trickle in your project
-    trickle run <command>       Run with observability (zero code changes)
-    trickle test [command]      Run tests with structured results
-
-  ${chalk.bold('Analyze')}
-    trickle summary             Full overview: errors, queries, root causes
-    trickle explain <file>      Understand a file: functions, call graph, data flow
-    trickle flamegraph          Performance hotspots visualization
-    trickle doctor              Health check with recommended actions
-
-  ${chalk.bold('Fix & Verify')}
-    trickle verify --baseline   Save metrics before fixing
-    trickle verify              Compare after fixing
-
-  ${chalk.bold('All Commands')}
-`);
+// Help text removed — visibleCommands filter handles it
 
 program.parse();