@astrosheep/keiyaku 2.9.13 → 4.0.1

package/build/core/task/commands.js

@@ -1,401 +0,0 @@
-import { FlowError } from "../../flow-error.js";
-import { IdentifierSlugError, taskIdentifierSlug, } from "../identifier-slug.js";
-import { markdownSourceSections } from "../scope.js";
-import { requireCanonicalTaskId, requireHealthy, resolveTaskId, } from "./board.js";
-import { dateTimestamp, invalid, nonblank, } from "./validation.js";
-import { advancedTaskUpdatedAt } from "./model.js";
-import { formatTaskCoordinate, parseTaskCoordinate } from "./coordinate.js";
-export async function readTaskBoard(repository) {
-    return repository.read();
-}
-function documentFromView(view) {
-    return {
-        id: view.id,
-        namespace: view.namespace,
-        coordinate: view.coordinate,
-        title: view.title,
-        state: view.state,
-        pri: view.pri,
-        needs: [...view.needs],
-        parent: view.parent,
-        from: [...view.from],
-        supersedes: [...view.supersedes],
-        relatesTo: [...view.relatesTo],
-        notes: view.notes.map((note) => ({ ...note })),
-        createdAt: view.createdAt,
-        ...(view.updatedAt === undefined ? {} : { updatedAt: view.updatedAt }),
-        creator: view.creator,
-        ...(view.startedAt === undefined ? {} : { startedAt: view.startedAt }),
-        ...(view.contractId === undefined ? {} : { contractId: view.contractId }),
-        body: view.body,
-    };
-}
-function documentCoordinate(document) {
-    return document.coordinate ?? formatTaskCoordinate(document.namespace ?? null, document.id);
-}
-function replaceDocument(document, subject) {
-    return {
-        replacements: [document],
-        subject,
-        select(resulting) {
-            const coordinate = documentCoordinate(document);
-            const value = resulting.byId.get(coordinate);
-            if (!value)
-                throw new FlowError("INTERNAL_STATE", `mutated task ${coordinate} disappeared from the board`);
-            return value;
-        },
-    };
-}
-function requireExisting(board, id) {
-    const task = board.byId.get(requireCanonicalTaskId(id));
-    if (!task)
-        throw new FlowError("INVALID_TARGET", `task '${id}' not found`);
-    return task;
-}
-function resolveMutationIds(board, ids) {
-    return ids.map((id) => resolveTaskId(board, id));
-}
-function validateRelations(board, id, supersedes, relatesTo) {
-    if (supersedes.includes(id) || relatesTo.includes(id))
-        invalid(`task ${id} relations must not reference itself`);
-    const seen = new Set();
-    const reachesSource = (current) => {
-        if (current === id)
-            return true;
-        if (seen.has(current))
-            return false;
-        seen.add(current);
-        return (board.byId.get(current)?.supersedes ?? []).some(reachesSource);
-    };
-    for (const target of supersedes) {
-        seen.clear();
-        if (reachesSource(target))
-            invalid(`task ${id} would create a supersedes cycle`);
-    }
-}
-function updateRelations(board, document, field, additions, removals) {
-    const added = resolveMutationIds(board, additions ?? []);
-    if (new Set(added).size !== added.length)
-        invalid(`task ${field} edges must be unique`);
-    const removed = new Set(resolveMutationIds(board, removals ?? []));
-    const retained = (document[field] ?? []).filter((value) => !removed.has(value));
-    if (added.some((value) => retained.includes(value)))
-        invalid(`task ${field} edges must be unique`);
-    document[field] = [...retained, ...added];
-}
-export async function createTask(repository, input, deps) {
-    nonblank("title", input.title);
-    nonblank("creator", input.creator);
-    const pri = input.pri ?? 2;
-    if (!Number.isInteger(pri) || pri < 0 || pri > 3)
-        invalid("task priority must be an integer from 0 through 3");
-    return repository.mutate((board) => {
-        requireHealthy(board);
-        const namespace = input.namespace ?? null;
-        if (namespace !== null)
-            parseTaskCoordinate(`${namespace}/task`, "task namespace");
-        const needs = resolveMutationIds(board, input.needs ?? []);
-        if (new Set(needs).size !== needs.length)
-            invalid("task needs must be unique");
-        const parent = input.parent == null ? null : resolveTaskId(board, input.parent);
-        const from = resolveMutationIds(board, input.from ?? []);
-        if (new Set(from).size !== from.length)
-            invalid("task from edges must be unique");
-        const supersedes = resolveMutationIds(board, input.supersedes ?? []);
-        if (new Set(supersedes).size !== supersedes.length)
-            invalid("task supersedes edges must be unique");
-        const relatesTo = resolveMutationIds(board, input.relatesTo ?? []);
-        if (new Set(relatesTo).size !== relatesTo.length)
-            invalid("task relatesTo edges must be unique");
-        let ordinal = 1;
-        let id;
-        for (;;) {
-            if (!Number.isSafeInteger(ordinal)) {
-                throw new FlowError("INTERNAL_STATE", "task id collision ordinal exceeded the safe integer range");
-            }
-            try {
-                id = taskIdentifierSlug(input.title, ordinal === 1 ? "" : `-${ordinal}`);
-            }
-            catch (error) {
-                if (error instanceof IdentifierSlugError) {
-                    throw new FlowError("INVALID_TARGET", `task title ${error.message}`, { cause: error });
-                }
-                throw error;
-            }
-            if (!board.byId.has(formatTaskCoordinate(namespace, id)))
-                break;
-            ordinal += 1;
-        }
-        const coordinate = formatTaskCoordinate(namespace, id);
-        validateRelations(board, coordinate, supersedes, relatesTo);
-        const now = deps.now();
-        const document = {
-            id,
-            namespace,
-            coordinate,
-            title: input.title,
-            state: "open",
-            pri,
-            needs,
-            parent,
-            from,
-            supersedes,
-            relatesTo,
-            notes: [],
-            createdAt: dateTimestamp("createdAt", now),
-            updatedAt: dateTimestamp("updatedAt", now),
-            creator: input.creator,
-            body: input.body ?? "",
-        };
-        return replaceDocument(document, `Add task ${coordinate}`);
-    });
-}
-export async function updateTask(repository, fullIdValue, patch, now = new Date()) {
-    return (await updateTaskWithReceipt(repository, fullIdValue, patch, now)).task;
-}
-export async function updateTaskWithReceipt(repository, fullIdValue, patch, now = new Date()) {
-    const hasChange = Object.values(patch).some((value) => value !== undefined);
-    if (!hasChange)
-        throw new FlowError("EMPTY_PARAM", "task update requires at least one change");
-    if (patch.body !== undefined && patch.appendBody !== undefined) {
-        throw new FlowError("EMPTY_PARAM", "task update cannot combine --body and --append");
-    }
-    return repository.mutate((board) => {
-        requireHealthy(board);
-        const id = resolveTaskId(board, fullIdValue);
-        const current = requireExisting(board, id);
-        const document = documentFromView(current);
-        if (patch.title !== undefined)
-            document.title = nonblank("title", patch.title);
-        if (patch.body !== undefined)
-            document.body = patch.body;
-        if (patch.appendBody !== undefined)
-            document.body = appendBody(document.body, patch.appendBody);
-        if (patch.pri !== undefined) {
-            if (!Number.isInteger(patch.pri) || patch.pri < 0 || patch.pri > 3)
-                invalid("task priority must be an integer from 0 through 3");
-            document.pri = patch.pri;
-        }
-        const additions = resolveMutationIds(board, patch.addNeeds ?? []);
-        const removals = new Set(resolveMutationIds(board, patch.dropNeeds ?? []));
-        document.needs = [...new Set([...document.needs.filter((need) => !removals.has(need)), ...additions])];
-        if (patch.parent !== undefined)
-            document.parent = patch.parent === null ? null : resolveTaskId(board, patch.parent);
-        if (patch.from !== undefined) {
-            document.from = [...new Set([...document.from, ...resolveMutationIds(board, patch.from)])];
-        }
-        updateRelations(board, document, "supersedes", patch.addSupersedes, patch.dropSupersedes);
-        updateRelations(board, document, "relatesTo", patch.addRelatesTo, patch.dropRelatesTo);
-        validateRelations(board, document.coordinate, document.supersedes, document.relatesTo);
-        if (JSON.stringify(document) === JSON.stringify(documentFromView(current))) {
-            throw new FlowError("EMPTY_PARAM", "task update requires at least one change");
-        }
-        document.updatedAt = advancedTaskUpdatedAt(current, now);
-        const bodyChange = patch.body === undefined ? undefined : describeBodyChange(current.body, document.body);
-        return {
-            replacements: [document],
-            subject: `Update task ${id}`,
-            select(resulting) {
-                const coordinate = documentCoordinate(document);
-                const task = resulting.byId.get(coordinate);
-                if (!task)
-                    throw new FlowError("INTERNAL_STATE", `mutated task ${coordinate} disappeared from the board`);
-                return { task, ...(bodyChange === undefined ? {} : { bodyChange }) };
-            },
-        };
-    });
-}
-function appendBody(body, addition) {
-    if (!body || !addition || body.endsWith("\n\n") || addition.startsWith("\n"))
-        return body + addition;
-    return `${body}${body.endsWith("\n") ? "\n" : "\n\n"}${addition}`;
-}
-function markdownLevelTwoSections(body) {
-    return markdownSourceSections(body)
-        .filter((section) => section.level === 2)
-        .map((section) => section.title.trim());
-}
-function bodyLines(body) {
-    return body.match(/[^\n]*\n|[^\n]+$/g) ?? [];
-}
-function lineDiffstat(before, after) {
-    const oldLines = bodyLines(before);
-    const newLines = bodyLines(after);
-    const lcs = Array(newLines.length + 1).fill(0);
-    for (const oldLine of oldLines) {
-        let previous = 0;
-        for (let index = 1; index <= newLines.length; index += 1) {
-            const saved = lcs[index];
-            lcs[index] = oldLine === newLines[index - 1]
-                ? previous + 1
-                : Math.max(lcs[index], lcs[index - 1]);
-            previous = saved;
-        }
-    }
-    const unchanged = lcs[newLines.length];
-    return { additions: newLines.length - unchanged, deletions: oldLines.length - unchanged };
-}
-function describeBodyChange(before, after) {
-    const remaining = new Map();
-    for (const section of markdownLevelTwoSections(after)) {
-        remaining.set(section, (remaining.get(section) ?? 0) + 1);
-    }
-    const oldBytes = Buffer.byteLength(before, "utf8");
-    const newBytes = Buffer.byteLength(after, "utf8");
-    return {
-        oldBytes,
-        newBytes,
-        removedSections: markdownLevelTwoSections(before).filter((section) => {
-            const count = remaining.get(section) ?? 0;
-            if (count === 0)
-                return true;
-            remaining.set(section, count - 1);
-            return false;
-        }),
-        diffstat: lineDiffstat(before, after),
-    };
-}
-async function transition(repository, fullIdValue, apply, subject, now) {
-    return repository.mutate((board) => {
-        requireHealthy(board);
-        const id = fullIdValue === undefined
-            ? selectSoleInProgress(board).coordinate
-            : resolveTaskId(board, fullIdValue);
-        const current = requireExisting(board, id);
-        const document = documentFromView(current);
-        apply(document);
-        document.updatedAt = advancedTaskUpdatedAt(current, now);
-        return replaceDocument(document, subject(id));
-    });
-}
-function rejectBound(document, action = "state") {
-    if (document.contractId !== undefined) {
-        const coordinate = documentCoordinate(document);
-        if (action === "drop") {
-            throw new FlowError("UNSUPPORTED_POLICY", `task ${coordinate} is bound to contract ${document.contractId}; forfeit the contract before dropping this task`);
-        }
-        throw new FlowError("UNSUPPORTED_POLICY", `task ${coordinate} is bound to contract ${document.contractId}; its state follows the contract`);
-    }
-}
-export async function startTask(repository, fullId, now) {
-    return transition(repository, fullId, (document) => {
-        rejectBound(document);
-        if (document.state !== "open")
-            invalid(`task ${documentCoordinate(document)} is ${document.state}, not open`);
-        document.state = "in_progress";
-        document.startedAt = dateTimestamp("startedAt", now);
-    }, (id) => `Start task ${id}`, now);
-}
-export async function stopTask(repository, fullId, now = new Date()) {
-    return transition(repository, fullId, (document) => {
-        rejectBound(document);
-        if (document.state !== "in_progress")
-            invalid(`task ${documentCoordinate(document)} is ${document.state}, not in_progress`);
-        document.state = "open";
-        delete document.startedAt;
-    }, (id) => `Stop task ${id}`, now);
-}
-export async function holdTask(repository, fullId, now = new Date()) {
-    return transition(repository, fullId, (document) => {
-        rejectBound(document);
-        if (document.state !== "open" && document.state !== "in_progress") {
-            invalid(`task ${documentCoordinate(document)} is ${document.state}, not open or in_progress`);
-        }
-        document.state = "on_hold";
-        delete document.startedAt;
-    }, (id) => `Hold task ${id}`, now);
-}
-export async function resumeTask(repository, fullId, now = new Date()) {
-    return transition(repository, fullId, (document) => {
-        rejectBound(document);
-        if (document.state !== "on_hold")
-            invalid(`task ${documentCoordinate(document)} is ${document.state}, not on_hold`);
-        document.state = "open";
-    }, (id) => `Resume task ${id}`, now);
-}
-export async function doneTask(repository, fullId, now = new Date()) {
-    return transition(repository, fullId, (document) => {
-        rejectBound(document);
-        if (document.state !== "open" && document.state !== "in_progress" && document.state !== "on_hold") {
-            invalid(`task ${documentCoordinate(document)} is ${document.state}, not open, in_progress, or on_hold`);
-        }
-        document.state = "done";
-        delete document.startedAt;
-    }, (id) => `Done task ${id}`, now);
-}
-export async function dropTask(repository, fullId, now = new Date()) {
-    return dropTaskWithNote(repository, fullId, undefined, now);
-}
-export async function appendTaskNote(repository, fullId, input, now = new Date()) {
-    nonblank("task note actor", input.actor);
-    nonblank("task note text", input.text);
-    return repository.mutate((board) => {
-        requireHealthy(board);
-        const id = resolveTaskId(board, fullId);
-        const current = requireExisting(board, id);
-        const document = documentFromView(current);
-        document.notes.push({ actor: input.actor, timestamp: dateTimestamp("task note timestamp", now), text: input.text });
-        document.updatedAt = advancedTaskUpdatedAt(current, now);
-        return replaceDocument(document, `Note task ${id}`);
-    });
-}
-export async function dropTaskWithNote(repository, fullId, note, now = new Date()) {
-    if (note !== undefined) {
-        nonblank("task note actor", note.actor);
-        nonblank("task note text", note.text);
-    }
-    return transition(repository, fullId, (document) => {
-        rejectBound(document, "drop");
-        if (document.state !== "open" && document.state !== "in_progress" && document.state !== "on_hold") {
-            invalid(`task ${documentCoordinate(document)} is ${document.state}, not open, in_progress, or on_hold`);
-        }
-        document.state = "drop";
-        delete document.startedAt;
-        if (note !== undefined) {
-            document.notes.push({ actor: note.actor, timestamp: dateTimestamp("task note timestamp", now), text: note.text });
-        }
-    }, (id) => `Drop task ${id}`, now);
-}
-export function selectSoleInProgress(board) {
-    const candidates = board.tasks.filter((task) => task.state === "in_progress");
-    if (candidates.length === 1)
-        return candidates[0];
-    const ids = candidates.map((task) => task.coordinate).sort();
-    const code = candidates.length === 0 ? "INVALID_TARGET" : "TASK_AMBIGUOUS";
-    throw Object.assign(new FlowError(code, candidates.length === 0
-        ? "no task in progress"
-        : "more than one task in progress; pass a coordinate", candidates.length === 0 ? undefined : {
-        facts: { kind: "task_ambiguous", candidates: ids },
-    }), { candidates: ids, candidateTasks: candidates });
-}
-/** Reopen task pointers whose contract authority has disappeared. The caller
- * supplies the ledger fact; this operation itself remains storage-neutral. */
-export async function rollbackOrphanTaskPointers(repository, contractIds, now = new Date()) {
-    const before = await repository.read();
-    const orphans = before.tasks
-        .filter((task) => task.contractId !== undefined && !contractIds.has(task.contractId))
-        .map((task) => ({ taskId: task.coordinate, contractId: task.contractId }))
-        .sort((a, b) => a.taskId.localeCompare(b.taskId));
-    if (orphans.length === 0)
-        return [];
-    await repository.mutate((board) => {
-        const replacements = orphans.flatMap(({ taskId: id }) => {
-            const current = board.byId.get(id);
-            if (!current || current.contractId === undefined || contractIds.has(current.contractId))
-                return [];
-            const document = documentFromView(current);
-            document.state = "open";
-            document.updatedAt = advancedTaskUpdatedAt(current, now);
-            delete document.startedAt;
-            delete document.contractId;
-            return [document];
-        });
-        if (replacements.length === 0)
-            throw new FlowError("CONCURRENT_MODIFICATION", "task pointers changed while doctor was reconciling them");
-        const subject = replacements.length === 1
-            ? `Clear orphan contract pointer from task ${documentCoordinate(replacements[0])}`
-            : `Clear orphan contract pointers from ${replacements.length} tasks`;
-        return { replacements, subject, select: () => undefined };
-    });
-    return orphans;
-}