primitive-admin 1.2.0-alpha.9 → 1.3.0-alpha.1
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 +303 -186
- package/assets/skill/skills/primitive-platform/SKILL.md +93 -27
- package/dist/bin/primitive.js +15 -89
- package/dist/bin/primitive.js.map +1 -1
- package/dist/src/commands/admins.js +80 -17
- package/dist/src/commands/admins.js.map +1 -1
- package/dist/src/commands/agent-sessions.d.ts +129 -0
- package/dist/src/commands/agent-sessions.js +532 -20
- package/dist/src/commands/agent-sessions.js.map +1 -1
- package/dist/src/commands/analytics.js +207 -155
- package/dist/src/commands/analytics.js.map +1 -1
- package/dist/src/commands/apps-children.js +3 -0
- package/dist/src/commands/apps-children.js.map +1 -1
- package/dist/src/commands/apps-transitions.d.ts +39 -0
- package/dist/src/commands/apps-transitions.js +198 -0
- package/dist/src/commands/apps-transitions.js.map +1 -0
- package/dist/src/commands/apps.d.ts +17 -0
- package/dist/src/commands/apps.js +108 -3
- package/dist/src/commands/apps.js.map +1 -1
- package/dist/src/commands/auth-sessions.js +2 -0
- package/dist/src/commands/auth-sessions.js.map +1 -1
- package/dist/src/commands/auth.js +170 -50
- package/dist/src/commands/auth.js.map +1 -1
- package/dist/src/commands/blob-buckets.js +2 -0
- package/dist/src/commands/blob-buckets.js.map +1 -1
- package/dist/src/commands/collections.js +318 -256
- package/dist/src/commands/collections.js.map +1 -1
- package/dist/src/commands/comparisons.js +2 -0
- package/dist/src/commands/comparisons.js.map +1 -1
- package/dist/src/commands/config.d.ts +2 -2
- package/dist/src/commands/config.js +59 -33
- package/dist/src/commands/config.js.map +1 -1
- package/dist/src/commands/connections.js +2 -0
- package/dist/src/commands/connections.js.map +1 -1
- package/dist/src/commands/database-type-configs.js +5 -3
- package/dist/src/commands/database-type-configs.js.map +1 -1
- package/dist/src/commands/databases.js +6 -4
- package/dist/src/commands/databases.js.map +1 -1
- package/dist/src/commands/db3-types.d.ts +42 -0
- package/dist/src/commands/db3-types.js +445 -0
- package/dist/src/commands/db3-types.js.map +1 -0
- package/dist/src/commands/db3.d.ts +38 -0
- package/dist/src/commands/db3.js +2053 -0
- package/dist/src/commands/db3.js.map +1 -0
- package/dist/src/commands/documents.d.ts +110 -10
- package/dist/src/commands/documents.js +1019 -748
- package/dist/src/commands/documents.js.map +1 -1
- package/dist/src/commands/email-templates.js +74 -0
- package/dist/src/commands/email-templates.js.map +1 -1
- package/dist/src/commands/env.js +8 -4
- package/dist/src/commands/env.js.map +1 -1
- package/dist/src/commands/function-trigger-commands.d.ts +28 -0
- package/dist/src/commands/function-trigger-commands.js +341 -0
- package/dist/src/commands/function-trigger-commands.js.map +1 -0
- package/dist/src/commands/functions.js +383 -32
- package/dist/src/commands/functions.js.map +1 -1
- package/dist/src/commands/groups.js +168 -50
- package/dist/src/commands/groups.js.map +1 -1
- package/dist/src/commands/guides.js +7 -5
- package/dist/src/commands/guides.js.map +1 -1
- package/dist/src/commands/hosting.d.ts +8 -0
- package/dist/src/commands/hosting.js +509 -0
- package/dist/src/commands/hosting.js.map +1 -0
- package/dist/src/commands/init.js +129 -38
- package/dist/src/commands/init.js.map +1 -1
- package/dist/src/commands/integrations.js +82 -53
- package/dist/src/commands/integrations.js.map +1 -1
- package/dist/src/commands/locks.d.ts +5 -3
- package/dist/src/commands/locks.js +19 -61
- package/dist/src/commands/locks.js.map +1 -1
- package/dist/src/commands/metadata-category-configs.d.ts +2 -2
- package/dist/src/commands/metadata-category-configs.js +4 -2
- package/dist/src/commands/metadata-category-configs.js.map +1 -1
- package/dist/src/commands/metadata.js +55 -6
- package/dist/src/commands/metadata.js.map +1 -1
- package/dist/src/commands/prompts.js +75 -52
- package/dist/src/commands/prompts.js.map +1 -1
- package/dist/src/commands/rate-counters.d.ts +19 -0
- package/dist/src/commands/rate-counters.js +104 -0
- package/dist/src/commands/rate-counters.js.map +1 -0
- package/dist/src/commands/rule-sets.d.ts +1 -1
- package/dist/src/commands/rule-sets.js +2 -1
- package/dist/src/commands/rule-sets.js.map +1 -1
- package/dist/src/commands/schemas.d.ts +15 -0
- package/dist/src/commands/schemas.js +122 -0
- package/dist/src/commands/schemas.js.map +1 -0
- package/dist/src/commands/scripts.d.ts +9 -17
- package/dist/src/commands/scripts.js +24 -479
- package/dist/src/commands/scripts.js.map +1 -1
- package/dist/src/commands/secrets.d.ts +38 -0
- package/dist/src/commands/secrets.js +148 -6
- package/dist/src/commands/secrets.js.map +1 -1
- package/dist/src/commands/sessions.js +2 -0
- package/dist/src/commands/sessions.js.map +1 -1
- package/dist/src/commands/skill.js +2 -0
- package/dist/src/commands/skill.js.map +1 -1
- package/dist/src/commands/spent-tokens.d.ts +19 -0
- package/dist/src/commands/spent-tokens.js +79 -0
- package/dist/src/commands/spent-tokens.js.map +1 -0
- package/dist/src/commands/sync-app-settings.d.ts +58 -0
- package/dist/src/commands/sync-app-settings.js +119 -2
- package/dist/src/commands/sync-app-settings.js.map +1 -1
- package/dist/src/commands/sync-schemas.d.ts +202 -0
- package/dist/src/commands/sync-schemas.js +629 -0
- package/dist/src/commands/sync-schemas.js.map +1 -0
- package/dist/src/commands/sync-user-properties.d.ts +118 -0
- package/dist/src/commands/sync-user-properties.js +276 -0
- package/dist/src/commands/sync-user-properties.js.map +1 -0
- package/dist/src/commands/sync.d.ts +578 -546
- package/dist/src/commands/sync.js +3516 -5134
- package/dist/src/commands/sync.js.map +1 -1
- package/dist/src/commands/tokens.js +5 -3
- package/dist/src/commands/tokens.js.map +1 -1
- package/dist/src/commands/transitions.d.ts +54 -0
- package/dist/src/commands/transitions.js +418 -0
- package/dist/src/commands/transitions.js.map +1 -0
- package/dist/src/commands/usage.d.ts +42 -0
- package/dist/src/commands/usage.js +397 -0
- package/dist/src/commands/usage.js.map +1 -0
- package/dist/src/commands/user-properties.d.ts +14 -0
- package/dist/src/commands/user-properties.js +79 -0
- package/dist/src/commands/user-properties.js.map +1 -0
- package/dist/src/commands/users.js +951 -18
- package/dist/src/commands/users.js.map +1 -1
- package/dist/src/commands/vars.js +2 -0
- package/dist/src/commands/vars.js.map +1 -1
- package/dist/src/commands/waitlist.js +39 -4
- package/dist/src/commands/waitlist.js.map +1 -1
- package/dist/src/commands/workflows.d.ts +5 -83
- package/dist/src/commands/workflows.js +57 -2282
- package/dist/src/commands/workflows.js.map +1 -1
- package/dist/src/lib/analytics-query.d.ts +58 -0
- package/dist/src/lib/analytics-query.js +134 -0
- package/dist/src/lib/analytics-query.js.map +1 -0
- package/dist/src/lib/api-client.d.ts +1976 -431
- package/dist/src/lib/api-client.js +1095 -550
- package/dist/src/lib/api-client.js.map +1 -1
- package/dist/src/lib/app-settings-descriptor.d.ts +14 -2
- package/dist/src/lib/app-settings-descriptor.js +55 -1
- package/dist/src/lib/app-settings-descriptor.js.map +1 -1
- package/dist/src/lib/auth-fixtures.d.ts +44 -0
- package/dist/src/lib/auth-fixtures.js +61 -0
- package/dist/src/lib/auth-fixtures.js.map +1 -0
- package/dist/src/lib/auth-flow.d.ts +47 -1
- package/dist/src/lib/auth-flow.js +451 -14
- package/dist/src/lib/auth-flow.js.map +1 -1
- package/dist/src/lib/block-layout.d.ts +12 -23
- package/dist/src/lib/block-layout.js +26 -92
- package/dist/src/lib/block-layout.js.map +1 -1
- package/dist/src/lib/block-selector.d.ts +8 -14
- package/dist/src/lib/block-selector.js +8 -19
- package/dist/src/lib/block-selector.js.map +1 -1
- package/dist/src/lib/child-apps-local.d.ts +3 -1
- package/dist/src/lib/child-apps-local.js +9 -1
- package/dist/src/lib/child-apps-local.js.map +1 -1
- package/dist/src/lib/cli-manifest.d.ts +9 -0
- package/dist/src/lib/cli-manifest.js +10 -1
- package/dist/src/lib/cli-manifest.js.map +1 -1
- package/dist/src/lib/cli-version.d.ts +14 -0
- package/dist/src/lib/cli-version.js +38 -0
- package/dist/src/lib/cli-version.js.map +1 -0
- package/dist/src/lib/codegen-shared/prettierStable.d.ts +41 -0
- package/dist/src/lib/codegen-shared/prettierStable.js +146 -24
- package/dist/src/lib/codegen-shared/prettierStable.js.map +1 -1
- package/dist/src/lib/collection-export.d.ts +76 -15
- package/dist/src/lib/collection-export.js +116 -23
- package/dist/src/lib/collection-export.js.map +1 -1
- package/dist/src/lib/collection-principal.d.ts +22 -0
- package/dist/src/lib/collection-principal.js +35 -0
- package/dist/src/lib/collection-principal.js.map +1 -0
- package/dist/src/lib/command-groups.d.ts +30 -0
- package/dist/src/lib/command-groups.js +111 -0
- package/dist/src/lib/command-groups.js.map +1 -0
- package/dist/src/lib/command-status.d.ts +147 -0
- package/dist/src/lib/command-status.js +266 -0
- package/dist/src/lib/command-status.js.map +1 -0
- package/dist/src/lib/config-object-descriptor.d.ts +9 -22
- package/dist/src/lib/config-object-descriptor.js +113 -277
- package/dist/src/lib/config-object-descriptor.js.map +1 -1
- package/dist/src/lib/config-surface.d.ts +3 -7
- package/dist/src/lib/config-surface.js +9 -13
- package/dist/src/lib/config-surface.js.map +1 -1
- package/dist/src/lib/config-toml.d.ts +11 -2
- package/dist/src/lib/config-toml.js +25 -2
- package/dist/src/lib/config-toml.js.map +1 -1
- package/dist/src/lib/credentials-home.d.ts +7 -0
- package/dist/src/lib/credentials-home.js +45 -10
- package/dist/src/lib/credentials-home.js.map +1 -1
- package/dist/src/lib/credentials-lock.d.ts +14 -6
- package/dist/src/lib/credentials-lock.js +90 -10
- package/dist/src/lib/credentials-lock.js.map +1 -1
- package/dist/src/lib/credentials-store.d.ts +142 -70
- package/dist/src/lib/credentials-store.js +420 -111
- package/dist/src/lib/credentials-store.js.map +1 -1
- package/dist/src/lib/custodian.d.ts +8 -0
- package/dist/src/lib/custodian.js +18 -0
- package/dist/src/lib/custodian.js.map +1 -0
- package/dist/src/lib/data-input.d.ts +1 -1
- package/dist/src/lib/data-input.js +1 -1
- package/dist/src/lib/db-codegen/dbTsTypes.d.ts +1 -1
- package/dist/src/lib/db-codegen/dbTsTypes.js +3 -0
- package/dist/src/lib/db-codegen/dbTsTypes.js.map +1 -1
- package/dist/src/lib/db-codegen/dbTypeIR.d.ts +40 -1
- package/dist/src/lib/db-codegen/dbTypeIR.js +32 -8
- package/dist/src/lib/db-codegen/dbTypeIR.js.map +1 -1
- package/dist/src/lib/db-type-records.d.ts +125 -0
- package/dist/src/lib/db-type-records.js +237 -0
- package/dist/src/lib/db-type-records.js.map +1 -0
- package/dist/src/lib/db3-export.d.ts +322 -0
- package/dist/src/lib/db3-export.js +767 -0
- package/dist/src/lib/db3-export.js.map +1 -0
- package/dist/src/lib/db3-index-output.d.ts +116 -0
- package/dist/src/lib/db3-index-output.js +223 -0
- package/dist/src/lib/db3-index-output.js.map +1 -0
- package/dist/src/lib/db3-json-fields.d.ts +49 -0
- package/dist/src/lib/db3-json-fields.js +195 -0
- package/dist/src/lib/db3-json-fields.js.map +1 -0
- package/dist/src/lib/db3-type-archive.d.ts +59 -0
- package/dist/src/lib/db3-type-archive.js +95 -0
- package/dist/src/lib/db3-type-archive.js.map +1 -0
- package/dist/src/lib/db3-type-models.d.ts +148 -0
- package/dist/src/lib/db3-type-models.js +583 -0
- package/dist/src/lib/db3-type-models.js.map +1 -0
- package/dist/src/lib/deprecation.d.ts +2 -2
- package/dist/src/lib/deprecation.js +2 -2
- package/dist/src/lib/document-export-record-log.d.ts +7 -0
- package/dist/src/lib/document-export-record-log.js +9 -0
- package/dist/src/lib/document-export-record-log.js.map +1 -1
- package/dist/src/lib/document-ingest-artifact.d.ts +19 -0
- package/dist/src/lib/document-ingest-artifact.js +55 -6
- package/dist/src/lib/document-ingest-artifact.js.map +1 -1
- package/dist/src/lib/document-ingest-format2.d.ts +36 -0
- package/dist/src/lib/document-ingest-format2.js +78 -0
- package/dist/src/lib/document-ingest-format2.js.map +1 -0
- package/dist/src/lib/document-ingest-input.d.ts +9 -0
- package/dist/src/lib/document-ingest-input.js +28 -1
- package/dist/src/lib/document-ingest-input.js.map +1 -1
- package/dist/src/lib/document-ingest.d.ts +11 -1
- package/dist/src/lib/document-ingest.js +16 -0
- package/dist/src/lib/document-ingest.js.map +1 -1
- package/dist/src/lib/document-schema-rows.d.ts +42 -0
- package/dist/src/lib/document-schema-rows.js +53 -0
- package/dist/src/lib/document-schema-rows.js.map +1 -0
- package/dist/src/lib/experimental-apis.d.ts +36 -0
- package/dist/src/lib/experimental-apis.js +46 -0
- package/dist/src/lib/experimental-apis.js.map +1 -0
- package/dist/src/lib/file-attachment.d.ts +24 -0
- package/dist/src/lib/file-attachment.js +31 -0
- package/dist/src/lib/file-attachment.js.map +1 -0
- package/dist/src/lib/function-authorize-check.d.ts +142 -0
- package/dist/src/lib/function-authorize-check.js +311 -0
- package/dist/src/lib/function-authorize-check.js.map +1 -0
- package/dist/src/lib/function-authorize-view.d.ts +36 -0
- package/dist/src/lib/function-authorize-view.js +110 -0
- package/dist/src/lib/function-authorize-view.js.map +1 -0
- package/dist/src/lib/function-bundle.d.ts +27 -5
- package/dist/src/lib/function-bundle.js +142 -7
- package/dist/src/lib/function-bundle.js.map +1 -1
- package/dist/src/lib/function-collect.d.ts +112 -12
- package/dist/src/lib/function-collect.js +601 -12
- package/dist/src/lib/function-collect.js.map +1 -1
- package/dist/src/lib/function-db-types.d.ts +65 -11
- package/dist/src/lib/function-db-types.js +326 -157
- package/dist/src/lib/function-db-types.js.map +1 -1
- package/dist/src/lib/function-document-types.d.ts +19 -7
- package/dist/src/lib/function-document-types.js +24 -12
- package/dist/src/lib/function-document-types.js.map +1 -1
- package/dist/src/lib/function-grants-preflight.d.ts +99 -0
- package/dist/src/lib/function-grants-preflight.js +154 -2
- package/dist/src/lib/function-grants-preflight.js.map +1 -1
- package/dist/src/lib/function-lint.d.ts +85 -0
- package/dist/src/lib/function-lint.js +442 -0
- package/dist/src/lib/function-lint.js.map +1 -0
- package/dist/src/lib/function-log-row.js +21 -2
- package/dist/src/lib/function-log-row.js.map +1 -1
- package/dist/src/lib/function-run.d.ts +13 -21
- package/dist/src/lib/function-run.js +14 -27
- package/dist/src/lib/function-run.js.map +1 -1
- package/dist/src/lib/function-schema-codegen.d.ts +86 -22
- package/dist/src/lib/function-schema-codegen.js +194 -88
- package/dist/src/lib/function-schema-codegen.js.map +1 -1
- package/dist/src/lib/function-schema-refs.d.ts +98 -0
- package/dist/src/lib/function-schema-refs.js +177 -0
- package/dist/src/lib/function-schema-refs.js.map +1 -0
- package/dist/src/lib/function-sync.d.ts +120 -6
- package/dist/src/lib/function-sync.js +217 -26
- package/dist/src/lib/function-sync.js.map +1 -1
- package/dist/src/lib/function-trigger-listing.d.ts +11 -6
- package/dist/src/lib/function-trigger-listing.js +32 -11
- package/dist/src/lib/function-trigger-listing.js.map +1 -1
- package/dist/src/lib/function-typecheck.d.ts +52 -0
- package/dist/src/lib/function-typecheck.js +174 -54
- package/dist/src/lib/function-typecheck.js.map +1 -1
- package/dist/src/lib/function-versions.d.ts +2 -0
- package/dist/src/lib/function-versions.js +1 -0
- package/dist/src/lib/function-versions.js.map +1 -1
- package/dist/src/lib/generated-build-flags.d.ts +13 -0
- package/dist/src/lib/generated-build-flags.js +14 -0
- package/dist/src/lib/generated-build-flags.js.map +1 -0
- package/dist/src/lib/generated-command-status.d.ts +6 -0
- package/dist/src/lib/generated-command-status.js +502 -0
- package/dist/src/lib/generated-command-status.js.map +1 -0
- package/dist/src/lib/generated-config-surfaces.d.ts +804 -140
- package/dist/src/lib/generated-config-surfaces.js +2491 -1806
- package/dist/src/lib/generated-config-surfaces.js.map +1 -1
- package/dist/src/lib/generated-sdk-types.d.ts +1 -1
- package/dist/src/lib/generated-sdk-types.js +1 -1
- package/dist/src/lib/generated-sdk-types.js.map +1 -1
- package/dist/src/lib/hosting-build.d.ts +97 -0
- package/dist/src/lib/hosting-build.js +204 -0
- package/dist/src/lib/hosting-build.js.map +1 -0
- package/dist/src/lib/hosting-client.d.ts +167 -0
- package/dist/src/lib/hosting-client.js +340 -0
- package/dist/src/lib/hosting-client.js.map +1 -0
- package/dist/src/lib/hosting-environments.d.ts +32 -0
- package/dist/src/lib/hosting-environments.js +74 -0
- package/dist/src/lib/hosting-environments.js.map +1 -0
- package/dist/src/lib/hosting-errors.d.ts +30 -0
- package/dist/src/lib/hosting-errors.js +43 -0
- package/dist/src/lib/hosting-errors.js.map +1 -0
- package/dist/src/lib/hosting-token.d.ts +46 -0
- package/dist/src/lib/hosting-token.js +60 -0
- package/dist/src/lib/hosting-token.js.map +1 -0
- package/dist/src/lib/hosting-trust-step.d.ts +67 -0
- package/dist/src/lib/hosting-trust-step.js +279 -0
- package/dist/src/lib/hosting-trust-step.js.map +1 -0
- package/dist/src/lib/hosting-trust.d.ts +77 -0
- package/dist/src/lib/hosting-trust.js +194 -0
- package/dist/src/lib/hosting-trust.js.map +1 -0
- package/dist/src/lib/hosting-wait.d.ts +42 -0
- package/dist/src/lib/hosting-wait.js +84 -0
- package/dist/src/lib/hosting-wait.js.map +1 -0
- package/dist/src/lib/hosting-wfp-upload.d.ts +86 -0
- package/dist/src/lib/hosting-wfp-upload.js +149 -0
- package/dist/src/lib/hosting-wfp-upload.js.map +1 -0
- package/dist/src/lib/init-assets.d.ts +2 -6
- package/dist/src/lib/init-assets.js +11 -27
- package/dist/src/lib/init-assets.js.map +1 -1
- package/dist/src/lib/init-ios-links.d.ts +11 -7
- package/dist/src/lib/init-ios-links.js +28 -22
- package/dist/src/lib/init-ios-links.js.map +1 -1
- package/dist/src/lib/init-login-note.d.ts +13 -0
- package/dist/src/lib/init-login-note.js +22 -0
- package/dist/src/lib/init-login-note.js.map +1 -0
- package/dist/src/lib/init-schema.d.ts +15 -0
- package/dist/src/lib/init-schema.js +54 -0
- package/dist/src/lib/init-schema.js.map +1 -1
- package/dist/src/lib/integration-test-request.d.ts +54 -0
- package/dist/src/lib/integration-test-request.js +207 -0
- package/dist/src/lib/integration-test-request.js.map +1 -0
- package/dist/src/lib/invoker-shared-enums.d.ts +35 -0
- package/dist/src/lib/invoker-shared-enums.js +98 -0
- package/dist/src/lib/invoker-shared-enums.js.map +1 -0
- package/dist/src/lib/json-value.d.ts +6 -0
- package/dist/src/lib/json-value.js +13 -0
- package/dist/src/lib/json-value.js.map +1 -0
- package/dist/src/lib/load-routes.d.ts +33 -0
- package/dist/src/lib/load-routes.js +35 -0
- package/dist/src/lib/load-routes.js.map +1 -0
- package/dist/src/lib/log-inspection.d.ts +23 -4
- package/dist/src/lib/log-inspection.js +14 -5
- package/dist/src/lib/log-inspection.js.map +1 -1
- package/dist/src/lib/login-exchange-check.d.ts +18 -0
- package/dist/src/lib/login-exchange-check.js +27 -0
- package/dist/src/lib/login-exchange-check.js.map +1 -0
- package/dist/src/lib/login-scope-lines.d.ts +17 -7
- package/dist/src/lib/login-scope-lines.js +33 -10
- package/dist/src/lib/login-scope-lines.js.map +1 -1
- package/dist/src/lib/metadata-report.d.ts +85 -0
- package/dist/src/lib/metadata-report.js +81 -0
- package/dist/src/lib/metadata-report.js.map +1 -0
- package/dist/src/lib/object-status-filter.d.ts +9 -1
- package/dist/src/lib/object-status-filter.js +9 -1
- package/dist/src/lib/object-status-filter.js.map +1 -1
- package/dist/src/lib/output.d.ts +1 -1
- package/dist/src/lib/output.js +3 -1
- package/dist/src/lib/output.js.map +1 -1
- package/dist/src/lib/pin-refusal-hint.d.ts +12 -0
- package/dist/src/lib/pin-refusal-hint.js +35 -0
- package/dist/src/lib/pin-refusal-hint.js.map +1 -0
- package/dist/src/lib/platform-owned.js +5 -0
- package/dist/src/lib/platform-owned.js.map +1 -1
- package/dist/src/lib/primitive-declaration-names.d.ts +21 -0
- package/dist/src/lib/primitive-declaration-names.js +22 -0
- package/dist/src/lib/primitive-declaration-names.js.map +1 -0
- package/dist/src/lib/primitive-declaration.d.ts +174 -0
- package/dist/src/lib/primitive-declaration.js +871 -0
- package/dist/src/lib/primitive-declaration.js.map +1 -0
- package/dist/src/lib/primitive-env-plugin.d.ts +99 -0
- package/dist/src/lib/primitive-env-plugin.js +408 -0
- package/dist/src/lib/primitive-env-plugin.js.map +1 -0
- package/dist/src/lib/project-login-apps.d.ts +8 -0
- package/dist/src/lib/project-login-apps.js +27 -0
- package/dist/src/lib/project-login-apps.js.map +1 -0
- package/dist/src/lib/prompt-schema-codegen.d.ts +36 -12
- package/dist/src/lib/prompt-schema-codegen.js +96 -100
- package/dist/src/lib/prompt-schema-codegen.js.map +1 -1
- package/dist/src/lib/prompt-schema-document.d.ts +35 -0
- package/dist/src/lib/prompt-schema-document.js +92 -0
- package/dist/src/lib/prompt-schema-document.js.map +1 -0
- package/dist/src/lib/prompt-schema-refs.d.ts +173 -0
- package/dist/src/lib/prompt-schema-refs.js +478 -0
- package/dist/src/lib/prompt-schema-refs.js.map +1 -0
- package/dist/src/lib/records-verbs.d.ts +79 -0
- package/dist/src/lib/records-verbs.js +45 -0
- package/dist/src/lib/records-verbs.js.map +1 -0
- package/dist/src/lib/refresh-admin-credentials.d.ts +34 -4
- package/dist/src/lib/refresh-admin-credentials.js +85 -29
- package/dist/src/lib/refresh-admin-credentials.js.map +1 -1
- package/dist/src/lib/refresh-stored-login.d.ts +85 -0
- package/dist/src/lib/refresh-stored-login.js +233 -0
- package/dist/src/lib/refresh-stored-login.js.map +1 -0
- package/dist/src/lib/register-commands.d.ts +36 -0
- package/dist/src/lib/register-commands.js +37 -0
- package/dist/src/lib/register-commands.js.map +1 -0
- package/dist/src/lib/retired-imports.d.ts +53 -0
- package/dist/src/lib/retired-imports.js +120 -0
- package/dist/src/lib/retired-imports.js.map +1 -0
- package/dist/src/lib/row-field-rename.d.ts +18 -0
- package/dist/src/lib/row-field-rename.js +32 -0
- package/dist/src/lib/row-field-rename.js.map +1 -0
- package/dist/src/lib/run-status.d.ts +1 -1
- package/dist/src/lib/run-status.generated.d.ts +2 -2
- package/dist/src/lib/run-status.generated.js +3 -1
- package/dist/src/lib/run-status.generated.js.map +1 -1
- package/dist/src/lib/run-status.js +1 -1
- package/dist/src/lib/schema-codegen/compiledSpace.d.ts +62 -0
- package/dist/src/lib/schema-codegen/compiledSpace.js +103 -0
- package/dist/src/lib/schema-codegen/compiledSpace.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-db3-bridge.d.ts +86 -0
- package/dist/src/lib/schema-codegen/generated-db3-bridge.js +227 -0
- package/dist/src/lib/schema-codegen/generated-db3-bridge.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.d.ts +85 -0
- package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js +86 -0
- package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-field-grammar.d.ts +229 -0
- package/dist/src/lib/schema-codegen/generated-field-grammar.js +420 -0
- package/dist/src/lib/schema-codegen/generated-field-grammar.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-field-table.d.ts +80 -0
- package/dist/src/lib/schema-codegen/generated-field-table.js +542 -0
- package/dist/src/lib/schema-codegen/generated-field-table.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-prompt-schemas.d.ts +195 -0
- package/dist/src/lib/schema-codegen/generated-prompt-schemas.js +503 -0
- package/dist/src/lib/schema-codegen/generated-prompt-schemas.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-schema-descriptor.d.ts +258 -0
- package/dist/src/lib/schema-codegen/generated-schema-descriptor.js +422 -0
- package/dist/src/lib/schema-codegen/generated-schema-descriptor.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-schema-file.d.ts +129 -0
- package/dist/src/lib/schema-codegen/generated-schema-file.js +475 -0
- package/dist/src/lib/schema-codegen/generated-schema-file.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-schema-provenance.d.ts +115 -0
- package/dist/src/lib/schema-codegen/generated-schema-provenance.js +274 -0
- package/dist/src/lib/schema-codegen/generated-schema-provenance.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-schema-refs.d.ts +366 -0
- package/dist/src/lib/schema-codegen/generated-schema-refs.js +1789 -0
- package/dist/src/lib/schema-codegen/generated-schema-refs.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-schema-shape.d.ts +27 -0
- package/dist/src/lib/schema-codegen/generated-schema-shape.js +126 -0
- package/dist/src/lib/schema-codegen/generated-schema-shape.js.map +1 -0
- package/dist/src/lib/schema-codegen/namedRefs.d.ts +56 -0
- package/dist/src/lib/schema-codegen/namedRefs.js +143 -0
- package/dist/src/lib/schema-codegen/namedRefs.js.map +1 -0
- package/dist/src/lib/schema-codegen/naming.d.ts +35 -0
- package/dist/src/lib/schema-codegen/naming.js +83 -0
- package/dist/src/lib/schema-codegen/naming.js.map +1 -0
- package/dist/src/lib/schema-codegen/schemaChanges.d.ts +74 -0
- package/dist/src/lib/schema-codegen/schemaChanges.js +277 -0
- package/dist/src/lib/schema-codegen/schemaChanges.js.map +1 -0
- package/dist/src/lib/schema-codegen/schemaDocs.d.ts +69 -0
- package/dist/src/lib/schema-codegen/schemaDocs.js +219 -0
- package/dist/src/lib/schema-codegen/schemaDocs.js.map +1 -0
- package/dist/src/lib/schema-codegen/schemaIR.d.ts +158 -0
- package/dist/src/lib/schema-codegen/schemaIR.js +279 -0
- package/dist/src/lib/schema-codegen/schemaIR.js.map +1 -0
- package/dist/src/lib/schema-codegen/schemaToTs.d.ts +109 -0
- package/dist/src/lib/schema-codegen/schemaToTs.js +269 -0
- package/dist/src/lib/schema-codegen/schemaToTs.js.map +1 -0
- package/dist/src/lib/schema-codegen/valuesLists.d.ts +48 -0
- package/dist/src/lib/schema-codegen/valuesLists.js +144 -0
- package/dist/src/lib/schema-codegen/valuesLists.js.map +1 -0
- package/dist/src/lib/schema-defs-module.d.ts +29 -0
- package/dist/src/lib/schema-defs-module.js +103 -0
- package/dist/src/lib/schema-defs-module.js.map +1 -0
- package/dist/src/lib/schema-family-index.d.ts +228 -0
- package/dist/src/lib/schema-family-index.js +813 -0
- package/dist/src/lib/schema-family-index.js.map +1 -0
- package/dist/src/lib/schema-pins.d.ts +82 -0
- package/dist/src/lib/schema-pins.js +198 -0
- package/dist/src/lib/schema-pins.js.map +1 -0
- package/dist/src/lib/schema-preview.d.ts +244 -0
- package/dist/src/lib/schema-preview.js +498 -0
- package/dist/src/lib/schema-preview.js.map +1 -0
- package/dist/src/lib/scope-request.d.ts +23 -11
- package/dist/src/lib/scope-request.js +69 -31
- package/dist/src/lib/scope-request.js.map +1 -1
- package/dist/src/lib/session-scope.d.ts +26 -0
- package/dist/src/lib/session-scope.js +58 -0
- package/dist/src/lib/session-scope.js.map +1 -0
- package/dist/src/lib/skill-installer.d.ts +2 -2
- package/dist/src/lib/skill-installer.js +2 -21
- package/dist/src/lib/skill-installer.js.map +1 -1
- package/dist/src/lib/step-run-table.d.ts +1 -2
- package/dist/src/lib/step-run-table.js +1 -2
- package/dist/src/lib/step-run-table.js.map +1 -1
- package/dist/src/lib/swift-codegen/agentGenerator.d.ts +2 -1
- package/dist/src/lib/swift-codegen/agentGenerator.js +25 -23
- package/dist/src/lib/swift-codegen/agentGenerator.js.map +1 -1
- package/dist/src/lib/swift-codegen/banners.d.ts +12 -0
- package/dist/src/lib/swift-codegen/banners.js +12 -0
- package/dist/src/lib/swift-codegen/banners.js.map +1 -1
- package/dist/src/lib/swift-codegen/functionGenerator.d.ts +36 -1
- package/dist/src/lib/swift-codegen/functionGenerator.js +169 -51
- package/dist/src/lib/swift-codegen/functionGenerator.js.map +1 -1
- package/dist/src/lib/swift-codegen/schemaToSwift.d.ts +33 -9
- package/dist/src/lib/swift-codegen/schemaToSwift.js +215 -179
- package/dist/src/lib/swift-codegen/schemaToSwift.js.map +1 -1
- package/dist/src/lib/swift-codegen/sharedGenerator.d.ts +51 -0
- package/dist/src/lib/swift-codegen/sharedGenerator.js +239 -0
- package/dist/src/lib/swift-codegen/sharedGenerator.js.map +1 -0
- package/dist/src/lib/swift-codegen/swiftKeys.d.ts +19 -0
- package/dist/src/lib/swift-codegen/swiftKeys.js +31 -0
- package/dist/src/lib/swift-codegen/swiftKeys.js.map +1 -0
- package/dist/src/lib/swift-codegen/userPropertiesGenerator.d.ts +30 -0
- package/dist/src/lib/swift-codegen/userPropertiesGenerator.js +69 -0
- package/dist/src/lib/swift-codegen/userPropertiesGenerator.js.map +1 -0
- package/dist/src/lib/sync-resource-types.d.ts +117 -31
- package/dist/src/lib/sync-resource-types.js +197 -189
- package/dist/src/lib/sync-resource-types.js.map +1 -1
- package/dist/src/lib/sync-selectors.d.ts +7 -0
- package/dist/src/lib/sync-selectors.js +22 -2
- package/dist/src/lib/sync-selectors.js.map +1 -1
- package/dist/src/lib/template.d.ts +39 -3
- package/dist/src/lib/template.js +103 -14
- package/dist/src/lib/template.js.map +1 -1
- package/dist/src/lib/test-case-file-names.d.ts +3 -5
- package/dist/src/lib/test-case-file-names.js +3 -5
- package/dist/src/lib/test-case-file-names.js.map +1 -1
- package/dist/src/lib/test-runs.d.ts +45 -0
- package/dist/src/lib/test-runs.js +150 -0
- package/dist/src/lib/test-runs.js.map +1 -0
- package/dist/src/lib/test-users.d.ts +25 -0
- package/dist/src/lib/test-users.js +36 -0
- package/dist/src/lib/test-users.js.map +1 -0
- package/dist/src/lib/toml-database-config.d.ts +4 -2
- package/dist/src/lib/toml-database-config.js +11 -6
- package/dist/src/lib/toml-database-config.js.map +1 -1
- package/dist/src/lib/toml-list-edit.d.ts +33 -0
- package/dist/src/lib/toml-list-edit.js +481 -0
- package/dist/src/lib/toml-list-edit.js.map +1 -0
- package/dist/src/lib/toml-scalar-edit.d.ts +9 -0
- package/dist/src/lib/toml-scalar-edit.js +73 -5
- package/dist/src/lib/toml-scalar-edit.js.map +1 -1
- package/dist/src/lib/transition-warnings.d.ts +21 -0
- package/dist/src/lib/transition-warnings.js +49 -0
- package/dist/src/lib/transition-warnings.js.map +1 -0
- package/dist/src/lib/usage-meters.d.ts +16 -0
- package/dist/src/lib/usage-meters.js +52 -0
- package/dist/src/lib/usage-meters.js.map +1 -0
- package/dist/src/lib/user-index.d.ts +80 -0
- package/dist/src/lib/user-index.js +166 -0
- package/dist/src/lib/user-index.js.map +1 -0
- package/dist/src/lib/user-properties/generated-properties-schema.d.ts +159 -0
- package/dist/src/lib/user-properties/generated-properties-schema.js +471 -0
- package/dist/src/lib/user-properties/generated-properties-schema.js.map +1 -0
- package/dist/src/lib/user-properties/user-properties-codegen.d.ts +55 -0
- package/dist/src/lib/user-properties/user-properties-codegen.js +129 -0
- package/dist/src/lib/user-properties/user-properties-codegen.js.map +1 -0
- package/dist/src/lib/user-walk.d.ts +31 -0
- package/dist/src/lib/user-walk.js +102 -0
- package/dist/src/lib/user-walk.js.map +1 -0
- package/dist/src/lib/webhook-capture.d.ts +43 -0
- package/dist/src/lib/webhook-capture.js +91 -0
- package/dist/src/lib/webhook-capture.js.map +1 -0
- package/dist/src/lib/webhook-deliver.d.ts +18 -20
- package/dist/src/lib/webhook-deliver.js +34 -89
- package/dist/src/lib/webhook-deliver.js.map +1 -1
- package/dist/src/lib/webhook-test-run.d.ts +32 -0
- package/dist/src/lib/webhook-test-run.js +108 -0
- package/dist/src/lib/webhook-test-run.js.map +1 -0
- package/dist/src/lib/worker-perf-format.d.ts +22 -0
- package/dist/src/lib/worker-perf-format.js +27 -0
- package/dist/src/lib/worker-perf-format.js.map +1 -0
- package/dist/src/types/index.d.ts +20 -65
- package/dist/src/validators.d.ts +7 -55
- package/dist/src/validators.js +7 -53
- package/dist/src/validators.js.map +1 -1
- package/dist/src/vite.d.ts +17 -0
- package/dist/src/vite.js +18 -0
- package/dist/src/vite.js.map +1 -0
- package/package.json +20 -9
|
@@ -1,10 +1,18 @@
|
|
|
1
|
+
import { Option } from "commander";
|
|
1
2
|
import { ApiClient } from "../lib/api-client.js";
|
|
3
|
+
import { commandStatus } from "../lib/command-status.js";
|
|
2
4
|
import { resolveAppId } from "../lib/config.js";
|
|
3
5
|
import { error, info, formatTable, formatId, formatDate, formatNumber, formatPercent, formatDuration, json, heading, result as printResult, dim, } from "../lib/output.js";
|
|
4
6
|
import { buildActivityEnvelope } from "../lib/log-inspection.js";
|
|
7
|
+
// #5105 — `--test-users`, one flag and one value list with `users list`.
|
|
8
|
+
import { analyticsTestUsersOption, printTestUsersLine, testUsersParam, } from "../lib/test-users.js";
|
|
9
|
+
// #5251 — `--where`, one filter grammar for every filtered analytics read, and
|
|
10
|
+
// `--fresh` on every reader, and the anonymous user's segment.
|
|
11
|
+
import { ANONYMOUS_USER_SEGMENT, ERROR_FILTER_FIELDS, EVENT_FILTER_FIELDS, analyticsFreshOption, filtersArg, freshParam, whereFilters, whereOption, } from "../lib/analytics-query.js";
|
|
12
|
+
// #5244 — the db3 query and request readers' cells.
|
|
13
|
+
import { DB3_QUERIES_ORDER_BY, db3QueryCaller, formatFigure, requestFunction, } from "../lib/worker-perf-format.js";
|
|
5
14
|
// #3787 — per-prompt cost cells, with the cost-unknown and partial-window rules.
|
|
6
15
|
import { formatAvgCostCell, formatCostCell, } from "../lib/prompt-cost-format.js";
|
|
7
|
-
import { ALL_APPS_CONFLICT_ERROR, ALL_APPS_SUPER_ADMIN_ERROR, isAbortStatus, isSuperAdminRole, mergeUsageReports, parseWindowDaysFlag, renderMergedUsageReport, renderUsageReport, usageExitCode, USAGE_CLI_DEFAULT_WINDOW_DAYS, USAGE_CLI_MAX_WINDOW_DAYS, USAGE_CLI_MIN_WINDOW_DAYS, } from "../lib/workflow-usage.js";
|
|
8
16
|
/** Format a value that is already a percentage (e.g. 33.3 → "33.3%") */
|
|
9
17
|
function formatPctRaw(value) {
|
|
10
18
|
if (value === undefined || value === null)
|
|
@@ -22,18 +30,24 @@ export function registerAnalyticsCommands(program) {
|
|
|
22
30
|
.addHelpText("after", `
|
|
23
31
|
Examples:
|
|
24
32
|
$ primitive analytics overview
|
|
33
|
+
$ primitive analytics overview --test-users include
|
|
34
|
+
$ primitive analytics overview --fresh
|
|
25
35
|
$ primitive analytics daily-active --window-days 14
|
|
26
36
|
$ primitive analytics top-users --limit 20
|
|
27
37
|
$ primitive analytics user-search --query user@example.com
|
|
28
38
|
$ primitive analytics user-detail <user-ulid>
|
|
39
|
+
$ primitive analytics user-detail --anonymous
|
|
29
40
|
$ primitive analytics events --window-days 7 --page 0
|
|
41
|
+
$ primitive analytics events --where action=login --where country!=US
|
|
30
42
|
$ primitive analytics events-grouped --group-by feature
|
|
31
43
|
$ primitive analytics errors-groups --window-days 14 --limit 100
|
|
44
|
+
$ primitive analytics errors-groups --where source!=integration
|
|
45
|
+
$ primitive analytics db3-queries --order-by rows-per-returned
|
|
46
|
+
$ primitive analytics requests --window-days 30
|
|
32
47
|
$ primitive analytics cohort-retention
|
|
33
|
-
$ primitive analytics workflows --limit 5
|
|
34
48
|
$ primitive analytics prompts --window-days 14
|
|
35
|
-
$ primitive analytics workflow-usage --window-days 30 --all-apps --json
|
|
36
49
|
`);
|
|
50
|
+
commandStatus(analytics, { stability: "production" });
|
|
37
51
|
// ── Overview (DAU / WAU / MAU / Growth) ──────────────────────────
|
|
38
52
|
analytics
|
|
39
53
|
.command("overview")
|
|
@@ -41,17 +55,24 @@ Examples:
|
|
|
41
55
|
.argument("[app-id]", "App ID (uses current app if not specified)")
|
|
42
56
|
.option("--app <app-id>", "App ID")
|
|
43
57
|
.option("--window-days <n>", "Growth window in days", "28")
|
|
58
|
+
.addOption(analyticsTestUsersOption("exclude"))
|
|
59
|
+
.addOption(analyticsFreshOption())
|
|
44
60
|
.option("--json", "Output as JSON")
|
|
45
61
|
.action(async (appId, options) => {
|
|
46
62
|
const resolvedAppId = resolveAppId(appId, options);
|
|
47
63
|
const client = new ApiClient();
|
|
48
64
|
try {
|
|
65
|
+
const testUsers = {
|
|
66
|
+
...testUsersParam(options.testUsers),
|
|
67
|
+
...freshParam(options.fresh),
|
|
68
|
+
};
|
|
49
69
|
const [dau, wau, mau, growth] = await Promise.all([
|
|
50
|
-
client.getAnalyticsOverviewDau(resolvedAppId),
|
|
51
|
-
client.getAnalyticsOverviewWau(resolvedAppId),
|
|
52
|
-
client.getAnalyticsOverviewMau(resolvedAppId),
|
|
70
|
+
client.getAnalyticsOverviewDau(resolvedAppId, testUsers),
|
|
71
|
+
client.getAnalyticsOverviewWau(resolvedAppId, testUsers),
|
|
72
|
+
client.getAnalyticsOverviewMau(resolvedAppId, testUsers),
|
|
53
73
|
client.getAnalyticsOverviewGrowth(resolvedAppId, {
|
|
54
74
|
windowDays: parseInt(options.windowDays),
|
|
75
|
+
...testUsers,
|
|
55
76
|
}),
|
|
56
77
|
]);
|
|
57
78
|
if (options.json) {
|
|
@@ -59,6 +80,7 @@ Examples:
|
|
|
59
80
|
return;
|
|
60
81
|
}
|
|
61
82
|
heading("Active Users");
|
|
83
|
+
printTestUsersLine(dau.testUsers);
|
|
62
84
|
console.log();
|
|
63
85
|
const formatDelta = (d) => d > 0 ? `+${(d * 100).toFixed(1)}%` : d === 0 ? "0%" : `${(d * 100).toFixed(1)}%`;
|
|
64
86
|
console.log(formatTable([
|
|
@@ -94,6 +116,8 @@ Examples:
|
|
|
94
116
|
.argument("[app-id]", "App ID (uses current app if not specified)")
|
|
95
117
|
.option("--app <app-id>", "App ID")
|
|
96
118
|
.option("--window-days <n>", "Time window in days (7-90)", "28")
|
|
119
|
+
.addOption(analyticsTestUsersOption("exclude"))
|
|
120
|
+
.addOption(analyticsFreshOption())
|
|
97
121
|
.option("--json", "Output as JSON")
|
|
98
122
|
.action(async (appId, options) => {
|
|
99
123
|
const resolvedAppId = resolveAppId(appId, options);
|
|
@@ -101,12 +125,15 @@ Examples:
|
|
|
101
125
|
try {
|
|
102
126
|
const result = await client.getAnalyticsDailyActive(resolvedAppId, {
|
|
103
127
|
windowDays: parseInt(options.windowDays),
|
|
128
|
+
...testUsersParam(options.testUsers),
|
|
129
|
+
...freshParam(options.fresh),
|
|
104
130
|
});
|
|
105
131
|
if (options.json) {
|
|
106
132
|
json(result);
|
|
107
133
|
return;
|
|
108
134
|
}
|
|
109
135
|
heading(`Daily Active Users (${result.window_days} days)`);
|
|
136
|
+
printTestUsersLine(result.testUsers);
|
|
110
137
|
console.log();
|
|
111
138
|
if (!result.rows || result.rows.length === 0) {
|
|
112
139
|
info("No data found.");
|
|
@@ -129,6 +156,8 @@ Examples:
|
|
|
129
156
|
.argument("[app-id]", "App ID (uses current app if not specified)")
|
|
130
157
|
.option("--app <app-id>", "App ID")
|
|
131
158
|
.option("--window-days <n>", "Rolling window size in days (1-28)", "7")
|
|
159
|
+
.addOption(analyticsTestUsersOption("exclude"))
|
|
160
|
+
.addOption(analyticsFreshOption())
|
|
132
161
|
.option("--json", "Output as JSON")
|
|
133
162
|
.action(async (appId, options) => {
|
|
134
163
|
const resolvedAppId = resolveAppId(appId, options);
|
|
@@ -136,12 +165,15 @@ Examples:
|
|
|
136
165
|
try {
|
|
137
166
|
const result = await client.getAnalyticsRollingActive(resolvedAppId, {
|
|
138
167
|
windowDays: parseInt(options.windowDays),
|
|
168
|
+
...testUsersParam(options.testUsers),
|
|
169
|
+
...freshParam(options.fresh),
|
|
139
170
|
});
|
|
140
171
|
if (options.json) {
|
|
141
172
|
json(result);
|
|
142
173
|
return;
|
|
143
174
|
}
|
|
144
175
|
heading(`Rolling Active Users (${result.window_days}-day window)`);
|
|
176
|
+
printTestUsersLine(result.testUsers);
|
|
145
177
|
console.log();
|
|
146
178
|
if (!result.rows || result.rows.length === 0) {
|
|
147
179
|
info("No data found.");
|
|
@@ -163,17 +195,23 @@ Examples:
|
|
|
163
195
|
.description("Weekly cohort retention matrix")
|
|
164
196
|
.argument("[app-id]", "App ID (uses current app if not specified)")
|
|
165
197
|
.option("--app <app-id>", "App ID")
|
|
198
|
+
.addOption(analyticsTestUsersOption("exclude"))
|
|
199
|
+
.addOption(analyticsFreshOption())
|
|
166
200
|
.option("--json", "Output as JSON")
|
|
167
201
|
.action(async (appId, options) => {
|
|
168
202
|
const resolvedAppId = resolveAppId(appId, options);
|
|
169
203
|
const client = new ApiClient();
|
|
170
204
|
try {
|
|
171
|
-
const result = await client.getAnalyticsCohortRetention(resolvedAppId
|
|
205
|
+
const result = await client.getAnalyticsCohortRetention(resolvedAppId, {
|
|
206
|
+
...testUsersParam(options.testUsers),
|
|
207
|
+
...freshParam(options.fresh),
|
|
208
|
+
});
|
|
172
209
|
if (options.json) {
|
|
173
210
|
json(result);
|
|
174
211
|
return;
|
|
175
212
|
}
|
|
176
213
|
heading("Cohort Retention");
|
|
214
|
+
printTestUsersLine(result.testUsers);
|
|
177
215
|
console.log();
|
|
178
216
|
if (!result.rows || result.rows.length === 0) {
|
|
179
217
|
info("No cohort data found.");
|
|
@@ -225,6 +263,8 @@ Examples:
|
|
|
225
263
|
.option("--app <app-id>", "App ID")
|
|
226
264
|
.option("--window-days <n>", "Time window in days", "30")
|
|
227
265
|
.option("--limit <n>", "Number of users to show", "10")
|
|
266
|
+
.addOption(analyticsTestUsersOption("exclude"))
|
|
267
|
+
.addOption(analyticsFreshOption())
|
|
228
268
|
.option("--json", "Output as JSON")
|
|
229
269
|
.action(async (appId, options) => {
|
|
230
270
|
const resolvedAppId = resolveAppId(appId, options);
|
|
@@ -233,12 +273,15 @@ Examples:
|
|
|
233
273
|
const result = await client.getAnalyticsTopUsers(resolvedAppId, {
|
|
234
274
|
windowDays: parseInt(options.windowDays),
|
|
235
275
|
limit: parseInt(options.limit),
|
|
276
|
+
...testUsersParam(options.testUsers),
|
|
277
|
+
...freshParam(options.fresh),
|
|
236
278
|
});
|
|
237
279
|
if (options.json) {
|
|
238
280
|
json(result);
|
|
239
281
|
return;
|
|
240
282
|
}
|
|
241
283
|
heading(`Top Users (${result.windowDays} days)`);
|
|
284
|
+
printTestUsersLine(result.testUsers);
|
|
242
285
|
console.log();
|
|
243
286
|
if (!result.results || result.results.length === 0) {
|
|
244
287
|
info("No user activity found.");
|
|
@@ -271,14 +314,18 @@ Examples:
|
|
|
271
314
|
.option("--signup-end-day <day>", "End of an inclusive signup range (YYYY-MM-DD)")
|
|
272
315
|
.option("--offset <n>", "Row offset; page a busy day until the result is not truncated")
|
|
273
316
|
.option("--limit <n>", "Max results", "25")
|
|
317
|
+
.addOption(analyticsTestUsersOption("exclude for a listing or a signup filter, include for --query"))
|
|
318
|
+
.addOption(analyticsFreshOption())
|
|
274
319
|
.option("--json", "Output as JSON")
|
|
275
320
|
.action(async (appId, options) => {
|
|
276
321
|
const resolvedAppId = resolveAppId(appId, options);
|
|
277
322
|
const client = new ApiClient();
|
|
278
323
|
const hasSignupFilter = Boolean(options.signupDay || options.signupStartDay || options.signupEndDay);
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
324
|
+
// #5105 — `--test-users` alone lists the most recently active users,
|
|
325
|
+
// filtered: asked for explicitly, it says which users to list.
|
|
326
|
+
if (!options.query && !hasSignupFilter && !options.testUsers) {
|
|
327
|
+
error("Give --query, a signup filter (--signup-day, or " +
|
|
328
|
+
"--signup-start-day with --signup-end-day), or --test-users.");
|
|
282
329
|
process.exit(1);
|
|
283
330
|
return;
|
|
284
331
|
}
|
|
@@ -295,6 +342,8 @@ Examples:
|
|
|
295
342
|
...(options.offset !== undefined
|
|
296
343
|
? { offset: parseInt(options.offset) }
|
|
297
344
|
: {}),
|
|
345
|
+
...testUsersParam(options.testUsers),
|
|
346
|
+
...freshParam(options.fresh),
|
|
298
347
|
});
|
|
299
348
|
if (options.json) {
|
|
300
349
|
json(result);
|
|
@@ -302,7 +351,10 @@ Examples:
|
|
|
302
351
|
}
|
|
303
352
|
heading(hasSignupFilter
|
|
304
353
|
? `Signups: ${result.signupStartDay ?? ""} to ${result.signupEndDay ?? ""}`
|
|
305
|
-
:
|
|
354
|
+
: options.query
|
|
355
|
+
? `User Search: "${result.query}"`
|
|
356
|
+
: "Recently Active Users");
|
|
357
|
+
printTestUsersLine(result.testUsers);
|
|
306
358
|
console.log();
|
|
307
359
|
if (!result.results || result.results.length === 0) {
|
|
308
360
|
info("No users found.");
|
|
@@ -342,22 +394,45 @@ Examples:
|
|
|
342
394
|
analytics
|
|
343
395
|
.command("user-detail")
|
|
344
396
|
.description("Detailed activity for a single user")
|
|
345
|
-
.argument("
|
|
397
|
+
.argument("[user-ulid]", "User ULID (omit with --anonymous)")
|
|
346
398
|
.argument("[app-id]", "App ID (uses current app if not specified)")
|
|
347
399
|
.option("--app <app-id>", "App ID")
|
|
400
|
+
.option("--anonymous", "Activity with no signed-in user; the one optional argument is then the app ID")
|
|
401
|
+
.addOption(analyticsFreshOption())
|
|
348
402
|
.option("--json", "Output as JSON")
|
|
349
403
|
.action(async (userUlid, appId, options) => {
|
|
404
|
+
// #5251 — with --anonymous there is no user to name, so the one
|
|
405
|
+
// positional is the app, as on every other reader.
|
|
406
|
+
if (options.anonymous) {
|
|
407
|
+
if (appId !== undefined) {
|
|
408
|
+
error("--anonymous takes at most one argument, the app ID.");
|
|
409
|
+
process.exit(1);
|
|
410
|
+
return;
|
|
411
|
+
}
|
|
412
|
+
appId = userUlid;
|
|
413
|
+
userUlid = ANONYMOUS_USER_SEGMENT;
|
|
414
|
+
}
|
|
415
|
+
else if (!userUlid) {
|
|
416
|
+
error("Give a user ULID, or --anonymous for anonymous activity.");
|
|
417
|
+
process.exit(1);
|
|
418
|
+
return;
|
|
419
|
+
}
|
|
350
420
|
const resolvedAppId = resolveAppId(appId, options);
|
|
351
421
|
const client = new ApiClient();
|
|
352
422
|
try {
|
|
353
|
-
const result = await client.getAnalyticsUserDetail(resolvedAppId, userUlid);
|
|
423
|
+
const result = await client.getAnalyticsUserDetail(resolvedAppId, userUlid, freshParam(options.fresh));
|
|
354
424
|
if (options.json) {
|
|
355
425
|
json(result);
|
|
356
426
|
return;
|
|
357
427
|
}
|
|
358
428
|
heading("User Detail");
|
|
359
429
|
console.log();
|
|
360
|
-
|
|
430
|
+
if (options.anonymous) {
|
|
431
|
+
printResult("User", "anonymous");
|
|
432
|
+
}
|
|
433
|
+
else {
|
|
434
|
+
printResult("ULID", result.user.user_ulid);
|
|
435
|
+
}
|
|
361
436
|
if (result.user.email)
|
|
362
437
|
printResult("Email", result.user.email);
|
|
363
438
|
if (result.user.name)
|
|
@@ -400,12 +475,13 @@ Examples:
|
|
|
400
475
|
.argument("<user-ulid>", "User ULID")
|
|
401
476
|
.argument("[app-id]", "App ID (uses current app if not specified)")
|
|
402
477
|
.option("--app <app-id>", "App ID")
|
|
478
|
+
.addOption(analyticsFreshOption())
|
|
403
479
|
.option("--json", "Output as JSON")
|
|
404
480
|
.action(async (userUlid, appId, options) => {
|
|
405
481
|
const resolvedAppId = resolveAppId(appId, options);
|
|
406
482
|
const client = new ApiClient();
|
|
407
483
|
try {
|
|
408
|
-
const result = await client.getAnalyticsUserSnapshot(resolvedAppId, userUlid);
|
|
484
|
+
const result = await client.getAnalyticsUserSnapshot(resolvedAppId, userUlid, freshParam(options.fresh));
|
|
409
485
|
if (options.json) {
|
|
410
486
|
json(result);
|
|
411
487
|
return;
|
|
@@ -434,19 +510,25 @@ Examples:
|
|
|
434
510
|
.option("--window-days <n>", "Time window in days", "7")
|
|
435
511
|
.option("--page <n>", "Page number (0-based)", "0")
|
|
436
512
|
.option("--user-id <id>", "Filter to a single user's events")
|
|
513
|
+
.addOption(whereOption(EVENT_FILTER_FIELDS))
|
|
514
|
+
.addOption(analyticsTestUsersOption("include"))
|
|
515
|
+
.addOption(analyticsFreshOption())
|
|
437
516
|
.option("--json", "Output as JSON")
|
|
438
517
|
.action(async (appId, options) => {
|
|
439
518
|
const resolvedAppId = resolveAppId(appId, options);
|
|
440
519
|
const client = new ApiClient();
|
|
441
520
|
try {
|
|
521
|
+
const filters = whereFilters(options.where, EVENT_FILTER_FIELDS);
|
|
442
522
|
const result = await client.getAnalyticsEvents(resolvedAppId, {
|
|
443
523
|
windowDays: parseInt(options.windowDays),
|
|
444
524
|
page: parseInt(options.page),
|
|
445
525
|
// The events feed filters by user via the bracketed
|
|
446
|
-
// `filter[user][is]` syntax the analytics route already parses —
|
|
447
|
-
// a raw query param (behavior 11).
|
|
526
|
+
// `filter[user][is]` syntax the analytics route already parses —
|
|
527
|
+
// not a raw query param (behavior 11).
|
|
448
528
|
...(options.userId ? { "filter[user][is]": options.userId } : {}),
|
|
449
|
-
|
|
529
|
+
...testUsersParam(options.testUsers),
|
|
530
|
+
...freshParam(options.fresh),
|
|
531
|
+
}, ...filtersArg(filters));
|
|
450
532
|
if (options.json) {
|
|
451
533
|
// Normalize the offset-paged response to the shared activity
|
|
452
534
|
// envelope: `{page_size, rows}` → `{pageSize, items}` with the
|
|
@@ -456,6 +538,7 @@ Examples:
|
|
|
456
538
|
return;
|
|
457
539
|
}
|
|
458
540
|
heading(`Events (page ${result.page}, ${result.total_rows} total)`);
|
|
541
|
+
printTestUsersLine(result.testUsers);
|
|
459
542
|
console.log();
|
|
460
543
|
if (!result.rows || result.rows.length === 0) {
|
|
461
544
|
info("No events found.");
|
|
@@ -496,20 +579,27 @@ Examples:
|
|
|
496
579
|
.option("--app <app-id>", "App ID")
|
|
497
580
|
.option("--group-by <dim>", "Dimension: action, feature, route, country, deviceType, plan, day", "action")
|
|
498
581
|
.option("--window-days <n>", "Time window in days", "7")
|
|
582
|
+
.addOption(whereOption(EVENT_FILTER_FIELDS))
|
|
583
|
+
.addOption(analyticsTestUsersOption("include"))
|
|
584
|
+
.addOption(analyticsFreshOption())
|
|
499
585
|
.option("--json", "Output as JSON")
|
|
500
586
|
.action(async (appId, options) => {
|
|
501
587
|
const resolvedAppId = resolveAppId(appId, options);
|
|
502
588
|
const client = new ApiClient();
|
|
503
589
|
try {
|
|
590
|
+
const filters = whereFilters(options.where, EVENT_FILTER_FIELDS);
|
|
504
591
|
const result = await client.getAnalyticsEventsGrouped(resolvedAppId, {
|
|
505
592
|
groupBy: options.groupBy,
|
|
506
593
|
windowDays: parseInt(options.windowDays),
|
|
507
|
-
|
|
594
|
+
...testUsersParam(options.testUsers),
|
|
595
|
+
...freshParam(options.fresh),
|
|
596
|
+
}, ...filtersArg(filters));
|
|
508
597
|
if (options.json) {
|
|
509
598
|
json(result);
|
|
510
599
|
return;
|
|
511
600
|
}
|
|
512
601
|
heading(`Events by ${result.group_by}`);
|
|
602
|
+
printTestUsersLine(result.testUsers);
|
|
513
603
|
console.log();
|
|
514
604
|
if (!result.rows || result.rows.length === 0) {
|
|
515
605
|
info("No events found.");
|
|
@@ -536,16 +626,21 @@ Examples:
|
|
|
536
626
|
.option("--limit <n>", "Max error groups to return", "50")
|
|
537
627
|
.option("--status-class <class>", "Filter by status class: 4xx, 5xx, transport")
|
|
538
628
|
.option("--source <source>", "Filter by source: workflow_run, workflow_step, integration, " +
|
|
539
|
-
"function_invocation, function_run")
|
|
629
|
+
"function_invocation, function_run, analytics_relay")
|
|
630
|
+
// Its own registration: the #3660 test reads `--source`'s help up to `)`.
|
|
631
|
+
.addOption(whereOption(ERROR_FILTER_FIELDS))
|
|
540
632
|
.option("--verbose", "Also print each group's exemplar (a raw sample of the failure) and where it came from")
|
|
633
|
+
.addOption(analyticsFreshOption())
|
|
541
634
|
.option("--json", "Output as JSON")
|
|
542
635
|
.action(async (appId, options) => {
|
|
543
636
|
const resolvedAppId = resolveAppId(appId, options);
|
|
544
637
|
const client = new ApiClient();
|
|
545
638
|
try {
|
|
639
|
+
const filters = whereFilters(options.where, ERROR_FILTER_FIELDS);
|
|
546
640
|
const params = {
|
|
547
641
|
windowDays: parseInt(options.windowDays),
|
|
548
642
|
limit: parseInt(options.limit),
|
|
643
|
+
...freshParam(options.fresh),
|
|
549
644
|
};
|
|
550
645
|
if (options.statusClass) {
|
|
551
646
|
params["filter[statusClass][is]"] = options.statusClass;
|
|
@@ -553,7 +648,7 @@ Examples:
|
|
|
553
648
|
if (options.source) {
|
|
554
649
|
params["filter[source][is]"] = options.source;
|
|
555
650
|
}
|
|
556
|
-
const result = await client.getAnalyticsErrorsGroups(resolvedAppId, params);
|
|
651
|
+
const result = await client.getAnalyticsErrorsGroups(resolvedAppId, params, ...filtersArg(filters));
|
|
557
652
|
if (options.json) {
|
|
558
653
|
json(result);
|
|
559
654
|
return;
|
|
@@ -607,37 +702,51 @@ Examples:
|
|
|
607
702
|
process.exit(1);
|
|
608
703
|
}
|
|
609
704
|
});
|
|
610
|
-
// ──
|
|
705
|
+
// ── Database Queries (#5244) ─────────────────────────────────────
|
|
611
706
|
analytics
|
|
612
|
-
.command("
|
|
613
|
-
.description("
|
|
707
|
+
.command("db3-queries")
|
|
708
|
+
.description("List the db3 query shapes that read the most rows, per endpoint and server function")
|
|
614
709
|
.argument("[app-id]", "App ID (uses current app if not specified)")
|
|
615
710
|
.option("--app <app-id>", "App ID")
|
|
616
|
-
.option("--window-days <n>", "Time window in days", "
|
|
711
|
+
.option("--window-days <n>", "Time window in days (1-90)", "7")
|
|
712
|
+
.option("--limit <n>", "Max rows to return (1-200)", "50")
|
|
713
|
+
.addOption(new Option("--order-by <order>", "Rank by rows read in total, or per row returned")
|
|
714
|
+
.choices(Object.keys(DB3_QUERIES_ORDER_BY))
|
|
715
|
+
.default("rows-read"))
|
|
716
|
+
.addOption(analyticsFreshOption())
|
|
617
717
|
.option("--json", "Output as JSON")
|
|
618
718
|
.action(async (appId, options) => {
|
|
619
719
|
const resolvedAppId = resolveAppId(appId, options);
|
|
620
720
|
const client = new ApiClient();
|
|
621
721
|
try {
|
|
622
|
-
const result = await client.
|
|
722
|
+
const result = await client.getAnalyticsDb3Queries(resolvedAppId, {
|
|
623
723
|
windowDays: parseInt(options.windowDays),
|
|
724
|
+
limit: parseInt(options.limit),
|
|
725
|
+
orderBy: DB3_QUERIES_ORDER_BY[options.orderBy],
|
|
726
|
+
...freshParam(options.fresh),
|
|
624
727
|
});
|
|
625
728
|
if (options.json) {
|
|
626
729
|
json(result);
|
|
627
730
|
return;
|
|
628
731
|
}
|
|
629
|
-
heading(`
|
|
732
|
+
heading(`Database queries (last ${result.window_days} days, by ${options.orderBy})`);
|
|
630
733
|
console.log();
|
|
631
|
-
if (!result.
|
|
632
|
-
info("No
|
|
734
|
+
if (!result.rows || result.rows.length === 0) {
|
|
735
|
+
info("No db3 server reads recorded in this window.");
|
|
633
736
|
return;
|
|
634
737
|
}
|
|
635
|
-
console.log(formatTable(result.
|
|
636
|
-
{ header: "
|
|
637
|
-
{ header: "
|
|
638
|
-
{ header: "
|
|
639
|
-
{ header: "
|
|
640
|
-
{ header: "
|
|
738
|
+
console.log(formatTable(result.rows.map((row) => ({ ...row, caller: db3QueryCaller(row) })), [
|
|
739
|
+
{ header: "TYPE", key: "type" },
|
|
740
|
+
{ header: "MODEL", key: "model" },
|
|
741
|
+
{ header: "OP", key: "op" },
|
|
742
|
+
{ header: "FILTER", key: "filter" },
|
|
743
|
+
{ header: "SORT", key: "sort" },
|
|
744
|
+
{ header: "CALLER", key: "caller" },
|
|
745
|
+
{ header: "CALLS", key: "calls", align: "right", format: formatFigure },
|
|
746
|
+
{ header: "ROWS READ", key: "rows_read", align: "right", format: formatFigure },
|
|
747
|
+
{ header: "PER CALL", key: "rows_read_per_call", align: "right", format: formatFigure },
|
|
748
|
+
{ header: "PER RETURNED", key: "rows_read_per_returned", align: "right", format: formatFigure },
|
|
749
|
+
{ header: "SCANNED", key: "scanned_calls", align: "right", format: formatFigure },
|
|
641
750
|
]));
|
|
642
751
|
}
|
|
643
752
|
catch (err) {
|
|
@@ -645,40 +754,85 @@ Examples:
|
|
|
645
754
|
process.exit(1);
|
|
646
755
|
}
|
|
647
756
|
});
|
|
648
|
-
// ── Top Workflows ────────────────────────────────────────────────
|
|
649
757
|
analytics
|
|
650
|
-
.command("
|
|
651
|
-
.description("
|
|
758
|
+
.command("requests")
|
|
759
|
+
.description("List request wall time and DynamoDB round trips per endpoint and server function")
|
|
652
760
|
.argument("[app-id]", "App ID (uses current app if not specified)")
|
|
653
761
|
.option("--app <app-id>", "App ID")
|
|
654
|
-
.option("--window-days <n>", "Time window in days", "
|
|
655
|
-
.option("--limit <n>", "
|
|
762
|
+
.option("--window-days <n>", "Time window in days (1-90)", "7")
|
|
763
|
+
.option("--limit <n>", "Max rows to return (1-200)", "50")
|
|
764
|
+
.addOption(analyticsFreshOption())
|
|
656
765
|
.option("--json", "Output as JSON")
|
|
657
766
|
.action(async (appId, options) => {
|
|
658
767
|
const resolvedAppId = resolveAppId(appId, options);
|
|
659
768
|
const client = new ApiClient();
|
|
660
769
|
try {
|
|
661
|
-
const result = await client.
|
|
770
|
+
const result = await client.getAnalyticsRequests(resolvedAppId, {
|
|
662
771
|
windowDays: parseInt(options.windowDays),
|
|
663
772
|
limit: parseInt(options.limit),
|
|
773
|
+
...freshParam(options.fresh),
|
|
664
774
|
});
|
|
665
775
|
if (options.json) {
|
|
666
776
|
json(result);
|
|
667
777
|
return;
|
|
668
778
|
}
|
|
669
|
-
heading(`
|
|
779
|
+
heading(`Requests (last ${result.window_days} days)`);
|
|
670
780
|
console.log();
|
|
671
|
-
if (!result.
|
|
672
|
-
info("No
|
|
781
|
+
if (!result.rows || result.rows.length === 0) {
|
|
782
|
+
info("No requests recorded in this window.");
|
|
673
783
|
return;
|
|
674
784
|
}
|
|
675
|
-
console.log(formatTable(result.
|
|
676
|
-
{ header: "
|
|
677
|
-
{ header: "
|
|
678
|
-
{ header: "
|
|
785
|
+
console.log(formatTable(result.rows.map((row) => ({ ...row, endpoint: `${row.method} ${row.path}`, function: requestFunction(row) })), [
|
|
786
|
+
{ header: "ENDPOINT", key: "endpoint" },
|
|
787
|
+
{ header: "FUNCTION", key: "function" },
|
|
788
|
+
{ header: "REQUESTS", key: "requests", align: "right", format: formatFigure },
|
|
789
|
+
{ header: "P50", key: "wall_ms_p50", align: "right", format: formatFigure },
|
|
790
|
+
{ header: "P95", key: "wall_ms_p95", align: "right", format: formatFigure },
|
|
791
|
+
{ header: "DYNAMO CALLS", key: "dynamo_calls_per_request", align: "right", format: formatFigure },
|
|
792
|
+
{ header: "DYNAMO MS", key: "dynamo_ms_per_request", align: "right", format: formatFigure },
|
|
793
|
+
{ header: "COLD", key: "cold_starts", align: "right", format: formatFigure },
|
|
794
|
+
]));
|
|
795
|
+
console.log();
|
|
796
|
+
info("P50, P95 and DYNAMO MS are milliseconds per request; DYNAMO CALLS is calls per request.");
|
|
797
|
+
}
|
|
798
|
+
catch (err) {
|
|
799
|
+
error(err.message);
|
|
800
|
+
process.exit(1);
|
|
801
|
+
}
|
|
802
|
+
});
|
|
803
|
+
// ── Integration Metrics ──────────────────────────────────────────
|
|
804
|
+
analytics
|
|
805
|
+
.command("integrations")
|
|
806
|
+
.description("Get integration usage metrics")
|
|
807
|
+
.argument("[app-id]", "App ID (uses current app if not specified)")
|
|
808
|
+
.option("--app <app-id>", "App ID")
|
|
809
|
+
.option("--window-days <n>", "Time window in days", "30")
|
|
810
|
+
.addOption(analyticsFreshOption())
|
|
811
|
+
.option("--json", "Output as JSON")
|
|
812
|
+
.action(async (appId, options) => {
|
|
813
|
+
const resolvedAppId = resolveAppId(appId, options);
|
|
814
|
+
const client = new ApiClient();
|
|
815
|
+
try {
|
|
816
|
+
const result = await client.getAnalyticsIntegrationMetrics(resolvedAppId, {
|
|
817
|
+
windowDays: parseInt(options.windowDays),
|
|
818
|
+
...freshParam(options.fresh),
|
|
819
|
+
});
|
|
820
|
+
if (options.json) {
|
|
821
|
+
json(result);
|
|
822
|
+
return;
|
|
823
|
+
}
|
|
824
|
+
heading(`Integration Metrics (${result.windowDays} days)`);
|
|
825
|
+
console.log();
|
|
826
|
+
if (!result.integrations || result.integrations.length === 0) {
|
|
827
|
+
info("No integration usage found.");
|
|
828
|
+
return;
|
|
829
|
+
}
|
|
830
|
+
console.log(formatTable(result.integrations, [
|
|
831
|
+
{ header: "INTEGRATION", key: "integrationKey" },
|
|
832
|
+
{ header: "CALLS", key: "invocations", align: "right", format: formatNumber },
|
|
833
|
+
{ header: "ERROR RATE", key: "errorRate", align: "right", format: formatPercent },
|
|
679
834
|
{ header: "MEDIAN", key: "medianDurationMs", align: "right", format: formatDuration },
|
|
680
|
-
{ header: "P95", key: "
|
|
681
|
-
{ header: "TOKENS", key: "totalTokens", align: "right", format: formatNumber },
|
|
835
|
+
{ header: "P95", key: "p95DurationMs", align: "right", format: formatDuration },
|
|
682
836
|
]));
|
|
683
837
|
}
|
|
684
838
|
catch (err) {
|
|
@@ -686,6 +840,7 @@ Examples:
|
|
|
686
840
|
process.exit(1);
|
|
687
841
|
}
|
|
688
842
|
});
|
|
843
|
+
// ── Top Workflows ────────────────────────────────────────────────
|
|
689
844
|
// ── Top Prompts ──────────────────────────────────────────────────
|
|
690
845
|
analytics
|
|
691
846
|
.command("prompts")
|
|
@@ -694,6 +849,7 @@ Examples:
|
|
|
694
849
|
.option("--app <app-id>", "App ID")
|
|
695
850
|
.option("--window-days <n>", "Time window in days", "30")
|
|
696
851
|
.option("--limit <n>", "Number of prompts to show", "10")
|
|
852
|
+
.addOption(analyticsFreshOption())
|
|
697
853
|
.option("--json", "Output as JSON")
|
|
698
854
|
.action(async (appId, options) => {
|
|
699
855
|
const resolvedAppId = resolveAppId(appId, options);
|
|
@@ -702,6 +858,7 @@ Examples:
|
|
|
702
858
|
const result = await client.getAnalyticsTopPrompts(resolvedAppId, {
|
|
703
859
|
windowDays: parseInt(options.windowDays),
|
|
704
860
|
limit: parseInt(options.limit),
|
|
861
|
+
...freshParam(options.fresh),
|
|
705
862
|
});
|
|
706
863
|
if (options.json) {
|
|
707
864
|
json(result);
|
|
@@ -736,110 +893,5 @@ Examples:
|
|
|
736
893
|
process.exit(1);
|
|
737
894
|
}
|
|
738
895
|
});
|
|
739
|
-
// ── Workflow step usage ──────────────────────────────────────────
|
|
740
|
-
/** Print one report's blocks: headings to stderr, bodies to stdout. */
|
|
741
|
-
function printUsageBlocks(blocks) {
|
|
742
|
-
for (const block of blocks) {
|
|
743
|
-
if (block.heading) {
|
|
744
|
-
console.log();
|
|
745
|
-
heading(block.heading);
|
|
746
|
-
}
|
|
747
|
-
console.log(block.body);
|
|
748
|
-
}
|
|
749
|
-
}
|
|
750
|
-
analytics
|
|
751
|
-
.command("workflow-usage")
|
|
752
|
-
.description("Step kinds this app's workflows configure, their runs in the window, and the sync-callable and idle workflows")
|
|
753
|
-
.argument("[app-id]", "App ID (uses current app if not specified)")
|
|
754
|
-
.option("--app <app-id>", "App ID")
|
|
755
|
-
.option("--window-days <n>", `Run window in days (${USAGE_CLI_MIN_WINDOW_DAYS}-${USAGE_CLI_MAX_WINDOW_DAYS}, default ${USAGE_CLI_DEFAULT_WINDOW_DAYS})`)
|
|
756
|
-
.option("--all-apps", "Merge the report across every app (super-admin only)")
|
|
757
|
-
.option("--json", "Output as JSON")
|
|
758
|
-
.action(async (appId, options) => {
|
|
759
|
-
// Both boundary checks run before the client is constructed, so an
|
|
760
|
-
// invalid invocation never reaches the network (principle 6).
|
|
761
|
-
if (options.allApps && (appId || options.app)) {
|
|
762
|
-
error(ALL_APPS_CONFLICT_ERROR);
|
|
763
|
-
process.exit(1);
|
|
764
|
-
}
|
|
765
|
-
const window = parseWindowDaysFlag(options.windowDays);
|
|
766
|
-
if ("error" in window) {
|
|
767
|
-
error(window.error);
|
|
768
|
-
process.exit(1);
|
|
769
|
-
return;
|
|
770
|
-
}
|
|
771
|
-
// Omitted means omitted on the wire: the server applies its own default
|
|
772
|
-
// and the CLI reports the same number for a merge that has no request.
|
|
773
|
-
const params = window.omitted
|
|
774
|
-
? undefined
|
|
775
|
-
: { windowDays: window.effective };
|
|
776
|
-
const client = new ApiClient();
|
|
777
|
-
if (options.allApps) {
|
|
778
|
-
try {
|
|
779
|
-
// The role gate comes first: GET /admin/api/apps is super-admin
|
|
780
|
-
// only (#3882), so the client refuses anyone else with its own
|
|
781
|
-
// message before any request rather than meeting the server's 403
|
|
782
|
-
// (D3130-002).
|
|
783
|
-
const me = await client.getMe();
|
|
784
|
-
if (!isSuperAdminRole(me.role)) {
|
|
785
|
-
error(ALL_APPS_SUPER_ADMIN_ERROR);
|
|
786
|
-
process.exit(1);
|
|
787
|
-
}
|
|
788
|
-
// There is no cross-app endpoint by design (intent): the CLI calls
|
|
789
|
-
// the per-app one once per app, over the GLOBAL apps list.
|
|
790
|
-
const apps = await client.listAllAppsGlobal();
|
|
791
|
-
const results = [];
|
|
792
|
-
for (const app of apps) {
|
|
793
|
-
try {
|
|
794
|
-
results.push({
|
|
795
|
-
appId: app.appId,
|
|
796
|
-
report: await client.getWorkflowUsage(app.appId, params),
|
|
797
|
-
});
|
|
798
|
-
}
|
|
799
|
-
catch (err) {
|
|
800
|
-
// A merged report over a silently chosen subset would answer a
|
|
801
|
-
// different question, so a refusal ends the walk.
|
|
802
|
-
if (isAbortStatus(err?.statusCode))
|
|
803
|
-
throw err;
|
|
804
|
-
results.push({
|
|
805
|
-
appId: app.appId,
|
|
806
|
-
error: err?.message ?? String(err),
|
|
807
|
-
});
|
|
808
|
-
}
|
|
809
|
-
}
|
|
810
|
-
const merged = mergeUsageReports(window.effective, results);
|
|
811
|
-
if (options.json) {
|
|
812
|
-
json(merged);
|
|
813
|
-
}
|
|
814
|
-
else {
|
|
815
|
-
printUsageBlocks(renderMergedUsageReport(merged));
|
|
816
|
-
}
|
|
817
|
-
// An incomplete report still prints, and still fails (intent).
|
|
818
|
-
// `exitCode` rather than `exit()`: the report is already on stdout
|
|
819
|
-
// and `process.exit` truncates a pipe's pending writes (#1004).
|
|
820
|
-
process.exitCode = usageExitCode(merged);
|
|
821
|
-
}
|
|
822
|
-
catch (err) {
|
|
823
|
-
error(err.message);
|
|
824
|
-
process.exit(1);
|
|
825
|
-
}
|
|
826
|
-
return;
|
|
827
|
-
}
|
|
828
|
-
const resolvedAppId = resolveAppId(appId, options);
|
|
829
|
-
try {
|
|
830
|
-
const report = await client.getWorkflowUsage(resolvedAppId, params);
|
|
831
|
-
if (options.json) {
|
|
832
|
-
json(report);
|
|
833
|
-
}
|
|
834
|
-
else {
|
|
835
|
-
printUsageBlocks(renderUsageReport(report));
|
|
836
|
-
}
|
|
837
|
-
process.exitCode = usageExitCode(report);
|
|
838
|
-
}
|
|
839
|
-
catch (err) {
|
|
840
|
-
error(err.message);
|
|
841
|
-
process.exit(1);
|
|
842
|
-
}
|
|
843
|
-
});
|
|
844
896
|
}
|
|
845
897
|
//# sourceMappingURL=analytics.js.map
|