@natjswenson/devlog 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -0,0 +1,71 @@
+# Changelog
+
+All notable changes to `@natjswenson/devlog` are documented here.
+
+## 0.1.7 (2026-05-01) — security hardening + UX improvements
+
+**Security**
+- Tightened `SHELL_METACHARS` to additionally reject whitespace, single-quote, square brackets, equals, and percent
+- Project paths now cannot start with `-` (would be parsed as flag)
+- Added strict validation of the `branch` field (no leading dash, no `..` as a path component)
+- Atomic `config.json` writes (write-to-tmp + rename)
+- CLI no longer forwards arbitrary `VITE_*` env vars to the spawned vite — only `VITE_DEVLOG_*` plus `PATH`/`HOME`/etc.
+- Added `Content-Security-Policy` meta tag to the preview app
+- Explicit `urlTransform` in `react-markdown` rejects `data:`, `blob:`, `javascript:`, `vbscript:`, `file:`, and any non-http(s)/mailto scheme
+- `react-markdown` invoked with `skipHtml` for explicit defense-in-depth
+- `SKILL.md` instructs the LLM to single-quote every interpolated config value (defense-in-depth on top of validation)
+- Production preview builds without env vars show a clear "Setup required" screen instead of attempting demo fetches that would 404
+- `config.json` written with mode `0600`, `~/.claude/skills/devlog/` created with mode `0700`
+- Pinned all dependencies to exact versions (no `^` ranges) to eliminate resolution drift
+
+**UX**
+- `init` now loops to register multiple projects in a single setup
+- New `add-project` subcommand: `npx @natjswenson/devlog add-project` — register a project without editing config.json by hand
+- New `config` subcommand: `npx @natjswenson/devlog config` — view current config with validation status
+- Init detects when `gh` is authenticated as a different user than `githubUser` and warns
+- Better next-step messaging after init (color, concrete commands)
+- All error messages now include actionable hints (`log.hint`)
+
+**Docs**
+- New `SECURITY.md` — threat model, audit history, ruled-out attack scenarios, vulnerability reporting flow
+- New `CHANGELOG.md` (this file)
+- README updated with new subcommands and security guarantees section
+
+## 0.1.6 (2026-05-01) — initial security audit fixes
+
+Addressed 1 Critical + 3 High findings from the first round of the 6-agent siege:
+- SKILL.md now requires runtime allowlist validation of every config value before shell interpolation
+- CLI switched from `execSync` with template strings to `spawnSync` with argv arrays for any user-input-bearing call
+- `gh repo create` regex hardened against leading-dash flag injection
+- `gitAuthor` validator now rejects shell metachars
+- Schema validation added for `manifest.json`, `VITE_DEVLOG_PROJECTS`, frontmatter (allowlist + `Object.create(null)`)
+- `optimizeDeps` includes for vite to fix react-markdown / react-dom CJS interop in npx layouts
+- Preview vite server bound to localhost only, CORS disabled
+
+## 0.1.5 (2026-05-01)
+
+- Corrected live-site URL in README (`natejswenson.com` not `.io`)
+
+## 0.1.4 (2026-05-01)
+
+- README troubleshooting section, npm + license badges
+- SKILL.md uses `<config.branch || 'main'>` consistently in push/URL output
+
+## 0.1.3 (2026-05-01)
+
+- Expanded `optimizeDeps.include` to cover react/react-dom for npx-installed layouts
+
+## 0.1.2 (2026-05-01)
+
+- First `optimizeDeps` fix for `style-to-js` CJS/ESM interop (react-markdown rendering)
+
+## 0.1.1 (2026-05-01)
+
+- `projects[].label` and `branch` config fields (optional, with safe defaults)
+
+## 0.1.0 (2026-05-01)
+
+- Initial release
+- CLI: `init`, `preview`
+- React drop-in components: `DevLogPage`, `useDevLogEntries`
+- Standalone deployable Vite preview app with snarky demo mode

package/README.md

@@ -2,6 +2,8 @@
 
 [![npm](https://img.shields.io/npm/v/@natjswenson/devlog?color=blue)](https://www.npmjs.com/package/@natjswenson/devlog)
 [![license](https://img.shields.io/npm/l/@natjswenson/devlog)](./LICENSE)
+[![security](https://img.shields.io/badge/security-audited-green)](./SECURITY.md)
+[![vulnerabilities](https://img.shields.io/badge/npm%20audit-0%20issues-brightgreen)](#security)
 
 A Claude Code skill that turns your daily git commits into a published dev log — and a React example for displaying it on your site.
 
@@ -9,7 +11,7 @@ A Claude Code skill that turns your daily git commits into a published dev log
 
 ## Live example
 
-The skill is in production at [natejswenson.com/devlog](https://natejswenson.com/devlog), publishing entries to [github.com/natejswenson/daily-dev-log](https://github.com/natejswenson/daily-dev-log). What you see on that page is exactly what `npx @natjswenson/devlog preview` renders for you locally.
+The skill is in production at [natejswenson.com/devlog](https://natejswenson.com/devlog), publishing to [github.com/natejswenson/daily-dev-log](https://github.com/natejswenson/daily-dev-log). What you see on that page is exactly what `npx @natjswenson/devlog preview` renders for you locally.
 
 ## How it works
 
@@ -24,30 +26,46 @@ npx @natjswenson/devlog init
 ```
 
 That command:
-- Creates `<your-username>/daily-dev-log` on GitHub
+- Creates `<your-username>/daily-dev-log` on GitHub (or uses an existing one)
 - Installs the skill at `~/.claude/skills/devlog/`
 - Writes `~/.claude/skills/devlog/config.json` with your answers
+- Lets you register one or more projects in a single run
 
 Then:
+
 ```sh
 npx @natjswenson/devlog preview
 ```
-to see your dev log rendered locally.
+
+to see your dev log rendered locally at `http://localhost:5173`.
 
 ## Prerequisites
 
 - **Node 18+** — for the CLI and preview app
-- **GitHub CLI** (`gh`), authenticated — used to create your dev-log repo and push entries
+- **GitHub CLI** (`gh`), authenticated with `gh auth login` — used to create your dev-log repo and push entries
 - **Claude Code** — to run the `/devlog` skill
 
+## Commands
+
+| Command | What it does |
+|---|---|
+| `npx @natjswenson/devlog init` | One-time setup: create dev-log repo, install skill, write config |
+| `npx @natjswenson/devlog add-project` | Register an additional project without editing config.json by hand |
+| `npx @natjswenson/devlog config` | Show your current config with validation status |
+| `npx @natjswenson/devlog preview` | Run a local preview at `http://localhost:5173` |
+| `npx @natjswenson/devlog --help` | Usage |
+| `npx @natjswenson/devlog --version` | Version |
+
+> **Tip:** run from any directory *outside* a clone of this repo. Running inside the repo causes a `package.json` name collision and `npx` fails with `command not found`.
+
 ## What you end up with
 
 ```
 ~/.claude/skills/devlog/
-├── SKILL.md          # The slash command
-└── config.json       # Your settings (target repo, projects, etc)
+├── SKILL.md          # The /devlog slash-command instructions
+└── config.json       # Your settings (mode 0600)
 
-github.com/<you>/daily-dev-log/   # Created by `init`, populated by /devlog
+github.com/<you>/daily-dev-log/   # Created by init, populated by /devlog
 ├── myproject/
 │   ├── manifest.json
 │   ├── 2026-05-01.md
@@ -55,19 +73,14 @@ github.com/<you>/daily-dev-log/   # Created by `init`, populated by /devlog
 └── ...
 ```
 
-## Manual setup (if you'd rather not use the CLI)
+## Manual setup (if you prefer)
 
-1. **Create your dev-log repo:**
-   ```sh
-   gh repo create <you>/daily-dev-log --public --add-readme
-   ```
-2. **Install the skill:**
-   ```sh
-   mkdir -p ~/.claude/skills/devlog
-   curl -o ~/.claude/skills/devlog/SKILL.md \
-     https://raw.githubusercontent.com/natejswenson/devlog/main/SKILL.md
-   ```
-3. **Write your config** at `~/.claude/skills/devlog/config.json` — copy [`config.example.json`](./config.example.json) and fill in.
+```sh
+gh repo create <you>/daily-dev-log --public --add-readme
+mkdir -p ~/.claude/skills/devlog
+curl -o ~/.claude/skills/devlog/SKILL.md https://raw.githubusercontent.com/natejswenson/devlog/main/SKILL.md
+# Then copy config.example.json → ~/.claude/skills/devlog/config.json and fill it in
+```
 
 ## Add to your site
 
@@ -77,7 +90,7 @@ github.com/<you>/daily-dev-log/   # Created by `init`, populated by /devlog
 cp -r examples/react/ your-site/src/devlog/
 ```
 
-Edit `your-site/src/devlog/devlog-config.js` to point at your repo, then mount:
+Edit `your-site/src/devlog/devlog-config.js` to point at your repo, then:
 
 ```jsx
 import DevLogPage from './devlog/DevLogPage.jsx';
@@ -89,15 +102,15 @@ Full instructions: [`examples/react/README.md`](./examples/react/README.md).
 
 ### No site yet?
 
-The `preview/` directory is a complete deployable Vite app. Set `VITE_DEVLOG_OWNER` / `VITE_DEVLOG_REPO` / `VITE_DEVLOG_PROJECTS` env vars on Vercel, Netlify, or Cloudflare Pages, build with `vite build`, deploy `dist/`. Done — you have a public dev log at your own URL. See [`preview/README.md`](./preview/README.md).
+The `preview/` directory is a complete deployable Vite app. Set `VITE_DEVLOG_OWNER` / `VITE_DEVLOG_REPO` / `VITE_DEVLOG_PROJECTS` env vars on Vercel, Netlify, or Cloudflare Pages, build with `vite build`, deploy `dist/`. See [`preview/README.md`](./preview/README.md).
 
-### Other stacks (Next, Astro, plain HTML, anything)
+### Other stacks (Next, Astro, plain HTML)
 
 It's static JSON and Markdown on GitHub. Build whatever UI you want — see the **Data contract** below.
 
 ## Data contract
 
-The dev-log repo has this layout, all served as raw files from `https://raw.githubusercontent.com/<owner>/<repo>/main/`:
+The dev-log repo has this layout, all served as raw files from `https://raw.githubusercontent.com/<owner>/<repo>/<branch>/`:
 
 ```
 <repo>/
@@ -117,7 +130,13 @@ The dev-log repo has this layout, all served as raw files from `https://raw.gith
 }
 ```
 
+Strict validation rules (entries that don't match are silently dropped by the React example):
+- `date` matches `YYYY-MM-DD`
+- `file` matches `^[a-zA-Z0-9._-]+\.md$`
+- `title` and `summary` are non-empty strings
+
 **Entry markdown:**
+
 ```markdown
 ---
 title: "Concise day summary"
@@ -144,39 +163,62 @@ That's the entire contract.
 
 | Field | Type | Description |
 |---|---|---|
-| `targetRepo` | `"<owner>/<repo>"` | Repo where dev log entries are published. **You create this — `init` does it for you, or `gh repo create` manually.** |
-| `branch` | string (optional) | Branch in the dev-log repo. Defaults to `main`. |
-| `gitAuthor` | string | Used as `git log --author=...` to find your commits. |
-| `githubUser` | string | Your GitHub username (for constructing commit links). |
+| `targetRepo` | `"<owner>/<repo>"` | Repo where dev log entries are published. Must match `^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._-]*$`. |
+| `branch` | string (optional) | Branch in the dev-log repo. Defaults to `main`. Must not contain `..` or start with `-`. |
+| `gitAuthor` | string | Used as `git log --author=...` to find your commits. Whitespace OK; no shell metacharacters. |
+| `githubUser` | string | Your GitHub username. |
 | `projects` | array | One entry per project you want dev logs for. |
-| `projects[].key` | string | Subdirectory name in the dev-log repo. |
-| `projects[].label` | string (optional) | Display name for the project tab in the UI. Defaults to `key`. |
-| `projects[].path` | string | Local filesystem path to the project. |
-| `projects[].remote` | `"<owner>/<repo>"` | The project's GitHub remote, used to mark public commits and link them. |
+| `projects[].key` | string | Subdirectory name in the dev-log repo. Strict token: `^[a-z0-9][a-z0-9._-]*$`, no `..`. |
+| `projects[].label` | string (optional) | Display name for the tab. Defaults to `key`. |
+| `projects[].path` | string | Local filesystem path to the project. Whitespace OK. |
+| `projects[].remote` | `"<owner>/<repo>"` | The project's GitHub remote. Used to mark public commits and link them. |
+
+See [`config.example.json`](./config.example.json) for a complete template, or run `npx @natjswenson/devlog config` to inspect your current config with validation.
+
+## Security
+
+The package is designed to be safe to install on a developer's machine and have ambient gh/git credentials. See [SECURITY.md](./SECURITY.md) for the full threat model and audit history.
 
-See [`config.example.json`](./config.example.json) for a complete template.
+**At a glance:**
+- ✓ All shell calls in the CLI use `spawnSync` with argv arrays (no shell, no injection surface)
+- ✓ The skill validates every config field against an allowlist before interpolating into shell commands; instructs the LLM to single-quote interpolated values
+- ✓ Markdown rendering uses `react-markdown` with `skipHtml` and an allowlist `urlTransform` (only http(s)/mailto allowed; data:, javascript:, vbscript:, file:, blob: all neutralized)
+- ✓ Frontmatter parser uses `Object.create(null)` + key allowlist (no prototype pollution)
+- ✓ All external JSON is schema-validated before use (manifest, env-var projects array)
+- ✓ Vite dev server bound to `localhost`, CORS off
+- ✓ Demo-mode `window.fetch` override gated to dev builds only
+- ✓ `config.json` written atomically (tmp + rename), mode 0600
+- ✓ All dependencies pinned to exact versions
+- ✓ `npm audit`: 0 known vulnerabilities
+
+**To report a vulnerability:** open a [GitHub security advisory](https://github.com/natejswenson/devlog/security/advisories/new). Do not open a public issue.
 
 ## Customization
 
 - **Tweak the entry template:** edit `~/.claude/skills/devlog/SKILL.md` (Step 4 — generate the entry).
-- **Tweak the UI:** override the `--devlog-*` CSS variables in `examples/react/DevLogPage.css` to match your theme. Or build your own UI against the data contract above.
-- **Add more projects:** edit `~/.claude/skills/devlog/config.json` directly.
+- **Tweak the UI:** override the `--devlog-*` CSS variables in `examples/react/DevLogPage.css` to match your theme.
+- **Add more projects:** `npx @natjswenson/devlog add-project` (no manual JSON editing required).
 
 ## Troubleshooting
 
-**`sh: devlog: command not found` when running `npx`:** you're probably inside a checkout of this repo. The local `package.json` collides with the published name. Run `npx` from anywhere else (e.g. `cd ~ && npx @natjswenson/devlog ...`).
-
-**Init prompt shows `78` after the placeholder text:** that's an artifact of capturing terminal output (cursor save/restore escapes); in a real terminal you won't see it.
+**`sh: devlog: command not found` when running `npx`:** you're inside a checkout of this repo. The local `package.json` name collides with the published one. Run `npx` from somewhere else, e.g. `cd ~ && npx @natjswenson/devlog ...`.
 
-**Preview is blank / no tabs / no entries:** check the browser console. If you see *"does not provide an export named …"* errors related to `react-dom/client`, `style-to-js`, or `react-markdown`, you're on a pre-0.1.3 release — upgrade with `npm cache clean --force && rm -rf ~/.npm/_npx && npx --yes @natjswenson/devlog@latest preview`.
+**Init prompts show `78` after placeholder text:** that's an artifact of how some output capture tools render `\x1b7`/`\x1b8` (cursor save/restore) escape sequences. In a real interactive terminal, you won't see it.
 
-**`npm publish` (if you fork/republish your own copy) fails with 403:** npm requires 2FA or a granular access token with bypass-2FA enabled for write operations. Easiest path: enable 2FA, install an authenticator app, and pass `--otp=<code>` to `npm publish`.
+**Preview is blank / no tabs / no entries:** check the browser console. If you see CJS interop errors related to `react-dom/client`, `style-to-js`, or `react-markdown`, you're on a pre-0.1.6 release — upgrade with `npm cache clean --force && rm -rf ~/.npm/_npx && npx --yes @natjswenson/devlog@latest preview`.
 
 **Init can't find `gh`:** install via [cli.github.com](https://cli.github.com/) and run `gh auth login`.
 
+**`Config validation failed: ...`** — the validator rejected something in your `config.json`. Run `npx @natjswenson/devlog config` for a detailed diagnosis. Common causes:
+- A field has shell metacharacters (`;` `&` `|` `` ` `` `$` etc) — see SKILL.md for the full list
+- A project key contains `..` or `/`
+- A path doesn't exist on disk
+
+**Preview shows "Setup required":** you deployed the preview app standalone but didn't set the env vars. Set `VITE_DEVLOG_OWNER`, `VITE_DEVLOG_REPO`, `VITE_DEVLOG_PROJECTS` (JSON-stringified array) in your hosting environment.
+
 ## Versioning
 
-Stable: see [npm](https://www.npmjs.com/package/@natjswenson/devlog). The package follows semver — bug fixes in patch releases (0.1.x), behavior changes in minor (0.x.0).
+Releases are documented in [CHANGELOG.md](./CHANGELOG.md). The package follows semver — bug fixes/security patches in patch releases (0.1.x), behavior changes in minor (0.x.0).
 
 ## License
 

package/SECURITY.md

@@ -0,0 +1,100 @@
+# Security policy
+
+## Reporting a vulnerability
+
+Please report security issues privately rather than opening a public GitHub issue.
+
+- **Email:** open a GitHub security advisory at https://github.com/natejswenson/devlog/security/advisories/new
+- **Response time:** target within 72 hours
+
+Please do not file public issues, post on social media, or share PoCs publicly until a fix has shipped.
+
+## Scope
+
+In scope:
+- The published npm package `@natjswenson/devlog` (any version)
+- The CLI (`bin/devlog.js`)
+- The Claude Code skill (`SKILL.md`)
+- The Vite preview app (`preview/`)
+- The React drop-in components (`examples/react/`)
+
+Out of scope:
+- The user's own `daily-dev-log` repo content (that's on the user)
+- The user's GitHub account, gh CLI, or local dev environment
+- The Claude Code product itself
+- Vulnerabilities that require an attacker to already have arbitrary code execution on the user's machine
+- Social engineering, phishing, or attacks on the npm registry / GitHub itself
+
+## Threat model
+
+### Trust boundaries
+
+The package crosses three trust boundaries:
+
+1. **npm → adopter's machine.** The package is distributed via the npm registry. Adopters trust npm not to ship a tampered tarball. Out of our scope; defense relies on npm's signing and provenance.
+
+2. **`config.json` → shell commands.** The Claude Code skill (`SKILL.md`) reads `~/.claude/skills/devlog/config.json` and uses values in shell commands run via Claude's bash tool. The skill's Step 0.5 enforces strict allowlist validation on every field BEFORE interpolation, and instructs the LLM to single-quote all values when interpolating. This is the most security-critical boundary.
+
+3. **`daily-dev-log` repo content → adopter's deployed site.** Markdown entries published via `/devlog` are fetched from `raw.githubusercontent.com` and rendered by `react-markdown` 9.x. Raw HTML is disabled. URLs are restricted to `http(s)://`, `mailto:`, `#`, and relative paths via an explicit `urlTransform`.
+
+### Attacker capabilities
+
+| Attacker | Has access to | Out of reach |
+|---|---|---|
+| Random LinkedIn reader | npm tarball, GitHub repo, README | Adopter's machine, gh token, dev-log content |
+| Adopter who edits config.json | Their own filesystem, gh token | Other adopters' machines |
+| Contributor with PR rights to dev-log repo | Markdown content rendered by adopter's site | Adopter's local files, gh token |
+
+### What's protected
+
+- **Command injection in the CLI:** every shell call that includes user input uses `spawnSync` with argv arrays (no shell). The four hardcoded `execSync` calls (`gh --version`, `gh auth status`, `gh api user --jq .login`, `git config --global user.name`) take no user input.
+
+- **Command injection via the skill:** the skill validates every config value against an allowlist before interpolation, instructs the LLM to single-quote every value, and uses `git -C <path>` form rather than `cd <path> && git ...` to reduce shell-composition surface.
+
+- **Path traversal:** project keys, manifest filenames, and project paths are all pattern-matched. Project paths additionally cannot start with `-` (would be parsed as a flag). Manifest filenames must match `^[a-zA-Z0-9._-]+\.md$`.
+
+- **XSS via markdown:** `react-markdown` 9 with `skipHtml`, plus an explicit `urlTransform` allowlisting only `http(s)://`, `mailto:`, `#`, and relative URLs. Schemes like `data:`, `blob:`, `javascript:`, `vbscript:`, `file:` are replaced with `#`.
+
+- **Prototype pollution via frontmatter:** the parser uses `Object.create(null)` and only writes to keys in `{title, date, project, summary}` — so `__proto__: x` in a hostile entry has no effect.
+
+- **Schema confusion:** every external JSON document (manifest, parsed env-var projects array) is validated against a strict schema before use. Malformed input is rejected, not "fixed."
+
+- **Demo-mode side effects in production:** the global `window.fetch` override is gated to `import.meta.env.DEV`. Production builds without env vars show a clear "Setup required" screen instead of broken-looking entries.
+
+- **Env var leakage to client-side:** the CLI passes only `VITE_DEVLOG_*` variables (plus `PATH`/`HOME`/etc. needed for Vite to run) to the spawned vite process. Adopter's other `VITE_*` shell vars do NOT leak into the preview bundle.
+
+- **Vite dev server exposure:** explicit `server.host: 'localhost'` + `cors: false`. The dev server cannot be reached from other machines on the LAN by default.
+
+- **Atomic config writes:** `config.json` is written to a sibling `.tmp.<pid>` file then renamed atomically. Readers never see partial state.
+
+- **Tight `.gitignore`:** excludes `.npmrc`, `.env*`, `*.pem`, `*.key`, `.vscode/`, `.idea/`, `coverage/` so future contributors can't accidentally publish secrets via the `files` whitelist in package.json.
+
+- **Pinned dependencies:** every dependency is pinned to an exact version (no `^` ranges) to eliminate resolution drift across installs.
+
+### What's NOT protected (intentional risk acceptance)
+
+- **Adopter editing config.json with malicious values.** The skill validates at runtime and refuses to run on bad input — but a sufficiently determined user can bypass any client-side guard by directly running shell commands themselves. The package can't protect against the adopter attacking their own machine.
+
+- **Adopter installing a typosquatted package.** Always verify the scope is `@natjswenson` (no extra `e`).
+
+- **GitHub raw URL paths.** A manifest entry's `file` field is restricted to `^[a-zA-Z0-9._-]+\.md$`, but the project key is part of the URL path. The schema validator on project keys rejects `..`, `/`, and other traversal characters.
+
+## Reproducible attack scenarios that have been ruled out
+
+Each of the following has been tested against the current code and shown to be ineffective. Reports of these scenarios will be acknowledged but treated as "already addressed."
+
+1. `gitAuthor: "Nate\"; rm -rf ~; #"` in config.json → blocked by Step 0.5 validation in skill, rejected by CLI prompt validator.
+2. `path: "/tmp/$(id)"` in config.json → blocked by SHELL_METACHARS regex.
+3. `targetRepo: "-h"` or `--template <evil-repo>` → rejected by `^[a-z0-9][a-z0-9._-]*$` regex requiring leading alphanumeric.
+4. `__proto__: pwned` in entry frontmatter → ignored by allowlist + `Object.create(null)` parser.
+5. `[click me](javascript:alert(1))` in entry markdown → react-markdown's default sanitizer + our `urlTransform` rewrite to `#`.
+6. `[click](data:text/html,<script>...)` in entry markdown → rewritten to `#` by `urlTransform`.
+7. Manifest entry with `file: "../../../other-repo/secret.md"` → rejected by `^[a-zA-Z0-9._-]+\.md$` schema.
+8. Concurrent editor seeing a half-written `config.json` → atomic rename guarantees readers see either the old or new file, never a partial write.
+9. `VITE_API_KEY=secret npx ... preview` leaking through into the preview bundle → blocked by env-var allowlist in CLI.
+
+## Audit history
+
+| Date | Version | Audit | Result |
+|---|---|---|---|
+| 2026-05-01 | 0.1.5 → 0.1.7 | 6-agent siege (Boundary Attacker, Insider Threat, Infrastructure Prober, Betrayed Consumer, Fresh Attacker, Chain Analyst) | 1 Critical + 3 High + 7 Medium + 4 Low → 0 Critical + 0 High + 0 Medium-Active in 0.1.7 |

package/SKILL.md

@@ -47,6 +47,43 @@ If the file does not exist or cannot be parsed, stop and tell the user:
 
 Validate that `targetRepo`, `gitAuthor`, `githubUser`, and `projects` (non-empty array) are all present. Each project must have `key`, `path`, and `remote`.
 
+### Step 0.5: SECURITY — validate config values before using them in shell commands
+
+**Critical:** every value below gets interpolated into shell commands. If any value contains shell metacharacters or breaks the expected shape, **STOP** and tell the user their config is malformed. Do not "fix" it — refuse to run.
+
+The CLI's `init` and `add-project` commands enforce these patterns at write time. The skill MUST re-enforce them at runtime because the user can edit `config.json` by hand at any time.
+
+| Field | Required pattern |
+|---|---|
+| `targetRepo` | Matches `^[a-zA-Z0-9][a-zA-Z0-9._-]*\/[a-zA-Z0-9][a-zA-Z0-9._-]*$` (owner/repo, no leading dash) |
+| `branch` (optional) | Matches `^[a-zA-Z0-9][a-zA-Z0-9._/-]*$` (no leading dash, no `..` as a path component); defaults to `main` |
+| `gitAuthor` | Must NOT contain any of: `;` `&` `\|` `` ` `` `$` `(` `)` `<` `>` `{` `}` `[` `]` `*` `?` `!` `#` `~` `"` `'` `\` newline, CR. (Whitespace, dots, hyphens, equals, percent are fine — names like "Nate Swenson" and "O.G. Lastname" must validate.) |
+| `githubUser` | Matches `^[a-zA-Z0-9][a-zA-Z0-9-]*$` |
+| `projects[].key` | Matches `^[a-zA-Z0-9][a-zA-Z0-9._-]*$` AND must not contain `..` |
+| `projects[].path` | Must NOT contain the shell-quote-break set (same as gitAuthor), MUST NOT start with `-`, AND must point to an existing directory. Whitespace allowed (paths legitimately contain spaces). |
+| `projects[].label` (optional) | Same character constraints as `gitAuthor` — used as display text, never as a shell argument |
+| `projects[].remote` | Same pattern as `targetRepo` |
+
+If any field fails validation, stop with:
+> Config field `<field>` failed security validation: `<value>`. Edit `~/.claude/skills/devlog/config.json` and retry, or run `npx @natjswenson/devlog config` to inspect.
+
+**Shell-quoting rule (defense-in-depth):**
+
+Even with values validated, when interpolating into a shell command, ALWAYS wrap the value in single quotes (`'...'`). Single-quoted shell strings have no metacharacter expansion. Since validation above forbids embedded single quotes, this is always safe. Example:
+
+```bash
+# Right
+git -C '<project.path>' log --author='<config.gitAuthor>' --since=midnight ...
+
+# Also right (separate flags after `=`)
+git -C '<project.path>' log "--author=<config.gitAuthor>" --since=midnight ...
+
+# Wrong — no quotes
+git -C <project.path> log ...
+```
+
+Once validated AND single-quoted, the values are safe to interpolate into the shell commands below. Even so, **prefer `git -C <path>` form over `cd <path> && git ...`** (reduces shell-escape complexity) and **use the Write tool, not bash heredocs, when writing JSON or markdown files** (avoids accidentally re-injecting attacker-controlled content into shell).
+
 ## Step 1: Determine scope
 
 - If the user passed a project argument (e.g. `/devlog myproject`), filter `projects` to that one. If the key is not in the registry, list available keys and stop.
@@ -54,10 +91,10 @@ Validate that `targetRepo`, `gitAuthor`, `githubUser`, and `projects` (non-empty
 
 ## Step 2: Gather today's commits
 
-For each project in scope, run:
+For each project in scope, run (use `git -C` to avoid `cd` shell-composition; single-quote interpolated values):
 
 ```bash
-cd <project.path> && git log --author="<config.gitAuthor>" --since="midnight" --format="%H|%s|%D" --all
+git -C '<project.path>' log "--author=<config.gitAuthor>" --since=midnight --format='%H|%s|%D' --all
 ```
 
 If no commits are found for a project, skip it. If no commits are found across all projects, inform the user and stop.
@@ -67,8 +104,8 @@ If no commits are found for a project, skip it. If no commits are found across a
 For each commit, check if it's on the `main` branch and if the remote is public:
 
 ```bash
-cd <project.path> && git remote get-url origin
-git branch --contains <hash> -r 2>/dev/null | grep -q 'origin/main'
+git -C '<project.path>' remote get-url origin
+git -C '<project.path>' branch --contains <hash> -r 2>/dev/null | grep -q 'origin/main'
 ```
 
 - If the remote URL matches `<project.remote>` (i.e. `github.com/<project.remote>` or the SSH equivalent) and the commit is on `origin/main`, it's a public commit — include a link using `https://github.com/<project.remote>/commit/<hash>`.
@@ -125,33 +162,41 @@ gh api repos/<config.targetRepo>/contents/<project.key>/YYYY-MM-DD.md --jq '.con
 
 ## Step 6: Push to GitHub
 
-Clone the repo once, write all project entries, then push:
+Clone the repo once, write all project entries, then push.
+
+**Important:** Claude Code's bash tool runs each invocation in a fresh shell — variables don't persist across calls. Use a single temp path you compute once and pass as an absolute path to every subsequent command. Do NOT rely on `$TMPDIR` or any other shell variable surviving between bash calls.
+
+```bash
+# Step 6.1: create temp dir, capture absolute path (use this exact path
+# in every subsequent command — do not reference $TMPDIR after this call)
+mktemp -d
+# → record the printed path, e.g. /var/folders/.../tmp.abc123
+
+# Step 6.2: clone (use --depth=1 to limit blast radius if remote is huge;
+# the targetRepo value has been validated to match <owner>/<repo> already)
+git -C '<abs-tmp-path>' clone --depth=1 'https://github.com/<config.targetRepo>.git'
+```
+
+Write entries and manifest using the **Write tool** (not bash heredocs — avoids re-injecting content into shell):
+
+- For each project with commits:
+  - Path: `<abs-tmp-path>/<repo-name>/<project.key>/YYYY-MM-DD.md`
+  - Path: `<abs-tmp-path>/<repo-name>/<project.key>/manifest.json` — read with the Read tool, mutate the entries array (newest first), write back
+  - Entry object: `{ "date": "YYYY-MM-DD", "file": "YYYY-MM-DD.md", "title": "...", "summary": "..." }`
+  - If appending to existing entry, update title/summary only if changed
+  - If manifest doesn't exist, create it as `{ "entries": [...] }`
+  - **Sanitize fetched title/summary:** if appending to an existing entry, the fetched values are external content — never echo them through bash without escaping. Use the Write tool with the values as JSON literals.
+
+Then commit and push (single-quote all interpolated values):
 
 ```bash
-# Clone to temp directory
-TMPDIR=$(mktemp -d)
-cd "$TMPDIR"
-git clone https://github.com/<config.targetRepo>.git
-cd $(basename <config.targetRepo>)
-
-# For each project with commits:
-# - Create directory if needed: mkdir -p <project.key>/
-# - Write the entry file to <project.key>/YYYY-MM-DD.md
-# - Update <project.key>/manifest.json
-#   - Read manifest, add/update entry in entries array (newest first)
-#   - Entry object: { "date": "YYYY-MM-DD", "file": "YYYY-MM-DD.md", "title": "...", "summary": "..." }
-#   - If appending to existing entry, update title/summary only if changed
-#   - If manifest doesn't exist, create it as { "entries": [...] }
-
-# Stage all changed project directories
-git add .
-
-# Single commit covering all projects
-git commit -m "devlog: add entries for YYYY-MM-DD"
-git push origin <config.branch || 'main'>
-
-# Cleanup
-rm -rf "$TMPDIR"
+git -C '<abs-tmp-path>/<repo-name>' add .
+git -C '<abs-tmp-path>/<repo-name>' commit -m 'devlog: add entries for YYYY-MM-DD'
+# Use --no-tags to avoid pushing any local tags that happened to be in the temp clone
+git -C '<abs-tmp-path>/<repo-name>' push --no-tags origin '<config.branch || main>'
+
+# Cleanup — pass the absolute path explicitly
+rm -rf '<abs-tmp-path>'
 ```
 
 ## Step 7: Confirm