feature/Wip-to-root · L-260928-b7cdfa

docs/architecture.md

@@ -270,7 +270,7 @@ The download twin of input preparation, and the Python twin of `@pipelex/sdk`'s
 
 ## Out of scope
 
-- The `/v1/build/*` helpers — `build_output`, `build_runner`, `concept`, `pipe_spec`. `build_inputs` shipped in 0.5.0 and was removed again once `prepare_inputs`, its only caller, moved onto `validate` + the input-form descriptor: this SDK no longer touches `/v1/build/*`, which the workspace is retiring (`wip/build-retirement/`).
+- The `/v1/build/*` helpers — `build_output`, `build_runner`, `concept`, `pipe_spec`. `build_inputs` shipped in 0.5.0 and was removed again once `prepare_inputs`, its only caller, moved onto `validate` + the input-form descriptor: this SDK no longer touches `/v1/build/*`, which the workspace is retiring (L-260829-848001 in the workspace ledger).
 - Organization *switch* (a WorkOS session operation, not a `/v1` route).
 - A `~/.pipelex/config` file reader (env-only for now, matching the JS SDK).
 - A synchronous client facade.

docs/input-preparation.md

@@ -1,6 +1,6 @@
 # Input preparation (`upload_file` / `prepare_inputs`)
 
-> **Status: implemented** (`pipelex_sdk/upload.py`, `pipelex_sdk/prepare_inputs.py`). `upload_file` and `prepare_inputs` are the Python counterpart of `@pipelex/sdk`'s `uploadFile` / `prepareInputs`, built on the raw `upload()` wire call. The design of record for the current shape is `pipelex-sdk-js/wip/prepare-inputs-selectors/design.md` in the sibling repo; the two SDKs are kept semantically identical.
+> **Status: implemented** (`pipelex_sdk/upload.py`, `pipelex_sdk/prepare_inputs.py`). `upload_file` and `prepare_inputs` are the Python counterpart of `@pipelex/sdk`'s `uploadFile` / `prepareInputs`, built on the raw `upload()` wire call. The design of record for the current shape is shared with `@pipelex/sdk` and tracked as L-260829-300c50 in the workspace ledger; the two SDKs are kept semantically identical.
 >
 > **Current scope.** `prepare_inputs` names the method three ways — inline `files`, a `method_ref` address, or a stored `method_id` — and reads the target pipe's signature from the standard's input-form descriptor. One piece is deliberately deferred and additive (it does not change this contract): the opt-in ingest of `http(s)` URLs into storage — for now an `http(s)` URL at a file position always passes through unchanged.
 

pipelex_sdk/crate_models.py

@@ -5,7 +5,7 @@
 `CrateRequestBase` and `CrateInvalidReport` used to sit in a `build_models` module beside the
 `/v1/build/inputs` wire models; those went when `prepare_inputs` moved its signature source to
 the input-form descriptor and this SDK stopped calling `/v1/build/*` (workspace campaign
-`wip/build-retirement/`). Nothing about the envelope changed in the move.
+L-260829-848001). Nothing about the envelope changed in the move.
 
 `/v1/resolve` emits the normalized library crate, `/v1/codegen` projects that crate into stamped
 typed artifacts plus their lock. Both are Pipelex API extensions (NOT MTHDS Protocol routes) over

pipelex_sdk/prepare_inputs.py

@@ -14,8 +14,8 @@
 field merely named `url` was read from disk and uploaded. The descriptor states the resolved
 kind at every depth and includes optional fields, so both are gone.
 
-See `docs/input-preparation.md`, and the design of record in
-`pipelex-sdk-js/wip/prepare-inputs-selectors/design.md`.
+See `docs/input-preparation.md`. The design of record is shared with `@pipelex/sdk` and
+tracked as L-260829-300c50 in the workspace ledger.
 """
 
 from __future__ import annotations

tests/unit/test_prepare_inputs.py

@@ -1,6 +1,6 @@
 """`prepare_inputs` — signature-driven input preparation over the input-form descriptor.
 
-Cases derive from the shared behavior matrix (`wip/upload/behavior-matrix.md`) and port
+Cases derive from the behavior this SDK shares with `@pipelex/sdk` (`docs/input-preparation.md`) and port
 `pipelex-sdk-js/tests/prepare-inputs.test.ts`: file-bearing positions come from the DESCRIPTOR's
 declared kind (`document` / `image`), assets are uploaded and rewritten to `pipelex-storage://`
 in `url`, http(s)/storage references pass through, dedup keys on source identity, and the call