@aligndottech/cli 0.48.0 → 0.50.0

package/dist/lib/curation/mark.d.ts

@@ -0,0 +1,76 @@
+import { type Judge, type Origin, type Verdict } from './judgements-db.js';
+/**
+ * The most files one check key covers. A check over more files has NO key (it cannot be hidden by
+ * a file-set mark, and a mark cannot be made for it): cutting the list would let a verdict given
+ * for the first 500 files hide the hit on any superset of them.
+ *
+ * The key is a sha256 of the file list and is REVERSIBLE for a small set (hash the likely paths of
+ * the repo and compare). It stays on this machine: nothing that is shared may carry `context_key`
+ * or a path (the share phase reads kind, value, note, via, agent and time only).
+ */
+export declare const MAX_CHECK_FILES = 500;
+export declare const MAX_NOTE_CHARS = 500;
+export declare const SUPERSEDES_CONFIDENCE = 1;
+export type MarkAction = {
+    action: 'conflict';
+    a: string;
+    b: string;
+    verdict: Verdict;
+} | {
+    action: 'check';
+    id: string;
+    verdict: Verdict;
+    files: string[];
+} | {
+    action: 'replaces';
+    newer: string;
+    older: string;
+} | {
+    action: 'not-a-decision';
+    id: string;
+} | {
+    action: 'note';
+    id: string;
+    text: string;
+};
+/** `code` picks the exit status: a usage problem is 2, a decision that is not in the graph is 1. `refused`: nothing was stored, by rule. */
+export declare class MarkError extends Error {
+    readonly code: 'usage' | 'unknown-id' | 'refused';
+    constructor(code: 'usage' | 'unknown-id' | 'refused', message: string);
+}
+/** Repo-relative, forward-slashed, no leading `./`, sorted, de-duplicated. Order and duplicates never change the key. Never cut. */
+export declare function normaliseFiles(files: readonly string[]): string[];
+/** sha256 of the sorted paths joined by newline. No files, more than 500, or an unnameable path has NO key. */
+export declare function contextKeyFor(files: readonly string[]): string | null;
+/**
+ * The files a git-style diff touches. Per `diff --git` block: the `+++` path, else the `---` path (a
+ * deletion), else `rename to`, else a symmetric header. The `+++`/`---` lines count only before the
+ * first hunk, because inside a hunk an added line `++ b/x` reads as `+++ b/x`.
+ */
+export declare function filesFromDiff(diff: string): string[];
+export declare const USAGE: string;
+/** Positional arguments to an action. `files` come from `--files`, or the caller's last check. */
+export declare function parseMarkArgs(args: string[], files: string[] | undefined): MarkAction;
+export interface ApplyContext {
+    dbPath: string;
+    judge: Judge;
+    origin: Origin;
+    now?: Date;
+}
+export interface MarkOutcome {
+    kind: 'conflict_verdict' | 'check_verdict' | 'supersede' | 'not_a_decision' | 'note';
+    /** True when this person's earlier answer on the same key was replaced. */
+    replaced: boolean;
+    undone?: boolean;
+    /** Plain words for the person or agent. Says the mark itself is not shared (a command-name usage ping may still go out when telemetry is on). */
+    text: string;
+}
+/** The command only a PERSON may run for the acts an agent is refused. */
+export declare function personCommandFor(m: MarkAction): string;
+/** Notes are stored and printed in a terminal and in an agent's context: no control characters, no line breaks, short. */
+export declare function checkNote(text: string): string;
+export declare function applyJudgement(ctx: ApplyContext, m: MarkAction, opts?: {
+    undo?: boolean;
+    force?: boolean;
+}): MarkOutcome;
+//# sourceMappingURL=mark.d.ts.map

package/dist/lib/curation/mark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark.d.ts","sourceRoot":"","sources":["../../../src/lib/curation/mark.ts"],"names":[],"mappings":"AAWA,OAAO,EACoD,KAAK,KAAK,EAAuB,KAAK,MAAM,EACnE,KAAK,OAAO,EAC/C,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,MAAM,MAAM,UAAU,GAClB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC9D;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAClE;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,4IAA4I;AAC5I,qBAAa,SAAU,SAAQ,KAAK;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS;gBAAxC,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM;CAI/E;AAED,oIAAoI;AACpI,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAKjE;AAED,+GAA+G;AAC/G,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAKrE;AAuCD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA4BpD;AAMD,eAAO,MAAM,KAAK,QAMJ,CAAC;AAEf,kGAAkG;AAClG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,UAAU,CAwBrF;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,kBAAkB,GAAG,eAAe,GAAG,WAAW,GAAG,gBAAgB,GAAG,MAAM,CAAC;IACrF,2EAA2E;IAC3E,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iJAAiJ;IACjJ,IAAI,EAAE,MAAM,CAAC;CACd;AA2BD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAEtD;AAYD,0HAA0H;AAC1H,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,WAAW,CAkB5H"}

package/dist/lib/curation/mark.js

@@ -0,0 +1,359 @@
+/**
+ * LM: `align mark` and `align_mark` share this module, so the two surfaces cannot diverge
+ * (LM.3): both parse into a `MarkAction` and both call `applyJudgement`. The only things that
+ * differ between a person's mark and an agent's are `via` and `agent_id`.
+ *
+ * Nothing here talks to a network, and nothing is classified by a model: a mark is a person's
+ * answer, stored as given.
+ */
+import { createHash } from 'node:crypto';
+import { createLocalDb } from '../local-db.js';
+import { hasUnsafeChars, quote } from './text.js';
+import { agentWouldOverrideHuman, existingTitles, HumanMarkError, removeJudgement, upsertJudgement, } from './judgements-db.js';
+/**
+ * The most files one check key covers. A check over more files has NO key (it cannot be hidden by
+ * a file-set mark, and a mark cannot be made for it): cutting the list would let a verdict given
+ * for the first 500 files hide the hit on any superset of them.
+ *
+ * The key is a sha256 of the file list and is REVERSIBLE for a small set (hash the likely paths of
+ * the repo and compare). It stays on this machine: nothing that is shared may carry `context_key`
+ * or a path (the share phase reads kind, value, note, via, agent and time only).
+ */
+export const MAX_CHECK_FILES = 500;
+export const MAX_NOTE_CHARS = 500;
+export const SUPERSEDES_CONFIDENCE = 1;
+/** `code` picks the exit status: a usage problem is 2, a decision that is not in the graph is 1. `refused`: nothing was stored, by rule. */
+export class MarkError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'MarkError';
+    }
+}
+/** Repo-relative, forward-slashed, no leading `./`, sorted, de-duplicated. Order and duplicates never change the key. Never cut. */
+export function normaliseFiles(files) {
+    const clean = files
+        .map((f) => f.trim().replace(/\\/g, '/').replace(/^\.\//, ''))
+        .filter((f) => f !== '');
+    return [...new Set(clean)].sort((x, y) => (x < y ? -1 : x > y ? 1 : 0));
+}
+/** sha256 of the sorted paths joined by newline. No files, more than 500, or an unnameable path has NO key. */
+export function contextKeyFor(files) {
+    const list = normaliseFiles(files);
+    // A path with a control or format character cannot be named safely, so it is not a file set at all: nothing is hidden for it.
+    if (list.length === 0 || list.length > MAX_CHECK_FILES || list.some(hasUnsafeChars))
+        return null;
+    return createHash('sha256').update(list.join('\n')).digest('hex');
+}
+/** A C-style quoted path as git writes one: `\"` `\\` `\t` `\n` and `\NNN` octal UTF-8 bytes. */
+function unquoteGitPath(raw) {
+    if (!(raw.startsWith('"') && raw.endsWith('"') && raw.length >= 2))
+        return null;
+    const bytes = [];
+    const body = raw.slice(1, -1);
+    const esc = { n: 10, t: 9, r: 13, '"': 34, '\\': 92, a: 7, b: 8, f: 12, v: 11 };
+    for (let i = 0; i < body.length; i++) {
+        const c = body[i];
+        if (c !== '\\') {
+            bytes.push(...Buffer.from(c, 'utf8'));
+            continue;
+        }
+        const oct = /^[0-7]{3}/.exec(body.slice(i + 1));
+        if (oct) {
+            bytes.push(parseInt(oct[0], 8));
+            i += 3;
+            continue;
+        }
+        const e = esc[body[i + 1]];
+        if (e === undefined)
+            return null;
+        bytes.push(e);
+        i += 1;
+    }
+    return Buffer.from(bytes).toString('utf8');
+}
+/** `a/<path>` or `b/<path>` (quoted or not) to the path; null for /dev/null or an unreadable name. */
+function sidePath(token, side) {
+    const t = token.replace(/\t.*$/, '');
+    const unq = unquoteGitPath(t) ?? t;
+    if (unq === '/dev/null')
+        return null;
+    return unq.startsWith(`${side}/`) ? unq.slice(2) : null;
+}
+/** The path of a `diff --git a/P b/P` header when both sides are the same path (so it is unambiguous even with spaces). */
+function symmetricHeaderPath(rest) {
+    const q = /^("a\/(?:[^"\\]|\\.)*") ("b\/(?:[^"\\]|\\.)*")$/.exec(rest);
+    if (q)
+        return sidePath(q[2], 'b');
+    const n = rest.length - 5;
+    if (n <= 0 || n % 2 !== 0)
+        return null;
+    const p = n / 2;
+    return rest.startsWith('a/') && rest.slice(2, 2 + p) === rest.slice(p + 5) && rest.slice(2 + p, 5 + p) === ' b/' ? rest.slice(2, 2 + p) : null;
+}
+/**
+ * The files a git-style diff touches. Per `diff --git` block: the `+++` path, else the `---` path (a
+ * deletion), else `rename to`, else a symmetric header. The `+++`/`---` lines count only before the
+ * first hunk, because inside a hunk an added line `++ b/x` reads as `+++ b/x`.
+ */
+export function filesFromDiff(diff) {
+    const out = [];
+    let open = false;
+    let inHunk = false;
+    let header = '';
+    let plus = null;
+    let minus = null;
+    let renamed = null;
+    const flush = () => {
+        if (!open)
+            return;
+        const f = plus ?? renamed ?? minus ?? symmetricHeaderPath(header);
+        if (f)
+            out.push(f);
+    };
+    for (const line of diff.split('\n')) {
+        if (line.startsWith('diff --git ')) {
+            flush();
+            open = true;
+            inHunk = false;
+            header = line.slice('diff --git '.length);
+            plus = null;
+            minus = null;
+            renamed = null;
+            continue;
+        }
+        if (!open)
+            continue;
+        if (line.startsWith('@@')) {
+            inHunk = true;
+            continue;
+        }
+        if (inHunk)
+            continue;
+        if (line.startsWith('+++ '))
+            plus = sidePath(line.slice(4), 'b');
+        else if (line.startsWith('--- '))
+            minus = sidePath(line.slice(4), 'a');
+        else if (line.startsWith('rename to '))
+            renamed = unquoteGitPath(line.slice(10)) ?? line.slice(10);
+    }
+    flush();
+    return normaliseFiles(out);
+}
+const VERDICTS = ['real', 'false'];
+function isVerdict(v) {
+    return v !== undefined && VERDICTS.includes(v);
+}
+export const USAGE = [
+    'align mark conflict <a> <b> real|false',
+    'align mark check <a> real|false [--files <f>...]',
+    'align mark <a> replaces <b>',
+    'align mark <a> not-a-decision [--undo]',
+    'align mark <a> note "<text>"',
+].join('\n  ');
+/** Positional arguments to an action. `files` come from `--files`, or the caller's last check. */
+export function parseMarkArgs(args, files) {
+    const bad = (why) => { throw new MarkError('usage', `${why}\n  Usage:\n  ${USAGE}`); };
+    const [first, second, third, fourth, ...rest] = args;
+    if (first === 'conflict') {
+        if (!second || !third || !isVerdict(fourth) || rest.length)
+            bad('A conflict mark needs two decision ids and real or false.');
+        return { action: 'conflict', a: second, b: third, verdict: fourth };
+    }
+    if (first === 'check') {
+        if (!second || !isVerdict(third) || fourth !== undefined)
+            bad('A check mark needs one decision id and real or false.');
+        return { action: 'check', id: second, verdict: third, files: files ?? [] };
+    }
+    if (first && second === 'replaces') {
+        if (!third || fourth !== undefined)
+            bad('`replaces` needs the id of the decision being replaced.');
+        return { action: 'replaces', newer: first, older: third };
+    }
+    if (first && second === 'not-a-decision') {
+        if (third !== undefined)
+            bad('`not-a-decision` takes no further argument.');
+        return { action: 'not-a-decision', id: first };
+    }
+    if (first && second === 'note') {
+        if (!third || fourth !== undefined)
+            bad('`note` needs the note text as one quoted argument.');
+        return { action: 'note', id: first, text: third };
+    }
+    return bad('Not a mark I recognise.');
+}
+const LOCAL_ONLY = 'Recorded on this machine only; the mark itself is not shared.';
+function requireDecisions(dbPath, ids) {
+    const titles = existingTitles(dbPath, ids);
+    for (const id of ids) {
+        if (!titles.has(id))
+            throw new MarkError('unknown-id', `No decision ${quote(id)} in your local graph. \`align decisions list\` shows what is there.`);
+    }
+    return titles;
+}
+function same(a, b, what) {
+    if (a === b)
+        throw new MarkError('usage', `${what} must name two different decisions.`);
+}
+/** The command a person runs to change a mark themselves. */
+function commandFor(m) {
+    switch (m.action) {
+        case 'conflict': return `align mark conflict ${m.a} ${m.b} real|false`;
+        case 'check': return `align mark check ${m.id} real|false --files <file>...`;
+        case 'replaces': return `align mark ${m.newer} replaces ${m.older} [--undo]`;
+        case 'not-a-decision': return `align mark ${m.id} not-a-decision --undo`;
+        case 'note': return `align mark ${m.id} note "<text>"`;
+    }
+}
+/** The command only a PERSON may run for the acts an agent is refused. */
+export function personCommandFor(m) {
+    return m.action === 'replaces' ? `align mark ${m.newer} replaces ${m.older}` : m.action === 'not-a-decision' ? `align mark ${m.id} not-a-decision` : commandFor(m);
+}
+function writeOf(m) {
+    switch (m.action) {
+        case 'conflict': {
+            const [lo, hi] = m.a < m.b ? [m.a, m.b] : [m.b, m.a];
+            return { kind: 'conflict_verdict', decisionId: lo, counterpartId: hi };
+        }
+        case 'check': {
+            const k = contextKeyFor(m.files);
+            return k === null ? null : { kind: 'check_verdict', decisionId: m.id, contextKey: k };
+        }
+        case 'replaces': return { kind: 'supersede', decisionId: m.newer, counterpartId: m.older };
+        case 'not-a-decision': return { kind: 'not_a_decision', decisionId: m.id };
+        case 'note': return null;
+    }
+}
+/** Notes are stored and printed in a terminal and in an agent's context: no control characters, no line breaks, short. */
+export function checkNote(text) {
+    const t = text.trim();
+    if (t === '')
+        throw new MarkError('usage', 'A note needs some text.');
+    if (hasUnsafeChars(t))
+        throw new MarkError('usage', 'A note cannot hold control characters or invisible ones: line breaks, tabs, escapes, zero-width and direction marks, Unicode tags, or the joiners emoji sequences use (a single emoji is fine). Write it on one line of ordinary text.');
+    if ([...t].length > MAX_NOTE_CHARS)
+        throw new MarkError('usage', `A note is at most ${MAX_NOTE_CHARS} characters; this one is ${[...t].length}.`);
+    return t;
+}
+export function applyJudgement(ctx, m, opts = {}) {
+    const refuse = () => { throw new MarkError('refused', `You marked this yourself; run \`${commandFor(m)}\` to change it. Nothing was stored.`); };
+    // An agent may record a verdict or a note. Hiding a decision, or declaring it replaced, is the
+    // person's: the label on an agent's mark is a name it reports about itself, not proof of who is typing.
+    if (ctx.origin.via === 'mcp' && (m.action === 'replaces' || m.action === 'not-a-decision')) {
+        throw new MarkError('refused', `Only the person can do that, not an agent. Ask the user to run: ${personCommandFor(m)}`);
+    }
+    // Before any side effect (the supersedes link below is written ahead of the row).
+    if (ctx.origin.via === 'mcp' && !opts.undo) {
+        const w = writeOf(m);
+        if (w && agentWouldOverrideHuman(ctx.dbPath, w, ctx.judge))
+            refuse();
+    }
+    try {
+        return applyChecked(ctx, m, opts);
+    }
+    catch (e) {
+        if (e instanceof HumanMarkError)
+            return refuse();
+        throw e;
+    }
+}
+function applyChecked(ctx, m, opts) {
+    const { dbPath, judge, origin, now } = ctx;
+    const undo = opts.undo === true;
+    switch (m.action) {
+        case 'conflict': {
+            same(m.a, m.b, 'A conflict mark');
+            requireDecisions(dbPath, [m.a, m.b]);
+            const [lo, hi] = m.a < m.b ? [m.a, m.b] : [m.b, m.a];
+            const key = { kind: 'conflict_verdict', decisionId: lo, counterpartId: hi };
+            if (undo) {
+                const n = removeJudgement(dbPath, key, judge).length;
+                return { kind: key.kind, replaced: false, undone: n > 0, text: n ? 'Removed your verdict on that pair.' : 'You had no verdict on that pair.' };
+            }
+            const { replaced } = upsertJudgement(dbPath, { ...key, value: m.verdict }, judge, origin, now);
+            return { kind: key.kind, replaced, text: `Marked the pair a ${m.verdict === 'false' ? 'false alarm' : 'real conflict'}${replaced ? ' (replacing your earlier answer)' : ''}. ${LOCAL_ONLY}` };
+        }
+        case 'check': {
+            const titles = requireDecisions(dbPath, [m.id]);
+            const files = normaliseFiles(m.files);
+            if (files.some(hasUnsafeChars))
+                throw new MarkError('usage', 'A file path with control characters or invisible ones cannot be named in a mark, so no verdict can be recorded for that set.');
+            const contextKey = contextKeyFor(files);
+            if (contextKey === null) {
+                throw new MarkError('usage', files.length > MAX_CHECK_FILES
+                    ? `That check covered ${files.length} files. A verdict is kept for at most ${MAX_CHECK_FILES}, so it cannot be recorded (and nothing is ever hidden for a check that large).`
+                    : 'A check verdict is about one set of files, and none was given. Pass the files the check covered (the check result lists them).');
+            }
+            const key = { kind: 'check_verdict', decisionId: m.id, contextKey };
+            if (undo) {
+                const n = removeJudgement(dbPath, key, judge).length;
+                return { kind: key.kind, replaced: false, undone: n > 0, text: n ? 'Removed your verdict for that set of files.' : 'You had no verdict for that set of files.' };
+            }
+            const { replaced } = upsertJudgement(dbPath, { ...key, value: m.verdict }, judge, origin, now);
+            const covered = `${files.length} file${files.length === 1 ? '' : 's'}: ${files.slice(0, 10).map(quote).join(', ')}${files.length > 10 ? `, and ${files.length - 10} more` : ''}`;
+            return {
+                kind: key.kind, replaced,
+                text: m.verdict === 'false'
+                    ? `Marked ${quote(titles.get(m.id) ?? '')} a false alarm for exactly this set of ${covered}. A later check touching exactly these files will hide it; any other files still show it. ${LOCAL_ONLY}`
+                    : `Marked ${quote(titles.get(m.id) ?? '')} a real conflict for exactly this set of ${covered}${replaced ? ' (replacing your earlier answer)' : ''}. ${LOCAL_ONLY}`,
+            };
+        }
+        case 'replaces': {
+            same(m.newer, m.older, '`replaces`');
+            const titles = requireDecisions(dbPath, [m.newer, m.older]);
+            const key = { kind: 'supersede', decisionId: m.newer, counterpartId: m.older };
+            if (undo) {
+                const removed = removeJudgement(dbPath, key, judge);
+                if (removed.length === 0)
+                    return { kind: key.kind, replaced: false, undone: false, text: 'You had no replacement mark for that pair.' };
+                const local = createLocalDb(dbPath);
+                let links = 0;
+                try {
+                    for (const id of removed)
+                        links += local.deleteMarkLink(id);
+                }
+                finally {
+                    local.close();
+                }
+                return {
+                    kind: key.kind, replaced: false, undone: true,
+                    text: links ? 'Removed your replacement mark and the supersedes link it created.' : 'Removed your replacement mark. A supersedes link between them that you did not create (a classifier made it) stays.',
+                };
+            }
+            const local = createLocalDb(dbPath);
+            try {
+                const older = local.getDecisionById(m.older);
+                if (!opts.force && older && (older.ratifiedAt || older.confirmedAt)) {
+                    throw new MarkError('refused', `${quote(titles.get(m.older) ?? '')} is ${older.ratifiedAt ? 'ratified' : 'confirmed'}. Replacing a decision a person stood behind needs --force, at a terminal: align mark ${m.newer} replaces ${m.older} --force`);
+                }
+                // The judgement is written FIRST so the link can carry its id: `--undo` then deletes exactly this link.
+                const { replaced, id } = upsertJudgement(dbPath, key, judge, origin, now);
+                local.insertLink({ id: `mark:${id}`, sourceId: m.newer, targetId: m.older, relation: 'supersedes', confidence: SUPERSEDES_CONFIDENCE });
+                return { kind: key.kind, replaced, text: `Recorded that ${quote(titles.get(m.newer) ?? '')} replaces ${quote(titles.get(m.older) ?? '')}. A check that cites the older one now names the newer as current; \`--undo\` takes it back. ${LOCAL_ONLY}` };
+            }
+            finally {
+                local.close();
+            }
+        }
+        case 'not-a-decision': {
+            const titles = requireDecisions(dbPath, [m.id]);
+            const key = { kind: 'not_a_decision', decisionId: m.id };
+            if (undo) {
+                const n = removeJudgement(dbPath, key, judge).length;
+                return { kind: key.kind, replaced: false, undone: n > 0, text: n ? `${quote(titles.get(m.id) ?? '')} is retrieved again.` : 'You had not marked that one.' };
+            }
+            const { replaced } = upsertJudgement(dbPath, key, judge, origin, now);
+            return { kind: key.kind, replaced, text: `${quote(titles.get(m.id) ?? '')} is out of ask and check results (every check says how many marks hide something). \`align decisions list --all\` still shows it. ${LOCAL_ONLY}` };
+        }
+        case 'note': {
+            const titles = requireDecisions(dbPath, [m.id]);
+            if (undo)
+                throw new MarkError('usage', 'Notes append and cannot be undone by id. `align mark --list` shows them.');
+            const text = checkNote(m.text);
+            upsertJudgement(dbPath, { kind: 'note', decisionId: m.id, note: text }, judge, origin, now);
+            return { kind: 'note', replaced: false, text: `Added a note to ${quote(titles.get(m.id) ?? '')}. ${LOCAL_ONLY}` };
+        }
+    }
+}
+//# sourceMappingURL=mark.js.map

package/dist/lib/curation/mark.js.map

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

package/dist/lib/curation/text.d.ts

@@ -0,0 +1,6 @@
+export declare function hasUnsafeChars(s: string): boolean;
+/** A JSON string literal with every unsafe character written out (\uXXXX, or \u{X} above the BMP), so one value is one visible, inert token. */
+export declare function quote(s: string): string;
+/** An agent id is a registry id or 'unknown', so it prints as is; anything else in the column is printed escaped. */
+export declare function agentLabel(id: string | null): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/lib/curation/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/lib/curation/text.ts"],"names":[],"mappings":"AAoBA,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,gJAAgJ;AAChJ,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvC;AAED,qHAAqH;AACrH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAEpD"}

package/dist/lib/curation/text.js

@@ -0,0 +1,35 @@
+/**
+ * LM: text from the graph or from a mark reaches a terminal and an agent's context. A decision
+ * title comes from a Slack message or a PR, and a note comes from whoever wrote it, so neither is
+ * printed raw: a control byte can move the cursor, hide a word (ESC [8m) or forge a whole row, and
+ * an invisible format character (a Unicode tag, a zero-width space, a direction mark) can carry
+ * text nobody sees.
+ *
+ * "Unsafe" is every control (Cc), format (Cf), private-use (Co) and surrogate (Cs) character plus
+ * the line and paragraph separators. That includes the zero-width joiner and variation selector 16
+ * that emoji SEQUENCES use: a family or profession emoji is refused in a note. A single-codepoint
+ * emoji is fine. Allowing the joiners only inside valid sequences would need an emoji grammar, and a
+ * refusal that says why is cheaper than a parser that can be fooled.
+ */
+// Beyond the categories: variation selectors and the combining grapheme joiner (Mn), and the Hangul fillers, all invisible.
+// The combining and variation characters in the class are the point: they are what must be refused.
+// eslint-disable-next-line no-misleading-character-class
+const UNSAFE = /[\p{Cc}\p{Cf}\p{Co}\p{Cs}\p{Zl}\p{Zp}\u034f\u115f\u1160\u3164\uffa0\ufe00-\ufe0f\u{e0100}-\u{e01ef}]/u;
+// eslint-disable-next-line no-misleading-character-class
+const UNSAFE_ALL = new RegExp(UNSAFE.source, 'gu');
+export function hasUnsafeChars(s) {
+    return UNSAFE.test(s);
+}
+/** A JSON string literal with every unsafe character written out (\uXXXX, or \u{X} above the BMP), so one value is one visible, inert token. */
+export function quote(s) {
+    return JSON.stringify(s).replace(UNSAFE_ALL, (c) => {
+        const n = c.codePointAt(0) ?? 0;
+        const hex = n.toString(16).padStart(4, '0');
+        return n > 0xffff ? `\\u{${hex}}` : `\\u${hex}`;
+    });
+}
+/** An agent id is a registry id or 'unknown', so it prints as is; anything else in the column is printed escaped. */
+export function agentLabel(id) {
+    return id !== null && /^[a-z0-9-]{1,40}$/.test(id) ? id : quote(id ?? '');
+}
+//# sourceMappingURL=text.js.map

package/dist/lib/curation/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/lib/curation/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,4HAA4H;AAC5H,oGAAoG;AACpG,yDAAyD;AACzD,MAAM,MAAM,GAAG,uGAAuG,CAAC;AACvH,yDAAyD;AACzD,MAAM,UAAU,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAEnD,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,gJAAgJ;AAChJ,MAAM,UAAU,KAAK,CAAC,CAAS;IAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE;QACjD,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qHAAqH;AACrH,MAAM,UAAU,UAAU,CAAC,EAAiB;IAC1C,OAAO,EAAE,KAAK,IAAI,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/dist/lib/fetchers/capture.d.ts

@@ -14,6 +14,10 @@ import type { PersonalImportItem } from '../personal-import.js';
  *  reason, printed verbatim, so `detail` is written for a person. Owned here, by the
  *  producer; the renderer consumes it. */
 export interface CaptureSkip {
+    /** The SDK's kind (page_cap, time_budget, vendor_cap, shape, pending, error, auth), when the
+     *  fetcher reported one. The renderer branches on it for one thing only: which skip stopped
+     *  a windowed read. Any other kind is printed verbatim like the rest (the union grows). */
+    kind?: string;
     /** How many source objects this covers. */
     count: number;
     /** One line printed after the count. */
@@ -29,7 +33,45 @@ export interface CaptureFetchReport {
      *  40-commit repo is printed every run and stops being read. */
     requested?: number;
     skips: CaptureSkip[];
+    /** L3: true when the read reached the end of its window with nothing cut. Absent from a
+     *  fetcher that cannot say (git, docs, and an SDK older than 0.10). */
+    complete?: boolean;
+    /** L3: the oldest `updated_at` the read saw, so an incomplete line can name the date it
+     *  actually reached. Absent when no item carried one; never filled in from the clock. */
+    oldestReached?: string;
+    /** L5: the latest `updated_at` the read saw, the SDK's own watermark candidate. Absent when no item carried one;
+     *  never filled in from the clock. */
+    highWater?: string;
+    /** L3: 'team' when the token's whole visible scope was read, 'yours' for the caller's own items. */
+    scope?: 'yours' | 'team';
+    /** L3: items returned whole but waiting for their discussion (GitHub's items-first pass). */
+    discussionPending?: number;
+    /** L3: items fetched items-first that COULD have had discussion (the denominator for the above). */
+    discussionTotal?: number;
+    /** L3: one line saying whose items a team-scope read covered ("everyone's PRs and issues in o/r"). */
+    scopeNote?: string;
+    /** L4: a team read that --json could not tell the person about; the disclosure is still owed and shows at the next foreground run. */
+    disclosurePending?: boolean;
 }
+/** L3: what every windowed fetch is given on top of its limit (see fetchWindow in since.ts). */
+export type WindowedOpts = {
+    /** ISO-8601 UTC lower bound. Absent means no bound: only the ceiling applies. */
+    since?: string;
+    /** Wall-clock budget for the whole read; running out is a `time_budget` skip. */
+    timeBudgetMs?: number;
+    /** L5: ISO-8601 UTC upper bound (exclusive). Set by a sync finishing the older part of a window a ceiling cut. */
+    until?: string;
+    /** L5, Slack only: stored threads whose replies since `since` should be re-read (their items come back `partial`). */
+    hotThreads?: Array<{
+        channel: string;
+        ts: string;
+    }>;
+    /** L4: a team scope's option for the fetchers that take one (Jira projects, Linear teams, GitLab projectId, Confluence spaces). */
+    projects?: string[];
+    teams?: string[];
+    projectId?: string;
+    spaces?: string[];
+};
 export interface CaptureFetchResult {
     items: PersonalImportItem[];
     report: CaptureFetchReport;
@@ -37,8 +79,8 @@ export interface CaptureFetchResult {
 /**
  * The slice of a connector-core fetcher this wrapper needs, declared structurally so it
  * compiles against 0.5.0 (no `fetchWithReport`) and consumes 0.6.0's report the moment
- * the installed package has one. `kind` and `platform` on the SDK report are accepted and
- * dropped: the CLI prints the detail and branches on nothing else.
+ * the installed package has one. `kind` on each skip and the report's `complete`, `oldestReached` and
+ * `scope` are carried through (L3); `platform` is dropped.
  */
 export interface ReportingFetcher<O> {
     fetch(opts: O): Promise<PersonalImportItem[]>;
@@ -48,9 +90,14 @@ export interface ReportingFetcher<O> {
             scanned: number;
             requested?: number;
             skips: ReadonlyArray<{
+                kind?: string;
                 count: number;
                 detail: string;
             }>;
+            complete?: boolean;
+            oldestReached?: string;
+            highWater?: string;
+            scope?: 'yours' | 'team';
         };
     }>;
 }

package/dist/lib/fetchers/capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../src/lib/fetchers/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;0CAE0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC;;8FAE0F;IAC1F,OAAO,EAAE,MAAM,CAAC;IAChB;;oEAEgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC9C,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;QACjC,KAAK,EAAE,kBAAkB,EAAE,CAAC;QAC5B,MAAM,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,aAAa,CAAC;gBAAE,KAAK,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;KAC1G,CAAC,CAAC;CACJ;AAED,wBAAsB,iBAAiB,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAClE,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAyB7B"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../src/lib/fetchers/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;0CAE0C;AAC1C,MAAM,WAAW,WAAW;IAC1B;;+FAE2F;IAC3F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC;;8FAE0F;IAC1F,OAAO,EAAE,MAAM,CAAC;IAChB;;oEAEgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB;2EACuE;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;6FACyF;IACzF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;0CACsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oGAAoG;IACpG,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oGAAoG;IACpG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sGAAsG;IACtG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sIAAsI;IACtI,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,gGAAgG;AAChG,MAAM,MAAM,YAAY,GAAG;IACzB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kHAAkH;IAClH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sHAAsH;IACtH,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,mIAAmI;IACnI,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC9C,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;QACjC,KAAK,EAAE,kBAAkB,EAAE,CAAC;QAC5B,MAAM,EAAE;YACN,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,KAAK,EAAE,aAAa,CAAC;gBAAE,IAAI,CAAC,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;SAC1B,CAAC;KACH,CAAC,CAAC;CACJ;AAED,wBAAsB,iBAAiB,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAClE,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA+B7B"}

package/dist/lib/fetchers/capture.js

@@ -2,12 +2,18 @@ export async function withCaptureReport(opts, fetcher) {
     if (typeof fetcher.fetchWithReport === 'function') {
         // One read, never two: the SDK's `fetch` is defined as `(await fetchWithReport()).items`.
         const { items, report } = await fetcher.fetchWithReport(opts);
+        const pending = items.filter((i) => i.detail_pending === true).length;
         return {
             items,
             report: {
                 scanned: report.scanned,
                 ...(report.requested !== undefined ? { requested: report.requested } : {}),
-                skips: report.skips.map((s) => ({ count: s.count, detail: s.detail })),
+                skips: report.skips.map((s) => ({ ...(s.kind !== undefined ? { kind: s.kind } : {}), count: s.count, detail: s.detail })),
+                ...(report.complete !== undefined ? { complete: report.complete } : {}),
+                ...(report.oldestReached !== undefined ? { oldestReached: report.oldestReached } : {}),
+                ...(report.highWater !== undefined ? { highWater: report.highWater } : {}),
+                ...(report.scope !== undefined ? { scope: report.scope } : {}),
+                ...(pending > 0 ? { discussionPending: pending } : {}),
             },
         };
     }