feat(api): v1 contract redesign + Python/Java SDKs + docs by ancongui · Pull Request #28 · firefly-operationOS/flydocs

docs: API contract v1 redesign spec

ancongui

committed

docs: implementation plan for API v1 contract redesign

ancongui

committed

chore: capture baseline test snapshot for v1 redesign

ancongui

committed

refactor(interfaces): rewrite DTOs and enums for API v1 contract

ancongui

committed

refactor(db): Extraction entity + ExtractionRepository + alembic v1 rename

ancongui

committed

refactor(core+web): sweep core services + workers + controllers to v1 vocabulary

ancongui

committed

test(v1): migrate enum, validator, field/request validator tests

ancongui

committed

test(v1): migrate event envelopes, webhook publisher, extraction repository tests

ancongui

committed

test(v1): migrate submit/list/get/reaper handler tests

ancongui

committed

test(v1): migrate worker concurrency / retry / bbox refine worker tests

ancongui

committed

test(v1): migrate bbox/transformer/integration/llm tests

ancongui

committed

docs: post-server test snapshot for Phase 5 of API v1 redesign

ancongui

committed

docs(api-reference): rewrite for v1

ancongui

committed

docs(payload-reference): rewrite for v1

ancongui

committed

docs: migration guide v0 -> v1

ancongui

committed

docs(validators): rename standard-validators -> validators, rewrite for v1

ancongui

committed

refactor(py-sdk): rewrite models around v1 DTOs; consolidate request.py into models.py

ancongui

committed

feat(py-sdk): Client + AsyncClient with extractions sub-resource

ancongui

committed

feat(py-sdk): WebhookVerifier returns typed EventEnvelope; errors expose ProblemDetails

ancongui

committed

test(py-sdk): rewrite around v1 surface (156 passing)

ancongui

committed

docs(py-sdk): rewrite examples + README + QUICKSTART + TUTORIAL for v1

ancongui

committed

feat(py-sdk): re-export full v1 surface; bump to 26.6.0

ancongui

committed

docs: sweep related docs for v1 vocabulary

ancongui

committed

docs: rewrite QUICKSTART/README/sdks-README + add CHANGELOG for v1

ancongui

committed

docs: align cross-references and last v1 vocabulary sweeps

ancongui

committed

feat(java-sdk): rewrite full SDK for v1 contract

ancongui

committed

fix(server): purge remaining v0 field names from LLM-facing schema

ancongui

committed

docs: capture final post-redesign test snapshot for Phase 9 sign-off

ancongui

committed

fix: sync timeout returns 408, bbox-worker topic, alembic + transform.yaml v1 alignment

ancongui

committed

chore: polish + ruff format + bump server to 26.6.0 for v1 release

ancongui

committed

fix(deps): cap fireflyframework-agentic<26.5.21 (pre-release transitive mistralai)

ancongui

committed

fix(deps): override transitive mistralai<2.0.0 to dodge pre-release-only 2.x

ancongui

committed

fix(ci): exclude scripts/ from ruff + wrap long migration lines

ancongui

committed

docs: replace 2 lingering 'StandardValidator(s)' refs with v1 vocabulary

ancongui

committed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(api): v1 contract redesign + Python/Java SDKs + docs#28

feat(api): v1 contract redesign + Python/Java SDKs + docs#28
ancongui merged 34 commits into
mainfrom
feat/api-v1-redesign

Commits on May 27, 2026

docs: API contract v1 redesign spec

docs: implementation plan for API v1 contract redesign

chore: capture baseline test snapshot for v1 redesign

refactor(interfaces): rewrite DTOs and enums for API v1 contract

refactor(db): Extraction entity + ExtractionRepository + alembic v1 rename

refactor(core+web): sweep core services + workers + controllers to v1 vocabulary

test(v1): migrate enum, validator, field/request validator tests

test(v1): migrate event envelopes, webhook publisher, extraction repository tests

test(v1): migrate submit/list/get/reaper handler tests

test(v1): migrate worker concurrency / retry / bbox refine worker tests

test(v1): migrate bbox/transformer/integration/llm tests

docs: post-server test snapshot for Phase 5 of API v1 redesign

docs(api-reference): rewrite for v1

docs(payload-reference): rewrite for v1

docs: migration guide v0 -> v1

docs(validators): rename standard-validators -> validators, rewrite for v1

refactor(py-sdk): rewrite models around v1 DTOs; consolidate request.py into models.py

feat(py-sdk): Client + AsyncClient with extractions sub-resource

feat(py-sdk): WebhookVerifier returns typed EventEnvelope; errors expose ProblemDetails

test(py-sdk): rewrite around v1 surface (156 passing)

docs(py-sdk): rewrite examples + README + QUICKSTART + TUTORIAL for v1

feat(py-sdk): re-export full v1 surface; bump to 26.6.0

docs: sweep related docs for v1 vocabulary

docs: rewrite QUICKSTART/README/sdks-README + add CHANGELOG for v1

docs: align cross-references and last v1 vocabulary sweeps

feat(java-sdk): rewrite full SDK for v1 contract

fix(server): purge remaining v0 field names from LLM-facing schema

docs: capture final post-redesign test snapshot for Phase 9 sign-off

fix: sync timeout returns 408, bbox-worker topic, alembic + transform.yaml v1 alignment

chore: polish + ruff format + bump server to 26.6.0 for v1 release

fix(deps): cap fireflyframework-agentic<26.5.21 (pre-release transitive mistralai)

fix(deps): override transitive mistralai<2.0.0 to dodge pre-release-only 2.x

fix(ci): exclude scripts/ from ruff + wrap long migration lines

docs: replace 2 lingering 'StandardValidator(s)' refs with v1 vocabulary