2026-03-12 23:59:21 +00:00
|
|
|
# Pre-commit Framework Configuration
|
|
|
|
|
# Generated by dev-system/ci
|
|
|
|
|
# Configures git pre-commit hooks for Rust projects
|
|
|
|
|
|
|
|
|
|
repos:
|
|
|
|
|
# ============================================================================
|
|
|
|
|
# Rust Hooks
|
|
|
|
|
# ============================================================================
|
|
|
|
|
- repo: local
|
|
|
|
|
hooks:
|
|
|
|
|
- id: rust-fmt
|
|
|
|
|
name: Rust formatting (cargo +nightly fmt)
|
|
|
|
|
entry: bash -c 'cargo +nightly fmt --all -- --check'
|
|
|
|
|
language: system
|
|
|
|
|
types: [rust]
|
|
|
|
|
pass_filenames: false
|
|
|
|
|
stages: [pre-commit]
|
|
|
|
|
|
|
|
|
|
- id: rust-clippy
|
|
|
|
|
name: Rust linting (cargo clippy)
|
2026-03-16 01:48:17 +00:00
|
|
|
entry: bash -c 'CARGO_TARGET_DIR=target cargo clippy --all-targets --no-deps --profile clippy -- -D warnings'
|
2026-03-12 23:59:21 +00:00
|
|
|
language: system
|
|
|
|
|
types: [rust]
|
|
|
|
|
pass_filenames: false
|
|
|
|
|
stages: [pre-commit]
|
|
|
|
|
|
|
|
|
|
- id: rust-test
|
|
|
|
|
name: Rust tests
|
feat: config surface, NCL contracts, override-layer mutation, on+re update
Config surface — per-project config introspection, coherence verification, and
audited mutation without destroying NCL structure (ADR-008):
- crates/ontoref-daemon/src/config.rs — typed DaemonNclConfig (parse-at-boundary
pattern); all section structs derive ConfigFields + config_section(id, ncl_file)
emitting inventory::submit!(ConfigFieldsEntry{...}) at link time
- crates/ontoref-derive/src/lib.rs — #[derive(ConfigFields)] proc-macro; serde
rename support; serde_rename_of() helper extracted to fix excessive_nesting
- crates/ontoref-daemon/src/main.rs — 3-tuple bootstrap block (nickel_import_path,
loaded_ncl_config: Option<DaemonNclConfig>, stdin_raw); apply_ui_config takes
&UiConfig; NATS call site typed; resolve_asset_dir cfg(feature = "ui")
- crates/ontoref-daemon/src/api.rs — config GET/PUT endpoints, quickref, coherence,
cross-project comparison; index_section_fields() extracted (excessive_nesting)
- crates/ontoref-daemon/src/config_coherence.rs — multi-consumer coherence;
merge_meta_into_section() extracted; and() replaces unnecessary and_then
NCL contracts for ontoref's own config:
- .ontoref/contracts.ncl — LogConfig (LogLevel, LogRotation, PositiveInt) and
DaemonConfig (Port, optional overrides); std.contract.from_validator throughout
- .ontoref/config.ncl — log | C.LogConfig applied
- .ontology/manifest.ncl — contracts_path, log/daemon contract refs, daemon section
with DaemonRuntimeConfig consumer and 7 declared fields
Protocol:
- adrs/adr-008-ncl-first-config-validation-and-override-layer.ncl — NCL contracts
as single validation gate; Rust structs are contract-trusted; override-layer
mutation writes {section}.overrides.ncl + _overrides_meta, never touches source
on+re update:
- .ontology/core.ncl — config-surface node (28 practices); adr-lifecycle extended
to adr-007 + adr-008; 6 new edges (ManifestsIn daemon, DependsOn ontology-crate,
Complements api-catalog-surface/dag-formalized/self-describing/adopt-ontoref)
- .ontology/state.ncl — protocol-maturity blocker and self-description-coverage
catalyst updated for session 2026-03-26
- README.md / CHANGELOG.md updated
2026-03-26 20:20:22 +00:00
|
|
|
entry: bash -c 'cargo test --all-features --workspace'
|
2026-03-12 23:59:21 +00:00
|
|
|
language: system
|
|
|
|
|
types: [rust]
|
|
|
|
|
pass_filenames: false
|
feat: unified auth model, project onboarding, install pipeline, config management
The full scope across this batch: POST /sessions key→token exchange, SessionStore dual-index with revoke_by_id, CLI Bearer injection (ONTOREF_TOKEN), ontoref setup
--gen-keys, install scripts, daemon config form roundtrip, ADR-004/005, on+re self-description update (fully-self-described), and landing page refresh.
2026-03-13 21:14:55 +00:00
|
|
|
stages: [pre-commit]
|
2026-03-12 23:59:21 +00:00
|
|
|
|
|
|
|
|
- id: cargo-deny
|
|
|
|
|
name: Cargo deny (licenses & advisories)
|
|
|
|
|
entry: bash -c 'cargo deny check licenses advisories'
|
|
|
|
|
language: system
|
2026-03-13 21:21:06 +00:00
|
|
|
files: Cargo\.(toml|lock)$
|
2026-03-12 23:59:21 +00:00
|
|
|
pass_filenames: false
|
feat: unified auth model, project onboarding, install pipeline, config management
The full scope across this batch: POST /sessions key→token exchange, SessionStore dual-index with revoke_by_id, CLI Bearer injection (ONTOREF_TOKEN), ontoref setup
--gen-keys, install scripts, daemon config form roundtrip, ADR-004/005, on+re self-description update (fully-self-described), and landing page refresh.
2026-03-13 21:14:55 +00:00
|
|
|
stages: [pre-commit]
|
2026-03-12 23:59:21 +00:00
|
|
|
|
feat: mode guards, convergence, manifest coverage, doc authoring pattern
## Mode guards and convergence loops (ADR-011)
- `Guard` and `Converge` types added to `reflection/schema.ncl` and
`reflection/defaults.ncl`. Guards run pre-flight checks (Block/Warn);
converge loops iterate until a condition is met (RetryFailed/RetryAll).
- `sync-ontology.ncl`: 3 guards + converge (zero-drift condition, max 2 iter).
- `coder-workflow.ncl`: guard (coder-dir-exists) + `novelty-check` step.
- Rust types in `ontoref-reflection/src/mode.rs`; executor in `executor.rs`
evaluates guards before steps and convergence loop after.
- `adrs/adr-011-mode-guards-and-convergence.ncl` added.
## Manifest capability completeness
- `.ontology/manifest.ncl`: 3 → 19 declared capabilities covering the full
action surface (daemon API, modes, Task Composer, QA, bookmarks, etc.).
- `sync.nu`: `audit-manifest-coverage` + `sync manifest-check` command.
- `validate-project.ncl`: 6th category `manifest-cov`.
- Pre-commit hook `manifest-coverage` added.
- Migrations `0010-manifest-capability-completeness`,
`0011-manifest-coverage-hooks`.
## Rust doc authoring pattern — canonical `///` convention
- `#[onto_api]`: `description = "..."` optional when `///` doc comment exists
above handler — first line used as fallback. `#[derive(OntologyNode)]` same.
- `ontoref-daemon/src/api.rs`: 42 handlers migrated to `///` doc comments;
`description = "..."` removed from all `#[onto_api]` blocks.
- `sync diff --docs --fail-on-drift`: exits 1 on crate `//!` drift; used by
new `docs-drift` pre-commit hook. `docs-links` hook checks rustdoc broken links.
- `generator.nu`: mdBook `crates/` chapter — per-crate page from `//!` doc,
coverage badge, feature flags, implementing practice nodes.
- `.claude/CLAUDE.md`: `### Documentation Authoring (Rust)` section added.
- Migration `0012-rust-doc-authoring-pattern`.
## OntologyNode derive fixes
- `#[derive(OntologyNode)]`: `name` and `paths` attributes supported; `///`
doc fallback for `description`; `artifact_paths` correctly populated.
- `Core::from_value` calls `merge_contributors()` behind `#[cfg(feature = "derive")]`.
## Bug fixes
- `sync.nu` drift check: exact crate path match (not `str starts-with`);
first-path-only rule; split on `. ` not `.` to avoid `.ontology/` truncation.
- `find-unclaimed-artifacts`: fixed absolute vs relative path comparison.
- Rustdoc broken intra-doc links fixed across all three crates.
- `ci-docs` recipe now sets `RUSTDOCFLAGS` and actually fails on errors.
mode guards/converge, manifest coverage validation, 19 capabilities (ADR-011)
Extend the mode schema with Guard (pre-flight Block/Warn checks) and Converge
(RetryFailed/RetryAll post-execution loops) — protocol pushes back on invalid
state and iterates until convergence. ADR-011 records the decision to extend
modes rather than create a separate action subsystem.
Manifest expanded from 3 to 19 capabilities covering the full action surface
(compose, plans, backlog graduation, notifications, coder pipeline, forms,
templates, drift, quick actions, migrations, config, onboarding). New
audit-manifest-coverage validator + pre-commit hook + SessionStart hook
ensure agents always see complete project self-description.
Bug fix: find-unclaimed-artifacts absolute vs relative path comparison —
19 phantom MISSING items resolved. Health 43% → 100%.
Anti-slop: coder novelty-check step (Jaccard overlap against published+QA)
inserted between triage and publish in coder-workflow.
Justfile restructured into 5 modules (build/test/dev/ci/assets).
Migrations 0010-0011 propagate requirements to consumer projects.
2026-03-30 19:08:25 +01:00
|
|
|
- id: docs-links
|
|
|
|
|
name: Rustdoc broken intra-doc links
|
|
|
|
|
entry: bash -c 'RUSTDOCFLAGS="-D rustdoc::broken-intra-doc-links -D rustdoc::private-intra-doc-links" cargo doc --no-deps --workspace -q'
|
|
|
|
|
language: system
|
|
|
|
|
types: [rust]
|
|
|
|
|
pass_filenames: false
|
|
|
|
|
stages: [pre-commit]
|
|
|
|
|
|
|
|
|
|
- id: docs-drift
|
|
|
|
|
name: Crate //! doc drift check
|
|
|
|
|
entry: bash -c 'nu -c "use ./reflection/modules/sync.nu; sync diff --docs --fail-on-drift"'
|
|
|
|
|
language: system
|
|
|
|
|
types: [rust]
|
|
|
|
|
pass_filenames: false
|
|
|
|
|
stages: [pre-commit]
|
|
|
|
|
|
|
|
|
|
- id: manifest-coverage
|
|
|
|
|
name: Manifest capability completeness
|
|
|
|
|
entry: bash -c 'ONTOREF_ROOT="$(pwd)" ONTOREF_PROJECT_ROOT="$(pwd)" nu --no-config-file -c "use ./reflection/modules/sync.nu *; sync manifest-check"'
|
|
|
|
|
language: system
|
|
|
|
|
files: (\.ontology/|reflection/modes/|reflection/forms/).*\.ncl$
|
|
|
|
|
pass_filenames: false
|
|
|
|
|
stages: [pre-commit]
|
|
|
|
|
|
2026-03-12 23:59:21 +00:00
|
|
|
# ============================================================================
|
|
|
|
|
# Nushell Hooks (optional - enable if using Nushell)
|
|
|
|
|
# ============================================================================
|
|
|
|
|
# - repo: local
|
|
|
|
|
# hooks:
|
|
|
|
|
# - id: nushell-check
|
|
|
|
|
# name: Nushell validation (nu --ide-check)
|
|
|
|
|
# entry: >-
|
|
|
|
|
# bash -c 'for f in $(git diff --cached --name-only --diff-filter=ACM | grep "\.nu$"); do
|
|
|
|
|
# echo "Checking: $f"; nu --ide-check 100 "$f" || exit 1; done'
|
|
|
|
|
# language: system
|
|
|
|
|
# types: [file]
|
|
|
|
|
# files: \.nu$
|
|
|
|
|
# pass_filenames: false
|
|
|
|
|
# stages: [pre-commit]
|
|
|
|
|
|
|
|
|
|
# ============================================================================
|
|
|
|
|
# Nickel Hooks (optional - enable if using Nickel)
|
|
|
|
|
# ============================================================================
|
|
|
|
|
# - repo: local
|
|
|
|
|
# hooks:
|
|
|
|
|
# - id: nickel-typecheck
|
|
|
|
|
# name: Nickel type checking
|
|
|
|
|
# entry: >-
|
|
|
|
|
# bash -c 'export NICKEL_IMPORT_PATH="../:."; for f in $(git diff --cached --name-only --diff-filter=ACM | grep "\.ncl$"); do
|
|
|
|
|
# echo "Checking: $f"; nickel typecheck "$f" || exit 1; done'
|
|
|
|
|
# language: system
|
|
|
|
|
# types: [file]
|
|
|
|
|
# files: \.ncl$
|
|
|
|
|
# pass_filenames: false
|
|
|
|
|
# stages: [pre-commit]
|
|
|
|
|
|
|
|
|
|
# ============================================================================
|
|
|
|
|
# Bash Hooks (optional - enable if using Bash)
|
|
|
|
|
# ============================================================================
|
|
|
|
|
# - repo: local
|
|
|
|
|
# hooks:
|
|
|
|
|
# - id: shellcheck
|
|
|
|
|
# name: Shellcheck (bash linting)
|
|
|
|
|
# entry: shellcheck
|
|
|
|
|
# language: system
|
|
|
|
|
# types: [shell]
|
|
|
|
|
# stages: [pre-commit]
|
|
|
|
|
#
|
|
|
|
|
# - id: shfmt
|
|
|
|
|
# name: Shell script formatting
|
|
|
|
|
# entry: bash -c 'shfmt -i 2 -d'
|
|
|
|
|
# language: system
|
|
|
|
|
# types: [shell]
|
|
|
|
|
# stages: [pre-commit]
|
|
|
|
|
|
|
|
|
|
# ============================================================================
|
|
|
|
|
# Markdown Hooks (RECOMMENDED - enable for documentation quality)
|
|
|
|
|
# ============================================================================
|
|
|
|
|
- repo: local
|
|
|
|
|
hooks:
|
|
|
|
|
- id: markdownlint
|
|
|
|
|
name: Markdown linting (markdownlint-cli2)
|
|
|
|
|
entry: markdownlint-cli2
|
|
|
|
|
language: system
|
|
|
|
|
pass_filenames: false
|
|
|
|
|
stages: [pre-commit]
|
|
|
|
|
|
|
|
|
|
# ============================================================================
|
|
|
|
|
# General Pre-commit Hooks
|
|
|
|
|
# ============================================================================
|
|
|
|
|
- repo: https://github.com/pre-commit/pre-commit-hooks
|
|
|
|
|
rev: v4.5.0
|
|
|
|
|
hooks:
|
|
|
|
|
- id: check-added-large-files
|
|
|
|
|
args: ['--maxkb=1000']
|
2026-03-29 00:19:56 +00:00
|
|
|
exclude: (^assets/presentation/|node_modules/)
|
2026-03-12 23:59:21 +00:00
|
|
|
|
|
|
|
|
- id: check-case-conflict
|
2026-03-29 00:19:56 +00:00
|
|
|
exclude: node_modules/
|
2026-03-12 23:59:21 +00:00
|
|
|
|
|
|
|
|
- id: check-merge-conflict
|
2026-03-29 00:19:56 +00:00
|
|
|
exclude: node_modules/
|
2026-03-12 23:59:21 +00:00
|
|
|
|
|
|
|
|
- id: check-toml
|
2026-03-29 00:19:56 +00:00
|
|
|
exclude: (^assets/presentation/|node_modules/)
|
2026-03-12 23:59:21 +00:00
|
|
|
|
|
|
|
|
- id: check-yaml
|
2026-03-29 00:19:56 +00:00
|
|
|
exclude: (^\.woodpecker/|^assets/presentation/|node_modules/)
|
2026-03-12 23:59:21 +00:00
|
|
|
|
|
|
|
|
- id: end-of-file-fixer
|
2026-03-29 00:19:56 +00:00
|
|
|
exclude: (^assets/presentation/|node_modules/)
|
2026-03-12 23:59:21 +00:00
|
|
|
|
|
|
|
|
- id: trailing-whitespace
|
2026-03-29 00:19:56 +00:00
|
|
|
exclude: (\.md$|^assets/presentation/|node_modules/)
|
2026-03-12 23:59:21 +00:00
|
|
|
|
|
|
|
|
- id: mixed-line-ending
|
2026-03-29 00:19:56 +00:00
|
|
|
exclude: (^assets/presentation/|node_modules/)
|