contains is a local substring helper to keep the templates_test.go file dependency-free. The standard library's strings.Contains would also work; keep

containsHeader does a case-insensitive comma-separated lookup.

containsPair returns true when args contains an adjacent (flag, value) pair. Used to assert "--workspace docapp" appears in BuildCLIArgs's output with

conventionPriorityRank ranks convention priority strings (must > should > nice-to-have). Lower rank = higher priority. Unknown values rank last so unt

copyFileContents copies src to dst atomically: it writes to a sibling temp file, fsyncs it, then renames it into place. A failure therefore never leav

countAndValue returns the number of times flag appears followed by a value, plus the LAST such value. Used to assert "exactly one --workspace and it h

--- create ---

createTaggedItem creates an item with the given JSON tags array.

currentUserFromRequest / isAPITokenFromRequest mirror the package-private accessors in internal/server. We need read-only access for tests; surface a

defaultStatus renders an empty status as a readable placeholder for error messages.

defaultTransport lazily builds and memoizes the package's safe transport. Reusing one transport across Fetch calls keeps the keep-alive pool bounded a

--- delete ---

deriveItemClosure computes derived closure (superseded, implemented, split) from item links. When vis is non-nil, links to items in hidden collections

dirPresent reports whether any of dirs (relative to base) exists as a directory.

dispatchAttachmentList handles `pad attachment list` — pure metadata query against /api/v1/workspaces/{ws}/attachments. Custom dispatcher (rather tha

dispatchAttachmentShow handles `pad attachment show <attachment-id> [--variant ...]` — metadata-only HEAD request. The HEAD response has no body; the

dispatchCreateItemLink handles the create-side of the link surface (block, blocked-by, implements, supersedes, split-from). Resolves both refs, then P

dispatchDeleteItemLink handles the un-* side of the link surface (unblock, unimplements, unsupersede, unsplit). Mirrors the CLI's deleteLineageLink +

dispatchItemDecide is the decision-log analogue of dispatchItemNote — same RMW shape, just using AppendDecisionLogEntry on a different fields slot.

dispatchItemDeps handles `pad item deps <ref>` — the simplest of the three read-only link queries. CLI parity: `deps --format json` returns the raw `/

dispatchItemImplementedBy handles `pad item implemented-by <ref>` with the CLI's filtered shape (cmd/pad/query.go implementedByCmd): {"item_ref":...

dispatchItemImport reproduces `pad item import <file>` over the HTTP MCP transport. It POSTs the raw artifact text (YAML frontmatter + Markdown body)

--- item note + decide (RMW append) --- dispatchItemNote handles `pad item note <ref> <summary> [--details ...]` — appends an implementation-note entr

dispatchItemRelated handles `pad item related <ref>` and emits the grouped response shape the CLI's `--format json` output uses (cmd/pad/query.go rela

dispatchItemUpdate handles `pad item update <ref>` with full CLI parity, including the read-modify-write merge of the fields JSON. The handler at han

--- library activate --- dispatchLibraryActivate reproduces `pad library activate <title>`: looks up a library entry by title (conventions first, then

dispatchLibraryList composes the /convention-library and playbook-library endpoints to mirror `pad library list --format json`. The CLI's JSON output

dispatchProjectChangelog proxies `project changelog` to GET workspaces/{ws}/changelog?days=N&since=YYYY-MM-DD&parent=REF — handleGetProjectChangelog (

dispatchProjectNext proxies `project next` to GET workspaces/{ws}/next — handleGetProjectNext (internal/server/handlers_project_intel.go), the browser

dispatchProjectReady reproduces `pad project ready --format json` — the CLI returns `{count, results}` extracted from the dashboard's SuggestedNext sl

dispatchProjectStale reproduces `pad project stale --format json` — CLI filters the dashboard's Attention slice to "interesting" types (stalled / bloc

dispatchProjectStandup proxies `project standup` to GET workspaces/{ws}/standup?days=N — handleGetProjectStandup (internal/server/handlers_project_int

doArtifactRequestWithCookie is doArtifactRequest with session + CSRF cookies, for the cloud-mode paths that require authentication.

doInteractiveLogin implements the classic email/password prompt login.

* Resolve the document position to insert at for a drop event. Uses * the editor's coordinate-to-position mapping; returns null when the * drop land

--- playbook ---

100 MiB effectiveBlobMaxBytes returns the per-blob ceiling for bundle import — matches whatever the upload handler accepts so an operator who raised P

effectiveLimit / effectiveOffset mirror the store-side defaults so the response carries the canonical values the handler used. Useful to the UI when t

emailVerifiedBackfillSQL reads the ACTUAL backfill statement out of the embedded migration file (070 for SQLite, 048 for Postgres) so the backfill tes

emitCmdhelpJSON walks the cobra command tree below `target` and emits a cmdhelp v0.1 JSON document matching schema/cmdhelp.schema.json. `--all` is a

emitCmdhelpMarkdown walks the cobra command tree below `target` and emits a cmdhelp v0.1 markdown document with the predictable section order from spe

encodeFlagValue stringifies an MCP input value for inclusion as a CLI flag argument. Strings and primitives pass through fmt.Sprint as before; structu

ensureSkills detects AI tools, installs missing skill files, and updates outdated ones. Returns a summary of what it did.

equalFold is a tiny case-insensitive string compare without pulling in strings.EqualFold's full Unicode logic — agent names are ASCII.