mt-signals 1.0.0 → 1.1.0

package/README.md

@@ -0,0 +1,88 @@
+# mt-signals
+
+CLI for [MetalTorque Research Signals](https://signals.metaltorque.dev) — scored trend intelligence from HN, Reddit, ArXiv, and GitHub.
+
+## Install
+
+```bash
+npx mt-signals signals                   # Run without installing
+npm i -g mt-signals                      # Or install globally
+```
+
+## Quick Start
+
+```bash
+# List all scored signals
+mt-signals signals
+
+# Top 5 hottest signals
+mt-signals top 5
+
+# Breakout trends + hot signals (score 6+)
+mt-signals trending
+
+# Deep dive on a topic
+mt-signals lookup "MCP server"
+
+# Filter by category
+mt-signals signals --category=ai
+```
+
+## Commands
+
+### Discovery
+| Command | Description |
+|---------|-------------|
+| `signals` | List all scored signals (filterable by category, sort, min score) |
+| `top [N]` | Top N signals ranked by score (default: 10) |
+| `trending` | Breakout signals (1.8x+ rolling avg) and hot signals (score 6+) |
+
+### Analysis
+| Command | Description |
+|---------|-------------|
+| `lookup <topic>` | Deep dive — score breakdown, evidence, trend history, actionable-for audience |
+| `category <name>` | All signals in a category (ai, infrastructure, security, devtools, data, business, career, market) |
+| `stats` | Aggregate stats — total signals, category breakdown, top 10 |
+
+### Management
+| Command | Description |
+|---------|-------------|
+| `recalculate` | Force score recalculation (applies time decay, detects new breakouts) |
+| `config` | View current configuration |
+| `config set <key> <value>` | Set config value (keys: `url`, `apiKey`) |
+
+## Agent / CI Usage
+
+Every command supports `--json`:
+
+```bash
+# JSON output for scripting
+mt-signals top 10 --json | jq '.[0].topic'
+
+# Pipe trending breakouts to another tool
+mt-signals trending --json | jq '.breakouts'
+
+# Filter high-score AI signals
+mt-signals signals --category=ai --min=7 --json
+```
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--json` | Output raw JSON (for piping/agents) |
+| `--category=X` | Filter: ai, infrastructure, security, devtools, data, business, career, market |
+| `--sort=X` | Sort: score, urgency, buyer_intent, durability |
+| `--min=N` | Minimum score filter |
+| `--limit=N` | Max results |
+| `--version` | Print version |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `MT_SIGNALS_API_KEY` | Access key for the API (overrides saved config) |
+| `MT_SIGNALS_URL` | Server URL (default: `https://signals.metaltorque.dev`) |
+| `NO_COLOR` | Disable colored output |
+
+Configuration is stored in `~/.mt-signals/config.json`.

package/bin/mt-signals.js

@@ -18,6 +18,12 @@ for (const a of args) {
 const cmd = positional[0];
 const json = flags.json;
 
+if (flags.version || flags.v) {
+  const { version } = require("../package.json");
+  console.log(version);
+  process.exit(0);
+}
+
 function out(data) {
   if (json) return console.log(JSON.stringify(data, null, 2));
   return data;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mt-signals",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "CLI for MetalTorque Research Signals — scored trend intelligence from HN, Reddit, ArXiv, and GitHub.",
   "bin": {
     "mt-signals": "bin/mt-signals.js"