Audited and corrected wiki docs against the codebase
Audited every wiki page against the actual code, smoke tests, and in-repo
docs, then fixed the verified inaccuracies. The cross-cutting corrections:
the MCP HTTP port (3747 to 3475), the real MCP tool names (list_media_files,
search_media_files, etc.), removal of commands and flags that do not exist
(secrets delete to remove, the bogus secrets import --public-key, psi geocode),
and the config file names (databases.json/desktop.json to .toml). Also
clarified that S3 credentials live in the secrets vault or AWS_* env vars and
are never stored in a toml file.
Reworked the larger pages: Command-Reference gained the missing commands
(mcp, news, hash-cache) and corrected flag names, while internal-only items
were kept out (the debug REST API option, the debug tools group, clear-cache,
and the orphan commands). Database-Code had a fabricated IPsi/Psi section
removed and its package paths corrected (packages/api to packages/node-api).
Claude-Integration and How-It-Works dropped hard tool counts so they will not
need updating on every tool change.
Restructured the getting-started guides for non-developers: removed the
build-from-source section and all CLI references from the desktop guide, added
a "Where to store your database" section recommending a local-primary,
cloud-replica, partial-on-constrained-devices strategy with a mermaid diagram,
and pointed cloud storage at the existing configuration doc (which already
carries the DigitalOcean Spaces recommendation). Added two new developer pages,
Building-From-Source-CLI and Building-From-Source-Desktop, with commands taken
from the real package.json scripts.
Finally, stripped every em dash from all wiki pages to match the project's
style rule (bold definition lists became colons, other em dashes became
commas). The legacy database-format checksum wording was left as-is because it
could not be verified against the now-removed v5 source, and the unfinished
Overview-Summary-Draft page was deleted.
Updated doco. Also includes new IPsi interface I'm considering adding.