tenbrains 2.1.0

package/dist/commands/digest.d.ts

@@ -0,0 +1,19 @@
+import type { RunContext } from "../core/context.js";
+import { type Opts } from "../core/opts.js";
+import type { CommandResult } from "../core/output.js";
+import type { Store } from "../db/repositories.js";
+interface DigestData {
+    since: string;
+    days: number;
+    counts: {
+        analyses: number;
+        takeaways: number;
+        bookmarks: number;
+    };
+    markdown: string;
+}
+/** A markdown recap of everything saved in the window — the tool's "output side". */
+export declare function buildDigest(store: Store, days: number, now: Date): DigestData;
+export declare function digestCommand(ctx: RunContext, opts: Opts): CommandResult;
+export {};
+//# sourceMappingURL=digest.d.ts.map

package/dist/commands/digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../src/commands/digest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,KAAK,IAAI,EAAa,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,UAAU,CA6D7E;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,aAAa,CAWxE"}

package/dist/commands/digest.js

@@ -0,0 +1,71 @@
+import { optNumber } from "../core/opts.js";
+function snippet(text, max = 120) {
+    const clean = text.replace(/\s+/g, " ").trim();
+    return clean.length > max ? `${clean.slice(0, max - 1)}…` : clean;
+}
+/** A markdown recap of everything saved in the window — the tool's "output side". */
+export function buildDigest(store, days, now) {
+    const since = new Date(now.getTime() - days * 86_400_000).toISOString();
+    const postsById = new Map(store.posts.all().map((p) => [p.id, p]));
+    const accountsById = new Map(store.accounts.list().map((a) => [a.id, a]));
+    const analyses = store.analyses.all().filter((a) => a.createdAt >= since);
+    const snapshots = store.snapshots.all().filter((s) => s.createdAt >= since);
+    const bookmarks = store.bookmarks.all().filter((b) => b.createdAt >= since);
+    const lines = [
+        `# tenbrains digest — last ${days} day${days === 1 ? "" : "s"}`,
+        "",
+        `_${analyses.length} analyses · ${snapshots.length} account takeaways · ${bookmarks.length} bookmarks since ${since.slice(0, 10)}_`,
+    ];
+    if (analyses.length > 0) {
+        lines.push("", "## Analyses", "");
+        for (const analysis of analyses) {
+            const post = postsById.get(analysis.postId);
+            const author = post?.authorUsername ? ` — @${post.authorUsername}` : "";
+            lines.push(`- **${analysis.topic}**${author}: ${snippet(analysis.summary)} \`${analysis.id}\``);
+        }
+    }
+    if (snapshots.length > 0) {
+        lines.push("", "## Account takeaways", "");
+        for (const snap of snapshots) {
+            const account = accountsById.get(snap.accountId);
+            lines.push(`- **@${account?.username ?? "account"}**: ${snippet(snap.summary)}`);
+            for (const takeaway of snap.takeaways.slice(0, 3)) {
+                lines.push(`  - ${snippet(takeaway, 100)}`);
+            }
+        }
+    }
+    if (bookmarks.length > 0) {
+        lines.push("", "## Bookmarks", "");
+        for (const bookmark of bookmarks) {
+            const post = postsById.get(bookmark.postId);
+            const tags = bookmark.tags.length > 0 ? ` ${bookmark.tags.map((t) => `#${t}`).join(" ")}` : "";
+            lines.push(`- ${snippet(post?.text ?? bookmark.note ?? "")}${tags} \`${bookmark.id}\``);
+        }
+    }
+    if (analyses.length + snapshots.length + bookmarks.length === 0) {
+        lines.push("", "Nothing saved in this window.");
+    }
+    return {
+        since,
+        days,
+        counts: {
+            analyses: analyses.length,
+            takeaways: snapshots.length,
+            bookmarks: bookmarks.length,
+        },
+        markdown: lines.join("\n"),
+    };
+}
+export function digestCommand(ctx, opts) {
+    const days = optNumber(opts, "days", 7);
+    const digest = buildDigest(ctx.store(), days, new Date());
+    return {
+        data: digest,
+        meta: {
+            days,
+            total: digest.counts.analyses + digest.counts.takeaways + digest.counts.bookmarks,
+        },
+        human: () => digest.markdown,
+    };
+}
+//# sourceMappingURL=digest.js.map

package/dist/commands/digest.js.map

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

package/dist/commands/import.d.ts

@@ -0,0 +1,11 @@
+import type { RunContext } from "../core/context.js";
+import { type Opts } from "../core/opts.js";
+import type { CommandResult } from "../core/output.js";
+/**
+ * Bulk-import the extracted official X account archive — the free path to
+ * real signal. Likes become posts + bookmarks (they feed the suggestion
+ * profile immediately); the account's own tweets become plain posts ready for
+ * analysis. Re-running is safe: everything dedupes on externalId.
+ */
+export declare function importXArchiveCommand(ctx: RunContext, opts: Opts): CommandResult;
+//# sourceMappingURL=import.d.ts.map

package/dist/commands/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,KAAK,IAAI,EAAqC,MAAM,iBAAiB,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,aAAa,CAuEhF"}

package/dist/commands/import.js

@@ -0,0 +1,78 @@
+import { optBool, optNumber, requireString } from "../core/opts.js";
+import { readArchive } from "../x/archive.js";
+/**
+ * Bulk-import the extracted official X account archive — the free path to
+ * real signal. Likes become posts + bookmarks (they feed the suggestion
+ * profile immediately); the account's own tweets become plain posts ready for
+ * analysis. Re-running is safe: everything dedupes on externalId.
+ */
+export function importXArchiveCommand(ctx, opts) {
+    const root = requireString(opts, "path", "<path>");
+    const store = ctx.store();
+    const limit = optNumber(opts, "limit", 0);
+    const wantLikes = optBool(opts, "likes") || !optBool(opts, "tweets");
+    const wantTweets = optBool(opts, "tweets") || !optBool(opts, "likes");
+    const bookmarkLikes = opts.bookmarks !== false; // --no-bookmarks opts out
+    const archive = readArchive(root);
+    const cap = (items) => (limit > 0 ? items.slice(0, limit) : items);
+    const counts = {
+        likesImported: 0,
+        bookmarksCreated: 0,
+        tweetsImported: 0,
+        deduped: 0,
+    };
+    store.transaction(() => {
+        if (wantLikes) {
+            for (const like of cap(archive.likes)) {
+                const { post, deduped } = store.posts.ingest({
+                    text: like.text,
+                    externalId: like.externalId,
+                    url: like.url,
+                });
+                if (deduped) {
+                    counts.deduped += 1;
+                }
+                else {
+                    counts.likesImported += 1;
+                }
+                if (bookmarkLikes && !store.bookmarks.findByPostId(post.id)) {
+                    store.bookmarks.create({ postId: post.id, tags: [], source: "x:archive" });
+                    counts.bookmarksCreated += 1;
+                }
+            }
+        }
+        if (wantTweets) {
+            for (const tweet of cap(archive.tweets)) {
+                const { deduped } = store.posts.ingest({
+                    text: tweet.text,
+                    externalId: tweet.externalId,
+                    url: `https://x.com/${archive.username ?? "i"}/status/${tweet.externalId}`,
+                    authorUsername: archive.username,
+                    postedAt: tweet.postedAt,
+                });
+                if (deduped) {
+                    counts.deduped += 1;
+                }
+                else {
+                    counts.tweetsImported += 1;
+                }
+            }
+        }
+    });
+    return {
+        data: {
+            path: root,
+            username: archive.username ?? null,
+            found: { likes: archive.likes.length, tweets: archive.tweets.length },
+            ...counts,
+        },
+        meta: { persisted: true },
+        human: () => [
+            `Imported X archive${archive.username ? ` for @${archive.username}` : ""}:`,
+            `  likes:     ${counts.likesImported} new (${counts.bookmarksCreated} bookmarked)`,
+            `  tweets:    ${counts.tweetsImported} new`,
+            `  deduped:   ${counts.deduped} already stored`,
+        ].join("\n"),
+    };
+}
+//# sourceMappingURL=import.js.map

package/dist/commands/import.js.map

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

package/dist/commands/learn.d.ts

@@ -0,0 +1,9 @@
+import type { RunContext } from "../core/context.js";
+import { type Opts } from "../core/opts.js";
+import type { CommandResult } from "../core/output.js";
+export declare function learnGenerateCommand(ctx: RunContext, opts: Opts): CommandResult;
+export declare function learnShowCommand(ctx: RunContext, opts: Opts): CommandResult;
+export declare function learnListCommand(ctx: RunContext, opts: Opts): CommandResult;
+export declare function learnTodayCommand(ctx: RunContext, opts: Opts): CommandResult;
+export declare function learnDoneCommand(ctx: RunContext, opts: Opts): CommandResult;
+//# sourceMappingURL=learn.d.ts.map

package/dist/commands/learn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learn.d.ts","sourceRoot":"","sources":["../../src/commands/learn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,KAAK,IAAI,EAAuC,MAAM,iBAAiB,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAOvD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,aAAa,CAwB/E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,aAAa,CAW3E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,aAAa,CAQ3E;AAYD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,aAAa,CAsD5E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,aAAa,CAkC3E"}

package/dist/commands/learn.js

@@ -0,0 +1,149 @@
+import { CliError } from "../core/errors.js";
+import { resolveJsonInput } from "../core/input.js";
+import { optNumber, optString, requireString } from "../core/opts.js";
+import { parseOrThrow } from "../core/validate.js";
+import { buildFeynmanTrack, nextPendingDay, scheduledDay } from "../domain/learn.js";
+import { RatingsInputSchema } from "../domain/schemas.js";
+export function learnGenerateCommand(ctx, opts) {
+    const store = ctx.store();
+    const analysisId = requireString(opts, "analysis", "--analysis");
+    const analysis = store.analyses.findById(analysisId);
+    if (!analysis) {
+        throw new CliError("NOT_FOUND", `No analysis with id ${analysisId}.`, {
+            details: { analysisId },
+        });
+    }
+    const ratingsOpt = optString(opts, "ratings");
+    const ratings = ratingsOpt
+        ? parseOrThrow(RatingsInputSchema, resolveJsonInput(ratingsOpt), "Invalid ratings input.")
+        : [];
+    const minutes = optNumber(opts, "minutes", 10);
+    const days = buildFeynmanTrack(analysis.concepts, minutes, ratings);
+    const track = store.tracks.create({ analysisId, minutesPerDay: minutes, ratings, days });
+    return {
+        data: { track, analysis },
+        meta: { trackId: track.id, minutesPerDay: minutes, persisted: true },
+        human: () => renderTrack(track),
+    };
+}
+export function learnShowCommand(ctx, opts) {
+    const store = ctx.store();
+    const id = requireString(opts, "id", "<id>");
+    const track = store.tracks.findById(id);
+    if (!track) {
+        throw new CliError("NOT_FOUND", `No learning track with id ${id}.`, { details: { id } });
+    }
+    return {
+        data: { track, analysis: store.analyses.findById(track.analysisId) },
+        human: () => renderTrack(track),
+    };
+}
+export function learnListCommand(ctx, opts) {
+    const limit = optNumber(opts, "limit", 20);
+    const analysisId = optString(opts, "analysis");
+    const tracks = ctx.store().tracks.list(limit, analysisId);
+    return {
+        data: { tracks, count: tracks.length },
+        meta: { limit, ...(analysisId ? { analysisId } : {}) },
+    };
+}
+/** Most recently created track that still has pending days. */
+function findActiveTrack(store) {
+    for (const track of store.tracks.list(100)) {
+        if (nextPendingDay(track.days, track.progress) !== null) {
+            return track;
+        }
+    }
+    return null;
+}
+export function learnTodayCommand(ctx, opts) {
+    const store = ctx.store();
+    const id = optString(opts, "id");
+    let track;
+    if (id) {
+        track = store.tracks.findById(id);
+        if (!track) {
+            throw new CliError("NOT_FOUND", `No learning track with id ${id}.`, { details: { id } });
+        }
+    }
+    else {
+        track = findActiveTrack(store);
+        if (!track) {
+            throw new CliError("NOT_FOUND", "No learning track with pending days. Create one with `learn generate --analysis <id>` or `analyze --learn`.");
+        }
+    }
+    const day = nextPendingDay(track.days, track.progress);
+    const analysis = store.analyses.findById(track.analysisId);
+    if (day === null) {
+        return {
+            data: { trackId: track.id, completed: true, task: null, progress: track.progress },
+            meta: { trackId: track.id, completed: true },
+            human: () => `Track ${track.id} is complete — all ${track.days.length} days done.`,
+        };
+    }
+    const task = track.days.find((d) => d.day === day) ?? null;
+    const onSchedule = scheduledDay(track.createdAt, new Date(), track.days.length);
+    return {
+        data: {
+            trackId: track.id,
+            day,
+            totalDays: track.days.length,
+            task,
+            scheduledDay: onSchedule,
+            behindBy: Math.max(0, onSchedule - day),
+            doneDays: track.progress.length,
+            topic: analysis?.topic ?? null,
+        },
+        meta: { trackId: track.id, day, completed: false },
+        human: () => {
+            const topic = analysis ? ` — ${analysis.topic}` : "";
+            const behind = onSchedule > day ? ` (calendar says day ${onSchedule}; ${onSchedule - day} behind)` : "";
+            return [
+                `Day ${day}/${track.days.length} of ${track.id}${topic}${behind}`,
+                ...(task ? [`  ${task.learn}`, `  ${task.explain}`, `  ${task.check}`] : []),
+                `Mark it finished with: learn done ${track.id}`,
+            ].join("\n");
+        },
+    };
+}
+export function learnDoneCommand(ctx, opts) {
+    const store = ctx.store();
+    const id = requireString(opts, "id", "<id>");
+    let track = store.tracks.findById(id);
+    if (!track) {
+        throw new CliError("NOT_FOUND", `No learning track with id ${id}.`, { details: { id } });
+    }
+    const pending = nextPendingDay(track.days, track.progress);
+    const day = optNumber(opts, "day", pending ?? 0);
+    if (pending === null && opts.day === undefined) {
+        throw new CliError("CONFLICT", `Track ${id} is already complete.`, { details: { id } });
+    }
+    if (!Number.isInteger(day) || day < 1 || day > track.days.length) {
+        throw new CliError("USAGE", `--day must be between 1 and ${track.days.length}.`, {
+            details: { day },
+        });
+    }
+    if (track.progress.some((p) => p.day === day)) {
+        throw new CliError("CONFLICT", `Day ${day} of track ${id} is already marked done.`, {
+            details: { id, day },
+        });
+    }
+    track = store.tracks.markDone(id, day, optString(opts, "notes"));
+    const remaining = nextPendingDay(track.days, track.progress);
+    return {
+        data: { track, day, completed: remaining === null },
+        meta: { trackId: track.id, day, completed: remaining === null, persisted: true },
+        human: () => remaining === null
+            ? `Day ${day} done — track ${id} complete! 🎉`
+            : `Day ${day} done (${track.progress.length}/${track.days.length}). Next up: day ${remaining}.`,
+    };
+}
+function renderTrack(track) {
+    const done = new Set(track.progress.map((p) => p.day));
+    const stats = track.progress.length > 0 ? ` — ${track.progress.length}/${track.days.length} done` : "";
+    return [
+        `7-day Feynman track (${track.minutesPerDay} min/day) — ${track.id}${stats}`,
+        ...track.days.map((d) => `Day ${d.day}${done.has(d.day) ? " ✓" : ""} [${d.concept}]\n  ${d.learn}\n  ${d.explain}\n  ${d.check}`),
+    ].join("\n");
+}
+//# sourceMappingURL=learn.js.map

package/dist/commands/learn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learn.js","sourceRoot":"","sources":["../../src/commands/learn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAa,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,MAAM,UAAU,oBAAoB,CAAC,GAAe,EAAE,IAAU;IAC9D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,uBAAuB,UAAU,GAAG,EAAE;YACpE,OAAO,EAAE,EAAE,UAAU,EAAE;SACxB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,UAAU;QACxB,CAAC,CAAC,YAAY,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,UAAU,CAAC,EAAE,wBAAwB,CAAC;QAC1F,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IAE/C,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzF,OAAO;QACL,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;QACzB,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE;QACpE,KAAK,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAe,EAAE,IAAU;IAC1D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;IAC1B,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,6BAA6B,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO;QACL,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE;QACpE,KAAK,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAe,EAAE,IAAU;IAC1D,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC1D,OAAO;QACL,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QACtC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;KACvD,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,SAAS,eAAe,CAAC,KAAY;IACnC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAe,EAAE,IAAU;IAC3D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;IAC1B,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjC,IAAI,KAA2B,CAAC;IAChC,IAAI,EAAE,EAAE,CAAC;QACP,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,6BAA6B,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,QAAQ,CAChB,WAAW,EACX,6GAA6G,CAC9G,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO;YACL,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;YAClF,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;YAC5C,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,KAAK,CAAC,EAAE,sBAAsB,KAAK,CAAC,IAAI,CAAC,MAAM,aAAa;SACnF,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC;IAC3D,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChF,OAAO;QACL,IAAI,EAAE;YACJ,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,GAAG;YACH,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM;YAC5B,IAAI;YACJ,YAAY,EAAE,UAAU;YACxB,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,GAAG,CAAC;YACvC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;YAC/B,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,IAAI;SAC/B;QACD,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE;QAClD,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,MAAM,MAAM,GACV,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,uBAAuB,UAAU,KAAK,UAAU,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3F,OAAO;gBACL,OAAO,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,KAAK,CAAC,EAAE,GAAG,KAAK,GAAG,MAAM,EAAE;gBACjE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5E,qCAAqC,KAAK,CAAC,EAAE,EAAE;aAChD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAe,EAAE,IAAU;IAC1D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;IAC1B,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,6BAA6B,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC;IACjD,IAAI,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC/C,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,SAAS,EAAE,uBAAuB,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjE,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,+BAA+B,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE;YAC/E,OAAO,EAAE,EAAE,GAAG,EAAE;SACjB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,aAAa,EAAE,0BAA0B,EAAE;YAClF,OAAO,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE;SACrB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC7D,OAAO;QACL,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,EAAE;QACnD,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;QAChF,KAAK,EAAE,GAAG,EAAE,CACV,SAAS,KAAK,IAAI;YAChB,CAAC,CAAC,OAAO,GAAG,iBAAiB,EAAE,eAAe;YAC9C,CAAC,CAAC,OAAO,GAAG,UAAU,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,mBAAmB,SAAS,GAAG;KACpG,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAoB;IACvC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,MAAM,KAAK,GACT,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3F,OAAO;QACL,wBAAwB,KAAK,CAAC,aAAa,eAAe,KAAK,CAAC,EAAE,GAAG,KAAK,EAAE;QAC5E,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CACf,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,EAAE,CAC1G;KACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/commands/manifest.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from "commander";
+import type { RunContext } from "../core/context.js";
+import type { Opts } from "../core/opts.js";
+import type { CommandResult } from "../core/output.js";
+/**
+ * Emit a complete, machine-readable description of the CLI: the output
+ * contract, error/exit codes, provider catalog, db schema version, and the full
+ * command tree. This is the agent's discovery entry point — one call reveals
+ * every command and flag without scraping `--help`.
+ */
+export declare function buildManifest(program: Command): Record<string, unknown>;
+export declare function manifestCommand(program: Command): (_ctx: RunContext, _opts: Opts) => CommandResult;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/commands/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/commands/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAiDvD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2BvE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,IACtC,MAAM,UAAU,EAAE,OAAO,IAAI,KAAG,aAAa,CAGtD"}

package/dist/commands/manifest.js

@@ -0,0 +1,62 @@
+import { PROVIDER_CATALOG } from "../ai/providers.js";
+import { ERROR_CODES, exitCodeMap } from "../core/errors.js";
+import { currentSchemaVersion } from "../db/migrations.js";
+function describeCommand(command) {
+    const args = (command
+        .registeredArguments ?? []);
+    return {
+        name: command.name(),
+        description: command.description(),
+        aliases: command.aliases(),
+        arguments: args.map((arg) => ({
+            name: arg.name(),
+            required: arg.required,
+            description: arg.description ?? "",
+        })),
+        options: command.options.map((option) => ({
+            flags: option.flags,
+            description: option.description ?? "",
+        })),
+        commands: command.commands.map(describeCommand),
+    };
+}
+/**
+ * Emit a complete, machine-readable description of the CLI: the output
+ * contract, error/exit codes, provider catalog, db schema version, and the full
+ * command tree. This is the agent's discovery entry point — one call reveals
+ * every command and flag without scraping `--help`.
+ */
+export function buildManifest(program) {
+    return {
+        name: "tenbrains",
+        version: program.version() ?? "unknown",
+        description: program.description(),
+        output: {
+            default: "json",
+            note: "stdout is exactly one JSON envelope per run; diagnostics go to stderr. Use --pretty for human output.",
+            successEnvelope: { ok: true, command: "string", data: "object", meta: "object" },
+            errorEnvelope: {
+                ok: false,
+                command: "string",
+                error: { code: "ErrorCode", message: "string", retryable: "boolean", details: "object?" },
+            },
+        },
+        errorCodes: ERROR_CODES,
+        exitCodes: exitCodeMap(),
+        providers: Object.values(PROVIDER_CATALOG).map((p) => ({
+            id: p.id,
+            label: p.label,
+            defaultModel: p.defaultModel,
+            requiresKey: p.requiresKey,
+            keyConfigPath: p.keyConfigPath,
+        })),
+        database: { engine: "sqlite", schemaVersion: currentSchemaVersion() },
+        commands: program.commands.map(describeCommand),
+    };
+}
+export function manifestCommand(program) {
+    return (_ctx, _opts) => ({
+        data: buildManifest(program),
+    });
+}
+//# sourceMappingURL=manifest.js.map

package/dist/commands/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/commands/manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AA4B3D,SAAS,eAAe,CAAC,OAAgB;IACvC,MAAM,IAAI,GAAG,CAAE,OAAoE;SAChF,mBAAmB,IAAI,EAAE,CAAwB,CAAC;IACrD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;QACpB,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;QAC1B,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC5B,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;YAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;SACnC,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACxC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;SACtC,CAAC,CAAC;QACH,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC;KAChD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,SAAS;QACvC,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;QAClC,MAAM,EAAE;YACN,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,uGAAuG;YAC7G,eAAe,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;YAChF,aAAa,EAAE;gBACb,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,QAAQ;gBACjB,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE;aAC1F;SACF;QACD,UAAU,EAAE,WAAW;QACvB,SAAS,EAAE,WAAW,EAAE;QACxB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrD,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,aAAa,EAAE,CAAC,CAAC,aAAa;SAC/B,CAAC,CAAC;QACH,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,oBAAoB,EAAE,EAAE;QACrE,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,OAAO,CAAC,IAAgB,EAAE,KAAW,EAAiB,EAAE,CAAC,CAAC;QACxD,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC;KAC7B,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/record.d.ts

@@ -0,0 +1,10 @@
+import type { RunContext } from "../core/context.js";
+import { type Opts } from "../core/opts.js";
+import type { CommandResult } from "../core/output.js";
+/**
+ * Resolve any prefixed id (post_, ana_, acc_, snap_, bm_, sug_, trk_) to its
+ * stored record. Lets an agent follow an id from one command's output straight
+ * to the underlying entity without knowing which table it belongs to.
+ */
+export declare function recordGetCommand(ctx: RunContext, opts: Opts): CommandResult;
+//# sourceMappingURL=record.d.ts.map

package/dist/commands/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/commands/record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,KAAK,IAAI,EAAiB,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,aAAa,CA8B3E"}

package/dist/commands/record.js

@@ -0,0 +1,37 @@
+import { CliError } from "../core/errors.js";
+import { requireString } from "../core/opts.js";
+/**
+ * Resolve any prefixed id (post_, ana_, acc_, snap_, bm_, sug_, trk_) to its
+ * stored record. Lets an agent follow an id from one command's output straight
+ * to the underlying entity without knowing which table it belongs to.
+ */
+export function recordGetCommand(ctx, opts) {
+    const id = requireString(opts, "id", "<id>");
+    const store = ctx.store();
+    const prefix = id.split("_", 1)[0];
+    const record = (() => {
+        switch (prefix) {
+            case "post":
+                return { type: "post", value: store.posts.findById(id) };
+            case "ana":
+                return { type: "analysis", value: store.analyses.findById(id) };
+            case "acc":
+                return { type: "account", value: store.accounts.findById(id) };
+            case "snap":
+                return { type: "takeaway_snapshot", value: store.snapshots.findById(id) };
+            case "bm":
+                return { type: "bookmark", value: store.bookmarks.findById(id) };
+            case "sug":
+                return { type: "suggestion", value: store.suggestions.findById(id) };
+            case "trk":
+                return { type: "learning_track", value: store.tracks.findById(id) };
+            default:
+                throw new CliError("USAGE", `Unrecognized id prefix "${prefix}".`, { details: { id } });
+        }
+    })();
+    if (!record.value) {
+        throw new CliError("NOT_FOUND", `No ${record.type} with id ${id}.`, { details: { id } });
+    }
+    return { data: { type: record.type, record: record.value } };
+}
+//# sourceMappingURL=record.js.map

package/dist/commands/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../src/commands/record.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAa,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG3D;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAe,EAAE,IAAU;IAC1D,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnC,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;QACnB,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,MAAM;gBACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3D,KAAK,KAAK;gBACR,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAClE,KAAK,KAAK;gBACR,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACjE,KAAK,MAAM;gBACT,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5E,KAAK,IAAI;gBACP,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACnE,KAAK,KAAK;gBACR,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACvE,KAAK,KAAK;gBACR,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACtE;gBACE,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,2BAA2B,MAAM,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC,IAAI,YAAY,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;AAC/D,CAAC"}

package/dist/commands/search.d.ts

@@ -0,0 +1,5 @@
+import type { RunContext } from "../core/context.js";
+import { type Opts } from "../core/opts.js";
+import type { CommandResult } from "../core/output.js";
+export declare function searchCommand(ctx: RunContext, opts: Opts): CommandResult;
+//# sourceMappingURL=search.d.ts.map

package/dist/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,KAAK,IAAI,EAAqC,MAAM,iBAAiB,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,aAAa,CA4BxE"}

package/dist/commands/search.js

@@ -0,0 +1,33 @@
+import { CliError } from "../core/errors.js";
+import { optList, optNumber, requireString } from "../core/opts.js";
+import { searchCorpus } from "../domain/search.js";
+const ALL_TYPES = ["analysis", "takeaway", "bookmark"];
+export function searchCommand(ctx, opts) {
+    const query = requireString(opts, "query", "<query>");
+    const requested = optList(opts, "type");
+    let types = ALL_TYPES;
+    if (requested.length > 0 && !requested.includes("all")) {
+        for (const t of requested) {
+            if (!ALL_TYPES.includes(t)) {
+                throw new CliError("USAGE", `Invalid --type "${t}". Use analysis|takeaway|bookmark|all.`);
+            }
+        }
+        types = requested;
+    }
+    const limit = optNumber(opts, "limit", 10);
+    const result = searchCorpus(ctx.store(), query, { types, limit });
+    return {
+        data: result,
+        meta: { total: result.total },
+        human: () => {
+            const lines = [`Results for "${query}" (${result.total}):`];
+            for (const type of ALL_TYPES) {
+                for (const hit of result.groups[type]) {
+                    lines.push(`  [${type} ${hit.score.toFixed(2)}] ${hit.title} — ${hit.snippet}`);
+                }
+            }
+            return result.total === 0 ? `No matches for "${query}".` : lines.join("\n");
+        },
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAa,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,EAAmB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,SAAS,GAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAErE,MAAM,UAAU,aAAa,CAAC,GAAe,EAAE,IAAU;IACvD,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,KAAK,GAAiB,SAAS,CAAC;IACpC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAe,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC,wCAAwC,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC;QACD,KAAK,GAAG,SAAyB,CAAC;IACpC,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAElE,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;QAC7B,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,KAAK,GAAa,CAAC,gBAAgB,KAAK,MAAM,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;YACtE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;gBAC7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBACtC,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBAClF,CAAC;YACH,CAAC;YACD,OAAO,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9E,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/commands/shared.d.ts

@@ -0,0 +1,9 @@
+import type { RunContext } from "../core/context.js";
+import { type Opts } from "../core/opts.js";
+/**
+ * Resolve the X (Twitter) Bearer token for a run: the `--x-bearer` flag (which
+ * may be `@file` or `-` for stdin) wins, then the stored `x.bearerToken` config,
+ * else null. No environment variables are consulted.
+ */
+export declare function resolveXBearer(ctx: RunContext, opts: Opts): string | null;
+//# sourceMappingURL=shared.d.ts.map

package/dist/commands/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,KAAK,IAAI,EAAa,MAAM,iBAAiB,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAIzE"}

package/dist/commands/shared.js

@@ -0,0 +1,13 @@
+import { resolveTextInput } from "../core/input.js";
+import { optString } from "../core/opts.js";
+/**
+ * Resolve the X (Twitter) Bearer token for a run: the `--x-bearer` flag (which
+ * may be `@file` or `-` for stdin) wins, then the stored `x.bearerToken` config,
+ * else null. No environment variables are consulted.
+ */
+export function resolveXBearer(ctx, opts) {
+    const flag = optString(opts, "xBearer");
+    const fromFlag = flag ? resolveTextInput(flag).trim() : "";
+    return fromFlag || ctx.config.getXBearer() || null;
+}
+//# sourceMappingURL=shared.js.map

package/dist/commands/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAa,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAe,EAAE,IAAU;IACxD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,OAAO,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,IAAI,CAAC;AACrD,CAAC"}

package/dist/commands/suggest.d.ts

@@ -0,0 +1,9 @@
+import type { RunContext } from "../core/context.js";
+import { type Opts } from "../core/opts.js";
+import type { CommandResult } from "../core/output.js";
+export declare function suggestGenerateCommand(ctx: RunContext, opts: Opts): CommandResult;
+export declare function suggestListCommand(ctx: RunContext, opts: Opts): CommandResult;
+export declare function suggestSaveCommand(ctx: RunContext, opts: Opts): CommandResult;
+export declare function suggestDismissCommand(ctx: RunContext, opts: Opts): CommandResult;
+export declare function suggestAddCommand(ctx: RunContext, opts: Opts): CommandResult;
+//# sourceMappingURL=suggest.d.ts.map