32 commits

This branch

This branch

All branches

Author	SHA1	Message	Date
Jesús Pérez	6721daf440	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
Jesús Pérez	a6e0287c6f	chore: fix /Users/Akasha/Development/ontoref withoud .ontoref	2026-04-08 11:33:35 +01:00
Jesús Pérez	f5d1d28181	chore: fix sync	2026-04-08 03:41:50 +01:00
Jesús Pérez	b00790f67b	chore: fix nu errors	2026-04-08 00:11:29 +01:00
Jesús Pérez	472952e29b	feat: domain extension system, VCS abstraction, personal/provisioning domains, web subpages ... Domain extension system (ADR-012): bash-layer dispatch activates repo_kind-conditional CLI domains. install.nu copies domains/ tree; short_alias wrappers generated (personal, prov). ore help and describe capabilities domain-aware. personal domain (PersonalOntology): career skills/talks/publications/positioning, CFP pipeline (Watching→Delivered), opportunities lifecycle, content pipeline, Sessionize integration. Daemon pages: /career, /personal. provisioning domain (DevWorkspace/Mixed): FSM state, next transitions, connections graph, gates, workspace card, capabilities, backlog. Daemon page: /provisioning. VCS abstraction layer (ADR-013): reflection/modules/vcs.nu — uniform jj/git API via filesystem detection (.jj/ vs .git/). opmode.nu and git-event.nu migrated off ^git. reflection/bin/jjw.nu — jj + ontoref + Radicle agent workspace lifecycle. jjw-ncl-merge.nu registered as jj merge tool for .ontology/ NCL conflicts. init-repo.nu for new_project mode. jj/rad not in ontoref requirements — belong in orchestration project manifests. 'Framework RepoKind: ontology/schemas/manifest.ncl gains 'Framework variant; ontoref self-identifies as framework — no domain activates for the protocol itself. Web presence: personal.html and provisioning.html domain subpages. index.html gains "Project Types — Domain Extensions" section with type cards and subpage links. Nav compacted (Arch/Prov labels, solid backdrop-filter background). on+re: vcs-abstraction (adrs: adr-013) and agent-workspace-orchestration Practice nodes; 21 manifest capabilities; state.ncl catalysts updated.	2026-04-07 23:08:29 +01:00
Jesús Pérez	13b03d6edf	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
Jesús Pérez	183b8dcb3f	feat: browser-style panel nav, repo file routing, migration 0007 ... graph, search, api_catalog pages: back/forward history stack (PanelNav/dpNav). File artifact paths open in external tabs via card.repo (Gitea source URL) or card.docs (cargo docs for .rs) — openFile/openFileInPanel removed from all pages. Tera | safe required for URL values inside <script> blocks (auto-escape of slashes). card.ncl: repo field added. insert_brand_ctx: injects card_repo/card_docs into Tera context. #[onto_api] proc-macro: source_file = file!() emitted; ApiRouteEntry.source_file populated in primary catalog handler. migration 0007-card-repo-field: check card.ncl for repo field; skip if absent.	2026-03-29 08:34:09 +01:00
Jesús Pérez	75892a8eea	feat: browser-style panel nav, repo file routing, migration 0007 ... graph, search, api_catalog pages: back/forward history stack (PanelNav/dpNav). File artifact paths open in external tabs via card.repo (Gitea source URL) or card.docs (cargo docs for .rs) — openFile/openFileInPanel removed from all pages. Tera | safe required for URL values inside <script> blocks (auto-escape of slashes). card.ncl: repo field added. insert_brand_ctx: injects card_repo/card_docs into Tera context. #[onto_api] proc-macro: source_file = file!() emitted; ApiRouteEntry.source_file populated in primary catalog handler. migration 0007-card-repo-field: check card.ncl for repo field; skip if absent.	2026-03-29 08:32:50 +01:00
Jesús Pérez	da083fb9ec	.coder/m	2026-03-29 00:19:56 +00:00
Jesús Pérez	502b5f0caa	feat: manifest self-interrogation layer — capabilities, requirements, critical deps (ADR-009) ... Three new typed arrays in manifest_type answering operational self-knowledge queries: capability_type (what/why/how + nodes[]/adrs[] DAG cross-refs), requirement_type (env_target: Production/Development/Both; kind: Tool/Service/EnvVar/Infrastructure), critical_dep_type (failure_impact required, mitigation). describe requirements new subcommand; describe capabilities and describe guides extended with manifest data. Bug fix: collect-identity was reading manifest.kind? (absent) instead of manifest.repo_kind?. Ontoref self-described with 3 capabilities, 5 requirements, 3 critical deps. on+re: manifest-self-description node (29 nodes, 59 edges), ADR-009 accepted.	2026-03-26 21:01:39 +00:00
Jesús Pérez	401294de5d	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
Jesús Pérez	085607130a	--- ... feat: API catalog surface, protocol v2 tooling, MCP expansion, on+re update ## Summary Session 2026-03-23. Closes the loop between handler code and discoverability across all three surfaces (browser, CLI, MCP agent) via compile-time inventory registration. Adds protocol v2 update tooling, extends MCP from 21 to 29 tools, and brings the self-description up to date. ## API Catalog Surface (#[onto_api] proc-macro) - crates/ontoref-derive: new proc-macro crate; `#[onto_api(method, path, description, auth, actors, params, tags)]` emits `inventory::submit!(ApiRouteEntry{...})` at link time - crates/ontoref-daemon/src/api_catalog.rs: `catalog()` — pure fn over `inventory::iter::<ApiRouteEntry>()`, zero runtime allocation - GET /api/catalog: returns full annotated HTTP surface as JSON - templates/pages/api_catalog.html: new page with client-side filtering by method, auth, path/description; detail panel per route (params table, feature flag); linked from dashboard card and nav - UI nav: "API" link (</> icon) added to mobile dropdown and desktop bar - inventory = "0.3" added to workspace.dependencies (MIT, zero transitive deps) ## Protocol Update Mode - reflection/modes/update_ontoref.ncl: 9-step DAG (5 detect parallel, 2 update idempotent, 2 validate, 1 report) — brings any project from protocol v1 to v2 by adding manifest.ncl and connections.ncl if absent, scanning ADRs for deprecated check_hint, validating with nickel export - reflection/templates/update-ontology-prompt.md: 8-phase reusable prompt for agent-driven ontology enrichment (infrastructure → audit → core.ncl → state.ncl → manifest.ncl → connections.ncl → ADR migration → validation) ## CLI — describe group extensions - reflection/bin/ontoref.nu: `describe diff [--fmt] [--file]` and `describe api [--actor] [--tag] [--auth] [--fmt]` registered as canonical subcommands with log-action; aliases `df` and `da` added; QUICK REFERENCE and ALIASES sections updated ## MCP — two new tools (21 → 29 total) - ontoref_api_catalog: filters catalog() output by actor/tag/auth; returns { routes, total } — no HTTP roundtrip, calls inventory directly - ontoref_file_versions: reads ProjectContext.file_versions DashMap per slug; returns BTreeMap<filename, u64> reload counters - insert_mcp_ctx: audited and updated from 15 to 28 entries in 6 groups - HelpTool JSON: 8 new entries (validate_adrs, validate, impact, guides, bookmark_list, bookmark_add, api_catalog, file_versions) - ServerHandler::get_info instructions updated to mention new tools ## Web UI — dashboard additions - Dashboard: "API Catalog" card (9th); "Ontology File Versions" section showing per-file reload counters from file_versions DashMap - dashboard_mp: builds BTreeMap<String, u64> from ctx.file_versions and injects into Tera context ## on+re update - .ontology/core.ncl: describe-query-layer and adopt-ontoref-tooling descriptions updated; ontoref-daemon updated ("11 pages", "29 tools", API catalog, per-file versioning, #[onto_api]); new node api-catalog-surface (Yang/Practice) with 3 edges; artifact_paths extended across 3 nodes - .ontology/state.ncl: protocol-maturity blocker updated (protocol v2 complete); self-description-coverage catalyst updated with session 2026-03-23 additions - ADR-007: "API Surface Discoverability via #[onto_api] Proc-Macro" — Accepted ## Documentation - README.md: crates table updated (11 pages, 29 MCP tools, ontoref-derive row); MCP representative table expanded; API Catalog, Semantic Diff, Per-File Versioning paragraphs added; update_ontoref onboarding section added - CHANGELOG.md: [Unreleased] section with 4 change groups - assets/web/src/index.html: tool counts 19→29 (EN+ES), page counts 12→11 (EN+ES), daemon description paragraph updated with API catalog + #[onto_api]	2026-03-23 00:58:27 +01:00
Jesús Pérez	a7ee8dee6f	feat: personal/career schemas, content modes, search bookmarks, Nu 0.111 compat (ADR-006), commit optimize	2026-03-16 01:48:17 +00:00
Jesús Pérez	9c171ffea2	chore: fix ctrl-c interactive and nickel_import	2026-03-14 09:38:40 +00:00
Jesús Pérez	4df5e4bc9f	chore: fix assets install - use hash	2026-03-13 23:28:41 +00:00
Jesús Pérez	ac8f7f91ec	chore: fix pre-commit config	2026-03-13 21:21:06 +00:00
Jesús Pérez	a7f23437d8	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
Jesús Pérez	b66ebbfeaf	chore: move rust-test and cargo-deny to manual stage	2026-03-13 21:03:06 +00:00
Jesús Pérez	d59644b96f	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 20:56:31 +00:00
Jesús Pérez	c5be37dcd5	chore: fix errors in registry projects and skip if project setting fails	2026-03-13 01:19:53 +00:00
Jesús Pérez	76e835d936	chore: update ontoref	2026-03-13 00:53:15 +00:00
Jesús Pérez	0dee00b03d	chore: update ontology	2026-03-13 00:52:41 +00:00
Jesús Pérez	7bda3a6123	chore: update ontology	2026-03-13 00:52:17 +00:00
Jesús Pérez	97ef96f3d8	chore: update ontology	2026-03-13 00:41:20 +00:00
Jesús Pérez	d2b361420b	chore: add templates and arch diagrams	2026-03-13 00:21:54 +00:00
Jesús Pérez	0396e4037b	chore: add ontology and reflection	2026-03-13 00:21:04 +00:00
Jesús Pérez	0436a3b436	chore: add web and branding	2026-03-13 00:19:51 +00:00
Jesús Pérez	591f0e0206	chore: add typedialog and just	2026-03-13 00:19:06 +00:00
Jesús Pérez	2d87d60bb5	chore: add src code	2026-03-13 00:18:14 +00:00
Jesús Pérez	147576e8bb	chore: add ci and dev settings	2026-03-13 00:15:49 +00:00
Jesús Pérez	c59c099e5d	chore: add images	2026-03-13 00:02:37 +00:00
Jesús Pérez	77373f5859	init repo	2026-03-12 23:59:21 +00:00