ontoref-code/crates/ontoref-daemon/src/ui/mod.rs

131 lines
5.3 KiB
Rust
Raw Normal View History

2026-03-13 00:18:14 +00:00
pub mod auth;
pub mod backlog_ncl;
pub mod drift_watcher;
pub mod handlers;
pub mod login;
pub mod ncl_write;
2026-03-13 00:18:14 +00:00
pub mod qa_ncl;
pub mod search_bookmarks_ncl;
2026-03-13 00:18:14 +00:00
pub mod watcher;
pub use drift_watcher::DriftWatcher;
pub use watcher::TemplateWatcher;
use crate::api::AppState;
pub fn router(state: AppState) -> axum::Router {
multi_router(state)
2026-03-13 00:18:14 +00:00
}
#[allow(dead_code)]
2026-03-13 00:18:14 +00:00
fn single_router(state: AppState) -> axum::Router {
use axum::routing::{get, post};
axum::Router::new()
.route("/", get(handlers::dashboard))
.route("/graph", get(handlers::graph))
.route("/sessions", get(handlers::sessions))
.route("/notifications", get(handlers::notifications_page))
.route("/modes", get(handlers::modes))
.route("/search", get(handlers::search_page))
.route("/assets/{*path}", get(handlers::serve_asset_single))
.route("/public/{*path}", get(handlers::serve_public_single))
.route("/backlog", get(handlers::backlog_page))
.route("/backlog/status", post(handlers::backlog_update_status))
.route("/backlog/add", post(handlers::backlog_add))
.route("/manage", get(handlers::manage_page))
.route("/manage/add", post(handlers::manage_add))
.route("/manage/remove", post(handlers::manage_remove))
.route("/actions", get(handlers::actions_page))
.route("/actions/run", post(handlers::actions_run))
.route("/qa", get(handlers::qa_page))
.route("/qa/delete", post(handlers::qa_delete))
.route("/qa/update", post(handlers::qa_update))
.route("/search/bookmark/add", post(handlers::search_bookmark_add))
.route(
"/search/bookmark/delete",
post(handlers::search_bookmark_delete),
)
2026-03-13 00:18:14 +00:00
.with_state(state)
}
fn multi_router(state: AppState) -> axum::Router {
use axum::routing::{get, post};
axum::Router::new()
// Project picker and management at root
.route("/", get(handlers::project_picker))
.route("/manage", get(handlers::manage_page_guarded))
.route("/manage/add", post(handlers::manage_add_guarded))
.route("/manage/remove", post(handlers::manage_remove_guarded))
.route(
"/manage/login",
get(login::manage_login_page).post(login::manage_login_submit),
)
.route("/manage/logout", get(handlers::manage_logout))
2026-03-13 00:18:14 +00:00
// Per-project routes — AuthUser extractor enforces auth per project
.route("/{slug}/", get(handlers::dashboard_mp))
.route("/{slug}/stats", get(handlers::dashboard_stats_mp))
2026-03-13 00:18:14 +00:00
.route("/{slug}/graph", get(handlers::graph_mp))
.route("/{slug}/sessions", get(handlers::sessions_mp))
.route("/{slug}/notifications", get(handlers::notifications_mp))
.route("/{slug}/modes", get(handlers::modes_mp))
.route("/{slug}/logout", get(login::logout))
.route("/{slug}/search", get(handlers::search_page_mp))
.route("/{slug}/assets/{*path}", get(handlers::serve_asset_mp))
.route("/{slug}/public/{*path}", get(handlers::serve_public_mp))
.route("/{slug}/backlog", get(handlers::backlog_page_mp))
.route(
"/{slug}/backlog/status",
post(handlers::backlog_update_status_mp),
)
.route("/{slug}/backlog/add", post(handlers::backlog_add_mp))
.route("/{slug}/backlog/edit", post(handlers::backlog_edit_mp))
.route("/{slug}/backlog/delete", post(handlers::backlog_delete_mp))
.route(
"/{slug}/backlog/propose-status",
post(handlers::backlog_propose_status_mp),
)
2026-03-13 00:18:14 +00:00
.route(
"/{slug}/notifications/{id}/action",
post(handlers::notification_action_mp),
)
.route(
"/{slug}/notifications/emit",
post(handlers::emit_notification_mp),
)
.route("/{slug}/compose", get(handlers::compose_page_mp))
.route(
"/{slug}/compose/form/{form_id}",
get(handlers::compose_form_schema_mp),
)
.route("/{slug}/compose/send", post(handlers::compose_send_mp))
--- 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
.route("/{slug}/api", get(handlers::api_catalog_page_mp))
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
.route("/{slug}/config", get(handlers::config_page_mp))
.route("/{slug}/adrs", get(handlers::adrs_page_mp))
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
.route("/{slug}/personal", get(handlers::personal_page_mp))
.route("/{slug}/career", get(handlers::career_page_mp))
.route("/{slug}/provisioning", get(handlers::provisioning_page_mp))
.route(
"/{slug}/migrations/pending",
get(handlers::pending_migrations_fragment_mp),
)
2026-03-13 00:18:14 +00:00
.route("/{slug}/actions", get(handlers::actions_page_mp))
.route("/{slug}/actions/run", post(handlers::actions_run_mp))
.route("/{slug}/qa", get(handlers::qa_page_mp))
.route("/{slug}/qa/delete", post(handlers::qa_delete))
.route("/{slug}/qa/update", post(handlers::qa_update))
.route(
"/{slug}/search/bookmark/add",
post(handlers::search_bookmark_add),
)
.route(
"/{slug}/search/bookmark/delete",
post(handlers::search_bookmark_delete),
)
2026-03-13 00:18:14 +00:00
// Login is public — no AuthUser extractor
.route(
"/{slug}/login",
get(login::login_page).post(login::login_submit),
)
.with_state(state)
}