13b03d6edf
## 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.
74 lines
2.2 KiB
Plaintext
74 lines
2.2 KiB
Plaintext
{
|
|
id = "0009",
|
|
slug = "claude-session-context",
|
|
description = "Add SessionStart hook and static project-context.md for auto-loading project identity into Claude Code sessions",
|
|
check = {
|
|
tag = "NuCmd",
|
|
cmd = "let root = $env.ONTOREF_PROJECT_ROOT; let hook = $\"($root)/.claude/hooks/session-context.sh\"; let ctx = $\"($root)/.claude/project-context.md\"; if ($hook | path exists) and ($ctx | path exists) { exit 0 } else { exit 1 }",
|
|
expect_exit = 0,
|
|
},
|
|
instructions = "
|
|
1. Create .claude/hooks/session-context.sh with the following content and make it executable:
|
|
|
|
#!/usr/bin/env bash
|
|
# Hook: SessionStart
|
|
# Injects current project identity, state dimensions, and hard constraints
|
|
# as initial context for every Claude Code session in this directory.
|
|
|
|
set -euo pipefail
|
|
|
|
REPO_ROOT=\"$(git rev-parse --show-toplevel 2>/dev/null || pwd)\"
|
|
|
|
if ! command -v nu &>/dev/null; then
|
|
exit 0
|
|
fi
|
|
|
|
export ONTOREF_ACTOR=developer
|
|
|
|
echo \"## Project Context (auto-loaded at session start)\"
|
|
echo \"\"
|
|
|
|
ontoref describe project --fmt text 2>/dev/null || true
|
|
|
|
echo \"\"
|
|
|
|
ontoref describe state 2>/dev/null || true
|
|
|
|
chmod +x .claude/hooks/session-context.sh
|
|
|
|
2. Add the following to .claude/settings.local.json (merge into existing JSON):
|
|
|
|
\"hooks\": {
|
|
\"SessionStart\": [
|
|
{
|
|
\"hooks\": [
|
|
{
|
|
\"type\": \"command\",
|
|
\"command\": \".claude/hooks/session-context.sh\"
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
|
|
3. Generate the static fallback file:
|
|
|
|
ONTOREF_ACTOR=developer ontoref describe project --fmt text > .claude/project-context.md
|
|
|
|
4. Add the import at the top of .claude/CLAUDE.md (immediately after the # heading):
|
|
|
|
@.claude/project-context.md
|
|
|
|
5. In reflection/hooks/git-event.nu, add regeneration of project-context.md on post-merge/post-checkout.
|
|
After the mode-detect call, insert:
|
|
|
|
let context_file = $\"($ontoref_root)/.claude/project-context.md\"
|
|
if ($context_file | path parent | path exists) {
|
|
let r = (do { ^nu $wrapper describe project --fmt text } | complete)
|
|
if $r.exit_code == 0 {
|
|
$r.stdout | save --force $context_file
|
|
}
|
|
}
|
|
",
|
|
}
|