terp-cli 0.37.0__tar.gz → 0.38.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. {terp_cli-0.37.0 → terp_cli-0.38.0}/PKG-INFO +9 -9
  2. {terp_cli-0.37.0 → terp_cli-0.38.0}/pyproject.toml +9 -9
  3. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/__init__.py +17 -3
  4. {terp_cli-0.37.0 → terp_cli-0.38.0}/.gitignore +0 -0
  5. {terp_cli-0.37.0 → terp_cli-0.38.0}/signer/Dockerfile +0 -0
  6. {terp_cli-0.37.0 → terp_cli-0.38.0}/signer/terp-arch-releases.json +0 -0
  7. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/_appref.py +0 -0
  8. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/_engine.py +0 -0
  9. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/_output.py +0 -0
  10. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/_subjects.py +0 -0
  11. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/access.py +0 -0
  12. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/api_contract.py +0 -0
  13. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/api_contract_bounds.py +0 -0
  14. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/api_contract_check.py +0 -0
  15. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/api_contract_schemas.py +0 -0
  16. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/api_contract_shapes.py +0 -0
  17. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/apidocs.py +0 -0
  18. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/authz_surface.py +0 -0
  19. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/capabilities.py +0 -0
  20. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/deploy_safety.py +0 -0
  21. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/deployment_adopt.py +0 -0
  22. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/deployment_app.py +0 -0
  23. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/deployment_check.py +0 -0
  24. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/deployment_declare.py +0 -0
  25. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/deployment_render.py +0 -0
  26. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/dev.py +0 -0
  27. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/docker.py +0 -0
  28. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/docker_masks.py +0 -0
  29. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/envfile.py +0 -0
  30. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/envrequired.py +0 -0
  31. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/envschema.py +0 -0
  32. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/envseams.py +0 -0
  33. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/fmt.py +0 -0
  34. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/grants.py +0 -0
  35. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/heartbeat.py +0 -0
  36. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/jobs.py +0 -0
  37. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/leases.py +0 -0
  38. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/locks.py +0 -0
  39. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/module_roles.py +0 -0
  40. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/openapi.py +0 -0
  41. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/outbox.py +0 -0
  42. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/ports.py +0 -0
  43. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/profiles.py +0 -0
  44. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/py.typed +0 -0
  45. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/__init__.py +0 -0
  46. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/_common.py +0 -0
  47. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/_compare.py +0 -0
  48. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/_dockerfile.py +0 -0
  49. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/_git.py +0 -0
  50. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/_image.py +0 -0
  51. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/_locks.py +0 -0
  52. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/_plan.py +0 -0
  53. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/_registry.py +0 -0
  54. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/_render.py +0 -0
  55. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/_sandbox.py +0 -0
  56. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/build.py +0 -0
  57. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/cli.py +0 -0
  58. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/dsse.py +0 -0
  59. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/gate.py +0 -0
  60. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/manifest.py +0 -0
  61. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/promote.py +0 -0
  62. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/release/sign.py +0 -0
  63. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/reseal.py +0 -0
  64. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/routes.py +0 -0
  65. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/scaffold.py +0 -0
  66. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/schema.py +0 -0
  67. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/seed.py +0 -0
  68. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/service_accounts.py +0 -0
  69. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/smoke.py +0 -0
  70. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/users.py +0 -0
  71. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/verify.py +0 -0
  72. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/version.py +0 -0
  73. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/workbench.py +0 -0
  74. {terp_cli-0.37.0 → terp_cli-0.38.0}/src/terp/cli/workbench_adopt.py +0 -0
@@ -1,23 +1,23 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: terp-cli
3
- Version: 0.37.0
3
+ Version: 0.38.0
4
4
  Summary: Terp command-line tool — inspect, scaffolding, migrations, checks, api-docs.
5
5
  Project-URL: Repository, https://github.com/AITT-NL/terp-framework
6
6
  Project-URL: Changelog, https://github.com/AITT-NL/terp-framework/blob/main/CHANGELOG.md
7
7
  License-Expression: Apache-2.0
8
8
  Requires-Python: >=3.13
9
9
  Requires-Dist: pyyaml>=6.0
10
- Requires-Dist: terp-arch==0.37.0
11
- Requires-Dist: terp-core==0.37.0
12
- Requires-Dist: terp-migrations==0.37.0
10
+ Requires-Dist: terp-arch==0.38.0
11
+ Requires-Dist: terp-core==0.38.0
12
+ Requires-Dist: terp-migrations==0.38.0
13
13
  Provides-Extra: jobs
14
- Requires-Dist: terp-cap-outbox==0.37.0; extra == 'jobs'
15
- Requires-Dist: terp-cap-scheduler-apscheduler==0.37.0; extra == 'jobs'
14
+ Requires-Dist: terp-cap-outbox==0.38.0; extra == 'jobs'
15
+ Requires-Dist: terp-cap-scheduler-apscheduler==0.38.0; extra == 'jobs'
16
16
  Provides-Extra: release
17
17
  Requires-Dist: cryptography>=46; extra == 'release'
18
18
  Requires-Dist: packaging>=24; extra == 'release'
19
- Requires-Dist: terp-cap-egress==0.37.0; extra == 'release'
19
+ Requires-Dist: terp-cap-egress==0.38.0; extra == 'release'
20
20
  Provides-Extra: scheduler
21
- Requires-Dist: terp-cap-scheduler-apscheduler==0.37.0; extra == 'scheduler'
21
+ Requires-Dist: terp-cap-scheduler-apscheduler==0.38.0; extra == 'scheduler'
22
22
  Provides-Extra: worker
23
- Requires-Dist: terp-cap-outbox==0.37.0; extra == 'worker'
23
+ Requires-Dist: terp-cap-outbox==0.38.0; extra == 'worker'
@@ -4,18 +4,18 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "terp-cli"
7
- version = "0.37.0"
7
+ version = "0.38.0"
8
8
  description = "Terp command-line tool — inspect, scaffolding, migrations, checks, api-docs."
9
9
  requires-python = ">=3.13"
10
10
  license = "Apache-2.0"
11
11
  dependencies = [
12
- "terp-core==0.37.0",
12
+ "terp-core==0.38.0",
13
13
  # `terp migrate` delegates to terp-migrations (lazily imported), keeping Alembic
14
14
  # off the path for `terp inspect` / `terp guide` while making migrations work.
15
- "terp-migrations==0.37.0",
15
+ "terp-migrations==0.38.0",
16
16
  # `terp guide rules` projects the live rule registry; terp-arch is imported lazily
17
17
  # (only when that topic is rendered), so it stays off the common `terp guide` path.
18
- "terp-arch==0.37.0",
18
+ "terp-arch==0.38.0",
19
19
  # `terp verify --only env-seams` and `terp smoke` read the compose profiles as data
20
20
  # (anchors and `<<:` merge keys resolved), so both answer without a Docker daemon or
21
21
  # even the `docker` binary. Declared explicitly rather than leant on: every app
@@ -29,11 +29,11 @@ dependencies = [
29
29
  # or a scheduler engine into apps that only use inspect/check/migrate. Deployments can select
30
30
  # one process role, while `jobs` is the convenient complete jobs-process bundle.
31
31
  [project.optional-dependencies]
32
- worker = ["terp-cap-outbox==0.37.0"]
33
- scheduler = ["terp-cap-scheduler-apscheduler==0.37.0"]
32
+ worker = ["terp-cap-outbox==0.38.0"]
33
+ scheduler = ["terp-cap-scheduler-apscheduler==0.38.0"]
34
34
  jobs = [
35
- "terp-cap-outbox==0.37.0",
36
- "terp-cap-scheduler-apscheduler==0.37.0",
35
+ "terp-cap-outbox==0.38.0",
36
+ "terp-cap-scheduler-apscheduler==0.38.0",
37
37
  ]
38
38
  # `terp release` and `terp promote` (ADR 0187): the DSSE signature (cryptography), the lock's
39
39
  # markers (packaging), and the one declared way to a registry, an index and the vulnerability
@@ -42,7 +42,7 @@ jobs = [
42
42
  release = [
43
43
  "cryptography>=46",
44
44
  "packaging>=24",
45
- "terp-cap-egress==0.37.0",
45
+ "terp-cap-egress==0.38.0",
46
46
  ]
47
47
 
48
48
  [project.scripts]
@@ -89,6 +89,8 @@ Add a module (the "10-minute module")
89
89
  number: str = Field(max_length=50, index=True, unique=True)
90
90
  amount_cents: int
91
91
  issued_at: datetime = Field(sa_type=UtcDateTime()) # an instant, stored as UTC
92
+ Every timestamp column is UtcDateTime from terp.core: DateTime(timezone=True) stores the
93
+ wall time on SQLite and is refused, and swapping it in needs no migration.
92
94
 
93
95
  2) schemas.py DTOs (cap every input string; the Read DTO is what the API returns)
94
96
  from terp.core import BaseSchema, BaseUpdateSchema
@@ -100,6 +102,10 @@ Add a module (the "10-minute module")
100
102
  amount_cents: int | None = None
101
103
  class InvoiceRead(BaseSchema): # NOT the table model
102
104
  id: uuid.UUID; number: str; amount_cents: int; issued_at: datetime; version: int
105
+ A timestamp a client sends must carry its UTC offset: "2026-11-06T10:00:00" is a 422 at
106
+ the field, "2026-11-06T10:00:00Z" is taken (ADR 0206). For a sender known to send UTC
107
+ without one, type that field NaiveMeansUtc and mark it
108
+ (# arch-allow-request-timestamps-carry-their-offset: <reason>); never by default.
103
109
 
104
110
  3) service.py business logic (CRUD is inherited and audited)
105
111
  from terp.core import BaseService
@@ -399,7 +405,13 @@ Services (BaseService)
399
405
  sort=sort)
400
406
  None values are dropped, so an absent optional parameter needs no branching. Filters
401
407
  compose ON TOP of base_query(), so row scope and business_filters() still apply —
402
- they cannot widen a read. Don't write a list() override to do this by hand.
408
+ they cannot widen a read. Don't write a list() override to do this by hand. A
409
+ timestamp filter (taken_after: datetime | None = None) is refused with a 400 when the
410
+ caller sends no UTC offset, so the bound always names an instant (ADR 0206). A calendar
411
+ day on a timestamp column needs the zone whose day it is: declare it,
412
+ FilterField("taken_on", Reading.taken_at, zone="Europe/Amsterdam"), with a route
413
+ parameter taken_on: date | None = None, and the day is compared as the whole of it
414
+ (eq that day, gte from its start, lte through its end); without a zone a day is a 400.
403
415
  - On a large table, prefer keyset pagination: a route takes CursorPaginationDep and
404
416
  returns CursorPage[ReadDTO] from self.list_by_cursor(session, pagination=...) —
405
417
  no OFFSET scan, and the exact COUNT runs only when the caller asks
@@ -882,12 +894,14 @@ Boundaries for a second top-level package (an ungated worker)
882
894
  `no_raw_outbound_http`, `no_adhoc_config_decrypt`, `no_internal_imports`, `no_print`,
883
895
  `no_naive_datetime`, `no_eval_or_exec`, `no_star_imports`, `no_blocking_sleep`,
884
896
  `no_mutable_default_args`, `no_todo_fixme`, `no_oversized_python_files`,
885
- `no_empty_tests`, `no_manual_table_schema`, `frozen_values_hold_no_mutable_collection`.
897
+ `no_empty_tests`, `no_manual_table_schema`, `frozen_values_hold_no_mutable_collection`,
898
+ and `request_timestamps_carry_their_offset`, since a worker that reads another system's
899
+ timestamps through a schema is held to their offset just as the app is.
886
900
  It does NOT get the rules that are properties of being a mounted app: a route's response
887
901
  model, a module's policy, a table's migration, the guarded session (ADR 0141). The check
888
902
  report says which, per root, under `roots` — so a green over the companion names the
889
903
  rules it is green about, and is a claim you can publish.
890
- Expect the first declared run to be red. Sixteen rules arriving at once over a package
904
+ Expect the first declared run to be red. Seventeen rules arriving at once over a package
891
905
  nothing has ever scanned will find things; they were violations all along.
892
906
  - WHAT A HAND-WRITTEN TEST IS STILL FOR. Not `no_dynamic_sql` or `no_print` — those now
893
907
  reach the second package, and a bespoke AST scan beside them is a weaker copy that has
File without changes
File without changes
File without changes
File without changes