tenbrains 2.1.0

package/dist/db/repositories.js

@@ -0,0 +1,418 @@
+import { newId, nowIso } from "./database.js";
+/** Coerce undefined to null; SQLite bindings reject undefined. */
+function nn(value) {
+    return value === undefined ? null : value;
+}
+function parseJsonArray(raw) {
+    if (typeof raw !== "string") {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+// --- mappers -----------------------------------------------------------------
+function mapPost(row) {
+    return {
+        id: row.id,
+        externalId: row.external_id,
+        url: row.url,
+        authorUsername: row.author_username,
+        authorName: row.author_name,
+        text: row.text,
+        postedAt: row.posted_at,
+        createdAt: row.created_at,
+    };
+}
+function mapAnalysis(row) {
+    return {
+        id: row.id,
+        postId: row.post_id,
+        provider: row.provider,
+        model: row.model,
+        topic: row.topic,
+        summary: row.summary,
+        intent: row.intent,
+        concepts: parseJsonArray(row.concepts_json),
+        mock: row.mock === 1,
+        createdAt: row.created_at,
+    };
+}
+function mapAccount(row) {
+    return {
+        id: row.id,
+        username: row.username,
+        name: row.name,
+        followedAt: row.followed_at,
+        lastRefreshedAt: row.last_refreshed_at,
+    };
+}
+function mapSnapshot(row) {
+    return {
+        id: row.id,
+        accountId: row.account_id,
+        provider: row.provider,
+        model: row.model,
+        summary: row.summary,
+        takeaways: parseJsonArray(row.takeaways_json),
+        sourcePostIds: parseJsonArray(row.source_post_ids_json),
+        postCount: row.post_count,
+        mock: row.mock === 1,
+        createdAt: row.created_at,
+    };
+}
+function mapBookmark(row) {
+    return {
+        id: row.id,
+        postId: row.post_id,
+        tags: parseJsonArray(row.tags_json),
+        note: row.note,
+        source: row.source,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+function mapSuggestion(row) {
+    return {
+        id: row.id,
+        postId: row.post_id,
+        reason: row.reason,
+        score: row.score,
+        status: row.status,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+function mapTrack(row, progress) {
+    return {
+        id: row.id,
+        analysisId: row.analysis_id,
+        minutesPerDay: row.minutes_per_day,
+        ratings: parseJsonArray(row.ratings_json),
+        days: parseJsonArray(row.days_json),
+        progress,
+        createdAt: row.created_at,
+    };
+}
+// --- repositories ------------------------------------------------------------
+export class PostsRepo {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    create(data) {
+        const id = newId("post");
+        const createdAt = nowIso();
+        this.db
+            .prepare(`INSERT INTO posts (id, external_id, url, author_username, author_name, text, posted_at, raw_json, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(id, nn(data.externalId), nn(data.url), nn(data.authorUsername), nn(data.authorName), data.text, nn(data.postedAt), data.raw === undefined ? null : JSON.stringify(data.raw), createdAt);
+        return this.findById(id);
+    }
+    /** Insert, or return the existing post when externalId already present. */
+    ingest(data) {
+        if (data.externalId) {
+            const existing = this.findByExternalId(data.externalId);
+            if (existing) {
+                return { post: existing, deduped: true };
+            }
+        }
+        return { post: this.create(data), deduped: false };
+    }
+    findById(id) {
+        const row = this.db.prepare("SELECT * FROM posts WHERE id = ?").get(id);
+        return row ? mapPost(row) : null;
+    }
+    findByExternalId(externalId) {
+        const row = this.db.prepare("SELECT * FROM posts WHERE external_id = ?").get(externalId);
+        return row ? mapPost(row) : null;
+    }
+    list(limit, offset) {
+        const rows = this.db
+            .prepare("SELECT * FROM posts ORDER BY created_at DESC, id DESC LIMIT ? OFFSET ?")
+            .all(limit, offset);
+        return rows.map(mapPost);
+    }
+    all() {
+        const rows = this.db.prepare("SELECT * FROM posts").all();
+        return rows.map(mapPost);
+    }
+}
+export class AnalysesRepo {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    create(data) {
+        const id = newId("ana");
+        const createdAt = nowIso();
+        this.db
+            .prepare(`INSERT INTO analyses (id, post_id, provider, model, topic, summary, intent, concepts_json, mock, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(id, data.postId, data.provider, data.model, data.topic, data.summary, data.intent, JSON.stringify(data.concepts), data.mock ? 1 : 0, createdAt);
+        return this.findById(id);
+    }
+    findById(id) {
+        const row = this.db.prepare("SELECT * FROM analyses WHERE id = ?").get(id);
+        return row ? mapAnalysis(row) : null;
+    }
+    latestForPost(postId) {
+        const row = this.db
+            .prepare("SELECT * FROM analyses WHERE post_id = ? ORDER BY created_at DESC LIMIT 1")
+            .get(postId);
+        return row ? mapAnalysis(row) : null;
+    }
+    list(limit, offset, author) {
+        if (author) {
+            const rows = this.db
+                .prepare(`SELECT a.* FROM analyses a JOIN posts p ON p.id = a.post_id
+           WHERE p.author_username = ? ORDER BY a.created_at DESC LIMIT ? OFFSET ?`)
+                .all(author, limit, offset);
+            return rows.map(mapAnalysis);
+        }
+        const rows = this.db
+            .prepare("SELECT * FROM analyses ORDER BY created_at DESC LIMIT ? OFFSET ?")
+            .all(limit, offset);
+        return rows.map(mapAnalysis);
+    }
+    all() {
+        const rows = this.db.prepare("SELECT * FROM analyses").all();
+        return rows.map(mapAnalysis);
+    }
+}
+export class AccountsRepo {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    create(username, name) {
+        const id = newId("acc");
+        this.db
+            .prepare("INSERT INTO accounts (id, username, name, followed_at) VALUES (?, ?, ?, ?)")
+            .run(id, username, nn(name), nowIso());
+        return this.findById(id);
+    }
+    findById(id) {
+        const row = this.db.prepare("SELECT * FROM accounts WHERE id = ?").get(id);
+        return row ? mapAccount(row) : null;
+    }
+    findByUsername(username) {
+        const row = this.db.prepare("SELECT * FROM accounts WHERE username = ?").get(username);
+        return row ? mapAccount(row) : null;
+    }
+    list() {
+        const rows = this.db
+            .prepare("SELECT * FROM accounts ORDER BY username ASC")
+            .all();
+        return rows.map(mapAccount);
+    }
+    touch(id) {
+        this.db.prepare("UPDATE accounts SET last_refreshed_at = ? WHERE id = ?").run(nowIso(), id);
+    }
+    delete(id) {
+        this.db.prepare("DELETE FROM accounts WHERE id = ?").run(id);
+    }
+}
+export class SnapshotsRepo {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    create(data) {
+        const id = newId("snap");
+        this.db
+            .prepare(`INSERT INTO takeaway_snapshots
+         (id, account_id, provider, model, summary, takeaways_json, source_post_ids_json, post_count, mock, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(id, data.accountId, data.provider, data.model, data.summary, JSON.stringify(data.takeaways), JSON.stringify(data.sourcePostIds), data.sourcePostIds.length, data.mock ? 1 : 0, nowIso());
+        return this.findById(id);
+    }
+    findById(id) {
+        const row = this.db.prepare("SELECT * FROM takeaway_snapshots WHERE id = ?").get(id);
+        return row ? mapSnapshot(row) : null;
+    }
+    latestByAccount(accountId) {
+        const row = this.db
+            .prepare("SELECT * FROM takeaway_snapshots WHERE account_id = ? ORDER BY created_at DESC LIMIT 1")
+            .get(accountId);
+        return row ? mapSnapshot(row) : null;
+    }
+    listByAccount(accountId, limit) {
+        const rows = this.db
+            .prepare("SELECT * FROM takeaway_snapshots WHERE account_id = ? ORDER BY created_at DESC LIMIT ?")
+            .all(accountId, limit);
+        return rows.map(mapSnapshot);
+    }
+    all() {
+        const rows = this.db
+            .prepare("SELECT * FROM takeaway_snapshots")
+            .all();
+        return rows.map(mapSnapshot);
+    }
+}
+export class BookmarksRepo {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    create(data) {
+        const id = newId("bm");
+        const ts = nowIso();
+        this.db
+            .prepare(`INSERT INTO bookmarks (id, post_id, tags_json, note, source, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`)
+            .run(id, data.postId, JSON.stringify(data.tags), nn(data.note), data.source, ts, ts);
+        return this.findById(id);
+    }
+    findById(id) {
+        const row = this.db.prepare("SELECT * FROM bookmarks WHERE id = ?").get(id);
+        return row ? mapBookmark(row) : null;
+    }
+    findByPostId(postId) {
+        const row = this.db.prepare("SELECT * FROM bookmarks WHERE post_id = ?").get(postId);
+        return row ? mapBookmark(row) : null;
+    }
+    list(limit, offset) {
+        const rows = this.db
+            .prepare("SELECT * FROM bookmarks ORDER BY created_at DESC LIMIT ? OFFSET ?")
+            .all(limit, offset);
+        return rows.map(mapBookmark);
+    }
+    all() {
+        const rows = this.db.prepare("SELECT * FROM bookmarks").all();
+        return rows.map(mapBookmark);
+    }
+    updateTags(id, tags) {
+        this.db
+            .prepare("UPDATE bookmarks SET tags_json = ?, updated_at = ? WHERE id = ?")
+            .run(JSON.stringify(tags), nowIso(), id);
+        return this.findById(id);
+    }
+    delete(id) {
+        this.db.prepare("DELETE FROM bookmarks WHERE id = ?").run(id);
+    }
+}
+export class SuggestionsRepo {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Insert a pending suggestion or refresh score/reason if one exists for the post. */
+    upsert(data) {
+        const existing = this.findByPostId(data.postId);
+        const ts = nowIso();
+        if (existing) {
+            if (existing.status === "pending") {
+                this.db
+                    .prepare("UPDATE suggestions SET reason = ?, score = ?, updated_at = ? WHERE id = ?")
+                    .run(data.reason, data.score, ts, existing.id);
+            }
+            return this.findById(existing.id);
+        }
+        const id = newId("sug");
+        this.db
+            .prepare(`INSERT INTO suggestions (id, post_id, reason, score, status, created_at, updated_at)
+         VALUES (?, ?, ?, ?, 'pending', ?, ?)`)
+            .run(id, data.postId, data.reason, data.score, ts, ts);
+        return this.findById(id);
+    }
+    findById(id) {
+        const row = this.db.prepare("SELECT * FROM suggestions WHERE id = ?").get(id);
+        return row ? mapSuggestion(row) : null;
+    }
+    findByPostId(postId) {
+        const row = this.db.prepare("SELECT * FROM suggestions WHERE post_id = ?").get(postId);
+        return row ? mapSuggestion(row) : null;
+    }
+    list(status, limit) {
+        if (status === "all") {
+            const rows = this.db
+                .prepare("SELECT * FROM suggestions ORDER BY score DESC, created_at DESC LIMIT ?")
+                .all(limit);
+            return rows.map(mapSuggestion);
+        }
+        const rows = this.db
+            .prepare("SELECT * FROM suggestions WHERE status = ? ORDER BY score DESC, created_at DESC LIMIT ?")
+            .all(status, limit);
+        return rows.map(mapSuggestion);
+    }
+    setStatus(id, status) {
+        this.db
+            .prepare("UPDATE suggestions SET status = ?, updated_at = ? WHERE id = ?")
+            .run(status, nowIso(), id);
+        return this.findById(id);
+    }
+}
+export class TracksRepo {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    create(data) {
+        const id = newId("trk");
+        this.db
+            .prepare(`INSERT INTO learning_tracks (id, analysis_id, minutes_per_day, ratings_json, days_json, created_at)
+         VALUES (?, ?, ?, ?, ?, ?)`)
+            .run(id, data.analysisId, data.minutesPerDay, JSON.stringify(data.ratings), JSON.stringify(data.days), nowIso());
+        return this.findById(id);
+    }
+    findById(id) {
+        const row = this.db.prepare("SELECT * FROM learning_tracks WHERE id = ?").get(id);
+        return row ? mapTrack(row, this.progressFor(row.id)) : null;
+    }
+    list(limit, analysisId) {
+        if (analysisId) {
+            const rows = this.db
+                .prepare("SELECT * FROM learning_tracks WHERE analysis_id = ? ORDER BY created_at DESC LIMIT ?")
+                .all(analysisId, limit);
+            return rows.map((row) => mapTrack(row, this.progressFor(row.id)));
+        }
+        const rows = this.db
+            .prepare("SELECT * FROM learning_tracks ORDER BY created_at DESC LIMIT ?")
+            .all(limit);
+        return rows.map((row) => mapTrack(row, this.progressFor(row.id)));
+    }
+    progressFor(trackId) {
+        const rows = this.db
+            .prepare("SELECT day, notes, completed_at FROM track_progress WHERE track_id = ? ORDER BY day")
+            .all(trackId);
+        return rows.map((row) => ({ day: row.day, notes: row.notes, completedAt: row.completed_at }));
+    }
+    /** Record a day as done. Caller guards against duplicates (PK would throw). */
+    markDone(trackId, day, notes) {
+        this.db
+            .prepare("INSERT INTO track_progress (track_id, day, notes, completed_at) VALUES (?, ?, ?, ?)")
+            .run(trackId, day, nn(notes), nowIso());
+        return this.findById(trackId);
+    }
+}
+/** Facade exposing every repository over a single Database. */
+export class Store {
+    database;
+    posts;
+    analyses;
+    accounts;
+    snapshots;
+    bookmarks;
+    suggestions;
+    tracks;
+    constructor(database) {
+        this.database = database;
+        const handle = database.handle;
+        this.posts = new PostsRepo(handle);
+        this.analyses = new AnalysesRepo(handle);
+        this.accounts = new AccountsRepo(handle);
+        this.snapshots = new SnapshotsRepo(handle);
+        this.bookmarks = new BookmarksRepo(handle);
+        this.suggestions = new SuggestionsRepo(handle);
+        this.tracks = new TracksRepo(handle);
+    }
+    transaction(fn) {
+        return this.database.transaction(fn);
+    }
+}
+//# sourceMappingURL=repositories.js.map

package/dist/db/repositories.js.map

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

package/dist/domain/learn.d.ts

@@ -0,0 +1,25 @@
+import type { Concept, ConceptRating, LearningDay, TrackDayProgress } from "./types.js";
+/**
+ * Order concepts for study: highest interest first, then most novel (lowest
+ * familiarity), preserving original order as a stable tiebreaker.
+ */
+export declare function prioritizeConcepts(concepts: Concept[], ratings: ConceptRating[]): Concept[];
+/**
+ * Build a 7-day Feynman track. Each day pairs a prioritized concept with
+ * Learn / Explain / Check steps. With fewer than 7 concepts, the top concepts
+ * recur on later days for spaced repetition.
+ */
+/**
+ * The next day to study: the first day without a progress entry. Progress is
+ * session-based, not calendar-based, so missing a calendar day never skips
+ * content. Returns null when every day is done.
+ */
+export declare function nextPendingDay(days: LearningDay[], progress: TrackDayProgress[]): number | null;
+/**
+ * Where the calendar says you should be: day 1 on the creation date, clamped
+ * to the track length. Reported alongside the pending day so callers can see
+ * whether the learner is behind schedule.
+ */
+export declare function scheduledDay(createdAt: string, now: Date, totalDays: number): number;
+export declare function buildFeynmanTrack(concepts: Concept[], minutesPerDay: number, ratings: ConceptRating[]): LearningDay[];
+//# sourceMappingURL=learn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"learn.d.ts","sourceRoot":"","sources":["../../src/domain/learn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiBxF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,CAe3F;AASD;;;;GAIG;AACH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,GAAG,IAAI,CAQ/F;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGpF;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,EAAE,EACnB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,aAAa,EAAE,GACvB,WAAW,EAAE,CAmBf"}

package/dist/domain/learn.js

@@ -0,0 +1,85 @@
+const TRACK_DAYS = 7;
+const DEFAULT_FAMILIARITY = 1; // assume novel when unrated
+const DEFAULT_INTEREST = 3; // assume neutral interest when unrated
+function ratingFor(concept, ratings) {
+    const match = ratings.find((r) => r.concept.toLowerCase() === concept.name.toLowerCase());
+    return {
+        familiarity: match?.familiarity ?? DEFAULT_FAMILIARITY,
+        interest: match?.interest ?? DEFAULT_INTEREST,
+    };
+}
+/**
+ * Order concepts for study: highest interest first, then most novel (lowest
+ * familiarity), preserving original order as a stable tiebreaker.
+ */
+export function prioritizeConcepts(concepts, ratings) {
+    return concepts
+        .map((concept, index) => ({ concept, index, ...ratingFor(concept, ratings) }))
+        .sort((a, b) => {
+        if (b.interest !== a.interest) {
+            return b.interest - a.interest;
+        }
+        const noveltyA = 6 - a.familiarity;
+        const noveltyB = 6 - b.familiarity;
+        if (noveltyB !== noveltyA) {
+            return noveltyB - noveltyA;
+        }
+        return a.index - b.index;
+    })
+        .map((entry) => entry.concept);
+}
+function splitMinutes(total) {
+    const learn = Math.max(1, Math.round(total * 0.4));
+    const explain = Math.max(1, Math.round(total * 0.4));
+    const check = Math.max(1, total - learn - explain);
+    return { learn, explain, check };
+}
+/**
+ * Build a 7-day Feynman track. Each day pairs a prioritized concept with
+ * Learn / Explain / Check steps. With fewer than 7 concepts, the top concepts
+ * recur on later days for spaced repetition.
+ */
+/**
+ * The next day to study: the first day without a progress entry. Progress is
+ * session-based, not calendar-based, so missing a calendar day never skips
+ * content. Returns null when every day is done.
+ */
+export function nextPendingDay(days, progress) {
+    const done = new Set(progress.map((p) => p.day));
+    for (const day of days) {
+        if (!done.has(day.day)) {
+            return day.day;
+        }
+    }
+    return null;
+}
+/**
+ * Where the calendar says you should be: day 1 on the creation date, clamped
+ * to the track length. Reported alongside the pending day so callers can see
+ * whether the learner is behind schedule.
+ */
+export function scheduledDay(createdAt, now, totalDays) {
+    const elapsed = Math.floor((now.getTime() - new Date(createdAt).getTime()) / 86_400_000);
+    return Math.min(Math.max(elapsed + 1, 1), Math.max(totalDays, 1));
+}
+export function buildFeynmanTrack(concepts, minutesPerDay, ratings) {
+    const ordered = prioritizeConcepts(concepts, ratings);
+    if (ordered.length === 0) {
+        return [];
+    }
+    const minutes = splitMinutes(minutesPerDay);
+    const days = [];
+    for (let day = 1; day <= TRACK_DAYS; day += 1) {
+        const concept = ordered[(day - 1) % ordered.length];
+        const revisiting = day > ordered.length;
+        days.push({
+            day,
+            concept: concept.name,
+            learn: `${minutes.learn} min: ${revisiting ? "Revisit" : "Read or watch a primer on"} "${concept.name}". ${concept.whyItMattersInTweet}`,
+            explain: `${minutes.explain} min: Write a plain-language explanation of "${concept.name}" as if teaching a beginner, no jargon.`,
+            check: `${minutes.check} min: List what still feels fuzzy about "${concept.name}" and note one question to resolve tomorrow.`,
+        });
+    }
+    return days;
+}
+//# sourceMappingURL=learn.js.map

package/dist/domain/learn.js.map

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