MARSHAIL v1.0.1

MARSHAIL v1.0.1

Deeper, code-derived knowledge with a tunable scan depth.

A focused patch release that makes the MARSHAIL knowledge layer a real, code-derived artifact rather than a thin per-module snapshot transcribed from existing docs.
The point of the knowledge layer is to cache hard-won understanding of a repo so future changes don't pay for the same code scan twice — this release makes that cache earn its keep.

What changed

• Knowledge is now code-derived.
  init and rebuild read the system from its entrypoints inward, verify every claim against the actual code, and cache the result — so the knowledge layer can save future costly code scans instead of restating existing docs.
• Depth is decided locally.
  Each area expands to whatever depth it warrants, decided per node, with multiple levels expected for genuinely complex components, algorithms, and end-to-end flows; trivial areas stay shallow.
• New knowledge.scan_depth knob (shallow / standard / deep).
  It sets the baseline for how far a scan expands beyond a flat per-subsystem map; the local per-node depth decision still applies on top. Wired into the installer's config reconcile schema, so existing installs pick it up on upgrade. Defaults to standard.

Where it landed

• knowledge-contract.md — code derivation and locally-decided depth are now required, representation-agnostic goals of any knowledge implementation.
• knowledge-markdown-spine.md — new Depth and code derivation section, required repo_paths for code-derived topics, a deepened illustrative layout, and stronger init / rebuild update paths.
• marshail-knowledge-curator.md — depth/derivation policy, context-safe delegation by judgment, and rewritten init / rebuild / rescan workflows.
• config.yml and install-marshail.sh — the knowledge.scan_depth knob and its installer reconcile entry.
• marshail.md — carries the concept in the canonical spec; the mechanics stay linked in the references.

Upgrade notes

No breaking changes.
Re-run the installer to pick up the new knowledge.scan_depth property — it defaults to standard, preserving prior behavior.
Choose deep for large or complex repos where re-scanning the code later is expensive, or shallow for small repos and quick first passes.

Install

From the root of your target repo:

curl -fsSL https://raw.githubusercontent.com/crestreach/marshail/main/scripts/install-marshail.sh | bash

Then run the marshail-init skill once to integrate MARSHAIL into the repo.

License

MARSHAIL is licensed under the MIT License.