Archon/packages/docs-web
Rasmus Widing ba4b9b47e6
docs(worktree): fix stale rename example + document copyFiles properly (#1328)
Three related fixes around the `worktree.copyFiles` primitive:

1. Remove the `.env.example -> .env` rename example from
   reference/configuration.md and getting-started/overview.md. The
   `->` parser was removed in #739 (2026-03-19) because it caused
   the stale-credentials production bug in #228 — but the docs kept
   advertising it. A user writing `.env.example -> .env` today gets
   `parseCopyFileEntry` returning `{source: '.env.example -> .env',
   destination: '.env.example -> .env'}`, stat() fails with ENOENT,
   and the copy silently no-ops at debug level.

2. Replace the single-line "Default behavior: .archon/ is always
   copied" note with a proper "Worktree file copying" subsection
   that explains:
   - Why this exists (git worktree add = tracked files only; gitignored
     workflow inputs need this hook)
   - The `.archon/` default (no config needed for the common case)
   - Common entries: .env, .vscode/, .claude/, plans/, reports/,
     data fixtures
   - Semantics: source=destination, ENOENT silently skipped, per-entry
     error isolation, path-traversal rejected
   - Interaction with `worktree.path` (both layouts get the same
     treatment)

3. Update the overview example to drop the `.env.example + .env` pair
   (which implied rename semantics) in favor of `.env + plans/`, and
   call out that `.archon/` is auto-copied so users don't list it.

No code changes. `bun run format:check` and `bun run lint` green.
2026-04-21 12:15:37 +03:00
..
public docs: add Archon logo as favicon for docs site 2026-04-07 13:21:12 -05:00
src docs(worktree): fix stale rename example + document copyFiles properly (#1328) 2026-04-21 12:15:37 +03:00
.gitignore refactor: move docs site to packages/docs-web as workspace member 2026-04-06 11:09:32 +03:00
astro.config.mjs fix(docs): prevent theme reset to dark after user switches to auto/light (#1079) 2026-04-20 10:01:27 +03:00
package.json Release 0.3.6 2026-04-12 12:16:49 +03:00
tsconfig.json refactor: move docs site to packages/docs-web as workspace member 2026-04-06 11:09:32 +03:00