OddKit docs audit: 7 new tool docs, updated prompts, IMPL status, consistency fixes#34
Merged
Merged
Conversation
…e drift fixes Gap 1: Created tool docs for search, get, catalog, validate, preflight, version, cleanup_storage - each with oddkit:// URIs, observed response shapes from live v0.14.0, behavioral rules, and canon references. Gap 2: Updated epistemic guide prompt to document all 12 tools in 4 clusters (discovery, epistemic core, implementation bookends, maintenance). Gap 3: Added file path alongside odd:// URI in epistemic-instructions.md. Gap 4: Marked IMPL-A (explain) and IMPL-B (mode headers) as superseded. Marked IMPL-content-addressed-caching as implemented. Gap 5: Updated modes.md with E0005 epoch, values-first axiom reference, and current tool names replacing historical Librarian/Promotions refs. Gap 6: Updated input schemas and response shapes in orient, challenge, gate, encode docs to match live observed behavior from oddkit v0.14.0. Co-authored-by: Cursor <cursoragent@cursor.com>
Deploying klappy-dev-website with
|
| Latest commit: |
36091d5
|
| Status: | 🚫 Build failed. |
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.
Summary
Replaces #33 (auto-closed when #32 merged).
Test plan
Made with Cursor
Note
Low Risk
Docs-only changes (schemas, response examples, and status annotations) with no runtime behavior changes; primary risk is mismatched or misleading documentation if the observed tool shapes drift.
Overview
Updates OddKit documentation to match the current
oddkit v0.14.0tool surface and observed responses: adds new operator docs foroddkit_search,oddkit_get,oddkit_catalog,oddkit_preflight,oddkit_validate,oddkit_version, andoddkit_cleanup_storage, and revises existing tool docs (oddkit_orient,oddkit_gate,oddkit_encode,oddkit_challenge) to use theinput-based schemas and the observed{action,result}response envelopes.Refreshes guidance docs by expanding the
prompts/epistemic-guideto describe all 12 tools in four clusters, updatingmodes.mdwith EpochE0005and current action names, and marking legacy implementation docs assuperseded(IMPL-A,IMPL-B) while marking content-addressed caching asimplemented(including the rename frominvalidate_cachetocleanup_storage).Written by Cursor Bugbot for commit 36091d5. This will update automatically on new commits. Configure here.