xarmian 062eef41b2 docs: architecture guide + full .env.example + gitattributes + Makefile note (TASK-687) (#222) ...

Grouped nice-to-haves called out in the pre-launch audit.

1. docs/architecture.md — new contributor-focused architecture doc.
   CLAUDE.md covers the same ground but is agent-oriented; this is the
   human companion. Covers backend layout, request flow, frontend /
   data model / CLI↔daemon model / agent integration / testing.

2. .env.example — extended to document every PAD_* variable in
   docs/deployment.md (core, database, real-time events, security,
   email). Existing Postgres/Redis + encryption secrets kept at the
   top; new variables grouped by concern with inline comments and
   safe defaults commented out.

3. .gitattributes — normalize LF line endings repo-wide, mark binary
   assets, and flag web/build + web/.svelte-kit as generated so they
   don't pollute GitHub linguist stats or PR diffs.

4. Makefile — CAUTION comment on `make install` noting that the
   `killall -9 pad` step is system-wide; anyone else's pad daemon on
   the same machine gets killed too. Designed for single-developer
   local setups; not for shared hosts.

Parent: PLAN-644.

2026-04-22 20:59:15 -04:00

..

architecture.md

docs: architecture guide + full .env.example + gitattributes + Makefile note (TASK-687) (#222)

2026-04-22 20:59:15 -04:00

backup.md

fix(docs): replace 'pad serve' with 'pad server start' (TASK-675) (#199)

2026-04-22 14:50:24 -04:00

deployment.md

fix(docs): replace 'pad serve' with 'pad server start' (TASK-675) (#199)

2026-04-22 14:50:24 -04:00