cto/manifest.yaml
Svrnty 10f919746e feat(cto): v1.0 MVP — executable orchestrator + cto-worker.sh helper
skills/cto-agent/SKILL.md: bumped 0.1.0 → 1.0.0; drop "v0.1 stub" banner;
operating loop now concrete (no more "v1.0 will…"); add explicit kanban
worker contract (kanban_complete | kanban_block required at task end —
fixes the protocol-violation noise observed in CTO validation testing).
Routing table updated: Python → cto-python-toolkit, Angular →
cto-angular-toolkit (the dedicated stack skills built earlier).
Added sot/-spec frontmatter fields (tier T2, status active, owner, source,
last_reviewed) per PROFILE-DISTRIBUTION-PROTOCOL §2.1.

lib/cto-worker.sh: orchestrator helper. 3 commands:
  - sandcastle <work-id> <target> <prompt> [provider] → invoke sandcastle
    via npx tsx + claudeCode + docker (default). Blocks reads against
    read-only siblings (hermes-agent, hermes-webui, marketingskills,
    sandcastle).
  - open-pr <work-id> <target> <title> <body> → resolves github-pat via
    credbridge (never in argv), pushes branch, creates PR. Returns URL.
  - emit-5w <work-id> <status> <summary> → prints 5W block (stdout
    captured by Hermes into kanban completion).

install.sh: invokes `hermes profile install --yes --force` for dispatch
readiness; chmod +x cto-worker.sh; drops v0.1 scaffold messages; sandcastle
sibling now REQUIRED (was just a WARN). Adds matching DRY echoes.

manifest.yaml + distribution.yaml: version 0.1.0 → 1.0.0; distribution_owned
adds lib/.

README.md: status v0.1 scaffold → v1.0 MVP; layout reflects 3 skills + lib/;
roadmap table refactored (v1.0 current / v1.1 next / v2 deferred).

Verified: hermes profile install → "✓ Installed 'cto-planb' v1.0.0".

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-24 13:02:10 -04:00

137 lines
6.3 KiB
YAML

# CTO profile distribution manifest — machine-readable identity + install contract.
# Read by install.sh. Convention shared by all Hermes profile distributions
# (see ../sot/03-PROTOCOLS/PROFILE-DISTRIBUTION-PROTOCOL.md — the canonical protocol).
profile: cto-planb # Hermes profile name (org-scoped); see also distribution.yaml → name
kind: profile-distribution # family marker; CTO = third C-suite profile (after CMO + CEO)
role: cto # function; same skill bundle could deploy as cto-<other-org>
org: planb # org scope — this profile serves Plan B
version: 1.0.0 # MVP — executable cto-agent skill + cto-worker.sh helper + 2 toolkit skills
identity: AGENT.md # WHO (role, mission, boundaries)
contract: CONTRACT.md # behavior contract — tier T1 (this file wins)
# Governance — org / owner / vision / rules linked to SOT (PROFILE-DISTRIBUTION-PROTOCOL §2.2).
governance:
org: planb
owner: jp
approval_authority: jp
vision_refs:
- ../sot/01-ROADMAP/CORTEX-OS-ROADMAP.md
- ../sot/02-FRAMEWORK/CORTEX-OS-FRAMEWORK.md
governing_protocols:
- ../sot/03-PROTOCOLS/PROFILE-DISTRIBUTION-PROTOCOL.md
standards:
- ../sot/04-STANDARDS/FRONTMATTER-SPEC.md
- ../sot/04-STANDARDS/SOT-ENFORCEMENT.md
brand_master_ref: ../sot/07-BRAND/PLANB-BRAND-SYNTHESIS.md
north_star: "reliable, evolving tech — sandcastle-orchestrated code work, JP-approved deploys, never bypass isolation"
skills: # exposed to Hermes via skills.external_dirs (→ <repo>/skills)
- skills/cto-agent # orchestrator (loop operator)
- skills/cto-python-toolkit # Python stack patterns (closes Python gap — inline until cortex/ lib extracted)
- skills/cto-angular-toolkit # Angular stack patterns (closes Angular gap — anchored to adwright-console)
# Role tools = scripts at repo root (the "lib"), reached through credbridge.
lib:
- credbridge.sh # credctl → env → CLI (secrets never logged)
# External read-only siblings + cortex/ tooling consumed by this profile.
# Stacks: typescript (sandcastle), dotnet (CQRS), dart (Flutter/gRPC), go (libs+QA), rust (runtime), multi (gates/bash/cortex).
# Python + Angular have no specific cortex/ tooling yet — CTO handles them via sandcastle generic Claude Code path.
external_tool_deps:
# Agent orchestration (external — Matt Pocock, MIT)
- repo: sandcastle
path: ../sandcastle
stack: typescript
pin: v0.5.11
role: sandboxed agent orchestrator for code-modifying work (Docker/Podman/Vercel)
registry: ../sot/06-REGISTRY/EXTERNAL-REFS/SANDCASTLE.md
# .NET / C# (Plan B's primary backend stack)
- repo: L6-svrnty.lib-dotnet-cqrs
path: ../../cortex/L6-svrnty.lib-dotnet-cqrs
stack: dotnet
role: CQRS framework (.NET 10, 21 projects, gRPC source-gen, FluentValidation, Minimal API)
- repo: L5-svrnty.tool-cqrs-plugin
path: ../../cortex/L5-svrnty.tool-cqrs-plugin
stack: dotnet
role: Claude Code plugin for CQRS/gRPC scaffolding + validation patterns
- repo: pi-bte-plugin
path: ../../cortex/pi-bte-plugin
stack: dotnet+design
role: Pi plugin — DTCG validation, voice schema lint, DESIGN.md export, contrast check, .NET 10 build verification
# Dart / Flutter (mobile + desktop client stack)
- repo: L6-svrnty.lib-cqrs-datasource
path: ../../cortex/L6-svrnty.lib-cqrs-datasource
stack: dart
pin: v1.0.1
role: gRPC client bridging Flutter apps to .NET CQRS backends (auto proto gen)
# Go (sovereign core stack — runtime, creds, memory, QA)
- repo: L6-svrnty.lib-llm
path: ../../cortex/L6-svrnty.lib-llm
stack: go
role: multi-provider LLM interface (Ollama/Claude/OpenAI/Gemini) + A/B harness
- repo: L6-svrnty.core-credentials
path: ../../cortex/L6-svrnty.core-credentials
stack: go
role: encrypted credential store (AES-256-GCM) — credctl backend
- repo: L6-svrnty.core-memory
path: ../../cortex/L6-svrnty.core-memory
stack: go
role: long-term memory + semantic search (ONNX embeddings) for agent fleet
- repo: PG-svrnty.tool-qa
path: ../../cortex/PG-svrnty.tool-qa
stack: go
role: QA orchestrator — YAML-defined test scenarios for zeroclaw/voice/gRPC services
# Rust (zero-overhead runtime layer)
- repo: L6-svrnty.core-runtime
path: ../../cortex/L6-svrnty.core-runtime
stack: rust
pin: v0.1.7
role: agent runtime (5MB RAM target, Rust/Tokio) — zeroclaw CLI
# Multi-stack utility
- repo: PG-svrnty.lib-quality-gates
path: ../../cortex/PG-svrnty.lib-quality-gates
stack: multi
role: 48 portable quality gates across Go/Rust/Dart/Python/C#/Docker/Proto (Bash 4+)
- repo: L5-svrnty.lib-skills-engineering
path: ../../cortex/L5-svrnty.lib-skills-engineering
stack: multi
role: 28 engineering patterns — CQRS, gRPC, Flutter design, saga, events, error handling
- repo: L5-svrnty.tool-bash-plugin
path: ../../cortex/L5-svrnty.tool-bash-plugin
stack: bash
role: Bash script engineering plugin (9 categories — init/gate/hook/cron/probe/seal/deploy/test/orchestrate)
- repo: PC-svrnty.tool-cortex-plugin
path: ../../cortex/PC-svrnty.tool-cortex-plugin
stack: cortex-os
role: Cortex sovereign OS installer — identity/sectors/detection/activation bootstrap
# Stacks NOT yet covered by dedicated cortex/ tooling:
# - Python: handled via sandcastle generic Claude Code path; no Python framework lib
# - Angular: handled via sandcastle generic Claude Code path; no Angular framework lib
# CTO declares these gaps in CONTRACT.md §6 (Tech stacks supported).
requires_tools: [terminal, memory_tool]
db:
file: cto.db # runtime state; created from schema.sql; never committed
schema: schema.sql
cron: [] # no cron at launch — CTO runs on-demand or on kanban tick
config: # portable per-install settings
- key: github_org
prompt: GitHub org for code work (e.g., svrnty)
default: "svrnty"
- key: default_sandcastle_provider
prompt: Default sandcastle sandbox provider (docker|podman|vercel|noSandbox)
default: "docker"
credentials: # provisioned via `credctl set <name>` — never shipped
required: [] # v1 has no required creds (no deploy/cloud yet)
optional: [github-pat] # for opening PRs via gh CLI when CTO ships v2