tenbrains 2.1.0 → 2.3.0

package/AGENTS.md

@@ -46,10 +46,12 @@ Error envelope:
   inline strings, `@path` (read file), or `-` (read stdin). JSON inputs (`--posts`, `--ratings`) take
   the same forms. `takeaway refresh` fetches a timeline when `--posts` is omitted (needs an X token,
   usually a paid tier).
-- **Ids are prefixed and stable**: `post_`, `ana_`, `acc_`, `snap_`, `bm_`, `sug_`, `trk_`. Any id
+- **Ids are prefixed and stable**: `post_`, `ana_`, `acc_`, `snap_`, `bm_`, `sug_`, `trk_`, `obj_`. Any id
   resolves via `tenbrains record get <id>`.
 - **Dedup is automatic.** Re-ingesting a post with the same `--id` (external X id) reuses the stored
   post (`meta.deduped: true`).
+- **Objective tagging is explicit.** Repeat `--objective <slug>` on supported creation commands, or
+  use `objective link`; objectives must already exist. The current focus never adds tags.
 - **Isolate state with `--db <path>`** if you want a per-task workspace.
 - **No environment variables.** Configure once with `tenbrains setup --provider <p> --api-key <k>`
   (add `--x-bearer <token>` for X timeline fetches; `-` pipes a secret without echo). Or test offline
@@ -73,6 +75,21 @@ echo '[{"concept":"Agentic","familiarity":2,"interest":5}]' \
 | tenbrains analyze --provider mock --text "..." --learn --minutes 10 --ratings -
 ```
 
+Create and apply learning objectives (repeat `--objective` for multiple goals):
+
+```bash
+tenbrains objective add "Agentic systems" --focus
+tenbrains analyze --provider mock --text "..." --objective agentic-systems
+tenbrains objective link bm_... --objective agentic-systems
+tenbrains objective show agentic-systems
+```
+
+Objective descriptions lens learning-track concept order through deterministic token overlap. For
+multiple described objectives, use the maximum overlap against any one description. Read
+`objective show`'s raw progress counts; do not derive or present a made-up completion percentage.
+The current focus also biases `suggest generate` when it has a description, but never tags.
+Use `search --objective <slug>` or `digest --objective <slug>` for explicit scoped output.
+
 Account takeaways (supply recent posts, or fetch from X with a token):
 
 ```bash
@@ -85,7 +102,7 @@ tenbrains takeaway show levelsio --history
 Suggestion feedback loop:
 
 ```bash
-tenbrains suggest generate                 # ranks analyzed, un-bookmarked posts vs your saved signal
+tenbrains suggest generate                 # saved-signal ranking + described current-focus bias
 tenbrains suggest save sug_...             # -> creates a bookmark (meta.bookmarkId)
 tenbrains suggest dismiss sug_...          # -> suppressed in future ranking
 ```

package/README.md

@@ -1,6 +1,6 @@
 # tenbrains
 
-An **agent-first** CLI for X research. It analyzes posts, tracks followed accounts, surfaces
+An **agent-first** CLI for X and YouTube research. It analyzes posts and video transcripts, tracks followed accounts, surfaces
 suggestions, and **persists every outcome to a local SQLite database** — all from the command line,
 with no `.env` files and no hosted backend.
 
@@ -21,8 +21,8 @@ machine-readable code and a deterministic exit status, and the entire surface is
   error codes, and exit codes as JSON — an agent can discover the whole tool in one call.
 - **Non-interactive.** No blocking prompts. Content comes in via flags, `@file`, or `-` (stdin);
   credentials are collected through commands, never by hand-editing a dotfile.
-- **Everything persisted.** Posts, analyses, takeaways, bookmarks, suggestions, and learning tracks
-  all land in one local SQLite file you can point anywhere with `--db`.
+- **Everything persisted.** Posts, analyses, takeaways, bookmarks, suggestions, learning tracks,
+  and learning objectives all land in one local SQLite file you can point anywhere with `--db`.
 - **Offline-capable.** The built-in `mock` provider produces deterministic analysis with no network,
   so agents and CI can exercise the full pipeline without API keys.
 
@@ -32,6 +32,13 @@ machine-readable code and a deterministic exit status, and the entire surface is
 
 ## Install
 
+```bash
+npm install -g tenbrains               # from npm — puts `tenbrains` (and `tb`) on PATH
+tenbrains --help
+```
+
+Or from a clone:
+
 ```bash
 npm install
 npm run build
@@ -58,6 +65,9 @@ tenbrains analyze --author levelsio --id 1790000000000000000 \
 # 2b. Or analyze a tweet by URL — fetched free via X's oEmbed endpoint, no key needed.
 tenbrains analyze --url "https://x.com/jack/status/20"
 
+# 2c. Or fetch and analyze public YouTube captions, then add a narrative digest and study plan.
+tenbrains analyze --url "https://www.youtube.com/watch?v=M7lc1UVf-VE" --summarize --learn
+
 # 3. Read it back / explore.
 tenbrains analyze list --limit 5
 tenbrains search "agent cli"
@@ -101,15 +111,16 @@ Exit codes: `0` success · `2` usage · `3` not found · `4` missing credentials
 
 | Command | Purpose |
 | --- | --- |
-| `analyze` | Analyze a post (`--text`, or `--url`/`--id` to fetch) into topic, summary, intent, 5 novel concepts. `--thread` analyzes a whole thread as one document; `--learn` also builds a track. |
+| `analyze` | Analyze a post or YouTube transcript (`--text`, `--transcript`, or `--url` to fetch) into topic, summary, intent, and concepts. `--summarize` adds a narrative digest; `--learn` builds a track. |
 | `analyze list` / `analyze get <id>` | Read stored analyses. |
+| `objective add\|list\|show\|focus\|archive\|link\|unlink` | Manage first-class learning goals, one optional current focus, and explicit record tags. |
 | `takeaway follow\|unfollow\|list\|refresh\|show` | Track accounts; summarize recent posts (supplied via `--posts` or fetched from X) into snapshots. |
-| `suggest generate\|list\|save\|dismiss\|add` | Rank un-saved posts against your saved signal; save/dismiss feedback. |
+| `suggest generate\|list\|save\|dismiss\|add` | Rank un-saved posts against your saved signal, biased toward a described current objective focus; save/dismiss feedback. |
 | `bookmark add\|list\|show\|tag\|remove` | Save posts with tags (auto-suggested from analysis) and notes. |
 | `learn generate\|today\|done\|show\|list` | Build 7-day Feynman learning tracks, get today's task, and check off progress. |
-| `search <query>` | Full-text search (SQLite FTS5, BM25-ranked, stemmed) across analyses, takeaways, and bookmarks. |
+| `search <query>` | Full-text search (SQLite FTS5, BM25-ranked, stemmed) across analyses, takeaways, and bookmarks; optionally filter by objective. |
 | `import x-archive <path>` | Bulk-import your extracted official X archive: likes become bookmarked posts, your tweets become posts. Free, idempotent. |
-| `digest [--days N]` | Markdown recap of analyses, takeaways, and bookmarks saved in the window (default 7 days). |
+| `digest [--days N]` | Markdown recap of analyses, takeaways, and bookmarks saved in the window (default 7 days), optionally filtered by objective. |
 | `setup` / `config set\|get\|list\|unset\|path` | Collect and manage provider credentials and defaults. |
 | `record get <id>` | Resolve any record by its prefixed id (`post_`, `ana_`, `acc_`, ...). |
 | `db stats\|migrate\|vacuum\|reindex\|reset` | Inspect and maintain the database. |
@@ -125,6 +136,78 @@ echo "long post text..." | tenbrains analyze --provider mock --text -
 tenbrains takeaway refresh levelsio --provider mock --posts @recent.json
 ```
 
+## Learning objectives
+
+Objectives are persistent learning goals, separate from loose bookmark tags. Each objective has a
+name, derived slug, optional description, active/archived lifecycle, and tagged-record counts.
+You can keep several active objectives while marking at most one as the current focus:
+
+```bash
+tenbrains objective add "Stablecoins" \
+  --description "Understand reserve models, settlement, and failure modes." --focus
+tenbrains objective add "AI agents"
+tenbrains objective list
+tenbrains objective show                 # defaults to the current focus
+tenbrains objective focus ai-agents
+tenbrains objective focus --clear
+tenbrains objective link post_... --objective stablecoins
+tenbrains objective unlink post_... --objective stablecoins
+tenbrains objective archive stablecoins
+```
+
+Tag at creation time with a repeatable `--objective` flag:
+
+```bash
+tenbrains analyze --provider mock --text "..." \
+  --objective stablecoins --objective ai-agents
+tenbrains takeaway follow levelsio --objective ai-agents
+tenbrains bookmark add --post-id post_... --objective stablecoins
+tenbrains learn generate --analysis ana_... --objective stablecoins
+tenbrains search "reserve risk" --objective stablecoins
+tenbrains digest --objective stablecoins
+```
+
+`bookmark add` tags the bookmark's post. Without an explicit `--objective`, `learn generate` inherits
+the objective tags on its source analysis' post; supplying the flag overrides that inheritance.
+Every referenced objective must already exist or the command returns `NOT_FOUND` without silently
+creating one. Focus never tags records automatically. `objective show` groups tagged posts,
+accounts, bookmarks, and tracks; `record get` includes an `objectives` array for linkable records.
+
+When a selected or inherited objective has a description, learning tracks rank concepts first by
+deterministic token overlap with that description, then by the existing interest and familiarity
+ratings. With multiple described objectives, a concept uses its highest overlap with any one
+description; matches are not summed across objectives. `objective show` also returns descriptive
+progress counts under `data.progress`:
+accounts followed, posts and transcripts analyzed, bookmarks saved, tracks completed, and learning
+days completed/total. It never fabricates a completion percentage.
+
+`suggest generate` adds deterministic token-overlap relevance from the current focus description to
+its existing saved-interest scores. With no focus or no usable focus description, its scores,
+reasons, and ordering are unchanged. This bias never creates objective links. `search` and `digest`
+accept one `--objective <slug>` filter and return only analyses whose posts, takeaways whose
+accounts, and bookmarks (directly or through their posts) are tagged to that objective. Unknown
+objectives return `NOT_FOUND`.
+
+## YouTube transcripts
+
+Pass a public YouTube watch, `youtu.be`, Shorts, or embed URL to `analyze`. tenbrains selects a
+caption track without an API key (manual before auto-generated; `--lang`, then English, then the
+first available), stores the transcript and video metadata with the post, and runs the normal
+analysis pipeline:
+
+```bash
+tenbrains analyze --url "https://youtu.be/M7lc1UVf-VE" --lang en
+tenbrains analyze --url "https://youtu.be/M7lc1UVf-VE" --summarize --learn
+tenbrains analyze --url "https://youtu.be/M7lc1UVf-VE" --transcript @captions.txt
+```
+
+`--summarize` returns `{ summary, keyPoints[] }` under `data.summary`, persists it in the post's
+`raw` metadata, and uses that digest as the condensed input for concept extraction. It composes
+with `--learn`. If a video is unavailable or has no captions, supply an existing transcript with
+`--transcript <text|@file|->`. v1 is caption-only: it does not download audio or invoke Whisper.
+YouTube's WEB caption URLs can return empty bodies, so the client retries through the embedded
+Android player API; that undocumented client version is the primary maintenance surface.
+
 ## Configuration & credentials
 
 There is **no `.env`**. The CLI owns credential collection:
@@ -172,8 +255,9 @@ If your tier can't read a tweet/timeline, the CLI returns a structured `PROVIDER
 
 A single SQLite file (default `~/.local/share/tenbrains/tenbrains.db`, override with `--db`). Schema
 is versioned and migrated automatically on open. Tables: `posts`, `analyses`, `accounts`,
-`takeaway_snapshots`, `bookmarks`, `suggestions`, `learning_tracks`, plus a trigger-maintained
-FTS5 index (`search_fts`) behind `search` — rebuild it anytime with `tenbrains db reindex`.
+`takeaway_snapshots`, `bookmarks`, `suggestions`, `learning_tracks`, `track_progress`, `objectives`,
+and `objective_links`, plus a trigger-maintained FTS5 index (`search_fts`) behind `search` — rebuild
+it anytime with `tenbrains db reindex`.
 
 ```bash
 tenbrains --db ./research.db analyze --provider mock --text "..."   # isolate a workspace

package/dist/ai/analyzer.d.ts

@@ -1,4 +1,4 @@
-import { type AnalysisResult, type TakeawayResult } from "../domain/schemas.js";
+import { type AnalysisResult, type SummaryResult, type TakeawayResult } from "../domain/schemas.js";
 import type { ResolvedProvider } from "./resolve.js";
 export interface AnalysisOutcome {
     result: AnalysisResult;
@@ -10,7 +10,12 @@ export interface PostForAnalysis {
     authorName?: string | undefined;
     url?: string | undefined;
 }
-export declare function analyzePost(resolved: ResolvedProvider, post: PostForAnalysis): Promise<AnalysisOutcome>;
+export declare function analyzePost(resolved: ResolvedProvider, post: PostForAnalysis, kind?: "tweet" | "transcript"): Promise<AnalysisOutcome>;
+export interface SummaryOutcome {
+    result: SummaryResult;
+    mock: boolean;
+}
+export declare function summarizeContent(resolved: ResolvedProvider, content: string): Promise<SummaryOutcome>;
 export interface TakeawayOutcome {
     result: TakeawayResult;
     mock: boolean;

package/dist/ai/analyzer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/ai/analyzer.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,cAAc,EAEpB,MAAM,sBAAsB,CAAC;AAU9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,eAAe,CAAC,CAkB1B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE;IACL,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IACzD,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CAC/D,GACA,OAAO,CAAC,eAAe,CAAC,CAkB1B"}
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/ai/analyzer.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,aAAa,EAElB,KAAK,cAAc,EAEpB,MAAM,sBAAsB,CAAC;AAY9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,eAAe,EACrB,IAAI,GAAE,OAAO,GAAG,YAAsB,GACrC,OAAO,CAAC,eAAe,CAAC,CAkB1B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,CAAC,CAkBzB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE;IACL,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IACzD,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CAC/D,GACA,OAAO,CAAC,eAAe,CAAC,CAkB1B"}

package/dist/ai/analyzer.js

@@ -1,10 +1,10 @@
 import { parseOrThrow } from "../core/validate.js";
-import { AnalysisResultSchema, TakeawayResultSchema, } from "../domain/schemas.js";
+import { AnalysisResultSchema, SummaryResultSchema, TakeawayResultSchema, } from "../domain/schemas.js";
 import { complete } from "./client.js";
 import { extractJsonObject } from "./json.js";
-import { mockAnalysis, mockTakeaway } from "./mock.js";
-import { accountTakeawaySystemPrompt, accountTakeawayUserPrompt, tweetAnalysisSystemPrompt, tweetAnalysisUserPrompt, } from "./prompts.js";
-export async function analyzePost(resolved, post) {
+import { mockAnalysis, mockSummary, mockTakeaway } from "./mock.js";
+import { accountTakeawaySystemPrompt, accountTakeawayUserPrompt, contentSummarySystemPrompt, contentSummaryUserPrompt, tweetAnalysisSystemPrompt, tweetAnalysisUserPrompt, } from "./prompts.js";
+export async function analyzePost(resolved, post, kind = "tweet") {
     if (resolved.provider === "mock") {
         return { result: mockAnalysis(post.text), mock: true };
     }
@@ -12,12 +12,26 @@ export async function analyzePost(resolved, post) {
         provider: resolved.provider,
         model: resolved.model,
         apiKey: resolved.apiKey,
-        system: tweetAnalysisSystemPrompt(),
+        system: tweetAnalysisSystemPrompt(kind),
         user: tweetAnalysisUserPrompt(post),
     });
     const result = parseOrThrow(AnalysisResultSchema, extractJsonObject(text), "Provider response did not match the expected analysis shape.", "PROVIDER_BAD_OUTPUT");
     return { result, mock: false };
 }
+export async function summarizeContent(resolved, content) {
+    if (resolved.provider === "mock") {
+        return { result: mockSummary(content), mock: true };
+    }
+    const text = await complete({
+        provider: resolved.provider,
+        model: resolved.model,
+        apiKey: resolved.apiKey,
+        system: contentSummarySystemPrompt(),
+        user: contentSummaryUserPrompt(content),
+    });
+    const result = parseOrThrow(SummaryResultSchema, extractJsonObject(text), "Provider response did not match the expected summary shape.", "PROVIDER_BAD_OUTPUT");
+    return { result, mock: false };
+}
 export async function summarizeAccount(resolved, input) {
     if (resolved.provider === "mock") {
         return { result: mockTakeaway(input.posts), mock: true };

package/dist/ai/analyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyzer.js","sourceRoot":"","sources":["../../src/ai/analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAEL,oBAAoB,EAEpB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAetB,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAA0B,EAC1B,IAAqB;IAErB,IAAI,QAAQ,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QACjC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACzD,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC;QAC1B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAgB;QACjC,MAAM,EAAE,yBAAyB,EAAE;QACnC,IAAI,EAAE,uBAAuB,CAAC,IAAI,CAAC;KACpC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,YAAY,CACzB,oBAAoB,EACpB,iBAAiB,CAAC,IAAI,CAAC,EACvB,8DAA8D,EAC9D,qBAAqB,CACtB,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACjC,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAA0B,EAC1B,KAGC;IAED,IAAI,QAAQ,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QACjC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC3D,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC;QAC1B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAgB;QACjC,MAAM,EAAE,2BAA2B,EAAE;QACrC,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC;KACvC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,YAAY,CACzB,oBAAoB,EACpB,iBAAiB,CAAC,IAAI,CAAC,EACvB,8DAA8D,EAC9D,qBAAqB,CACtB,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACjC,CAAC"}
+{"version":3,"file":"analyzer.js","sourceRoot":"","sources":["../../src/ai/analyzer.ts"],"names":[],"mappings":"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"}

package/dist/ai/mock.d.ts

@@ -1,5 +1,6 @@
-import type { AnalysisResult, TakeawayResult } from "../domain/schemas.js";
+import type { AnalysisResult, SummaryResult, TakeawayResult } from "../domain/schemas.js";
 export declare function mockAnalysis(text: string): AnalysisResult;
+export declare function mockSummary(text: string): SummaryResult;
 export declare function mockTakeaway(posts: Array<{
     text: string;
 }>): TakeawayResult;

package/dist/ai/mock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/ai/mock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAsC3E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAsBzD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,cAAc,CAgB3E"}
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/ai/mock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAsC1F,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAsBzD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAWvD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,cAAc,CAgB3E"}

package/dist/ai/mock.js

@@ -49,6 +49,18 @@ export function mockAnalysis(text) {
     });
     return { topic, summary, intent, novelConcepts };
 }
+export function mockSummary(text) {
+    const sentences = text
+        .trim()
+        .split(/(?<=[.!?])\s+/)
+        .filter(Boolean);
+    const summary = (sentences.slice(0, 4).join(" ") || firstSentence(text)).slice(0, 1200);
+    const terms = significantTerms(text, 5);
+    const keyPoints = terms.length
+        ? terms.map((term) => `${titleCase(term)} is a recurring theme in the content.`)
+        : ["The supplied content does not contain enough detail for additional key points."];
+    return { summary, keyPoints };
+}
 export function mockTakeaway(posts) {
     const combined = posts.map((p) => p.text).join("\n");
     const terms = significantTerms(combined, 6);

package/dist/ai/mock.js.map

@@ -1 +1 @@
-{"version":3,"file":"mock.js","sourceRoot":"","sources":["../../src/ai/mock.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../../src/ai/mock.ts"],"names":[],"mappings":"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"}

package/dist/ai/prompts.d.ts

@@ -1,4 +1,6 @@
-export declare function tweetAnalysisSystemPrompt(): string;
+export declare function tweetAnalysisSystemPrompt(kind?: "tweet" | "transcript"): string;
+export declare function contentSummarySystemPrompt(): string;
+export declare function contentSummaryUserPrompt(content: string): string;
 export declare function tweetAnalysisUserPrompt(post: {
     text: string;
     authorUsername?: string | undefined;

package/dist/ai/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/ai/prompts.ts"],"names":[],"mappings":"AAWA,wBAAgB,yBAAyB,IAAI,MAAM,CAUlD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,GAAG,MAAM,CAET;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAUpD;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IACzD,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CAC/D,GAAG,MAAM,CAST"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/ai/prompts.ts"],"names":[],"mappings":"AAWA,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,OAAO,GAAG,YAAsB,GAAG,MAAM,CAYxF;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CASnD;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,GAAG,MAAM,CAET;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAUpD;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IACzD,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CAC/D,GAAG,MAAM,CAST"}

package/dist/ai/prompts.js

@@ -6,9 +6,11 @@ function compactPost(post) {
         url: post.url ?? null,
     };
 }
-export function tweetAnalysisSystemPrompt() {
+export function tweetAnalysisSystemPrompt(kind = "tweet") {
     return [
-        "You are analyzing a post on X.",
+        kind === "transcript"
+            ? "You are analyzing a video transcript."
+            : "You are analyzing a post on X.",
         "Return only a valid JSON object with exactly these keys: topic, summary, intent, novelConcepts.",
         "novelConcepts must be an array with exactly 5 objects.",
         "Each concept object must have keys: name and whyItMattersInTweet.",
@@ -17,6 +19,19 @@ export function tweetAnalysisSystemPrompt() {
         "Keep it factual and avoid speculation when evidence is missing.",
     ].join(" ");
 }
+export function contentSummarySystemPrompt() {
+    return [
+        "You are summarizing long-form content.",
+        "Return only a valid JSON object with exactly these keys: summary, keyPoints.",
+        "summary must be a substantive, readable multi-paragraph string.",
+        "keyPoints must be an array of non-empty strings.",
+        "Stay factual and grounded in the supplied content.",
+        "Do not include markdown fences, comments, or extra keys.",
+    ].join(" ");
+}
+export function contentSummaryUserPrompt(content) {
+    return JSON.stringify({ content }, null, 2);
+}
 export function tweetAnalysisUserPrompt(post) {
     return JSON.stringify({ post: compactPost(post) }, null, 2);
 }

package/dist/ai/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/ai/prompts.ts"],"names":[],"mappings":"AAEA,SAAS,WAAW,CAAC,IAAqE;IACxF,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;QAC3C,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI;QACnC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,gCAAgC;QAChC,iGAAiG;QACjG,wDAAwD;QACxD,mEAAmE;QACnE,kFAAkF;QAClF,0DAA0D;QAC1D,iEAAiE;KAClE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAKvC;IACC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,mEAAmE;QACnE,8EAA8E;QAC9E,qCAAqC;QACrC,2DAA2D;QAC3D,yEAAyE;QACzE,oDAAoD;QACpD,0DAA0D;KAC3D,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAGzC;IACC,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE;QAC/E,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;KAChF,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/ai/prompts.ts"],"names":[],"mappings":"AAEA,SAAS,WAAW,CAAC,IAAqE;IACxF,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;QAC3C,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI;QACnC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAA+B,OAAO;IAC9E,OAAO;QACL,IAAI,KAAK,YAAY;YACnB,CAAC,CAAC,uCAAuC;YACzC,CAAC,CAAC,gCAAgC;QACpC,iGAAiG;QACjG,wDAAwD;QACxD,mEAAmE;QACnE,kFAAkF;QAClF,0DAA0D;QAC1D,iEAAiE;KAClE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,wCAAwC;QACxC,8EAA8E;QAC9E,iEAAiE;QACjE,kDAAkD;QAClD,oDAAoD;QACpD,0DAA0D;KAC3D,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAKvC;IACC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,mEAAmE;QACnE,8EAA8E;QAC9E,qCAAqC;QACrC,2DAA2D;QAC3D,yEAAyE;QACzE,oDAAoD;QACpD,0DAA0D;KAC3D,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAGzC;IACC,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE;QAC/E,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;KAChF,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AA2KpD,wBAAgB,YAAY,IAAI,OAAO,CA4ftC;AAED,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBvD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AA6LpD,wBAAgB,YAAY,IAAI,OAAO,CAinBtC;AAED,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBvD"}

package/dist/cli.js

@@ -8,6 +8,7 @@ import { digestCommand } from "./commands/digest.js";
 import { importXArchiveCommand } from "./commands/import.js";
 import { learnDoneCommand, learnGenerateCommand, learnListCommand, learnShowCommand, learnTodayCommand, } from "./commands/learn.js";
 import { manifestCommand } from "./commands/manifest.js";
+import { objectiveAddCommand, objectiveArchiveCommand, objectiveFocusCommand, objectiveLinkCommand, objectiveListCommand, objectiveShowCommand, objectiveUnlinkCommand, } from "./commands/objective.js";
 import { recordGetCommand } from "./commands/record.js";
 import { searchCommand } from "./commands/search.js";
 import { suggestAddCommand, suggestDismissCommand, suggestGenerateCommand, suggestListCommand, suggestSaveCommand, } from "./commands/suggest.js";
@@ -92,7 +93,12 @@ function makeCommand(reg) {
         cmd.argument(arg.spec, arg.description ?? "");
     }
     for (const option of reg.options ?? []) {
-        cmd.option(option.flags, option.description);
+        if (option.repeatable) {
+            cmd.option(option.flags, option.description, (value, previous) => [...previous, value], []);
+        }
+        else {
+            cmd.option(option.flags, option.description);
+        }
     }
     for (const negation of reg.negations ?? []) {
         cmd.option(negation.flags, negation.description);
@@ -117,7 +123,7 @@ export function buildProgram() {
     const program = new Command();
     program
         .name("tenbrains")
-        .description("Agent-first CLI for X research: analyze posts, track accounts, surface suggestions, and persist every outcome to a local SQLite database.")
+        .description("Agent-first CLI for X and YouTube research: analyze content and persist every outcome to a local SQLite database.")
         .version(readVersion(), "-v, --version")
         .exitOverride()
         .configureOutput({ writeErr: () => { } });
@@ -125,13 +131,25 @@ export function buildProgram() {
     // --- analyze --------------------------------------------------------------
     const analyze = makeCommand({
         name: "analyze",
-        description: "Analyze a post into topic, summary, intent, and 5 novel concepts.",
+        description: "Analyze a post or YouTube transcript into topic, summary, intent, and concepts.",
         options: [
             ...POST_INPUT_OPTIONS,
             {
                 flags: "--thread [json]",
                 description: "Analyze a whole thread as one document: pass parts as JSON (@file/- ok), or bare with --url/--id to fetch the author's self-thread via the X API",
             },
+            {
+                flags: "--transcript <text>",
+                description: "Video transcript; @file reads a file, - reads stdin",
+            },
+            {
+                flags: "--lang <code>",
+                description: "Preferred YouTube caption language (then English, then first available)",
+            },
+            {
+                flags: "--summarize",
+                description: "Also generate and persist a fuller narrative summary with key points",
+            },
             {
                 flags: "--fetch <mode>",
                 description: "With --url/--id and no --text: auto|oembed|api (default auto, free-first)",
@@ -141,6 +159,11 @@ export function buildProgram() {
                 description: "X API Bearer token for --fetch api/fallback; - reads stdin",
             },
             ...PROVIDER_OPTIONS,
+            {
+                flags: "--objective <slug>",
+                description: "Tag the resulting post; repeat for multiple existing objectives",
+                repeatable: true,
+            },
             { flags: "--learn", description: "Also generate a 7-day Feynman learning track" },
             { flags: "--ratings <json>", description: "Concept ratings JSON for --learn (@file/- ok)" },
             { flags: "--minutes <n>", description: "Minutes per day for --learn (default 10)" },
@@ -176,7 +199,14 @@ export function buildProgram() {
         name: "follow",
         description: "Follow an account for takeaway tracking.",
         args: [{ spec: "<username>", description: "X username (with or without @)" }],
-        options: [{ flags: "--name <name>", description: "Display name" }],
+        options: [
+            { flags: "--name <name>", description: "Display name" },
+            {
+                flags: "--objective <slug>",
+                description: "Tag the followed account; repeat for multiple existing objectives",
+                repeatable: true,
+            },
+        ],
         handler: takeawayFollowCommand,
     }));
     takeaway.addCommand(makeCommand({
@@ -232,7 +262,7 @@ export function buildProgram() {
     });
     suggest.addCommand(makeCommand({
         name: "generate",
-        description: "Regenerate pending suggestions from the local corpus.",
+        description: "Regenerate suggestions, biased by the described current objective focus.",
         options: [{ flags: "--limit <n>", description: "Max suggestions returned (default 10)" }],
         handler: suggestGenerateCommand,
     }));
@@ -289,6 +319,11 @@ export function buildProgram() {
             { flags: "--tags <list>", description: "Comma-separated tags" },
             { flags: "--note <note>", description: "Freeform note" },
             { flags: "--source <source>", description: "Source label (default cli)" },
+            {
+                flags: "--objective <slug>",
+                description: "Tag the bookmarked post; repeat for multiple existing objectives",
+                repeatable: true,
+            },
         ],
         negations: [{ flags: "--no-auto-tags", description: "Disable automatic tag suggestion" }],
         handler: bookmarkAddCommand,
@@ -337,11 +372,16 @@ export function buildProgram() {
     });
     learn.addCommand(makeCommand({
         name: "generate",
-        description: "Build a learning track from an analysis' concepts.",
+        description: "Build a learning track, lensed by any selected objective descriptions.",
         options: [
             { flags: "--analysis <id>", description: "Analysis id to build from" },
             { flags: "--ratings <json>", description: "Concept ratings JSON (@file/- ok)" },
             { flags: "--minutes <n>", description: "Minutes per day (default 10)" },
+            {
+                flags: "--objective <slug>",
+                description: "Tag the track; repeat to override inherited objectives",
+                repeatable: true,
+            },
         ],
         handler: learnGenerateCommand,
     }));
@@ -377,6 +417,69 @@ export function buildProgram() {
         handler: learnListCommand,
     }));
     program.addCommand(learn);
+    // --- objective ------------------------------------------------------------
+    const objective = makeCommand({
+        name: "objective",
+        description: "Manage first-class learning objectives and the current focus.",
+        handler: () => {
+            throw new CliError("USAGE", "Specify a subcommand: add|list|show|focus|archive|link|unlink.");
+        },
+    });
+    objective.addCommand(makeCommand({
+        name: "add",
+        description: "Create a learning objective; its kebab-case slug is derived from the name.",
+        args: [{ spec: "<name>", description: "Objective name" }],
+        options: [
+            { flags: "--description <text>", description: "Fuller statement of the learning goal" },
+            { flags: "--focus", description: "Make this objective the current focus" },
+        ],
+        handler: objectiveAddCommand,
+    }));
+    objective.addCommand(makeCommand({
+        name: "list",
+        description: "List objectives with tagged counts and the current-focus marker.",
+        options: [
+            {
+                flags: "--status <status>",
+                description: "Filter active|archived|all (default active)",
+            },
+        ],
+        handler: objectiveListCommand,
+    }));
+    objective.addCommand(makeCommand({
+        name: "show",
+        description: "Show an objective, tagged records, and descriptive progress (defaults to the current focus).",
+        args: [{ spec: "[slug]", description: "Objective slug or obj_ id" }],
+        handler: objectiveShowCommand,
+    }));
+    objective.addCommand(makeCommand({
+        name: "focus",
+        description: "Set or clear the one current objective focus.",
+        args: [{ spec: "[slug]", description: "Active objective slug or obj_ id" }],
+        options: [{ flags: "--clear", description: "Clear the current focus" }],
+        handler: objectiveFocusCommand,
+    }));
+    objective.addCommand(makeCommand({
+        name: "archive",
+        description: "Archive an objective while preserving its record links.",
+        args: [{ spec: "<slug>", description: "Objective slug or obj_ id" }],
+        handler: objectiveArchiveCommand,
+    }));
+    objective.addCommand(makeCommand({
+        name: "link",
+        description: "Tag an existing post, account, bookmark, or track with an objective.",
+        args: [{ spec: "<recordId>", description: "Existing post_, acc_, bm_, or trk_ id" }],
+        options: [{ flags: "--objective <slug>", description: "Existing objective slug or obj_ id" }],
+        handler: objectiveLinkCommand,
+    }));
+    objective.addCommand(makeCommand({
+        name: "unlink",
+        description: "Remove an objective tag from an existing record.",
+        args: [{ spec: "<recordId>", description: "Existing post_, acc_, bm_, or trk_ id" }],
+        options: [{ flags: "--objective <slug>", description: "Existing objective slug or obj_ id" }],
+        handler: objectiveUnlinkCommand,
+    }));
+    program.addCommand(objective);
     // --- search ---------------------------------------------------------------
     program.addCommand(makeCommand({
         name: "search",
@@ -385,6 +488,7 @@ export function buildProgram() {
         options: [
             { flags: "--type <list>", description: "Limit types: analysis,takeaway,bookmark (or all)" },
             { flags: "--limit <n>", description: "Max hits per type (default 10)" },
+            { flags: "--objective <slug>", description: "Only records tagged with this objective" },
         ],
         handler: searchCommand,
     }));
@@ -392,7 +496,10 @@ export function buildProgram() {
     program.addCommand(makeCommand({
         name: "digest",
         description: "Markdown recap of analyses, takeaways, and bookmarks saved recently.",
-        options: [{ flags: "--days <n>", description: "Window in days (default 7)" }],
+        options: [
+            { flags: "--days <n>", description: "Window in days (default 7)" },
+            { flags: "--objective <slug>", description: "Only records tagged with this objective" },
+        ],
         handler: digestCommand,
     }));
     // --- import ---------------------------------------------------------------
@@ -479,7 +586,7 @@ export function buildProgram() {
     });
     record.addCommand(makeCommand({
         name: "get",
-        description: "Fetch any record by id (post_/ana_/acc_/snap_/bm_/sug_/trk_).",
+        description: "Fetch any record by id, including obj_, with its objective tags.",
         args: [{ spec: "<id>" }],
         handler: recordGetCommand,
     }));