@taurgis/bonsai 3.2.2 → 4.0.0

package/oclif.manifest.json

@@ -18,6 +18,10 @@
         {
           "description": "cache a volatile page with compressed JSON output",
           "command": "<%= config.bin %> https://news.ycombinator.com/ --format compressed --ttl 2h --json"
+        },
+        {
+          "description": "fetch multiple URLs in one batch (space-separated)",
+          "command": "<%= config.bin %> https://docs.nestjs.com/ https://docs.nestjs.com/first-steps"
         }
       ],
       "flags": {
@@ -37,9 +41,15 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "toon": {
+          "description": "emit the same envelope as --json, encoded as TOON (fewer tokens); cannot be combined with --json",
+          "name": "toon",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "topic": {
           "char": "t",
-          "description": "main research topic for metadata",
+          "description": "main research topic for metadata (max 200 chars)",
           "name": "topic",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -47,7 +57,7 @@
         },
         "tags": {
           "char": "g",
-          "description": "taxonomic tags for this research (can be repeated)",
+          "description": "taxonomic tags for this research (can be repeated, max 100 chars each)",
           "name": "tags",
           "hasDynamicHelp": false,
           "multiple": true,
@@ -187,6 +197,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "toon": {
+          "description": "emit the same envelope as --json, encoded as TOON (fewer tokens); cannot be combined with --json",
+          "name": "toon",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "stdin": {
           "description": "read Markdown from stdin",
           "name": "stdin",
@@ -215,7 +231,7 @@
         },
         "topic": {
           "char": "t",
-          "description": "main topic for this research note",
+          "description": "main topic for this research note (max 200 chars)",
           "name": "topic",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -223,7 +239,7 @@
         },
         "tags": {
           "char": "g",
-          "description": "taxonomic tags (can be repeated)",
+          "description": "taxonomic tags (can be repeated, max 100 chars each)",
           "name": "tags",
           "hasDynamicHelp": false,
           "multiple": true,
@@ -304,6 +320,10 @@
         {
           "description": "inspect cached metadata as JSON",
           "command": "<%= config.bin %> <%= command.id %> https://example.com/docs --json"
+        },
+        {
+          "description": "inspect multiple URLs in one batch (space-separated)",
+          "command": "<%= config.bin %> <%= command.id %> https://example.com/docs https://example.com/api"
         }
       ],
       "flags": {
@@ -322,6 +342,12 @@
           "name": "read-only",
           "allowNo": false,
           "type": "boolean"
+        },
+        "toon": {
+          "description": "emit the same envelope as --json, encoded as TOON (fewer tokens); cannot be combined with --json",
+          "name": "toon",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -338,7 +364,7 @@
     "list": {
       "aliases": [],
       "args": {},
-      "description": "List page-level cached artifacts with source URLs, topic, tags, freshness, capture method, and token estimates.",
+      "description": "List page-level cached artifacts by source URL, topic, freshness, and token estimate. Pass --full for every metadata field (cache key, path, artifact type, tags, capture method, quality notes, timestamps).",
       "examples": [
         {
           "description": "list cached entries",
@@ -355,6 +381,10 @@
         {
           "description": "list entries matching a URL glob",
           "command": "<%= config.bin %> list --url \"https://react.dev/*\""
+        },
+        {
+          "description": "list every metadata field instead of the minimal default row",
+          "command": "<%= config.bin %> list --full --json"
         }
       ],
       "flags": {
@@ -374,6 +404,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "toon": {
+          "description": "emit the same envelope as --json, encoded as TOON (fewer tokens); cannot be combined with --json",
+          "name": "toon",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "topic": {
           "char": "t",
           "description": "exact topic (case-insensitive)",
@@ -436,12 +472,18 @@
           "type": "option"
         },
         "limit": {
-          "description": "result count (default 50, max 100)",
+          "description": "result count (max 100)",
           "name": "limit",
           "default": 50,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "full": {
+          "description": "include every metadata field (cache key, path, artifact type, tags, capture method, quality notes, timestamps); default output is a minimal row (source URLs, topic, freshness, token estimate)",
+          "name": "full",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -458,7 +500,7 @@
     "prune": {
       "aliases": [],
       "args": {},
-      "description": "Delete cached artifacts by content age, idle time, URL glob, or artifact type.",
+      "description": "Delete cached artifacts by content age, idle time, URL glob, artifact type, topic, or tags.",
       "examples": [
         {
           "description": "preview pruning entries older than 30 days",
@@ -471,6 +513,10 @@
         {
           "description": "prune entries matching a URL glob",
           "command": "<%= config.bin %> prune --url \"https://react.dev/*\" --yes"
+        },
+        {
+          "description": "prune entries tagged as deprecated",
+          "command": "<%= config.bin %> prune --tags deprecated --yes"
         }
       ],
       "flags": {
@@ -490,6 +536,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "toon": {
+          "description": "emit the same envelope as --json, encoded as TOON (fewer tokens); cannot be combined with --json",
+          "name": "toon",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "older-than": {
           "description": "content age threshold (fetched_at, else validated_at), e.g. \"30d\"",
           "name": "older-than",
@@ -511,6 +563,22 @@
           "multiple": false,
           "type": "option"
         },
+        "topic": {
+          "char": "t",
+          "description": "exact topic (case-insensitive)",
+          "name": "topic",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tags": {
+          "char": "g",
+          "description": "tags to require (must match all)",
+          "name": "tags",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "artifact-type": {
           "description": "artifact type to prune, including section children",
           "name": "artifact-type",
@@ -567,6 +635,10 @@
         {
           "description": "evaluate status with a specific tier and TTL",
           "command": "<%= config.bin %> <%= command.id %> https://example.com/docs --tier volatile --ttl 2h"
+        },
+        {
+          "description": "check multiple URLs in one batch (space-separated)",
+          "command": "<%= config.bin %> <%= command.id %> https://example.com/docs https://example.com/api"
         }
       ],
       "flags": {
@@ -586,6 +658,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "toon": {
+          "description": "emit the same envelope as --json, encoded as TOON (fewer tokens); cannot be combined with --json",
+          "name": "toon",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "tier": {
           "description": "freshness tier policy to evaluate; when omitted, uses the cached entry's own tier",
           "name": "tier",
@@ -655,6 +733,12 @@
           "name": "read-only",
           "allowNo": false,
           "type": "boolean"
+        },
+        "toon": {
+          "description": "emit the same envelope as --json, encoded as TOON (fewer tokens); cannot be combined with --json",
+          "name": "toon",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -677,7 +761,7 @@
           "required": false
         }
       },
-      "description": "Print a config value. Without --global/--local, shows the merged effective value, in precedence order: a per-command override flag (e.g. `fetch --storage`) > env var > project file > user file > built-in default.\n\nValid keys: storage, summary.",
+      "description": "Print a config value. Without --global/--local, shows the merged effective value, in precedence order: a per-command override flag (e.g. `fetch --storage`) > env var > project file > user file > built-in default.\n\nValid keys: storage (global|project), summary (conservative|balanced|aggressive).",
       "examples": [
         {
           "description": "get the effective storage mode",
@@ -705,6 +789,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "toon": {
+          "description": "emit the same envelope as --json, encoded as TOON (fewer tokens); cannot be combined with --json",
+          "name": "toon",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "global": {
           "char": "g",
           "description": "read user-level config only",
@@ -738,7 +828,7 @@
     "config:list": {
       "aliases": [],
       "args": {},
-      "description": "Show every configuration key with its current value. Use --global/--local to show a single scope.\n\nValid keys: storage, summary.",
+      "description": "Show every configuration key with its current value. Use --global/--local to show a single scope.\n\nValid keys: storage (global|project), summary (conservative|balanced|aggressive).",
       "examples": [
         {
           "description": "show all effective config values",
@@ -766,6 +856,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "toon": {
+          "description": "emit the same envelope as --json, encoded as TOON (fewer tokens); cannot be combined with --json",
+          "name": "toon",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "global": {
           "char": "g",
           "description": "show user-level config only",
@@ -810,7 +906,7 @@
           "required": false
         }
       },
-      "description": "Persist a configuration value. Writes user-level config by default; pass --local for project-level config (.bonsai.json in cwd).\n\nValid keys: storage, summary. The inline form `<key>=<value>` is also accepted.",
+      "description": "Persist a configuration value. Writes user-level config by default; pass --local for project-level config (.bonsai.json in cwd).\n\nValid keys: storage (global|project), summary (conservative|balanced|aggressive). The inline form `<key>=<value>` is also accepted.",
       "examples": [
         {
           "description": "store research cache in the current project",
@@ -838,6 +934,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "toon": {
+          "description": "emit the same envelope as --json, encoded as TOON (fewer tokens); cannot be combined with --json",
+          "name": "toon",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "global": {
           "char": "g",
           "description": "write user-level config (default)",
@@ -883,7 +985,7 @@
           "required": false
         }
       },
-      "description": "Delete a key from user-level config (default) or project-level config (--local), restoring the built-in default.\n\nValid keys: storage, summary.",
+      "description": "Delete a key from user-level config (default) or project-level config (--local), restoring the built-in default.\n\nValid keys: storage (global|project), summary (conservative|balanced|aggressive).",
       "examples": [
         {
           "description": "remove the user-level storage setting",
@@ -911,6 +1013,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "toon": {
+          "description": "emit the same envelope as --json, encoded as TOON (fewer tokens); cannot be combined with --json",
+          "name": "toon",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "global": {
           "char": "g",
           "description": "remove from user-level config (default)",
@@ -948,5 +1056,5 @@
       "stdoutIsPrimaryData": true
     }
   },
-  "version": "3.2.2"
+  "version": "4.0.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taurgis/bonsai",
-  "version": "3.2.2",
+  "version": "4.0.0",
   "description": "Bonsai is a standalone local research cache CLI for AI agents",
   "repository": {
     "type": "git",
@@ -37,6 +37,7 @@
     "@mozilla/readability": "^0.5.0",
     "@oclif/core": "^4.11.4",
     "@oclif/plugin-autocomplete": "^3.2.52",
+    "@toon-format/toon": "^4.0.0",
     "linkedom": "^0.18.12",
     "turndown": "^7.2.0",
     "undici": "^8.7.0",