@c4a/context-cli 0.6.0-beta.3 → 0.6.0-beta.5

package/README.md

@@ -77,6 +77,11 @@ context source add repo sample-lib --local ../sample-lib
 # Do not register the parent monorepo and use extractTs.include as a package selector.
 context source add repo sample-lib --local ../packages/sample-lib
 
+# Keep non-standard TypeScript entry roots in the Context project src/index.ts.
+# Do not add package.json entry fields or source files solely for Context.
+# extractTs({ source, collection: "codegraph", include: ["src/**/*.ts"], entries: ["src/api.ts"] })
+# Use mode: "scan" instead when every include-matched file is a scan root.
+
 # Optional overrides when origin / HEAD cannot be inferred:
 context source add repo sample-lib \
   --local ../sample-lib \
@@ -135,7 +140,7 @@ For project workflows, `context` is a semantic service. Agents should call the C
 | `context source list|get <name>` | CLI | Inspect the repo source registry and readiness metadata. |
 | `context source inspect [name]` | CLI | Detect module/package boundaries in registered repo sources without extraction. Use this before extracting monorepo roots; it prints package names, paths, versions when available, and suggested source registration commands. |
 | `context run --list` | CLI | List phases declared by `src/index.ts`. |
-| `context run <phase-id> [--dry-run]` | CLI | Inspect or run one declared phase. Dry run prints reads/writes and, for extract phases when sources are ready, a resolved preview with modules, file counts, symbol counts, candidate estimates, and module error hints. It does not mutate project files. |
+| `context run <phase-id> [--dry-run] [--auto-promote]` | CLI | Inspect or run one declared phase. Extract dry-run separates discovered, AST-analyzed, skipped, symbol, and relation counts. Missing/empty entries fail with `NO_ENTRY_DETECTED`; TypeScript aliases come from tsconfig/jsconfig `baseUrl` and `paths`. Codegraph defaults to first-run full Review and later delta-only Review; `--auto-promote` is the verified codegraph-only CI/CD mode. |
 | `context review html [collection] [--open]` | CLI | Render the local self-contained HTML review surface under `.tmp/context-runtime/review/`, emit a clickable `file://` URL, and optionally open it with the system browser. |
 | `context review list [collection]` | CLI | List draft candidates for CLI-oriented review. |
 | `context review apply <payload-file>` | CLI | Apply copied review decisions; approved entities materialize to `knowledge/`, rejected entities remain in `unapproved/entities.jsonl`. |