82a358f18d
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).
58 lines
2.6 KiB
Text
58 lines
2.6 KiB
Text
let d = import "core.ncl" in
|
|
|
|
{
|
|
lift_out_practice = d.make_node {
|
|
id = "lift-out-practice",
|
|
name = "Component Lift-Out",
|
|
pole = 'Yang,
|
|
level = 'Practice,
|
|
description = "A component developed inside a host project is extracted as an independent peer project when it passes the four-criterion test: orthogonal concern, plurality of consumers, divergent release cadence, and path-agnostic config. The extracted project registers in ontoref before any code moves.",
|
|
adrs = ["adr-016-component-lift-out-pattern"],
|
|
},
|
|
|
|
lift_readiness_practice = d.make_node {
|
|
id = "lift-readiness",
|
|
name = "Lift Readiness Evaluation",
|
|
pole = 'Spiral,
|
|
level = 'Practice,
|
|
description = "Before extracting a component, four criteria are evaluated: (1) orthogonal concern — the component's domain is not the host's domain; (2) consumer plurality — at least two distinct callers exist or are imminent; (3) release cadence divergence — the component's lifecycle does not match the host's; (4) config path-agnostic — the component can receive its config from any caller without importing host infrastructure.",
|
|
adrs = ["adr-016-component-lift-out-pattern"],
|
|
},
|
|
|
|
premature_decomposition_tension = d.make_node {
|
|
id = "premature-decomposition",
|
|
name = "Premature Decomposition Tension",
|
|
pole = 'Yin,
|
|
level = 'Tension,
|
|
description = "Extracting a component before it has proven orthogonality and multiple consumers creates coordination overhead without autonomy benefits. The four-criterion gate is the safeguard.",
|
|
},
|
|
|
|
host_coupling_tension = d.make_node {
|
|
id = "host-coupling",
|
|
name = "Host Coupling Tension",
|
|
pole = 'Yin,
|
|
level = 'Tension,
|
|
description = "A component that imports host-project infrastructure (config loaders, schema registries, workspace crates) cannot be an independent peer. Host coupling is the primary blocker for lift-out and must be severed at extraction time.",
|
|
},
|
|
|
|
edges = [
|
|
d.make_edge {
|
|
from = "lift-readiness",
|
|
to = "lift-out-practice",
|
|
kind = 'FlowsTo,
|
|
note = "readiness evaluation gates the extraction decision",
|
|
},
|
|
d.make_edge {
|
|
from = "premature-decomposition",
|
|
to = "lift-out-practice",
|
|
kind = 'TensionWith,
|
|
note = "extracting too early defeats the purpose",
|
|
},
|
|
d.make_edge {
|
|
from = "host-coupling",
|
|
to = "lift-readiness",
|
|
kind = 'LimitedBy,
|
|
note = "coupling to host infrastructure fails criterion 4",
|
|
},
|
|
],
|
|
}
|