pinets-cli 0.1.0 → 0.1.1

package/README.md

@@ -39,6 +39,12 @@ No code to write. No project to set up. Just point it at a `.pine` file and go.
 npm install -g pinets-cli
 ```
 
+Or run directly without installing:
+
+```bash
+npx pinets-cli run sma_cross.pine --symbol BTCUSDT --timeframe 60
+```
+
 ### Run your first indicator
 
 Create a file called `sma_cross.pine`:
@@ -113,6 +119,8 @@ pinets run rsi.pine --data ./my_candles.json
 | `--output <path>` | `-o` | Write output to a file instead of stdout | stdout |
 | `--format <type>` | `-f` | Output format: `default` or `full` | `default` |
 | `--pretty` | &mdash; | Force pretty-printed JSON | auto |
+| `--clean` | &mdash; | Filter out null, false, and empty values from plots | &mdash; |
+| `--plots <names>` | &mdash; | Comma-separated list of plot names to include | all plots |
 
 ### Candle Control
 
@@ -192,6 +200,30 @@ pinets run rsi.pine --symbol BTCUSDT --format full --pretty
 pinets run my_indicator.pine --symbol BTCUSDT --debug
 ```
 
+### Filter signals with --clean
+
+For indicators that generate signals (like crossovers), most candles will have `false` values. Use `--clean` to filter them out:
+
+```bash
+# Without --clean: 500 entries, mostly false
+pinets run ma_cross.pine -s BTCUSDT -t 1D -n 500
+
+# With --clean: Only actual signals
+pinets run ma_cross.pine -s BTCUSDT -t 1D -n 500 --clean
+```
+
+### Select specific plots
+
+When you only need specific plots from an indicator:
+
+```bash
+# Get only the Fast SMA (ignore Slow SMA)
+pinets run sma_cross.pine -s BTCUSDT --plots "Fast SMA"
+
+# Get only Buy and Sell signals
+pinets run signals.pine -s BTCUSDT --plots "Buy,Sell" --clean -q | jq '.plots'
+```
+
 ---
 
 ## Output Formats

package/dist/pinets-cli.dev.cjs

@@ -4501,13 +4501,13 @@ function readStdin(timeoutMs = 1e4) {
   });
 }
 
-function formatOutput(context, format, candles) {
+function formatOutput(context, format, candles, clean, plotFilter) {
   switch (format) {
     case "full":
-      return formatFull(context, candles);
+      return formatFull(context, candles, clean, plotFilter);
     case "default":
     default:
-      return formatDefault(context, candles);
+      return formatDefault(context, candles, clean, plotFilter);
   }
 }
 function writeOutput(data, outputPath, pretty, quiet) {
@@ -4523,14 +4523,25 @@ function writeOutput(data, outputPath, pretty, quiet) {
     process.stdout.write(json + "\n");
   }
 }
-function formatDefault(context, candles) {
+function formatDefault(context, candles, clean, plotFilter) {
   const plots = {};
+  const includePlots = plotFilter ? new Set(plotFilter.split(",").map((s) => s.trim()).filter((s) => s.length > 0)) : null;
   for (const [title, plotData] of Object.entries(context.plots)) {
-    const data = plotData.data;
+    if (includePlots && !includePlots.has(title)) {
+      continue;
+    }
+    let data = plotData.data;
+    data = data.length > candles ? data.slice(-candles) : data;
+    if (clean) {
+      data = data.filter((entry) => {
+        const val = entry.value;
+        return val !== null && val !== false && val !== void 0 && val !== "";
+      });
+    }
     plots[title] = {
       title: plotData.title,
       options: plotData.options,
-      data: data.length > candles ? data.slice(-candles) : data
+      data
     };
   }
   return {
@@ -4538,8 +4549,8 @@ function formatDefault(context, candles) {
     plots
   };
 }
-function formatFull(context, candles) {
-  const defaultOutput = formatDefault(context, candles);
+function formatFull(context, candles, clean, plotFilter) {
+  const defaultOutput = formatDefault(context, candles, clean, plotFilter);
   const md = context.marketData;
   const trimmedMarketData = md.length > candles ? md.slice(-candles) : md;
   let result = context.result;
@@ -4654,7 +4665,7 @@ async function runCommand(file, options) {
     log(quiet, "Executing...");
     const context = await pineTS.run(indicatorCode);
     log(quiet, "Done.");
-    const output = formatOutput(context, options.format, candles);
+    const output = formatOutput(context, options.format, candles, options.clean, options.plots);
     const pretty = options.pretty !== void 0 ? true : options.output ? false : !!process.stdout.isTTY;
     writeOutput(output, options.output, pretty, quiet);
   } catch (err) {
@@ -4696,7 +4707,7 @@ const PACKAGE_NAME = "pinets-cli";
 async function main() {
   const updateCheck = checkForUpdate(VERSION, PACKAGE_NAME);
   program.name("pinets").description("CLI for running Pine Script indicators via PineTS").version(VERSION, "-v, --version");
-  program.command("run").description("Execute a Pine Script indicator").argument("[file]", "Path to indicator file (.pine or any text file)").option("-s, --symbol <ticker>", "Symbol to query (e.g., BTCUSDT, ETHUSDT.P)").option("-t, --timeframe <tf>", "Timeframe: 1, 5, 15, 60, 240, 1D, 1W, 1M", "60").option("-d, --data <path>", "Path to JSON data file (alternative to --symbol)").option("-o, --output <path>", "Write output to file (default: stdout)").option("-f, --format <type>", "Output format: default | full", "default").option("--pretty", "Pretty-print JSON output").option("-n, --candles <count>", "Number of output candles", "500").option("-w, --warmup <count>", "Extra warmup candles for indicator init", "0").option("--debug", "Show transpiled code").option("-q, --quiet", "Suppress informational messages").action(runCommand);
+  program.command("run").description("Execute a Pine Script indicator").argument("[file]", "Path to indicator file (.pine or any text file)").option("-s, --symbol <ticker>", "Symbol to query (e.g., BTCUSDT, ETHUSDT.P)").option("-t, --timeframe <tf>", "Timeframe: 1, 5, 15, 60, 240, 1D, 1W, 1M", "60").option("-d, --data <path>", "Path to JSON data file (alternative to --symbol)").option("-o, --output <path>", "Write output to file (default: stdout)").option("-f, --format <type>", "Output format: default | full", "default").option("--pretty", "Pretty-print JSON output").option("--clean", "Filter out null, false, and empty values from plot data").option("--plots <names>", "Comma-separated list of plot names to include").option("-n, --candles <count>", "Number of output candles", "500").option("-w, --warmup <count>", "Extra warmup candles for indicator init", "0").option("--debug", "Show transpiled code").option("-q, --quiet", "Suppress informational messages").action(runCommand);
   await program.parseAsync();
   const notice = await Promise.race([
     updateCheck,