@neurowire/cli 0.1.0 → 0.3.0

package/dist/index.js

@@ -7,12 +7,17 @@ import {
   FORMATS,
   MeshSchema,
   isFormat,
+  parseDuration,
+  resolveWindow,
+  selectEntries,
   serialize,
   validateNwf
 } from "@neurowire/core";
 import { FeedTemplateSchema, fetchFeed, fetchMesh } from "@neurowire/ingest";
 import { registerAllTaps } from "@neurowire/taps";
-var VERSION = "0.1.0";
+var VERSION = "0.3.0";
+var SORT_KEYS = ["date", "title", "source"];
+var SORT_ORDERS = ["asc", "desc"];
 var HELP = `Neurowire ${VERSION} - turn any blog or feed into Atom and friends.
 
 Usage:
@@ -29,6 +34,16 @@ Options:
   -h, --help             Show this help.
   -v, --version          Show the version.
 
+Shape the output (applied before --format):
+      --sort <key>       Sort by date, title, or source.
+      --order <dir>      asc or desc (default: newest-first for date, A-Z otherwise).
+  -n, --limit <n>        Keep at most n entries. Handy for integrations: --limit 10.
+      --since <age>      Keep entries within this window, e.g. 24h, 90m, 7d.
+      --max-age <age>    Drop entries older than this (same window as --since).
+      --today            Keep entries since midnight UTC today.
+      --this-week        Keep entries since Monday midnight UTC.
+      --between <a>..<b> Keep entries between two dates, e.g. 2026-01-01..2026-02-01.
+
 Commands:
   validate <file-or-url> Check that an nwf document is well-formed (exits non-zero if not).
 
@@ -42,7 +57,8 @@ Taps teach Neurowire to read sites with no RSS/Atom feed. Add your own with
 Examples:
   neurowire https://example.com/blog
   neurowire https://example.com/feed.xml --format atom > feed.xml
-  neurowire --mesh ai-news.json --format atom
+  neurowire --mesh ai-news.json --format json --limit 10
+  neurowire --mesh ai-news.json --since 24h --sort date --format atom
   neurowire validate feed.nwf
 `;
 var useColor = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
@@ -99,6 +115,69 @@ async function runValidate(input) {
     process.exitCode = 1;
   }
 }
+function refineFeed(feed, values) {
+  const fail = (message) => {
+    process.stderr.write(`error: ${message}
+`);
+    process.exitCode = 1;
+    return void 0;
+  };
+  const sort = values.sort;
+  if (sort !== void 0 && !SORT_KEYS.includes(sort)) {
+    return fail(`unknown --sort "${sort}". Use one of: ${SORT_KEYS.join(", ")}`);
+  }
+  const order = values.order;
+  if (order !== void 0 && !SORT_ORDERS.includes(order)) {
+    return fail(`unknown --order "${order}". Use asc or desc`);
+  }
+  let limit;
+  if (values.limit !== void 0) {
+    limit = Number(values.limit);
+    if (!Number.isInteger(limit) || limit < 0) {
+      return fail(`--limit must be a non-negative integer (got "${values.limit}")`);
+    }
+  }
+  const spec = {};
+  if (typeof values.since === "string") spec.since = values.since;
+  if (typeof values["max-age"] === "string") spec.maxAge = values["max-age"];
+  if (values.today) spec.today = true;
+  if (values["this-week"]) spec.thisWeek = true;
+  if (typeof values.between === "string") {
+    const parts = values.between.split("..");
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+      return fail("--between expects <start>..<end>, e.g. 2026-01-01..2026-02-01");
+    }
+    spec.between = [parts[0], parts[1]];
+  }
+  for (const [flag, value] of [
+    ["--since", spec.since],
+    ["--max-age", spec.maxAge]
+  ]) {
+    if (value !== void 0 && parseDuration(value) === void 0) {
+      return fail(`invalid ${flag} "${value}" (use e.g. 24h, 90m, 7d)`);
+    }
+  }
+  if (spec.between) {
+    const [a, b] = spec.between;
+    if (Number.isNaN(Date.parse(a)) || Number.isNaN(Date.parse(b))) {
+      return fail("--between needs two parseable dates, e.g. 2026-01-01..2026-02-01");
+    }
+  }
+  const window = resolveWindow(spec, Date.now());
+  const opts = {
+    ...window,
+    sort,
+    order,
+    limit
+  };
+  const before = feed.entries.length;
+  const refined = selectEntries(feed, opts);
+  if (refined.entries.length !== before) {
+    process.stderr.write(`Refined to ${refined.entries.length} of ${before} entries
+`);
+  }
+  return refined;
+}
 function renderTerminal(feed) {
   const out = [bold(cyan(feed.title))];
   const sub = [feed.home, `${feed.entries.length} entries`, `updated ${day(feed.updated)}`].filter(
@@ -133,6 +212,14 @@ async function main() {
       template: { type: "string", short: "t" },
       mesh: { type: "string", short: "m" },
       taps: { type: "string", multiple: true },
+      sort: { type: "string" },
+      order: { type: "string" },
+      limit: { type: "string", short: "n" },
+      since: { type: "string" },
+      "max-age": { type: "string" },
+      today: { type: "boolean" },
+      "this-week": { type: "boolean" },
+      between: { type: "string" },
       help: { type: "boolean", short: "h" },
       version: { type: "boolean", short: "v" }
     }
@@ -171,6 +258,9 @@ async function main() {
     }
     feed = await fetchFeed(url, { template });
   }
+  const refined = refineFeed(feed, values);
+  if (!refined) return;
+  feed = refined;
   if (values.format) {
     if (!isFormat(values.format)) {
       process.stderr.write(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neurowire/cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Neurowire command-line tool: turn any blog, feed, or mesh into Atom, JSON Feed, Markdown, or nwf.",
   "type": "module",
   "bin": {
@@ -33,15 +33,15 @@
     "url": "https://github.com/starside-io/neurowire/issues"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=24"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@neurowire/ingest": "0.1.0",
-    "@neurowire/core": "0.1.0",
-    "@neurowire/taps": "0.1.0"
+    "@neurowire/ingest": "0.2.0",
+    "@neurowire/core": "0.3.0",
+    "@neurowire/taps": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.5",