yt-briefing 0.2.0 → 0.3.0

package/README.md

@@ -53,6 +53,14 @@ npx yt-briefing init      # or: bunx yt-briefing init
 
 `init` asks for your language, your keys, the channels to follow, and which tool runs `/yt`.
 
+Add or remove channels anytime:
+
+```bash
+npx yt-briefing add @handle https://youtube.com/@another   # one or more, handle or URL
+npx yt-briefing remove @handle                              # also deletes its learned profile
+npx yt-briefing list                                        # show the current list
+```
+
 ## Run it
 
 Open your project in Claude Code or Cursor and run `/yt`. If it's not listed, start a fresh

package/dist/bootstrap.js

@@ -18,6 +18,7 @@ import { join } from 'node:path';
 import { DATA_DIR, BASE_DIR, PKG_ROOT, CHANNELS_DIR, CHANNELS_MD, STATE_MD, CONFIG_JSON, ENV_PATH, profilePath, } from "./lib/paths.js";
 import { AGENTS, installSkill, projectSkillDir, customSkillDirDefault, isPackageDevCwd } from "./lib/skill-install.js";
 import { question } from "./lib/prompt.js";
+import { normalizeHandle, slugify, serializeChannels, serializeState, profileBody, baselineStateRow } from "./lib/channels.js";
 const ask = (q, def = '') => {
     const a = question(def ? `${q} [${def}]:` : `${q}:`).trim();
     return a || def;
@@ -28,35 +29,6 @@ const askYN = (q, def = true) => {
         return def;
     return a.startsWith('y');
 };
-/**
- * Accept any of: `@betterstack`, `betterstack`, `https://www.youtube.com/@betterstack`
- * (with or without a trailing `/videos` etc.) → canonical `@betterstack`. Returns null if
- * no handle can be read (e.g. a bare `/channel/UC…` URL — ask the user for the @handle).
- */
-function normalizeHandle(input) {
-    let s = input.trim();
-    if (/youtube\.com/i.test(s) || /^https?:\/\//i.test(s)) {
-        const m = s.match(/@[A-Za-z0-9._-]+/); // pull the @handle out of a URL
-        s = m ? m[0] : '';
-    }
-    s = s.replace(/^@+/, '').replace(/[^A-Za-z0-9._-].*$/, ''); // bare token
-    return s ? `@${s}` : null;
-}
-/** kebab-case slug that also breaks CamelCase: "BetterStack" → "better-stack". */
-function slugify(s) {
-    return s
-        .replace(/@/g, '')
-        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
-        .replace(/[^A-Za-z0-9]+/g, '-')
-        .replace(/-+/g, '-')
-        .replace(/^-|-$/g, '')
-        .toLowerCase();
-}
-const today = new Date().toISOString().slice(0, 10);
-// Fresh channels start "baseline": the first sweep surfaces the latest upload per type.
-// updated is set this far back so that window actually contains a recent video.
-const BASELINE_LOOKBACK_DAYS = 60;
-const lookback = new Date(Date.now() - BASELINE_LOOKBACK_DAYS * 864e5).toISOString().slice(0, 10);
 function main() {
     console.log('\n  yt-briefing — onboarding\n  ' + '─'.repeat(40) + '\n');
     if (existsSync(CHANNELS_MD)) {
@@ -163,58 +135,12 @@ function main() {
     }
     // config.json
     writeFileSync(CONFIG_JSON, JSON.stringify({ output_lang: outputLang }, null, 2) + '\n', 'utf8');
-    // channels.md — a flat list of the channels you follow.
-    const chParts = [
-        '---',
-        'type: yt-config',
-        'name: yt-channels',
-        'description: The channels you follow. Per-channel learned signal lives in channels/<slug>.md.',
-        `updated: ${today}`,
-        '---',
-        '',
-        '# Channels',
-        '',
-    ];
-    for (const c of channels) {
-        chParts.push(`- [${c.handle}](https://www.youtube.com/${c.handle}) → [[channels/${c.slug}]]`);
-    }
-    writeFileSync(CHANNELS_MD, chParts.join('\n') + '\n', 'utf8');
-    // state.md — one flat table (baseline rows: pointers "—", updated = lookback so the first
-    // sweep finds the latest upload per type).
-    const stParts = [
-        '---',
-        'type: yt-state',
-        'name: yt-state',
-        'description: Per-channel per-type cursor. The sweep reads and updates it.',
-        `updated: ${today}`,
-        '---',
-        '',
-        '# State',
-        '',
-        '| Channel | last_longform_id | last_short_id | last_live_id | updated | session |',
-        '|---|---|---|---|---|---|',
-    ];
-    for (const c of channels) {
-        stParts.push(`| ${c.handle} | — | — | — | ${lookback} | 0 |`);
-    }
-    writeFileSync(STATE_MD, stParts.join('\n') + '\n', 'utf8');
-    // per-channel profiles
-    for (const c of channels) {
-        const pParts = [
-            '---',
-            'type: yt-channel-profile',
-            `name: ${c.slug}-profile`,
-            `channel: ${c.handle}`,
-            `channel_url: https://www.youtube.com/${c.handle}`,
-            `updated: ${today}`,
-            'sessions_observed: 0',
-            '---',
-            '',
-            `# ${c.handle} — Profile`,
-            '',
-        ];
-        writeFileSync(profilePath(c.slug), pParts.join('\n') + '\n', 'utf8');
-    }
+    // channels.md / state.md / per-channel profiles — via the shared serializers, so the
+    // on-disk format is identical to what the add/remove command writes (single source).
+    writeFileSync(CHANNELS_MD, serializeChannels(channels), 'utf8');
+    writeFileSync(STATE_MD, serializeState(channels.map(c => baselineStateRow(c.handle))), 'utf8');
+    for (const c of channels)
+        writeFileSync(profilePath(c.slug), profileBody(c.handle, c.slug), 'utf8');
     console.log('  ' + '─'.repeat(40));
     console.log(`  Done. Wrote:`);
     console.log(`    ${ENV_PATH}`);

package/dist/cli.js

@@ -7,6 +7,8 @@
  *
  *   yt-briefing init                       interactive onboarding wizard
  *   yt-briefing install-skill              install the /yt skill into a coding agent
+ *   yt-briefing add|remove <@handle|url>   add or remove channels (also list)
+ *   yt-briefing list                       list the channels you follow
  *   yt-briefing sweep [--reset]            advance one step; prints a JSON status line
  *   yt-briefing rate --rating 0|1 [...]    record a rating for the pending video
  *   yt-briefing transcribe <url|id>        print a single video's transcript
@@ -14,6 +16,8 @@
 import { spawnSync } from 'node:child_process';
 import { script } from "./lib/paths.js";
 const [cmd, ...rest] = process.argv.slice(2);
+// Subcommand → engine script. Channel actions all route to yt-channels with the action
+// passed through as its first arg.
 const TARGETS = {
     init: 'bootstrap',
     'install-skill': 'install-skill',
@@ -21,9 +25,15 @@ const TARGETS = {
     rate: 'yt-rating',
     transcribe: 'yt-transcript',
 };
-if (!cmd || !TARGETS[cmd]) {
-    console.error('Usage: yt-briefing <init|install-skill|sweep|rate|transcribe> [args...]');
+const CHANNEL_ACTIONS = new Set(['add', 'remove', 'list']);
+let argv = null;
+if (cmd && CHANNEL_ACTIONS.has(cmd))
+    argv = [script('yt-channels'), cmd, ...rest];
+else if (cmd && TARGETS[cmd])
+    argv = [script(TARGETS[cmd]), ...rest];
+if (!argv) {
+    console.error('Usage: yt-briefing <init|install-skill|add|remove|list|sweep|rate|transcribe> [args...]');
     process.exit(cmd ? 1 : 0);
 }
-const res = spawnSync(process.execPath, [script(TARGETS[cmd]), ...rest], { stdio: 'inherit' });
+const res = spawnSync(process.execPath, argv, { stdio: 'inherit' });
 process.exit(res.status ?? 1);

package/dist/lib/channels.js

@@ -0,0 +1,82 @@
+export const BASELINE_LOOKBACK_DAYS = 60;
+export const today = () => new Date().toISOString().slice(0, 10);
+// Fresh channels start "baseline": updated is set this far back so the first sweep's window
+// still contains a recent upload per type (which becomes the starting point).
+export const lookbackDate = () => new Date(Date.now() - BASELINE_LOOKBACK_DAYS * 864e5).toISOString().slice(0, 10);
+export const channelUrl = (handle) => `https://www.youtube.com/${handle}`;
+/**
+ * Accept any of: `@betterstack`, `betterstack`, `https://www.youtube.com/@betterstack`
+ * (with or without a trailing `/videos` etc.) → canonical `@betterstack`. Returns null if no
+ * handle can be read (e.g. a bare `/channel/UC…` URL — ask the user for the @handle).
+ */
+export function normalizeHandle(input) {
+    let s = input.trim();
+    if (/youtube\.com/i.test(s) || /^https?:\/\//i.test(s)) {
+        const m = s.match(/@[\p{L}\p{N}._-]+/u); // pull the @handle out of a URL (Unicode-aware)
+        s = m ? m[0] : '';
+    }
+    s = s.replace(/^@+/, '');
+    // Keep the leading run of handle chars — letters (any script, e.g. ł), digits, . _ - —
+    // so non-ASCII handles like @DziałZagraniczny survive instead of truncating at the first ł.
+    const m = s.match(/^[\p{L}\p{N}._-]+/u);
+    s = m ? m[0] : '';
+    return s ? `@${s}` : null;
+}
+/**
+ * kebab-case slug that also breaks CamelCase: "BetterStack" → "better-stack". Diacritics are
+ * folded to ASCII so non-Latin handles get readable slugs: "DziałZagraniczny" → "dzial-zagraniczny"
+ * (ł has no NFD decomposition, so it's mapped explicitly; the rest go through NFD).
+ */
+export function slugify(s) {
+    return s
+        .replace(/@/g, '')
+        .replace(/ł/g, 'l').replace(/Ł/g, 'L')
+        .normalize('NFD').replace(/[̀-ͯ]/g, '') // strip combining diacritics (ą→a, é→e, …)
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/[^A-Za-z0-9]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        .toLowerCase();
+}
+/** A fresh state row for a just-added channel: no cursors yet, dated back to the lookback. */
+export const baselineStateRow = (handle) => ({
+    handle,
+    last_longform_id: null,
+    last_short_id: null,
+    last_live_id: null,
+    updated: lookbackDate(),
+    session: 0,
+});
+/** channels.md — a flat list of the channels you follow. */
+export function serializeChannels(entries, date = today()) {
+    const parts = [
+        '---', 'type: yt-config', 'name: yt-channels',
+        'description: The channels you follow. Per-channel learned signal lives in channels/<slug>.md.',
+        `updated: ${date}`, '---', '', '# Channels', '',
+    ];
+    for (const c of entries)
+        parts.push(`- [${c.handle}](${channelUrl(c.handle)}) → [[channels/${c.slug}]]`);
+    return parts.join('\n') + '\n';
+}
+/** state.md — one flat table; baseline rows use "—" pointers and the lookback date. */
+export function serializeState(rows, date = today()) {
+    const parts = [
+        '---', 'type: yt-state', 'name: yt-state',
+        'description: Per-channel per-type cursor. The sweep reads and updates it.',
+        `updated: ${date}`, '---', '', '# State', '',
+        '| Channel | last_longform_id | last_short_id | last_live_id | updated | session |',
+        '|---|---|---|---|---|---|',
+    ];
+    for (const r of rows) {
+        parts.push(`| ${r.handle} | ${r.last_longform_id ?? '—'} | ${r.last_short_id ?? '—'} | ${r.last_live_id ?? '—'} | ${r.updated ?? lookbackDate()} | ${r.session} |`);
+    }
+    return parts.join('\n') + '\n';
+}
+/** A fresh, empty channel profile (learned signal accumulates here as you rate). */
+export function profileBody(handle, slug, date = today()) {
+    return [
+        '---', 'type: yt-channel-profile', `name: ${slug}-profile`,
+        `channel: ${handle}`, `channel_url: ${channelUrl(handle)}`, `updated: ${date}`,
+        'sessions_observed: 0', '---', '', `# ${handle} — Profile`, '',
+    ].join('\n') + '\n';
+}

package/dist/yt-channels.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * Add, remove, or list the channels you follow — keeping channels.md, state.md, and the
+ * per-channel profile in sync. Driven by the CLI: `yt-briefing add|remove|list ...`.
+ *
+ *   yt-briefing add @foo https://youtube.com/@bar   # add one or more (handle or URL)
+ *   yt-briefing remove @foo                          # remove (also deletes its profile)
+ *   yt-briefing list                                 # show the current list
+ *
+ * Adding a channel starts it at "baseline" (next sweep surfaces the latest upload per type);
+ * removing one drops its row and learned profile. Existing channels' cursors are untouched.
+ */
+import { existsSync, readFileSync, writeFileSync, rmSync } from 'node:fs';
+import { CHANNELS_MD, STATE_MD, profilePath } from "./lib/paths.js";
+import { parseChannels, parseState } from "./lib/yt-lib.js";
+import { normalizeHandle, slugify, serializeChannels, serializeState, profileBody, baselineStateRow, } from "./lib/channels.js";
+const [action, ...args] = process.argv.slice(2);
+if (!existsSync(CHANNELS_MD) || !existsSync(STATE_MD)) {
+    console.error('No channel list yet — run onboarding first: yt-briefing init');
+    process.exit(1);
+}
+let entries = parseChannels(readFileSync(CHANNELS_MD, 'utf8'));
+if (action === 'list') {
+    for (const e of entries)
+        console.log(`  ${e.handle}`);
+    console.log(`\n  ${entries.length} channel(s).`);
+    process.exit(0);
+}
+if ((action !== 'add' && action !== 'remove') || args.length === 0) {
+    console.error('Usage: yt-briefing add|remove <@handle | url> [...]   ·   yt-briefing list');
+    process.exit(1);
+}
+let rows = parseState(readFileSync(STATE_MD, 'utf8'));
+let changed = 0;
+for (const raw of args) {
+    const handle = normalizeHandle(raw);
+    if (!handle) {
+        console.log(`  ! couldn't read a handle from "${raw}" — use @name or the channel URL`);
+        continue;
+    }
+    const slug = slugify(handle);
+    const exists = entries.some(e => e.slug === slug);
+    if (action === 'add') {
+        if (exists) {
+            console.log(`  • ${handle} already on the list — skipping`);
+            continue;
+        }
+        entries.push({ handle, slug });
+        rows.push(baselineStateRow(handle));
+        writeFileSync(profilePath(slug), profileBody(handle, slug), 'utf8');
+        console.log(`  + ${handle}`);
+        changed++;
+    }
+    else {
+        if (!exists) {
+            console.log(`  • ${handle} not on the list — skipping`);
+            continue;
+        }
+        const entry = entries.find(e => e.slug === slug);
+        entries = entries.filter(e => e.slug !== slug);
+        rows = rows.filter(r => r.handle !== entry.handle);
+        try {
+            rmSync(profilePath(slug));
+        }
+        catch { /* profile already gone */ }
+        console.log(`  − ${handle}  (profile deleted)`);
+        changed++;
+    }
+}
+if (changed) {
+    writeFileSync(CHANNELS_MD, serializeChannels(entries), 'utf8');
+    writeFileSync(STATE_MD, serializeState(rows), 'utf8');
+}
+console.log(`\n  ${entries.length} channel(s) now. The next sweep picks up the change.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yt-briefing",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A self-learning YouTube briefing engine: it sweeps the channels you follow, filters noise in two stages (title, then transcript), summarizes the rest in your language, and adapts to your ratings — one video at a time.",
   "type": "module",
   "bin": {