@aiaiai-pt/frankctl 0.4.2 → 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 +15 -0
- package/README.md +8 -1
- package/dist/index.js +162 -160
- package/package.json +1 -1
- package/skills/frank-cli/SKILL.md +261 -204
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,21 @@
|
|
|
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
|
+
|
|
17
|
+
## 0.4.3
|
|
18
|
+
|
|
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).
|
|
20
|
+
|
|
6
21
|
## 0.4.2
|
|
7
22
|
|
|
8
23
|
- Add `frankctl skill` — prints the bundled agent SKILL.md to stdout (seed any agent runtime; `frankctl skill > .claude/skills/frankctl/SKILL.md`).
|
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 +
|