dexterm-cli 0.0.0-stage → 0.1.2

package/dist/packages/cli/assets/claude/schemas/larp.schema.json

@@ -0,0 +1,117 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dexterm/claude-layer/larp",
+  "title": "LARP detector verdict (larp-check)",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["skill", "skill_version", "mint", "verdict", "confidence", "claims", "missing_data", "facts", "flags", "injection_detected", "sources_used", "summary"],
+  "properties": {
+    "skill": { "type": "string", "enum": ["larp-check"] },
+    "skill_version": { "type": "string" },
+    "mint": { "type": "string", "description": "The mint analysed, or empty string when AMBIGUOUS before resolution" },
+    "verdict": { "type": "string", "enum": ["REAL_PRODUCT", "EARLY_BUT_REAL", "LARP", "UNVERIFIABLE", "AMBIGUOUS"] },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+    "summary": { "type": "string", "maxLength": 600, "description": "Two to four short lines for a 40-column panel: the verdict in plain words and the strongest evidence. Never a disclaimer line" },
+    "claims": {
+      "type": "array",
+      "description": "Each product claim the site/socials make, with the evidence for or against it.",
+      "minItems": 0,
+      "maxItems": 20,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["claim", "status", "evidence"],
+        "properties": {
+          "claim": { "type": "string", "maxLength": 160, "description": "What the project claims exists (a live app, a demo, a GitHub, a team, docs…)" },
+          "status": { "type": "string", "enum": ["supported", "contradicted", "unverifiable"] },
+          "evidence": { "type": "string", "maxLength": 240, "description": "The tool result that supports/contradicts it (tool + field + value), or why it is unverifiable" }
+        }
+      }
+    },
+    "links_checked": {
+      "type": "array",
+      "maxItems": 24,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["url", "kind", "reachable"],
+        "properties": {
+          "url": { "type": "string" },
+          "kind": { "type": "string" },
+          "reachable": { "type": "boolean" },
+          "status": { "type": ["number", "null"] }
+        }
+      }
+    },
+    "domain": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "properties": {
+        "domain": { "type": ["string", "null"] },
+        "age_days": { "type": ["number", "null"] },
+        "registrar": { "type": ["string", "null"] },
+        "privacy": { "type": ["boolean", "null"] }
+      }
+    },
+    "github": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "properties": {
+        "repo": { "type": ["string", "null"] },
+        "days_since_push": { "type": ["number", "null"] },
+        "stars": { "type": ["number", "null"] },
+        "archived": { "type": ["boolean", "null"] }
+      }
+    },
+    "missing_data": {
+      "type": "array",
+      "description": "What could not be fetched keyless (e.g. X is login-walled, site timed out). Be honest here.",
+      "items": { "type": "string", "maxLength": 160 },
+      "maxItems": 20
+    },
+    "facts": {
+      "type": "array",
+      "minItems": 0,
+      "maxItems": 24,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["claim", "tool", "field", "value"],
+        "properties": {
+          "claim": { "type": "string", "maxLength": 160 },
+          "tool": { "type": "string" },
+          "field": { "type": "string" },
+          "value": { "type": ["number", "string", "boolean", "null"] },
+          "age_sec": { "type": ["number", "null"] }
+        }
+      }
+    },
+    "flags": { "type": "array", "items": { "type": "string" }, "maxItems": 20 },
+    "invalidation": { "type": "string", "maxLength": 240 },
+    "proposals": {
+      "type": "array",
+      "maxItems": 5,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["type", "text"],
+        "properties": {
+          "type": { "type": "string", "enum": ["alert", "note", "watchlist"] },
+          "text": { "type": "string", "maxLength": 200 },
+          "condition": { "type": "string", "maxLength": 120 }
+        }
+      }
+    },
+    "injection_detected": { "type": "boolean" },
+    "candidates": {
+      "type": "array",
+      "description": "AMBIGUOUS only: the mints the symbol could mean",
+      "items": { "type": "object", "additionalProperties": false, "required": ["mint"], "properties": { "mint": { "type": "string" }, "launchpad": { "type": "string" }, "mcap": { "type": ["number", "null"] }, "ageSec": { "type": ["number", "null"] } } }
+    },
+    "sources_used": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": false, "required": ["tool"], "properties": { "tool": { "type": "string" }, "source": { "type": "string" }, "age_sec": { "type": ["number", "null"] } } }
+    },
+    "kb_entries_cited": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/dist/packages/cli/assets/claude/schemas/trench-scan.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dexterm/claude-layer/trench-scan",
+  "title": "Trench scan output",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["skill", "skill_version", "scanned", "candidates", "skipped", "injection_detected", "sources_used", "summary"],
+  "properties": {
+    "skill": { "type": "string", "enum": ["trench-scan"] },
+    "skill_version": { "type": "string" },
+    "scanned": { "type": "integer", "minimum": 0 },
+    "summary": { "type": "string", "maxLength": 400, "description": "One short line per candidate plus one skipped-count line. No intro, no disclaimer line" },
+    "candidates": {
+      "type": "array",
+      "maxItems": 10,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["mint", "verdict", "confidence", "reasons", "facts"],
+        "properties": {
+          "mint": { "type": "string" },
+          "symbol": { "type": "string" },
+          "verdict": { "type": "string", "enum": ["WATCH", "SPECULATIVE", "AVOID", "INSUFFICIENT_DATA"] },
+          "bias": { "type": "string", "enum": ["long", "short", "avoid", "wait"], "description": "Quick directional lean for this candidate" },
+          "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+          "reasons": { "type": "array", "items": { "type": "string", "maxLength": 120 }, "maxItems": 5 },
+          "facts": {
+            "type": "array",
+            "maxItems": 8,
+            "items": { "type": "object", "additionalProperties": false, "required": ["claim", "tool", "field", "value"], "properties": { "claim": { "type": "string", "maxLength": 120 }, "tool": { "type": "string" }, "field": { "type": "string" }, "value": { "type": ["number", "string", "boolean", "null"] } } }
+          }
+        }
+      }
+    },
+    "skipped": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": false, "required": ["mint", "reason"], "properties": { "mint": { "type": "string" }, "reason": { "type": "string", "maxLength": 120 } } }
+    },
+    "proposals": {
+      "type": "array",
+      "maxItems": 5,
+      "items": { "type": "object", "additionalProperties": false, "required": ["type", "text"], "properties": { "type": { "type": "string", "enum": ["alert", "note", "watchlist"] }, "text": { "type": "string", "maxLength": 200 }, "mint": { "type": "string" } } }
+    },
+    "injection_detected": { "type": "boolean" },
+    "results": {
+      "type": "array",
+      "maxItems": 20,
+      "description": "The scan's ranked coins as a list the app renders as a live table (prices/liq/vol from its data layer by mint, never your text). One entry per WATCH/SPECULATIVE candidate, best first; only mints the screener returned.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["mint", "reason"],
+        "properties": {
+          "mint": { "type": "string" },
+          "symbol": { "type": "string", "maxLength": 32 },
+          "reason": { "type": "string", "maxLength": 100 }
+        }
+      }
+    },
+    "filter_applied": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["query"],
+      "properties": {
+        "query": { "type": "string", "maxLength": 120 },
+        "notes": { "type": "string", "maxLength": 160 }
+      }
+    },
+    "sources_used": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["tool"], "properties": { "tool": { "type": "string" }, "source": { "type": "string" }, "age_sec": { "type": ["number", "null"] } } } }
+  }
+}

package/dist/packages/cli/assets/claude/schemas/verdict.schema.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dexterm/claude-layer/verdict",
+  "title": "Analyst verdict (token-dossier, rug-check)",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["skill", "skill_version", "mint", "verdict", "confidence", "facts", "flags", "invalidation", "proposals", "injection_detected", "sources_used", "summary", "missing_data"],
+  "properties": {
+    "product_assessment": {
+      "type": "object", "additionalProperties": false,
+      "required": ["verdict", "confidence", "claims", "missing_data"],
+      "properties": {
+        "verdict": { "type": "string", "enum": ["REAL_PRODUCT", "EARLY_BUT_REAL", "LARP", "UNVERIFIABLE"] },
+        "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+        "claims": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["claim", "evidence"], "properties": { "claim": { "type": "string" }, "evidence": { "type": "string" } } } },
+        "missing_data": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "skill": { "type": "string", "enum": ["token-dossier", "rug-check"] },
+    "skill_version": { "type": "string" },
+    "mint": { "type": "string", "description": "The mint analysed, or empty string when AMBIGUOUS/INSUFFICIENT_DATA before resolution" },
+    "verdict": { "type": "string", "enum": ["WATCH", "SPECULATIVE", "AVOID", "INSUFFICIENT_DATA", "AMBIGUOUS"] },
+    "bias": { "type": "string", "enum": ["long", "short", "avoid", "wait"], "description": "The directional trading view; give one unless AMBIGUOUS/INSUFFICIENT_DATA" },
+    "setup_quality": { "type": "string", "enum": ["strong", "mixed", "weak"], "description": "How clean the setup is given liquidity, holders, tape and structure" },
+    "key_levels": {
+      "type": "array",
+      "maxItems": 8,
+      "description": "Concrete levels from the candles and liquidity (support, resistance, VWAP, range high/low, invalidation level)",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["label"],
+        "properties": {
+          "label": { "type": "string", "maxLength": 40 },
+          "value": { "type": ["number", "string", "null"] },
+          "note": { "type": "string", "maxLength": 80 }
+        }
+      }
+    },
+    "size_hint": { "type": "string", "maxLength": 160, "description": "Size framed as a fraction of risk capital with the stop (e.g. '0.5-1% risk, stop below the range low'); never a dollar amount or a token count" },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+    "missing_data": { "type": "array", "items": { "type": "string", "maxLength": 160 }, "maxItems": 20, "description": "Sections or fields that were unavailable/null (copied from the dossier `availability.missing` and `knownUnavailable`). Empty array when everything was present. A non-empty list lowers confidence but — as long as price or liquidity exists — never forces INSUFFICIENT_DATA." },
+    "rug_probability": { "type": "number", "minimum": 0, "maximum": 1, "description": "rug-check only: model's probability that this token rugs within 72 h" },
+    "summary": { "type": "string", "maxLength": 600, "description": "Two to four short lines for a 40-column panel: the call in plain words and the deciding facts. Never repeats bias/levels/invalidation/size (rendered from their own fields), never a disclaimer line" },
+    "facts": {
+      "type": "array",
+      "minItems": 0,
+      "maxItems": 20,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["claim", "tool", "field", "value"],
+        "properties": {
+          "claim": { "type": "string", "maxLength": 160 },
+          "tool": { "type": "string" },
+          "field": { "type": "string" },
+          "value": { "type": ["number", "string", "boolean", "null"] },
+          "age_sec": { "type": ["number", "null"] }
+        }
+      }
+    },
+    "flags": { "type": "array", "items": { "type": "string" }, "maxItems": 20 },
+    "invalidation": { "type": "string", "maxLength": 240 },
+    "proposals": {
+      "type": "array",
+      "maxItems": 5,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["type", "text"],
+        "properties": {
+          "type": { "type": "string", "enum": ["alert", "note", "watchlist"] },
+          "text": { "type": "string", "maxLength": 200 },
+          "condition": { "type": "string", "maxLength": 120 }
+        }
+      }
+    },
+    "injection_detected": { "type": "boolean" },
+    "candidates": {
+      "type": "array",
+      "description": "AMBIGUOUS only: the mints the symbol could mean",
+      "items": { "type": "object", "additionalProperties": false, "required": ["mint"], "properties": { "mint": { "type": "string" }, "launchpad": { "type": "string" }, "mcap": { "type": ["number", "null"] }, "ageSec": { "type": ["number", "null"] } } }
+    },
+    "results": {
+      "type": "array",
+      "maxItems": 20,
+      "description": "When the answer is a LIST of coins (e.g. after a filter, or 'best setups right now'), put one entry per coin here by mint. The app renders a live table from these mints (prices/liq/vol come from its data layer, never your text); only mints already on screen or fetched via tools are shown. Give a one-line reason per row.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["mint", "reason"],
+        "properties": {
+          "mint": { "type": "string", "description": "base58 mint of a coin that is on screen or that a tool returned" },
+          "symbol": { "type": "string", "maxLength": 32 },
+          "reason": { "type": "string", "maxLength": 100, "description": "one short line on why this coin is in the list" }
+        }
+      }
+    },
+    "filter_applied": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "When you called show_in_screener for a plain-language request, echo the structured filter you applied here so the user sees (and can correct) the numbers you chose.",
+      "required": ["query"],
+      "properties": {
+        "query": { "type": "string", "maxLength": 120, "description": "the exact filter string you passed to show_in_screener, in dexterm grammar (e.g. 'mcap < 5M liq > 50K h24 > 0 flag:clean')" },
+        "notes": { "type": "string", "maxLength": 160, "description": "the numbers you chose for vague words, in words (e.g. 'low cap = mcap < 5M; liquid = liq > 50K; up on the day = h24 > 0; not a rug = flag:clean')" }
+      }
+    },
+    "sources_used": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": false, "required": ["tool"], "properties": { "tool": { "type": "string" }, "source": { "type": "string" }, "age_sec": { "type": ["number", "null"] } } }
+    },
+    "kb_entries_cited": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/dist/packages/cli/bin/dexterm.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+// dexterm bin shim. Runs the TypeScript sources directly via Node's built-in type stripping
+// (Node >= 22.18 / 23.6+ / 24). This is the checkout/source-tarball entry; the npm package's bin is
+// the compiled copy at dist/packages/cli/bin/dexterm.mjs, built by scripts/build-dist.mjs (task-1346).
+const [major, minor] = process.versions.node.split('.').map(Number);
+if (major < 22 || (major === 22 && minor < 18)) {
+  process.stderr.write(`dexterm needs Node 22.18 or newer (found ${process.versions.node})\n`);
+  process.exit(1);
+}
+const { main } = await import('../src/main.js');
+process.exitCode = await main(process.argv.slice(2));