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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: context-loader
-Version: 1.0.0
+Version: 1.1.0
 Summary: Render deterministic local Git context for any executor
 License:                                  Apache License
                                     Version 2.0, January 2004
@@ -240,7 +240,7 @@ 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.1.0`. Install its matching published release or an exact source commit.
 
 Install via `uv`:
 
@@ -254,7 +254,7 @@ Install via `pip`:
 pip install context-loader
 ```
 
-For development or source-based installs tracking current repository (`1.0.0`):
+For development or source-based installs tracking current repository (`1.1.0`):
 
 ```bash
 uv tool install git+https://github.com/xuanheng-tech/context-loader.git
@@ -345,7 +345,7 @@ Keys are serialized in sorted order with `ensure_ascii=False`. The declared cont
   "schema_version": 1,
   "tool": {
     "name": "context-loader",
-    "version": "1.0.0"
+    "version": "1.1.0"
   },
   "repository": {
     "requested_path": "/canonical/requested/path",
@@ -374,6 +374,7 @@ 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": []
 }
 ```
@@ -384,12 +385,14 @@ assembly order, after the existing newline normalization and truncation rules. `
 `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.
+integer `1`, while `tool.version` is `1.1.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.
 

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

@@ -29,7 +29,7 @@ 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.1.0`. Install its matching published release or an exact source commit.
 
 Install via `uv`:
 
@@ -43,7 +43,7 @@ Install via `pip`:
 pip install context-loader
 ```
 
-For development or source-based installs tracking current repository (`1.0.0`):
+For development or source-based installs tracking current repository (`1.1.0`):
 
 ```bash
 uv tool install git+https://github.com/xuanheng-tech/context-loader.git
@@ -134,7 +134,7 @@ Keys are serialized in sorted order with `ensure_ascii=False`. The declared cont
   "schema_version": 1,
   "tool": {
     "name": "context-loader",
-    "version": "1.0.0"
+    "version": "1.1.0"
   },
   "repository": {
     "requested_path": "/canonical/requested/path",
@@ -163,6 +163,7 @@ 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": []
 }
 ```
@@ -173,12 +174,14 @@ assembly order, after the existing newline normalization and truncation rules. `
 `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.
+integer `1`, while `tool.version` is `1.1.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.
 

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

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

{context_loader-1.0.0 → context_loader-1.1.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,
 )
@@ -22,6 +29,14 @@ from .render import render_markdown_with_details, rendered_source_contents
 JSON_SCHEMA_VERSION = 1
 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 +61,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 +79,7 @@ class ProjectContextResult:
     context: str
     context_sha256: str
     warnings: tuple[str, ...]
+    statuses: tuple[ContextStatus, ...]
 
 
 def _text_sha256(content: str) -> str:
@@ -102,6 +127,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 +218,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 +233,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,6 +264,14 @@ def _selection_document(selection: AgentsSelectionAudit) -> 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) -> dict[str, object]:
     document: dict[str, object] = {
         "ordinal": source.ordinal,
@@ -184,6 +299,7 @@ def render_json(result: ProjectContextResult) -> bytes:
             "canonical_root": os.fspath(result.repository.canonical_root),
         },
         "sources": [_source_document(source) 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.1.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.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "context-loader"
-version = "1.0.0"
+version = "1.1.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.1.0}/pyproject.toml.orig

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

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

@@ -44,5 +44,5 @@
   ],
   "schema_version": 1,
   "tool_name": "context-loader",
-  "tool_version": "1.0.0"
+  "tool_version": "1.1.0"
 }