context-loader 1.0.0__tar.gz → 1.2.0__tar.gz

{context_loader-1.0.0 → context_loader-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: context-loader
-Version: 1.0.0
+Version: 1.2.0
 Summary: Render deterministic local Git context for any executor
 License:                                  Apache License
                                     Version 2.0, January 2004
@@ -219,15 +219,14 @@ Python standard library.
 
 ## Open-source quick start
 
-Context Loader is a local CLI that exports repository context deterministically for coding-agent workflows,
-rendering stable Markdown or JSON output.
+Current stable release: **1.2.0**. Local CLI for coding-agent workflows; renders deterministic Markdown or JSON.
 
 ```bash
-uv tool install context-loader
+uv tool install 'context-loader==1.2.0'
 ```
 
 ```bash
-pip install context-loader
+pip install 'context-loader==1.2.0'
 ```
 
 ```bash
@@ -240,21 +239,21 @@ project-context --repo /path/to/repo --format json
 
 ## Install
 
-Source version: `1.0.0`. Install its matching published release or an exact source commit.
+Source version: `1.2.0`. Install its matching published release or an exact source commit.
 
 Install via `uv`:
 
 ```bash
-uv tool install context-loader
+uv tool install 'context-loader==1.2.0'
 ```
 
 Install via `pip`:
 
 ```bash
-pip install context-loader
+pip install 'context-loader==1.2.0'
 ```
 
-For development or source-based installs tracking current repository (`1.0.0`):
+For development or source-based installs tracking current repository (`1.2.0`):
 
 ```bash
 uv tool install git+https://github.com/xuanheng-tech/context-loader.git
@@ -305,16 +304,17 @@ project-context --version
 project-context --repo /home/user/projects/example
 project-context --repo /home/user/projects/example --format markdown
 project-context --repo /home/user/projects/example --format json
+project-context --repo /home/user/projects/example --format json-compact
 project-context --repo /home/user/projects/example \
   --focus "Authentication and session management" \
   --path auth/session.py
 ```
 
 `--format` defaults to `markdown`. In Markdown mode, `--repo` retains the 0.1.1 contract: it must be
-the absolute, canonical root of a non-bare Git working tree. In JSON mode, an absolute existing
-directory inside the working tree is accepted; symlinks are normalized and the discovered root is
-reported as `canonical_root`. Relative paths, non-Git directories, regular files, and bare
-repositories are rejected in both modes.
+the absolute, canonical root of a non-bare Git working tree. In the `json` and `json-compact` modes,
+an absolute existing directory inside the working tree is accepted; symlinks are normalized and the
+discovered root is reported as `canonical_root`. Relative paths, non-Git directories, regular files,
+and bare repositories are rejected in every mode.
 
 `--focus` and `--path` are optional, bounded selection signals for the root `AGENTS.md`. `--path`
 must be repository-relative. The collector does not retain either input in output or audit data.
@@ -337,15 +337,17 @@ The output has no generated timestamp, AI summary, architecture inference, or di
 
 ## JSON Output
 
-`--format json` writes exactly one compact UTF-8 JSON document plus one trailing newline to stdout.
-Keys are serialized in sorted order with `ensure_ascii=False`. The declared contract is:
+`--format json` writes exactly one separator-compact UTF-8 JSON document plus one trailing newline
+to stdout. Keys are serialized in sorted order with `ensure_ascii=False`. `--format json-compact`
+uses the identical serialization; only the field set differs, as described under “Compact model
+consumption”. The declared contract for `--format json` is:
 
 ```json
 {
   "schema_version": 1,
   "tool": {
     "name": "context-loader",
-    "version": "1.0.0"
+    "version": "1.2.0"
   },
   "repository": {
     "requested_path": "/canonical/requested/path",
@@ -374,22 +376,45 @@ Keys are serialized in sorted order with `ensure_ascii=False`. The declared cont
   ],
   "context": "the same assembled Markdown context",
   "context_sha256": "sha256-hex",
+  "statuses": [],
   "warnings": []
 }
 ```
 
 `context_sha256` hashes the UTF-8 bytes of `context`; each `content_sha256` does the same for that
-source's `content`. `sources` contains only file bodies that actually enter the final context, in
-assembly order, after the existing newline normalization and truncation rules. `scope` distinguishes
-`repository` from `global`; version 1.0.0's fixed root-file selection currently emits only
-`repository` sources and does not add any global-file discovery.
+source's `content` body as rendered (after newline normalization, any `AGENTS.md` section selection
+and any truncation marker) — never for the raw bytes of the file at `path`, which match only for
+unselected, untruncated LF files. `sources` contains only file bodies that actually enter the final
+context, in assembly order, after the existing newline normalization and truncation rules. `scope`
+distinguishes `repository` from `global`; version 1.0.0's fixed root-file selection currently emits
+only `repository` sources and does not add any global-file discovery.
+
+`statuses` lists machine-readable collection and render conditions that previously appeared only inside `context` Markdown: skipped or absent sources, truncated sources, unreadable directory-tree entries, sections omitted under the global output budget, and truncated working-tree or declared-command listings. Each entry has stable `code`, `subject_kind`, and `subject` fields. `sources`, `context`, and `schema_version` remain unchanged; callers can ignore `statuses` safely.
 
 The optional `selection` object is present only on a rendered `AGENTS.md` source. Its section entries
 contain heading, heading level, and fixed selection reasons; it never contains the original focus or
 target path. Existing source fields and schema version 1 remain unchanged.
 
-The JSON schema version and package version are independent: `schema_version` is currently the
-integer `1`, while `tool.version` is `1.0.0`. Callers must depend only on fields declared above.
+### Compact model consumption (`--format json-compact`)
+
+`--format json-compact` emits a `schema_version` 2 document: exactly the version-1 document with
+`sources[*].content` omitted. Every other field — `context`, `context_sha256`, `statuses`,
+`warnings`, `tool`, `repository`, and each source's `ordinal`, `kind`, `scope`, `path`,
+`content_sha256` and optional `selection` — is identical to `--format json` for the same arguments.
+The projection exists because the selected source bodies already occur verbatim inside `context`,
+so carrying them again in `sources` duplicates a large share of the document bytes (measured up to
+~44% on real worktrees, scaling with how much of `context` those bodies occupy) for a model
+consumer without adding information. Nothing is lost: each omitted body remains inside `context`,
+`content_sha256` still fingerprints that rendered body, and `path` plus `canonical_root` locate the
+underlying file for a bounded manual re-read (whose raw bytes may differ from the rendered body as
+defined above). `schema_version` is an exact document selector, not an upgrade marker: version 2 is
+a field-set projection of version 1, so consumers must branch on the value and must not apply
+`>=`-superset reasoning. Default Markdown and `--format json` output bytes, exit codes and
+determinism are unchanged.
+
+The JSON schema version and package version are independent: `--format json` currently emits
+`schema_version` `1` and `--format json-compact` emits `2`, while `tool.version` is `1.2.0`.
+Callers must depend only on fields declared above.
 The document contains no generated time or random identifier, so unchanged input produces identical
 JSON bytes. On failure, stdout remains empty and stderr contains only a short diagnostic.
 
@@ -497,8 +522,11 @@ just check
 ## Version maintenance
 
 The versions in `pyproject.toml` and `context_loader/__init__.py`, the matching `CHANGELOG.md`
-section, and required tests must change in the same release-preparation batch. `CHANGELOG.md` is the
-authoritative version-change record. Merging to `master` is not a release; formal publication
+section, required tests, and the README current-stable declaration plus `context-loader==X.Y.Z`
+install pins must change in the same release-preparation batch. `CHANGELOG.md` is the
+authoritative version-change record. `scripts/release.py` rejects README stable/install
+pins that disagree with the intended package version; historical changelog entries are
+not part of that check. Merging to `master` is not a release; formal publication
 still requires a separately created and pushed tag.
 
 ## Release closure and retries

{context_loader-1.0.0 → context_loader-1.2.0}/README.md

@@ -8,15 +8,14 @@ Python standard library.
 
 ## Open-source quick start
 
-Context Loader is a local CLI that exports repository context deterministically for coding-agent workflows,
-rendering stable Markdown or JSON output.
+Current stable release: **1.2.0**. Local CLI for coding-agent workflows; renders deterministic Markdown or JSON.
 
 ```bash
-uv tool install context-loader
+uv tool install 'context-loader==1.2.0'
 ```
 
 ```bash
-pip install context-loader
+pip install 'context-loader==1.2.0'
 ```
 
 ```bash
@@ -29,21 +28,21 @@ project-context --repo /path/to/repo --format json
 
 ## Install
 
-Source version: `1.0.0`. Install its matching published release or an exact source commit.
+Source version: `1.2.0`. Install its matching published release or an exact source commit.
 
 Install via `uv`:
 
 ```bash
-uv tool install context-loader
+uv tool install 'context-loader==1.2.0'
 ```
 
 Install via `pip`:
 
 ```bash
-pip install context-loader
+pip install 'context-loader==1.2.0'
 ```
 
-For development or source-based installs tracking current repository (`1.0.0`):
+For development or source-based installs tracking current repository (`1.2.0`):
 
 ```bash
 uv tool install git+https://github.com/xuanheng-tech/context-loader.git
@@ -94,16 +93,17 @@ project-context --version
 project-context --repo /home/user/projects/example
 project-context --repo /home/user/projects/example --format markdown
 project-context --repo /home/user/projects/example --format json
+project-context --repo /home/user/projects/example --format json-compact
 project-context --repo /home/user/projects/example \
   --focus "Authentication and session management" \
   --path auth/session.py
 ```
 
 `--format` defaults to `markdown`. In Markdown mode, `--repo` retains the 0.1.1 contract: it must be
-the absolute, canonical root of a non-bare Git working tree. In JSON mode, an absolute existing
-directory inside the working tree is accepted; symlinks are normalized and the discovered root is
-reported as `canonical_root`. Relative paths, non-Git directories, regular files, and bare
-repositories are rejected in both modes.
+the absolute, canonical root of a non-bare Git working tree. In the `json` and `json-compact` modes,
+an absolute existing directory inside the working tree is accepted; symlinks are normalized and the
+discovered root is reported as `canonical_root`. Relative paths, non-Git directories, regular files,
+and bare repositories are rejected in every mode.
 
 `--focus` and `--path` are optional, bounded selection signals for the root `AGENTS.md`. `--path`
 must be repository-relative. The collector does not retain either input in output or audit data.
@@ -126,15 +126,17 @@ The output has no generated timestamp, AI summary, architecture inference, or di
 
 ## JSON Output
 
-`--format json` writes exactly one compact UTF-8 JSON document plus one trailing newline to stdout.
-Keys are serialized in sorted order with `ensure_ascii=False`. The declared contract is:
+`--format json` writes exactly one separator-compact UTF-8 JSON document plus one trailing newline
+to stdout. Keys are serialized in sorted order with `ensure_ascii=False`. `--format json-compact`
+uses the identical serialization; only the field set differs, as described under “Compact model
+consumption”. The declared contract for `--format json` is:
 
 ```json
 {
   "schema_version": 1,
   "tool": {
     "name": "context-loader",
-    "version": "1.0.0"
+    "version": "1.2.0"
   },
   "repository": {
     "requested_path": "/canonical/requested/path",
@@ -163,22 +165,45 @@ Keys are serialized in sorted order with `ensure_ascii=False`. The declared cont
   ],
   "context": "the same assembled Markdown context",
   "context_sha256": "sha256-hex",
+  "statuses": [],
   "warnings": []
 }
 ```
 
 `context_sha256` hashes the UTF-8 bytes of `context`; each `content_sha256` does the same for that
-source's `content`. `sources` contains only file bodies that actually enter the final context, in
-assembly order, after the existing newline normalization and truncation rules. `scope` distinguishes
-`repository` from `global`; version 1.0.0's fixed root-file selection currently emits only
-`repository` sources and does not add any global-file discovery.
+source's `content` body as rendered (after newline normalization, any `AGENTS.md` section selection
+and any truncation marker) — never for the raw bytes of the file at `path`, which match only for
+unselected, untruncated LF files. `sources` contains only file bodies that actually enter the final
+context, in assembly order, after the existing newline normalization and truncation rules. `scope`
+distinguishes `repository` from `global`; version 1.0.0's fixed root-file selection currently emits
+only `repository` sources and does not add any global-file discovery.
+
+`statuses` lists machine-readable collection and render conditions that previously appeared only inside `context` Markdown: skipped or absent sources, truncated sources, unreadable directory-tree entries, sections omitted under the global output budget, and truncated working-tree or declared-command listings. Each entry has stable `code`, `subject_kind`, and `subject` fields. `sources`, `context`, and `schema_version` remain unchanged; callers can ignore `statuses` safely.
 
 The optional `selection` object is present only on a rendered `AGENTS.md` source. Its section entries
 contain heading, heading level, and fixed selection reasons; it never contains the original focus or
 target path. Existing source fields and schema version 1 remain unchanged.
 
-The JSON schema version and package version are independent: `schema_version` is currently the
-integer `1`, while `tool.version` is `1.0.0`. Callers must depend only on fields declared above.
+### Compact model consumption (`--format json-compact`)
+
+`--format json-compact` emits a `schema_version` 2 document: exactly the version-1 document with
+`sources[*].content` omitted. Every other field — `context`, `context_sha256`, `statuses`,
+`warnings`, `tool`, `repository`, and each source's `ordinal`, `kind`, `scope`, `path`,
+`content_sha256` and optional `selection` — is identical to `--format json` for the same arguments.
+The projection exists because the selected source bodies already occur verbatim inside `context`,
+so carrying them again in `sources` duplicates a large share of the document bytes (measured up to
+~44% on real worktrees, scaling with how much of `context` those bodies occupy) for a model
+consumer without adding information. Nothing is lost: each omitted body remains inside `context`,
+`content_sha256` still fingerprints that rendered body, and `path` plus `canonical_root` locate the
+underlying file for a bounded manual re-read (whose raw bytes may differ from the rendered body as
+defined above). `schema_version` is an exact document selector, not an upgrade marker: version 2 is
+a field-set projection of version 1, so consumers must branch on the value and must not apply
+`>=`-superset reasoning. Default Markdown and `--format json` output bytes, exit codes and
+determinism are unchanged.
+
+The JSON schema version and package version are independent: `--format json` currently emits
+`schema_version` `1` and `--format json-compact` emits `2`, while `tool.version` is `1.2.0`.
+Callers must depend only on fields declared above.
 The document contains no generated time or random identifier, so unchanged input produces identical
 JSON bytes. On failure, stdout remains empty and stderr contains only a short diagnostic.
 
@@ -286,8 +311,11 @@ just check
 ## Version maintenance
 
 The versions in `pyproject.toml` and `context_loader/__init__.py`, the matching `CHANGELOG.md`
-section, and required tests must change in the same release-preparation batch. `CHANGELOG.md` is the
-authoritative version-change record. Merging to `master` is not a release; formal publication
+section, required tests, and the README current-stable declaration plus `context-loader==X.Y.Z`
+install pins must change in the same release-preparation batch. `CHANGELOG.md` is the
+authoritative version-change record. `scripts/release.py` rejects README stable/install
+pins that disagree with the intended package version; historical changelog entries are
+not part of that check. Merging to `master` is not a release; formal publication
 still requires a separately created and pushed tag.
 
 ## Release closure and retries

{context_loader-1.0.0 → context_loader-1.2.0}/context_loader/__init__.py

@@ -1,3 +1,3 @@
 """Project Context Loader."""
 
-__version__ = "1.0.0"
+__version__ = "1.2.0"

{context_loader-1.0.0 → context_loader-1.2.0}/context_loader/application.py

@@ -10,9 +10,16 @@ from pathlib import Path
 
 from . import __version__
 from .collect import (
+    NOT_PRESENT,
+    SKIPPED_ENCODING,
+    SKIPPED_NOT_REGULAR,
+    SKIPPED_SYMLINK,
+    SKIPPED_UNREADABLE,
+    TRUNCATION_MARKER,
     AgentsSectionAuditEntry,
     AgentsSelectionAudit,
     AgentsSelectionInputError,
+    CollectedFile,
     ProjectContext,
     collect_project_context,
 )
@@ -20,8 +27,17 @@ from .git import ContextLoaderError, collect_repository
 from .render import render_markdown_with_details, rendered_source_contents
 
 JSON_SCHEMA_VERSION = 1
+COMPACT_JSON_SCHEMA_VERSION = 2
 TOOL_NAME = "context-loader"
 
+_STATUS_CODE_BY_MESSAGE = {
+    NOT_PRESENT: "not_present",
+    SKIPPED_SYMLINK: "skipped_symlink",
+    SKIPPED_NOT_REGULAR: "skipped_not_regular",
+    SKIPPED_ENCODING: "skipped_encoding",
+    SKIPPED_UNREADABLE: "skipped_unreadable",
+}
+
 
 @dataclass(frozen=True, slots=True)
 class ToolIdentity:
@@ -46,6 +62,15 @@ class ProjectContextSource:
     selection: AgentsSelectionAudit | None = None
 
 
+@dataclass(frozen=True, slots=True)
+class ContextStatus:
+    """One machine-readable skipped, omitted, truncated, or unreadable condition."""
+
+    code: str
+    subject_kind: str
+    subject: str
+
+
 @dataclass(frozen=True, slots=True)
 class ProjectContextResult:
     schema_version: int
@@ -55,6 +80,7 @@ class ProjectContextResult:
     context: str
     context_sha256: str
     warnings: tuple[str, ...]
+    statuses: tuple[ContextStatus, ...]
 
 
 def _text_sha256(content: str) -> str:
@@ -102,6 +128,79 @@ def _sources(
     return tuple(sources)
 
 
+def _status(code: str, subject_kind: str, subject: str) -> ContextStatus:
+    return ContextStatus(code=code, subject_kind=subject_kind, subject=subject)
+
+
+def _statuses_for_source(source: CollectedFile) -> list[ContextStatus]:
+    if source.status is not None:
+        code = _STATUS_CODE_BY_MESSAGE.get(source.status, "skipped_unreadable")
+        return [_status(code, "source", source.name)]
+    statuses: list[ContextStatus] = []
+    if source.truncated or (source.selection is not None and source.selection.truncated):
+        statuses.append(_status("truncated", "source", source.name))
+    if source.selection is not None:
+        if source.selection.parse_fallback:
+            statuses.append(_status("parse_fallback", "source", source.name))
+        if source.selection.source_scan_truncated:
+            statuses.append(_status("source_scan_truncated", "source", source.name))
+        if source.selection.index_truncated:
+            statuses.append(_status("index_truncated", "source", source.name))
+    return statuses
+
+
+def _build_statuses(
+    project: ProjectContext,
+    *,
+    omitted_sections: tuple[str, ...],
+    changes_truncated: bool,
+    commands_truncated: bool,
+    rendered_sources: tuple[ProjectContextSource, ...],
+) -> tuple[ContextStatus, ...]:
+    statuses: list[ContextStatus] = []
+    for source in (project.instructions, project.overview, *project.entry_files):
+        statuses.extend(_statuses_for_source(source))
+
+    truncated_sources = {
+        status.subject
+        for status in statuses
+        if status.subject_kind == "source" and status.code == "truncated"
+    }
+    for source in rendered_sources:
+        if TRUNCATION_MARKER not in source.content:
+            continue
+        name = source.path.name
+        if name in truncated_sources:
+            continue
+        statuses.append(_status("truncated", "source", name))
+        truncated_sources.add(name)
+
+    if commands_truncated:
+        statuses.append(_status("truncated", "commands", "Declared Commands"))
+    if changes_truncated:
+        statuses.append(_status("truncated", "changes", "Working Tree Changes"))
+
+    if project.directory_tree.truncated:
+        statuses.append(_status("truncated", "tree", "Directory Tree"))
+    for entry in project.directory_tree.entries:
+        if entry.kind == "unreadable_directory":
+            subject = entry.path if entry.path else "."
+            statuses.append(_status("unreadable", "tree_entry", subject))
+
+    for title in omitted_sections:
+        statuses.append(_status("section_omitted", "section", title))
+
+    deduped: list[ContextStatus] = []
+    seen: set[tuple[str, str, str]] = set()
+    for status in statuses:
+        key = (status.code, status.subject_kind, status.subject)
+        if key in seen:
+            continue
+        seen.add(key)
+        deduped.append(status)
+    return tuple(deduped)
+
+
 def load_project_context(
     repo: str | os.PathLike[str],
     *,
@@ -120,6 +219,14 @@ def load_project_context(
         raise ContextLoaderError(str(exc), exit_code=2) from None
     rendered = render_markdown_with_details(state, project)
     context = rendered.output.decode("utf-8")
+    sources = _sources(state.repository, project, rendered.included_sections)
+    statuses = _build_statuses(
+        project,
+        omitted_sections=rendered.omitted_sections,
+        changes_truncated=rendered.changes_truncated,
+        commands_truncated=rendered.commands_truncated,
+        rendered_sources=sources,
+    )
     return ProjectContextResult(
         schema_version=JSON_SCHEMA_VERSION,
         tool=ToolIdentity(name=TOOL_NAME, version=__version__),
@@ -127,10 +234,11 @@ def load_project_context(
             requested_path=location.requested_path,
             canonical_root=location.canonical_root,
         ),
-        sources=_sources(state.repository, project, rendered.included_sections),
+        sources=sources,
         context=context,
         context_sha256=hashlib.sha256(rendered.output).hexdigest(),
         warnings=(),
+        statuses=statuses,
     )
 
 
@@ -157,24 +265,38 @@ def _selection_document(selection: AgentsSelectionAudit) -> dict[str, object]:
     }
 
 
-def _source_document(source: ProjectContextSource) -> dict[str, object]:
+def _status_document(status: ContextStatus) -> dict[str, object]:
+    return {
+        "code": status.code,
+        "subject": status.subject,
+        "subject_kind": status.subject_kind,
+    }
+
+
+def _source_document(source: ProjectContextSource, *, include_content: bool) -> dict[str, object]:
     document: dict[str, object] = {
         "ordinal": source.ordinal,
         "kind": source.kind,
         "scope": source.scope,
         "path": os.fspath(source.path),
         "content_sha256": source.content_sha256,
-        "content": source.content,
     }
+    if include_content:
+        document["content"] = source.content
     if source.selection is not None:
         document["selection"] = _selection_document(source.selection)
     return document
 
 
-def render_json(result: ProjectContextResult) -> bytes:
-    """Serialize one result as stable UTF-8 JSON followed by exactly one newline."""
+def render_json(result: ProjectContextResult, *, compact: bool = False) -> bytes:
+    """Serialize one result as stable UTF-8 JSON followed by exactly one newline.
+
+    ``compact`` projects away the duplicated source bodies only at this
+    boundary: statuses and context were computed from the full model at load
+    time, so both documents agree on everything except ``sources[*].content``.
+    """
     document = {
-        "schema_version": result.schema_version,
+        "schema_version": (COMPACT_JSON_SCHEMA_VERSION if compact else result.schema_version),
         "tool": {
             "name": result.tool.name,
             "version": result.tool.version,
@@ -183,7 +305,10 @@ def render_json(result: ProjectContextResult) -> bytes:
             "requested_path": os.fspath(result.repository.requested_path),
             "canonical_root": os.fspath(result.repository.canonical_root),
         },
-        "sources": [_source_document(source) for source in result.sources],
+        "sources": [
+            _source_document(source, include_content=not compact) for source in result.sources
+        ],
+        "statuses": [_status_document(status) for status in result.statuses],
         "context": result.context,
         "context_sha256": result.context_sha256,
         "warnings": list(result.warnings),

{context_loader-1.0.0 → context_loader-1.2.0}/context_loader/cli.py

@@ -36,9 +36,12 @@ def _parser() -> argparse.ArgumentParser:
     )
     parser.add_argument(
         "--format",
-        choices=("markdown", "json"),
+        choices=("markdown", "json", "json-compact"),
         default="markdown",
-        help="output format (default: markdown)",
+        help=(
+            "output format (default: markdown); json-compact emits schema "
+            "version 2 without duplicated source bodies"
+        ),
     )
     return parser
 
@@ -52,11 +55,12 @@ def main(argv: Sequence[str] | None = None) -> int:
             focus=arguments.focus,
             path=arguments.target_path,
         )
-        output = (
-            result.context.encode("utf-8")
-            if arguments.format == "markdown"
-            else render_json(result)
-        )
+        if arguments.format == "markdown":
+            output = result.context.encode("utf-8")
+        elif arguments.format == "json":
+            output = render_json(result)
+        else:
+            output = render_json(result, compact=True)
     except ContextLoaderError as exc:
         print(f"error: {exc}", file=sys.stderr)
         return exc.exit_code

{context_loader-1.0.0 → context_loader-1.2.0}/context_loader/render.py

@@ -34,6 +34,9 @@ GLOBAL_OMISSION = "Omitted: global output limit reached."
 class MarkdownRender:
     output: bytes
     included_sections: tuple[str, ...]
+    omitted_sections: tuple[str, ...]
+    changes_truncated: bool
+    commands_truncated: bool
 
 
 def _display(value: str) -> str:
@@ -173,10 +176,12 @@ def _command_line(command: DeclaredCommand) -> str:
     return f"- `{invocation}` → `{_display(command.target)}`"
 
 
-def _bounded_lines(lines: list[str], limit: int, *, already_truncated: bool = False) -> str:
+def _bounded_lines(
+    lines: list[str], limit: int, *, already_truncated: bool = False
+) -> tuple[str, bool]:
     complete = "\n".join(lines)
     if not already_truncated and len(complete.encode()) <= limit:
-        return complete
+        return complete, False
     marker_size = len(TRUNCATION_MARKER.encode())
     budget = max(0, limit - marker_size - 1)
     selected: list[str] = []
@@ -188,20 +193,15 @@ def _bounded_lines(lines: list[str], limit: int, *, already_truncated: bool = Fa
         selected.append(line)
         used += size
     selected.append(TRUNCATION_MARKER)
-    return "\n".join(selected)
+    return "\n".join(selected), True
 
 
-def _render_commands(commands: tuple[DeclaredCommand, ...]) -> str:
+def _render_commands(commands: tuple[DeclaredCommand, ...]) -> tuple[str, bool]:
     lines = [_command_line(command) for command in commands]
     if not lines:
         lines.append("No supported command declarations found.")
-    return "\n".join(
-        (
-            "## Declared Commands",
-            "",
-            _bounded_lines(lines, DECLARED_COMMANDS_LIMIT_BYTES),
-        )
-    )
+    body, truncated = _bounded_lines(lines, DECLARED_COMMANDS_LIMIT_BYTES)
+    return "\n".join(("## Declared Commands", "", body)), truncated
 
 
 def _entry_body(source: CollectedFile, remaining: int) -> tuple[str | None, int]:
@@ -276,7 +276,7 @@ def _render_directory_tree(tree: DirectoryTree) -> str:
     lines = [_tree_line(entry) for entry in tree.entries]
     if not lines:
         lines.append("No entries.")
-    body = _bounded_lines(
+    body, _truncated = _bounded_lines(
         lines,
         DIRECTORY_TREE_LIMIT_BYTES,
         already_truncated=tree.truncated,
@@ -298,6 +298,8 @@ def render_markdown_with_details(state: RepositoryState, project: ProjectContext
             f"- Repository: `{_display(os.fspath(state.repository))}`",
         )
     )
+    commands_section, commands_truncated = _render_commands(project.commands)
+    changes_truncated = _change_lines(state)[1]
     sections: list[tuple[str, str | None]] = [
         ("Git State", _render_git_state(state)),
         (
@@ -312,7 +314,7 @@ def render_markdown_with_details(state: RepositoryState, project: ProjectContext
             "Project Overview",
             _render_source_section("Project Overview", project.overview, README_LIMIT_BYTES),
         ),
-        ("Declared Commands", _render_commands(project.commands)),
+        ("Declared Commands", commands_section),
         ("Project Entry Files", _render_entry_files(project.entry_files)),
         ("Recent Commits", _render_recent_commits(state.commits)),
         ("Directory Tree", _render_directory_tree(project.directory_tree)),
@@ -320,6 +322,7 @@ def render_markdown_with_details(state: RepositoryState, project: ProjectContext
 
     rendered_parts = [header.encode()]
     included_sections: list[str] = []
+    omitted_sections: list[str] = []
     omission_started = False
     for index, (title, full_section) in enumerate(sections):
         omission = _omitted_section(title).encode()
@@ -330,6 +333,7 @@ def render_markdown_with_details(state: RepositoryState, project: ProjectContext
         if omission_started or full_section is None:
             selected = omission
             omission_started = True
+            omitted_sections.append(title)
         else:
             candidate = full_section.encode()
             tentative = b"\n\n".join((*rendered_parts, candidate, *future_omissions)) + b"\n"
@@ -339,12 +343,19 @@ def render_markdown_with_details(state: RepositoryState, project: ProjectContext
             else:
                 selected = omission
                 omission_started = True
+                omitted_sections.append(title)
         rendered_parts.append(selected)
 
     output = b"\n\n".join(rendered_parts) + b"\n"
     if len(output) > GLOBAL_OUTPUT_LIMIT_BYTES:
         raise RuntimeError("global context output limit could not be satisfied")
-    return MarkdownRender(output=output, included_sections=tuple(included_sections))
+    return MarkdownRender(
+        output=output,
+        included_sections=tuple(included_sections),
+        omitted_sections=tuple(omitted_sections),
+        changes_truncated=changes_truncated,
+        commands_truncated=commands_truncated,
+    )
 
 
 def rendered_source_contents(

{context_loader-1.0.0 → context_loader-1.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "context-loader"
-version = "1.0.0"
+version = "1.2.0"
 description = "Render deterministic local Git context for any executor"
 readme = "README.md"
 requires-python = ">=3.12,<3.13"

{context_loader-1.0.0 → context_loader-1.2.0}/pyproject.toml.orig

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "context-loader"
-version = "1.0.0"
+version = "1.2.0"
 description = "Render deterministic local Git context for any executor"
 license = { file = "LICENSE" }
 readme = "README.md"

{context_loader-1.0.0 → context_loader-1.2.0}/tool_cli_contract.json

@@ -15,6 +15,7 @@
         "repo_is_absolute_git_worktree",
         "markdown_requires_canonical_root",
         "json_accepts_path_inside_worktree",
+        "json_compact_accepts_path_inside_worktree",
         "target_path_is_repository_relative"
       ],
       "result_statuses": [
@@ -24,11 +25,12 @@
       ]
     }
   ],
-  "contract_version": 2,
+  "contract_version": 3,
   "flags": {
     "format": [
       "markdown",
-      "json"
+      "json",
+      "json-compact"
     ],
     "output": "stdout",
     "stderr": "bounded_diagnostic_only"
@@ -44,5 +46,5 @@
   ],
   "schema_version": 1,
   "tool_name": "context-loader",
-  "tool_version": "1.0.0"
+  "tool_version": "1.2.0"
 }