ctxr-cli 0.23.0 → 0.25.0

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

@@ -22,6 +22,13 @@ export interface Filing {
     /** The segment naming the subject note, present only when D3 inserts one. */
     subject_segment: string | null;
     moves: FilingMove[];
+    /**
+     * Why no path derives, when `prefix` is null: no folder path names the
+     * subject (`store-root`), or the derived path's first segment is the one
+     * reserved for disposable pages (`reserved-segment`,
+     * two-kinds-of-published-page D2). Null whenever a path derives.
+     */
+    no_path_reason: 'store-root' | 'reserved-segment' | null;
 }
 /**
  * Re-exported from `core/slug.ts`, which owns the one normalization rule; the
@@ -30,18 +37,11 @@ export interface Filing {
  */
 export { slugifyPath, slugifySegment };
 /**
- * design.md D2: the group folder comes from the SELECTOR, never from where the
- * resolved notes live. The deepest common ancestor of a real store's resolved
- * set collapses to the store root — a page cites the role, the person, and
- * three reference notes — which would name no folder at all, file the page flat
- * at the publish root, and make `publish check` fail a page this command had
- * just told the author to create.
- *
- * D3: the segment naming the subject note is inserted exactly when that subject
- * already has a page, so a one-page subject stays shallow and a multi-page one
- * collects; and when the folder path is empty, so a subject at the store root
- * still yields a path one level deep and satisfies `checkPageLocation`'s floor
- * by construction.
+ * two-kinds-of-published-page D2: the first segment under the publish path
+ * named `disposable` is reserved for disposable pages, and a store folder named
+ * "Disposable" slugifies to exactly it. A path derived into it is reported as no
+ * path at all, with the reservation as the reason — the existing "no path
+ * derives" outcome with a second reason, so gather still gates nothing.
  */
 export declare function deriveFiling(storeRoot: string, publishPath: string, subject: FilingSubject): Promise<Filing>;
 //# sourceMappingURL=filing.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"filing.d.ts","sourceRoot":"","sources":["../../../src/core/publish/filing.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzD,8GAA8G;AAC9G,MAAM,WAAW,aAAa;IAC5B,+FAA+F;IAC/F,SAAS,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,oHAAoH;IACpH,UAAU,EAAE,aAAa,GAAG,WAAW,CAAC;CACzC;AAED,MAAM,WAAW,MAAM;IACrB,kHAAkH;IAClH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,oGAAoG;IACpG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,uHAAuH;IACvH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,6EAA6E;IAC7E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;AAsFvC;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClH"}
+{"version":3,"file":"filing.d.ts","sourceRoot":"","sources":["../../../src/core/publish/filing.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIzD,8GAA8G;AAC9G,MAAM,WAAW,aAAa;IAC5B,+FAA+F;IAC/F,SAAS,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,oHAAoH;IACpH,UAAU,EAAE,aAAa,GAAG,WAAW,CAAC;CACzC;AAED,MAAM,WAAW,MAAM;IACrB,kHAAkH;IAClH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,oGAAoG;IACpG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,uHAAuH;IACvH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,6EAA6E;IAC7E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB;;;;;OAKG;IACH,cAAc,EAAE,YAAY,GAAG,kBAAkB,GAAG,IAAI,CAAC;CAC1D;AAED;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;AAsGvC;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAOlH"}

package/dist/core/publish/filing.js

@@ -2,9 +2,9 @@ import { existsSync } from 'node:fs';
 import { readFile, readdir } from 'node:fs/promises';
 import path from 'node:path';
 import { PUBLISH_INDEX_FILE } from '../browse/routes.js';
-import { extractLinkTargets } from '../graph/model.js';
-import { parseNoteText } from '../notes/parse.js';
 import { slugifyPath, slugifySegment } from '../slug.js';
+import { DISPOSABLE_SEGMENT } from './lifespan.js';
+import { readLeadLink } from './represents.js';
 /**
  * Re-exported from `core/slug.ts`, which owns the one normalization rule; the
  * filing module was where it was first written and is still where most callers
@@ -47,10 +47,10 @@ async function readmeLeadsWithStem(absolutePageDirectory, stem) {
     catch {
         return false;
     }
-    // Parsed rather than grepped so frontmatter is excluded, matching how
-    // `publish check` reads the same file and how the graph resolves a wikilink.
-    // `extractLinkTargets` reports occurrences in body order, so [0] is the lead.
-    return extractLinkTargets(parseNoteText(raw, readmePath).body)[0] === stem;
+    // two-kinds-of-published-page D4: the one reading of a README's lead link,
+    // shared with `publish check`'s represented-note check so the two cannot
+    // diverge on whose page a page is.
+    return readLeadLink(raw, readmePath)?.target === stem;
 }
 async function pagesForNote(publishRoot, group, subjectSlug, noteStem) {
     const subjectDirectory = group === '' ? subjectSlug : `${group}/${subjectSlug}`;
@@ -69,20 +69,22 @@ async function pagesForNote(publishRoot, group, subjectSlug, noteStem) {
     return found;
 }
 /**
- * design.md D2: the group folder comes from the SELECTOR, never from where the
- * resolved notes live. The deepest common ancestor of a real store's resolved
- * set collapses to the store root — a page cites the role, the person, and
- * three reference notes — which would name no folder at all, file the page flat
- * at the publish root, and make `publish check` fail a page this command had
- * just told the author to create.
- *
- * D3: the segment naming the subject note is inserted exactly when that subject
- * already has a page, so a one-page subject stays shallow and a multi-page one
- * collects; and when the folder path is empty, so a subject at the store root
- * still yields a path one level deep and satisfies `checkPageLocation`'s floor
- * by construction.
+ * two-kinds-of-published-page D2: the first segment under the publish path
+ * named `disposable` is reserved for disposable pages, and a store folder named
+ * "Disposable" slugifies to exactly it. A path derived into it is reported as no
+ * path at all, with the reservation as the reason — the existing "no path
+ * derives" outcome with a second reason, so gather still gates nothing.
  */
 export async function deriveFiling(storeRoot, publishPath, subject) {
+    const filing = await deriveUnreservedFiling(storeRoot, publishPath, subject);
+    if (filing.prefix === null)
+        return { ...filing, no_path_reason: 'store-root' };
+    if (filing.prefix.split('/')[0] === DISPOSABLE_SEGMENT) {
+        return { prefix: null, path: null, group: filing.group, subject_segment: null, moves: [], no_path_reason: 'reserved-segment' };
+    }
+    return { ...filing, no_path_reason: null };
+}
+async function deriveUnreservedFiling(storeRoot, publishPath, subject) {
     const publishPrefix = publishPath.split(path.sep).join('/').replace(/\/+$/, '');
     const publishRoot = path.join(storeRoot, ...publishPrefix.split('/'));
     const group = slugifyPath(subject.directory);

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * two-kinds-of-published-page: a page's lifespan, read from where it is filed
+ * and from nothing else (design.md D3). A page whose folder's first segment
+ * under the configured publish path is `disposable` is disposable; every
+ * other page is permanent, so every page that predates this change is
+ * permanent without being touched.
+ */
+export type PageLifespan = 'permanent' | 'disposable';
+/**
+ * D2: a fixed segment, not a config key — a key would have to be opt-in with
+ * no shipped default, which makes the feature off in every store. The plain
+ * word can collide with a store folder named "Disposable" (it slugifies to
+ * exactly this), so the name is RESERVED rather than unreachable: `publish new`
+ * refuses a slug spelled into it without `--disposable`, `publish gather`
+ * derives no filing path into it, and `publish check` reads anything filed
+ * there as disposable and fails its shape. `_disposable` would have made the
+ * collision structurally impossible, and lost on how it reads in a URL.
+ */
+export declare const DISPOSABLE_SEGMENT = "disposable";
+/** D6: the window after which lint lists a disposable page as a removal candidate. A code constant, not config. */
+export declare const DISPOSABLE_REVIEW_DAYS = 30;
+/**
+ * The lifespan of a page (or any file under it), given its store-relative
+ * path. `null` when the path is not under the configured publish path — such
+ * a file is not a published page and has no lifespan.
+ */
+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.
+ */
+export declare function parseDisposableDate(folderName: 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

@@ -0,0 +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"}

package/dist/core/publish/lifespan.js

@@ -0,0 +1,59 @@
+/**
+ * two-kinds-of-published-page: a page's lifespan, read from where it is filed
+ * and from nothing else (design.md D3). A page whose folder's first segment
+ * under the configured publish path is `disposable` is disposable; every
+ * other page is permanent, so every page that predates this change is
+ * permanent without being touched.
+ */
+/**
+ * D2: a fixed segment, not a config key — a key would have to be opt-in with
+ * no shipped default, which makes the feature off in every store. The plain
+ * word can collide with a store folder named "Disposable" (it slugifies to
+ * exactly this), so the name is RESERVED rather than unreachable: `publish new`
+ * refuses a slug spelled into it without `--disposable`, `publish gather`
+ * derives no filing path into it, and `publish check` reads anything filed
+ * there as disposable and fails its shape. `_disposable` would have made the
+ * collision structurally impossible, and lost on how it reads in a URL.
+ */
+export const DISPOSABLE_SEGMENT = 'disposable';
+/** D6: the window after which lint lists a disposable page as a removal candidate. A code constant, not config. */
+export const DISPOSABLE_REVIEW_DAYS = 30;
+function normalizedPrefix(publishPath) {
+    return publishPath.replace(/\\/g, '/').replace(/\/+$/, '');
+}
+/**
+ * The lifespan of a page (or any file under it), given its store-relative
+ * path. `null` when the path is not under the configured publish path — such
+ * a file is not a published page and has no lifespan.
+ */
+export function lifespanOf(relativePath, publishPath) {
+    const prefix = normalizedPrefix(publishPath);
+    const normalized = relativePath.replace(/\\/g, '/');
+    if (!normalized.startsWith(`${prefix}/`))
+        return null;
+    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.
+ */
+export function parseDisposableDate(folderName) {
+    const match = DISPOSABLE_DATE_RE.exec(folderName);
+    if (!match)
+        return null;
+    const [year, month, day] = [Number(match[1]), Number(match[2]), Number(match[3])];
+    const date = new Date(Date.UTC(year, month - 1, day));
+    if (date.getUTCFullYear() !== year || date.getUTCMonth() !== month - 1 || date.getUTCDate() !== day)
+        return null;
+    return `${match[1]}-${match[2]}-${match[3]}`;
+}
+/** Whole days from `date` to `today`, both `YYYY-MM-DD`. */
+export function daysBetween(date, today) {
+    return Math.round((Date.parse(`${today}T00:00:00Z`) - Date.parse(`${date}T00:00:00Z`)) / 86_400_000);
+}
+//# sourceMappingURL=lifespan.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,72 @@
+import type { Note } from '../notes/list.js';
+/**
+ * two-kinds-of-published-page design.md D4: the note a permanent page
+ * represents is the FIRST wikilink in its README's body, frontmatter
+ * excluded. `filing.ts` reads the same link to decide whose page a page is,
+ * so the reading lives here once and both call it — a page `gather` counts as
+ * a subject's and a page `check` says represents that subject cannot disagree.
+ */
+export interface LeadLink {
+    /** The wikilink target as written: the stem before any `|alias` or `#heading`. */
+    target: string;
+    /** Zero-based index of the raw README line holding it, frontmatter lines counted. */
+    line: number;
+}
+/**
+ * Parsed rather than grepped so frontmatter is excluded, matching how the graph
+ * resolves a wikilink. `extractLinkTargets` reports occurrences in body order,
+ * so the first line that yields one holds the lead.
+ */
+export declare function readLeadLink(readmeRaw: string, readmePath: string): LeadLink | null;
+export type RepresentedResolution = {
+    note: Note;
+} | {
+    none: true;
+} | {
+    ambiguous: string[];
+};
+/**
+ * By filename stem, through the one stem index every wikilink resolution in the
+ * system reads (`buildStemIndex`): exactly one note resolves, zero or two-plus
+ * do not. The candidates are named so the author can qualify the link.
+ */
+export declare function resolveRepresented(notes: readonly Note[], stem: string): RepresentedResolution;
+export declare function readHashMarker(line: string): string | null;
+/**
+ * D5: the marker is written once and never overwritten. A line that already
+ * carries one comes back unchanged — confirming a page against a changed note
+ * takes removing the marker by hand and stamping again.
+ */
+export declare function appendHashMarker(line: string, hash: string): string;
+/** The represented note's hash — `contentHashOfBody`, imported and never re-spelled. */
+export declare function representedNoteHash(note: Note): string;
+export type Representation = {
+    status: 'no-link';
+} | {
+    status: 'not-found';
+    target: string;
+} | {
+    status: 'ambiguous';
+    target: string;
+    candidates: string[];
+} | {
+    status: 'not-stamped';
+    note: string;
+    hash: string;
+    lead: LeadLink;
+} | {
+    status: 'stale';
+    note: string;
+    hash: string;
+    recorded: string;
+    lead: LeadLink;
+} | {
+    status: 'current';
+    note: string;
+    hash: string;
+    lead: LeadLink;
+};
+/** Where a permanent page stands against its note — one reading for `publish check`, `publish stamp` and lint. */
+export declare function assessRepresentation(readmeRaw: string, readmePath: string, notes: readonly Note[]): Representation;
+export declare function readReadme(readmeAbsolutePath: string): Promise<string | null>;
+//# sourceMappingURL=represents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"represents.d.ts","sourceRoot":"","sources":["../../../src/core/publish/represents.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAG7C;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CASnF;AAED,MAAM,MAAM,qBAAqB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE9F;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAK9F;AAKD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEtD;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GAC7D;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GACrE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GACjF;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEtE,kHAAkH;AAClH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,cAAc,CAWlH;AAED,wBAAsB,UAAU,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOnF"}

package/dist/core/publish/represents.js

@@ -0,0 +1,83 @@
+import { readFile } from 'node:fs/promises';
+import { contentHashOfBody } from '../content/canonicalize.js';
+import { buildStemIndex, extractLinkTargets } from '../graph/model.js';
+import { parseNoteText } from '../notes/parse.js';
+/**
+ * Parsed rather than grepped so frontmatter is excluded, matching how the graph
+ * resolves a wikilink. `extractLinkTargets` reports occurrences in body order,
+ * so the first line that yields one holds the lead.
+ */
+export function readLeadLink(readmeRaw, readmePath) {
+    const { body } = parseNoteText(readmeRaw, readmePath);
+    const frontmatterLines = readmeRaw.slice(0, readmeRaw.length - body.length).split('\n').length - 1;
+    const lines = body.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const target = extractLinkTargets(lines[i])[0];
+        if (target !== undefined)
+            return { target, line: frontmatterLines + i };
+    }
+    return null;
+}
+/**
+ * By filename stem, through the one stem index every wikilink resolution in the
+ * system reads (`buildStemIndex`): exactly one note resolves, zero or two-plus
+ * do not. The candidates are named so the author can qualify the link.
+ */
+export function resolveRepresented(notes, stem) {
+    const paths = buildStemIndex(notes).get(stem) ?? [];
+    if (paths.length === 0)
+        return { none: true };
+    if (paths.length > 1)
+        return { ambiguous: [...paths].sort() };
+    return { note: notes.find((note) => note.path === paths[0]) };
+}
+/** The catalog's frozen-hash form, so an agent that has learned one has learned both (D5). */
+const HASH_MARKER_RE = /\s*<!-- hash:([0-9a-f]{16}) -->/;
+export function readHashMarker(line) {
+    return HASH_MARKER_RE.exec(line)?.[1] ?? null;
+}
+/**
+ * D5: the marker is written once and never overwritten. A line that already
+ * carries one comes back unchanged — confirming a page against a changed note
+ * takes removing the marker by hand and stamping again.
+ */
+export function appendHashMarker(line, hash) {
+    if (readHashMarker(line) !== null)
+        return line;
+    // A CRLF file's line keeps its `\r`, so nothing but the marker changes.
+    const ending = line.endsWith('\r') ? '\r' : '';
+    return `${line.replace(/\s+$/, '')} <!-- hash:${hash} -->${ending}`;
+}
+/** The represented note's hash — `contentHashOfBody`, imported and never re-spelled. */
+export function representedNoteHash(note) {
+    return contentHashOfBody(note.body);
+}
+/** Where a permanent page stands against its note — one reading for `publish check`, `publish stamp` and lint. */
+export function assessRepresentation(readmeRaw, readmePath, notes) {
+    const lead = readLeadLink(readmeRaw, readmePath);
+    if (lead === null)
+        return { status: 'no-link' };
+    const resolved = resolveRepresented(notes, lead.target);
+    if ('none' in resolved)
+        return { status: 'not-found', target: lead.target };
+    if ('ambiguous' in resolved)
+        return { status: 'ambiguous', target: lead.target, candidates: resolved.ambiguous };
+    const hash = representedNoteHash(resolved.note);
+    const recorded = readHashMarker(readmeRaw.split('\n')[lead.line]);
+    if (recorded === null)
+        return { status: 'not-stamped', note: resolved.note.path, hash, lead };
+    if (recorded !== hash)
+        return { status: 'stale', note: resolved.note.path, hash, recorded, lead };
+    return { status: 'current', note: resolved.note.path, hash, lead };
+}
+export async function readReadme(readmeAbsolutePath) {
+    try {
+        return await readFile(readmeAbsolutePath, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+//# sourceMappingURL=represents.js.map

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

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

package/dist/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQhD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,YAAI,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAuIpE,wBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgjBjF"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQhD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,YAAI,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAuIpE,wBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAymBjF"}

package/dist/run.js

@@ -6,9 +6,11 @@ import * as adaptersGenerateCommand from './commands/adapters-generate.js';
 import * as archiveCommand from './commands/archive.js';
 import * as doctorCommand from './commands/doctor.js';
 import * as ingestCommand from './commands/ingest.js';
+import * as landCommand from './commands/land.js';
 import * as lintCommand from './commands/lint.js';
 import * as contextGatherCommand from './commands/context-gather.js';
 import * as graphBuildCommand from './commands/graph-build.js';
+import * as graphDiffCommand from './commands/graph-diff.js';
 import * as entryAppendCommand from './commands/entry-append.js';
 import * as graphQueryCommand from './commands/graph-query.js';
 import * as initCommand from './commands/init.js';
@@ -16,6 +18,8 @@ import * as publishGatherCommand from './commands/publish-gather.js';
 import * as publishCheckCommand from './commands/publish-check.js';
 import * as publishUrlsCommand from './commands/publish-urls.js';
 import * as publishNewCommand from './commands/publish-new.js';
+import * as publishStampCommand from './commands/publish-stamp.js';
+import * as reviewListCommand from './commands/review-list.js';
 import * as sessionCaptureCommand from './commands/session-capture.js';
 import * as sessionListCommand from './commands/session-list.js';
 import * as serveCommand from './commands/serve.js';
@@ -282,6 +286,23 @@ export async function run(argv, env) {
             return graphBuildCommand.execute(store, { emitRecords: cmdOpts.emitRecords });
         });
     });
+    graphCommand
+        .command('diff')
+        .description('how the knowledge changed between two commits: notes, links, dangling links, inbound links, rollups and newly cited sources — read from git, writing nothing')
+        .option('--since <ref>', 'compare from the merge base of this ref and the head (required)')
+        .option('--until <ref>', 'the head commit to compare (default: HEAD)')
+        .option('--format <form>', `the human output: ${graphDiffCommand.GRAPH_DIFF_FORMATS.join(' or ')} (markdown is the pull request's Knowledge changes block; not with --json)`)
+        .action(async (cmdOpts, cmd) => {
+        const { runEnv, jsonMode, root } = deriveRunEnv(env, cmd);
+        const flags = { since: cmdOpts.since, until: cmdOpts.until, format: cmdOpts.format };
+        // review-the-knowledge-diff (D9): `--format markdown` is the whole stdout — the
+        // block rides as the human summary, which the reporter writes verbatim and alone.
+        result = await runCommand('graph.diff', runEnv, jsonMode, async () => {
+            graphDiffCommand.checkFlags(flags, jsonMode);
+            const store = await openStore(runEnv, { root });
+            return graphDiffCommand.execute(store, flags, jsonMode);
+        });
+    });
     const graphQueryCommandGroup = graphCommand.command('query').description('query the built graph');
     graphQueryCommandGroup
         .command('neighbors <node>')
@@ -499,17 +520,28 @@ export async function run(argv, env) {
     });
     publishCommand
         .command('new <slug>')
-        .description('scaffold a page folder with a sibling README, and name the address it is served at — the slug may name a path of folders under the publish path — refusing a reserved or already-existing slug')
-        .action(async (slug, _cmdOpts, cmd) => {
+        .description('scaffold a page folder with a sibling README, and name the address it is served at and its lifespan — the slug may name a path of folders under the publish path — refusing a reserved or already-existing slug; with --disposable, a throwaway page at disposable/<today>-<slug>')
+        .option('--disposable', 'scaffold a disposable page at disposable/<YYYY-MM-DD>-<slug>, dated today by the command (two-kinds-of-published-page)')
+        .action(async (slug, cmdOpts, cmd) => {
         const { runEnv, jsonMode, root } = deriveRunEnv(env, cmd);
         result = await runCommand('publish.new', runEnv, jsonMode, async () => {
             const store = await openStore(runEnv, { root });
-            return publishNewCommand.execute(store, { slug });
+            return publishNewCommand.execute(store, { slug, disposable: cmdOpts.disposable === true });
+        });
+    });
+    publishCommand
+        .command('stamp <path>')
+        .description("record the hash of the note a permanent page represents (its README's lead link) as a marker on that line — once; never overwrites a marker, and refuses a disposable page")
+        .action(async (pagePath, _cmdOpts, cmd) => {
+        const { runEnv, jsonMode, root } = deriveRunEnv(env, cmd);
+        result = await runCommand('publish.stamp', runEnv, jsonMode, async () => {
+            const store = await openStore(runEnv, { root });
+            return publishStampCommand.execute(store, { path: pagePath });
         });
     });
     publishCommand
         .command('check <path>')
-        .description('the mechanized structural checks a published page must pass (no external references, viewport meta, print rule, provenance, sibling README, script syntax), and the address it is served at')
+        .description("the mechanized structural checks a published page must pass (no external references, viewport meta, print rule, provenance, sibling README, script syntax; a disposable page's shape; a permanent page's represented note and its hash), and the page's address and lifespan")
         .action(async (pagePath, _cmdOpts, cmd) => {
         const { runEnv, jsonMode, root } = deriveRunEnv(env, cmd);
         result = await runCommand('publish.check', runEnv, jsonMode, async () => {
@@ -585,6 +617,30 @@ export async function run(argv, env) {
             return verifyCommand.execute(runEnv, store, { portable: cmdOpts.portable });
         });
     });
+    program
+        .command('land')
+        .description('land a session pull request: check consent for its head, catch it up with the default branch, merge, confirm, sync the canonical clone, and remove the worktree')
+        .argument('[pr]', 'the pull request number to land', (v) => Number.parseInt(v, 10))
+        .option('--pending', 'land every open session pull request whose current head carries an approval from the approval page')
+        .option('--confirm', 'the caller already has an explicit go for this pull request; land it without a recorded approval')
+        .action(async (pr, cmdOpts, cmd) => {
+        const { runEnv, jsonMode, root } = deriveRunEnv(env, cmd);
+        result = await runCommand('land', runEnv, jsonMode, async () => {
+            const store = await openStore(runEnv, { root });
+            return landCommand.execute(runEnv, store, { pr, pending: Boolean(cmdOpts.pending), confirm: Boolean(cmdOpts.confirm) });
+        });
+    });
+    const reviewCommand = program.command('review').description('read the decisions people made on session pull requests from the approval page');
+    reviewCommand
+        .command('list')
+        .description('report each open session pull request with its decision state: awaiting, approved, changes-requested, needs-reapproval or blocked')
+        .action(async (_cmdOpts, cmd) => {
+        const { runEnv, jsonMode, root } = deriveRunEnv(env, cmd);
+        result = await runCommand('review.list', runEnv, jsonMode, async () => {
+            const store = await openStore(runEnv, { root });
+            return reviewListCommand.execute(runEnv, store);
+        });
+    });
     const sessionCommand = program.command('session').description('manage session worktrees');
     sessionCommand
         .command('start')