@trillioncore/cli 1.0.0-next.3 → 1.0.0-next.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/README.md +2 -0
- package/dist/index.js +5 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -53,6 +53,8 @@ The catalog describes stored content kinds or approved **active synchronized** P
|
|
|
53
53
|
|
|
54
54
|
For native content, `recordSchemas` describes the allowed scalar fields in `get`'s `attributes`, grouped by recognized observed record kind. These field names/types come from the same definitions used to validate stored records. Fields may be absent on individual records; a schema does not prove populated values, complete history, relationship IDs, or SQL support. Empty connections return no observed schemas; unknown kinds remain listed without invented definitions. Table resources retain their separate `relation.columns` metadata.
|
|
55
55
|
|
|
56
|
+
`lifecycle` reports the persisted `activeRun` (queued/running) and `lastFinishedRun` (completed/failed), independently of the last successful sync timestamp. Null means no matching run was recorded. The stored `startedAt` can be enqueue time; a running state does not prove worker health. Progress counts are processed pages/records, not percentages or newly created records. A completed run does not prove exhaustive source coverage. Native `page-upserts` may remain visible even if a later page fails; `active-revision` describes snapshot publication, not whether production execution is configured. `sourceRemovals: not-propagated` means native source removal events do not remove stored records; `revision-scoped` describes active-snapshot visibility, not a guarantee of continuous deletion tracking. Lifecycle/counter and freshness changes alone do not invalidate resource cursors; schema/revision changes still require restarting discovery. No cursors, raw failure messages or credentials appear in lifecycle metadata.
|
|
57
|
+
|
|
56
58
|
Respect `operations[].available` and `warnings`. Production synced SQL is currently not wired, so its schemas can be discovered but SQL is explicitly unavailable with `synced_sql_not_configured`. Live PostgreSQL resources are outside this catalog's coverage. No semantic search or actions are advertised. Native connectors retain search/get capabilities when empty; `recordKinds` lists only observed kinds (capped at 100 with an explicit warning). Synced manifests use existing limits of 25 tables/1,000 columns. A successful sync timestamp does not establish complete history or current provider state. Business definitions, currency and attribution are not inferred.
|
|
57
59
|
|
|
58
60
|
All discovery uses the same organization, live token scope, connection permission and enabled-state checks as existing agent reads. Multiple internal adapters may eventually fulfill a connection's capabilities; this catalog does not introduce a separate user-visible integration for each adapter.
|
package/dist/index.js
CHANGED
|
@@ -3853,6 +3853,11 @@ function renderIndex(result) {
|
|
|
3853
3853
|
return [
|
|
3854
3854
|
`Resources: ${catalog.connectionRef}`,
|
|
3855
3855
|
`Last successful sync: ${catalog.freshness.lastSuccessfulSyncAt ?? "unknown"}; source completeness: ${catalog.freshness.sourceCompleteness}`,
|
|
3856
|
+
...catalog.lifecycle ? [
|
|
3857
|
+
`Publication: ${catalog.lifecycle.publication}; source removals: ${catalog.lifecycle.sourceRemovals}`,
|
|
3858
|
+
...[["Active run", catalog.lifecycle.activeRun], ["Last finished run", catalog.lifecycle.lastFinishedRun]].map(([label, run]) => run ? `${label}: ${run.status}; recorded at: ${run.startedAt}; finished: ${run.completedAt ?? "not recorded"}; attempts: ${run.attemptCount}; pages: ${run.progress.pagesProcessed}; seen: ${run.progress.recordsSeen}; upserted: ${run.progress.recordsUpserted}; skipped: ${run.progress.recordsSkipped}` : `${label}: none recorded`),
|
|
3859
|
+
"Run state is recorded metadata, not worker health. Completed does not mean full source coverage."
|
|
3860
|
+
] : [],
|
|
3856
3861
|
...catalog.resources.flatMap((resource) => [
|
|
3857
3862
|
`${resource.name} (${resource.kind})`,
|
|
3858
3863
|
...resource.recordKinds ? [` Observed record kinds: ${resource.recordKinds.join(", ") || "none"}`] : [],
|