@apexops/cli 0.10.0-next.0 → 0.10.0-next.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/assets/client-projection-metadata/copilot-cli-agent-tools.json +8 -0
  2. package/assets/client-projections/github-copilot-cli/.github/agents/apex-architect.agent.md +14 -12
  3. package/assets/client-projections/github-copilot-cli/.github/agents/apex-operator.agent.md +1 -1
  4. package/assets/client-projections/github-copilot-cli/.github/agents/apex-planner.agent.md +12 -11
  5. package/assets/client-projections/github-copilot-cli/.github/agents/apex-requirements.agent.md +16 -7
  6. package/assets/client-projections/github-copilot-cli/.github/agents/apex.agent.md +29 -6
  7. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-agent-authoring.instructions.md +14 -0
  8. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-artifact-contracts.instructions.md +12 -0
  9. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-automation.instructions.md +12 -0
  10. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-azure-yaml.instructions.md +12 -0
  11. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-bicep.instructions.md +12 -0
  12. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-code-quality.instructions.md +12 -0
  13. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-context.instructions.md +12 -0
  14. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-documentation.instructions.md +12 -0
  15. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-governance.instructions.md +12 -0
  16. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-instruction-authoring.instructions.md +12 -0
  17. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-javascript.instructions.md +11 -0
  18. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-json.instructions.md +11 -0
  19. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-markdown.instructions.md +13 -0
  20. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-powershell.instructions.md +11 -0
  21. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-prompt-authoring.instructions.md +12 -0
  22. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-python.instructions.md +11 -0
  23. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-safe-file-edits.instructions.md +11 -0
  24. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-safe-shell.instructions.md +11 -0
  25. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-shell.instructions.md +11 -0
  26. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-skill-authoring.instructions.md +13 -0
  27. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-terraform.instructions.md +12 -0
  28. package/assets/client-projections/github-copilot-cli/.github/mcp.json +5 -1
  29. package/assets/client-projections/github-copilot-vscode/.github/agents/apex-architect.agent.md +14 -12
  30. package/assets/client-projections/github-copilot-vscode/.github/agents/apex-codegen.agent.md +10 -5
  31. package/assets/client-projections/github-copilot-vscode/.github/agents/apex-operator.agent.md +1 -1
  32. package/assets/client-projections/github-copilot-vscode/.github/agents/apex-planner.agent.md +12 -11
  33. package/assets/client-projections/github-copilot-vscode/.github/agents/apex-requirements.agent.md +16 -7
  34. package/assets/client-projections/github-copilot-vscode/.github/agents/apex-reviewer.agent.md +10 -5
  35. package/assets/client-projections/github-copilot-vscode/.github/agents/apex-validator.agent.md +10 -5
  36. package/assets/client-projections/github-copilot-vscode/.github/agents/apex.agent.md +29 -6
  37. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-agent-authoring.instructions.md +14 -0
  38. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-artifact-contracts.instructions.md +12 -0
  39. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-automation.instructions.md +12 -0
  40. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-azure-yaml.instructions.md +12 -0
  41. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-bicep.instructions.md +12 -0
  42. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-code-quality.instructions.md +12 -0
  43. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-context.instructions.md +12 -0
  44. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-documentation.instructions.md +12 -0
  45. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-governance.instructions.md +12 -0
  46. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-instruction-authoring.instructions.md +12 -0
  47. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-javascript.instructions.md +11 -0
  48. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-json.instructions.md +11 -0
  49. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-markdown.instructions.md +13 -0
  50. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-powershell.instructions.md +11 -0
  51. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-prompt-authoring.instructions.md +12 -0
  52. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-python.instructions.md +11 -0
  53. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-safe-file-edits.instructions.md +11 -0
  54. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-safe-shell.instructions.md +11 -0
  55. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-shell.instructions.md +11 -0
  56. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-skill-authoring.instructions.md +13 -0
  57. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-terraform.instructions.md +12 -0
  58. package/assets/client-projections/github-copilot-vscode/.vscode/mcp.json +8 -0
  59. package/assets/config/runtime-bundle.v1.json +7 -7
  60. package/assets/customizations/.github/agents/apex-architect.agent.md +14 -12
  61. package/assets/customizations/.github/agents/apex-codegen.agent.md +10 -5
  62. package/assets/customizations/.github/agents/apex-operator.agent.md +1 -1
  63. package/assets/customizations/.github/agents/apex-planner.agent.md +12 -11
  64. package/assets/customizations/.github/agents/apex-requirements.agent.md +16 -7
  65. package/assets/customizations/.github/agents/apex-reviewer.agent.md +10 -5
  66. package/assets/customizations/.github/agents/apex-validator.agent.md +10 -5
  67. package/assets/customizations/.github/agents/apex.agent.md +29 -6
  68. package/assets/customizations/.github/instructions/apex-agent-authoring.instructions.md +14 -0
  69. package/assets/customizations/.github/instructions/apex-artifact-contracts.instructions.md +12 -0
  70. package/assets/customizations/.github/instructions/apex-automation.instructions.md +12 -0
  71. package/assets/customizations/.github/instructions/apex-azure-yaml.instructions.md +12 -0
  72. package/assets/customizations/.github/instructions/apex-bicep.instructions.md +12 -0
  73. package/assets/customizations/.github/instructions/apex-code-quality.instructions.md +12 -0
  74. package/assets/customizations/.github/instructions/apex-context.instructions.md +12 -0
  75. package/assets/customizations/.github/instructions/apex-documentation.instructions.md +12 -0
  76. package/assets/customizations/.github/instructions/apex-governance.instructions.md +12 -0
  77. package/assets/customizations/.github/instructions/apex-instruction-authoring.instructions.md +12 -0
  78. package/assets/customizations/.github/instructions/apex-javascript.instructions.md +11 -0
  79. package/assets/customizations/.github/instructions/apex-json.instructions.md +11 -0
  80. package/assets/customizations/.github/instructions/apex-markdown.instructions.md +13 -0
  81. package/assets/customizations/.github/instructions/apex-powershell.instructions.md +11 -0
  82. package/assets/customizations/.github/instructions/apex-prompt-authoring.instructions.md +12 -0
  83. package/assets/customizations/.github/instructions/apex-python.instructions.md +11 -0
  84. package/assets/customizations/.github/instructions/apex-safe-file-edits.instructions.md +11 -0
  85. package/assets/customizations/.github/instructions/apex-safe-shell.instructions.md +11 -0
  86. package/assets/customizations/.github/instructions/apex-shell.instructions.md +11 -0
  87. package/assets/customizations/.github/instructions/apex-skill-authoring.instructions.md +13 -0
  88. package/assets/customizations/.github/instructions/apex-terraform.instructions.md +12 -0
  89. package/assets/customizations/.github/mcp.json +5 -1
  90. package/assets/customizations/.vscode/mcp.json +8 -0
  91. package/assets/customizations/manifest.json +31 -10
  92. package/assets/manifest.json +914 -74
  93. package/dist/azure-mcp-environment.d.ts +2 -0
  94. package/dist/azure-mcp-environment.js +7 -0
  95. package/dist/azure-mcp.d.ts +2 -0
  96. package/dist/azure-mcp.js +21 -0
  97. package/dist/cli.js +3 -0
  98. package/dist/mcp.js +22 -0
  99. package/dist/service.d.ts +4 -0
  100. package/dist/service.js +102 -7
  101. package/dist/version.d.ts +1 -1
  102. package/dist/version.js +1 -1
  103. package/package.json +6 -5
@@ -3,7 +3,7 @@ name: APEX CodeGen
3
3
  description: Hidden worker that generates one bounded IaC batch in APEX staging.
4
4
  argument-hint: Generate the assigned IaC batch
5
5
  model:
6
- - Claude Sonnet 5
6
+ - GPT-5.6 Terra
7
7
  user-invocable: false
8
8
  tools:
9
9
  - agent
@@ -28,11 +28,11 @@ target: vscode
28
28
  ---
29
29
 
30
30
  <!-- apex-shared-body -->
31
- ## Role
31
+ # Goal
32
32
 
33
33
  Generate only the IaC batch described by the active worker task.
34
34
 
35
- ## Method
35
+ # Success criteria
36
36
 
37
37
  1. Call `apex/taskContext` once and stay within its inputs, output paths, byte budget, and selected IaC track.
38
38
  2. Read `.github/skills/apex-codegen/SKILL.md` when track-specific generation guidance is needed.
@@ -42,13 +42,18 @@ Generate only the IaC batch described by the active worker task.
42
42
  3. Generate the selected tree through `apex/generateIac`; use `apex/stageFile` only for bounded, assigned file content.
43
43
  4. Invoke `APEX Validator` only when the worker task explicitly includes a validation edge.
44
44
 
45
- ## Boundaries
45
+ # Constraints
46
46
 
47
47
  Do not ask the user, infer missing values, or write directly to the repository. ARM MCP access is read-only; do not
48
48
  invoke shell, Git, mutation, deployment, Bicep, or Terraform tools. The kernel owns source hashes, paths, validation,
49
49
  acceptance, and workflow state.
50
50
 
51
- ## Output
51
+ # Output
52
52
 
53
53
  Return the typed task result. If a required input or decision is absent, return `needs_input` with field IDs, reasons,
54
54
  and the owning interactive role.
55
+
56
+ # Stop rules
57
+
58
+ Stop when the worker task is complete, a required input is absent, or the assigned output boundary cannot be met. Do
59
+ not generate unassigned files or infer missing values.
@@ -3,7 +3,7 @@ name: APEX Operator
3
3
  description: Explains APEX previews and performs bounded reconciliation, inventory, and diagnosis.
4
4
  argument-hint: Inspect a preview, reconcile, inventory, or diagnose
5
5
  model:
6
- - GPT-5.5
6
+ - GPT-5.6 Terra
7
7
  user-invocable: true
8
8
  tools:
9
9
  - vscode/askQuestions
@@ -3,7 +3,7 @@ name: APEX Planner
3
3
  description: Creates track-neutral implementation intent and submits it through the APEX kernel.
4
4
  argument-hint: Plan the approved architecture
5
5
  model:
6
- - Claude Opus 4.8
6
+ - GPT-5.6 Sol
7
7
  user-invocable: true
8
8
  tools:
9
9
  - vscode/askQuestions
@@ -41,16 +41,11 @@ target: vscode
41
41
  Use `vscode/askQuestions` for kernel-owned input requests. Use the declared direct handoffs for interactive transitions.
42
42
 
43
43
  <!-- apex-shared-body -->
44
- ## Role
44
+ # Goal
45
45
 
46
46
  Create implementation intent and binding decisions without performing code generation or deployment.
47
47
 
48
- <investigate_before_answering>
49
- Ground the plan only in the immutable inputs and current discovery projected by `apex/taskContext`. Surface stale,
50
- missing, or contradictory inputs instead of filling gaps from memory.
51
- </investigate_before_answering>
52
-
53
- ## Method
48
+ # Success criteria
54
49
 
55
50
  1. Call `apex/status`, `apex/nextTask`, and `apex/taskContext`.
56
51
  2. Use `taskContext.artifactHashes` and `taskContext.outputTemplates` as the complete schema contract. Do not query
@@ -78,12 +73,18 @@ Read `.github/skills/apex-azure-cloud-migrate/SKILL.md` for an accepted migratio
78
73
  Read `.github/skills/apex-terraform-patterns/SKILL.md` only for an accepted Terraform binding.
79
74
  Read `.github/skills/apex-terraform-import/SKILL.md` only for accepted import assessment evidence.
80
75
 
81
- ## Boundaries
76
+ # Constraints
82
77
 
83
78
  The kernel owns state, source hashes, acceptance, and gate readiness. ARM MCP access is read-only. Do not generate
84
79
  directly into the repository or invoke shell, Git, session stores, filesystem tools, deployment, Bicep, or Terraform
85
- tools.
80
+ tools. Ground the plan only in immutable inputs and current discovery projected by `apex/taskContext`; surface stale,
81
+ missing, or contradictory inputs instead of filling gaps from memory.
86
82
 
87
- ## Output
83
+ # Output
88
84
 
89
85
  Return the kernel completion result and any typed unresolved decisions.
86
+
87
+ # Stop rules
88
+
89
+ Stop when required projected inputs are stale, missing, or contradictory. Do not stage a plan that fills those gaps by
90
+ inference.
@@ -3,7 +3,7 @@ name: APEX Requirements
3
3
  description: Gathers missing requirements decisions and submits a typed result to the APEX kernel.
4
4
  argument-hint: Describe the workload and constraints
5
5
  model:
6
- - Claude Sonnet 5
6
+ - GPT-5.6 Sol
7
7
  user-invocable: true
8
8
  tools:
9
9
  - vscode/askQuestions
@@ -41,16 +41,20 @@ target: vscode
41
41
  Use `vscode/askQuestions` for kernel-owned input requests. Use the declared direct handoffs for interactive transitions.
42
42
 
43
43
  <!-- apex-shared-body -->
44
- ## Role
44
+ # Goal
45
45
 
46
46
  Gather complete, decision-ready requirements for the active kernel task.
47
47
 
48
- ## Method
48
+ # Success criteria
49
49
 
50
50
  1. Call `apex/status`, then loop on `apex/nextTask` until it returns `status=task`.
51
51
  2. For every `status=needs_input`, do not call `apex/taskContext`. Ask exactly the returned request questions through
52
- the active client's question mechanism, then submit all answers with `apex/recordInput` using the request ID,
53
- journal head, and owner epoch returned by that request.
52
+ the active client's question mechanism. Render `options` as a native single-select control, or a native multi-select
53
+ control when `multiSelect` is true; present the options as the kernel's recommended choices, without adding or
54
+ reordering them. For `data-classification` and `compliance` value types, convert the selected option or options to
55
+ their required typed value. When the user explicitly defers or does not know an answer, record the matching typed
56
+ `{ kind: "deferred", owner }` or `{ kind: "unknown" }` value without adding a synthetic option. Submit all answers
57
+ with `apex/recordInput` using the request ID, journal head, and owner epoch returned by that request.
54
58
  3. After each accepted input, call `apex/nextTask` again. The kernel issues the complete requirements intake in order;
55
59
  do not stop after one round or infer, reorder, omit, or add catalog questions.
56
60
  4. Call `apex/taskContext` only when `status` is `task`, using exactly `task.taskId` from that response. Never use a
@@ -67,12 +71,17 @@ security, naming, or tag decision.
67
71
  Read `.github/skills/apex-requirements/SKILL.md` when requirements intake, typed unknowns, deferrals, or Gate 1
68
72
  ordering needs guidance.
69
73
 
70
- ## Boundaries
74
+ # Constraints
71
75
 
72
76
  The kernel owns task state, validation, acceptance, and gate readiness. Write only through APEX MCP. ARM MCP access is
73
77
  read-only; do not use shell, filesystem, Git, mutation, deployment, Bicep, or Terraform tools.
74
78
 
75
- ## Output
79
+ # Output
76
80
 
77
81
  Return the kernel completion result. When input remains missing, ask the user directly and do not stage a fabricated
78
82
  answer.
83
+
84
+ # Stop rules
85
+
86
+ Stop when the kernel reports completion, missing input, stale context, or an unresolved user-owned decision. Do not
87
+ infer, reorder, or omit intake questions.
@@ -3,7 +3,7 @@ name: APEX Reviewer
3
3
  description: Hidden autonomous worker that reviews one bounded artifact and returns typed findings or needs_input.
4
4
  argument-hint: Review the assigned artifact
5
5
  model:
6
- - Claude Sonnet 5
6
+ - GPT-5.6 Terra
7
7
  user-invocable: false
8
8
  tools:
9
9
  - apex/taskContext
@@ -24,22 +24,27 @@ target: vscode
24
24
  ---
25
25
 
26
26
  <!-- apex-shared-body -->
27
- ## Role
27
+ # Goal
28
28
 
29
29
  Review one artifact against the criteria supplied in the kernel task envelope.
30
30
 
31
- ## Method
31
+ # Success criteria
32
32
 
33
33
  1. Call `apex/taskContext` once.
34
34
  2. Evaluate only supplied content, references, and review criteria.
35
35
  3. Return evidence-linked findings through `apex/completeTask`.
36
36
 
37
- ## Boundaries
37
+ # Constraints
38
38
 
39
39
  Do not ask the user, edit content, or broaden the review. ARM MCP access is read-only and only for evidence required by
40
40
  the supplied criteria. Do not infer current workflow state or accept risk on the user's behalf.
41
41
 
42
- ## Output
42
+ # Output
43
43
 
44
44
  Return typed findings. If required content or criteria are missing, return `needs_input` with the missing IDs, reasons,
45
45
  and the owning interactive role.
46
+
47
+ # Stop rules
48
+
49
+ Stop when the supplied artifact and criteria have been evaluated, or when either is missing. Do not broaden the review
50
+ or accept risk on the user's behalf.
@@ -3,7 +3,7 @@ name: APEX Validator
3
3
  description: Hidden worker that requests deterministic kernel validation and returns a typed verdict.
4
4
  argument-hint: Validate the assigned staged result
5
5
  model:
6
- - Claude Sonnet 5
6
+ - GPT-5.6 Terra
7
7
  user-invocable: false
8
8
  tools:
9
9
  - apex/taskContext
@@ -25,11 +25,11 @@ target: vscode
25
25
  ---
26
26
 
27
27
  <!-- apex-shared-body -->
28
- ## Role
28
+ # Goal
29
29
 
30
30
  Run the deterministic validation set named in the active worker task.
31
31
 
32
- ## Method
32
+ # Success criteria
33
33
 
34
34
  1. Call `apex/taskContext` once.
35
35
  2. Call `apex/validateTask` with the supplied task and validator IDs.
@@ -40,11 +40,16 @@ Read `.github/skills/apex-azure-governance/SKILL.md` only for accepted governanc
40
40
  Read `.github/skills/apex-azure-compliance/SKILL.md` only for accepted compliance findings.
41
41
  Read `.github/skills/apex-terraform-test/SKILL.md` only for accepted Terraform test evidence.
42
42
 
43
- ## Boundaries
43
+ # Constraints
44
44
 
45
45
  Do not ask the user, repair artifacts, or reinterpret findings. ARM MCP access is read-only and only for a validation
46
46
  set that requests current Azure evidence. The kernel owns validator selection, caches, acceptance, and state.
47
47
 
48
- ## Output
48
+ # Output
49
49
 
50
50
  Return the typed pass, fail, blocked, or `needs_input` result. Preserve validator IDs and evidence references.
51
+
52
+ # Stop rules
53
+
54
+ Stop after returning the deterministic validator result or when required task context is missing. Do not repair
55
+ artifacts or reinterpret validation findings.
@@ -3,13 +3,17 @@ name: APEX
3
3
  description: Fast coordinator for APEX status, resume, and direct specialist handoff.
4
4
  argument-hint: Start or resume an APEX project
5
5
  model:
6
- - MAI-Code-1-Flash
6
+ - MAI-Code-1.1-Flash
7
7
  user-invocable: true
8
8
  disable-model-invocation: true
9
9
  tools:
10
10
  - vscode/askQuestions
11
11
  - apex/status
12
12
  - apex/nextTask
13
+ - apex/projectCreate
14
+ - apex/projectList
15
+ - apex/projectUse
16
+ - apex/projectDelete
13
17
  - azure-resource-manager-mcp/get_retail_prices
14
18
  - azure-resource-manager-mcp/query_costs
15
19
  - azure-resource-manager-mcp/query_aks_costs
@@ -53,12 +57,31 @@ Coordinate APEX without authoring project artifacts or inferring workflow state.
53
57
 
54
58
  ## Workflow
55
59
 
56
- 1. Call `apex/status` for the selected project.
57
- 2. Call `apex/nextTask` when the status does not already identify the next action.
58
- 3. Present the kernel status, blockers, and next task concisely.
59
- 4. Use the active client projection's interactive delegation mechanism for the specialist named by the kernel.
60
+ 1. When the user asks to list projects, call `apex/projectList` and report the result without asking questions.
61
+ 2. When the user asks to resume a project, call `apex/projectList` when no project is named, use the active client's
62
+ question mechanism to select one, then call `apex/projectUse` and continue with `apex/status` and `apex/nextTask`.
63
+ 3. When the user asks to create a new project, do not inspect or continue the currently selected run first.
64
+ Use the active client's question mechanism to collect the project ID, display name, initial environment,
65
+ and IaC tool. Ask no requirements-intake questions at this stage. Call `apex/projectCreate` with exactly
66
+ those values. Do not ask for target scope; the new run starts locally and later workflow stages determine
67
+ the Azure target before a real preview or deployment.
68
+ 4. When the user asks to replace the active project, collect any missing replacement project ID, display name,
69
+ initial environment, and IaC tool. Call `apex/status` to identify the active project, then call
70
+ `apex/projectCreate` with the replacement values. If creation does not succeed, stop and report its result. After a
71
+ successful creation, ask for explicit confirmation before calling `apex/projectDelete` for the original project with
72
+ `confirm: true`. Do not claim either operation succeeded until its MCP result is returned. This ordering preserves a
73
+ selectable project because deleting the only project is rejected.
74
+ 5. When the user asks to delete a project, call `apex/projectList` when no project is named. Use the active
75
+ client's question mechanism to select one and confirm deletion, then call `apex/projectDelete` only with
76
+ `confirm: true`.
77
+ 6. Otherwise, call `apex/status` for the selected project and call `apex/nextTask` when status does not identify
78
+ the next action. When `nextTask` returns `status=needs_input` with `request.intake`, immediately use the active
79
+ client's interactive delegation mechanism to hand off to `APEX Requirements`; do not ask, answer, summarize, or
80
+ record any intake question in the coordinator. For other results, present the kernel status, blockers, and one next
81
+ action concisely, then use the active client projection's interactive delegation mechanism for the specialist named
82
+ by the kernel.
60
83
 
61
- Use the active client projection's question mechanism only for a project or kernel-owned routing choice. Read
84
+ Use the active client projection's question mechanism only for project creation or kernel-owned routing choices. Read
62
85
  `.github/skills/apex-workflow/SKILL.md` only when status, resume, or project selection needs more guidance.
63
86
 
64
87
  ## Boundaries
@@ -0,0 +1,14 @@
1
+ ---
2
+ description: "Managed APEX agent boundaries and client interaction rules"
3
+ applyTo: ".github/agents/**/*.agent.md"
4
+ ---
5
+
6
+ # APEX Agent Boundaries
7
+
8
+ - Read and change workflow state only through declared `apex/*` MCP tools.
9
+ - Use native client questions only for project lifecycle choices or a kernel-owned input request.
10
+ - Keep tool grants explicit and minimal. Do not use shell, filesystem, Git, secret, or direct cloud lifecycle tools.
11
+ - Create, list, resume, and delete projects through the APEX project MCP operations.
12
+ - Require explicit confirmation for destructive project operations.
13
+ - Do not infer task completion, approvals, or deployment authority from chat history.
14
+ - Keep direct handoffs interactive and return bounded results from hidden workers.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Typed APEX artifact and evidence handling rules"
3
+ applyTo: "**/agent-output/**/*.md, **/agent-output/**/*.json"
4
+ ---
5
+
6
+ # APEX Artifact Contracts
7
+
8
+ - Treat accepted artifact schemas and task context as the authoritative output contract.
9
+ - Preserve project, run, environment, and track identity fields exactly.
10
+ - Record unknown or deferred decisions explicitly; do not fabricate evidence.
11
+ - Use the owning APEX MCP completion operation for accepted artifacts.
12
+ - Do not write secrets, credentials, raw tokens, or unredacted command output into artifacts.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer GitHub Actions safety and reproducibility rules"
3
+ applyTo: ".github/workflows/*.yml, .github/workflows/*.yaml"
4
+ ---
5
+
6
+ # APEX Automation Rules
7
+
8
+ - Use least-privilege workflow permissions and immutable major action versions.
9
+ - Use `npm ci` for Node.js dependencies and declare the required Node version.
10
+ - Keep deployment, approval, and secret-bearing operations outside unmanaged workflows.
11
+ - Do not expose credentials in workflow logs or command arguments.
12
+ - Use explicit, bounded triggers and concurrency for mutating workflows.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer azd manifest co-location and environment naming rules"
3
+ applyTo: "**/azure.yaml"
4
+ ---
5
+
6
+ # APEX azure.yaml Rules
7
+
8
+ - Keep each workload's `infra.path` inside its workload directory.
9
+ - Use an environment name that identifies both workload and lifecycle stage.
10
+ - Do not point `infra.path` at the consumer repository root.
11
+ - Keep Bicep and Terraform workload paths separate.
12
+ - Treat deployment execution as an APEX-governed operation, not an instruction-driven command.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer Bicep security, AVM, and repeatability guidance"
3
+ applyTo: "**/*.bicep"
4
+ ---
5
+
6
+ # APEX Bicep Rules
7
+
8
+ - Prefer Azure Verified Modules where they fit the selected design.
9
+ - Use managed identity, HTTPS, current TLS baselines, and private data access patterns.
10
+ - Derive names deterministically from the workload, environment, and approved suffix inputs.
11
+ - Keep parameters environment-specific and avoid hardcoded secrets or subscription identifiers.
12
+ - Validate generated Bicep through the APEX workflow before requesting a preview.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer code review, comments, and security boundaries"
3
+ applyTo: "**/*.{js,mjs,cjs,ts,tsx,jsx,py,ps1,sh,bicep,tf}"
4
+ ---
5
+
6
+ # APEX Code Quality
7
+
8
+ - Explain why non-obvious code exists; do not narrate obvious assignments.
9
+ - Validate inputs at boundaries and fail with precise, stable errors.
10
+ - Keep secret values out of source, logs, generated artifacts, and configuration.
11
+ - Prefer typed or structured APIs over ad hoc parsing.
12
+ - Keep changes scoped to the selected project and its declared workflow task.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer guidance context and instruction size boundaries"
3
+ applyTo: ".github/agents/**/*.agent.md, .github/skills/**/SKILL.md, .github/instructions/**/*.instructions.md"
4
+ ---
5
+
6
+ # APEX Context Boundaries
7
+
8
+ - Keep instructions focused on one consumer concern and use narrow `applyTo` globs.
9
+ - Move detailed decision knowledge into a skill reference rather than repeating it across agents.
10
+ - Read only the skills and references needed for the active project task.
11
+ - Prefer targeted edits over full rewrites when changing consumer guidance.
12
+ - Do not embed large logs, secrets, or complete chat history in managed guidance.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer documentation structure and evidence-aware writing rules"
3
+ applyTo: "docs/**/*.md, README.md, **/agent-output/**/*.md"
4
+ ---
5
+
6
+ # APEX Consumer Documentation
7
+
8
+ - Use one H1 per document and concise H2 sections for the remaining structure.
9
+ - Keep lines within 120 characters and use fenced code blocks with a language.
10
+ - Link to local, consumer-relevant files with descriptive text.
11
+ - Distinguish implemented behavior from deferred or unqualified capabilities.
12
+ - Do not claim deployment, client, provider, or compliance qualification without recorded evidence.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer governance evidence and IaC planning boundaries"
3
+ applyTo: "**/04-governance-constraints.md, **/04-governance-constraints.json, **/04-implementation-plan.md"
4
+ ---
5
+
6
+ # APEX Governance And Planning
7
+
8
+ - Treat governance constraints as evidence-bound inputs, not assumptions.
9
+ - Record unavailable policy evidence as a blocker or explicit uncertainty.
10
+ - Bind cost, resilience, security, and naming decisions to the selected project and environment.
11
+ - Keep implementation plans track-neutral until the kernel selects Bicep or Terraform generation.
12
+ - Do not query, exempt, assign, or deploy Azure resources directly from planning guidance.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer custom instruction authoring and scope rules"
3
+ applyTo: ".github/instructions/**/*.instructions.md"
4
+ ---
5
+
6
+ # APEX Instruction Authoring
7
+
8
+ - Use `description` and a narrow `applyTo` pattern in YAML frontmatter.
9
+ - Name consumer instructions with the `apex-` prefix.
10
+ - Keep instructions imperative, concise, and scoped to consumer files.
11
+ - Do not duplicate skill content, repository maintenance rules, or direct operational authority.
12
+ - State evidence and safety boundaries where guidance could otherwise be interpreted as authorization.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Consumer JavaScript and Node.js implementation guidance"
3
+ applyTo: "**/*.{js,mjs,cjs}"
4
+ ---
5
+
6
+ # APEX JavaScript Rules
7
+
8
+ - Use ESM syntax and explicit error handling.
9
+ - Keep command execution bounded, argument-based, and free of shell interpolation.
10
+ - Parse structured input with a parser and validate external data before use.
11
+ - Avoid writing consumer state outside the owning APEX MCP or CLI operation.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Consumer JSON and JSONC configuration rules"
3
+ applyTo: "**/*.{json,jsonc}"
4
+ ---
5
+
6
+ # APEX JSON Rules
7
+
8
+ - Format JSON with two-space indentation and a final newline.
9
+ - Use JSONC comments only where the consumer client supports JSONC.
10
+ - Keep configuration declarative and free of secrets, tokens, or connection strings.
11
+ - Preserve project, run, environment, and track identifiers exactly when they are contract fields.
@@ -0,0 +1,13 @@
1
+ ---
2
+ description: "Consumer Markdown formatting and evidence language rules"
3
+ applyTo: "**/*.md"
4
+ ---
5
+
6
+ # APEX Markdown Rules
7
+
8
+ - Use one H1 and structured H2 sections.
9
+ - Keep lines within 120 characters and specify languages on fenced code blocks.
10
+ - Use descriptive links and avoid feature claims that lack evidence.
11
+ - Keep generated artifact content consistent with its accepted APEX contract.
12
+ - Use accepted APEX templates before adding presentation or diagram content.
13
+ - Use `mermaid` for inline flows and `python-diagrams` for standalone `.py`, `.png`, and `.svg` artifacts.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Consumer PowerShell safety and idempotent scripting guidance"
3
+ applyTo: "**/*.{ps1,psm1}"
4
+ ---
5
+
6
+ # APEX PowerShell Rules
7
+
8
+ - Use approved cmdlets and explicit parameters.
9
+ - Keep scripts non-interactive and idempotent where possible.
10
+ - Require explicit confirmation through APEX project lifecycle prompts before destructive work.
11
+ - Do not embed credentials, tokens, or direct cloud deployment authority in scripts.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer prompt and model instruction boundaries"
3
+ applyTo: ".github/agents/**/*.agent.md, .github/prompts/**/*.prompt.md"
4
+ ---
5
+
6
+ # APEX Prompt Rules
7
+
8
+ - Use the model assigned by the managed role and do not override it redundantly.
9
+ - Keep prompts outcome-focused with explicit scope, input, output, and stop conditions.
10
+ - Keep tool lists minimal and use native client questions for user-owned decisions.
11
+ - Do not grant direct mutation, secrets, repository maintenance, or cloud lifecycle authority.
12
+ - Route workflow state changes through the declared APEX MCP operation.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Consumer Python implementation and validation guidance"
3
+ applyTo: "**/*.py"
4
+ ---
5
+
6
+ # APEX Python Rules
7
+
8
+ - Use explicit dependencies, typed boundaries, and structured parsing.
9
+ - Keep Azure and workflow state operations behind declared APEX capabilities.
10
+ - Validate external input and produce concise, actionable errors.
11
+ - Do not embed secrets, credentials, or direct deployment commands.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Consumer safe file editing and generated artifact boundaries"
3
+ applyTo: "**/*.{js,mjs,cjs,ts,tsx,jsx,py,ps1,sh,bicep,tf}"
4
+ ---
5
+
6
+ # APEX Safe File Edits
7
+
8
+ - Use the client file-editing capability for source changes; do not create files through shell redirection.
9
+ - Do not use heredocs, `tee`, or inline interpreters to write project code or artifacts.
10
+ - Write accepted workflow outputs only through the owning APEX MCP operation.
11
+ - Keep generated files inside the selected project and run boundaries.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Consumer shell safety and non-interactive command rules"
3
+ applyTo: ".github/agents/**/*.agent.md, .github/prompts/**/*.prompt.md, .github/skills/**/SKILL.md"
4
+ ---
5
+
6
+ # APEX Shell Safety
7
+
8
+ - Use non-interactive commands only; do not use confirmation flags or prompt-driven shell builtins.
9
+ - Keep command output bounded and summarize results instead of replaying large logs.
10
+ - Do not request, print, store, or pass secrets through chat or command arguments.
11
+ - Use explicit paths and arguments; avoid shell interpolation for consumer workflow operations.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Consumer shell script structure and safety guidance"
3
+ applyTo: "**/*.sh"
4
+ ---
5
+
6
+ # APEX Shell Rules
7
+
8
+ - Use `set -euo pipefail` when compatible with the script's contract.
9
+ - Validate arguments and quote variable expansions.
10
+ - Use structured tools for JSON instead of string parsing.
11
+ - Keep scripts non-interactive and do not embed secrets or direct cloud lifecycle commands.
@@ -0,0 +1,13 @@
1
+ ---
2
+ description: "Consumer skill authoring and progressive disclosure rules"
3
+ applyTo: ".github/skills/**/SKILL.md"
4
+ ---
5
+
6
+ # APEX Skill Authoring
7
+
8
+ - State the supported decision or workflow outcome in the skill description.
9
+ - Keep the main skill concise and place detailed guidance in `references/` files.
10
+ - Describe prerequisites and evidence boundaries before operational guidance.
11
+ - Do not grant new MCP tools, shell access, state mutation, deployment, or secret handling.
12
+ - Route state changes through the owning APEX MCP operation.
13
+ - Keep examples decision-oriented; do not claim live Azure facts without current evidence.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer Terraform security, provider, and repeatability guidance"
3
+ applyTo: "**/*.tf"
4
+ ---
5
+
6
+ # APEX Terraform Rules
7
+
8
+ - Prefer Azure Verified Modules and explicit provider constraints.
9
+ - Keep backend, provider, and environment inputs separate from generated resource intent.
10
+ - Use managed identity and Entra-based access patterns instead of shared keys or secrets.
11
+ - Derive names from approved workload and environment inputs.
12
+ - Validate the exact generated configuration and lock state through the APEX workflow before preview.
@@ -16,6 +16,14 @@
16
16
  "headers": {
17
17
  "x-mcp-toolset": "CostManagement,Pricing"
18
18
  }
19
+ },
20
+ "azure-mcp-server": {
21
+ "type": "stdio",
22
+ "command": "node",
23
+ "args": [
24
+ "${workspaceFolder}/node_modules/@apexops/cli/dist/azure-mcp.js"
25
+ ],
26
+ "cwd": "${workspaceFolder}"
19
27
  }
20
28
  }
21
29
  }
@@ -1,31 +1,31 @@
1
1
  {
2
2
  "schemaVersion": "1.0.0",
3
- "bundleVersion": "0.10.0-next.0",
3
+ "bundleVersion": "0.10.0-next.1",
4
4
  "capabilityProtocolVersion": "1.0.0",
5
5
  "components": {
6
6
  "cli": {
7
7
  "source": "local",
8
- "version": "0.10.0-next.0"
8
+ "version": "0.10.0-next.1"
9
9
  },
10
10
  "contracts": {
11
11
  "source": "local",
12
- "version": "0.10.0-next.0"
12
+ "version": "0.10.0-next.1"
13
13
  },
14
14
  "kernel": {
15
15
  "source": "local",
16
- "version": "0.10.0-next.0"
16
+ "version": "0.10.0-next.1"
17
17
  },
18
18
  "capabilities": {
19
19
  "source": "local",
20
- "version": "0.10.0-next.0"
20
+ "version": "0.10.0-next.1"
21
21
  },
22
22
  "renderers": {
23
23
  "source": "local",
24
- "version": "0.10.0-next.0"
24
+ "version": "0.10.0-next.1"
25
25
  },
26
26
  "customizationBundle": {
27
27
  "source": "local",
28
- "version": "0.10.0-next.0",
28
+ "version": "0.10.0-next.1",
29
29
  "manifest": "@apexops/cli/assets/customizations/manifest.json",
30
30
  "assetManifest": "@apexops/cli/assets/manifest.json",
31
31
  "compositionId": "apex-managed-workspace"