light-plan 0.0.0-stage → 0.1.0

package/dist/core/operations/comment.js

@@ -0,0 +1,46 @@
+import { findNode } from '../board/query.js';
+import { BoardError } from '../errors.js';
+import { appendComment, readComments, writeComments } from '../storage/comments.js';
+import { nowIso } from '../storage/document.js';
+import { gitIdentity } from '../storage/git.js';
+import { boardWrite } from './shared.js';
+function requireNode(board, id) {
+    const node = findNode(board, id);
+    if (!node)
+        throw new BoardError(`No issue, period or resource with id "${id}"`);
+    return node;
+}
+export function addComment(board, id, input) {
+    return boardWrite(board, `comment on ${id}`, () => {
+        const body = input.body.trim();
+        if (!body)
+            throw new BoardError('A comment cannot be empty');
+        const node = requireNode(board, id);
+        const at = input.at ?? nowIso();
+        const author = input.author?.trim() || gitIdentity(board.paths.lpmDir) || 'unknown';
+        appendComment(node.dir, { at, author, body });
+        const comments = readComments(node.dir);
+        return { node, comment: comments.at(-1), total: comments.length };
+    });
+}
+export function listComments(board, id) {
+    return readComments(requireNode(board, id).dir);
+}
+/** Delete one comment by its position. Numbering starts at 1. */
+export function removeComment(board, id, index) {
+    // Read-modify-write of the whole log: two deletions racing would each rewrite
+    // the file from the list they read, and one of the two would come back.
+    return boardWrite(board, `delete a comment on ${id}`, () => {
+        const node = requireNode(board, id);
+        const comments = readComments(node.dir);
+        const target = comments.find((comment) => comment.index === index);
+        if (!target) {
+            throw new BoardError(`${id} has no comment ${index}`, [
+                comments.length ? `It has ${comments.length}.` : 'It has none.',
+            ]);
+        }
+        writeComments(node.dir, comments.filter((comment) => comment.index !== index));
+        return target;
+    });
+}
+//# sourceMappingURL=comment.js.map

package/dist/core/operations/comment.js.map

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

package/dist/core/operations/create.d.ts

@@ -0,0 +1,82 @@
+import type { LoadedBoard } from '../board/load.js';
+import type { Issue, ParamDefs, Period, Resource, Squad, Template } from '../model/types.js';
+export interface NewIssueInput {
+    type: string;
+    title: string;
+    status?: string;
+    /** Parent issue id; omit to create at the board root. */
+    parentId?: string;
+    /** Period to schedule the issue in. */
+    period?: string;
+    /** Resource to assign the issue to — a person or a pool, by id or name. */
+    assignee?: string;
+    dependsOn?: string[];
+    relatesTo?: string[];
+    /** Files this issue is about: the requirement, the source that has to change. */
+    relatedFiles?: string[];
+    attributes?: Record<string, unknown>;
+    author?: string;
+}
+export declare function createIssue(board: LoadedBoard, input: NewIssueInput): Issue;
+export interface NewPeriodInput {
+    type: string;
+    title: string;
+    starts: string;
+    ends: string;
+    /** Parent period id; omit to create at the top of the timeline. */
+    parentId?: string;
+    /** The switch over the dates. Omit — the normal case — to let them decide. */
+    active?: boolean;
+    /** Id of the squad that owns this period. */
+    squad?: string;
+    attributes?: Record<string, unknown>;
+    author?: string;
+}
+export declare function createPeriod(board: LoadedBoard, input: NewPeriodInput): Period;
+export interface NewResourceInput {
+    type: string;
+    title: string;
+    /** Full-time equivalents. Defaults to 1: one person at full time. */
+    capacity?: number;
+    /** Generic resources this one can be drawn from. */
+    covers?: string[];
+    /** Parent resource id; omit to create at the top of the roster. */
+    parentId?: string;
+    attributes?: Record<string, unknown>;
+    author?: string;
+}
+export declare function createResource(board: LoadedBoard, input: NewResourceInput): Resource;
+export interface NewTemplateInput {
+    /** An issue type, or `folder` for a container. */
+    type: string;
+    title: string;
+    /** What this template is for. Shown in the registry listing. */
+    description?: string;
+    /** Parent template id; omit to create at the top of the registry. */
+    parentId?: string;
+    /** What this template asks for. Roots only — see `Template.params`. */
+    params?: ParamDefs;
+    dependsOn?: string[];
+    relatesTo?: string[];
+    relatedFiles?: string[];
+    attributes?: Record<string, unknown>;
+    author?: string;
+}
+/**
+ * Add a document to the template registry.
+ *
+ * A template is written in the board's own issue types, so this reads like
+ * `createIssue` with the scheduling taken out: nothing here has a status, an
+ * assignee or a period, because none of that is decided until the template is
+ * instantiated. @see planInstantiate
+ */
+export declare function createTemplate(board: LoadedBoard, input: NewTemplateInput): Template;
+export interface NewSquadInput {
+    type: string;
+    title: string;
+    /** Resource ids that belong to this squad. */
+    members?: string[];
+    attributes?: Record<string, unknown>;
+    author?: string;
+}
+export declare function createSquad(board: LoadedBoard, input: NewSquadInput): Squad;

package/dist/core/operations/create.js

@@ -0,0 +1,306 @@
+import { mkdirSync } from 'node:fs';
+import path from 'node:path';
+import { DEFAULT_CAPACITY } from '../board/load.js';
+import { BoardError } from '../errors.js';
+import { hasPeriods, hasResources, hasSquads, isFolderTemplate } from '../model/types.js';
+import { nowIso } from '../storage/document.js';
+import { gitIdentity } from '../storage/git.js';
+import { collectionDir, documentFileName } from '../storage/paths.js';
+import { writeBoardIndex } from './board-index.js';
+import { propagateStatus } from './rollup.js';
+import { allocateFor, boardWrite, buildAttributes, normalizeFileRefs, prepareFolder, requireCapacity, requireDates, requirePeriod, requireResource, requireStatus, resolveCoverTargets, resolveLinkTargets, resolveParentFor, resolveTemplateLinkTargets, typeDefOf, writeDocument, } from './shared.js';
+export function createIssue(board, input) {
+    // Locked for the id as much as for the document: `allocateFor` reads the
+    // counter, bumps it and writes it back, so two processes creating an issue
+    // at the same moment would otherwise both be handed the same id.
+    return boardWrite(board, 'create an issue', () => createIssueUnderLock(board, input));
+}
+function createIssueUnderLock(board, input) {
+    const typeDef = typeDefOf(board, 'issue', input.type);
+    const title = input.title.trim();
+    if (!title)
+        throw new BoardError('Issue title cannot be empty');
+    const parent = resolveParentFor(board, 'issue', input.type, input.parentId);
+    const status = input.status ?? board.config.default_status;
+    requireStatus(board, status);
+    if (input.period)
+        requirePeriod(board, input.period);
+    const assignee = input.assignee ? requireResource(board, input.assignee).id : null;
+    const dependsOn = resolveLinkTargets(board, input.dependsOn ?? []);
+    const relatesTo = resolveLinkTargets(board, input.relatesTo ?? []);
+    const attributes = buildAttributes(typeDef, input.type, input.attributes);
+    const id = allocateFor(board, 'issue');
+    const dir = prepareFolder(board, parent ? parent.dir : board.paths.boardDir, id);
+    const timestamp = nowIso();
+    const issue = {
+        kind: 'issue',
+        id,
+        type: input.type,
+        title,
+        status,
+        assignee,
+        period: input.period ?? null,
+        // A new issue is never flagged: nobody has started it yet.
+        flag: null,
+        depends_on: dependsOn,
+        relates_to: relatesTo,
+        related_files: normalizeFileRefs(input.relatedFiles ?? []),
+        created: timestamp,
+        updated: timestamp,
+        author: input.author ?? gitIdentity(board.paths.lpmDir),
+        attributes,
+        body: typeDef.body,
+        dir,
+        file: path.join(dir, documentFileName('issue')),
+        parentId: parent ? parent.id : null,
+        depth: parent ? parent.depth + 1 : 0,
+    };
+    writeDocument(board, issue);
+    writeBoardIndex(board, { node: issue });
+    // Open work inside a container that claimed to be finished reopens it — the
+    // same rule `moveNode` applies, since adding a story is one more way for a
+    // closed feature to stop being true. It writes nothing when the parent is
+    // open, which is every ordinary create. @see src/shared/rollup.ts
+    propagateStatus(board, issue, issue.status);
+    return issue;
+}
+export function createPeriod(board, input) {
+    // Locked for the id as much as for the document: `allocateFor` reads the
+    // counter, bumps it and writes it back, so two processes creating a period
+    // at the same moment would otherwise both be handed the same id.
+    return boardWrite(board, 'create a period', () => createPeriodUnderLock(board, input));
+}
+function createPeriodUnderLock(board, input) {
+    if (!hasPeriods(board.config)) {
+        throw new BoardError('This board has no time hierarchy', [
+            'Add period_types, period_hierarchy and period_prefix to .lpm/config.yml.',
+        ]);
+    }
+    const typeDef = typeDefOf(board, 'period', input.type);
+    const title = input.title.trim();
+    if (!title)
+        throw new BoardError('Period title cannot be empty');
+    requireDates(input.starts, input.ends);
+    const parent = resolveParentFor(board, 'period', input.type, input.parentId);
+    if (parent && parent.starts && parent.ends) {
+        if (input.starts < parent.starts || input.ends > parent.ends) {
+            throw new BoardError(`${input.starts}..${input.ends} falls outside ${parent.id} (${parent.starts}..${parent.ends})`, ['A period must fit inside its parent period.']);
+        }
+    }
+    const attributes = buildAttributes(typeDef, input.type, input.attributes);
+    const id = allocateFor(board, 'period');
+    const parentDir = parent ? parent.dir : collectionDir(board.paths, 'period');
+    mkdirSync(parentDir, { recursive: true });
+    const dir = prepareFolder(board, parentDir, id);
+    const timestamp = nowIso();
+    // Validate squad if given
+    let squad = null;
+    if (input.squad) {
+        if (!board.squadsById.get(input.squad)) {
+            throw new BoardError(`No squad with id "${input.squad}"`, [
+                board.squads.length
+                    ? `Available squads: ${board.squads.map((s) => `${s.id} (${s.title})`).join(', ')}`
+                    : 'This board has no squads. Create one with `lpm new squad -t "..."`.',
+            ]);
+        }
+        squad = input.squad;
+    }
+    const period = {
+        kind: 'period',
+        id,
+        type: input.type,
+        title,
+        starts: input.starts,
+        ends: input.ends,
+        active: input.active,
+        squad,
+        created: timestamp,
+        updated: timestamp,
+        author: input.author ?? gitIdentity(board.paths.lpmDir),
+        attributes,
+        body: typeDef.body,
+        dir,
+        file: path.join(dir, documentFileName('period')),
+        parentId: parent ? parent.id : null,
+        depth: parent ? parent.depth + 1 : 0,
+    };
+    writeDocument(board, period);
+    writeBoardIndex(board, { node: period });
+    return period;
+}
+export function createResource(board, input) {
+    // Locked for the id as much as for the document: `allocateFor` reads the
+    // counter, bumps it and writes it back, so two processes creating a resource
+    // at the same moment would otherwise both be handed the same id.
+    return boardWrite(board, 'create a resource', () => createResourceUnderLock(board, input));
+}
+function createResourceUnderLock(board, input) {
+    if (!hasResources(board.config)) {
+        throw new BoardError('This board has no team roster', [
+            'Add resource_types, resource_hierarchy and resource_prefix to .lpm/config.yml.',
+        ]);
+    }
+    const typeDef = typeDefOf(board, 'resource', input.type);
+    const title = input.title.trim();
+    if (!title)
+        throw new BoardError('Resource title cannot be empty');
+    const capacity = input.capacity ?? DEFAULT_CAPACITY;
+    requireCapacity(capacity);
+    const covers = resolveCoverTargets(board, input.covers ?? []);
+    const parent = resolveParentFor(board, 'resource', input.type, input.parentId);
+    const attributes = buildAttributes(typeDef, input.type, input.attributes);
+    const id = allocateFor(board, 'resource');
+    const parentDir = parent ? parent.dir : collectionDir(board.paths, 'resource');
+    mkdirSync(parentDir, { recursive: true });
+    const dir = prepareFolder(board, parentDir, id);
+    const timestamp = nowIso();
+    const resource = {
+        kind: 'resource',
+        id,
+        type: input.type,
+        title,
+        capacity,
+        covers,
+        created: timestamp,
+        updated: timestamp,
+        author: input.author ?? gitIdentity(board.paths.lpmDir),
+        attributes,
+        body: typeDef.body,
+        dir,
+        file: path.join(dir, documentFileName('resource')),
+        parentId: parent ? parent.id : null,
+        depth: parent ? parent.depth + 1 : 0,
+    };
+    writeDocument(board, resource);
+    writeBoardIndex(board, { node: resource });
+    return resource;
+}
+/**
+ * Add a document to the template registry.
+ *
+ * A template is written in the board's own issue types, so this reads like
+ * `createIssue` with the scheduling taken out: nothing here has a status, an
+ * assignee or a period, because none of that is decided until the template is
+ * instantiated. @see planInstantiate
+ */
+export function createTemplate(board, input) {
+    // Locked for the id as much as for the document: `allocateFor` reads the
+    // counter, bumps it and writes it back, so two processes creating a template
+    // at the same moment would otherwise both be handed the same id.
+    return boardWrite(board, 'create a template', () => createTemplateUnderLock(board, input));
+}
+function createTemplateUnderLock(board, input) {
+    const typeDef = typeDefOf(board, 'template', input.type);
+    const title = input.title.trim();
+    if (!title)
+        throw new BoardError('Template title cannot be empty');
+    const parent = resolveParentFor(board, 'template', input.type, input.parentId);
+    const dependsOn = resolveTemplateLinkTargets(board, input.dependsOn ?? []);
+    const relatesTo = resolveTemplateLinkTargets(board, input.relatesTo ?? []);
+    // Only a root asks for anything: it is what somebody instantiates, and its
+    // children take the answers it was given. `check` reports a document that
+    // declares parameters anywhere else, and refusing to write one in the first
+    // place is the same rule one step earlier.
+    const params = input.params ?? {};
+    if (Object.keys(params).length) {
+        if (isFolderTemplate({ type: input.type })) {
+            throw new BoardError('A folder cannot declare parameters', [
+                'Parameters belong on the template somebody instantiates, not on the folder holding it.',
+            ]);
+        }
+        if (parent && !isFolderTemplate(parent)) {
+            throw new BoardError('Only a root declares parameters', [
+                `This would sit inside the template ${parent.id}, so it is part of one.`,
+                `Put the parameters on ${parent.id}, or on whatever root holds it.`,
+            ]);
+        }
+    }
+    const attributes = buildAttributes(typeDef, input.type, input.attributes, true);
+    const id = allocateFor(board, 'template');
+    const parentDir = parent ? parent.dir : collectionDir(board.paths, 'template');
+    mkdirSync(parentDir, { recursive: true });
+    const dir = prepareFolder(board, parentDir, id);
+    const timestamp = nowIso();
+    const template = {
+        kind: 'template',
+        id,
+        type: input.type,
+        title,
+        description: input.description?.trim() ?? '',
+        params,
+        depends_on: dependsOn,
+        relates_to: relatesTo,
+        related_files: normalizeFileRefs(input.relatedFiles ?? []),
+        created: timestamp,
+        updated: timestamp,
+        author: input.author ?? gitIdentity(board.paths.lpmDir),
+        attributes,
+        // A folder carries no scaffolding; a template of a type starts from the
+        // same body a new issue of that type would, which is the point of it.
+        body: typeDef.body,
+        dir,
+        file: path.join(dir, documentFileName('template')),
+        parentId: parent ? parent.id : null,
+        depth: parent ? parent.depth + 1 : 0,
+    };
+    writeDocument(board, template);
+    writeBoardIndex(board, { node: template });
+    return template;
+}
+export function createSquad(board, input) {
+    // Locked for the id as much as for the document: `allocateFor` reads the
+    // counter, bumps it and writes it back, so two processes creating a squad
+    // at the same moment would otherwise both be handed the same id.
+    return boardWrite(board, 'create a squad', () => createSquadUnderLock(board, input));
+}
+function createSquadUnderLock(board, input) {
+    if (!hasSquads(board.config)) {
+        throw new BoardError('This board has no squad types', [
+            'Add squad_types, squad_hierarchy and squad_prefix to .lpm/config.yml.',
+        ]);
+    }
+    const typeDef = typeDefOf(board, 'squad', input.type);
+    const title = input.title.trim();
+    if (!title)
+        throw new BoardError('Squad title cannot be empty');
+    const resolvedMembers = [];
+    if (input.members) {
+        for (const raw of input.members) {
+            const id = raw.trim();
+            if (!id)
+                continue;
+            const resource = board.resourcesById.get(id);
+            if (!resource)
+                throw new BoardError(`No resource with id "${id}"`);
+            if (!resolvedMembers.includes(resource.id))
+                resolvedMembers.push(resource.id);
+        }
+    }
+    const parent = resolveParentFor(board, 'squad', input.type, undefined);
+    const attributes = buildAttributes(typeDef, input.type, input.attributes);
+    const id = allocateFor(board, 'squad');
+    const parentDir = collectionDir(board.paths, 'squad');
+    mkdirSync(parentDir, { recursive: true });
+    const dir = prepareFolder(board, parentDir, id);
+    const timestamp = nowIso();
+    const squad = {
+        kind: 'squad',
+        id,
+        type: input.type,
+        title,
+        members: resolvedMembers,
+        created: timestamp,
+        updated: timestamp,
+        author: input.author ?? gitIdentity(board.paths.lpmDir),
+        attributes,
+        body: typeDef.body,
+        dir,
+        file: path.join(dir, documentFileName('squad')),
+        parentId: parent ? parent.id : null,
+        depth: parent ? parent.depth + 1 : 0,
+    };
+    writeDocument(board, squad);
+    writeBoardIndex(board, { node: squad });
+    return squad;
+}
+//# sourceMappingURL=create.js.map

package/dist/core/operations/create.js.map

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

package/dist/core/operations/flag.d.ts

@@ -0,0 +1,58 @@
+import type { LoadedBoard } from '../board/load.js';
+import type { Issue } from '../model/types.js';
+import type { AppliedFlagRollup } from './rollup.js';
+/**
+ * Raising and clearing a flag: "I have stopped, and here is why."
+ *
+ * A flag is not a status. The issue stays in whatever column the board calls
+ * in-progress, and the flag says the work is not moving — which is a different
+ * claim from "nobody has started this", and the only one that needs somebody's
+ * attention today.
+ *
+ * The comment is written here rather than left to the caller, and it is
+ * required. A flag with no explanation is a red box nobody can act on: the
+ * person who has to clear it would have to go and ask what it means, which is
+ * exactly the round trip the flag exists to save. Putting the rule in the
+ * operation is what makes it true of the CLI, the MCP server and the web app at
+ * once, instead of three times over.
+ *
+ * Who may clear one is deliberately *not* enforced. Clearing a flag is the
+ * plan-owner's call — it says "carry on" — but light-plan has no permissions
+ * anywhere else and inventing them here would make a profile into access
+ * control. The convention is documented; the tooling records who did it.
+ */
+export interface FlagInput {
+    /** Why the work stopped. Defaults to `blocked`. */
+    reason?: string;
+    /** What happened, and what would unblock it. Required. */
+    comment: string;
+    /** Defaults to the git identity of the checkout. */
+    author?: string;
+}
+export interface FlagResult {
+    issue: Issue;
+    /**
+     * Containers above it whose flag changed with this one — gained one because
+     * work inside them stopped, or lost one because the last stopped work in
+     * them started again. @see src/shared/flag-rollup.ts
+     */
+    rollups: AppliedFlagRollup[];
+    /** The flag now on the issue, or null once it is cleared. */
+    flag: string | null;
+    /** What it was before, so a caller can say "already flagged". */
+    previous: string | null;
+    /** Position of the comment this call wrote. */
+    comment: number;
+}
+/**
+ * Flag an issue and say why. Refuses an issue that is already finished: work
+ * nobody is doing cannot be stuck, and a flag left on a closed issue is noise
+ * on the canvas forever.
+ */
+export declare function flagIssue(board: LoadedBoard, target: Issue, input: FlagInput): FlagResult;
+/**
+ * Clear a flag and say what changed. The comment is required here too: "carry
+ * on" with no reason attached tells the person picking the work back up
+ * nothing, and they are the one who wrote the flag.
+ */
+export declare function clearFlag(board: LoadedBoard, target: Issue, input: FlagInput): FlagResult;

package/dist/core/operations/flag.js

@@ -0,0 +1,95 @@
+import { isActiveStatus, isTerminalStatus } from '../config/lookup.js';
+import { BoardError } from '../errors.js';
+import { DERIVED_FLAG, FLAG_REASONS, flagLabel, isDerivedFlag, isFlagReason } from '../model/types.js';
+import { nowIso } from '../storage/document.js';
+import { gitIdentity } from '../storage/git.js';
+import { addComment } from './comment.js';
+import { boardWrite, requireUnchanged, setFlag, writeDocument } from './shared.js';
+import { propagateFlag } from './rollup.js';
+function requireReason(reason) {
+    const wanted = (reason ?? 'blocked').trim().toLowerCase();
+    // The roll-up's own word. Letting somebody type it would make a container's
+    // own flag indistinguishable from one the roll-up is free to clear.
+    if (isDerivedFlag(wanted)) {
+        throw new BoardError(`"${DERIVED_FLAG}" is not a reason you can raise`, [
+            'It is what a container carries while work inside it is stopped, and it',
+            'is written and cleared automatically.',
+            `Expected one of: ${FLAG_REASONS.join(', ')}.`,
+        ]);
+    }
+    if (!isFlagReason(wanted)) {
+        throw new BoardError(`Unknown flag reason "${reason}"`, [
+            `Expected one of: ${FLAG_REASONS.join(', ')}.`,
+            'blocked = something outside this issue has to happen first; ' +
+                'paused = deliberately set down; help = a person is needed.',
+        ]);
+    }
+    return wanted;
+}
+function requireComment(comment, verb) {
+    const body = comment?.trim() ?? '';
+    if (!body) {
+        throw new BoardError(`Say why you are ${verb}`, [
+            'A flag nobody can read is a red box nobody can act on.',
+            'Write what happened and what would resolve it.',
+        ]);
+    }
+    return body;
+}
+function write(board, target, flag, body, heading, author) {
+    const at = nowIso();
+    const resolvedAuthor = author?.trim() || gitIdentity(board.paths.lpmDir) || 'unknown';
+    const issue = { ...target, updated: at };
+    // The flag and the line in the body that records it, together — see setFlag.
+    setFlag(issue, flag, { at, author: resolvedAuthor, heading, text: body });
+    writeDocument(board, issue);
+    // After the write, so a comment is never attached to a flag that failed to
+    // land. Pass the resolved author explicitly so the comment and the activity
+    // entry always name the same person.
+    const result = addComment(board, issue.id, { body, author: resolvedAuthor, at });
+    // The board handle is stale by now — this wrote straight to disk — so the
+    // overlay is what tells the walk upward what this issue's flag actually is.
+    const rollups = propagateFlag(board, issue, new Map([[issue.id, flag]]));
+    return { issue, flag, previous: target.flag, comment: result.comment.index, rollups };
+}
+/**
+ * Flag an issue and say why. Refuses an issue that is already finished: work
+ * nobody is doing cannot be stuck, and a flag left on a closed issue is noise
+ * on the canvas forever.
+ */
+export function flagIssue(board, target, input) {
+    return boardWrite(board, `flag ${target.id}`, () => flagUnderLock(board, target, input));
+}
+function flagUnderLock(board, target, input) {
+    requireUnchanged(board, target);
+    const reason = requireReason(input.reason);
+    const body = requireComment(input.comment, 'flagging this');
+    if (isTerminalStatus(board.config, target.status)) {
+        throw new BoardError(`${target.id} is already "${target.status}"`, [
+            'Reopen it first if the work is not actually done.',
+        ]);
+    }
+    const note = `**Flagged: ${flagLabel(reason)}**\n\n${body}` +
+        (isActiveStatus(board.config, target.status)
+            ? ''
+            : `\n\n_(${target.id} is "${target.status}", not in progress.)_`);
+    return write(board, target, reason, note, `flagged: ${flagLabel(reason)}`, input.author);
+}
+/**
+ * Clear a flag and say what changed. The comment is required here too: "carry
+ * on" with no reason attached tells the person picking the work back up
+ * nothing, and they are the one who wrote the flag.
+ */
+export function clearFlag(board, target, input) {
+    return boardWrite(board, `clear the flag on ${target.id}`, () => clearUnderLock(board, target, input));
+}
+function clearUnderLock(board, target, input) {
+    requireUnchanged(board, target);
+    const body = requireComment(input.comment, 'clearing this flag');
+    if (!target.flag) {
+        throw new BoardError(`${target.id} is not flagged`, ['There is nothing to clear.']);
+    }
+    const note = `**Flag cleared** (was: ${flagLabel(target.flag)})\n\n${body}`;
+    return write(board, target, null, note, 'flag cleared', input.author);
+}
+//# sourceMappingURL=flag.js.map

package/dist/core/operations/flag.js.map

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