Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
Record the rule: never change a model's input out of the user's sight
Claudea882fd51159c
diff --git a/AGENTS.md b/AGENTS.mdindex 2f602047f7..5503c3db88 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -101,6 +101,8 @@ Because both are off by default, **never treat "the password is set" as an avail**Pattern for background pre-generation (e.g. caches):** boot-time init loads only what's on disk (zero LLM calls); the bulk/cold fill runs only from an explicit user-triggered endpoint behind a UI prompt that names the provider/model and lets the user change it or decline; incremental top-ups after the user has engaged (replenishing one item they consumed) may run silently. Reference: `server/services/meatspacePostDrillCache.js` (`initDrillCache` / `requestCacheFill`) and `client/src/components/meatspace/post/WordplayTrainer.jsx` (`CacheFillConsentModal`).+**Never modify a model's input out of the user's sight.** What a user types or picks for a model (an LLM, image, video or music engine) is sent as written. Do not regex-rewrite, strip, truncate, or append or prepend text to it on the way out. Anything PortOS itself adds (a style or bible, a guard clause, a negative prompt, a reference) must appear where the user composes the request, so they can see the exact text and inputs that go out before they send them (the music video shot card's "Sent to the model" block, `client/src/components/musicVideo/SceneRenderInputs.jsx`, is the reference). When an input breaks a model's limit, refuse with the reason and let the user fix it; never quietly change it. Generated prompts are fixed at the source, in the instructions to the model that writes them, not by a cleanup pass before the send.+## ArchitectureThe server is always user-facing on `:5555` (HTTP or HTTPS). The client runs on the Vite dev server at `:5554` under `npm run dev`; under `npm start` the built client is served from `:5555`. PM2 manages app lifecycles. Where a record persists (Postgres vs a `data/` file) is decided by `docs/STORAGE.md`.