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.
Hardcoded MCP HTTP port to 3747 and documented MCP server
The MCP HTTP server previously used findAvailablePort() to pick a random
port at startup, which made it impossible for users to know the address
in advance. The port is now hardcoded to 3747 so the URL is always
http://localhost:3747/mcp.
Added a new "MCP Server (Claude Integration)" section to How-It-Works.md
covering the architecture: process isolation via Electron utility process,
the IPC-driven database tracking model, the stateless per-request pattern,
a sequence diagram, and a full tool reference table with parameter and
return value details.
Expanded the Tool reference table in Claude-Integration.md to include
parameters and detailed descriptions for all six tools, drawn directly
from the implementation.
Expanded the CLI (stdio transport) section in Claude-Integration.md to
match the level of detail of the desktop section: step-by-step setup
instructions, separate config blocks for Claude Code and Claude Desktop,
encrypted database usage, and a manual verification step.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Updated documentation around credential sharing.
Updated How It Works (markdown)
Replaced "asset" with more direct terminology.
Added a new doc to the wiki to explain how Photosphere works.