ontoref/reflection/defaults/workflow.ncl

209 lines
7 KiB
Text
Raw Normal View History

feat: workflow layer model — NCL-first CI/build/distribution generator 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
2026-04-08 14:20:38 +01:00
# Standard validation, build, and distribution catalog for Rust/Nushell/Nickel projects.
# Workspaces import this and reference IDs in their layer declarations.
# Override or extend by merging with &: `D.validations & { my-check = { ... } }`
{
validations = {
# ── Rust linting ─────────────────────────────────────────────────────────
rust-fmt = {
id = "rust-fmt",
kind = 'Lint,
tool = "cargo",
args = ["+nightly", "fmt", "--all", "--", "--check"],
when = ["*.rs"],
fail_fast = true,
cargo_profile = "",
},
rust-clippy = {
id = "rust-clippy",
kind = 'Lint,
tool = "cargo",
args = ["clippy", "--all-targets", "--no-deps", "--profile", "clippy", "--", "-D", "warnings"],
when = ["*.rs"],
fail_fast = true,
cargo_profile = "clippy",
},
rust-clippy-all = {
id = "rust-clippy-all",
kind = 'Lint,
tool = "cargo",
args = ["clippy", "--all-targets", "--all-features", "--", "-D", "warnings"],
when = ["*.rs"],
fail_fast = true,
cargo_profile = "",
},
# ── Rust testing ─────────────────────────────────────────────────────────
nextest-ci-test = {
id = "nextest-ci-test",
kind = 'Test,
tool = "cargo-nextest",
args = ["run", "--all-features", "--workspace",
"--profile", "ci-test", "--cargo-profile", "ci-test"],
when = ["*.rs"],
fail_fast = true,
cargo_profile = "ci-test",
},
nextest-ci = {
id = "nextest-ci",
kind = 'Test,
tool = "cargo-nextest",
args = ["run", "--all-features", "--workspace",
"--profile", "ci", "--cargo-profile", "ci"],
when = ["*.rs"],
fail_fast = false, # see all failures in CI
cargo_profile = "ci",
},
# ── Security ─────────────────────────────────────────────────────────────
deny-subset = {
id = "deny-subset",
kind = 'Security,
tool = "cargo-deny",
args = ["check", "licenses", "advisories"],
when = ["Cargo.toml", "Cargo.lock"],
fail_fast = true,
cargo_profile = "",
},
deny-all = {
id = "deny-all",
kind = 'Security,
tool = "cargo-deny",
args = ["check"],
when = [],
fail_fast = true,
cargo_profile = "",
},
geiger = {
id = "geiger",
kind = 'Security,
tool = "cargo-geiger",
args = ["--all-features", "--all-targets"],
when = ["*.rs"],
fail_fast = false, # informational by default; use --forbid-only to gate
cargo_profile = "",
},
# ── Documentation ────────────────────────────────────────────────────────
docs-check = {
id = "docs-check",
kind = 'Docs,
tool = "cargo",
args = ["doc", "--no-deps", "--workspace", "--profile", "ci", "-q"],
when = ["*.rs"],
fail_fast = true,
cargo_profile = "ci",
},
# ── Compliance (ontoref-specific) ────────────────────────────────────────
docs-drift = {
id = "docs-drift",
kind = 'Compliance,
tool = "nu",
args = ["-c", "use ./reflection/modules/sync.nu; sync diff --docs --fail-on-drift"],
when = ["*.rs"],
fail_fast = true,
cargo_profile = "",
},
manifest-coverage = {
id = "manifest-coverage",
kind = 'Compliance,
tool = "nu",
args = ["--no-config-file", "-c",
"use ./reflection/modules/sync.nu *; sync manifest-check"],
when = [".ontology/*.ncl", "reflection/modes/*.ncl", "reflection/forms/*.ncl"],
fail_fast = true,
cargo_profile = "",
},
# ── Nickel / Nushell linting ─────────────────────────────────────────────
nickel-typecheck = {
id = "nickel-typecheck",
kind = 'Lint,
tool = "nickel",
args = ["typecheck"],
when = ["*.ncl"],
fail_fast = true,
cargo_profile = "",
},
nushell-check = {
id = "nushell-check",
kind = 'Lint,
tool = "nu",
args = ["--ide-check", "100"],
when = ["*.nu"],
fail_fast = true,
cargo_profile = "",
},
# ── Markdown ─────────────────────────────────────────────────────────────
markdownlint = {
id = "markdownlint",
kind = 'Lint,
tool = "markdownlint-cli2",
args = [],
when = ["*.md"],
fail_fast = true,
cargo_profile = "",
},
},
builds = {
release-native = {
id = "release-native",
kind = 'Binary,
tool = "cargo",
args = ["build", "--release", "--workspace"],
cargo_profile = "release",
target = "",
artifacts = ["target/release/"],
},
release-musl-x86 = {
id = "release-musl-x86",
kind = 'Binary,
tool = "cross",
args = ["build", "--target", "x86_64-unknown-linux-musl", "--release"],
cargo_profile = "release",
target = "x86_64-unknown-linux-musl",
artifacts = ["target/x86_64-unknown-linux-musl/release/"],
},
sbom = {
id = "sbom",
kind = 'SBOM,
tool = "cargo-sbom",
args = [],
cargo_profile = "",
target = "",
artifacts = ["sbom.json"],
},
docs-html = {
id = "docs-html",
kind = 'Docs,
tool = "cargo",
args = ["doc", "--no-deps", "--workspace"],
cargo_profile = "release",
target = "",
artifacts = ["target/doc/"],
},
},
distributions = {},
}