@aiaiai-pt/frankctl 0.4.3 → 0.4.4

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.
package/CHANGELOG.md CHANGED
@@ -3,6 +3,17 @@
3
3
  All notable changes to `@aiaiai-pt/frankctl` are documented here. This project
4
4
  adheres to [Semantic Versioning](https://semver.org/).
5
5
 
6
+ ## 0.4.4
7
+
8
+ - Add `backing-datasets sync --force` and poll the exact ontology sync run,
9
+ exposing safe replay reason, snapshot, row count, and attempted/applied
10
+ effective-SyncSpec fingerprint evidence.
11
+ - Preserve ordinary-sync compatibility with an older API through legacy status
12
+ polling and safe no-wait output. Capability-check `--force` before mutation,
13
+ so an unsupported server receives zero sync POSTs.
14
+ - Prefer the precision-safe `snapshot_id_exact` in human sync output while JSON
15
+ retains numeric `snapshot_id` and exposes the additive exact decimal string.
16
+
6
17
  ## 0.4.3
7
18
 
8
19
  - Rewrite the bundled agent skill (`SKILL.md`) to be outward-facing and declarative-first: leads with the repeatable `pipelines scaffold → edit → apply` loop (multi-doc `frank.platform/v1` YAML, `--dry-run-server`, `--wait`, idempotency/`--allow-recreate`), with the imperative subcommands as a reference. Drops internal-only content (ticket refs, dev-mode/E2E-harness notes, roadmap).
package/README.md CHANGED
@@ -37,7 +37,7 @@ frankctl --help
37
37
  - `frankctl config set|get|list`
38
38
  - `frankctl pipelines list|get|validate|apply|export`
39
39
  - `frankctl sources list|get|create|update|delete|discover|sync|logs|history`
40
- - `frankctl backing-datasets list|get|create|update|delete` (alias: `frankctl bd`)
40
+ - `frankctl backing-datasets list|get|create|update|delete|sync|entities` (alias: `frankctl bd`; `sync --force` replays unchanged data/spec)
41
41
  - `frankctl sources streams list|set|refresh-schema`
42
42
  - `frankctl transforms list|get|runs|logs|trigger`
43
43
  - `frankctl runs get|wait|cancel`
@@ -48,6 +48,13 @@ frankctl --help
48
48
 
49
49
  Config files for `sources create|update`, `backing-datasets create|update`, and `sources streams set` accept YAML or JSON (use `-` to read stdin).
50
50
 
51
+ `frankctl backing-datasets sync <id>` polls exact run evidence when the API
52
+ advertises sync contract v2. For an ordinary sync against an older API, it
53
+ falls back to BackingDataset status polling and explicitly reports that replay
54
+ evidence is unavailable. `--force` is stricter: the CLI verifies the
55
+ capabilities endpoint before the mutating request and sends zero sync POSTs
56
+ when force replay is unsupported or unadvertised.
57
+
51
58
  ### Declarative apply (`pipelines apply -f`)
52
59
 
53
60
  `frankctl pipelines apply -f vertical.yaml` provisions a complete Source +