Skip to content

v0.2.0 — Foam knowledge backend + docs consistency

Choose a tag to compare

View all tags
@JRS1986 JRS1986 released this 18 May 15:07
· 111 commits to main since this release
v0.2.0
fc9eee3
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Minor release. Headline addition is the Foam knowledge backend; the rest is the docs/consistency work and the case-collision regression guard that landed since v0.1.0.

Added

Foam knowledge backend

coding-scaffold knowledge create --target . --backend foam

Generates a self-contained VS Code workspace under .coding-scaffold/knowledge/:

  • .vscode/extensions.json — recommends foam.foam-vscode on first open.
  • .vscode/settings.json — Foam workspace defaults (graph view, daily-note directory, ignores .git/ and team _repo/).
  • .foam/templates/{decision,skill,agent}.md — note templates.
  • FOAM.md — entry note explaining the workflow.

Foam is MIT-licensed and runs entirely in VS Code — a commercial-friendly alternative to Obsidian for organizations of more than two people that would otherwise need a paid Obsidian Commercial license. See Knowledge Base / Foam.

Fixed

  • Knowledge index case-collision hardening. Stale index.md reference in the generated AGENTS.md cleaned up; golden-output tests gained an automatic _casefold_collisions guard so any future case-sensitive vs case-insensitive filesystem mismatch is caught at test time, not in Linux CI after the fact.
  • Misleading setup tool --install example in the README. Reworked so every tool is listed once for validate-and-configure and --install is shown once as a universal modifier — it's a flag on setup tool itself, not OpenCode-specific.
  • Non-existent policy --strict flag removed from the control-and-reproducibility persona path.

Changed

  • Compatibility matrix dedup. The README compatibility table was diverging from the canonical 11-row capability matrix in docs/wiki/Tool-Adapters.md. Collapsed to a quick-scan tool → support-depth strip linking to the canonical version.

Documentation

  • 14 audit findings reconciled between code and docs (knowledge tree listings completed in README and Knowledge-Base.md to match what knowledge.py actually writes; INDEX.md casing corrected; Claude Code and Codex added to installer sentence; .coding-scaffold/team/sources/ added to outputs inventory).
  • Review-Backlog reorganized: twelve items delivered as of v0.1.0 moved to a Delivered as of v0.1.0 section so the priority lists actually reflect remaining work.
  • --share and --relaxed-permissions flags surfaced in docs/wiki/Policy-Packs.md.
  • Wiki-style [[X]] links converted to relative Markdown so the docs render correctly when browsing docs/wiki/ in the repo on GitHub.

Verification

168 tests passing, ruff clean, CI green on Linux.

Upgrade notes

No breaking changes from v0.1.0. The Foam backend is additive — existing markdown, obsidian, and mempalace knowledge bases continue to work unchanged.

Full notes: CHANGELOG.md.

Assets 2
Loading