patchshuttle 0.1.0a6__tar.gz → 0.1.0a7__tar.gz

{patchshuttle-0.1.0a6 → patchshuttle-0.1.0a7}/CHANGELOG.md

@@ -3,6 +3,36 @@
 All notable changes to PatchShuttle are recorded in this file. The project
 uses semantic versioning, including Python-compatible pre-release versions.
 
+## 0.1.0a7 - release candidate (not yet published)
+
+- Audit AI instructions: complete action catalogs, correct method YAML indentation
+  and job-ID rules, clarify guard sources, MCP limits and database boundaries.
+
+- Add `python_references` for bounded, explicitly unverified symbol-reference
+  candidates with import aliases and unresolved attributes.
+
+- Add read-only `python_dependencies` for static local import candidates, cycle
+  groups and explicitly unresolved/dynamic cases before module refactoring.
+
+- Add opt-in, bounded action drafts to symbol/import audits with observed guards;
+  fragments require review and never execute during audit.
+
+- Add `edit_imports`: 1-100 ordered import edits guarded by one initial import
+  hash, with step diagnostics and the existing import safety checks.
+
+- Explain structural replacement failures with bounded indentation context and
+  YAML guidance, without rewriting input or changing guard semantics.
+
+- Add reviewed `docs refresh` for recognized AI guide templates, retaining
+  appended owner notes and exact backups; unknown inline edits require review.
+- Add conditional Python symbol-edit guidance to CLI plans, full and compact
+  logs, including targeting failures; advisory does not alter guards or policy.
+- Add operation-selection rules and an audit-to-patch example to AI guidance.
+- Prefer configured MCP history retrieval, retaining manual logs as fallback.
+- Count symbol/range transfers and report structural imports and file moves.
+- Extract plan and discovery-log presentation into smaller modules without
+  relaxing the existing architecture ratchet.
+
 ## 0.1.0a6 - 2026-10-21
 
 ### Added

{patchshuttle-0.1.0a6 → patchshuttle-0.1.0a7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: patchshuttle
-Version: 0.1.0a6
+Version: 0.1.0a7
 Summary: Local, auditable patch workflows for AI-assisted software development
 License-Expression: MIT
 License-File: LICENSE
@@ -50,7 +50,8 @@ describes a small job, the user reviews and runs it locally, and PatchShuttle
 records the result for the next iteration.
 
 > [!IMPORTANT]
-> PatchShuttle is alpha software. Version `0.1.0a6` implements the complete
+> PatchShuttle is alpha software. This branch prepares `0.1.0a7`; the latest
+> recorded published version is `0.1.0a6`. It implements the complete
 > local v0.1 workflow. It executes bounded read-only
 > audits, approved patch transactions, and approved one-pass verification jobs
 > under a project lock. Patch jobs retain backups, run controlled checks, apply
@@ -483,7 +484,8 @@ retained formatted-file states, final check results, audit observations, and a
 workspace comparison where applicable.
 
 An audit executes `tree`, `read`, literal `search`, bounded `search_context`,
-Python `read_symbol`, `find_files`, `file_info`, SHA-256 `hash`, canonical
+Python `read_symbol`, `read_imports`, `python_structure`, `python_dependencies`,
+`python_references`, `find_files`, `file_info`, SHA-256 `hash`, canonical
 `hash_range`, `git_status`, and `environment`. Traversal, file reads, match
 counts, and recorded output are bounded by local policy. Protected and ignored
 paths are skipped, source content appears only when explicitly requested by a
@@ -503,7 +505,8 @@ automatically undo those changes.
 
 A patch plan may contain `create_directory`, `create_file`, `replace_exact`,
 `replace_symbol`, `insert_before`, `insert_after`, `delete_exact`,
-`replace_range`, `delete_range`, `insert_at_line`, or `apply_diff` actions and
+`replace_range`, `delete_range`, `insert_at_line`, `apply_diff`, `ensure_import`,
+`remove_import`, `edit_imports`, `move_file`, `move_range`, or `move_symbol` actions and
 applies the final bytes already computed by the planner.
 
 The optional line-range actions are strict guarded operations for cases where
@@ -764,18 +767,19 @@ actions:
       symbol: Service.run
 ```
 
-If a change is needed, copy the canonical SHA-256 returned by `read_symbol`
-into a guarded patch action:
+If a change is needed, use the audit-derived draft or copy `ast_sha256` from
+`read_symbol` on the same Python minor version. Add its text `sha256` too when
+comments must be guarded. The action below is illustrative:
 
 ```yaml
 actions:
   - replace_symbol:
       path: src/example/service.py
       symbol: Service.run
-      expected_sha256: 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
-      new_content: |
-        def run(self, value):
-            return value
+      expected_ast_sha256: 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
+      new_content: |2
+            def run(self, value):
+                return value
 ```
 
 The same audit can be constructed through the public Python adapter:
@@ -891,7 +895,7 @@ python -m coverage report --fail-under=100
 python -m build
 python -m twine check dist/*
 python tools/release_checks.py dist
-python tools/wheel_smoke.py dist/patchshuttle-0.1.0a6-py3-none-any.whl --version 0.1.0a6
+python tools/wheel_smoke.py dist/patchshuttle-0.1.0a7-py3-none-any.whl --version 0.1.0a7
 ```
 
 The `0.1.0a2`, `0.1.0a3`, and `0.1.0a4` alpha releases each passed the
@@ -1009,7 +1013,9 @@ The implemented local cycle is:
 5. For a patch, run optional changed-HTML linting, controlled checks, the
    locally resolved isort/Black scopes, and final checks.
 6. Receive a timestamped log or generate a fresh handoff.
-7. Review the log, upload it to the AI, and continue with the next job.
+7. Retrieve configured MCP history or provide the log through an authorized
+   channel. Current MCP history returns summaries/references, not full logs.
+   Review the observed result before continuing with the next job.
 
 See [SPEC_V0_1.md](SPEC_V0_1.md) for the approved product contract and
 [CHANGELOG.md](CHANGELOG.md) for release notes. PatchShuttle is designed for
@@ -1080,3 +1086,18 @@ owner-configured authenticated MCP server (`patchshuttle[mcp]`).
 Optional [Django migrations](docs/DJANGO_MIGRATIONS.md) provide reviewed plans,
 locks and recovery journals (`patchshuttle[django]`). A live ChatGPT deployment
 requires the owner's HTTPS endpoint and OAuth configuration.
+
+
+## AI workflow in a7 development
+
+Start with the installed capabilities/schema and the workspace handoff. The
+[AI guide](src/patchshuttle/resources/AI_GUIDE.md) contains the operation decision
+table, guard sources, refactoring checklist and recovery boundaries. Existing
+Python declaration edits should normally use `read_symbol` then `replace_symbol`;
+request `include_template: true` for a guarded draft. Use `edit_imports` for a
+sequence of import edits. Keep audits separate from patches and review actual
+execution outcomes. The explicit `|2` in the method example preserves Python
+indentation after YAML parsing. Documentation examples use illustrative bodies
+and hashes; replace these with observed source and guards before submitting.
+
+This section describes the development branch, not a published a7 release.

{patchshuttle-0.1.0a6 → patchshuttle-0.1.0a7}/README.md

@@ -6,7 +6,8 @@ describes a small job, the user reviews and runs it locally, and PatchShuttle
 records the result for the next iteration.
 
 > [!IMPORTANT]
-> PatchShuttle is alpha software. Version `0.1.0a6` implements the complete
+> PatchShuttle is alpha software. This branch prepares `0.1.0a7`; the latest
+> recorded published version is `0.1.0a6`. It implements the complete
 > local v0.1 workflow. It executes bounded read-only
 > audits, approved patch transactions, and approved one-pass verification jobs
 > under a project lock. Patch jobs retain backups, run controlled checks, apply
@@ -439,7 +440,8 @@ retained formatted-file states, final check results, audit observations, and a
 workspace comparison where applicable.
 
 An audit executes `tree`, `read`, literal `search`, bounded `search_context`,
-Python `read_symbol`, `find_files`, `file_info`, SHA-256 `hash`, canonical
+Python `read_symbol`, `read_imports`, `python_structure`, `python_dependencies`,
+`python_references`, `find_files`, `file_info`, SHA-256 `hash`, canonical
 `hash_range`, `git_status`, and `environment`. Traversal, file reads, match
 counts, and recorded output are bounded by local policy. Protected and ignored
 paths are skipped, source content appears only when explicitly requested by a
@@ -459,7 +461,8 @@ automatically undo those changes.
 
 A patch plan may contain `create_directory`, `create_file`, `replace_exact`,
 `replace_symbol`, `insert_before`, `insert_after`, `delete_exact`,
-`replace_range`, `delete_range`, `insert_at_line`, or `apply_diff` actions and
+`replace_range`, `delete_range`, `insert_at_line`, `apply_diff`, `ensure_import`,
+`remove_import`, `edit_imports`, `move_file`, `move_range`, or `move_symbol` actions and
 applies the final bytes already computed by the planner.
 
 The optional line-range actions are strict guarded operations for cases where
@@ -720,18 +723,19 @@ actions:
       symbol: Service.run
 ```
 
-If a change is needed, copy the canonical SHA-256 returned by `read_symbol`
-into a guarded patch action:
+If a change is needed, use the audit-derived draft or copy `ast_sha256` from
+`read_symbol` on the same Python minor version. Add its text `sha256` too when
+comments must be guarded. The action below is illustrative:
 
 ```yaml
 actions:
   - replace_symbol:
       path: src/example/service.py
       symbol: Service.run
-      expected_sha256: 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
-      new_content: |
-        def run(self, value):
-            return value
+      expected_ast_sha256: 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
+      new_content: |2
+            def run(self, value):
+                return value
 ```
 
 The same audit can be constructed through the public Python adapter:
@@ -847,7 +851,7 @@ python -m coverage report --fail-under=100
 python -m build
 python -m twine check dist/*
 python tools/release_checks.py dist
-python tools/wheel_smoke.py dist/patchshuttle-0.1.0a6-py3-none-any.whl --version 0.1.0a6
+python tools/wheel_smoke.py dist/patchshuttle-0.1.0a7-py3-none-any.whl --version 0.1.0a7
 ```
 
 The `0.1.0a2`, `0.1.0a3`, and `0.1.0a4` alpha releases each passed the
@@ -965,7 +969,9 @@ The implemented local cycle is:
 5. For a patch, run optional changed-HTML linting, controlled checks, the
    locally resolved isort/Black scopes, and final checks.
 6. Receive a timestamped log or generate a fresh handoff.
-7. Review the log, upload it to the AI, and continue with the next job.
+7. Retrieve configured MCP history or provide the log through an authorized
+   channel. Current MCP history returns summaries/references, not full logs.
+   Review the observed result before continuing with the next job.
 
 See [SPEC_V0_1.md](SPEC_V0_1.md) for the approved product contract and
 [CHANGELOG.md](CHANGELOG.md) for release notes. PatchShuttle is designed for
@@ -1036,3 +1042,18 @@ owner-configured authenticated MCP server (`patchshuttle[mcp]`).
 Optional [Django migrations](docs/DJANGO_MIGRATIONS.md) provide reviewed plans,
 locks and recovery journals (`patchshuttle[django]`). A live ChatGPT deployment
 requires the owner's HTTPS endpoint and OAuth configuration.
+
+
+## AI workflow in a7 development
+
+Start with the installed capabilities/schema and the workspace handoff. The
+[AI guide](src/patchshuttle/resources/AI_GUIDE.md) contains the operation decision
+table, guard sources, refactoring checklist and recovery boundaries. Existing
+Python declaration edits should normally use `read_symbol` then `replace_symbol`;
+request `include_template: true` for a guarded draft. Use `edit_imports` for a
+sequence of import edits. Keep audits separate from patches and review actual
+execution outcomes. The explicit `|2` in the method example preserves Python
+indentation after YAML parsing. Documentation examples use illustrative bodies
+and hashes; replace these with observed source and guards before submitting.
+
+This section describes the development branch, not a published a7 release.

{patchshuttle-0.1.0a6 → patchshuttle-0.1.0a7}/docs/NEXT_RELEASE.md

@@ -1,7 +1,29 @@
 # Next release: structural editing and controlled refactoring
 
-Status: 0.1.0a6 candidate undergoing release qualification.
-Base: 0.1.0a5. Publication requires the release gates below.
+Status: 0.1.0a6 published; see RELEASE.md for immutable publication evidence.
+The sections below describe a6 scope and remaining work.
+
+## 0.1.0a7 release candidate
+
+Implemented a7 scope:
+
+- Python operation-selection rules and conditional advisory feedback in plans,
+  full/compact logs and handoff; transfer/import telemetry.
+- Reviewed `docs refresh` for recognized AI guide templates, preserving appended
+  owner notes and backups; inline customizations still require manual review.
+- Bounded indentation diagnostics for structural replacements.
+- `edit_imports`: ordered import changes with one initial import-set guard.
+- Optional `include_template` drafts from `read_symbol` and `read_imports`.
+- Read-only `python_dependencies` and `python_references` for bounded static
+  dependency/cycle and unverified reference candidates. No automatic rewrites.
+- Audited AI guide, handoff, protocol and CLI explanations, with executable
+  YAML example tests and action-catalog checks.
+
+No a7 publication is recorded yet. Source version is now `0.1.0a7` for candidate
+qualification. Final commit CI, TestPyPI and production publication gates remain
+required before recording this version as released.
+See ROADMAP.md for the broader backlog. The following sections record the a6
+foundation and its remaining limitations, not additional a7 completion claims.
 
 ## Implemented in this branch
 
@@ -28,7 +50,7 @@ This is AST-selected source replacement, not AST unparse of the whole file.
     path: services/offers.py
     symbol: OfferService.calculate
     expected_ast_sha256: "<64 hex digits from read_symbol>"
-    new_content: |
+    new_content: |2
           def calculate(self, amount):
               return amount * 2
 ```
@@ -166,5 +188,6 @@ module is compiled without importing or executing it.
 
 Unrelated source remains intact before the normal scoped formatter phase.
 Neither action rewrites callers, proves runtime compatibility, nor infers
-imports when moving files or symbols. A sequence of import edits needs the
-hash of each simulated intermediate import set, or separate audited jobs.
+imports when moving files or symbols. Separate import actions need the hash of each simulated intermediate import
+set, or separate audited jobs. In a7, prefer `edit_imports` for multiple ordered
+changes: its guard targets the import set at entry to that action.

{patchshuttle-0.1.0a6 → patchshuttle-0.1.0a7}/docs/RELEASE.md

@@ -1,6 +1,6 @@
 # PatchShuttle release guide
 
-This guide records the immutable published `0.1.0a2`, `0.1.0a3`, and `0.1.0a4` evidence and
+This guide records immutable published release evidence through `0.1.0a6` and
 the staged qualification procedure for later releases. Do not publish a
 stable `0.1.0` release until every acceptance criterion in `SPEC_V0_1.md` has
 passed and the stable release is approved.
@@ -158,7 +158,7 @@ python tools/wheel_smoke.py dist/patchshuttle-<VERSION>-py3-none-any.whl --versi
 `release_checks.py` requires exactly one wheel and one source archive for the
 source version and writes `dist/SHA256SUMS`. Replace `<VERSION>` with the exact
 source version under qualification. For the most recent recorded qualification it
-was `0.1.0a4`. Do not reuse an immutable published version for a future upload.
+was `0.1.0a6`. Do not reuse an immutable published version for a future upload.
 
 During a source-version transition, metadata in an already-installed editable
 environment may still report the previous version until the package is
@@ -181,7 +181,8 @@ logs must keep exposing resolved formatter and architecture decisions.
 3. Do not upload `.venv/`, caches, previous phase archives, or local runtime
    `patches/` directories.
 4. Push the default branch and wait for the `CI` workflow.
-5. Require all five matrix jobs and the package job to pass before publishing.
+5. Require all five matrix jobs, the PostgreSQL integration job and the package
+   job to pass before publishing.
 
 The required matrix is Ubuntu/Python 3.10, 3.12, and 3.14 plus
 Windows/Python 3.12 and 3.14. A local Linux result does not replace these jobs.
@@ -252,15 +253,40 @@ statement also requires a separate recorded ChatGPT end-to-end workflow using
 that released protocol and must state the tested scope.
 
 
-## 0.1.0a6 candidate
+## Recorded `0.1.0a6` qualification
+
+Published on 2026-10-22 from immutable tag `v0.1.0a6`, resolving to
+`831dc2a8b4342150785a227a4834e5c1efdfc5be`.
 
-Source candidate prepared on 2026-10-21. This is not a publication record.
 Scope: AST-guarded symbol/import edits, guarded file/range/symbol transfers,
 UTF-8 formatter subprocesses, optional authenticated MCP history retrieval,
 and an optional Django migration command with reviewed plans and journals.
 The owner must configure the live HTTPS/OAuth deployment separately.
-
-Adapter commit `738366bfe1c6c02442913703e9d9bafaafd7065c` passed
-[Linux/Windows, PostgreSQL 16, and distribution CI](https://github.com/ratundo/patchshuttle/actions/runs/39432455841).
-The final versioned candidate still requires its own complete gates before
-TestPyPI, GitHub pre-release and production PyPI publication.
+Refactoring does not automatically rewrite callers or infer dependencies;
+database recovery requires explicit owner review rather than automatic rollback.
+
+External gates completed successfully:
+
+- [main CI: all seven jobs](https://github.com/ratundo/patchshuttle/actions/runs/39643741606),
+  including Ubuntu, Windows, PostgreSQL 16 and clean-wheel checks;
+- [tag CI](https://github.com/ratundo/patchshuttle/actions/runs/39741537873);
+- [TestPyPI build, publish and clean-index verification](https://github.com/ratundo/patchshuttle/actions/runs/39740928641);
+- [GitHub pre-release](https://github.com/ratundo/patchshuttle/releases/tag/v0.1.0a6);
+- [PyPI build, publish and clean-index verification](https://github.com/ratundo/patchshuttle/actions/runs/39741537464),
+  with `INDEX_SMOKE_OK pypi 0.1.0a6`;
+- [PyPI version](https://pypi.org/project/patchshuttle/0.1.0a6/).
+
+The qualified suite passed 1,112 tests with 100% statement and branch coverage.
+Windows pytest and coverage-report steps are separate so a later successful
+native command cannot mask a failed test command.
+
+The TestPyPI and production PyPI JSON APIs independently reported byte-identical
+artifacts (matching sizes and SHA-256 digests):
+
+- `patchshuttle-0.1.0a6-py3-none-any.whl`, 202331 bytes:
+  `fd83e54be01115af1217d56ae73bd7cf2c8880ce79b84a7fd7d5b06678efb92f`;
+- `patchshuttle-0.1.0a6.tar.gz`, 355211 bytes:
+  `15654537705304ab843ba6cfa5d615900420efd2f6ebefc83b28ca7d64da8c91`.
+
+This publication record does not extend the separately scoped a2
+**Tested with ChatGPT** claim or claim deployment of a live MCP endpoint.

patchshuttle-0.1.0a7/docs/ROADMAP.md

@@ -0,0 +1,56 @@
+# Development roadmap after 0.1.0a6
+
+This is a backlog, not a statement that every item ships in a7.
+Published a6 evidence remains in RELEASE.md. Source version stays a6 until
+an a7 candidate is qualified; no a7 package has been published.
+
+## First a7 milestone
+
+Implemented locally: conditional symbol-edit advisory in plans/full/compact logs,
+operation selection rules, handoff example, MCP-aware retrieval guidance,
+transfer/import telemetry, and smaller presentation modules.
+The first guidance milestone passed hosted Linux/Windows/PostgreSQL CI.
+Guide refresh now supports reviewed updates of recognized current/a4/a5/a6
+templates with appended notes, hashes and backups; inline customizations require
+manual review.
+Guide refresh passed hosted CI. Structural replacement failures now include
+bounded indentation context and YAML guidance; input is never reindented.
+Indentation diagnostics passed both hosted CI runs. Batch import editing with
+one initial guard is implemented; qualification is in progress.
+Batch imports passed hosted CI. Opt-in audit-derived action drafts are
+implemented. Static module-import dependency auditing is implemented;
+dependency auditing passed hosted CI. Syntactic symbol-reference candidates
+are implemented; binding-aware resolution, rewrites and release qualification
+remain pending.
+
+## Subsequent work, in priority order
+
+1. Synchronize AI guide, protocol and explain output; detect stale generated
+   guides and support reviewed refresh preserving owner additions.
+2. Batch import edits with one initial guard; audit-derived action templates;
+   explain conflicts with initial versus simulated intermediate state.
+3. Static dependency/reference analysis before moves, unresolved dynamic cases,
+   import-cycle reporting, reviewed updates and optional compatibility reexports.
+4. End-to-end refactors: rename symbols/modules, extract selected declarations,
+   move groups into packages, report architecture before/after.
+5. Extend transfers: same-file moves, multiple destinations/anchors, move chains,
+   case-only renames, binary files, multi-alias and selected conditional imports.
+6. Improve indentation diagnostics; evaluate explicit dedented input and CST
+   for targeted edits while preserving multiline-string semantics.
+7. Deploy and test read-only MCP with real owner HTTPS/OAuth configuration;
+   retrieve bounded diagnostics and the separate migration journal.
+8. Migration data checks, partial-success reports, recovery integration and
+   imported-helper identity. Do not claim file/database atomic rollback.
+9. Reproduce the owner's original Windows isort error and add a regression test;
+   cover Cyrillic paths, CRLF/BOM and subprocess output encodings.
+10. Benchmark discovery/planning/checks/output size/retries before optimizing
+    AST reuse, traversal or owner-configured focused check profiles.
+11. Maintain reproducible dogfooding tasks with model/instruction versions,
+    input state, timings, attempt counts, outputs and recovery outcomes.
+
+## Release gates
+
+Formatting, meaningful regression tests, full statement/branch coverage,
+Ubuntu/Windows/PostgreSQL CI, build and clean-wheel checks, TestPyPI verification,
+then a tagged GitHub prerelease and PyPI verification. Record evidence only after
+completion. Do not weaken guards or architecture policy to pass these gates.

{patchshuttle-0.1.0a6 → patchshuttle-0.1.0a7}/src/patchshuttle/_python_discovery.py

@@ -11,8 +11,10 @@ from patchshuttle.models import Job
 _TEXT_ACTIONS = frozenset(
     {"delete_exact", "insert_after", "insert_before", "replace_exact"}
 )
-_SYMBOL_ACTIONS = frozenset({"replace_symbol"})
-_LINE_ACTIONS = frozenset({"delete_range", "insert_at_line", "replace_range"})
+_SYMBOL_ACTIONS = frozenset({"replace_symbol", "move_symbol"})
+_LINE_ACTIONS = frozenset(
+    {"delete_range", "insert_at_line", "replace_range", "move_range"}
+)
 _FAILURE_SIGNALS = {
     "LINE_RANGE_GUARD_MISMATCH": "LINE_TARGETING_FAILURE",
     "LINE_RANGE_OUT_OF_BOUNDS": "LINE_TARGETING_FAILURE",
@@ -47,6 +49,8 @@ class PythonDiscoveryEvaluation:
     declared_python_line_actions: int
     failure_signal: str | None
     reason_codes: tuple[str, ...]
+    declared_python_import_actions: int = 0
+    declared_python_file_move_actions: int = 0
 
 
 def evaluate_python_discovery(
@@ -77,6 +81,8 @@ def evaluate_python_discovery(
     declared_python_symbol_actions = 0
     declared_python_line_actions = 0
 
+    import_actions = 0
+    file_moves = 0
     for index, action in enumerate(job.actions, start=1):
         name = action.name
         parameters = action.parameters
@@ -118,6 +124,10 @@ def evaluate_python_discovery(
 
         if not python_targeted:
             continue
+        if name in {"ensure_import", "remove_import", "edit_imports"}:
+            import_actions += 1
+        if name == "move_file":
+            file_moves += 1
         if name in _TEXT_ACTIONS:
             declared_python_text_actions += 1
         elif name in _SYMBOL_ACTIONS:
@@ -142,6 +152,8 @@ def evaluate_python_discovery(
         declared_python_line_actions=declared_python_line_actions,
         failure_signal=failure_signal,
     )
+    reason_codes += ("PYTHON_IMPORT_TARGETING_USED",) if import_actions else ()
+    reason_codes += ("PYTHON_FILE_MOVE_USED",) if file_moves else ()
     applicable = bool(python_paths or reason_codes)
     return PythonDiscoveryEvaluation(
         applicable=applicable,
@@ -164,6 +176,8 @@ def evaluate_python_discovery(
         declared_python_line_actions=declared_python_line_actions,
         failure_signal=failure_signal,
         reason_codes=reason_codes,
+        declared_python_import_actions=import_actions,
+        declared_python_file_move_actions=file_moves,
     )
 
 

{patchshuttle-0.1.0a6 → patchshuttle-0.1.0a7}/src/patchshuttle/_version.py

@@ -1,3 +1,3 @@
 """Single source of truth for the PatchShuttle package version."""
 
-__version__ = "0.1.0a6"
+__version__ = "0.1.0a7"

{patchshuttle-0.1.0a6 → patchshuttle-0.1.0a7}/src/patchshuttle/actions/__init__.py

@@ -10,6 +10,7 @@ from patchshuttle.actions.constructors import (
     create_file,
     delete_exact,
     delete_range,
+    edit_imports,
     ensure_import,
     environment,
     file_info,
@@ -23,6 +24,8 @@ from patchshuttle.actions.constructors import (
     move_file,
     move_range,
     move_symbol,
+    python_dependencies,
+    python_references,
     python_structure,
     read,
     read_imports,
@@ -91,8 +94,11 @@ __all__ = [
     "read",
     "read_symbol",
     "read_imports",
+    "edit_imports",
     "ensure_import",
     "remove_import",
+    "python_references",
+    "python_dependencies",
     "python_structure",
     "move_file",
     "move_range",

{patchshuttle-0.1.0a6 → patchshuttle-0.1.0a7}/src/patchshuttle/actions/constructors.py

@@ -86,8 +86,9 @@ def read_symbol(
     symbol: str,
     *,
     max_bytes: int | None = None,
+    include_template: bool = False,
 ) -> Action:
-    parameters = {"path": path, "symbol": symbol}
+    parameters = {"path": path, "symbol": symbol, "include_template": include_template}
     if max_bytes is not None:
         parameters["max_bytes"] = max_bytes
     return Action({"read_symbol": parameters})
@@ -445,8 +446,10 @@ def _add_guards(
         parameters["expected_sha256"] = expected_sha256
 
 
-def read_imports(path: str, *, max_bytes: int | None = None) -> Action:
-    parameters = {"path": path}
+def read_imports(
+    path: str, *, max_bytes: int | None = None, include_template: bool = False
+) -> Action:
+    parameters = {"path": path, "include_template": include_template}
     if max_bytes is not None:
         parameters["max_bytes"] = max_bytes
     return Action({"read_imports": parameters})
@@ -480,8 +483,66 @@ def remove_import(
     )
 
 
+def edit_imports(path: str, edits, *, expected_imports_ast_sha256: str) -> Action:
+    """Apply ordered import edits guarded by the initial simulated import set."""
+    return Action(
+        {
+            "edit_imports": {
+                "path": path,
+                "edits": edits,
+                "expected_imports_ast_sha256": expected_imports_ast_sha256,
+            }
+        }
+    )
+
+
+def python_dependencies(
+    path: str = ".",
+    *,
+    max_files: int = 300,
+    max_findings: int = 2000,
+    max_bytes: int = 50000,
+) -> Action:
+    return Action(
+        {
+            "python_dependencies": dict(
+                path=path,
+                max_files=max_files,
+                max_findings=max_findings,
+                max_bytes=max_bytes,
+            )
+        }
+    )
+
+
+def python_references(
+    module: str,
+    symbol: str,
+    *,
+    path: str = ".",
+    max_files: int = 300,
+    max_findings: int = 2000,
+    max_bytes: int = 50000,
+) -> Action:
+    return Action(
+        {
+            "python_references": dict(
+                module=module,
+                symbol=symbol,
+                path=path,
+                max_files=max_files,
+                max_findings=max_findings,
+                max_bytes=max_bytes,
+            )
+        }
+    )
+
+
 __all__ = [
+    "python_references",
+    "python_dependencies",
     "read_imports",
+    "edit_imports",
     "ensure_import",
     "remove_import",
     "apply_diff",

patchshuttle-0.1.0a7/src/patchshuttle/analysis/__init__.py

@@ -0,0 +1 @@
+"""Read-only static analysis helpers."""