feat(shell-projection): add exec* dispatch and platform* file I/O seam (#3465) (#3470)
* feat(shell-projection): add exec* dispatch and platform* file I/O seam (Phase 1, #3465)
Extends shell-command-projection.cjs with two new sections:
Subprocess dispatch:
- execGit(args, opts) → { exitCode, stdout, stderr }
- execNpm(args, opts) → same; owns shell:true on Windows (npm.cmd)
- execTool(program, args, opts) → same; ENOENT → exitCode 127, no throw
- probeTty(opts) → string | null; returns null on Windows and non-tty
Platform file I/O:
- normalizeContent(filePath, content) → { content, encoding }; pure function;
.md → full normalizeMd pass; other → CRLF→LF + trailing newline
- platformWriteSync(filePath, content, opts) → ensureDir + normalizeContent + atomic write
- platformReadSync(filePath, opts) → null on ENOENT; throws when required:true
- platformEnsureDir(dirPath) → mkdirSync recursive, idempotent
Absorbs normalizeMd fence-tracking logic from core.cjs (no circular dep).
Existing rendering exports untouched. core.cjs compat exports unchanged until Phase 4.
Updates CONTEXT.md with Shell Command Projection Module canonical definition.
31 new behavioral tests; full suite green.
Closes #3465
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* docs(context): record shell-projection expansion session learnings
* chore(changeset): add entry for shell-projection I/O seam (#3465)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* docs(adr): add ADR-0010 skill-surface budget module and ADR-0011 review default reviewers (Phase 1, #3465)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* docs(context): record phase 1 rebase and PR session learnings (#3465)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* test(shell-projection): drop substring match on stderr — assert typed shape only
The lint-no-source-grep rule prohibits substring matching on stderr (or any
test-output text). The exitCode === 127 assertion already proves the ENOENT
path; the stderr content was implementation-detail of the OS.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* fix(pr3470): address CodeRabbit findings and minimal-core drift
* docs(adr0010): align profile interface with phase-1 scope
* docs(adr): index newly added 0010/0011 ADR drafts in README
enh-3271 invariant requires every file in docs/adr/ to be linked from
the README. Adds entries for the three ADR drafts committed earlier
in this PR.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---------
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
ba625c0978