ontoref/assets/work-group-ore/README.md

34 lines
1.3 KiB
Markdown
Raw Normal View History

feat: #[onto_mcp_tool] catalog, OCI credential vault layer, validate ADR-018 mode hierarchy ontoref-derive: #[onto_mcp_tool] attribute macro registers MCP tool unit-structs in the catalog at link time via inventory::submit!; annotated item is emitted unchanged, ToolBase/AsyncTool impls stay on the struct. All 34 tools migrated from manual wiring (net +5: ontoref_list_projects, ontoref_search, ontoref_describe, ontoref_list_ontology_extensions, ontoref_get_ontology_extension). validate modes (ADR-018): reads level_hierarchy from workflow.ncl and checks every .ncl mode for level declared, strategy declared, delegate chain coherent, compose extends valid. mode resolve <id> shows which hierarchy level handles a mode and why. --self-test generates synthetic fixtures in a temp dir for CI smoke-testing. validate run-cargo: two-step Cargo.toml resolution — workspace layout first (crates/<check.crate>/Cargo.toml), single-crate fallback by package name or repo basename. Lets the same ADR constraint shape apply to workspace and single-crate repos. ontology/schemas/manifest.ncl: registry_topology_type contract — multi-registry coordination, push targets, participant scopes, per-namespace capability. reflection/requirements/base.ncl: oras ≥1.2.0, cosign ≥2.0.0, sops ≥3.9.0, age ≥1.1.0, restic declared as Hard/Soft requirements with version_min, check_cmd, and install_hint (ADR-017 toolchain surface). ADR-019: per-file recipient routing for tenant isolation without multi-vault. Schema additions: sops.recipient_groups + sops.recipient_rules in ontoref-project.ncl. secrets-bootstrap generates .sops.yaml from project.ncl in declarative mode. Three new secrets-audit checks: recipient-routing-coherent, recipient-routing-coverage, no-multi-vault. Adoption templates: single-team/, multi-tenant/, agent-first/. Integration templates: domain-producer/, mode-producer/, mode-consumer/. UI: project_picker surfaces registry badge (⟳ participant) and vault badge (⛁ vault_id · N, green=declarative / amber=legacy) per project card. Expanded panel adds collapsible Registry section with namespace, endpoint, and push/pull capability. manage.html gains Runtime Services card — MCP and GraphQL toggleable without restart via HTMX POST /ui/manage/services/{service}/toggle. describe.nu: capabilities JSON includes registry_topology and vault_state per project. sync.nu: drift check extended to detect //! absence on newly registered crates. qa.ncl: six entries — credential-vault-best-practice (layered data-flow diagram), credential-vault-templates (paths A/B/C), credential-vault-troubleshooting (15 named errors), integration-what-and-why (ADR-042 OCI federation), integration-how-to-implement, integration-troubleshooting. on+re: core.ncl + manifest.ncl updated to reflect OCI, MCP, and mode-hierarchy nodes. Deleted stale presentation assets (2026-02 slides + voice notes).
2026-05-12 04:46:15 +01:00
# Working Group OntoRef — Material de Apoyo
Material para la sesión de presentación + arranque del Working Group local
(Rust-LasPalmas) sobre Ontología y Reflection.
## Estructura
```text
work-group-ore/
├── README.md Este archivo
├── setup.md Guía de instalación para participantes
└── demo/
├── README.md Cómo correr las demos
├── script.md Guion timing-by-timing de la mini-demo
├── option-a-owner/ Demo principal: owner por servicio
├── option-b-layers/ Demo alternativa: capas sin acople
└── recording/ Plan B — asciinema pre-grabada
```
## Slides asociadas
`../presentation/work_group_info.md` — sesión de presentación en Slidev.
## Flujo recomendado
1. **Antes de la sesión presentación**: ensayar la demo en vivo con
`demo/option-a-owner/` siguiendo `demo/script.md`. Grabar la versión asciinema
como Plan B (`demo/recording/record.sh`).
2. **Durante la sesión presentación**: usar las slides + cambiar a terminal en
la slide-anchor "Demo en vivo".
3. **Tras la sesión presentación**: enviar `setup.md` a quienes se apuntaron.
4. **Sesión 0 del WG**: cada participante llega con setup completo y un
proyecto suyo identificado.