Skip to content

v0.6.11: overview.md never auto-updated, reviews API gaps (DELETE 405, field name), cascade-delete review orphans #737

Description

@soadleer-jpg

Tested v0.6.11 (e808211) on Windows 11 against the README feature list. Four findings, each with evidence:

1. wiki/overview.md is never auto-updated

README promises: "overview.md auto-update — global summary page regenerated on every ingest to reflect the latest state of the wiki."

After three ingests, wiki/overview.md is still the untouched project template stub. Code references:

  • src/lib/ingest.ts:2270 and :3382 — both generation prompts instruct the model: "Do not generate wiki/index.md or wiki/overview.md. The application maintains aggregate navigation separately."
  • The aggregate writers only handle index.md (updateBoundedRecentIndexSection, bounded "## Recently Updated" section) and log.md (append). Nothing ever writes overview.md.
  • The wholesale-overwrite branch for listing pages (ingest.ts ~line 2011, isListingPath) is dead code for overview, because the prompt forbids the model from emitting it.

Either the prompt or the writer side needs to change — currently the documented behavior is unimplemented.

2. DELETE /api/v1/projects/{id}/reviews/{reviewId} → 405

The README API table documents this endpoint, but src-tauri/src/api_server.rs:348-354 only routes GET .../reviews, POST .../reviews/resolve, and PATCH .../reviews/{id}. Live response:

{"error":"Method not allowed","ok":false}

3. README: bulk-resolve body field name mismatch

README documents POST /projects/{id}/reviews/resolve with {"reviewIds": [...]}. The server expects ids:

{"error":"Invalid request body: missing field `ids` at line 1 column 168","ok":false}

4. Cascade delete leaves review orphans

Deleting a source file externally correctly removes the derived wiki pages, cleans wikilinks, sources[] arrays, and the index (great!). However, review items whose affectedPages referenced the deleted pages survive in .llm-wiki/review.json as orphans — they still show up as unresolved in GET .../reviews?status=unresolved, pointing at files that no longer exist. Suggest pruning or auto-resolving review items when their last affected page is deleted.


Everything else in the README checklist verified working: source-folder auto-watch (<15 s pickup), SHA-256 incremental cache (unchanged re-saves skipped), cascade deletion itself, hybrid /search, /graph, backend agent chat with page references, persistent ingest queue, German output language (project-level override works once projectOutputLanguages is set — see below).

One related papercut: a missing per-project outputLanguage falls back to "auto" in App.tsx instead of the global outputLanguage from settings, and auto-detection misdetected a German source as French (producing French wiki pages). Falling back to the global setting before "auto" would be safer.

Happy to test any fix. Thanks for the great app!

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions