kanbo-cli 0.3.0 → 0.5.0

package/dist/drizzle-sqlite/meta/_journal.json

@@ -36,6 +36,13 @@
       "when": 1790266700022,
       "tag": "0004_run_external_session_ref",
       "breakpoints": true
+    },
+    {
+      "idx": 5,
+      "version": "6",
+      "when": 1793915081450,
+      "tag": "0005_flow_rules_and_column_entries",
+      "breakpoints": true
     }
   ]
 }

package/dist/lib/{approval-BsBk2xVr.d.cts → approval-CnJJfwfi.d.mts}

@@ -1,4 +1,27 @@
-import { c as IssueStatus, n as IssueComment, r as IssueFieldChange, t as Issue } from "./schema-D0MyXcej.cjs";
+import { c as IssueStatus, n as IssueComment, r as IssueFieldChange, t as Issue } from "./schema-Cwx3HosC.mjs";
+//#region src/domain/flow-rules.d.ts
+/**
+ * Where a card may come from before it enters a column, and how many cards the
+ * column holds (board-workflow spec, Part 2). Checked at the same door as the
+ * entry rules, `enforceColumnEntry`, for every writer.
+ *
+ * - `allowedFrom` — the ids of the columns a card may enter this one from;
+ *   `null` for any column. `[]` lets no card in from another column, so only a
+ *   person puts one there — it is also what a list becomes when its last column
+ *   is deleted, so a guarded column never opens by accident.
+ * - `wipLimit` — the most cards the column holds, 1 or more; `null` for no
+ *   limit. The card entering is not counted.
+ */
+interface ColumnFlowRules {
+  allowedFrom: string[] | null;
+  wipLimit: number | null;
+}
+/** The two flow rules, as an unmet entry names them. */
+declare const FLOW_RULES: readonly ['allowed_from', 'wip_limit'];
+type FlowRule = typeof FLOW_RULES[number];
+/** A column's flow rules, out of what the row stores. */
+declare function readFlowRules(column: Pick<IssueStatus, 'allowedFrom' | 'wipLimit'>): ColumnFlowRules;
+//#endregion
 //#region src/domain/entry-rules.d.ts
 /**
  * What a column may ask of a card before an agent puts the card in it (ruling
@@ -14,15 +37,16 @@ import { c as IssueStatus, n as IssueComment, r as IssueFieldChange, t as Issue
 declare const ENTRY_RULES: readonly ['checklist_complete', 'pull_request_linked', 'ci_green', 'approved'];
 type EntryRule = typeof ENTRY_RULES[number];
 /** Why a rule is unmet, as a key a translated surface can name in its own words. */
-declare const UNMET_ENTRY_RULE_REASONS: readonly ['no_checklist', 'unchecked', 'no_pull_request', 'no_ci', 'ci_red', 'approval_pending', 'returned', 'not_approved'];
+declare const UNMET_ENTRY_RULE_REASONS: readonly ['no_checklist', 'unchecked', 'no_pull_request', 'no_ci', 'ci_red', 'approval_pending', 'returned', 'not_approved', 'not_allowed_from', 'column_full'];
 type UnmetEntryRuleReason = typeof UNMET_ENTRY_RULE_REASONS[number];
 /**
  * One rule a card does not meet yet: `detail` says what is missing in English
  * words the command line and MCP print; `reason` (with `checked` and `total`
- * for `unchecked`) says the same for a surface that translates it.
+ * for `unchecked`) says the same for a surface that translates it. `rule` is an
+ * entry rule, or a flow rule (`allowed_from`, `wip_limit`) the same door checks.
  */
 interface UnmetEntryRule {
-  rule: EntryRule;
+  rule: EntryRule | FlowRule;
   reason: UnmetEntryRuleReason;
   detail: string;
   checked?: number;
@@ -91,7 +115,7 @@ declare const ENTRY_RULE_DESCRIPTIONS: Record<EntryRule, string>;
  * Nothing here executes anything. These are names and the commands that mean
  * the same thing, for a prompt and for documentation.
  */
-declare const KANBO_TOOL_NAMES: readonly ['kanbo_prime', 'kanbo_ready', 'kanbo_columns', 'kanbo_sprints', 'kanbo_card_get', 'kanbo_card_list', 'kanbo_card_create', 'kanbo_card_update', 'kanbo_card_move', 'kanbo_card_comment', 'kanbo_card_link_pr', 'kanbo_card_pull_requests', 'kanbo_status_line', 'kanbo_wait_approval', 'kanbo_run_start', 'kanbo_run_finish'];
+declare const KANBO_TOOL_NAMES: readonly ['kanbo_prime', 'kanbo_ready', 'kanbo_card_claim', 'kanbo_columns', 'kanbo_sprints', 'kanbo_card_get', 'kanbo_card_list', 'kanbo_card_create', 'kanbo_card_update', 'kanbo_card_move', 'kanbo_card_comment', 'kanbo_card_link_pr', 'kanbo_card_pull_requests', 'kanbo_status_line', 'kanbo_wait_approval', 'kanbo_run_start', 'kanbo_run_finish'];
 /** One of the board's tools. */
 type KanboToolName = typeof KANBO_TOOL_NAMES[number];
 /** The command line that does what a tool does. */
@@ -178,4 +202,4 @@ interface CardAttention {
   lastComment: CardLastComment | null;
 }
 //#endregion
-export { readEntryRules as C, readChecklist as S, EntryRule as _, IssueActorReference as a, UnmetEntryRule as b, isOutsideWriter as c, KANBO_TOOL_CLI_EQUIVALENTS as d, KANBO_TOOL_NAMES as f, ENTRY_RULE_DESCRIPTIONS as g, ENTRY_RULES as h, IssueActorKind as i, normalizeCommentAuthorKind as l, KanboToolName as m, CardAttention as n, IssueView as o, KanboToolCliEquivalent as p, CardLastComment as r, IssueWriterProvenance as s, BoardApproval as t, toIssueView as u, EntryRuleFacts as v, serializeEntryRules as w, evaluateEntryRules as x, UNMET_ENTRY_RULE_REASONS as y };
+export { readEntryRules as C, FlowRule as D, FLOW_RULES as E, readFlowRules as O, readChecklist as S, ColumnFlowRules as T, EntryRule as _, IssueActorReference as a, UnmetEntryRule as b, isOutsideWriter as c, KANBO_TOOL_CLI_EQUIVALENTS as d, KANBO_TOOL_NAMES as f, ENTRY_RULE_DESCRIPTIONS as g, ENTRY_RULES as h, IssueActorKind as i, normalizeCommentAuthorKind as l, KanboToolName as m, CardAttention as n, IssueView as o, KanboToolCliEquivalent as p, CardLastComment as r, IssueWriterProvenance as s, BoardApproval as t, toIssueView as u, EntryRuleFacts as v, serializeEntryRules as w, evaluateEntryRules as x, UNMET_ENTRY_RULE_REASONS as y };

package/dist/lib/{approval-LRZ6ontC.d.mts → approval-DNfUhYD5.d.cts}

@@ -1,4 +1,27 @@
-import { c as IssueStatus, n as IssueComment, r as IssueFieldChange, t as Issue } from "./schema-D0MyXcej.mjs";
+import { c as IssueStatus, n as IssueComment, r as IssueFieldChange, t as Issue } from "./schema-Cwx3HosC.cjs";
+//#region src/domain/flow-rules.d.ts
+/**
+ * Where a card may come from before it enters a column, and how many cards the
+ * column holds (board-workflow spec, Part 2). Checked at the same door as the
+ * entry rules, `enforceColumnEntry`, for every writer.
+ *
+ * - `allowedFrom` — the ids of the columns a card may enter this one from;
+ *   `null` for any column. `[]` lets no card in from another column, so only a
+ *   person puts one there — it is also what a list becomes when its last column
+ *   is deleted, so a guarded column never opens by accident.
+ * - `wipLimit` — the most cards the column holds, 1 or more; `null` for no
+ *   limit. The card entering is not counted.
+ */
+interface ColumnFlowRules {
+  allowedFrom: string[] | null;
+  wipLimit: number | null;
+}
+/** The two flow rules, as an unmet entry names them. */
+declare const FLOW_RULES: readonly ['allowed_from', 'wip_limit'];
+type FlowRule = typeof FLOW_RULES[number];
+/** A column's flow rules, out of what the row stores. */
+declare function readFlowRules(column: Pick<IssueStatus, 'allowedFrom' | 'wipLimit'>): ColumnFlowRules;
+//#endregion
 //#region src/domain/entry-rules.d.ts
 /**
  * What a column may ask of a card before an agent puts the card in it (ruling
@@ -14,15 +37,16 @@ import { c as IssueStatus, n as IssueComment, r as IssueFieldChange, t as Issue
 declare const ENTRY_RULES: readonly ['checklist_complete', 'pull_request_linked', 'ci_green', 'approved'];
 type EntryRule = typeof ENTRY_RULES[number];
 /** Why a rule is unmet, as a key a translated surface can name in its own words. */
-declare const UNMET_ENTRY_RULE_REASONS: readonly ['no_checklist', 'unchecked', 'no_pull_request', 'no_ci', 'ci_red', 'approval_pending', 'returned', 'not_approved'];
+declare const UNMET_ENTRY_RULE_REASONS: readonly ['no_checklist', 'unchecked', 'no_pull_request', 'no_ci', 'ci_red', 'approval_pending', 'returned', 'not_approved', 'not_allowed_from', 'column_full'];
 type UnmetEntryRuleReason = typeof UNMET_ENTRY_RULE_REASONS[number];
 /**
  * One rule a card does not meet yet: `detail` says what is missing in English
  * words the command line and MCP print; `reason` (with `checked` and `total`
- * for `unchecked`) says the same for a surface that translates it.
+ * for `unchecked`) says the same for a surface that translates it. `rule` is an
+ * entry rule, or a flow rule (`allowed_from`, `wip_limit`) the same door checks.
  */
 interface UnmetEntryRule {
-  rule: EntryRule;
+  rule: EntryRule | FlowRule;
   reason: UnmetEntryRuleReason;
   detail: string;
   checked?: number;
@@ -91,7 +115,7 @@ declare const ENTRY_RULE_DESCRIPTIONS: Record<EntryRule, string>;
  * Nothing here executes anything. These are names and the commands that mean
  * the same thing, for a prompt and for documentation.
  */
-declare const KANBO_TOOL_NAMES: readonly ['kanbo_prime', 'kanbo_ready', 'kanbo_columns', 'kanbo_sprints', 'kanbo_card_get', 'kanbo_card_list', 'kanbo_card_create', 'kanbo_card_update', 'kanbo_card_move', 'kanbo_card_comment', 'kanbo_card_link_pr', 'kanbo_card_pull_requests', 'kanbo_status_line', 'kanbo_wait_approval', 'kanbo_run_start', 'kanbo_run_finish'];
+declare const KANBO_TOOL_NAMES: readonly ['kanbo_prime', 'kanbo_ready', 'kanbo_card_claim', 'kanbo_columns', 'kanbo_sprints', 'kanbo_card_get', 'kanbo_card_list', 'kanbo_card_create', 'kanbo_card_update', 'kanbo_card_move', 'kanbo_card_comment', 'kanbo_card_link_pr', 'kanbo_card_pull_requests', 'kanbo_status_line', 'kanbo_wait_approval', 'kanbo_run_start', 'kanbo_run_finish'];
 /** One of the board's tools. */
 type KanboToolName = typeof KANBO_TOOL_NAMES[number];
 /** The command line that does what a tool does. */
@@ -178,4 +202,4 @@ interface CardAttention {
   lastComment: CardLastComment | null;
 }
 //#endregion
-export { readEntryRules as C, readChecklist as S, EntryRule as _, IssueActorReference as a, UnmetEntryRule as b, isOutsideWriter as c, KANBO_TOOL_CLI_EQUIVALENTS as d, KANBO_TOOL_NAMES as f, ENTRY_RULE_DESCRIPTIONS as g, ENTRY_RULES as h, IssueActorKind as i, normalizeCommentAuthorKind as l, KanboToolName as m, CardAttention as n, IssueView as o, KanboToolCliEquivalent as p, CardLastComment as r, IssueWriterProvenance as s, BoardApproval as t, toIssueView as u, EntryRuleFacts as v, serializeEntryRules as w, evaluateEntryRules as x, UNMET_ENTRY_RULE_REASONS as y };
+export { readEntryRules as C, FlowRule as D, FLOW_RULES as E, readFlowRules as O, readChecklist as S, ColumnFlowRules as T, EntryRule as _, IssueActorReference as a, UnmetEntryRule as b, isOutsideWriter as c, KANBO_TOOL_CLI_EQUIVALENTS as d, KANBO_TOOL_NAMES as f, ENTRY_RULE_DESCRIPTIONS as g, ENTRY_RULES as h, IssueActorKind as i, normalizeCommentAuthorKind as l, KanboToolName as m, CardAttention as n, IssueView as o, KanboToolCliEquivalent as p, CardLastComment as r, IssueWriterProvenance as s, BoardApproval as t, toIssueView as u, EntryRuleFacts as v, serializeEntryRules as w, evaluateEntryRules as x, UNMET_ENTRY_RULE_REASONS as y };

package/dist/lib/{board-store-D_Mpfb84.d.mts → board-store-D2x2w1wG.d.cts}

@@ -1,4 +1,4 @@
-import { _ as issueStatuses, a as IssuePullRequest, c as IssueStatus, d as issueComments, f as issueFieldChanges, g as issueRuns, h as issueRelations, i as IssueMilestone, l as KanbanMeta, m as issuePullRequests, n as IssueComment, o as IssueRelation, p as issueMilestones, r as IssueFieldChange, s as IssueRun, t as Issue, v as issues } from "./schema-D0MyXcej.mjs";
+import { _ as issueStatuses, a as IssuePullRequest, c as IssueStatus, d as issueComments, f as issueFieldChanges, g as issueRuns, h as issueRelations, i as IssueMilestone, l as KanbanMeta, m as issuePullRequests, n as IssueComment, o as IssueRelation, p as issueMilestones, r as IssueFieldChange, s as IssueRun, t as Issue, v as issues } from "./schema-Cwx3HosC.cjs";
 //#region src/board-store.d.ts
 /** Workflow statuses of a workspace. */
 interface IssueStatusStore {
@@ -62,6 +62,12 @@ interface IssueRowStore {
   /** Issues with the given ids, in no particular order. Missing ids are simply absent. */
   listByIds: (issueIds: string[]) => Promise<Issue[]>;
   findById: (issueId: string) => Promise<Issue | null>;
+  /**
+   * The issue, read inside a write so no other writer can change it until this
+   * transaction ends: `select … for update` on Postgres. A SQLite write already
+   * holds the whole file (`begin immediate`), so there it is `findById`.
+   */
+  lockById: (issueId: string) => Promise<Issue | null>;
   /** The issue, only when it belongs to the given workspace. */
   findInWorkspace: (workspaceId: string, issueId: string) => Promise<Issue | null>;
   /** The issue carrying that number inside the workspace — the uniqueness constraint behind key generation. */
@@ -272,12 +278,30 @@ interface IssueContextRefStore {
   /** Replace the whole ref list of one issue with the serialized value the caller built. */
   replace: (issueId: string, contextRefs: Issue['contextRefs'], updatedAt: number) => Promise<void>;
 }
+/** Which field changes `listByFieldSince` reads: the cards of these workspaces, from `since` and up to `until` (unix seconds, both inclusive), `limit` at most. */
+interface BoardFieldChangeQuery {
+  workspaceIds: readonly string[];
+  since: number;
+  until?: number;
+  limit?: number;
+}
+/** A field change with the workspace its card is on — one row of `listByFieldSince`. */
+type BoardWorkspaceFieldChange = IssueFieldChange & {
+  workspaceId: string;
+};
 /** Append-only audit of issue field edits. */
 interface IssueFieldChangeStore {
   /** Field changes of one issue, oldest first. */
   listByIssue: (issueId: string) => Promise<IssueFieldChange[]>;
   /** Field changes of one issue touching one field, oldest first. */
   listByIssueField: (issueId: string, field: string) => Promise<IssueFieldChange[]>;
+  /**
+   * The changes of one field on the cards of the named workspaces, ordered by
+   * `(created_at, id)` — the `(field, created_at)` index answers it. An empty
+   * `workspaceIds` lists nothing. Changes whose new value is null are left out.
+   * What the column-entry feed reads.
+   */
+  listByFieldSince: (field: string, query: BoardFieldChangeQuery) => Promise<BoardWorkspaceFieldChange[]>;
   create: (values: typeof issueFieldChanges.$inferInsert) => Promise<void>;
 }
 /** A pull request a card names, with the workspace of that card — one row of `listLinked`. */
@@ -351,4 +375,4 @@ interface BoardStore {
   }) => Promise<T>;
 }
 //#endregion
-export { IssueRunStore as _, BoardMilestoneCardCount as a, BoardStore as c, IssueContextRefStore as d, IssueFieldChangeStore as f, IssueRowStore as g, IssueRelationStore as h, BoardLinkedPullRequest as i, BoardTransactionMode as l, IssuePullRequestStore as m, BoardCardPage as n, BoardRunProjection as o, IssueMilestoneStore as p, BoardCardQuery as r, BoardRunProjectionScope as s, BoardActiveRun as t, IssueCommentStore as u, IssueStatusStore as v, KanbanMetaStore as y };
+export { IssueRelationStore as _, BoardLinkedPullRequest as a, IssueStatusStore as b, BoardRunProjectionScope as c, BoardWorkspaceFieldChange as d, IssueCommentStore as f, IssuePullRequestStore as g, IssueMilestoneStore as h, BoardFieldChangeQuery as i, BoardStore as l, IssueFieldChangeStore as m, BoardCardPage as n, BoardMilestoneCardCount as o, IssueContextRefStore as p, BoardCardQuery as r, BoardRunProjection as s, BoardActiveRun as t, BoardTransactionMode as u, IssueRowStore as v, KanbanMetaStore as x, IssueRunStore as y };

package/dist/lib/{board-store-Dx-mw2I6.d.cts → board-store-DN5Y2U2y.d.mts}

@@ -1,4 +1,4 @@
-import { _ as issueStatuses, a as IssuePullRequest, c as IssueStatus, d as issueComments, f as issueFieldChanges, g as issueRuns, h as issueRelations, i as IssueMilestone, l as KanbanMeta, m as issuePullRequests, n as IssueComment, o as IssueRelation, p as issueMilestones, r as IssueFieldChange, s as IssueRun, t as Issue, v as issues } from "./schema-D0MyXcej.cjs";
+import { _ as issueStatuses, a as IssuePullRequest, c as IssueStatus, d as issueComments, f as issueFieldChanges, g as issueRuns, h as issueRelations, i as IssueMilestone, l as KanbanMeta, m as issuePullRequests, n as IssueComment, o as IssueRelation, p as issueMilestones, r as IssueFieldChange, s as IssueRun, t as Issue, v as issues } from "./schema-Cwx3HosC.mjs";
 //#region src/board-store.d.ts
 /** Workflow statuses of a workspace. */
 interface IssueStatusStore {
@@ -62,6 +62,12 @@ interface IssueRowStore {
   /** Issues with the given ids, in no particular order. Missing ids are simply absent. */
   listByIds: (issueIds: string[]) => Promise<Issue[]>;
   findById: (issueId: string) => Promise<Issue | null>;
+  /**
+   * The issue, read inside a write so no other writer can change it until this
+   * transaction ends: `select … for update` on Postgres. A SQLite write already
+   * holds the whole file (`begin immediate`), so there it is `findById`.
+   */
+  lockById: (issueId: string) => Promise<Issue | null>;
   /** The issue, only when it belongs to the given workspace. */
   findInWorkspace: (workspaceId: string, issueId: string) => Promise<Issue | null>;
   /** The issue carrying that number inside the workspace — the uniqueness constraint behind key generation. */
@@ -272,12 +278,30 @@ interface IssueContextRefStore {
   /** Replace the whole ref list of one issue with the serialized value the caller built. */
   replace: (issueId: string, contextRefs: Issue['contextRefs'], updatedAt: number) => Promise<void>;
 }
+/** Which field changes `listByFieldSince` reads: the cards of these workspaces, from `since` and up to `until` (unix seconds, both inclusive), `limit` at most. */
+interface BoardFieldChangeQuery {
+  workspaceIds: readonly string[];
+  since: number;
+  until?: number;
+  limit?: number;
+}
+/** A field change with the workspace its card is on — one row of `listByFieldSince`. */
+type BoardWorkspaceFieldChange = IssueFieldChange & {
+  workspaceId: string;
+};
 /** Append-only audit of issue field edits. */
 interface IssueFieldChangeStore {
   /** Field changes of one issue, oldest first. */
   listByIssue: (issueId: string) => Promise<IssueFieldChange[]>;
   /** Field changes of one issue touching one field, oldest first. */
   listByIssueField: (issueId: string, field: string) => Promise<IssueFieldChange[]>;
+  /**
+   * The changes of one field on the cards of the named workspaces, ordered by
+   * `(created_at, id)` — the `(field, created_at)` index answers it. An empty
+   * `workspaceIds` lists nothing. Changes whose new value is null are left out.
+   * What the column-entry feed reads.
+   */
+  listByFieldSince: (field: string, query: BoardFieldChangeQuery) => Promise<BoardWorkspaceFieldChange[]>;
   create: (values: typeof issueFieldChanges.$inferInsert) => Promise<void>;
 }
 /** A pull request a card names, with the workspace of that card — one row of `listLinked`. */
@@ -351,4 +375,4 @@ interface BoardStore {
   }) => Promise<T>;
 }
 //#endregion
-export { IssueRunStore as _, BoardMilestoneCardCount as a, BoardStore as c, IssueContextRefStore as d, IssueFieldChangeStore as f, IssueRowStore as g, IssueRelationStore as h, BoardLinkedPullRequest as i, BoardTransactionMode as l, IssuePullRequestStore as m, BoardCardPage as n, BoardRunProjection as o, IssueMilestoneStore as p, BoardCardQuery as r, BoardRunProjectionScope as s, BoardActiveRun as t, IssueCommentStore as u, IssueStatusStore as v, KanbanMetaStore as y };
+export { IssueRelationStore as _, BoardLinkedPullRequest as a, IssueStatusStore as b, BoardRunProjectionScope as c, BoardWorkspaceFieldChange as d, IssueCommentStore as f, IssuePullRequestStore as g, IssueMilestoneStore as h, BoardFieldChangeQuery as i, BoardStore as l, IssueFieldChangeStore as m, BoardCardPage as n, BoardMilestoneCardCount as o, IssueContextRefStore as p, BoardCardQuery as r, BoardRunProjection as s, BoardActiveRun as t, BoardTransactionMode as u, IssueRowStore as v, KanbanMetaStore as x, IssueRunStore as y };

package/dist/lib/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_manifest = require("./manifest-QPoQl8tn.cjs");
+const require_manifest = require("./manifest-DUGRyC7A.cjs");
 const require_migrations_path = require("./migrations-path-DBCE17dT.cjs");
 exports.BINDING_FILE_PATH = require_manifest.BINDING_FILE_PATH;
 exports.BOARD_ACTOR = require_manifest.BOARD_ACTOR;
@@ -14,6 +14,7 @@ exports.DEFAULT_BOARD_FILE_PATH = require_manifest.DEFAULT_BOARD_FILE_PATH;
 exports.DEFAULT_STATUSES = require_manifest.DEFAULT_STATUSES;
 exports.ENTRY_RULES = require_manifest.ENTRY_RULES;
 exports.ENTRY_RULE_DESCRIPTIONS = require_manifest.ENTRY_RULE_DESCRIPTIONS;
+exports.FLOW_RULES = require_manifest.FLOW_RULES;
 exports.KANBO_TOOL_CLI_EQUIVALENTS = require_manifest.KANBO_TOOL_CLI_EQUIVALENTS;
 exports.KANBO_TOOL_NAMES = require_manifest.KANBO_TOOL_NAMES;
 exports.TRACKED_FIELDS = require_manifest.TRACKED_FIELDS;
@@ -50,6 +51,7 @@ exports.readBinding = require_manifest.readBinding;
 exports.readChangeSeq = require_manifest.readChangeSeq;
 exports.readChecklist = require_manifest.readChecklist;
 exports.readEntryRules = require_manifest.readEntryRules;
+exports.readFlowRules = require_manifest.readFlowRules;
 exports.readIssuePrefix = require_manifest.readIssuePrefix;
 exports.readProjectBinding = require_manifest.readProjectBinding;
 exports.readSystemCommentKind = require_manifest.readSystemCommentKind;

package/dist/lib/index.d.cts

@@ -1,6 +1,6 @@
-import { a as IssuePullRequest, c as IssueStatus, f as issueFieldChanges, i as IssueMilestone, l as KanbanMeta, n as IssueComment, o as IssueRelation, r as IssueFieldChange, s as IssueRun, t as Issue, v as issues } from "./schema-D0MyXcej.cjs";
-import { _ as IssueRunStore, a as BoardMilestoneCardCount, c as BoardStore, d as IssueContextRefStore, f as IssueFieldChangeStore, g as IssueRowStore, h as IssueRelationStore, i as BoardLinkedPullRequest, l as BoardTransactionMode, m as IssuePullRequestStore, n as BoardCardPage, o as BoardRunProjection, p as IssueMilestoneStore, r as BoardCardQuery, s as BoardRunProjectionScope, t as BoardActiveRun, u as IssueCommentStore, v as IssueStatusStore, y as KanbanMetaStore } from "./board-store-Dx-mw2I6.cjs";
-import { C as readEntryRules, S as readChecklist, _ as EntryRule, a as IssueActorReference, b as UnmetEntryRule, c as isOutsideWriter, d as KANBO_TOOL_CLI_EQUIVALENTS, f as KANBO_TOOL_NAMES, g as ENTRY_RULE_DESCRIPTIONS, h as ENTRY_RULES, i as IssueActorKind, l as normalizeCommentAuthorKind, m as KanboToolName, n as CardAttention, o as IssueView, p as KanboToolCliEquivalent, r as CardLastComment, s as IssueWriterProvenance, t as BoardApproval, u as toIssueView, v as EntryRuleFacts, w as serializeEntryRules, x as evaluateEntryRules, y as UNMET_ENTRY_RULE_REASONS } from "./approval-BsBk2xVr.cjs";
+import { a as IssuePullRequest, c as IssueStatus, f as issueFieldChanges, i as IssueMilestone, l as KanbanMeta, n as IssueComment, o as IssueRelation, r as IssueFieldChange, s as IssueRun, t as Issue, v as issues } from "./schema-Cwx3HosC.cjs";
+import { _ as IssueRelationStore, a as BoardLinkedPullRequest, b as IssueStatusStore, c as BoardRunProjectionScope, d as BoardWorkspaceFieldChange, f as IssueCommentStore, g as IssuePullRequestStore, h as IssueMilestoneStore, i as BoardFieldChangeQuery, l as BoardStore, m as IssueFieldChangeStore, n as BoardCardPage, o as BoardMilestoneCardCount, p as IssueContextRefStore, r as BoardCardQuery, s as BoardRunProjection, t as BoardActiveRun, u as BoardTransactionMode, v as IssueRowStore, x as KanbanMetaStore, y as IssueRunStore } from "./board-store-D2x2w1wG.cjs";
+import { C as readEntryRules, D as FlowRule, E as FLOW_RULES, O as readFlowRules, S as readChecklist, T as ColumnFlowRules, _ as EntryRule, a as IssueActorReference, b as UnmetEntryRule, c as isOutsideWriter, d as KANBO_TOOL_CLI_EQUIVALENTS, f as KANBO_TOOL_NAMES, g as ENTRY_RULE_DESCRIPTIONS, h as ENTRY_RULES, i as IssueActorKind, l as normalizeCommentAuthorKind, m as KanboToolName, n as CardAttention, o as IssueView, p as KanboToolCliEquivalent, r as CardLastComment, s as IssueWriterProvenance, t as BoardApproval, u as toIssueView, v as EntryRuleFacts, w as serializeEntryRules, x as evaluateEntryRules, y as UNMET_ENTRY_RULE_REASONS } from "./approval-DNfUhYD5.cjs";
 import { z } from "zod";
 //#region src/cli/output.d.ts
 /**
@@ -366,7 +366,7 @@ export declare function maskDatabaseUrls(text: string): string;
  * (`../serve/board-error-responses.ts`), the one table `kanbo serve` and any app
  * serving the board over HTTP answer with.
  */
-type BoardErrorCode = 'board_approval_requires_user' | 'board_column_name_taken' | 'board_column_not_empty' | 'board_column_ready_protected' | 'board_column_remove_target_invalid' | 'board_column_rules_requires_user' | 'board_column_structure_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';
+type BoardErrorCode = 'board_approval_requires_user' | 'board_card_not_ready' | 'board_card_run_active' | 'board_column_name_taken' | 'board_column_not_empty' | 'board_column_ready_protected' | 'board_column_remove_target_invalid' | 'board_column_rules_requires_user' | 'board_column_structure_requires_user' | 'board_column_rules_unmet' | 'board_entry_rule_invalid' | 'board_execution_mode_locked' | 'board_flow_rule_invalid' | 'board_nothing_ready' | '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_cycle' | '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;
@@ -960,6 +960,44 @@ type BoardRunView = IssueRun & {
   attempt: number;
 };
 //#endregion
+//#region src/ops/claim.d.ts
+/** What a claim takes: the board, the card when the claimer names one, and the run it starts. */
+interface ClaimCardInput {
+  workspaceId: string;
+  /** The card to take; the first ready card in To Do, in board order, when absent. */
+  issueId?: string;
+  run: StartRunInput;
+}
+/** What a claim did: the card where it now is, the run it started, and the column it moved to. */
+interface ClaimedCard {
+  /** Carries `unmetRules` when a person's claim put it in a column whose rules it does not meet. */
+  card: BoardCardWrite;
+  run: IssueRun;
+  column: IssueStatus;
+}
+/** Why a named card is not there to take, most telling first. */
+type CardNotReadyReason = 'run_active' | 'waiting_for_person' | 'not_in_to_do';
+//#endregion
+//#region src/ops/column-entries.d.ts
+/** One card entering one column: a move, or a card created in it (`fromStatusId: null`). */
+interface ColumnEntry {
+  changeId: string;
+  issueId: string;
+  workspaceId: string;
+  fromStatusId: string | null;
+  toStatusId: string;
+  actorKind: IssueFieldChange['actorKind'];
+  actorId: string | null;
+  /** Unix seconds. */
+  at: number;
+}
+/** Which boards to read, from when (unix seconds, inclusive), and where a page may end. */
+interface ListColumnEntriesInput {
+  workspaceIds: string[];
+  since: number;
+  limit?: number;
+}
+//#endregion
 //#region src/ops/activity.d.ts
 /**
  * What the host knows and the board does not: the names of its workspaces, who
@@ -1231,6 +1269,7 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
   assertReturnable: (issueId: string, input: {
     toStatusName?: string | null;
   }, actor: BoardActor) => Promise<{
+    allowedFrom: string | null;
     category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
     color: string | null;
     createdAt: number;
@@ -1239,6 +1278,7 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     id: string;
     name: string;
     order: number;
+    wipLimit: number | null;
     workspaceId: string;
   }>;
   readApproval: (issueId: string) => Promise<BoardApproval>;
@@ -1317,6 +1357,7 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     carryTo?: string | null;
   }, actor: BoardActor, scope?: BoardWriteScope<TStore>) => Promise<CloseSprintResult>;
   listColumns: (workspaceId: string) => Promise<{
+    allowedFrom: string | null;
     category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
     color: string | null;
     createdAt: number;
@@ -1325,9 +1366,11 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     id: string;
     name: string;
     order: number;
+    wipLimit: number | null;
     workspaceId: string;
   }[]>;
   findColumn: (workspaceId: string, nameOrId: string) => Promise<{
+    allowedFrom: string | null;
     category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
     color: string | null;
     createdAt: number;
@@ -1336,9 +1379,11 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     id: string;
     name: string;
     order: number;
+    wipLimit: number | null;
     workspaceId: string;
   } | null>;
   requireColumn: (workspaceId: string, nameOrId: string) => Promise<{
+    allowedFrom: string | null;
     category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
     color: string | null;
     createdAt: number;
@@ -1347,9 +1392,11 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     id: string;
     name: string;
     order: number;
+    wipLimit: number | null;
     workspaceId: string;
   }>;
   ensureDefaultColumns: (workspaceId: string, scope?: BoardWriteScope<TStore>) => Promise<{
+    allowedFrom: string | null;
     category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
     color: string | null;
     createdAt: number;
@@ -1358,9 +1405,11 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     id: string;
     name: string;
     order: number;
+    wipLimit: number | null;
     workspaceId: string;
   }[]>;
   createColumn: (input: BoardColumnInput, actor: BoardActor, scope?: BoardWriteScope<TStore>) => Promise<{
+    allowedFrom: string | null;
     category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
     color: string | null;
     createdAt: number;
@@ -1369,9 +1418,11 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     id: string;
     name: string;
     order: number;
+    wipLimit: number | null;
     workspaceId: string;
   }>;
   updateColumn: (statusId: string, patch: BoardColumnPatch, actor: BoardActor, scope?: BoardWriteScope<TStore>) => Promise<{
+    allowedFrom: string | null;
     category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
     color: string | null;
     createdAt: number;
@@ -1380,9 +1431,11 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     id: string;
     name: string;
     order: number;
+    wipLimit: number | null;
     workspaceId: string;
   }>;
   describeColumn: (workspaceId: string, nameOrId: string, description: string | null, scope?: BoardWriteScope<TStore>) => Promise<{
+    allowedFrom: string | null;
     category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
     color: string | null;
     createdAt: number;
@@ -1391,9 +1444,11 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     id: string;
     name: string;
     order: number;
+    wipLimit: number | null;
     workspaceId: string;
   }>;
   setColumnEntryRules: (workspaceId: string, nameOrId: string, entryRules: readonly string[] | null, actor: BoardActor, scope?: BoardWriteScope<TStore>) => Promise<{
+    allowedFrom: string | null;
     category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
     color: string | null;
     createdAt: number;
@@ -1402,8 +1457,35 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     id: string;
     name: string;
     order: number;
+    wipLimit: number | null;
     workspaceId: string;
   }>;
+  setColumnFlowRules: (columnId: string, rules: ColumnFlowRules, actor: BoardActor, scope?: BoardWriteScope<TStore>) => Promise<{
+    allowedFrom: string | null;
+    category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
+    color: string | null;
+    createdAt: number;
+    description: string | null;
+    entryRules: string | null;
+    id: string;
+    name: string;
+    order: number;
+    wipLimit: number | null;
+    workspaceId: string;
+  }>;
+  applyStandardFlow: (workspaceId: string, actor: BoardActor, scope?: BoardWriteScope<TStore>) => Promise<{
+    allowedFrom: string | null;
+    category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
+    color: string | null;
+    createdAt: number;
+    description: string | null;
+    entryRules: string | null;
+    id: string;
+    name: string;
+    order: number;
+    wipLimit: number | null;
+    workspaceId: string;
+  }[]>;
   enforceColumnEntryForCards: (issueIds: string[], statusId: string, actor: BoardActor) => Promise<{
     issueId: string;
     unmet: UnmetEntryRule[];
@@ -1415,6 +1497,7 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     added: string[];
   }>;
   addColumn: (workspaceId: string, input: AddColumnInput, actor: BoardActor, scope?: BoardWriteScope<TStore>) => Promise<{
+    allowedFrom: string | null;
     category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
     color: string | null;
     createdAt: number;
@@ -1423,6 +1506,7 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     id: string;
     name: string;
     order: number;
+    wipLimit: number | null;
     workspaceId: string;
   }>;
   applyColumnTemplate: (workspaceId: string, columns: readonly ColumnSpec[], options: ApplyColumnTemplateOptions, scope?: BoardWriteScope<TStore>) => Promise<{
@@ -1430,6 +1514,7 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     added: string[];
   }>;
   renameColumn: (workspaceId: string, nameOrId: string, newName: string, actor: BoardActor, scope?: BoardWriteScope<TStore>) => Promise<{
+    allowedFrom: string | null;
     category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
     color: string | null;
     createdAt: number;
@@ -1438,9 +1523,11 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     id: string;
     name: string;
     order: number;
+    wipLimit: number | null;
     workspaceId: string;
   }>;
   moveColumn: (workspaceId: string, nameOrId: string, position: ColumnPosition, actor: BoardActor, scope?: BoardWriteScope<TStore>) => Promise<{
+    allowedFrom: string | null;
     category: "backlog" | "canceled" | "completed" | "started" | "triage" | "unstarted";
     color: string | null;
     createdAt: number;
@@ -1449,6 +1536,7 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     id: string;
     name: string;
     order: number;
+    wipLimit: number | null;
     workspaceId: string;
   }[]>;
   removeColumn: (workspaceId: string, nameOrId: string, options: RemoveColumnOptions, actor: BoardActor, scope?: BoardWriteScope<TStore>) => Promise<RemoveColumnResult>;
@@ -1469,6 +1557,7 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     state: "failed" | "finished" | "running" | "stopped";
     worktreePath: string | null;
   }>;
+  claimCard: (input: ClaimCardInput, actor: BoardActor, scope?: BoardWriteScope<TStore>) => Promise<ClaimedCard>;
   attachRunExecution: (runId: string, input: AttachRunExecutionInput, scope?: BoardWriteScope<TStore>) => Promise<{
     agentId: string | null;
     agentName: string;
@@ -1596,6 +1685,7 @@ export declare function createBoardOps<TStore extends BoardStore>(store: TStore)
     limit?: number;
     offset?: number;
   }) => Promise<CardQueryResult>;
+  listColumnEntries: (input: ListColumnEntriesInput) => Promise<ColumnEntry[]>;
   buildPrimeText: (workspaceId: string) => Promise<string>;
 };
 /** The board's operations, as a type callers can name. */
@@ -1622,7 +1712,7 @@ interface BoardErrorResponse {
  * answering for a person — approving a card, sending it back or closing a
  * sprint — as anyone but one is 403, dropping a pull request link somebody else made is the same 403
  * for the same reason, and acting on a run that has already ended is 409,
- * because the answer would have been yes a moment earlier. An agent putting a
+ * because the answer would have been yes a moment earlier. Starting a run on a card that has one going, and claiming a card nobody can take right now, are 409 for the same reason. An agent putting a
  * card in a column whose entry rules it does not meet yet is 409 for the same
  * reason turned around: the answer will be yes once the card meets them, and
  * `details.unmet` says what is missing. Deleting a column that still holds
@@ -1636,4 +1726,4 @@ interface BoardErrorResponse {
  */
 export declare const BOARD_ERROR_RESPONSES: Record<BoardErrorCode, BoardErrorResponse>;
 //#endregion
-export { type AddColumnInput, type AddCommentInput, type ApplyColumnTemplateOptions, type AttachRunExecutionInput, type BoardActiveRun, type BoardActor, type BoardApproval, type BoardCardPage, type BoardCardQuery, type BoardCardWrite, type BoardColumnInput, type BoardColumnPatch, type BoardErrorCode, type BoardErrorResponse, type BoardLinkedPullRequest, type BoardMilestoneCardCount, 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 CardAttention, type CardLastComment, type CardQueryInput, type CardQueryResult, type CloseSprintResult, type ColumnPosition, type ColumnSpec, type ColumnTemplateId, 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 RemoveColumnOptions, type RemoveColumnResult, type StartRunInput, UNMET_ENTRY_RULE_REASONS, type UnmetEntryRule, type UpdateCardInput, type UpdateMilestoneInput, evaluateEntryRules, isOutsideWriter, normalizeCommentAuthorKind, readChecklist, readEntryRules, serializeEntryRules, toIssueView };
+export { type AddColumnInput, type AddCommentInput, type ApplyColumnTemplateOptions, type AttachRunExecutionInput, type BoardActiveRun, type BoardActor, type BoardApproval, type BoardCardPage, type BoardCardQuery, type BoardCardWrite, type BoardColumnInput, type BoardColumnPatch, type BoardErrorCode, type BoardErrorResponse, type BoardFieldChangeQuery, type BoardLinkedPullRequest, type BoardMilestoneCardCount, type BoardOps, type BoardPullRequestStanding, type BoardRunProjection, type BoardRunProjectionScope, type BoardRunView, type BoardSprint, type BoardStore, type BoardTransactionMode, type BoardWorkspaceFieldChange, type BoardWorkspaceIdentity, type BoardWriteScope, type BulkUpdateCardsInput, type BulkUpdateCardsResult, type CardAttention, type CardLastComment, type CardNotReadyReason, type CardQueryInput, type CardQueryResult, type ClaimCardInput, type ClaimedCard, type CloseSprintResult, type ColumnEntry, type ColumnFlowRules, type ColumnPosition, type ColumnSpec, type ColumnTemplateId, type CreateCardInput, type CreateCommentOnceInput, type CreateMilestoneInput, type CreateRelationInput, ENTRY_RULES, ENTRY_RULE_DESCRIPTIONS, type EntryRule, type EntryRuleFacts, type ExternalSessionRef, FLOW_RULES, type FinishRunInput, type FlowRule, 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 ListColumnEntriesInput, type MigrateCardsInput, type MigrateCardsResult, type PullRequestFactKeys, type RemoveColumnOptions, type RemoveColumnResult, type StartRunInput, UNMET_ENTRY_RULE_REASONS, type UnmetEntryRule, type UpdateCardInput, type UpdateMilestoneInput, evaluateEntryRules, isOutsideWriter, normalizeCommentAuthorKind, readChecklist, readEntryRules, readFlowRules, serializeEntryRules, toIssueView };