[SILO-1466] feat(v2): variant F surface — flat path, loaded rows, typed filters - #70

Open

Prashant-Surya wants to merge 95 commits into

mainfrom

feat/silo-1466-python-sdk-v2

Commits on Aug 30, 2026

feat(v2): add the complete api_v2 surface — 120 resource groups, 406 operations

Prashant-Surya
and
claude
committed
5ae278c

Commits on Sep 3, 2026

feat(v2): link/unlink type properties, add/remove bridges, slug/key lookups (review feedback)

Prashant-Surya
and
claude
committed
a57823e

Commits on Sep 7, 2026

feat: ship py.typed marker and depend on typing_extensions

Prashant-Surya
and
claude
committed
ae7873b
feat: generate Literal field and order_by aliases per operation

Prashant-Surya
and
claude
committed
98ce60b
feat: generate TypedDict filter kwargs; regenerate constants at 407 operations

Prashant-Surya
and
claude
committed
f64371b
fix: regenerate constants.py from origin/preview golden; pin display_name filter

Prashant-Surya
and
claude
committed
38c9cf8
chore: repair the malformed .gitignore line

Prashant-Surya
and
claude
committed
4392b8f
fix: type array query params as Sequence; make the typing tests actually run

Prashant-Surya
and
claude
committed
06a7a6a
refactor: kernel resources take path ids per call, not bound scope

Prashant-Surya
and
claude
committed
14a9534
feat: kernel supports per-method alternate path templates

Prashant-Surya
and
claude
committed
e471c48
feat: loaded rows raise FieldNotRequested for unrequested fields

Prashant-Surya
and
claude
committed
8666353
fix: harden Owned against silent id misassignment; guard stale bridge_path at definition

Prashant-Surya
and
claude
committed
730f34e
fix: guard bridge_path at url_for call time; convert the three dead declarations to extra_paths

Prashant-Surya
and
claude
committed
16a1a8b
feat: re-author States on the flat form as the depth-2 exemplar

Prashant-Surya
and
claude
committed
de464b3
feat: flat tree root; delete the workspace, project and wiki locators

Prashant-Surya
and
claude
committed
8d2756b
fix: expose fields on writes and per_page/offset on list (fix round 1)

Prashant-Surya
and
claude
committed
cebd881
feat: fetched projects navigate to their children

Prashant-Surya
and
claude
committed
ca309a2
feat: re-author work items and comments as the depth-3 exemplar

Prashant-Surya
and
claude
committed
1d0ee75
fix: task 9+10 round 1 -- LoadedProject.work_items and dropped-coverage signpost

Prashant-Surya
and
claude
committed
7b4fef1
feat: grouping node, singleton, bridge and alternate-path shapes on the flat tree

Prashant-Surya
and
claude
committed
0c2a77f
fix: thread fields= through _load so sparse fetches raise, not None

Prashant-Surya
and
claude
committed
c7e4743
fix: iterate/update/upsert return navigable rows; restore WorkspaceFeature.id

Prashant-Surya
and
claude
committed
b041000
docs: describe the variant F surface; prove filter typing with mypy

Prashant-Surya
and
claude
committed
4d22c95
fix: correct release-labels bridge signature in prose docs

Prashant-Surya
and
claude
committed
95f472d
fix: derive Loaded field presence from the response, not the request

Prashant-Surya
and
claude
committed
d28e3a9
fix: give loaded-row navigation real types instead of Any

Prashant-Surya
and
claude
committed
2948615
fix: wrap the missing-path-id KeyError in a named MissingPathId error

Prashant-Surya
and
claude
committed
3ef632e
fix: name the wired-but-unmigrated v2 branches instead of failing with KeyError

Prashant-Surya
and
claude
committed
f035c36
refactor: promote row loading, singletons and 204 actions into the kernel

Prashant-Surya
and
claude
committed
08e0d77
fix: return loaded rows from find_by_name and archive/unarchive

Prashant-Surya
and
claude
committed
709f7ef
refactor: make the path-id naming rule one rule, and write it down

Prashant-Surya
and
claude
committed
e6412f1
test: make the iterate laziness tests discriminate

Prashant-Surya
and
claude
committed
26c39c5
feat: export FieldNotRequested from plane.api.v2

Prashant-Surya
and
claude
committed
f8ee826
chore: revert incidental reformatting of unmigrated v2 files

Prashant-Surya
and
claude
committed
35976d6
fix: let dunder probes through PendingMigration, and fix string fields= in Loaded.build

Prashant-Surya
and
claude
committed
0db4cf6
docs: fix CLAUDE.md's stale bridge_path guidance and add param name

Prashant-Surya
and
claude
committed
1e50666

Commits on Sep 8, 2026

test: flat-form fixtures for the already-migrated resources

Prashant-Surya
and
claude
committed
da2c244
feat(v2): flat form for the read-only workspace resources

Prashant-Surya
and
claude
committed
6cfa1bc
feat(v2): flat form for the workspace CRUD resources

Prashant-Surya
and
claude
committed
07f5e0c
fix(v2): make Roles' slug filter reachable, tighten find_by_slug/find_by_name docs

Prashant-Surya
and
claude
committed
1337fa9
feat(v2): flat form for the alternate-path and singleton workspace resources

Prashant-Surya
and
claude
committed
dad5a6c
feat(v2): wire the migrated workspace resources onto the tree

Prashant-Surya
and
claude
committed
9edd750
docs: record the workspace resources now reachable on the flat tree

Prashant-Surya
and
claude
committed
ad0b670
fix(v2): table-driven class+URL proof for tree attachments, fix stale count

Prashant-Surya
and
claude
committed
360655d
fix(docs): correct migrated/remaining resource counts (19/59, not 20/58)

Prashant-Surya
and
claude
committed
13663ac
fix(v2): drop the `_id` suffix from every path id this batch added

Prashant-Surya
and
claude
committed
1fbcf0a
test(v2): derive the path-id naming sweep from the tree, not a hand list

Prashant-Surya
and
claude
committed
327a289
test(v2): prove the tree-attachment table is complete, not just correct

Prashant-Surya
and
claude
committed
690ee09
feat(v2): expose `expand` wherever the golden offers it, and sweep for the gap

Prashant-Surya
and
claude
committed
4a7cf42
test(v2): pin Roles' hand-written filter set to the generated TypedDict

Prashant-Surya
and
claude
committed
55a054c
refactor(v2): one kernel helper for custom actions with their own envelope

Prashant-Surya
and
claude
committed
9b0914b
refactor(v2): bring UserAssets onto the generated-constants recipe

Prashant-Surya
and
claude
committed
87d0686
docs: record the derived sweeps and the custom-action kernel helper

Prashant-Surya
and
claude
committed
106d2fa
feat(v2): flat form for the project-level leaf resources

Prashant-Surya
and
claude
committed
2a511c1
feat(v2): flat form for cycles, milestones and modules

Prashant-Surya
and
claude
committed
5694b71
feat(v2): flat form for estimates, webhooks and the work item children

Prashant-Surya
and
claude
committed
f9aac59
feat(v2): navigable rows for cycles, milestones, modules, estimates and webhooks

Prashant-Surya
and
claude
committed
d42250f
fix(v2): split fields exposure ruling for one-time-response writes

Prashant-Surya
and
claude
committed
67d8366
feat(v2): work item children become real resources on the tree

Prashant-Surya
and
claude
committed
8f80880
feat(v2): wire the project band onto the tree

Prashant-Surya
and
claude
committed
e87da3c
test(v2): sweep every resource class, not just the ones that happen to qualify

Prashant-Surya
and
claude
committed
0760bbb
test(v2): scope the path-id naming sweep to actual path ids

Prashant-Surya
and
claude
committed
0d7cce2
docs: record the project band and the navigable families

Prashant-Surya
and
claude
committed
0887d7e
feat(v2): a fetched project reaches all fifteen of its children

Prashant-Surya
and
claude
committed
0e93b86
fix(v2): loaded rows keep the fields the model does not declare

Prashant-Surya
and
claude
committed
516dad9
test(v2): freeze the opt-out list's membership, not its length

Prashant-Surya
and
claude
committed
4367bdd
test(v2): sweep the `fields` rule instead of trusting the prose

Prashant-Surya
and
claude
committed
c5ad2a3
refactor(v2): route the dict-shaped `list`s through the kernel

Prashant-Surya
and
claude
committed
935a737
test(v2): detect migration by shape over every method, not by `list`

Prashant-Surya
and
claude
committed
aff7ed0
test(v2): exact URL comparisons in the work item resource tests

Prashant-Surya
and
claude
committed
88c9668
docs: record the closed gaps in the v2 rules

Prashant-Surya
and
claude
committed
ab88e98
feat(v2): flat form and navigable rows for collections and customers

Prashant-Surya
and
claude
committed
546ab1d
feat(v2): flat form and navigable rows for initiatives and releases

Prashant-Surya
and
claude
committed
b52103c
feat(v2): flat form and navigable rows for both automations families

Prashant-Surya
and
claude
committed
ee6bb6d
feat(v2): flat form and navigable rows for work item types and properties

Prashant-Surya
and
claude
committed
13f48c3
feat(v2): flat form for workflows; the opt-out list is empty

Prashant-Surya
and
claude
committed
d29d9da
feat(v2): wire every remaining family onto the tree

Prashant-Surya
and
claude
committed
0e82c85
docs: variant F migration complete across all 90 resources

Prashant-Surya
and
claude
committed
684c77c
feat(v2): make Workspaces navigable, and sweep for the gap that hid it

Prashant-Surya
and
claude
committed
9e521f9
docs: state the `find_by_*` default the right way round

Prashant-Surya
and
claude
committed
97cb5b6
docs(v2): explain the one class that answers a bare navigable row

Prashant-Surya
and
claude
committed
b1d6280
fix(v2): attach the release-tag catalog to the workspace, not to releases

Prashant-Surya
and
claude
committed
464dfd5
refactor(v2): route the last six transport bypasses through the kernel

Prashant-Surya
and
claude
committed
76a9a55
test(v2): sweep that `iterate` yields what `list` returns

Prashant-Surya
and
claude
committed
fdc1483
style: black a pre-existing nit in a file this wave touched

Prashant-Surya
and
claude
committed
d100339
test(v2): stop the live integration suite from skipping silently

Prashant-Surya
and
claude
committed
7729dcc
fix(v2): make the pagination envelope reachable at all

Prashant-Surya
and
claude
committed
6efeda3
fix(v2): stop a bound navigation property handing back an unbound resource

Prashant-Surya
and
claude
committed
1df1862
test(v2): refresh the first half of the integration suite onto the flat surface

Prashant-Surya
and
claude
committed
ba00987
fix(v2): one read verb for a singleton, not two

Prashant-Surya
and
claude
committed
5b00c03
test(v2): finish the live-suite refresh and pin the surface with mypy

Prashant-Surya
and
claude
committed
a15e648

Commits on Sep 9, 2026

test(v2): assert the sparse-field contract the SDK has, not the one it replaced

Prashant-Surya
and
claude
committed
e74de0f
test(v2): read the webhook fixture as the model it is

Prashant-Surya
and
claude
committed
8d42dc8
Merge origin/main into the v2 variant F branch

Prashant-Surya
and
claude
committed
aa0f74e
fix(ci): restore the golden header path the drift check expects

Prashant-Surya
and
claude
committed
5661f95