delimit_os_plan
Create an OS-level execution plan for deploying, migrating, or rotating a target component, requiring approval before execution.
Instructions
Mint an OS-level execution plan against a target component (Pro).
When to use: to draft a structured plan (deploy, migrate, rotation, rollback) that the governance kernel can later inspect via delimit_os_gates and human reviewers can approve before any side-effecting execution. The pattern is plan -> approval check via gates -> separate execution call. When NOT to use: for aggregate OS counts (delimit_os_status), to check gate state on an existing plan (delimit_os_gates), or to actually execute a deploy (delimit_deploy_* / delimit_deploy_build). Also do not use this as an audit-trail surrogate for free-form work; that is delimit_ledger_add territory.
Sibling contrast: delimit_os_gates checks gates on an existing plan; delimit_os_status reports portfolio-wide counts; this is the only OS surface that mints a new plan. Compared to delimit_gov_new_task (governance-classed task), this records an OS-level operation (deploy/migrate/rotation) rather than a policy-scoped task.
Side effects: gated by require_premium — unlicensed callers
receive a license payload and no plan is created. On a licensed
call, parameters is first coerced (string -> dict via
_coerce_dict_arg); a malformed payload short-circuits with an
error response. On success, invokes backends.os_bridge.create_plan
which writes a new plan record to the OS plan store keyed by a
generated plan_id. Result is wrapped via _with_next_steps. No
deploy is executed by this call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | Yes | Operation to plan (e.g. "deploy", "migrate"). Required. | |
| target | Yes | Target component or service. Required. | |
| parameters | No | Optional operation parameters as dict or JSON string. | |
| require_approval | No | If True (default), the plan requires approval before execution. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||