@wirecat/cli-base 0.25.0 → 0.27.0

package/dist/standards/vocabulary.js

@@ -118,6 +118,10 @@ const verbs = [
     ["backup", "copy a file somewhere safe"],
     ["restore", "put a backup back in its place"],
     ["repair", "bring a file's tables to this build's shape without deleting anything"],
+    [
+        "rebuild",
+        "compute again, from what the store already holds, what the tool derives from it, keeping the owner's decisions",
+    ],
     ["link", "record that two identities are one person"],
     ["unlink", "undo a link"],
     ["lookup", "ask the messenger who is behind a phone number"],
@@ -180,7 +184,10 @@ const collections = [
     ["notes", "text the owner writes, or files from a notes folder"],
     ["projects", "the owner's work units with a task key"],
     ["organizations", "companies, teams, families or communities"],
-    ["identities", "accounts of a person in one messenger or mailbox"],
+    [
+        "identities",
+        "ways to reach a person or an organization: an account in one messenger or mailbox, an e-mail address, a phone",
+    ],
     ["facts", "what happened, with evidence"],
     ["memories", "what an agent concluded, with evidence and scope"],
     ["relationships", "confirmed or suggested links between people, organizations and projects"],
@@ -191,6 +198,7 @@ const collections = [
     ["jobs", "work this tool runs in the background or on a timer"],
     ["actions", "what an agent proposes to do; the owner confirms or rejects each"],
     ["aliases", "other names of one thing"],
+    ["mentions", "phones, e-mail addresses, links and documents found in stored text, each where it was written"],
 ];
 const singulars = [
     ["session", "this tool's login"],
@@ -198,6 +206,7 @@ const singulars = [
     ["config", "a profile's settings"],
     ["server", "the long-running process of a profile"],
     ["store", "the local SQLite database the tools share"],
+    ["catalog", "stored source file and folder metadata and parent relationships"],
     ["skill", "the agent skill file of this tool"],
     ["cache", "max's per-profile cache"],
     ["flood", "what the messenger told this profile to hold off on"],
@@ -205,6 +214,7 @@ const singulars = [
     ["api", "the source's own API, one command per operation"],
 ];
 const views = [
+    ["tree", "the parent and child hierarchy of stored sources"],
     ["logs", "the log of a running process"],
     ["events", "what happened in a thing over time"],
     ["scheduled", "what is scheduled to happen"],
@@ -216,6 +226,7 @@ const views = [
     ["official", "the view the messenger itself computed, under stats"],
     ["transcript", "the text of speech: a voice message or a meeting recording"],
     ["evidence", "the stored messages or lines a result or a reference rests on"],
+    ["passage", "a cited transcript line with bounded surrounding lines from the same revision"],
 ];
 const roots = [
     ["inbox", "what waits across every chat"],
@@ -232,6 +243,37 @@ const roots = [
     ["search", "searches across resources"],
 ];
 const flags = [
+    {
+        name: "--bytes",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "at most this many bytes of included evidence content",
+        unit: "bytes",
+    },
+    {
+        name: "--max-read-bytes",
+        value: "<bytes>",
+        role: "budget",
+        type: "count",
+        meaning: "at most this many stored text bytes read for one bounded evidence window",
+        unit: "bytes",
+    },
+    {
+        name: "--expected-fingerprint",
+        value: "<hash>",
+        role: "target",
+        type: "string",
+        meaning: "require the selected evidence anchor to match this previously read fingerprint",
+    },
+    {
+        name: "--depth",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "maximum descendant depth in a hierarchy",
+        unit: "levels",
+    },
     { name: "--limit", value: "<n>", role: "paging", type: "count", meaning: "how many items", unit: "items" },
     {
         name: "--page",
@@ -273,16 +315,16 @@ const flags = [
         value: "<n>",
         role: "output",
         type: "count",
-        meaning: "how many messages before it",
-        unit: "messages",
+        meaning: "how many messages or transcript lines before it",
+        unit: "items",
     },
     {
         name: "--after-n",
         value: "<n>",
         role: "output",
         type: "count",
-        meaning: "how many messages after it",
-        unit: "messages",
+        meaning: "how many messages or transcript lines after it",
+        unit: "items",
     },
     { name: "--timeout", value: "<duration>", role: "budget", type: "duration", meaning: "give up after this long" },
     {
@@ -313,6 +355,494 @@ const flags = [
         type: "switch",
         meaning: "on failure, show the full error record: cause and stack",
     },
+    {
+        name: "--agent-json",
+        role: "output",
+        type: "switch",
+        meaning: "JSON with control and direction characters made visible in strings and keys",
+    },
+    {
+        name: "--brief",
+        role: "output",
+        type: "switch",
+        meaning: "each item as its reference, title, time and excerpt only",
+    },
+    {
+        name: "--chart-kind",
+        value: "<messages|active|membership>",
+        role: "output",
+        type: "choice",
+        meaning: "what a chart draws",
+    },
+    {
+        name: "--checkpoints",
+        value: "<durations>",
+        role: "output",
+        type: "list",
+        meaning: "the ages to report on, comma-separated: 1d,7d,30d",
+    },
+    {
+        name: "--fields",
+        value: "<paths>",
+        role: "output",
+        type: "list",
+        meaning: "only these comma-separated fields of each item; list metadata stays",
+    },
+    { name: "--format", value: "<format>", role: "output", type: "choice", meaning: "the format of the file written" },
+    { name: "--full", role: "output", type: "switch", meaning: "each item with its whole text and every field" },
+    {
+        name: "--json",
+        role: "output",
+        type: "switch",
+        meaning: "machine-readable output: one JSON value on stdout, nothing else",
+    },
+    { name: "--jsonl", role: "output", type: "switch", meaning: "machine-readable output: one JSON object per line" },
+    { name: "--output", value: "<file>", role: "output", type: "path", meaning: "the file to write" },
+    {
+        name: "--output-dir",
+        value: "<dir>",
+        role: "output",
+        type: "path",
+        meaning: "the folder to write into, created if missing",
+    },
+    { name: "--quiet", role: "output", type: "switch", meaning: "no diagnostics on stderr" },
+    { name: "--show-phone", role: "output", type: "switch", meaning: "print the whole phone number" },
+    {
+        name: "--thread-within",
+        value: "<duration>",
+        role: "output",
+        type: "duration",
+        meaning: "messages within this long either side of the hit",
+    },
+    {
+        name: "--trace",
+        role: "output",
+        type: "switch",
+        meaning: "one line per request on stderr: ids and timings, never content",
+    },
+    { name: "--verbose", role: "output", type: "switch", meaning: "more detail in what is shown; repeat for more" },
+    { name: "--version", role: "output", type: "switch", meaning: "print the version number" },
+    { name: "--with-notes", role: "output", type: "switch", meaning: "include the owner's private notes" },
+    { name: "--measure", value: "<name>", role: "sort", type: "choice", meaning: "the metric a ranking is ordered by" },
+    { name: "--newest", role: "sort", type: "switch", meaning: "newest first instead of best first" },
+    {
+        name: "--order",
+        value: "<recent|name>",
+        role: "sort",
+        type: "choice",
+        meaning: "the order of a list: most recent first, or by name",
+    },
+    { name: "--score", value: "<preset>", role: "sort", type: "choice", meaning: "the named ranking score preset" },
+    {
+        name: "--weights",
+        value: "<json>",
+        role: "sort",
+        type: "string",
+        meaning: "the ranking component weights, all of them",
+    },
+    { name: "--accept-terms", role: "mode", type: "switch", meaning: "accept the model's licence terms" },
+    {
+        name: "--allow-any-file",
+        role: "mode",
+        type: "switch",
+        meaning: "send a file even from a credential folder or the tool's own folders",
+    },
+    {
+        name: "--allow-dangerous",
+        role: "mode",
+        type: "switch",
+        meaning: "go ahead without the question an ask level puts before a deletion",
+    },
+    {
+        name: "--allow-writes",
+        role: "mode",
+        type: "switch",
+        meaning: "acknowledge that the profile offers writing tools",
+    },
+    { name: "--as-file", role: "mode", type: "switch", meaning: "send every file as a plain file to download" },
+    { name: "--background", role: "mode", type: "switch", meaning: "run as a job that outlives this command" },
+    {
+        name: "--base-url",
+        value: "<url>",
+        role: "mode",
+        type: "string",
+        meaning: "the address of an OpenAI-compatible model API",
+    },
+    { name: "--dims", value: "<n>", role: "mode", type: "count", meaning: "the embedding vector size" },
+    {
+        name: "--discover",
+        role: "mode",
+        type: "switch",
+        meaning: "also find partial matches; the results are evidence, not answers",
+    },
+    {
+        name: "--encrypt",
+        role: "mode",
+        type: "switch",
+        meaning: "compress and encrypt with a password that is never kept",
+    },
+    { name: "--exact", role: "mode", type: "switch", meaning: "bare words and quotes match their exact form only" },
+    {
+        name: "--fingerprint",
+        value: "<hash>",
+        role: "mode",
+        type: "string",
+        meaning: "refuse if the plan it names has changed",
+    },
+    {
+        name: "--for-everyone",
+        role: "mode",
+        type: "switch",
+        meaning: "delete for everyone in the chat, not only for the owner",
+    },
+    { name: "--http", role: "mode", type: "switch", meaning: "serve over HTTP on 127.0.0.1" },
+    { name: "--language", value: "<lucene|legacy>", role: "mode", type: "choice", meaning: "the query language" },
+    { name: "--local", role: "mode", type: "switch", meaning: "use the model on this machine, never the source" },
+    {
+        name: "--max-age",
+        value: "<duration>",
+        role: "mode",
+        type: "duration",
+        meaning: "how old a stored snapshot may be and still count as fresh",
+    },
+    { name: "--md", role: "mode", type: "switch", meaning: "the text is the messenger's Markdown" },
+    { name: "--no-backup", role: "mode", type: "switch", meaning: "do not back the file up before deleting it" },
+    { name: "--no-input", role: "mode", type: "switch", meaning: "never prompt or open an interactive login" },
+    { name: "--no-preview", role: "mode", type: "switch", meaning: "no preview card for a link in the text" },
+    {
+        name: "--no-record",
+        role: "mode",
+        type: "switch",
+        meaning: "do not keep this run, whatever the configuration says",
+    },
+    { name: "--no-registries", role: "mode", type: "switch", meaning: "do not ask the public ban lists" },
+    { name: "--notify", role: "mode", type: "switch", meaning: "tell the chat's members about it" },
+    { name: "--offline", role: "mode", type: "switch", meaning: "answer from what was recorded and never connect" },
+    { name: "--port", value: "<port>", role: "mode", type: "number", meaning: "the local port for --http" },
+    {
+        name: "--public-url",
+        value: "<url>",
+        role: "mode",
+        type: "string",
+        meaning: "the public https address of the tunnel",
+    },
+    {
+        name: "--record",
+        role: "mode",
+        type: "switch",
+        meaning: "keep this run under runs: ids and timings, never content",
+    },
+    { name: "--regex", role: "mode", type: "switch", meaning: "the words are one regular expression" },
+    {
+        name: "--send-id",
+        value: "<id>",
+        role: "mode",
+        type: "id",
+        meaning: "identify a send attempt, so a retry reuses it",
+    },
+    { name: "--silent", role: "mode", type: "switch", meaning: "deliver without a notification" },
+    { name: "--thread", role: "mode", type: "switch", meaning: "the stored reply chain instead of time neighbours" },
+    {
+        name: "--timezone",
+        value: "<zone>",
+        role: "mode",
+        type: "string",
+        meaning: "the IANA timezone dates and times are read in",
+    },
+    {
+        name: "--yes",
+        role: "mode",
+        type: "switch",
+        meaning: "go ahead with the write without asking or previewing first",
+    },
+    { name: "--analyze", role: "action", type: "switch", meaning: "also analyze with the configured provider" },
+    { name: "--catch-up", role: "action", type: "switch", meaning: "prepare local search after this run" },
+    { name: "--extract", role: "action", type: "switch", meaning: "also read the text inside the files written" },
+    {
+        name: "--mark-read",
+        role: "action",
+        type: "switch",
+        meaning: "also mark the chat read up to the newest message shown; the other person sees it",
+    },
+    { name: "--no-catch-up", role: "action", type: "switch", meaning: "skip local preparation after this run" },
+    { name: "--retract", role: "action", type: "switch", meaning: "take the owner's vote back" },
+    { name: "--revoke", role: "action", type: "switch", meaning: "forget every login given to a browser app" },
+    { name: "--track", role: "action", type: "switch", meaning: "also do it daily while serve runs" },
+    {
+        name: "--transcribe",
+        role: "action",
+        type: "switch",
+        meaning: "also transcribe voice messages not transcribed yet, on this machine",
+    },
+    {
+        name: "--catch-up-chunks",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "at most this many chunks prepared after the run",
+        unit: "chunks",
+    },
+    {
+        name: "--catch-up-messages",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "skip the graph rebuild above this many messages",
+        unit: "messages",
+    },
+    {
+        name: "--concurrency",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "requests to the source at once",
+        unit: "requests",
+    },
+    {
+        name: "--deep",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "also check the top n in full, one a second",
+        unit: "people",
+    },
+    {
+        name: "--max-actions",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "at most this many actions in one run",
+        unit: "actions",
+    },
+    {
+        name: "--max-chats",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "at most this many chats in one run",
+        unit: "chats",
+    },
+    {
+        name: "--max-chunks",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "at most this many chunks in one run",
+        unit: "chunks",
+    },
+    {
+        name: "--max-gaps",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "at most this many gaps repaired in one run",
+        unit: "gaps",
+    },
+    {
+        name: "--max-input-bytes",
+        value: "<bytes>",
+        role: "budget",
+        type: "count",
+        meaning: "at most this many bytes of buffered stdin",
+        unit: "bytes",
+    },
+    {
+        name: "--max-messages",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "at most this many messages in one run",
+        unit: "messages",
+    },
+    {
+        name: "--max-replies",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "at most this many replies read",
+        unit: "replies",
+    },
+    {
+        name: "--max-tokens",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "at most this many model tokens in one run",
+        unit: "tokens",
+    },
+    {
+        name: "--thread-bytes",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "at most this many bytes in each thread context",
+        unit: "bytes",
+    },
+    {
+        name: "--thread-hops",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "at most this many links from the hit",
+        unit: "links",
+    },
+    {
+        name: "--thread-messages",
+        value: "<n>",
+        role: "budget",
+        type: "count",
+        meaning: "at most this many messages in each thread context",
+        unit: "messages",
+    },
+    {
+        name: "--batch",
+        value: "<id>",
+        role: "target",
+        type: "id",
+        meaning: "the batch to act on, by the id that listed it",
+    },
+    {
+        name: "--component",
+        value: "<name>",
+        role: "target",
+        type: "string",
+        meaning: "the ranking component to read the evidence of",
+    },
+    {
+        name: "--counters",
+        value: "<names>",
+        role: "target",
+        type: "list",
+        meaning: "the counters to read: views, reactions, comments",
+    },
+    { name: "--failed", role: "target", type: "switch", meaning: "every chat whose newest job failed or died" },
+    { name: "--left", role: "target", type: "switch", meaning: "only the chats this account has left" },
+    { name: "--others", role: "target", type: "switch", meaning: "every session but this one" },
+    {
+        name: "--saved",
+        value: "<name|id>",
+        role: "target",
+        type: "string",
+        meaning: "run a saved search, or an earlier run by its id",
+    },
+    {
+        name: "--selection",
+        value: "<json>",
+        role: "target",
+        type: "string",
+        meaning: "the resolved ranking selection a drilldown returned",
+    },
+    {
+        name: "--add",
+        value: "<chat>",
+        role: "value",
+        type: "id",
+        meaning: "put this chat into the set being changed; repeat it for more",
+    },
+    { name: "--all-can-pin", value: "<on|off>", role: "value", type: "choice", meaning: "every member may pin messages" },
+    { name: "--anonymous", role: "value", type: "switch", meaning: "nobody sees who voted for what" },
+    {
+        name: "--approval",
+        role: "value",
+        type: "switch",
+        meaning: "who joins by the link asks first, and an admin lets them in",
+    },
+    { name: "--can", value: "<rights>", role: "value", type: "list", meaning: "what an admin may do, comma-separated" },
+    { name: "--channel", role: "value", type: "switch", meaning: "a channel instead of a group" },
+    {
+        name: "--closed",
+        value: "<on|off>",
+        role: "value",
+        type: "choice",
+        meaning: "close it to new messages, or reopen it",
+    },
+    { name: "--comment-to", value: "<post>", role: "value", type: "id", meaning: "comment on this channel post" },
+    { name: "--description", value: "<text>", role: "value", type: "string", meaning: "the new description" },
+    { name: "--expire-time", value: "<time>", role: "value", type: "time", meaning: "it stops working at this time" },
+    { name: "--first-name", value: "<name>", role: "value", type: "string", meaning: "the account's first name" },
+    { name: "--hidden", value: "<on|off>", role: "value", type: "choice", meaning: "hide it from the list, or show it" },
+    { name: "--last-name", value: "<name>", role: "value", type: "string", meaning: "the account's last name" },
+    {
+        name: "--max-uses",
+        value: "<n>",
+        role: "value",
+        type: "count",
+        meaning: "at most this many people join by it",
+        unit: "people",
+    },
+    {
+        name: "--members-see-link",
+        value: "<on|off>",
+        role: "value",
+        type: "choice",
+        meaning: "members may see the invite link",
+    },
+    { name: "--multiple", role: "value", type: "switch", meaning: "people may pick several answers" },
+    {
+        name: "--only-admins-add",
+        value: "<on|off>",
+        role: "value",
+        type: "choice",
+        meaning: "only admins may add members",
+    },
+    {
+        name: "--only-admins-call",
+        value: "<on|off>",
+        role: "value",
+        type: "choice",
+        meaning: "only admins may start a call",
+    },
+    {
+        name: "--only-owner-edits-info",
+        value: "<on|off>",
+        role: "value",
+        type: "choice",
+        meaning: "only the owner may change the name and photo",
+    },
+    {
+        name: "--photo",
+        value: "<file>",
+        role: "value",
+        type: "path",
+        meaning: "an image file: a profile or chat photo, or a photo to send",
+    },
+    {
+        name: "--pinned",
+        value: "<on|off>",
+        role: "value",
+        type: "choice",
+        meaning: "pin it at the top of the list, or unpin it",
+    },
+    {
+        name: "--remove",
+        value: "<chat>",
+        role: "value",
+        type: "id",
+        meaning: "take this chat out of the set being changed; repeat it for more",
+    },
+    {
+        name: "--reply-to",
+        value: "<message>",
+        role: "value",
+        type: "id",
+        meaning: "answer this message in the same chat",
+    },
+    { name: "--revote", role: "value", type: "switch", meaning: "people may change their vote" },
+    { name: "--send-as", value: "<id>", role: "value", type: "id", meaning: "send as this identity of the chat" },
+    {
+        name: "--voice",
+        value: "<file>",
+        role: "value",
+        type: "path",
+        meaning: "an Ogg Opus file sent as a voice message",
+    },
+    {
+        name: "--filter",
+        value: "<query>",
+        role: "query",
+        type: "string",
+        meaning: "a query every result must also match, beside the search's own words",
+    },
 ];
 /** The words every CLI on cli-base is judged against. Seeded from STANDARD's command-name rules and the glossary. */
 export const VOCABULARY = defineVocabulary({