From 76b9ed1494002bfe13c14dff025d737ba74d3492 Mon Sep 17 00:00:00 2001
From: Dan Connolly <dckc@madmode.com>
Date: Wed, 7 Oct 2026 09:34:06 -0500
Subject: [PATCH] fixup! diigo-cache: RSS in diigo's export shape, from cached
 items
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Docs per the docs-files-api skill: a 1–2 line @file; what a declaration is or does in JSDoc on it, not in // comments or the file header.

Generated-by: Claude Opus 5.5
---
 diigo-cache/scripts/compare-export.ts | 10 ++++------
 diigo-cache/src/rss.ts                |  6 +-----
 2 files changed, 5 insertions(+), 11 deletions(-)

diff --git a/diigo-cache/scripts/compare-export.ts b/diigo-cache/scripts/compare-export.ts
index 9715ac0..5cb9208 100644
--- a/diigo-cache/scripts/compare-export.ts
+++ b/diigo-cache/scripts/compare-export.ts
@@ -1,10 +1,5 @@
 #!/usr/bin/env node
-/**
- * @file program script: does a cache hold everything in a diigo RSS
- * export? See {@link main}.
- *
- *     node scripts/compare-export.ts <cache.sqlite> <export.xml> <out-dir>
- */
+/** @file program script: does a cache hold everything in a diigo RSS export? See {@link main}. */
 import * as nodeFs from "node:fs/promises";
 import { basename, join } from "node:path";
 import { DatabaseSync } from "node:sqlite";
@@ -107,6 +102,9 @@ export function outDir(fs: Pick<typeof nodeFs, "writeFile">, dir: string) {
 /**
  * Generates RSS from a cache's items (src/rss.ts) and compares it with a
  * diigo RSS export: title, tags, description, highlights + sticky notes.
+ *
+ *     node scripts/compare-export.ts <cache.sqlite> <export.xml> <out-dir>
+ *
  * Prints counts to stdout; writes <out-dir>/from-cache.rss and
  * <out-dir>/report.json (mismatched links, by category).
  *
diff --git a/diigo-cache/src/rss.ts b/diigo-cache/src/rss.ts
index d32ed59..dba55aa 100644
--- a/diigo-cache/src/rss.ts
+++ b/diigo-cache/src/rss.ts
@@ -1,8 +1,4 @@
-/**
- * @file cached diigo items as RSS 2.0, in the shape of diigo's RSS export
- * (`Tags:…;Description:…;Annotations and Sticky notes:…`), but well-formed
- * and with titles uncut. Pure: the caller supplies the dates.
- */
+/** @file cached diigo items as RSS 2.0, in the shape of diigo's RSS export. */
 
 import type { Item } from "./items.js";