ctxr-cli 0.25.0 → 0.27.0

package/dist/core/git/land-lock.js

@@ -0,0 +1,91 @@
+import { hostname } from 'node:os';
+import { open, readFile, stat, unlink } from 'node:fs/promises';
+import { unlinkSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * write-lifecycle spec ("One landing runs per repository at a time";
+ * serve-lands-approved-changes D4): an exclusive pid file in the repository's
+ * common git directory, which every worktree and every container mounting the
+ * store shares — the same shape git uses for `index.lock`.
+ *
+ * Stale when its process is gone. Only the host that wrote it can tell, so a
+ * lock from another host (another container) is stale only once it is older
+ * than any landing run could be.
+ */
+export const LAND_LOCK_FILE = 'ctxr-land.lock';
+const FOREIGN_STALE_MS = 2 * 60 * 60 * 1000;
+function alive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // EPERM: it exists but belongs to someone else.
+        return err.code === 'EPERM';
+    }
+}
+async function readHolder(file) {
+    try {
+        const parsed = JSON.parse(await readFile(file, 'utf8'));
+        return typeof parsed.pid === 'number' && typeof parsed.host === 'string' ? { pid: parsed.pid, host: parsed.host } : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function stale(file, holder, now) {
+    if (holder !== null && holder.host === hostname())
+        return !alive(holder.pid);
+    try {
+        return now - (await stat(file)).mtimeMs > FOREIGN_STALE_MS;
+    }
+    catch {
+        return true;
+    }
+}
+export async function acquireLandLock(git, cwd, now = Date.now) {
+    const common = (await git.run(['rev-parse', '--git-common-dir'], { cwd })).stdout.trim();
+    const file = path.join(path.resolve(cwd, common), LAND_LOCK_FILE);
+    const me = { pid: process.pid, host: hostname() };
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            const handle = await open(file, 'wx');
+            await handle.writeFile(JSON.stringify(me));
+            await handle.close();
+        }
+        catch (err) {
+            if (err.code !== 'EEXIST')
+                throw err;
+            const holder = await readHolder(file);
+            if (attempt === 0 && (await stale(file, holder, now()))) {
+                await unlink(file).catch(() => undefined);
+                continue;
+            }
+            return { acquired: false, holder: holder ?? { pid: 0, host: 'unknown' } };
+        }
+        // A landing stopped by its parent (serve shutting down) must not leave the lock behind.
+        const onSignal = (signal) => {
+            try {
+                unlinkSync(file);
+            }
+            catch {
+                // already gone
+            }
+            process.exit(signal === 'SIGINT' ? 130 : 143);
+        };
+        process.once('SIGTERM', onSignal);
+        process.once('SIGINT', onSignal);
+        return {
+            acquired: true,
+            async release() {
+                process.off('SIGTERM', onSignal);
+                process.off('SIGINT', onSignal);
+                const holder = await readHolder(file);
+                if (holder?.pid === me.pid && holder.host === me.host)
+                    await unlink(file).catch(() => undefined);
+            },
+        };
+    }
+    return { acquired: false, holder: { pid: 0, host: 'unknown' } };
+}
+//# sourceMappingURL=land-lock.js.map

package/dist/core/git/land-lock.js.map

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

package/dist/core/publish/lifespan.d.ts

@@ -26,12 +26,12 @@ export declare const DISPOSABLE_REVIEW_DAYS = 30;
  */
 export declare function lifespanOf(relativePath: string, publishPath: string): PageLifespan | null;
 /**
- * The calendar date leading a disposable page's folder name, as `YYYY-MM-DD`,
- * or `null` when the name carries none or the date is not a real one
- * (`2026-13-45`, `2026-02-30`). Round-tripping through `Date.UTC` is what
- * rejects a day the month does not have.
+ * The calendar date leading a dated name, as `YYYY-MM-DD`, or `null` when the
+ * name carries none or the date is not a real one (`2026-13-45`,
+ * `2026-02-30`). Round-tripping through `Date.UTC` is what rejects a day the
+ * month does not have.
  */
-export declare function parseDisposableDate(folderName: string): string | null;
+export declare function parseLeadingDate(name: string): string | null;
 /** Whole days from `date` to `today`, both `YYYY-MM-DD`. */
 export declare function daysBetween(date: string, today: string): number;
 //# sourceMappingURL=lifespan.d.ts.map

package/dist/core/publish/lifespan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifespan.d.ts","sourceRoot":"","sources":["../../../src/core/publish/lifespan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAEtD;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAE/C,mHAAmH;AACnH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAMzC;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAMzF;AAKD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOrE;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D"}
+{"version":3,"file":"lifespan.d.ts","sourceRoot":"","sources":["../../../src/core/publish/lifespan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAEtD;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAE/C,mHAAmH;AACnH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAMzC;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAMzF;AAUD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO5D;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/dist/core/publish/lifespan.js

@@ -34,16 +34,21 @@ export function lifespanOf(relativePath, publishPath) {
     const firstSegment = normalized.slice(prefix.length + 1).split('/')[0];
     return firstSegment === DISPOSABLE_SEGMENT ? 'disposable' : 'permanent';
 }
-/** The `YYYY-MM-DD-` lead a disposable page's folder name carries, stamped by `ctxr publish new --disposable`. */
-const DISPOSABLE_DATE_RE = /^(\d{4})-(\d{2})-(\d{2})-./;
 /**
- * The calendar date leading a disposable page's folder name, as `YYYY-MM-DD`,
- * or `null` when the name carries none or the date is not a real one
- * (`2026-13-45`, `2026-02-30`). Round-tripping through `Date.UTC` is what
- * rejects a day the month does not have.
+ * The `YYYY-MM-DD-` lead of a dated name: a disposable page's folder, stamped
+ * by `ctxr publish new --disposable`, and a page's send copy without its
+ * extension (file-pdfs-beside-their-page D4). At least one character
+ * must follow the date.
  */
-export function parseDisposableDate(folderName) {
-    const match = DISPOSABLE_DATE_RE.exec(folderName);
+const LEADING_DATE_RE = /^(\d{4})-(\d{2})-(\d{2})-./;
+/**
+ * The calendar date leading a dated name, as `YYYY-MM-DD`, or `null` when the
+ * name carries none or the date is not a real one (`2026-13-45`,
+ * `2026-02-30`). Round-tripping through `Date.UTC` is what rejects a day the
+ * month does not have.
+ */
+export function parseLeadingDate(name) {
+    const match = LEADING_DATE_RE.exec(name);
     if (!match)
         return null;
     const [year, month, day] = [Number(match[1]), Number(match[2]), Number(match[3])];

package/dist/core/publish/lifespan.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifespan.js","sourceRoot":"","sources":["../../../src/core/publish/lifespan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE/C,mHAAmH;AACnH,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,OAAO,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,YAAoB,EAAE,WAAmB;IAClE,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,YAAY,KAAK,kBAAkB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;AAC1E,CAAC;AAED,kHAAkH;AAClH,MAAM,kBAAkB,GAAG,4BAA4B,CAAC;AAExD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,IAAI,IAAI,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACjH,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAa;IACrD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;AACvG,CAAC"}
+{"version":3,"file":"lifespan.js","sourceRoot":"","sources":["../../../src/core/publish/lifespan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE/C,mHAAmH;AACnH,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,OAAO,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,YAAoB,EAAE,WAAmB;IAClE,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,YAAY,KAAK,kBAAkB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;AAC1E,CAAC;AAED;;;;;GAKG;AACH,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAErD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,IAAI,IAAI,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACjH,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAa;IACrD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;AACvG,CAAC"}

package/dist/core/publish/send-copies.d.ts

@@ -0,0 +1,12 @@
+/**
+ * send-copies-beside-their-page: a send copy is a file built from a note and
+ * sent to someone — a record of what went out on a day. Directly in a page
+ * folder, beside `index.html`, a file in one of these formats is one; anywhere
+ * below it, the same file is an input the page uses (file-pdfs-beside-their-page
+ * D3). A closed list, so a missed format goes unchecked rather than failing a
+ * page over a file nobody sent (D1). Adding a format is one entry here.
+ */
+export declare const SEND_COPY_EXTENSIONS: readonly string[];
+/** The send-copy extension `fileName` carries, lower-cased, or `null` when it is not a send copy. */
+export declare function sendCopyExtension(fileName: string): string | null;
+//# sourceMappingURL=send-copies.d.ts.map

package/dist/core/publish/send-copies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-copies.d.ts","sourceRoot":"","sources":["../../../src/core/publish/send-copies.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAwC,CAAC;AAE3F,qGAAqG;AACrG,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGjE"}

package/dist/core/publish/send-copies.js

@@ -0,0 +1,15 @@
+/**
+ * send-copies-beside-their-page: a send copy is a file built from a note and
+ * sent to someone — a record of what went out on a day. Directly in a page
+ * folder, beside `index.html`, a file in one of these formats is one; anywhere
+ * below it, the same file is an input the page uses (file-pdfs-beside-their-page
+ * D3). A closed list, so a missed format goes unchecked rather than failing a
+ * page over a file nobody sent (D1). Adding a format is one entry here.
+ */
+export const SEND_COPY_EXTENSIONS = ['.pdf', '.docx', '.xlsx', '.pptx'];
+/** The send-copy extension `fileName` carries, lower-cased, or `null` when it is not a send copy. */
+export function sendCopyExtension(fileName) {
+    const lower = fileName.toLowerCase();
+    return SEND_COPY_EXTENSIONS.find((extension) => lower.endsWith(extension)) ?? null;
+}
+//# sourceMappingURL=send-copies.js.map

package/dist/core/publish/send-copies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-copies.js","sourceRoot":"","sources":["../../../src/core/publish/send-copies.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAE3F,qGAAqG;AACrG,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,IAAI,CAAC;AACrF,CAAC"}

package/dist/version.d.ts

@@ -1,5 +1,5 @@
 /** Kept in sync with package.json's "version" field. */
-export declare const CLI_VERSION = "0.25.0";
+export declare const CLI_VERSION = "0.27.0";
 /**
  * The npm package this executable is published as. Bound here, beside the
  * version, because the release check resolves the latest published release by

package/dist/version.js

@@ -1,5 +1,5 @@
 /** Kept in sync with package.json's "version" field. */
-export const CLI_VERSION = '0.25.0';
+export const CLI_VERSION = '0.27.0';
 /**
  * The npm package this executable is published as. Bound here, beside the
  * version, because the release check resolves the latest published release by

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctxr-cli",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "description": "Context store for AI coding agents — markdown and git, catalog and graph retrieval, no vector database.",
   "type": "module",
   "license": "MIT",

package/templates/skills/ctxr-publish.md

@@ -96,7 +96,8 @@ this choice. Why: a page filed under a word that names nothing helps no reader.
 
 Never start the page's own name with a date (`YYYY-` or `YYYY-MM-DD-`). That naming is reserved for
 the frozen pages that `ctxr publish new --disposable` makes. The rule applies to the final segment, not
-to the folders above it. The command refuses to overwrite an existing folder. If a folder already
+to the folders above it. It does not apply to a send copy in the page's folder, which starts with
+the date you made it (step 8). The command refuses to overwrite an existing folder. If a folder already
 exists for this subject, edit its files directly. Do not run `publish new` again. Why: a rename or an
 overwrite breaks a link that somebody already has.
 
@@ -133,6 +134,8 @@ Run `ctxr publish check <path>`. It runs the mechanical half of the checklist:
   with a real date at the start of its name;
 - for a permanent page, the note it represents (`represented-note`) and that note's recorded hash
   (`represented-note-hash`).
+- for each send copy at the page folder's root, a file name that starts with a real date
+  (`send-copy-name`).
 
 The command reports the page's lifespan. It exits non-zero and names every failing check. Fix all of
 them before you report the page as ready. The command answers only what the files can show. Why: the
@@ -186,6 +189,39 @@ changed after the stamp. To confirm a stale page, do these steps in order:
 `ctxr publish stamp` never overwrites a marker. Why: a stamp without a review confirms nothing, so
 the stale report stays until somebody removes the marker.
 
+**Send copies of the page.** A send copy is a file that you make from the note and send to somebody.
+It is a `.pdf`, `.docx`, `.xlsx` or `.pptx` file. Make a send copy only when you send one. Why: every
+send copy is kept, so a send copy for each edit fills the folder.
+
+Write the send copy into the page's folder, next to `index.html`. Start its file name with the date
+you make it: `<YYYY-MM-DD>-<name>.<extension>`. `ctxr publish check` fails a send copy at the folder
+root that has no real date (`send-copy-name`). `ctxr publish check --json` lists each send copy with
+its address. Give that address when you hand on the send copy.
+
+A send copy is never a page on its own. A document that you send as a PDF, a Word file, a workbook or
+a deck still needs an `index.html` for the same content. Why: every command that reads pages finds a
+page by its `index.html`. The stamp on its README then reports the page and its send copies as stale
+together.
+
+When the page changes, write a new dated send copy. Do not change or remove an earlier one. Why: an
+earlier file can be the one a recipient got, and the folder then shows what you sent on each date.
+
+Put a file that the page uses, but that you did not make, in the page's `assets/` folder. Why:
+`ctxr publish check` reads only the files at the folder root as the page's send copies.
+
+The store chooses how to make a send copy. You can print `index.html` to a PDF, because it already
+has a print rule. You can also use the store's own document or spreadsheet skill. Contexture does not
+make send copies.
+
+**A file that is its own source.** Some office files are not made from a note. An example is a
+financial model that somebody edits by hand in a spreadsheet. Do not publish that file. Keep it in
+the store, next to the note that describes it, with no date in its name. Why: the file is the source,
+and the note describes it. A published copy would sit where retrieval does not look, and the stale
+report would treat the note as the source. Git keeps the file's history. When you send a copy of the
+file to somebody, that copy is a send copy: write it, dated, into the page's folder.
+
+A file that you received from somebody is a capture. File it where the store keeps its captures.
+
 Never revise a disposable page after it lands. Why: it is a snapshot of one moment, and its link
 shows that moment. Make a new disposable page instead. Do not remove a disposable page yourself.
 `ctxr lint` lists disposable pages that are older than 30 days, and the operator decides which to