@apexops/cli 0.10.0-next.0

package/assets/customizations/README.md

@@ -0,0 +1,22 @@
+## Managed Workspace Source
+
+This directory is the versioned source bundle installed into consumer repositories by `apex init` and updated by
+`apex update`. Its payload uses supported workspace discovery paths:
+
+- `.github/agents/`
+- `.github/skills/`
+- `.github/copilot-instructions.md`
+- `.vscode/mcp.json`
+
+`manifest.json` records the bundle version, managed files, agent roles, supported targets, invocation edges, interaction
+types, recommended models, and cost tiers. A client projection omits roles that do not declare its target; unsupported
+roles are never installed or added to the managed lock.
+
+## Editing Policy
+
+Make source changes in this directory and release them as a new bundle version. Consumer copies are managed files; do
+not edit them manually. The installer records base and current hashes so update can preserve user changes with a
+three-way merge or stop with an actionable conflict instead of silently overwriting them.
+
+The prompts are guidance, not an authorization boundary. The APEX kernel and its narrow MCP tools remain authoritative
+for state transitions, validation, approvals, and external operations.

package/assets/customizations/manifest.json

@@ -0,0 +1,251 @@
+{
+  "version": "0.10.0-next.0",
+  "bundle": {
+    "id": "apex-managed-workspace",
+    "authority": "npm:@apexops/cli",
+    "composition": "copy-tree",
+    "sourceRoot": "customizations",
+    "generatedRoot": "customizations"
+  },
+  "managedFiles": [
+    ".github/agents/apex.agent.md",
+    ".github/agents/apex-requirements.agent.md",
+    ".github/agents/apex-architect.agent.md",
+    ".github/agents/apex-planner.agent.md",
+    ".github/agents/apex-operator.agent.md",
+    ".github/agents/apex-codegen.agent.md",
+    ".github/agents/apex-reviewer.agent.md",
+    ".github/agents/apex-validator.agent.md",
+    ".github/skills/apex-workflow/SKILL.md",
+    ".github/skills/apex-requirements/SKILL.md",
+    ".github/skills/apex-architecture/SKILL.md",
+    ".github/skills/apex-planning/SKILL.md",
+    ".github/skills/apex-codegen/SKILL.md",
+    ".github/skills/apex-operations/SKILL.md",
+    ".github/skills/apex-artifacts/SKILL.md",
+    ".github/skills/apex-azure-defaults/SKILL.md",
+    ".github/skills/apex-azure-defaults/references/baseline-fallbacks.md",
+    ".github/skills/apex-azure-defaults/references/naming.md",
+    ".github/skills/apex-azure-defaults/references/tag-precedence.md",
+    ".github/skills/apex-azure-defaults/references/security-baseline.md",
+    ".github/skills/apex-azure-defaults/references/avm-binding-guidance.md",
+    ".github/skills/apex-azure-defaults/references/service-selection.md",
+    ".github/skills/apex-azure-defaults/references/governance-effects.md",
+    ".github/skills/apex-azure-defaults/references/network-planning.md",
+    ".github/skills/apex-azure-defaults/references/cost-monitoring.md",
+    ".github/skills/apex-azure-defaults/references/decision-boundaries.md",
+    ".github/skills/apex-azure-adr/SKILL.md",
+    ".github/skills/apex-azure-adr/references/decision-record-fields.md",
+    ".github/skills/apex-azure-adr/references/decision-quality.md",
+    ".github/skills/apex-azure-adr/references/decision-guardrails.md",
+    ".github/skills/apex-azure-adr/references/decision-examples.md",
+    ".github/skills/apex-azure-rbac/SKILL.md",
+    ".github/skills/apex-azure-rbac/references/least-privilege-selection.md",
+    ".github/skills/apex-azure-rbac/references/assignment-intent.md",
+    ".github/skills/apex-microsoft-docs/SKILL.md",
+    ".github/skills/apex-microsoft-docs/references/research-method.md",
+    ".github/skills/apex-azure-compute/SKILL.md",
+    ".github/skills/apex-azure-compute/references/compute-selection.md",
+    ".github/skills/apex-azure-compute/references/pricing-evidence.md",
+    ".github/skills/apex-azure-compute/references/recommendation-and-scale-rules.md",
+    ".github/skills/apex-azure-storage/SKILL.md",
+    ".github/skills/apex-azure-storage/references/storage-selection.md",
+    ".github/skills/apex-azure-storage/references/security-and-governance.md",
+    ".github/skills/apex-azure-storage/references/service-auth-and-sdk-boundary.md",
+    ".github/skills/apex-bicep-patterns/SKILL.md",
+    ".github/skills/apex-bicep-patterns/references/network-and-observability.md",
+    ".github/skills/apex-bicep-patterns/references/avm-and-codegen-acceptance.md",
+    ".github/skills/apex-bicep-patterns/references/module-interfaces-and-parameters.md",
+    ".github/skills/apex-bicep-patterns/references/compiler-and-provider-gotchas.md",
+    ".github/skills/apex-bicep-patterns/references/codegen-acceptance-checklist.md",
+    ".github/skills/apex-azure-prepare/SKILL.md",
+    ".github/skills/apex-azure-prepare/references/preparation-lineage.md",
+    ".github/skills/apex-azure-prepare/references/functions-recipe-pack.md",
+    ".github/skills/apex-azure-validate/SKILL.md",
+    ".github/skills/apex-azure-validate/references/preflight-evidence.md",
+    ".github/skills/apex-azure-validate/references/operational-checklist.md",
+    ".github/skills/apex-azure-deploy/SKILL.md",
+    ".github/skills/apex-azure-deploy/references/preview-recovery-verification.md",
+    ".github/skills/apex-azure-deploy/references/operational-checklist.md",
+    ".github/skills/apex-azure-governance/SKILL.md",
+    ".github/skills/apex-azure-governance/references/evidence-interpretation.md",
+    ".github/skills/apex-azure-governance/references/operational-checklist.md",
+    ".github/skills/apex-azure-quotas/SKILL.md",
+    ".github/skills/apex-azure-quotas/references/capacity-decision-rules.md",
+    ".github/skills/apex-azure-quotas/references/operational-checklist.md",
+    ".github/skills/apex-azure-resources/SKILL.md",
+    ".github/skills/apex-azure-resources/references/inventory-query-patterns.md",
+    ".github/skills/apex-azure-resources/references/operational-checklist.md",
+    ".github/skills/apex-azure-cost-optimization/SKILL.md",
+    ".github/skills/apex-azure-cost-optimization/references/cost-assessment-criteria.md",
+    ".github/skills/apex-azure-cost-optimization/references/operational-checklist.md",
+    ".github/skills/apex-azure-compliance/SKILL.md",
+    ".github/skills/apex-azure-compliance/references/compliance-finding-criteria.md",
+    ".github/skills/apex-azure-compliance/references/operational-checklist.md",
+    ".github/skills/apex-azure-diagnostics/SKILL.md",
+    ".github/skills/apex-azure-diagnostics/references/diagnostic-interpretation.md",
+    ".github/skills/apex-azure-diagnostics/references/operational-checklist.md",
+    ".github/skills/apex-azure-kusto/SKILL.md",
+    ".github/skills/apex-azure-kusto/references/kql-evidence-interpretation.md",
+    ".github/skills/apex-azure-kusto/references/operational-checklist.md",
+    ".github/skills/apex-entra-app-registration/SKILL.md",
+    ".github/skills/apex-entra-app-registration/references/oauth-registration-model.md",
+    ".github/skills/apex-entra-app-registration/references/permissions-and-credentials.md",
+    ".github/skills/apex-entra-app-registration/references/capability-receipts.md",
+    ".github/skills/apex-entra-app-registration/references/design-and-diagnostics.md",
+    ".github/skills/apex-azure-cloud-migrate/SKILL.md",
+    ".github/skills/apex-azure-cloud-migrate/references/migration-readiness.md",
+    ".github/skills/apex-azure-cloud-migrate/references/workload-mapping.md",
+    ".github/skills/apex-azure-cloud-migrate/references/staged-validation-handoff.md",
+    ".github/skills/apex-azure-cloud-migrate/references/lambda-to-functions-assessment.md",
+    ".github/skills/apex-terraform-patterns/SKILL.md",
+    ".github/skills/apex-terraform-patterns/references/network-and-observability.md",
+    ".github/skills/apex-terraform-patterns/references/module-composition-and-state-boundaries.md",
+    ".github/skills/apex-terraform-patterns/references/module-locks-and-codegen-acceptance.md",
+    ".github/skills/apex-terraform-patterns/references/module-composition-and-refactor.md",
+    ".github/skills/apex-terraform-patterns/references/plan-and-change-assessment.md",
+    ".github/skills/apex-terraform-test/SKILL.md",
+    ".github/skills/apex-terraform-test/references/test-design.md",
+    ".github/skills/apex-terraform-test/references/plan-mode-and-mock-design.md",
+    ".github/skills/apex-terraform-test/references/evidence-acceptance.md",
+    ".github/skills/apex-terraform-test/references/plan-mode-test-design.md",
+    ".github/skills/apex-terraform-import/SKILL.md",
+    ".github/skills/apex-terraform-import/references/import-assessment.md",
+    ".github/skills/apex-terraform-import/references/mapping-and-adoption-attestation.md",
+    ".github/skills/apex-terraform-import/references/adoption-attestation.md",
+    ".github/skills/apex-terraform-import/references/import-mapping.md",
+    ".github/skills/apex-mermaid/SKILL.md",
+    ".github/skills/apex-mermaid/references/syntax.md",
+    ".github/skills/apex-mermaid/references/styling.md",
+    ".github/skills/apex-artifacts/references/presentation-conventions.md",
+    ".github/skills/apex-artifacts/references/reference-only-outlines.md",
+    ".github/skills/apex-artifacts/templates/requirements.md",
+    ".github/skills/apex-artifacts/templates/architecture-assessment.md",
+    ".github/skills/apex-artifacts/templates/cost-estimate.md",
+    ".github/skills/apex-artifacts/templates/governance-constraints.md",
+    ".github/skills/apex-artifacts/templates/implementation-plan.md",
+    ".github/skills/apex-artifacts/templates/deployment-summary.md",
+    ".github/skills/apex-artifacts/templates/operations-runbook.md",
+    ".github/skills/apex-artifacts/templates/resource-inventory.md",
+    ".github/copilot-instructions.md",
+    ".github/mcp.json",
+    ".vscode/mcp.json"
+  ],
+  "sharedFiles": [
+    ".github/copilot-instructions.md"
+  ],
+  "sharedDirectories": [".github/skills"],
+  "clientProjections": [
+    {
+      "id": "github-copilot-vscode",
+      "generatedRoot": "client-projections/github-copilot-vscode",
+      "files": [".vscode/mcp.json"]
+    },
+    {
+      "id": "github-copilot-cli",
+      "generatedRoot": "client-projections/github-copilot-cli",
+      "files": [".github/mcp.json"]
+    }
+  ],
+  "roles": [
+    {
+      "id": "coordinator",
+      "source": ".github/agents/apex.agent.md",
+      "agent": "APEX",
+      "role": "coordinator",
+      "supportedTargets": ["vscode", "github-copilot"],
+      "interactionType": "interactive-handoff",
+      "model": "MAI-Code-1-Flash",
+      "costTier": "fast"
+    },
+    {
+      "id": "requirements",
+      "source": ".github/agents/apex-requirements.agent.md",
+      "agent": "APEX Requirements",
+      "role": "requirements",
+      "supportedTargets": ["vscode", "github-copilot"],
+      "interactionType": "interactive-handoff",
+      "model": "Claude Sonnet 5",
+      "costTier": "standard"
+    },
+    {
+      "id": "architecture",
+      "source": ".github/agents/apex-architect.agent.md",
+      "agent": "APEX Architect",
+      "role": "architecture",
+      "supportedTargets": ["vscode", "github-copilot"],
+      "interactionType": "interactive-handoff",
+      "model": "Claude Opus 4.8",
+      "costTier": "premium"
+    },
+    {
+      "id": "planning",
+      "source": ".github/agents/apex-planner.agent.md",
+      "agent": "APEX Planner",
+      "role": "planning",
+      "supportedTargets": ["vscode", "github-copilot"],
+      "interactionType": "interactive-handoff",
+      "model": "Claude Opus 4.8",
+      "costTier": "premium"
+    },
+    {
+      "id": "operations",
+      "source": ".github/agents/apex-operator.agent.md",
+      "agent": "APEX Operator",
+      "role": "operations",
+      "supportedTargets": ["vscode", "github-copilot"],
+      "interactionType": "interactive-handoff",
+      "model": "GPT-5.5",
+      "costTier": "premium"
+    },
+    {
+      "id": "code-generation",
+      "source": ".github/agents/apex-codegen.agent.md",
+      "agent": "APEX CodeGen",
+      "role": "code-generation",
+      "supportedTargets": ["vscode"],
+      "interactionType": "autonomous-subagent",
+      "model": "Claude Sonnet 5",
+      "costTier": "standard"
+    },
+    {
+      "id": "review",
+      "source": ".github/agents/apex-reviewer.agent.md",
+      "agent": "APEX Reviewer",
+      "role": "review",
+      "supportedTargets": ["vscode"],
+      "interactionType": "autonomous-subagent",
+      "model": "Claude Sonnet 5",
+      "costTier": "standard"
+    },
+    {
+      "id": "validation",
+      "source": ".github/agents/apex-validator.agent.md",
+      "agent": "APEX Validator",
+      "role": "validation",
+      "supportedTargets": ["vscode"],
+      "interactionType": "autonomous-subagent",
+      "model": "Claude Sonnet 5",
+      "costTier": "standard"
+    }
+  ],
+  "invocationEdges": [
+    { "from": "APEX", "to": "APEX Requirements", "type": "handoff" },
+    { "from": "APEX", "to": "APEX Architect", "type": "handoff" },
+    { "from": "APEX", "to": "APEX Planner", "type": "handoff" },
+    { "from": "APEX", "to": "APEX Operator", "type": "handoff" },
+    { "from": "APEX Requirements", "to": "APEX Architect", "type": "handoff" },
+    { "from": "APEX Architect", "to": "APEX Planner", "type": "handoff" },
+    { "from": "APEX Planner", "to": "APEX Operator", "type": "handoff" },
+    { "from": "APEX Requirements", "to": "APEX Reviewer", "type": "subagent" },
+    { "from": "APEX Requirements", "to": "APEX Validator", "type": "subagent" },
+    { "from": "APEX Architect", "to": "APEX Reviewer", "type": "subagent" },
+    { "from": "APEX Architect", "to": "APEX Validator", "type": "subagent" },
+    { "from": "APEX Planner", "to": "APEX CodeGen", "type": "subagent" },
+    { "from": "APEX Planner", "to": "APEX Reviewer", "type": "subagent" },
+    { "from": "APEX Planner", "to": "APEX Validator", "type": "subagent" },
+    { "from": "APEX Operator", "to": "APEX Reviewer", "type": "subagent" },
+    { "from": "APEX Operator", "to": "APEX Validator", "type": "subagent" },
+    { "from": "APEX CodeGen", "to": "APEX Validator", "type": "subagent" }
+  ]
+}