@apexops/cli 0.10.0-next.3 → 0.10.0-next.5

package/assets/customizations/.github/agents/apex-requirements.agent.md

@@ -11,8 +11,9 @@ tools:
   - apex/nextTask
   - apex/recordInput
   - apex/taskContext
-  - apex/stageArtifact
-  - apex/completeTask
+  - apex/requirementsComplete
+  - apex/reviewDecide
+  - apex/gateDecide
   - azure-resource-manager-mcp/get_retail_prices
   - azure-resource-manager-mcp/query_costs
   - azure-resource-manager-mcp/query_aks_costs
@@ -41,12 +42,16 @@ candidate Azure services without deciding architecture, and produces a human-rev
 
 # Success criteria
 
-1. Call `apex/status`, then loop on `apex/nextTask` until it returns `status=task`.
+1. Extract facts already supplied in the user's opening description. Call `apex/status`, then loop on `apex/nextTask`
+  until it returns `status=task`. Present matching supplied facts as recommended confirmations; do not make the user
+  retype them and do not record them before confirmation.
 2. For every `status=needs_input`, do not call `apex/taskContext`. Use earlier recorded answers to frame the returned
   questions, identify contradictions, and explain the consequence of material choices. Ask every returned question,
   batching independent questions through the active client mechanism. Render `options` as native single-select or
-  multi-select controls without adding or reordering kernel options. For `data-classification` and `compliance`, convert
-  selections to their required typed value. Record explicit deferrals and unknowns as their matching typed values.
+  multi-select controls without adding or reordering kernel options. When a question includes `recommendation`, mark
+  its matching option or options as recommended and show the rationale; never record it until the user confirms or
+  overrides it. For `data-classification` and `compliance`, convert selections to their required typed value. Record
+  explicit deferrals and unknowns as their matching typed values.
 3. Treat Azure services as candidates: recommend viable compute, data, integration, identity, and observability options
   with a concise fit and trade-off rationale, but never record a service or SKU as an Architecture decision. Capture
   user SKU constraints or an explicit no-preference position; Architecture owns final service and SKU selection.
@@ -58,13 +63,19 @@ candidate Azure services without deciding architecture, and produces a human-rev
   required fields. Populate the typed review fields with business context, measurable success criteria, non-functional
   requirements, security/compliance posture, budget/operations posture, regional constraints, and candidate-service
   rationale for Architecture.
-7. Stage and submit the typed requirements artifact. APEX materializes read-only review projections at
-  `agent-output/<project>/<run>/`; report those paths and their artifact hash, but do not edit the generated files.
-8. When the kernel issues `requirements-review`, delegate the exact task to `APEX Reviewer`. Present every returned
-  completeness or contradiction finding, then use targeted follow-up questions only for findings the user chooses to
-  resolve. Findings must be remediated, accepted with rationale, or explicitly deferred before Gate 1 can open.
-9. When review completes, direct the user to review `01-requirements.md`, `README.md`, `service-recommendations.md`,
-  `sku-preferences.md`, and `challenger-findings.md`. Gate 1 remains a human terminal ceremony; never approve it.
+7. Submit the typed requirements artifact through `apex/requirementsComplete`. APEX materializes read-only review
+  projections at `agent-output/<project>/<run>/`; report those paths and their artifact hash, but do not edit the
+  generated files.
+8. Immediately call `apex/nextTask` after submitting requirements. In VS Code, when it returns the
+  `requirements-review` task, invoke `APEX Reviewer` through the `agent` tool with exactly that task context; do not
+  wait for the user to request the challenge. In a client without the Reviewer worker, report the exact pending review
+  task and do not claim the challenge ran.
+9. When `apex/nextTask` returns `needs_review`, present every finding in one native decision panel. Submit the complete
+  decision set through `apex/reviewDecide`. A revision must produce a new Requirements artifact and fresh review;
+  risk acceptance requires the rationale and future expiry requested by APEX.
+10. When review completes, direct the user to review `01-requirements.md`, `README.md`, `service-recommendations.md`,
+  `sku-preferences.md`, and `challenger-findings.md`. Ask one explicit Proceed/Revise question. Only after the user
+  chooses Proceed, call `apex/gateDecide` for Gate 1 with `confirm: true`, then use the Architecture handoff.
 
 Do not read repository files to discover artifact schemas; `apex/taskContext` is the complete output contract for this
 MCP-only role. Read `.github/skills/apex-azure-defaults/SKILL.md` only when the kernel asks for a region, compliance,

package/assets/customizations/.github/agents/apex-reviewer.agent.md

@@ -6,7 +6,8 @@ model: ["GPT-5.6 Terra"]
 user-invocable: false
 tools:
   - apex/taskContext
-  - apex/completeTask
+  - apex/readTaskInput
+  - apex/reviewComplete
   - azure-resource-manager-mcp/get_retail_prices
   - azure-resource-manager-mcp/query_costs
   - azure-resource-manager-mcp/query_aks_costs
@@ -28,16 +29,19 @@ resolve, accept with rationale, or defer through the owning interactive stage.
 
 # Success criteria
 
-1. Call `apex/taskContext` once.
+1. Call `apex/taskContext` once. If its content is externalized or incomplete, call `apex/readTaskInput` with the
+  supplied task ID, then continue from each returned `nextOffset` until the bounded review subject is complete.
 2. Evaluate only supplied content, references, and review criteria. Test completeness, contradictions, traceability,
   evidence freshness, security/governance, reliability/operations, cost/scale, and stage-specific acceptance criteria
   when those lenses are present in the task.
-3. Return one typed finding per issue with severity, evidence references, a concise impact, and a concrete remediation.
-  Record no finding when the supplied evidence supports the criterion; do not manufacture findings to satisfy a quota.
+3. Return one typed finding per issue with `id`, `severity`, `title`, and `detail`. Put the challenged criterion,
+  evidence, impact, and concrete remediation in `detail`. Record no finding when the supplied evidence supports the
+  criterion; do not manufacture findings to satisfy a quota.
 4. The kernel materializes a read-only summary at `agent-output/<project>/<run>/reviews/<subject>-findings.md`.
   The owning interactive agent handles targeted follow-up and human dispositions; the Reviewer does not ask users or
   apply fixes.
-5. Return evidence-linked findings through `apex/completeTask`.
+5. Return findings through `apex/reviewComplete`; APEX derives subject identity, hash, timestamp, disposition, and
+  evidence binding.
 
 # Constraints
 

package/assets/customizations/.github/agents/apex.agent.md

@@ -13,6 +13,7 @@ tools:
   - apex/projectList
   - apex/projectUse
   - apex/projectDelete
+  - apex/gateDecide
   - azure-resource-manager-mcp/get_retail_prices
   - azure-resource-manager-mcp/query_costs
   - azure-resource-manager-mcp/query_aks_costs
@@ -81,6 +82,9 @@ Coordinate APEX without authoring project artifacts or inferring workflow state.
   `apex gate decide --gate <N> --decision <approved|rejected> --actor <USER_ID> --json`. At Gate 4, also require
   review of the exact preview, target, expiry, and approval recipient before directing
   `apex gate decide --gate 4 --decision <approved|rejected> --actor <USER_ID> --recipient <RECIPIENT_ID> --json`.
+9. When the user explicitly says `approve Gate 1`, `approve Gate 2`, `approve Gate 3`, or the equivalent rejection,
+  call `apex/gateDecide` with that gate, decision, and `confirm: true`. The operation derives the actor from the local
+  OS username. Do not use it for Gate 4, and do not infer confirmation from an ambiguous message.
 
 Use the active client projection's question mechanism only for project creation or kernel-owned routing choices. Read
 `.github/skills/apex-workflow/SKILL.md` only when status, resume, or project selection needs more guidance.

package/assets/customizations/.github/mcp.json

@@ -11,16 +11,23 @@
         "capabilityStatus",
         "nextTask",
         "taskContext",
+        "readTaskInput",
         "recordInput",
         "projectCreate",
         "projectList",
         "projectUse",
         "projectDelete",
+        "gateDecide",
+        "reviewDecide",
         "stageArtifact",
         "stageFile",
         "generateIac",
         "validateTask",
         "completeTask",
+        "requirementsComplete",
+        "architectureComplete",
+        "reviewComplete",
+        "planComplete",
         "preview",
         "reconcile",
         "inventory",

package/assets/customizations/.github/skills/apex-requirements/SKILL.md

@@ -24,10 +24,13 @@ Use this skill only for an active requirements task.
 4. Submit that request only through `apex/recordInput`, preserving its request ID, expected journal head, and owner
    epoch.
 5. Call `apex/nextTask` again and repeat until it returns a requirements `task`; only then read `apex/taskContext`.
-6. Treat the service-preferences round as a preference boundary. Capture retained, prohibited, and preferred services,
-   SKU preferences, and environment overrides without selecting architecture, SKUs, or implementation details.
-7. Stage the task-context-defined requirements output, complete the requirements task, and wait for the required review
-   result before reporting that Gate 1 is ready. Only the kernel opens or evaluates Gate 1.
+6. Treat service questions in the workload panel as a preference boundary. Present the kernel recommendation, then
+   capture retained, prohibited, and preferred services, SKU preferences, and environment overrides without selecting
+   architecture, SKUs, or implementation details.
+7. Submit the task-context-defined output through `apex/requirementsComplete`, invoke the required Reviewer, and handle
+   `needs_review` through one native findings panel and `apex/reviewDecide`.
+8. After a clean or fully dispositioned review, ask for explicit Gate 1 approval. Call `apex/gateDecide` only after the
+   user chooses Proceed, then continue to Architecture in the same turn.
 
 The kernel catalog and its versioned input contracts are authoritative. Do not choose architecture, SKUs, or
 implementation details while gathering requirements.

package/assets/customizations/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.10.0-next.3",
+  "version": "0.10.0-next.5",
   "bundle": {
     "id": "apex-managed-workspace",
     "authority": "npm:@apexops/cli",

package/assets/manifest.json

@@ -1,7 +1,7 @@
 {
   "version": 1,
   "sources": {
-    "customizations": "0.10.0-next.3",
+    "customizations": "0.10.0-next.5",
     "config": "1.0.0"
   },
   "composition": {
@@ -190,7 +190,7 @@
         "client-projections/github-copilot-cli/.github/skills/apex-terraform-test/references/test-design.md",
         "client-projections/github-copilot-cli/.github/skills/apex-workflow/SKILL.md"
       ],
-      "digest": "5e312275847b3433ec55ce0d35d0b7c55025247a958a5b239af806c2f5621498"
+      "digest": "87f5d74109a94f0014cb832441c4e02bb5b7c5ce97f7a43f80959e55b96052ec"
     },
     {
       "id": "github-copilot-vscode",
@@ -338,7 +338,7 @@
         "client-projections/github-copilot-vscode/.github/skills/apex-workflow/SKILL.md",
         "client-projections/github-copilot-vscode/.vscode/mcp.json"
       ],
-      "digest": "e879f9c46bbf2f8de5eb76449d41a11af533714148331441f2f0cb6f5660c160"
+      "digest": "a6387c778c2f2fddbda8453960f113ec4522bca784a7aeaa0a113fa18e9da7db"
     }
   ],
   "files": [
@@ -378,8 +378,8 @@
         "path": "tools/registry/copilot-cli-agent-tools.json",
         "mapping": "copilot-cli-tool-inventory"
       },
-      "sha256": "eaa67e61da99a42fca622f5e0c75f2778bf19d78016f176e0ac0a4620f6e1dca",
-      "bytes": 3008
+      "sha256": "e67b7d9ca1c28956c13e8817c5f8ae2173d2070f4855ff71098690516e40d1fc",
+      "bytes": 3310
     },
     {
       "path": "client-projections/github-copilot-cli/.github/agents/apex-architect.agent.md",
@@ -388,13 +388,13 @@
         "composition": "client-projections",
         "roleId": "architecture",
         "sourcePath": ".github/agents/apex-architect.agent.md",
-        "sourceHash": "0620b04dc8a48db7f5af148044ed8d040079f887add3b16b3c0e9fdcc022cca0",
+        "sourceHash": "47e6edf792c88ea633cd3bc66c59fba00a3c13020f8771d3635d5e2cc3414e70",
         "clientId": "github-copilot-cli",
         "target": ".github/agents/apex-architect.agent.md",
         "adapterVersion": "1.1.0"
       },
-      "sha256": "3d58237f0006a983daf33bb96049e006d4c1dfd301088d306bc16491b5569c74",
-      "bytes": 5408
+      "sha256": "9c194b0877b6dabcb5a5775c1e719bf851ea194206a183a582200f645b74dfc8",
+      "bytes": 5362
     },
     {
       "path": "client-projections/github-copilot-cli/.github/agents/apex-operator.agent.md",
@@ -418,13 +418,13 @@
         "composition": "client-projections",
         "roleId": "planning",
         "sourcePath": ".github/agents/apex-planner.agent.md",
-        "sourceHash": "15934864666d9b4f3936f526942d1f56c1a5e8fc608b5ce2047db139eab9d2fa",
+        "sourceHash": "b33471f0ef586ace4847b9eecfd5363c1d8b269dd9eba460022498ff488c509c",
         "clientId": "github-copilot-cli",
         "target": ".github/agents/apex-planner.agent.md",
         "adapterVersion": "1.1.0"
       },
-      "sha256": "039d8f4d5ca4b5b6920a6bce4e052acb6a81d20844668bc5d6da61a1ed6a211b",
-      "bytes": 4661
+      "sha256": "e1e7a3790dc13628214ba19d5b28d1ab8a522fff07868e5c962a3ad985b690f5",
+      "bytes": 4868
     },
     {
       "path": "client-projections/github-copilot-cli/.github/agents/apex-requirements.agent.md",
@@ -433,13 +433,13 @@
         "composition": "client-projections",
         "roleId": "requirements",
         "sourcePath": ".github/agents/apex-requirements.agent.md",
-        "sourceHash": "1e7c8d6d7992fc5d59499f662f00a20fe9814c80fb5a321cb063ec5067ebf04f",
+        "sourceHash": "4bb98532f4c277424689eab261779a33dd0790faf6764a8487848afb5ffb9225",
         "clientId": "github-copilot-cli",
         "target": ".github/agents/apex-requirements.agent.md",
         "adapterVersion": "1.1.0"
       },
-      "sha256": "00a54b4a8f43b47184ec72f62f730e0dbe1ad3319ea0c09300b9cecf28cae8db",
-      "bytes": 5143
+      "sha256": "6bd816e8b228ca0fd5b46e55949495286316b5cc406d11f0cefd9cd5bf0b3b0d",
+      "bytes": 6044
     },
     {
       "path": "client-projections/github-copilot-cli/.github/agents/apex.agent.md",
@@ -448,13 +448,13 @@
         "composition": "client-projections",
         "roleId": "coordinator",
         "sourcePath": ".github/agents/apex.agent.md",
-        "sourceHash": "a9a64bb9f743ba73f0ea2237f0e2702a1881dee7f90ca83f9cf588de37bbed45",
+        "sourceHash": "a7440e67b68177d9877a9d5b2201917d1bdf56fda9431ef106ffa1cb7a30298c",
         "clientId": "github-copilot-cli",
         "target": ".github/agents/apex.agent.md",
         "adapterVersion": "1.1.0"
       },
-      "sha256": "73f6d4fb101c4b7eff22472eca46c931c6b7e96a72810c0f10136e6568d39aea",
-      "bytes": 4908
+      "sha256": "65da2837858c0251432818f2819f21877253152d5626fd4715c79ce47ff0fc4f",
+      "bytes": 5261
     },
     {
       "path": "client-projections/github-copilot-cli/.github/copilot-instructions.md",
@@ -773,10 +773,10 @@
         "target": ".github/mcp.json",
         "adapterVersion": "1.1.0",
         "sourcePath": ".github/mcp.json",
-        "sourceHash": "dd39613c4d01b6f7146afe6c09548d6153fbfad550dba6bfcdbecf8188cb2209"
+        "sourceHash": "21d86c077f0f304e59433f7b7f5063948f60b41ec961f71d50eccf94c340fea9"
       },
-      "sha256": "dd39613c4d01b6f7146afe6c09548d6153fbfad550dba6bfcdbecf8188cb2209",
-      "bytes": 1350
+      "sha256": "21d86c077f0f304e59433f7b7f5063948f60b41ec961f71d50eccf94c340fea9",
+      "bytes": 1535
     },
     {
       "path": "client-projections/github-copilot-cli/.github/skills/apex-architecture/SKILL.md",
@@ -2089,10 +2089,10 @@
         "target": ".github/skills/apex-requirements/SKILL.md",
         "adapterVersion": "1.1.0",
         "sourcePath": ".github/skills/apex-requirements/SKILL.md",
-        "sourceHash": "846fd892c70658a956b6657eebc06557619f7483cf690acf0e2d18ad9c616884"
+        "sourceHash": "0b5076218e79d165efaa2d4a00d5f6014804e6f04666d223947a4e8c9f9512f5"
       },
-      "sha256": "846fd892c70658a956b6657eebc06557619f7483cf690acf0e2d18ad9c616884",
-      "bytes": 2187
+      "sha256": "0b5076218e79d165efaa2d4a00d5f6014804e6f04666d223947a4e8c9f9512f5",
+      "bytes": 2418
     },
     {
       "path": "client-projections/github-copilot-cli/.github/skills/apex-terraform-import/SKILL.md",
@@ -2339,13 +2339,13 @@
         "composition": "client-projections",
         "roleId": "architecture",
         "sourcePath": ".github/agents/apex-architect.agent.md",
-        "sourceHash": "0620b04dc8a48db7f5af148044ed8d040079f887add3b16b3c0e9fdcc022cca0",
+        "sourceHash": "47e6edf792c88ea633cd3bc66c59fba00a3c13020f8771d3635d5e2cc3414e70",
         "clientId": "github-copilot-vscode",
         "target": ".github/agents/apex-architect.agent.md",
         "adapterVersion": "1.1.0"
       },
-      "sha256": "d1cb288b989e3ad488e6ae26b0c1cb83b39692058bd6f12fbfe5215a016ad368",
-      "bytes": 5693
+      "sha256": "f4e8363fd82309494f2d3a54371abd824e6862323c4db6f52c8b8fe657bf0745",
+      "bytes": 5647
     },
     {
       "path": "client-projections/github-copilot-vscode/.github/agents/apex-codegen.agent.md",
@@ -2384,13 +2384,13 @@
         "composition": "client-projections",
         "roleId": "planning",
         "sourcePath": ".github/agents/apex-planner.agent.md",
-        "sourceHash": "15934864666d9b4f3936f526942d1f56c1a5e8fc608b5ce2047db139eab9d2fa",
+        "sourceHash": "b33471f0ef586ace4847b9eecfd5363c1d8b269dd9eba460022498ff488c509c",
         "clientId": "github-copilot-vscode",
         "target": ".github/agents/apex-planner.agent.md",
         "adapterVersion": "1.1.0"
       },
-      "sha256": "1423df4a00c325f3c07eb7906da4a72990f6a221c7f271333fb22e31ae99ffcd",
-      "bytes": 4969
+      "sha256": "1133d3020cdf6b5a787df091730e9efa7de9076290dd760fe58864478d7fbec4",
+      "bytes": 5176
     },
     {
       "path": "client-projections/github-copilot-vscode/.github/agents/apex-requirements.agent.md",
@@ -2399,13 +2399,13 @@
         "composition": "client-projections",
         "roleId": "requirements",
         "sourcePath": ".github/agents/apex-requirements.agent.md",
-        "sourceHash": "1e7c8d6d7992fc5d59499f662f00a20fe9814c80fb5a321cb063ec5067ebf04f",
+        "sourceHash": "4bb98532f4c277424689eab261779a33dd0790faf6764a8487848afb5ffb9225",
         "clientId": "github-copilot-vscode",
         "target": ".github/agents/apex-requirements.agent.md",
         "adapterVersion": "1.1.0"
       },
-      "sha256": "d053deeb51609ad24e36192f14bc7407b84c425bc87d6f607cba50ac7d295989",
-      "bytes": 5447
+      "sha256": "70e254ca0b7a8cef6f44fc93c5558d6983c6d0bee71b616dc467f5010a687165",
+      "bytes": 6348
     },
     {
       "path": "client-projections/github-copilot-vscode/.github/agents/apex-reviewer.agent.md",
@@ -2414,13 +2414,13 @@
         "composition": "client-projections",
         "roleId": "review",
         "sourcePath": ".github/agents/apex-reviewer.agent.md",
-        "sourceHash": "b76a003f0147584974175f47e5d1a28d68c45f5153d12a8c5fa5e4552872ae13",
+        "sourceHash": "aa2c8064d102f8e2e69eaccc15894455abfcc56892e61bde46d6ece0cbc3c7cd",
         "clientId": "github-copilot-vscode",
         "target": ".github/agents/apex-reviewer.agent.md",
         "adapterVersion": "1.1.0"
       },
-      "sha256": "55dbe78ed39469d87e6a223c3b986986f78a7f66d4058690bd69457e5e7da12d",
-      "bytes": 2635
+      "sha256": "4be66c1a357ea492c20eaada3431c9b7184f33618bfd69f2725c0c83a2f3f8e7",
+      "bytes": 2976
     },
     {
       "path": "client-projections/github-copilot-vscode/.github/agents/apex-validator.agent.md",
@@ -2444,13 +2444,13 @@
         "composition": "client-projections",
         "roleId": "coordinator",
         "sourcePath": ".github/agents/apex.agent.md",
-        "sourceHash": "a9a64bb9f743ba73f0ea2237f0e2702a1881dee7f90ca83f9cf588de37bbed45",
+        "sourceHash": "a7440e67b68177d9877a9d5b2201917d1bdf56fda9431ef106ffa1cb7a30298c",
         "clientId": "github-copilot-vscode",
         "target": ".github/agents/apex.agent.md",
         "adapterVersion": "1.1.0"
       },
-      "sha256": "cb0aea4d710e8974d137475db3edbc772a51a76696c4d6f738364ec940ae9c5a",
-      "bytes": 5726
+      "sha256": "1ebb9da1303aff993228efdc1bb29dde70c6ce9c3cb1b61306659ae2a7ecc6f2",
+      "bytes": 6079
     },
     {
       "path": "client-projections/github-copilot-vscode/.github/copilot-instructions.md",
@@ -4071,10 +4071,10 @@
         "target": ".github/skills/apex-requirements/SKILL.md",
         "adapterVersion": "1.1.0",
         "sourcePath": ".github/skills/apex-requirements/SKILL.md",
-        "sourceHash": "846fd892c70658a956b6657eebc06557619f7483cf690acf0e2d18ad9c616884"
+        "sourceHash": "0b5076218e79d165efaa2d4a00d5f6014804e6f04666d223947a4e8c9f9512f5"
       },
-      "sha256": "846fd892c70658a956b6657eebc06557619f7483cf690acf0e2d18ad9c616884",
-      "bytes": 2187
+      "sha256": "0b5076218e79d165efaa2d4a00d5f6014804e6f04666d223947a4e8c9f9512f5",
+      "bytes": 2418
     },
     {
       "path": "client-projections/github-copilot-vscode/.github/skills/apex-terraform-import/SKILL.md",
@@ -4385,7 +4385,7 @@
         "path": "config/runtime-bundle.v1.json",
         "mapping": "config"
       },
-      "sha256": "414de8d636f820fb560142c33d38dc12a38ec2e924149c3c123a0cf3fd9fbcbc",
+      "sha256": "7f90c32650d60c10143c298896b404b204427c77a5a746a8778a9bdf1229fd30",
       "bytes": 2039
     },
     {
@@ -4415,8 +4415,8 @@
         "path": "customizations/.github/agents/apex-architect.agent.md",
         "mapping": "customizations"
       },
-      "sha256": "0620b04dc8a48db7f5af148044ed8d040079f887add3b16b3c0e9fdcc022cca0",
-      "bytes": 5509
+      "sha256": "47e6edf792c88ea633cd3bc66c59fba00a3c13020f8771d3635d5e2cc3414e70",
+      "bytes": 5463
     },
     {
       "path": "customizations/.github/agents/apex-codegen.agent.md",
@@ -4445,8 +4445,8 @@
         "path": "customizations/.github/agents/apex-planner.agent.md",
         "mapping": "customizations"
       },
-      "sha256": "15934864666d9b4f3936f526942d1f56c1a5e8fc608b5ce2047db139eab9d2fa",
-      "bytes": 4785
+      "sha256": "b33471f0ef586ace4847b9eecfd5363c1d8b269dd9eba460022498ff488c509c",
+      "bytes": 4992
     },
     {
       "path": "customizations/.github/agents/apex-requirements.agent.md",
@@ -4455,8 +4455,8 @@
         "path": "customizations/.github/agents/apex-requirements.agent.md",
         "mapping": "customizations"
       },
-      "sha256": "1e7c8d6d7992fc5d59499f662f00a20fe9814c80fb5a321cb063ec5067ebf04f",
-      "bytes": 5263
+      "sha256": "4bb98532f4c277424689eab261779a33dd0790faf6764a8487848afb5ffb9225",
+      "bytes": 6164
     },
     {
       "path": "customizations/.github/agents/apex-reviewer.agent.md",
@@ -4465,8 +4465,8 @@
         "path": "customizations/.github/agents/apex-reviewer.agent.md",
         "mapping": "customizations"
       },
-      "sha256": "b76a003f0147584974175f47e5d1a28d68c45f5153d12a8c5fa5e4552872ae13",
-      "bytes": 2594
+      "sha256": "aa2c8064d102f8e2e69eaccc15894455abfcc56892e61bde46d6ece0cbc3c7cd",
+      "bytes": 2935
     },
     {
       "path": "customizations/.github/agents/apex-validator.agent.md",
@@ -4485,8 +4485,8 @@
         "path": "customizations/.github/agents/apex.agent.md",
         "mapping": "customizations"
       },
-      "sha256": "a9a64bb9f743ba73f0ea2237f0e2702a1881dee7f90ca83f9cf588de37bbed45",
-      "bytes": 5542
+      "sha256": "a7440e67b68177d9877a9d5b2201917d1bdf56fda9431ef106ffa1cb7a30298c",
+      "bytes": 5895
     },
     {
       "path": "customizations/.github/copilot-instructions.md",
@@ -4715,8 +4715,8 @@
         "path": "customizations/.github/mcp.json",
         "mapping": "customizations"
       },
-      "sha256": "dd39613c4d01b6f7146afe6c09548d6153fbfad550dba6bfcdbecf8188cb2209",
-      "bytes": 1350
+      "sha256": "21d86c077f0f304e59433f7b7f5063948f60b41ec961f71d50eccf94c340fea9",
+      "bytes": 1535
     },
     {
       "path": "customizations/.github/skills/apex-architecture/SKILL.md",
@@ -5655,8 +5655,8 @@
         "path": "customizations/.github/skills/apex-requirements/SKILL.md",
         "mapping": "customizations"
       },
-      "sha256": "846fd892c70658a956b6657eebc06557619f7483cf690acf0e2d18ad9c616884",
-      "bytes": 2187
+      "sha256": "0b5076218e79d165efaa2d4a00d5f6014804e6f04666d223947a4e8c9f9512f5",
+      "bytes": 2418
     },
     {
       "path": "customizations/.github/skills/apex-terraform-import/SKILL.md",
@@ -5855,13 +5855,13 @@
         "path": "customizations/manifest.json",
         "mapping": "customizations"
       },
-      "sha256": "03599d828a02d0e36696af2efaa7ba3353089aebee332ea8043638f0a7b0727c",
+      "sha256": "c6f64975501baddd9d1712a7a5169b70ab61a4328fdcba9444c0b20800d05ade",
       "bytes": 14078
     }
   ],
   "lock": {
     "algorithm": "sha256",
     "canonicalization": "apex-bundled-assets-v1",
-    "digest": "207ce6214c3078991469dc4e5a02b91ab0d6e43830bcb587703c683823e67fae"
+    "digest": "455ee4805ee6e1635feea04cd73745cd358679a791360ba7f6ae24180785a05d"
   }
 }

package/dist/cli.d.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
 import { type ServiceOptions } from "./service.js";
 export declare function execute(argv: string[], root?: string, options?: ServiceOptions): Promise<unknown>;
+export declare function formatHumanResult(args: string[], result: unknown): string;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.js

@@ -624,12 +624,14 @@ export async function execute(argv, root = process.cwd(), options = {}) {
 }
 async function main() {
     const json = process.argv.includes("--json");
+    const verbose = process.argv.includes("--verbose");
+    const args = process.argv.slice(2);
     try {
-        const result = await execute(process.argv.slice(2));
+        const result = await execute(args);
         if (result !== undefined)
             process.stdout.write(json
                 ? `${JSON.stringify({ ok: true, result })}\n`
-                : `${typeof result === "string" ? result : JSON.stringify(result, null, 2)}\n`);
+                : `${verbose ? (typeof result === "string" ? result : JSON.stringify(result, null, 2)) : formatHumanResult(args, result)}\n`);
     }
     catch (error) {
         const normalized = normalizeError(error);
@@ -641,6 +643,44 @@ async function main() {
         process.exitCode = normalized.exitCode;
     }
 }
+export function formatHumanResult(args, result) {
+    const command = args.find((argument) => !argument.startsWith("--"));
+    if (command === "status" && result !== null && typeof result === "object") {
+        const status = result;
+        const task = status.task ?? null;
+        const stage = task?.startsWith("requirements")
+            ? "Requirements"
+            : task?.startsWith("architecture") || task?.startsWith("governance")
+                ? "Architecture"
+                : task?.startsWith("plan")
+                    ? "Planning"
+                    : task?.startsWith("codegen") || task?.startsWith("validation")
+                        ? "Build and validate"
+                        : task?.startsWith("preview") || task?.startsWith("deploy") || task === "inventory"
+                            ? "Operations"
+                            : "Ready for next decision";
+        const blocker = status.blockers?.[0] ?? "None";
+        const next = task !== null ? `Continue ${stage}` : blocker !== "None" ? blocker : "Ask APEX to continue";
+        return [
+            `Project: ${status.run?.projectId ?? "unknown"} (${status.run?.environment ?? "unknown"})`,
+            `Stage: ${stage}`,
+            `Blocker: ${blocker}`,
+            `Next: ${next}`,
+        ].join("\n");
+    }
+    if (command === "doctor" && result !== null && typeof result === "object") {
+        const doctor = result;
+        const passed = doctor.checks?.filter(({ ok }) => ok).length ?? 0;
+        const total = doctor.checks?.length ?? 0;
+        const remaining = doctor.remedies?.length ?? 0;
+        return [
+            `Status: ${doctor.healthy ? "Ready" : "Setup incomplete"} (${passed}/${total} checks ready)`,
+            `Next: ${doctor.nextAction ?? "No action required"}`,
+            ...(remaining > 1 ? [`Later: ${remaining - 1} additional setup item${remaining === 2 ? "" : "s"}`] : []),
+        ].join("\n");
+    }
+    return typeof result === "string" ? result : JSON.stringify(result, null, 2);
+}
 if (process.argv[1] !== undefined && (await realpath(process.argv[1])) === (await realpath(new URL(import.meta.url))))
     await main();
 //# sourceMappingURL=cli.js.map