@codex-agent/cli 0.1.0-main.13.sha3ad2ccf → 0.1.0-main.14.shac4b2c28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +12 -1
  2. package/dist/codex-agent.mjs +866 -470
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -14,7 +14,18 @@ npx --yes @codex-agent/cli@latest migrate navigation --from /path/to/project --j
14
14
  npx --yes @codex-agent/cli@latest eval --json
15
15
  ```
16
16
 
17
- Run these commands from the target repository. Use `npx @codex-agent/cli@latest help` to list every command. Context initialization, refresh, and saving preview changes by default. For init or refresh, pass `--apply --plan-hash <reviewed-plan-hash>` so repository drift cannot change the reviewed proposal; context saving uses `--apply`, and existing curated-context updates also require `--update`.
17
+ Run these commands from the target repository. Use `npx @codex-agent/cli@latest help` to list every command. Context initialization and refresh show a human-readable approval plan by default, including repository evidence, file actions, preserved surfaces, conflicts, and safeguards. The plan's integrity ID protects against drift; when working through Codex, approve the displayed plan in natural language and Codex retains the ID internally. Direct automation can still pass `--apply --plan-hash <reviewed-plan-hash>`. Context saving uses `--apply`, and existing curated-context updates also require `--update`.
18
+
19
+ Project analysis uses one ecosystem-neutral pipeline: inventory, declared solution/workspace membership, detector registry, ownership and path roles, fact aggregation, and rendering. Its v2 result reports plural `toolchains`, `technologies`, and `units`; no package manager or language is treated as the repository-wide default. Declared units override ignore and transient-name heuristics, while the `scan` signal makes exclusions and truncation explicit.
20
+
21
+ When repository ownership requires an optional managed surface to remain untouched, repeat `--exclude-managed` in both preview and apply. The supported paths are `.codex/config.toml` and `.gitignore`; exclusions are validated and included in the `planHash`.
22
+
23
+ ```bash
24
+ npx --yes @codex-agent/cli@latest context init \
25
+ --exclude-managed .codex/config.toml \
26
+ --exclude-managed .gitignore \
27
+ --json
28
+ ```
18
29
 
19
30
  `migrate navigation` discovers navigation-based Markdown context trees, skips incompatible runtime material by default, and writes native indexed context only with `--apply`.
20
31