fixup! diigo-cache: RSS in diigo's export shape, from cached items

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

@@ -1,10 +1,5 @@
 #!/usr/bin/env node
-/**
+/** @file program script: does a cache hold everything in a diigo RSS export? See {@link main}. */
- * @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>
- */
 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).
  *

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. */
- * @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.
- */
 
 import type { Item } from "./items.js";