@wirecat/cli-core 0.515.0 → 0.517.0

package/CHANGELOG.md

@@ -7,6 +7,47 @@ shape of this file.
 
 ## Unreleased
 
+## 0.517.0 — 01.11.2026
+
+### Added
+
+- **`withSyncCommands(found, sync)`** gives each linked chat of a stored project gathering its `syncCommand`: the
+  line the text names to sync a chat held in part, or null. tg's and max's `projects evidence --json` carry it as
+  `linked_chats[].sync_command`, so an agent reading JSON gets the command the text shows.
+
+### Fixed
+
+- **A chat that reaches its first message is no longer "held from <date> only"** in `missing`, `next` and the
+  `projects evidence` text: it is "held from its first message, behind since <date>", or "with gaps".
+- **`messages sync` progress says how far back it got as a date** ("back to 2026-09-27"), not as a message key, which
+  for MAX was a number of milliseconds.
+
+## 0.516.0 — 01.11.2026
+
+### Fixed
+
+- **`syncMail` counts what `max` left unread in `remaining`**, not 0, so a CLI can say how much is left after a run
+  cut short by `--limit`.
+- **`tasks update --priority none` clears the priority** instead of failing with "a priority score is 0 to 1":
+  Commander stores an option parser's `null` as an empty string. `priorityOption` reads `none` as the word `"none"`
+  for a command's own option; a consumer that maps it to `null` (as `--due none`) clears the priority.
+
+### Added
+
+- **Store version 42: a task's revision goes up only for a change a person could overwrite** (`minCompatible` stays
+  34): its title, description, status, priority, agent, due date, project or parent, an assignee added or removed, or
+  a tag added or removed. A claim taken, renewed or released, a follow-up time, a close suggestion or certainty no
+  longer bump it, so a board no longer reports a conflict while an agent simply works. Triggers do it, so writes by
+  older builds follow the same rule.
+
+### Changed — may break callers
+
+- **`tasks.move` beside a task in another column moves the task into that column**: without `status` it takes the
+  neighbour's status. A `status` that differs from the neighbour's is refused with `validation_error`, reason
+  `task.column` (`HRB-2 is in in_progress, not todo: pick a task in the todo column`), with `anchor`, `anchorStatus`
+  and `requestedStatus` in the details. A neighbour off every project board, or the task itself, is refused with a
+  message that says so.
+
 ## 0.515.0 — 01.11.2026
 
 ### Added

package/dist/cli/index.d.ts

@@ -109,7 +109,7 @@ export { window, withPaging } from "./paging.js";
 export { type CommandPermissions, commandPathKey, commandPermissions, knownBeside, knownPermissionKeys, type PermissionKeyOf, type PermissionKeySource, refuseUnknownPermissionKeys, unknownPermissionIssues, unknownPermissionKeys, } from "./permission-keys.js";
 export { asFirstWord, commandWords, liftProfile, profileFree, refuseCommandName, rootOf, takesProfile, usableProfileName, } from "./profile.js";
 export { createProgram, type ProgramDefinition, type ProgramOptions, type RunOptions, run } from "./program.js";
-export { type ProjectTextHints, projectAnswerParts, projectCutoffTime, projectEvidenceText, projectWindowOf, } from "./project-evidence.js";
+export { type ProjectTextHints, projectAnswerParts, projectCutoffTime, projectEvidenceText, projectWindowOf, withSyncCommands, } from "./project-evidence.js";
 export { fieldsOf, projectFields } from "./result-fields.js";
 export { type Config, type Configuration, count, first, flag, fromFile, type GlobalFlags, NONE_NAMED, namedProfile, type ProfileKind, plain, type ResolveOptions, type Settings, type SettingsExtension, type SettingsExtensionContext, type Source, settingsFor, } from "./settings.js";
 export { type PermissionAnswer, readSetupAnswers, type SetupAnswers, setupPermissionCeiling } from "./setup-answers.js";

package/dist/cli/index.js

@@ -99,7 +99,7 @@ export { window, withPaging } from "./paging.js";
 export { commandPathKey, commandPermissions, knownBeside, knownPermissionKeys, refuseUnknownPermissionKeys, unknownPermissionIssues, unknownPermissionKeys, } from "./permission-keys.js";
 export { asFirstWord, commandWords, liftProfile, profileFree, refuseCommandName, rootOf, takesProfile, usableProfileName, } from "./profile.js";
 export { createProgram, run } from "./program.js";
-export { projectAnswerParts, projectCutoffTime, projectEvidenceText, projectWindowOf, } from "./project-evidence.js";
+export { projectAnswerParts, projectCutoffTime, projectEvidenceText, projectWindowOf, withSyncCommands, } from "./project-evidence.js";
 export { fieldsOf, projectFields } from "./result-fields.js";
 export { count, first, flag, fromFile, NONE_NAMED, namedProfile, plain, settingsFor, } from "./settings.js";
 export { readSetupAnswers, setupPermissionCeiling } from "./setup-answers.js";

package/dist/cli/messenger/projects-command.js

@@ -7,7 +7,7 @@ import { gatherStoredProject } from "../../services/stored-project-gathering.js"
 import { FETCH } from "../effects.js";
 import { itemOf, renderAnswer, snakeKeys } from "../envelope.js";
 import { positiveCount } from "../paging.js";
-import { projectAnswerParts, projectCutoffTime, projectEvidenceText, projectWindowOf } from "../project-evidence.js";
+import { projectAnswerParts, projectCutoffTime, projectEvidenceText, projectWindowOf, withSyncCommands, } from "../project-evidence.js";
 import { lineOf } from "../steps.js";
 import { messengerContext } from "./context.js";
 const collect = (value, previous) => [...previous, value];
@@ -120,12 +120,13 @@ export const projectsCommand = (messenger) => {
             : undefined;
         const found = await context.withStore((store, account) => gather(store, account, fetcher));
         const parts = projectAnswerParts(options.sinceTime, found);
-        renderAnswer(this, context, itemOf(snakeKeys(found), parts), () => projectEvidenceText(found, {
+        const hints = {
             sync: (one, since) => one.provider === messenger.provider
                 ? lineOf(this, `projects evidence ${quote(project)} --since-time ${since} --sync-first`)
                 : null,
             showDocument: "the notes app that imported it",
-        }));
+        };
+        renderAnswer(this, context, itemOf(snakeKeys(withSyncCommands(found, hints.sync)), parts), () => projectEvidenceText(found, hints));
     }));
     return projects;
 };

package/dist/cli/messenger/search-answers.d.ts

@@ -18,6 +18,11 @@ export type HitItem = InferOutput<(typeof ENTITIES)["hit"]>;
 /** The page a `--page` asks for, as the offset the search services take. */
 export declare const offsetOf: (page: number | undefined, limit: number) => number | undefined;
 export declare const messageHitItem: (hit: FoundMessage, query?: string) => MessageHitItem;
+/**
+ * What the store holds of a chat that is not complete, in words. A chat that reaches its first message is only
+ * behind or has gaps: saying "held from <date> only" would claim older history is missing.
+ */
+export declare const heldPhrase: ({ completeness, held }: Pick<ChatCoverage, "completeness" | "held">) => string;
 /**
  * What the archive lacked for this answer, and the step that would fill it. From a search's coverage, or from the
  * chats an answer is about (`since` is the start of the window it was asked for).

package/dist/cli/messenger/search-answers.js

@@ -96,6 +96,19 @@ const metaOf = (accounts, skipped = [], heldInPart = false) => ({
         : {}),
 });
 const day = (at) => at?.slice(0, 10) ?? "no date";
+/**
+ * What the store holds of a chat that is not complete, in words. A chat that reaches its first message is only
+ * behind or has gaps: saying "held from <date> only" would claim older history is missing.
+ */
+export const heldPhrase = ({ completeness, held }) => {
+    if (completeness.state === "unknown" || !held.oldestAt)
+        return "never fetched";
+    if (!completeness.reachesStart)
+        return `held from ${day(held.oldestAt)} only`;
+    if (completeness.gaps)
+        return "held from its first message, with gaps";
+    return `held from its first message, behind since ${day(held.newestAt)}`;
+};
 /**
  * The steps for chats the store holds only in part. Bounded first, when the answer's window is known, then the whole
  * chat; both name the first chat only, because a download is the owner's call. Counts and dates only, never text.
@@ -105,7 +118,7 @@ const chatGaps = (rows, since) => {
     const [first] = open;
     if (!first)
         return { next: [], missing: [] };
-    const held = first.completeness.state === "unknown" ? "never fetched" : `held from ${day(first.held.oldestAt)} only`;
+    const held = heldPhrase(first);
     const steps = (args, why) => ({
         ...nextStep("messages.sync", { args: { chat: first.chatId, ...args } }),
         why,

package/dist/cli/messenger/tasks-command.js

@@ -8,7 +8,7 @@ import { aheadOf, momentOf } from "../../services/moment.js";
 import { unlistedNote } from "../../services/task-categories.js";
 import { ARRIVAL_WINDOW, applyTaskRulesToChats } from "../../services/task-rules.js";
 import { CLAIM_LEASE_MS, closedStateOf, TASK_PAIR_QUERY, TASK_QUERY, taskLinkKindOf, taskTypeOf, } from "../../services/tasks.js";
-import { PRIORITY_LABELS, priorityOf } from "../../tasks/index.js";
+import { PRIORITY_LABELS, priorityOption } from "../../tasks/index.js";
 import { actorOf, holderOf as holderIn } from "../author.js";
 import { environmentOf } from "../context.js";
 import { destroysNothing, LOCAL_READ, LOCAL_WRITE, ownerOnlyOption } from "../effects.js";
@@ -119,7 +119,7 @@ const HOLDER_HELP = "who you are for claims: a session id or a chat id; default
 const planFrom = (options) => {
     const plan = {};
     if (options.priority !== undefined)
-        plan.priority = options.priority;
+        plan.priority = options.priority === "none" ? null : options.priority;
     if (options.parent !== undefined)
         plan.parent = options.parent === "none" ? null : options.parent;
     if (options.category !== undefined)
@@ -208,7 +208,7 @@ export const tasksCommand = (messenger) => {
         .description("update a task's text, schedule, category, assignees, priority or parent; nothing reaches the messenger")
         .argument("<task>", "the task's id or key, as tasks list shows it")
         .option("--category <name>", `${categoryHelp}; a change is kept in the task's history`)
-        .option("--priority <n>", `${PRIORITY_LABELS.join(", ")} or none; 0 (urgent) … 4 (low) still read as before`, priorityOf)
+        .option("--priority <n>", `${PRIORITY_LABELS.join(", ")} or none; 0 (urgent) … 4 (low) still read as before`, priorityOption)
         .option("--parent <id>", "parent task in the same project; none clears it"), "send Alex the API token").action(async function (id) {
         const context = messengerContext(this, messenger);
         refuseLocalWrite(context, messenger.app.command, "tasks.update");

package/dist/cli/project-evidence.d.ts

@@ -41,6 +41,102 @@ export declare const projectAnswerParts: (sinceTime: string, found: StoredProjec
         complete: boolean;
     };
 };
+/**
+ * The gathering with each linked chat's `syncCommand`: the line that syncs a chat held in part back to the window
+ * start, or null when it needs none or no command here can. JSON readers get what the text says per chat.
+ */
+export declare const withSyncCommands: (found: StoredProjectGathering, sync: ProjectTextHints["sync"]) => {
+    schemaVersion: 1;
+    runKey: string;
+    fingerprint: string;
+    resumed: boolean;
+    project: {
+        name: string;
+        key: string | null;
+        background: string | null;
+        aliases: string[];
+    };
+    window: {
+        after: number;
+        before: number;
+        asOf: number;
+        lookbackDays: number | null;
+        basis: "explicit" | "lookback";
+        timeBasis: "per-item-time-kind";
+    };
+    scope: {
+        origin: "all-connected" | "explicit";
+        sources: import("../context/evidence.js").ContextSource[];
+    };
+    lanes: import("../services/project-gathering-request.js").ProjectLane[];
+    fetch: import("../services/project-gathering-request.js").ProjectChatFetched[];
+    index: import("../services/project-gathering.js").ProjectIndexCatchUp;
+    units: {
+        lane: string;
+        source: number;
+        after: number;
+        before: number;
+        state: import("../services/project-gathering-request.js").ProjectUnitState;
+        pages: number;
+        issue: string | null;
+    }[];
+    items: import("../services/project-gathering.js").ProjectEvidenceItem[];
+    people: import("../services/project-gathering.js").ProjectEvidencePerson[];
+    peopleOmitted: number;
+    oversized: {
+        ref: string;
+        lanes: string[];
+        source: number;
+        bytes: number;
+    }[];
+    matchedAgain: {
+        ref: string;
+        lanes: string[];
+    }[];
+    usage: {
+        reads: number;
+        readBytes: number;
+        aroundBytes: number;
+        items: number;
+        elapsedMs: number;
+    };
+    totals: {
+        reads: number;
+        readBytes: number;
+        items: number;
+        invocations: number;
+    };
+    stopped: import("../services/project-gathering.js").ProjectGatheringStop;
+    complete: boolean;
+    completeness: "complete" | "partial" | "unknown";
+    checkpoint: string | null;
+    projectRef: string | null;
+    unreadSources: {
+        source: string;
+        kind: string;
+        reason?: "out-of-scope" | "linked-chat-limit" | "member-limit" | "no-identity" | "unknown-provider";
+    }[];
+    mentions: import("../services/project-gathering-mentions.js").EvidenceMentions;
+    linkedChats: {
+        provider: string;
+        account: string;
+        chat: string;
+        ref: string;
+        source: number | null;
+        lane: string | null;
+        state: "in-scope" | "out-of-scope" | "pending" | "unavailable";
+        title: string | null;
+        completeness: import("../store/exports.js").ChatCompleteness | null;
+        held: {
+            messages: number;
+            oldestAt: string | null;
+            newestAt: string | null;
+        } | null;
+        items?: number | undefined;
+        capped?: boolean | undefined;
+        syncCommand: string | null;
+    }[];
+};
 export interface ProjectTextHints {
     /** The command that syncs one linked chat back to `since` (`YYYY-MM-DD`), or null when no command here can. */
     sync: (chat: StoredProjectGathering["linkedChats"][number], since: string) => string | null;

package/dist/cli/project-evidence.js

@@ -1,7 +1,7 @@
 import { CliError } from "@wirecat/cli-base";
 import * as v from "valibot";
 import { dateWindow, momentOf } from "../services/moment.js";
-import { coverageGaps } from "./messenger/search-answers.js";
+import { coverageGaps, heldPhrase } from "./messenger/search-answers.js";
 /** Days back (`90d`) or a start date (`2026-09-01`); either way the run freezes its end, so a resume keeps it. */
 export const projectWindowOf = (value) => {
     const days = /^([1-9]\d{0,2})d$/.exec(value)?.[1];
@@ -47,6 +47,17 @@ export const projectAnswerParts = (sinceTime, found) => {
         },
     };
 };
+/**
+ * The gathering with each linked chat's `syncCommand`: the line that syncs a chat held in part back to the window
+ * start, or null when it needs none or no command here can. JSON readers get what the text says per chat.
+ */
+export const withSyncCommands = (found, sync) => ({
+    ...found,
+    linkedChats: found.linkedChats.map((one) => ({
+        ...one,
+        syncCommand: one.completeness === null || one.completeness.state === "complete" ? null : sync(one, day(found.window.after)),
+    })),
+});
 const LABELS = {
     "person-only": "  [person only]",
     sender: "  [sent by contact]",
@@ -120,13 +131,11 @@ export const projectEvidenceText = (found, hints) => {
     for (const one of found.fetch)
         lines.push(`${one.chat}: ${FETCH_STATES[one.state] ?? one.state} before reading` +
             `${one.reason && one.state !== "skipped" ? ` (${one.reason})` : ""}`);
-    const held = (one) => one.completeness?.state === "unknown" || !one.held?.oldestAt
-        ? "never fetched"
-        : `held from ${one.held.oldestAt.slice(0, 10)} only`;
     for (const one of found.linkedChats)
         if (one.completeness !== null && one.completeness.state !== "complete") {
             const sync = hints.sync(one, day(found.window.after));
-            lines.push(`${one.title ?? one.ref}: ${held(one)}${one.state === "pending" ? ", not read this run" : ""}` +
+            const held = one.held === null ? "never fetched" : heldPhrase({ completeness: one.completeness, held: one.held });
+            lines.push(`${one.title ?? one.ref}: ${held}${one.state === "pending" ? ", not read this run" : ""}` +
                 (sync ? ` — sync it: ${sync}` : ""));
         }
     const capped = found.linkedChats.filter((one) => one.capped);

package/dist/errors/reasons.js

@@ -121,6 +121,7 @@ const OTHERS = [
     validation("task.claimed", "someone else holds the task"),
     validation("task.closed", "the task is already closed"),
     ["task.stale", "configuration_error", "the task changed since it was read; read it again"],
+    validation("task.column", "the task beside which it moves is in another column than the status asked for"),
     validation("task.dependency-cycle", "the task would depend on itself"),
     validation("task.duplicate-candidates", "open tasks may be the same job: attach to one, or add it as new"),
     validation("task.certainty-required", "an agent closes a task with its certainty, 0 to 1"),

package/dist/mail/quick.d.ts

@@ -33,6 +33,8 @@ export interface QuickRead {
     }[];
     /** Mail of the folder is left for a later round or run. */
     capped: boolean;
+    /** How many of the open mail `max` left for the next run; an unbudgeted run only. */
+    left: number;
 }
 /**
  * One round of a folder whose server gives no cheap message id: UID, flags, date and size of what is not done, then

package/dist/mail/quick.js

@@ -7,7 +7,7 @@ export const keyOf = (folder, uid) => `${folder}\0${uid}`;
  * the raw bytes of the newest of it, whose Message-ID gives the id the full listing would have given.
  */
 export const readQuick = async (source, since, folder, searched, done, max, plan, located) => {
-    const answer = { listing: [], read: [], unreadable: [], capped: false };
+    const answer = { listing: [], read: [], unreadable: [], capped: false, left: 0 };
     let items = plan?.quick.get(folder);
     if (items === undefined) {
         // Mail whose location is known is listed for its flags only; it is never read again.
@@ -40,6 +40,8 @@ export const readQuick = async (source, since, folder, searched, done, max, plan
     if (plan !== undefined)
         plan.remaining += open.length - slice.length;
     answer.capped = open.length > slice.length;
+    if (plan === undefined)
+        answer.left = open.length - slice.length;
     if (slice.length === 0)
         return answer;
     if (plan !== undefined) {

package/dist/mail/sync.d.ts

@@ -36,7 +36,7 @@ export interface MailSyncResult {
     state?: "partial" | "complete";
     /** Why a budgeted run stopped early: its request budget, its deadline, or a cancel. */
     stopped?: BudgetStop;
-    /** Messages of the window this run did not get to read; a budgeted run only. */
+    /** Messages of the window this run did not get to read: left by a budget, or by `max`. */
     remaining?: number;
     /** Requests a budgeted run spent. */
     requests?: number;

package/dist/mail/sync.js

@@ -121,7 +121,7 @@ export const syncMail = async (source, store, options) => {
         deleted: sum((round) => round.deleted),
         complete,
         state: complete ? "complete" : "partial",
-        remaining,
+        remaining: remaining + (last.remaining ?? 0),
         requests: budget.used,
         ...(plan.stopped === null ? {} : { stopped: plan.stopped }),
         ...(indexed === undefined ? {} : { indexed }),
@@ -183,6 +183,7 @@ const syncRound = async (source, store, { account, since, max = 200, maxBodyChar
             mboxPoint = point;
     }
     let capped = false;
+    let overMax = 0;
     const unreadable = [];
     /** Raw mail read to learn its id, kept for the save so it is not read twice. */
     const rawOf = new Map();
@@ -258,6 +259,7 @@ const syncRound = async (source, store, { account, since, max = 200, maxBodyChar
                     refreshed.set(id, { ...refreshed.get(id), ...flags });
                 if (round.capped)
                     capped = true;
+                overMax += round.left;
                 for (const { item, raw } of round.read) {
                     collected.push(item);
                     rawOf.set(item, raw);
@@ -465,8 +467,10 @@ const syncRound = async (source, store, { account, since, max = 200, maxBodyChar
                 upgraded.set(item.messageId, boxes);
                 pending.push(item);
             }
-            else
+            else {
                 full = true;
+                overMax++;
+            }
             continue;
         }
         if (known.has(item.messageId)) {
@@ -491,8 +495,10 @@ const syncRound = async (source, store, { account, since, max = 200, maxBodyChar
         }
         if (pending.length < max)
             pending.push(item);
-        else
+        else {
             full = true;
+            overMax++;
+        }
     }
     const inMailboxes = (item) => [
         ...[...(foundFolders.get(item.messageId) ?? [])].map(mailbox),
@@ -794,6 +800,7 @@ const syncRound = async (source, store, { account, since, max = 200, maxBodyChar
         envelopes,
         deleted,
         complete,
+        remaining: overMax,
         ...(indexed === undefined ? {} : { indexed }),
         coverage,
         ...(attachments.length ? { attachments } : {}),

package/dist/services/archive.js

@@ -308,7 +308,7 @@ export const fetchInto = async ({ history, store, account, fetching, limit, page
         before = byTime
             ? new Date(boundary + (fresh > 0 && !(window && fetching.beforeInclusive) ? 1 : 0)).toISOString()
             : String(boundary);
-        note(`${fetched} messages so far, back to ${held.from}`);
+        note(`${fetched} messages so far, back to ${fromAt.slice(0, 10)}`);
         const wait = fetching.jitter ? pauseMs * (1 + Math.random()) : pauseMs;
         await sleep(wait, undefined, { signal: stop }).catch(() => { });
     }

package/dist/store/index.d.ts

@@ -5,7 +5,7 @@ export type { TagRedirectIndex, TagRedirectResolution, TagRedirectSnapshot } fro
 export { createTagRedirectIndex } from "../domain/tag-redirects.js";
 export { note } from "../entities/note.js";
 export type { FindingEvidence, FindingOutcome, MeetingFactFinding, MeetingFinding, MeetingFindingsInput, MeetingFindingsReceipt, MeetingTaskFinding, } from "../meetings/index.js";
-export { CLOSED_STATES, isClosedState, PRIORITY_LABELS, type PriorityLabel, priorityLabel, priorityOf, TASK_STATES, type TaskState, } from "../tasks/index.js";
+export { CLOSED_STATES, isClosedState, PRIORITY_LABELS, type PriorityLabel, priorityLabel, priorityOf, priorityOption, TASK_STATES, type TaskState, } from "../tasks/index.js";
 export type { AccountMail, AccountMeetings, AccountStore } from "./account-store.js";
 export type { DocumentTransferOptions, DocumentTransferPreview, DocumentTransferReceipt, } from "./document-transfer/index.js";
 export { applyDocumentTransfer, previewDocumentTransfer } from "./document-transfer/index.js";

package/dist/store/index.js

@@ -1,7 +1,7 @@
 export { FACT_STATUSES, FACT_TYPES, MEMORY_KINDS, MEMORY_SCOPES, MEMORY_STATUSES, TASK_TYPES, WORK_TASK_TYPES, } from "../domain/knowledge.js";
 export { createTagRedirectIndex } from "../domain/tag-redirects.js";
 export { note } from "../entities/note.js";
-export { CLOSED_STATES, isClosedState, PRIORITY_LABELS, priorityLabel, priorityOf, TASK_STATES, } from "../tasks/index.js";
+export { CLOSED_STATES, isClosedState, PRIORITY_LABELS, priorityLabel, priorityOf, priorityOption, TASK_STATES, } from "../tasks/index.js";
 export { applyDocumentTransfer, previewDocumentTransfer } from "./document-transfer/index.js";
 export { PRAGMAS } from "./driver.js";
 export { EVIDENCE_FINDINGS_KIND, validateEvidenceFindings, } from "./evidence-findings.js";

package/dist/store/sqlite/manifest.js

@@ -55,6 +55,7 @@ export const MANIFEST = [
     { name: "20261030114008_version-39-email-locations", version: 39, minCompatible: 34 },
     { name: "20261030225520_version-40-note-trigrams", version: 40, minCompatible: 34 },
     { name: "20261031230945_version-41-task-fields", version: 41, minCompatible: 34 },
+    { name: "20261101002523_version-42-task-revision", version: 42, minCompatible: 34 },
 ];
 export const generatedMigrations = (manifest = MANIFEST, generated = GENERATED) => {
     const migrations = [];

package/dist/store/sqlite/migrations.generated.js

@@ -859,5 +859,16 @@ export const GENERATED = [
             "CREATE TRIGGER tasks_priority_score_au AFTER UPDATE OF priority ON tasks WHEN new.priority IS NOT old.priority AND new.priority_score IS old.priority_score BEGIN\n  UPDATE tasks SET priority_score = CASE new.priority WHEN 0 THEN 0.875 WHEN 1 THEN 0.625 WHEN 2 THEN 0.375 WHEN 3 THEN 0.1875 WHEN 4 THEN 0.0625 END WHERE id = new.id;\nEND;",
             "-- Every build's write bumps it, older ones too, so a stale copy is caught whoever wrote last.\nCREATE TRIGGER tasks_revision_au AFTER UPDATE ON tasks WHEN new.revision IS old.revision BEGIN\n  UPDATE tasks SET revision = old.revision + 1 WHERE id = new.id;\nEND;"
         ]
+    },
+    {
+        "name": "20261101002523_version-42-task-revision",
+        "statements": [
+            "-- A claim renewed, a follow-up time or a close suggestion is an agent at work, not a change a person could overwrite;\n-- bumping on those made the board report a conflict while an agent simply worked.\nDROP TRIGGER tasks_revision_au;",
+            "CREATE TRIGGER tasks_revision_au AFTER UPDATE OF title, description, status, priority, priority_score, agent, due_at, project_id, parent_id ON tasks\n  WHEN new.revision IS old.revision AND (new.title IS NOT old.title OR new.description IS NOT old.description\n    OR new.status IS NOT old.status OR new.priority IS NOT old.priority OR new.priority_score IS NOT old.priority_score\n    OR new.agent IS NOT old.agent OR new.due_at IS NOT old.due_at OR new.project_id IS NOT old.project_id\n    OR new.parent_id IS NOT old.parent_id) BEGIN\n  UPDATE tasks SET revision = old.revision + 1 WHERE id = new.id;\nEND;",
+            "CREATE TRIGGER tasks_revision_assignment_ai AFTER INSERT ON task_assignments BEGIN\n  UPDATE tasks SET revision = revision + 1 WHERE id = new.task_id;\nEND;",
+            "CREATE TRIGGER tasks_revision_assignment_ad AFTER DELETE ON task_assignments BEGIN\n  UPDATE tasks SET revision = revision + 1 WHERE id = old.task_id;\nEND;",
+            "CREATE TRIGGER tasks_revision_tagging_ai AFTER INSERT ON taggings WHEN new.taggable_type = 'task' BEGIN\n  UPDATE tasks SET revision = revision + 1 WHERE id = new.taggable_id;\nEND;",
+            "CREATE TRIGGER tasks_revision_tagging_ad AFTER DELETE ON taggings WHEN old.taggable_type = 'task' BEGIN\n  UPDATE tasks SET revision = revision + 1 WHERE id = old.taggable_id;\nEND;"
+        ]
     }
 ];

package/dist/store/sqlite/work-tasks.js

@@ -239,20 +239,27 @@ export const workTaskOperationsOver = (context) => {
             throw new CliError("validation_error", "give --before or --after, not both");
         if (!database.prepare(`SELECT 1 FROM tasks t WHERE t.id = ? AND ${BOARD_SCOPE}`).get(task))
             throw new CliError("validation_error", "only a project task moves on the board");
-        const status = move.status ?? row.status;
-        const column = columnOf(task, status);
         const neighbour = move.before ?? move.after;
         if (neighbour === undefined) {
-            if (column.length > 0 || move.status === undefined)
+            const status = move.status ?? row.status;
+            if (columnOf(task, status).length > 0 || move.status === undefined)
                 throw new CliError("validation_error", "say where it goes: --before <key> or --after <key>");
             const from = priorityLabel(row.priority_score == null ? null : Number(row.priority_score));
             edit(task, { status: move.status }, actor);
             return { label: { from, to: from, changed: false }, renumbered: [] };
         }
         const target = required(neighbour);
+        const anchor = database.prepare(`SELECT t.key, t.status FROM tasks t WHERE t.id = ? AND ${BOARD_SCOPE}`).get(target);
+        if (target === task)
+            throw new CliError("validation_error", "a task moves beside another task, not itself");
+        if (!anchor)
+            throw new CliError("validation_error", `${neighbour} is not on a project's board`);
+        // A card dropped beside one in another column joins that column; a status that names a different one is a mistake.
+        const status = anchor.status;
+        if (move.status !== undefined && move.status !== status)
+            throw new CliError("validation_error", `${String(anchor.key)} is in ${status}, not ${move.status}: pick a task in the ${move.status} column`, { reason: "task.column", anchor: String(anchor.key), anchorStatus: status, requestedStatus: move.status });
+        const column = columnOf(task, status);
         const at = column.findIndex(({ id }) => id === target);
-        if (at === -1)
-            throw new CliError("validation_error", `${move.before ?? move.after} is not a ${status} task of a project; a task moves beside one in its column`);
         const index = move.before === undefined ? at + 1 : at;
         const above = column[index - 1];
         const below = column[index];
@@ -285,7 +292,7 @@ export const workTaskOperationsOver = (context) => {
                 renumbered.push(one.key);
             });
         }
-        edit(task, { priority: given, ...(move.status === undefined ? {} : { status: move.status }) }, actor);
+        edit(task, { priority: given, status }, actor);
         const to = priorityLabel(given);
         return { label: { from, to, changed: from !== to }, renumbered };
     };

package/dist/tasks/index.d.ts

@@ -1,4 +1,4 @@
 export { CLOSED_STATES, type ClosedState, closeTask, isClosedState, TASK_KINDS, TASK_ORIGINS, TASK_STATES, TASK_VERDICTS, type Task, type TaskKind, type TaskOrigin, type TaskState, type TaskVerdict, } from "./model.js";
-export { checkedScore, LEGACY_PRIORITY_SCORES, legacyPriority, PRIORITY_LABELS, type PriorityLabel, priorityBand, priorityLabel, priorityOf, } from "./priority.js";
+export { checkedScore, LEGACY_PRIORITY_SCORES, legacyPriority, PRIORITY_LABELS, type PriorityLabel, priorityBand, priorityLabel, priorityOf, priorityOption, } from "./priority.js";
 export { type CloseOptions, createTaskService, type GroupStats, type NewTask, type TaskService, type TaskServiceOptions, } from "./service.js";
 export { matches, type TaskFilter, type TaskStore } from "./store.js";

package/dist/tasks/index.js

@@ -1,4 +1,4 @@
 export { CLOSED_STATES, closeTask, isClosedState, TASK_KINDS, TASK_ORIGINS, TASK_STATES, TASK_VERDICTS, } from "./model.js";
-export { checkedScore, LEGACY_PRIORITY_SCORES, legacyPriority, PRIORITY_LABELS, priorityBand, priorityLabel, priorityOf, } from "./priority.js";
+export { checkedScore, LEGACY_PRIORITY_SCORES, legacyPriority, PRIORITY_LABELS, priorityBand, priorityLabel, priorityOf, priorityOption, } from "./priority.js";
 export { createTaskService, } from "./service.js";
 export { matches } from "./store.js";

package/dist/tasks/priority.d.ts

@@ -16,3 +16,5 @@ export declare const checkedScore: (score: number) => number;
  * `none` clears it.
  */
 export declare const priorityOf: (value: string) => number | null;
+/** `priorityOf` for a command-line option: Commander stores a parser's `null` as an empty string, so `none` stays a word. */
+export declare const priorityOption: (value: string) => number | "none";

package/dist/tasks/priority.js

@@ -35,3 +35,5 @@ export const priorityOf = (value) => {
         return LEGACY_PRIORITY_SCORES[Number(word)];
     throw new CliError("validation_error", `a priority is ${PRIORITY_LABELS.join(", ")} or none; 0 (urgent) … 4 (low) still work as critical, high, medium, low, low`);
 };
+/** `priorityOf` for a command-line option: Commander stores a parser's `null` as an empty string, so `none` stays a word. */
+export const priorityOption = (value) => priorityOf(value) ?? "none";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.515.0",
+  "version": "0.517.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",