vault layer: tess as the knowledge-base provider for agents - #10
Merged
Conversation
- tess vault: orientation map (folders/boards/bases/templates/canvases,
default write target), folders, mkdir, init <dir> workspace scaffold
- tess note new/ls/path/show: frontmatter + {{var}} templates, exit-3
ambiguity contract with re-runnable path candidates
- tess kanban: full CRUD on Lokus-native .kanban files — app-schema-exact
cards, atomic writes, mtime CAS against an open app, malformed-tolerant
- tess tasks: all 7 checkbox states across notes, line-exact check-off;
reminders now shows every open state
- tess base: database queries over frontmatter + saved .base views
(stdlib mini-YAML, quote-aware); tess links: backlinks/outlinks/--broken
- tess canvas: Excalidraw list/new (plain Excalidraw JSON)
- tess todo start + board: [/] in-progress state and a kanban view
- new tess-vault skill + primer/docs so agents learn the whole layer
- safety: symlink-hard vault confinement, no dot-path writes, todo id
regex gate, tess add no longer guesses among same-named notes,
exact note names win over the app-open fallback
- reserved words only bind at create time (existing features stay
manageable); 105-case smoke suite
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
A full knowledge layer over the
TESS_VAULTmarkdown vault, agent-first:tess vault(orientation map with an explicit default write target,folders,mkdir,init <dir>workspace scaffolding),tess note(new/ls/path/show with frontmatter +{{var}}templates),tess kanban(full CRUD on Lokus-native.kanbanfiles — app-schema-exact cards, atomic writes, mtime CAS against an open app),tess tasks(all 7 checkbox states across notes, line-exact check-off),tess base(database-style queries over frontmatter + saved.baseviews via a stdlib mini-YAML reader),tess links(backlinks/outlinks/--broken),tess canvas(Excalidraw), plustess todo start+tess todo board. A newtess-vaultskill, primer lines, anddocs/vault.mdteach agents the whole layer, including the layer-wide exit-code contract (3 = ambiguous, candidates re-runnable verbatim).Why
Agents had no way to learn what the vault offers or where to write — no discovery, no note creation with conventions, no access to boards/tasks/bases. This makes the vault the default knowledge-base provider for every wired agent, while staying a plain-markdown tool: everything degrades gracefully on any md folder (Obsidian, plain files); Lokus formats light up when present, with zero new required config.
Verified
tests/smoke.shpasses —smoke: 105 passed, 0 failed(includes a ~50-case vault battery: kanban schema round-trip throughjson.load+ required-field asserts, exit-3 contracts,[/]todo state, unconfigured-vault guidance per helper, reserved-word refusal)vaultmap,tasks(271 open across all states),linksbacklinks,base query, and a full kanban write lifecycle — add → move → rm on a real board, file restored byte-identical minusmetadata.modifiedtess addambiguity becoming exit 3 instead of a guessConventions (see CONTRIBUTING.md)
TESS_*config--helpstays safe: never creates a worktree, spawns an agent, or mutates state