6721daf440
Adds a declarative workflow system where .ontology/workflow.ncl declares
independent layers (commit-fast, ci-standard, ci-exhaustive), each with a
trigger and a set of providers. The generator materialises Woodpecker YAML,
justfile recipes, and pre-commit hook stubs from that single declaration.
Layers form a set, not a chain — no layer depends on another at the
declaration level. Woodpecker steps express fine-grained parallelism
internally (lint → test/docs/build).
Schema and catalog:
- reflection/schemas/workflow.ncl — types, contracts, provider constructors
- reflection/defaults/workflow.ncl — standard Rust/Nushell/Nickel catalog
(14 validations, 4 builds)
Generator (ore workflow generate):
- PreCommit: prints hook fragments for manual merge into .pre-commit-config.yaml
- Woodpecker: writes per-layer YAML with image selection, tool installs,
depends_on chains, and CI-aware command translation
(nu --ide-check → find+xargs; markdownlint-cli2 → node:lts image)
- Justfile: single justfiles/workflow.just aggregated from all Justfile layers
(hoisted out of per-provider loop — was writing N times, now once)
Dispatcher: ore workflow validate|list|generate|diff + ore wf v|l|gen|diff
Cargo/nextest profiles:
- .cargo/config.toml: [profile.ci-test] (debug=0, no-incremental) and
[profile.ci] (line-tables-only) — shared by test + docs hooks to reuse
.rlib artifacts; CI retains actionable backtraces
- .config/nextest.toml: ci-test (fail-fast, no retries) and ci (all failures,
one retry)
Pre-commit: nextest run with --profile ci-test --cargo-profile ci-test;
docs-links hook shares same profile to reuse artifacts
Self-application: ontoref declares its own workflow in .ontology/workflow.ncl
and the generated .woodpecker/ files are the authoritative CI definition
Migration 0014: checks workflow.ncl + both cargo and nextest profiles present
Adoption: reflection/templates/ontology/workflow.ncl stub + install_workflow
confirm in adopt_ontoref form + step 5 in adoption script template
57 lines
2.4 KiB
Text
57 lines
2.4 KiB
Text
{
|
|
id = "0014",
|
|
slug = "workflow-layer-model",
|
|
description = "Workflow layer model: .ontology/workflow.ncl declares independent CI/build/distribution layers. Cargo profiles ci-test (pre-commit, debug=0) and ci (CI pipeline, line-tables-only) must exist. Nextest profiles ci-test and ci must exist. Generator: ore workflow generate.",
|
|
check = {
|
|
tag = "NuCmd",
|
|
cmd = "let root = ($env.ONTOREF_PROJECT_ROOT? | default ($env.ONTOREF_ROOT? | default (pwd | path expand))); let wf = $\"($root)/.ontology/workflow.ncl\"; if not ($wf | path exists) { exit 1 }; let cargo_cfg = $\"($root)/.cargo/config.toml\"; if not ($cargo_cfg | path exists) { exit 1 }; let cargo_txt = (open --raw $cargo_cfg); let has_ci_test = ($cargo_txt | str contains \"[profile.ci-test]\"); let has_ci = ($cargo_txt | str contains \"[profile.ci]\"); let nextest_cfg = $\"($root)/.config/nextest.toml\"; if not ($nextest_cfg | path exists) { exit 1 }; let nextest_txt = (open --raw $nextest_cfg); let nx_ci_test = ($nextest_txt | str contains \"[profile.ci-test]\"); let nx_ci = ($nextest_txt | str contains \"[profile.ci]\"); if $has_ci_test and $has_ci and $nx_ci_test and $nx_ci { exit 0 } else { exit 1 }",
|
|
expect_exit = 0,
|
|
},
|
|
instructions = "
|
|
Adopt the workflow layer model:
|
|
|
|
1. Create .ontology/workflow.ncl declaring your CI layers.
|
|
Use the template at reflection/templates/ontology/workflow.ncl
|
|
or copy from an existing workspace.
|
|
|
|
2. Add cargo profiles to .cargo/config.toml:
|
|
|
|
[profile.ci-test]
|
|
# Pre-commit: no debug info, no incremental — shared .rlib between test + docs hooks
|
|
inherits = \"test\"
|
|
debug = 0
|
|
incremental = false
|
|
|
|
[profile.ci]
|
|
# CI pipeline: line-tables-only for actionable backtraces on remote failures
|
|
inherits = \"test\"
|
|
debug = \"line-tables-only\"
|
|
incremental = false
|
|
|
|
3. Add nextest profiles to .config/nextest.toml:
|
|
|
|
[profile.ci-test]
|
|
fail-fast = true
|
|
retries = 0
|
|
|
|
[profile.ci]
|
|
fail-fast = false
|
|
retries = 1
|
|
|
|
4. Generate CI artifacts from the declaration:
|
|
|
|
ore workflow generate
|
|
|
|
This writes:
|
|
- .woodpecker/ci.yml (from layers with provider Woodpecker + trigger OnPR)
|
|
- .woodpecker/ci-exhaustive.yml (from layers with trigger OnMainMerge)
|
|
- justfiles/workflow.just (from layers with provider Justfile)
|
|
|
|
Pre-commit hooks are printed for manual merge into .pre-commit-config.yaml.
|
|
|
|
5. Verify:
|
|
|
|
ore workflow validate
|
|
ore workflow list
|
|
",
|
|
}
|