kanbo-cli 0.1.3 → 0.2.0

package/dist/lib/index.cjs

@@ -1,258 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_manifest = require("./manifest-BBJIrMw7.cjs");
+const require_manifest = require("./manifest-RDyoGrVR.cjs");
 const require_migrations_path = require("./migrations-path-CZxVOgeD.cjs");
-//#region src/ops/board-copy.ts
-/** Nothing copied — what a move that had nothing to move reports. */
-function emptyCopyCounts() {
-	return {
-		statuses: 0,
-		milestones: 0,
-		issues: 0,
-		comments: 0,
-		runs: 0,
-		relations: 0,
-		fieldChanges: 0,
-		contextRefs: 0,
-		pullRequests: 0
-	};
-}
-/**
-* Everything the workspace has on this board, read in one pass before a single
-* row is written anywhere.
-*
-* Links are collected by id because an edge is listed by both of the cards it
-* touches, and one reaching a card outside this workspace is left behind rather
-* than copied: the target holds this workspace's board and nothing else, so the
-* far end of that edge is not there to point at.
-*/
-async function readBoardSlice(from, workspaceId) {
-	const warnings = [];
-	const statuses = await from.statuses.listByWorkspace(workspaceId);
-	const milestones = await from.milestones.listByWorkspace(workspaceId);
-	const issues = orderParentsFirst(await from.issues.listByWorkspace(workspaceId));
-	const issueIds = new Set(issues.map((issue) => issue.id));
-	const comments = [];
-	const runs = [];
-	const relations = /* @__PURE__ */ new Map();
-	const fieldChanges = [];
-	const pullRequests = [];
-	const skippedRelations = /* @__PURE__ */ new Set();
-	for (const issue of issues) {
-		comments.push(...await from.comments.listByIssue(issue.id));
-		runs.push(...await from.runs.listByIssue(issue.id));
-		for (const relation of await from.relations.listByIssue(issue.id)) {
-			if (issueIds.has(relation.sourceIssueId) && issueIds.has(relation.targetIssueId)) {
-				relations.set(relation.id, relation);
-				continue;
-			}
-			skippedRelations.add(relation.id);
-		}
-		fieldChanges.push(...await from.fieldChanges.listByIssue(issue.id));
-		pullRequests.push(...await from.pullRequests.listByIssue(issue.id));
-	}
-	if (skippedRelations.size > 0) warnings.push(`${skippedRelations.size} links to cards in other workspaces were not moved`);
-	return {
-		statuses,
-		milestones,
-		issues,
-		comments,
-		runs,
-		relations: [...relations.values()],
-		fieldChanges,
-		pullRequests,
-		warnings
-	};
-}
-/**
-* Write a slice into the target board, in one transaction, and say what was
-* written and what a person should know about it — the slice's own warnings
-* first.
-*
-* It is idempotent by id. A row the target already has is left exactly as it
-* is and counted as already present, so a copy interrupted half-way is finished
-* by running it again, and a second run of a finished one copies nothing. A
-* clash that is not the same row — a column name or a card number the target
-* holds under another id — refuses the whole copy before its first insert
-* (`board_copy_conflict`, ruling 3-55).
-*/
-async function writeBoardSlice(to, slice, workspaceId) {
-	const warnings = [...slice.warnings];
-	const copied = emptyCopyCounts();
-	let alreadyPresent = 0;
-	await to.transaction(async (tx) => {
-		await assertTheCopyFits(tx, slice, workspaceId);
-		for (const status of slice.statuses) {
-			if (await tx.statuses.findById(status.id)) {
-				alreadyPresent += 1;
-				continue;
-			}
-			await tx.statuses.create(status);
-			copied.statuses += 1;
-		}
-		for (const milestone of slice.milestones) {
-			if (await tx.milestones.findById(milestone.id)) {
-				alreadyPresent += 1;
-				continue;
-			}
-			await tx.milestones.create(milestone);
-			copied.milestones += 1;
-		}
-		const movingIssueIds = new Set(slice.issues.map((issue) => issue.id));
-		for (const issue of slice.issues) {
-			if (await tx.issues.findById(issue.id)) {
-				alreadyPresent += 1;
-				continue;
-			}
-			const parentIsReachable = issue.parentIssueId === null || movingIssueIds.has(issue.parentIssueId) || await tx.issues.findById(issue.parentIssueId) !== null;
-			if (!parentIsReachable) warnings.push(`${issue.id} lost its parent card, which is not on this board`);
-			const { contextRefs, ...row } = issue;
-			await tx.issues.create({
-				...row,
-				parentIssueId: parentIsReachable ? issue.parentIssueId : null
-			});
-			copied.issues += 1;
-			if (contextRefs !== "[]") {
-				await tx.contextRefs.replace(issue.id, contextRefs, issue.updatedAt);
-				copied.contextRefs += 1;
-			}
-		}
-		for (const comment of slice.comments) {
-			if (await tx.comments.findById(comment.id)) {
-				alreadyPresent += 1;
-				continue;
-			}
-			await tx.comments.create(comment);
-			copied.comments += 1;
-		}
-		for (const run of slice.runs) {
-			if (await tx.runs.findById(run.id)) {
-				alreadyPresent += 1;
-				continue;
-			}
-			await tx.runs.create(run);
-			copied.runs += 1;
-		}
-		for (const relation of slice.relations) {
-			if (await tx.relations.findById(relation.id)) {
-				alreadyPresent += 1;
-				continue;
-			}
-			await tx.relations.create(relation);
-			copied.relations += 1;
-		}
-		const changesByIssue = /* @__PURE__ */ new Map();
-		for (const change of slice.fieldChanges) changesByIssue.set(change.issueId, [...changesByIssue.get(change.issueId) ?? [], change]);
-		for (const [issueId, changes] of changesByIssue) {
-			const present = new Set((await tx.fieldChanges.listByIssue(issueId)).map((change) => change.id));
-			for (const change of changes) {
-				if (present.has(change.id)) {
-					alreadyPresent += 1;
-					continue;
-				}
-				await tx.fieldChanges.create(change);
-				copied.fieldChanges += 1;
-			}
-		}
-		const linksByIssue = /* @__PURE__ */ new Map();
-		for (const link of slice.pullRequests) linksByIssue.set(link.issueId, [...linksByIssue.get(link.issueId) ?? [], link]);
-		for (const [issueId, links] of linksByIssue) {
-			const present = new Set((await tx.pullRequests.listByIssue(issueId)).map((link) => link.id));
-			for (const link of links) {
-				if (present.has(link.id) || (await tx.pullRequests.link(link)).id !== link.id) {
-					alreadyPresent += 1;
-					continue;
-				}
-				copied.pullRequests += 1;
-			}
-		}
-		await tx.meta.bumpRevision("board", require_manifest.currentUnixSeconds());
-	});
-	if (alreadyPresent > 0) warnings.push(`${alreadyPresent} rows were already present on the target board and were left as they are`);
-	return {
-		copied,
-		warnings
-	};
-}
-/**
-* Empty the slice off the board it was read from, in a transaction of its own.
-*
-* Only the cards, the columns and the milestones are named: comments, runs,
-* links, pull request links and the field-change history hang off a card by a
-* foreign key that cascades on both engines, so deleting the card takes them
-* with it.
-*/
-async function deleteBoardSlice(from, slice) {
-	await from.transaction(async (tx) => {
-		for (const issue of slice.issues) await tx.issues.delete(issue.id);
-		for (const milestone of slice.milestones) await tx.milestones.delete(milestone.id);
-		for (const status of slice.statuses) await tx.statuses.delete(status.id);
-		await tx.meta.bumpRevision("board", require_manifest.currentUnixSeconds());
-	});
-}
-/**
-* What a copy would collide with on the target, said before a row is written.
-*
-* The board carries two uniqueness rules that a *second* board of the same
-* workspace can break: a column's name within its workspace, and a card's
-* number within it. In practice it is the columns that collide: a standard set
-* created a second time carries the same names under new ids, while a card's id
-* is its key (`BST-001`), so two generations of card *number* 1 are two rows
-* with one id — which the copy treats as already present rather than as a
-* clash. The number check covers the case where they are not: a workspace whose
-* identifier changed between the two generations numbers from 1 again under
-* different ids.
-*
-* A row the target already has *by id* is not a collision — it is the
-* idempotent half of the copy, which is why the holder's id is compared rather
-* than merely counted. Milestones need no check: neither engine makes their
-* titles unique.
-*/
-async function assertTheCopyFits(tx, slice, workspaceId) {
-	const conflicts = [];
-	const numbers = new Map((await tx.issues.listByWorkspace(workspaceId)).map((issue) => [issue.number, issue.id]));
-	for (const issue of slice.issues) {
-		const holder = numbers.get(issue.number);
-		if (holder !== void 0 && holder !== issue.id) conflicts.push({
-			kind: "card",
-			value: issue.number,
-			heldBy: holder
-		});
-	}
-	const names = new Map((await tx.statuses.listByWorkspace(workspaceId)).map((status) => [status.name, status.id]));
-	for (const status of slice.statuses) {
-		const holder = names.get(status.name);
-		if (holder !== void 0 && holder !== status.id) conflicts.push({
-			kind: "column",
-			value: status.name,
-			heldBy: holder
-		});
-	}
-	if (conflicts.length > 0) throw new require_migrations_path.BoardError("board_copy_conflict", {
-		workspaceId,
-		conflicts
-	});
-}
-/**
-* The same cards, ordered so that a parent is always written before its
-* children. The column is a foreign key onto the same table, so any other order
-* writes a card pointing at one that is not there yet.
-*/
-function orderParentsFirst(issues) {
-	const byId = new Map(issues.map((issue) => [issue.id, issue]));
-	const ordered = [];
-	const placed = /* @__PURE__ */ new Set();
-	function place(issue, ancestors) {
-		if (placed.has(issue.id) || ancestors.has(issue.id)) return;
-		ancestors.add(issue.id);
-		const parent = issue.parentIssueId === null ? void 0 : byId.get(issue.parentIssueId);
-		if (parent) place(parent, ancestors);
-		placed.add(issue.id);
-		ordered.push(issue);
-	}
-	for (const issue of issues) place(issue, /* @__PURE__ */ new Set());
-	return ordered;
-}
-//#endregion
 exports.BINDING_FILE_PATH = require_manifest.BINDING_FILE_PATH;
 exports.BOARD_ACTOR = require_manifest.BOARD_ACTOR;
 exports.BOARD_ERROR_RESPONSES = require_manifest.BOARD_ERROR_RESPONSES;
@@ -274,9 +22,7 @@ exports.cardDisplayTitle = require_manifest.cardDisplayTitle;
 exports.commentAuthorReference = require_manifest.commentAuthorReference;
 exports.createBoardOps = require_manifest.createBoardOps;
 exports.currentUnixSeconds = require_manifest.currentUnixSeconds;
-exports.deleteBoardSlice = deleteBoardSlice;
 exports.diffFieldChanges = require_manifest.diffFieldChanges;
-exports.emptyCopyCounts = emptyCopyCounts;
 exports.evaluateEntryRules = require_manifest.evaluateEntryRules;
 exports.formatActivityIssueReference = require_manifest.formatActivityIssueReference;
 exports.formatExternalSessionRef = require_manifest.formatExternalSessionRef;
@@ -296,7 +42,6 @@ exports.parseActivityStringArray = require_manifest.parseActivityStringArray;
 exports.parseExternalSessionRef = require_manifest.parseExternalSessionRef;
 exports.pullRequestFactKeys = require_manifest.pullRequestFactKeys;
 exports.readBinding = require_manifest.readBinding;
-exports.readBoardSlice = readBoardSlice;
 exports.readChangeSeq = require_manifest.readChangeSeq;
 exports.readChecklist = require_manifest.readChecklist;
 exports.readEntryRules = require_manifest.readEntryRules;
@@ -308,6 +53,3 @@ exports.runBoardWrite = require_manifest.runBoardWrite;
 exports.serializeEntryRules = require_manifest.serializeEntryRules;
 exports.toIssueView = require_manifest.toIssueView;
 exports.writeBinding = require_manifest.writeBinding;
-exports.writeBoardSlice = writeBoardSlice;
-
-//# sourceMappingURL=index.cjs.map

package/dist/lib/index.d.cts

@@ -383,20 +383,8 @@ export declare function maskDatabaseUrls(text: string): string;
  * this list: what each code is over HTTP is `BOARD_ERROR_RESPONSES`
  * (`../serve/board-error-responses.ts`), the one table `kanbo serve` and any app
  * serving the board over HTTP answer with.
- *
- * Five of them are about where a board lives rather than about what is on it,
- * and they are named here for the same reason as the rest: a host that keeps
- * one board in a file and another in a database still answers its callers in
- * one vocabulary. `board_storage_not_prepared` is a connection string pointing
- * at a database that holds no board this build can speak for,
- * `board_storage_unavailable` is one the host could not reach at all,
- * `board_storage_not_configured` is a workspace that names no board to look at,
- * `board_storage_not_empty` is a board still holding cards when something asked
- * to point the workspace somewhere else, and `board_mixed_workspaces` is a
- * single operation naming cards that turned out to live in two different
- * boards — which no transaction can commit as one.
  */
-type BoardErrorCode = 'board_approval_requires_user' | 'board_column_rules_requires_user' | 'board_column_rules_unmet' | 'board_copy_conflict' | 'board_entry_rule_invalid' | 'board_execution_mode_locked' | 'board_mixed_workspaces' | 'board_pull_request_invalid' | 'board_pull_request_not_found' | 'board_pull_request_not_yours' | 'board_return_no_previous_column' | 'board_return_requires_user' | 'board_run_already_finished' | 'board_run_not_found' | 'board_run_session_ref_conflict' | 'board_run_session_ref_invalid' | 'board_run_session_ref_requires_user' | 'board_schema_outdated' | 'board_sprint_carry_invalid' | 'board_sprint_close_requires_user' | 'board_sprint_dates_invalid' | 'board_storage_not_configured' | 'board_storage_not_empty' | 'board_storage_not_prepared' | 'board_storage_unavailable' | 'issue_comment_delete_requires_user' | 'issue_comment_not_found' | 'issue_context_ref_invalid_index' | 'issue_milestone_not_found' | 'issue_not_found' | 'issue_parent_not_found' | 'issue_parent_self_reference' | 'issue_relation_not_found' | 'issue_relation_self_reference' | 'issue_status_name_empty' | 'issue_status_not_found' | 'issue_status_reference_conflict' | 'issue_workspace_not_found';
+type BoardErrorCode = 'board_approval_requires_user' | 'board_column_rules_requires_user' | 'board_column_rules_unmet' | 'board_entry_rule_invalid' | 'board_execution_mode_locked' | 'board_pull_request_invalid' | 'board_pull_request_not_found' | 'board_pull_request_not_yours' | 'board_return_no_previous_column' | 'board_return_requires_user' | 'board_run_already_finished' | 'board_run_not_found' | 'board_run_session_ref_conflict' | 'board_run_session_ref_invalid' | 'board_run_session_ref_requires_user' | 'board_schema_outdated' | 'board_sprint_carry_invalid' | 'board_sprint_close_requires_user' | 'board_sprint_dates_invalid' | 'issue_comment_delete_requires_user' | 'issue_comment_not_found' | 'issue_context_ref_invalid_index' | 'issue_milestone_not_found' | 'issue_not_found' | 'issue_parent_not_found' | 'issue_parent_self_reference' | 'issue_relation_not_found' | 'issue_relation_self_reference' | 'issue_status_name_empty' | 'issue_status_not_found' | 'issue_status_reference_conflict' | 'issue_workspace_not_found';
 /** A board rule the caller broke, carrying the offending values in `details`. */
 export declare class BoardError extends Error {
   readonly code: BoardErrorCode;
@@ -1174,6 +1162,19 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     card: Issue;
     stoppedRunIds: string[];
   }>;
+  assertReturnable: (issueId: string, input: {
+    toStatusName?: string | null;
+  }, actor: BoardActor) => Promise<{
+    category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
+    color: string | null;
+    createdAt: number;
+    description: string | null;
+    entryRules: string | null;
+    id: string;
+    name: string;
+    order: number;
+    workspaceId: string;
+  }>;
   readApproval: (issueId: string) => Promise<BoardApproval>;
   linkPullRequest: (issueId: string, urlOrRef: string, actor: BoardActor, scope?: BoardWriteScope<TStore>) => Promise<{
     createdAt: number;
@@ -1490,72 +1491,6 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
 /** The board's operations, as a type callers can name. */
 type BoardOps = ReturnType<typeof createBoardOps<BoardStore>>;
 //#endregion
-//#region src/ops/board-copy.d.ts
-/** How many rows of each kind a copy wrote into the target board. */
-interface BoardCopyCounts {
-  statuses: number;
-  milestones: number;
-  issues: number;
-  comments: number;
-  runs: number;
-  relations: number;
-  fieldChanges: number;
-  /** Cards that carried refs, not rows: context refs are a column on the card. */
-  contextRefs: number;
-  pullRequests: number;
-}
-/** Everything one workspace has on a board, read before anything is written. */
-interface BoardSlice {
-  statuses: IssueStatus[];
-  milestones: IssueMilestone[];
-  /** In an order where a card's parent always comes before it. */
-  issues: Issue[];
-  comments: IssueComment[];
-  runs: IssueRun[];
-  relations: IssueRelation[];
-  fieldChanges: IssueFieldChange[];
-  pullRequests: IssuePullRequest[];
-  /** What reading it had to leave behind, said to a person. */
-  warnings: string[];
-}
-/** Nothing copied — what a move that had nothing to move reports. */
-export declare function emptyCopyCounts(): BoardCopyCounts;
-/**
- * Everything the workspace has on this board, read in one pass before a single
- * row is written anywhere.
- *
- * Links are collected by id because an edge is listed by both of the cards it
- * touches, and one reaching a card outside this workspace is left behind rather
- * than copied: the target holds this workspace's board and nothing else, so the
- * far end of that edge is not there to point at.
- */
-export declare function readBoardSlice(from: BoardStore, workspaceId: string): Promise<BoardSlice>;
-/**
- * Write a slice into the target board, in one transaction, and say what was
- * written and what a person should know about it — the slice's own warnings
- * first.
- *
- * It is idempotent by id. A row the target already has is left exactly as it
- * is and counted as already present, so a copy interrupted half-way is finished
- * by running it again, and a second run of a finished one copies nothing. A
- * clash that is not the same row — a column name or a card number the target
- * holds under another id — refuses the whole copy before its first insert
- * (`board_copy_conflict`, ruling 3-55).
- */
-export declare function writeBoardSlice(to: BoardStore, slice: BoardSlice, workspaceId: string): Promise<{
-  copied: BoardCopyCounts;
-  warnings: string[];
-}>;
-/**
- * Empty the slice off the board it was read from, in a transaction of its own.
- *
- * Only the cards, the columns and the milestones are named: comments, runs,
- * links, pull request links and the field-change history hang off a card by a
- * foreign key that cascades on both engines, so deleting the card takes them
- * with it.
- */
-export declare function deleteBoardSlice(from: BoardStore, slice: BoardSlice): Promise<void>;
-//#endregion
 //#region src/serve/board-error-responses.d.ts
 /** What one board failure is over HTTP: the status, the sentence, and the code a client matches on when it is renamed. */
 interface BoardErrorResponse {
@@ -1582,21 +1517,6 @@ interface BoardErrorResponse {
  * reason turned around: the answer will be yes once the card meets them, and
  * `details.unmet` says what is missing.
  *
- * The five failures about where a board is kept read the same rule. A database
- * that holds no board this build can speak for is 409 — the setting is there,
- * the board behind it is not yet, and `board-storage prepare` is what settles
- * that — and one nobody could reach at all is 503, because nothing about the
- * request was wrong. A workspace naming no board at all is 404: the caller
- * asked about a setting that is not there. A board still holding cards when
- * somebody asks to point the workspace elsewhere is 409, because the answer
- * would have been yes on an empty board and `board-storage migrate` is what
- * makes it one. An operation naming cards from two different boards is 400: no
- * transaction reaches both, so the caller asked for something that cannot be
- * done. A copy that would land on a card number or a column name the target
- * already holds under a different id is 409 for the same reason the others
- * are: the answer would have been yes on a target that did not hold that
- * board, and `details.conflicts` names every value that clashed.
- *
  * A failure may also be renamed here: the package names its codes after the
  * board, while every error the `/issues` routes answer with is named after the
  * issue, and a client matching on `issue_*` should not have to learn a second
@@ -1604,5 +1524,5 @@ interface BoardErrorResponse {
  */
 export declare const BOARD_ERROR_RESPONSES: Record<BoardErrorCode, BoardErrorResponse>;
 //#endregion
-export { type AddCommentInput, type AttachRunExecutionInput, type BoardActiveRun, type BoardActor, type BoardApproval, type BoardCardWrite, type BoardColumnInput, type BoardColumnPatch, type BoardCopyCounts, type BoardErrorCode, type BoardErrorResponse, type BoardLinkedPullRequest, type BoardOps, type BoardPullRequestStanding, type BoardRunProjection, type BoardRunProjectionScope, type BoardRunView, type BoardSlice, type BoardSprint, type BoardStore, type BoardTransactionMode, type BoardWorkspaceIdentity, type BoardWriteScope, type BulkUpdateCardsInput, type BulkUpdateCardsResult, type CloseSprintResult, type CreateCardInput, type CreateCommentOnceInput, type CreateMilestoneInput, type CreateRelationInput, ENTRY_RULES, ENTRY_RULE_DESCRIPTIONS, type EntryRule, type EntryRuleFacts, type ExternalSessionRef, type FinishRunInput, type Issue, type IssueActivityAction, type IssueActivityCommentView, type IssueActivityField, type IssueActivityFieldChangeView, type IssueActivityItemView, type IssueActivityLookup, type IssueActivityResolver, type IssueActivityValueToken, type IssueActivityValueView, type IssueActorKind, type IssueActorReference, type IssueComment, type IssueCommentAuthorView, type IssueCommentStore, type IssueContextRefStore, type IssueFieldChange, type IssueFieldChangeStore, type IssueMilestone, type IssueMilestoneStore, type IssueMutationActor, type IssuePullRequest, type IssuePullRequestStore, type IssueRelation, type IssueRelationCounterpart, type IssueRelationStore, type IssueRelationView, type IssueRowStore, type IssueRun, type IssueRunStore, type IssueStatus, type IssueStatusStore, type IssueView, KANBO_TOOL_CLI_EQUIVALENTS, KANBO_TOOL_NAMES, type KanbanMeta, type KanbanMetaStore, type KanboBinding, type KanboCapabilities, type KanboCapabilitiesPackage, type KanboCapabilitiesRoles, type KanboCapabilityCommand, type KanboCapabilityCommandArgument, type KanboCapabilityCommandOption, type KanboCapabilityEntryRule, type KanboCapabilityStorage, type KanboCapabilityTool, type KanboToolCliEquivalent, type KanboToolName, type MigrateCardsInput, type MigrateCardsResult, type PullRequestFactKeys, type StartRunInput, UNMET_ENTRY_RULE_REASONS, type UnmetEntryRule, type UpdateCardInput, type UpdateMilestoneInput, evaluateEntryRules, readChecklist, readEntryRules, serializeEntryRules };
+export { type AddCommentInput, type AttachRunExecutionInput, type BoardActiveRun, type BoardActor, type BoardApproval, type BoardCardWrite, type BoardColumnInput, type BoardColumnPatch, type BoardErrorCode, type BoardErrorResponse, type BoardLinkedPullRequest, type BoardOps, type BoardPullRequestStanding, type BoardRunProjection, type BoardRunProjectionScope, type BoardRunView, type BoardSprint, type BoardStore, type BoardTransactionMode, type BoardWorkspaceIdentity, type BoardWriteScope, type BulkUpdateCardsInput, type BulkUpdateCardsResult, type CloseSprintResult, type CreateCardInput, type CreateCommentOnceInput, type CreateMilestoneInput, type CreateRelationInput, ENTRY_RULES, ENTRY_RULE_DESCRIPTIONS, type EntryRule, type EntryRuleFacts, type ExternalSessionRef, type FinishRunInput, type Issue, type IssueActivityAction, type IssueActivityCommentView, type IssueActivityField, type IssueActivityFieldChangeView, type IssueActivityItemView, type IssueActivityLookup, type IssueActivityResolver, type IssueActivityValueToken, type IssueActivityValueView, type IssueActorKind, type IssueActorReference, type IssueComment, type IssueCommentAuthorView, type IssueCommentStore, type IssueContextRefStore, type IssueFieldChange, type IssueFieldChangeStore, type IssueMilestone, type IssueMilestoneStore, type IssueMutationActor, type IssuePullRequest, type IssuePullRequestStore, type IssueRelation, type IssueRelationCounterpart, type IssueRelationStore, type IssueRelationView, type IssueRowStore, type IssueRun, type IssueRunStore, type IssueStatus, type IssueStatusStore, type IssueView, KANBO_TOOL_CLI_EQUIVALENTS, KANBO_TOOL_NAMES, type KanbanMeta, type KanbanMetaStore, type KanboBinding, type KanboCapabilities, type KanboCapabilitiesPackage, type KanboCapabilitiesRoles, type KanboCapabilityCommand, type KanboCapabilityCommandArgument, type KanboCapabilityCommandOption, type KanboCapabilityEntryRule, type KanboCapabilityStorage, type KanboCapabilityTool, type KanboToolCliEquivalent, type KanboToolName, type MigrateCardsInput, type MigrateCardsResult, type PullRequestFactKeys, type StartRunInput, UNMET_ENTRY_RULE_REASONS, type UnmetEntryRule, type UpdateCardInput, type UpdateMilestoneInput, evaluateEntryRules, readChecklist, readEntryRules, serializeEntryRules };
 //# sourceMappingURL=index.d.cts.map

package/dist/lib/index.d.mts

@@ -383,20 +383,8 @@ export declare function maskDatabaseUrls(text: string): string;
  * this list: what each code is over HTTP is `BOARD_ERROR_RESPONSES`
  * (`../serve/board-error-responses.ts`), the one table `kanbo serve` and any app
  * serving the board over HTTP answer with.
- *
- * Five of them are about where a board lives rather than about what is on it,
- * and they are named here for the same reason as the rest: a host that keeps
- * one board in a file and another in a database still answers its callers in
- * one vocabulary. `board_storage_not_prepared` is a connection string pointing
- * at a database that holds no board this build can speak for,
- * `board_storage_unavailable` is one the host could not reach at all,
- * `board_storage_not_configured` is a workspace that names no board to look at,
- * `board_storage_not_empty` is a board still holding cards when something asked
- * to point the workspace somewhere else, and `board_mixed_workspaces` is a
- * single operation naming cards that turned out to live in two different
- * boards — which no transaction can commit as one.
  */
-type BoardErrorCode = 'board_approval_requires_user' | 'board_column_rules_requires_user' | 'board_column_rules_unmet' | 'board_copy_conflict' | 'board_entry_rule_invalid' | 'board_execution_mode_locked' | 'board_mixed_workspaces' | 'board_pull_request_invalid' | 'board_pull_request_not_found' | 'board_pull_request_not_yours' | 'board_return_no_previous_column' | 'board_return_requires_user' | 'board_run_already_finished' | 'board_run_not_found' | 'board_run_session_ref_conflict' | 'board_run_session_ref_invalid' | 'board_run_session_ref_requires_user' | 'board_schema_outdated' | 'board_sprint_carry_invalid' | 'board_sprint_close_requires_user' | 'board_sprint_dates_invalid' | 'board_storage_not_configured' | 'board_storage_not_empty' | 'board_storage_not_prepared' | 'board_storage_unavailable' | 'issue_comment_delete_requires_user' | 'issue_comment_not_found' | 'issue_context_ref_invalid_index' | 'issue_milestone_not_found' | 'issue_not_found' | 'issue_parent_not_found' | 'issue_parent_self_reference' | 'issue_relation_not_found' | 'issue_relation_self_reference' | 'issue_status_name_empty' | 'issue_status_not_found' | 'issue_status_reference_conflict' | 'issue_workspace_not_found';
+type BoardErrorCode = 'board_approval_requires_user' | 'board_column_rules_requires_user' | 'board_column_rules_unmet' | 'board_entry_rule_invalid' | 'board_execution_mode_locked' | 'board_pull_request_invalid' | 'board_pull_request_not_found' | 'board_pull_request_not_yours' | 'board_return_no_previous_column' | 'board_return_requires_user' | 'board_run_already_finished' | 'board_run_not_found' | 'board_run_session_ref_conflict' | 'board_run_session_ref_invalid' | 'board_run_session_ref_requires_user' | 'board_schema_outdated' | 'board_sprint_carry_invalid' | 'board_sprint_close_requires_user' | 'board_sprint_dates_invalid' | 'issue_comment_delete_requires_user' | 'issue_comment_not_found' | 'issue_context_ref_invalid_index' | 'issue_milestone_not_found' | 'issue_not_found' | 'issue_parent_not_found' | 'issue_parent_self_reference' | 'issue_relation_not_found' | 'issue_relation_self_reference' | 'issue_status_name_empty' | 'issue_status_not_found' | 'issue_status_reference_conflict' | 'issue_workspace_not_found';
 /** A board rule the caller broke, carrying the offending values in `details`. */
 export declare class BoardError extends Error {
   readonly code: BoardErrorCode;
@@ -1174,6 +1162,19 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     card: Issue;
     stoppedRunIds: string[];
   }>;
+  assertReturnable: (issueId: string, input: {
+    toStatusName?: string | null;
+  }, actor: BoardActor) => Promise<{
+    category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
+    color: string | null;
+    createdAt: number;
+    description: string | null;
+    entryRules: string | null;
+    id: string;
+    name: string;
+    order: number;
+    workspaceId: string;
+  }>;
   readApproval: (issueId: string) => Promise<BoardApproval>;
   linkPullRequest: (issueId: string, urlOrRef: string, actor: BoardActor, scope?: BoardWriteScope<TStore>) => Promise<{
     createdAt: number;
@@ -1490,72 +1491,6 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
 /** The board's operations, as a type callers can name. */
 type BoardOps = ReturnType<typeof createBoardOps<BoardStore>>;
 //#endregion
-//#region src/ops/board-copy.d.ts
-/** How many rows of each kind a copy wrote into the target board. */
-interface BoardCopyCounts {
-  statuses: number;
-  milestones: number;
-  issues: number;
-  comments: number;
-  runs: number;
-  relations: number;
-  fieldChanges: number;
-  /** Cards that carried refs, not rows: context refs are a column on the card. */
-  contextRefs: number;
-  pullRequests: number;
-}
-/** Everything one workspace has on a board, read before anything is written. */
-interface BoardSlice {
-  statuses: IssueStatus[];
-  milestones: IssueMilestone[];
-  /** In an order where a card's parent always comes before it. */
-  issues: Issue[];
-  comments: IssueComment[];
-  runs: IssueRun[];
-  relations: IssueRelation[];
-  fieldChanges: IssueFieldChange[];
-  pullRequests: IssuePullRequest[];
-  /** What reading it had to leave behind, said to a person. */
-  warnings: string[];
-}
-/** Nothing copied — what a move that had nothing to move reports. */
-export declare function emptyCopyCounts(): BoardCopyCounts;
-/**
- * Everything the workspace has on this board, read in one pass before a single
- * row is written anywhere.
- *
- * Links are collected by id because an edge is listed by both of the cards it
- * touches, and one reaching a card outside this workspace is left behind rather
- * than copied: the target holds this workspace's board and nothing else, so the
- * far end of that edge is not there to point at.
- */
-export declare function readBoardSlice(from: BoardStore, workspaceId: string): Promise<BoardSlice>;
-/**
- * Write a slice into the target board, in one transaction, and say what was
- * written and what a person should know about it — the slice's own warnings
- * first.
- *
- * It is idempotent by id. A row the target already has is left exactly as it
- * is and counted as already present, so a copy interrupted half-way is finished
- * by running it again, and a second run of a finished one copies nothing. A
- * clash that is not the same row — a column name or a card number the target
- * holds under another id — refuses the whole copy before its first insert
- * (`board_copy_conflict`, ruling 3-55).
- */
-export declare function writeBoardSlice(to: BoardStore, slice: BoardSlice, workspaceId: string): Promise<{
-  copied: BoardCopyCounts;
-  warnings: string[];
-}>;
-/**
- * Empty the slice off the board it was read from, in a transaction of its own.
- *
- * Only the cards, the columns and the milestones are named: comments, runs,
- * links, pull request links and the field-change history hang off a card by a
- * foreign key that cascades on both engines, so deleting the card takes them
- * with it.
- */
-export declare function deleteBoardSlice(from: BoardStore, slice: BoardSlice): Promise<void>;
-//#endregion
 //#region src/serve/board-error-responses.d.ts
 /** What one board failure is over HTTP: the status, the sentence, and the code a client matches on when it is renamed. */
 interface BoardErrorResponse {
@@ -1582,21 +1517,6 @@ interface BoardErrorResponse {
  * reason turned around: the answer will be yes once the card meets them, and
  * `details.unmet` says what is missing.
  *
- * The five failures about where a board is kept read the same rule. A database
- * that holds no board this build can speak for is 409 — the setting is there,
- * the board behind it is not yet, and `board-storage prepare` is what settles
- * that — and one nobody could reach at all is 503, because nothing about the
- * request was wrong. A workspace naming no board at all is 404: the caller
- * asked about a setting that is not there. A board still holding cards when
- * somebody asks to point the workspace elsewhere is 409, because the answer
- * would have been yes on an empty board and `board-storage migrate` is what
- * makes it one. An operation naming cards from two different boards is 400: no
- * transaction reaches both, so the caller asked for something that cannot be
- * done. A copy that would land on a card number or a column name the target
- * already holds under a different id is 409 for the same reason the others
- * are: the answer would have been yes on a target that did not hold that
- * board, and `details.conflicts` names every value that clashed.
- *
  * A failure may also be renamed here: the package names its codes after the
  * board, while every error the `/issues` routes answer with is named after the
  * issue, and a client matching on `issue_*` should not have to learn a second
@@ -1604,5 +1524,5 @@ interface BoardErrorResponse {
  */
 export declare const BOARD_ERROR_RESPONSES: Record<BoardErrorCode, BoardErrorResponse>;
 //#endregion
-export { type AddCommentInput, type AttachRunExecutionInput, type BoardActiveRun, type BoardActor, type BoardApproval, type BoardCardWrite, type BoardColumnInput, type BoardColumnPatch, type BoardCopyCounts, type BoardErrorCode, type BoardErrorResponse, type BoardLinkedPullRequest, type BoardOps, type BoardPullRequestStanding, type BoardRunProjection, type BoardRunProjectionScope, type BoardRunView, type BoardSlice, type BoardSprint, type BoardStore, type BoardTransactionMode, type BoardWorkspaceIdentity, type BoardWriteScope, type BulkUpdateCardsInput, type BulkUpdateCardsResult, type CloseSprintResult, type CreateCardInput, type CreateCommentOnceInput, type CreateMilestoneInput, type CreateRelationInput, ENTRY_RULES, ENTRY_RULE_DESCRIPTIONS, type EntryRule, type EntryRuleFacts, type ExternalSessionRef, type FinishRunInput, type Issue, type IssueActivityAction, type IssueActivityCommentView, type IssueActivityField, type IssueActivityFieldChangeView, type IssueActivityItemView, type IssueActivityLookup, type IssueActivityResolver, type IssueActivityValueToken, type IssueActivityValueView, type IssueActorKind, type IssueActorReference, type IssueComment, type IssueCommentAuthorView, type IssueCommentStore, type IssueContextRefStore, type IssueFieldChange, type IssueFieldChangeStore, type IssueMilestone, type IssueMilestoneStore, type IssueMutationActor, type IssuePullRequest, type IssuePullRequestStore, type IssueRelation, type IssueRelationCounterpart, type IssueRelationStore, type IssueRelationView, type IssueRowStore, type IssueRun, type IssueRunStore, type IssueStatus, type IssueStatusStore, type IssueView, KANBO_TOOL_CLI_EQUIVALENTS, KANBO_TOOL_NAMES, type KanbanMeta, type KanbanMetaStore, type KanboBinding, type KanboCapabilities, type KanboCapabilitiesPackage, type KanboCapabilitiesRoles, type KanboCapabilityCommand, type KanboCapabilityCommandArgument, type KanboCapabilityCommandOption, type KanboCapabilityEntryRule, type KanboCapabilityStorage, type KanboCapabilityTool, type KanboToolCliEquivalent, type KanboToolName, type MigrateCardsInput, type MigrateCardsResult, type PullRequestFactKeys, type StartRunInput, UNMET_ENTRY_RULE_REASONS, type UnmetEntryRule, type UpdateCardInput, type UpdateMilestoneInput, evaluateEntryRules, readChecklist, readEntryRules, serializeEntryRules };
+export { type AddCommentInput, type AttachRunExecutionInput, type BoardActiveRun, type BoardActor, type BoardApproval, type BoardCardWrite, type BoardColumnInput, type BoardColumnPatch, type BoardErrorCode, type BoardErrorResponse, type BoardLinkedPullRequest, type BoardOps, type BoardPullRequestStanding, type BoardRunProjection, type BoardRunProjectionScope, type BoardRunView, type BoardSprint, type BoardStore, type BoardTransactionMode, type BoardWorkspaceIdentity, type BoardWriteScope, type BulkUpdateCardsInput, type BulkUpdateCardsResult, type CloseSprintResult, type CreateCardInput, type CreateCommentOnceInput, type CreateMilestoneInput, type CreateRelationInput, ENTRY_RULES, ENTRY_RULE_DESCRIPTIONS, type EntryRule, type EntryRuleFacts, type ExternalSessionRef, type FinishRunInput, type Issue, type IssueActivityAction, type IssueActivityCommentView, type IssueActivityField, type IssueActivityFieldChangeView, type IssueActivityItemView, type IssueActivityLookup, type IssueActivityResolver, type IssueActivityValueToken, type IssueActivityValueView, type IssueActorKind, type IssueActorReference, type IssueComment, type IssueCommentAuthorView, type IssueCommentStore, type IssueContextRefStore, type IssueFieldChange, type IssueFieldChangeStore, type IssueMilestone, type IssueMilestoneStore, type IssueMutationActor, type IssuePullRequest, type IssuePullRequestStore, type IssueRelation, type IssueRelationCounterpart, type IssueRelationStore, type IssueRelationView, type IssueRowStore, type IssueRun, type IssueRunStore, type IssueStatus, type IssueStatusStore, type IssueView, KANBO_TOOL_CLI_EQUIVALENTS, KANBO_TOOL_NAMES, type KanbanMeta, type KanbanMetaStore, type KanboBinding, type KanboCapabilities, type KanboCapabilitiesPackage, type KanboCapabilitiesRoles, type KanboCapabilityCommand, type KanboCapabilityCommandArgument, type KanboCapabilityCommandOption, type KanboCapabilityEntryRule, type KanboCapabilityStorage, type KanboCapabilityTool, type KanboToolCliEquivalent, type KanboToolName, type MigrateCardsInput, type MigrateCardsResult, type PullRequestFactKeys, type StartRunInput, UNMET_ENTRY_RULE_REASONS, type UnmetEntryRule, type UpdateCardInput, type UpdateMilestoneInput, evaluateEntryRules, readChecklist, readEntryRules, serializeEntryRules };
 //# sourceMappingURL=index.d.mts.map