git:20261012.64bdf7d to git:20261012.83db886

3 added, 2 removed. Audit A to A.

# @shadowclone/environment

Holds what agents receive: the environment record, skill publication, native instruction sections, hooks, install, and undo.

(generated by `bun run guides`; do not edit by hand)

- Package name: `@shadowclone/environment`

- Workspace dependencies: `@shadowclone/agents`, `@shadowclone/changes`, `@shadowclone/core`, `@shadowclone/profile`, `@shadowclone/redact`, `@shadowclone/sessions`, `@shadowclone/skills`

- External dependencies: `zod`

- Export subpaths: `.`, `./testing`, `./browser`

## Owns

- `src/environment/`: the store (`readEnvironment`, `writeEnvironment`), `publishEnvironmentRevision`, `undoRevision`, `syncLearningEnvironment`, and `environmentStatus`.

- `src/environment/builds/` and `harness/`: build definitions, routing text, and the harness manifest.

- `src/integrations/`: native sections, hooks, `installIntegration`, `uninstallIntegration`, and `compileContext`.

- `src/integrations/installation/`: the install record and artifact ownership checks.

- `src/environment/learningNotice.ts`, `repositoryQuestion.ts`, and `reviewPrompt.ts`: the one-time triage notice, the repository destination question, and the prompt to review waiting proposals in session-start context.

- `src/integrations/contextSkill.ts`: the `shadowclone-context` skill that each agent receives, including the steps to review proposals with the user.

## Rules

- Every write goes through `publishEnvironmentRevision`. A path outside the authorized destinations is an error.

- `undoRevision` takes the write lock. It refuses an unauthorized root and a revision that conflicts with later edits.

- Native routing text is at most 4096 bytes. A longer text is an error, and the old section stays.

- Shadowclone rewrites only the text between the `<shadowclone-guidance>` markers. Malformed markers are an error.

- Shadowclone replaces an installed file only when its fingerprint matches the install record. A manual edit stays.

- - Migration copies the original skills and native instructions to `environment-baselines/` before it publishes.

+ - Initialization copies the original skills and native instructions to `environment-baselines/` before it publishes.

+ - The skills environment is the only store for learned rules. Without `environment.json`, learning and `remember` stop and say to run `shadowclone init`, and context delivery is empty.

- A repository with `privateSkillsDirectory` publishes skills only under `~/.shadowclone/builds/`. Its routing names each skill by its file path, and no repository file changes.

## Tests

- Run `bun test` in this folder, or `bun test packages/environment` from the root. The `./testing` export gives `learningRecord` and `skillFixture`. Several tests run `git` on temporary repositories.

+ Run `bun test` in this folder, or `bun test packages/environment` from the root. The `./testing` export gives `environmentFixture`, `writeActiveEnvironment`, `learningRecord`, and `skillFixture`. Several tests run `git` on temporary repositories.

Update this file in the same commit when you change the package purpose, public exports, dependencies, or a rule above.