@socialseal/cli 0.1.9 → 0.1.10

package/CHANGELOG.md

@@ -2,24 +2,33 @@
 
 ## Unreleased
 
+## 0.1.10 - 2026-06-10
+
+- Clarify ranked search exports now include publish/observed dates and scoped tracked-search resurfacing history fields when the backend export template is deployed.
+- Update `data export-options` metadata to distinguish search capture, metrics capture, platform publish, and SocialSeal observed-history timestamps.
+
 ## 0.1.9 - 2026-05-13
+
 - Fail `group-management add_items` on backend partial failures, expected-count mismatches, and failed backend verification.
 - Add `data export-group-evidence` to route social ranked evidence and Google AI evidence to the right raw export template with metadata.
 - Add `data group-completeness` with backend-first completeness checks, manifest fallback, and refresh status visibility.
 - Harden `tools status --wait` terminal failure handling and empty group refresh guardrails.
 
 ## 0.1.8 - 2026-04-13
+
 - Increase default CLI timeout from 30s to 5m to reduce false timeout failures on heavy tool/export workflows.
 - Harden async `search-journey-run` polling to accept additional active/terminal status labels (`queued`, `in_progress`, `running`, `succeeded`, `error`) instead of failing on unexpected variants.
 - Fix async `search-journey-run` polling workspace propagation to always reuse the resolved effective workspace scope.
 
 ## 0.1.7 - 2026-03-20
+
 - Add `socialseal data export-search-results` for CLI-first enriched ranked-search exports, including direct CSV download handling.
 - Add `search_results_enriched` as an alias on `socialseal data export-report` to map to the ranked-search export template.
 - Add `socialseal data export-options` to make available export workflows discoverable from the CLI.
 - Improve export ergonomics with local report-type validation and instructive failure guidance for processing, failed, and expired-download states.
 
 ## 0.1.6 - 2026-03-19
+
 - Fix runtime version reporting so `socialseal --version` reads from package metadata instead of a hardcoded source string.
 - Fix `tracking` create request translation so `--workspace-id` is sent on the REST query path the backend uses for workspace binding.
 - Improve tracked-video extraction failure messages by avoiding `[object Object]` item errors and returning explicit guidance when `videoId` is actually a search-result id or tracking item id.
@@ -28,28 +37,34 @@
 - Clarify in workspace discovery output and docs that `workspace_id` and `brand_id` are different identifiers.
 
 ## 0.1.5 - 2026-03-19
+
 - Add first-class tracked-video workflows with `video queue-analysis` and `video extract`.
 - Make `--video-id` the primary ergonomic selector for tracked-video analysis and asset extraction, while keeping `--search-result-id` as a fallback selector.
 - Support batch queueing/extraction payloads plus optional asset downloads for thumbnails, source video, and extracted key frames.
 
 ## 0.1.4 - 2026-03-19
+
 - Add explicit `group_add_item` / `group_add_items` CLI aliases for tracking-group membership workflows.
 - Add `tracking resolve` / `get_by_value` so existing tracked searches can be resolved by value using the same duplicate-detection semantics as create.
 - Return operational duplicate metadata for tracking conflicts, including `existing_item_id`, `member_of_group_ids`, platform, region, workspace, and active state.
 
 ## 0.1.3 - 2026-03-19
+
 - Republish the current CLI release line after the successful `0.1.2` npm publish, keeping the internal and OSS package versions aligned.
 
 ## 0.1.2 - 2026-03-18
+
 - Add `search-journey-run` async CLI ergonomics: `--async` starts the backend async mode, polling is on by default, and `--no-poll` returns the initial `runId` immediately.
 - Add `--poll-interval <ms>` for async `search-journey-run` status polling.
 - Treat terminal async `search-journey-run` failures as non-zero CLI exits instead of silent `200` JSON output.
 
 ## 0.1.1 - 2026-03-13
+
 - Document public base URL and CLI error output.
 - Add request timeouts, verbose error output, and OSS-safe tool discovery behavior.
 - Ship a stable built-in tool registry for `tools list` instead of the hard-disabled discovery message.
 - Fail fast on agent WebSocket `error` events and surface session/tool progress diagnostics in `--verbose` mode.
 
 ## 0.1.0
+
 - Initial CLI with agent streaming, tools calls, and provisional data exports.

package/README.md

@@ -1,12 +1,15 @@
 # SocialSeal CLI
 
 ## Setup
+
 - Requires Node 18+
 - Global install: `npm install -g @socialseal/cli`
 - Dev install: `npm install`
 
 ## Configuration
+
 Environment variables:
+
 - `SOCIALSEAL_API_KEY`
 - `SOCIALSEAL_API_BASE` (default `https://api.socialseal.co`)
 - `SOCIALSEAL_WORKSPACE_ID` (optional workspace override; takes precedence over config)
@@ -14,6 +17,7 @@ Environment variables:
 - `SOCIALSEAL_AGENT_IDLE_TIMEOUT_MS` (optional agent WebSocket inactivity timeout override; default 300000)
 
 Optional config file:
+
 - `~/.config/socialseal/config.json`
 
 ```json
@@ -27,6 +31,7 @@ Optional config file:
 ```
 
 ## Commands
+
 - Workspace discovery/defaults:
   - `socialseal workspace list`
   - `socialseal workspace current`
@@ -68,10 +73,17 @@ Optional config file:
   - `socialseal data export-report --report-type keyword_universe --format csv --payload @payload.json --out out.csv`
 
 ## Notes
+
 - `export-report`, `export_tracking_data`, and `export-data`-backed exports are provisional until CLI export specs are finalized.
 - `tools list` ships a stable built-in registry of supported direct-call function targets. It is not live backend enumeration.
 - `tools schema --function <name>` prints static required/optional payload fields and example bodies for high-friction tools.
-- `data export-search-results` maps to `export-data` template `tracking_ranked_videos_raw` and returns enriched ranked-search rows (search fields + video metadata + latest metrics + analysis). It downloads the signed CSV artifact when available.
+- `data export-search-results` maps to `export-data` template `tracking_ranked_videos_raw` and returns enriched ranked-search rows (search fields + video metadata + publish/observed dates + latest metrics + scoped tracked-search history + analysis). It downloads the signed CSV artifact when available.
+- Timestamp meanings in ranked search exports:
+  - `search_timestamp`: when SocialSeal captured that ranked search row.
+  - `latest_metrics_ts`: when the latest exported engagement metrics snapshot was captured.
+  - `published_at`: platform publish/upload time when available from the video record; blank if unavailable.
+  - `observed_at`: when SocialSeal first observed/ingested the video record when available; blank if unavailable.
+  - `first_seen_at` / `last_seen_at`: earliest/latest `search_timestamp` for the video within the exported tracking-group/search-row scope. Use these for “resurfacing in tracked search” language, not platform-age claims when `published_at` is absent.
 - `data export-report --report-type search_results_enriched` is a compatibility alias to the same `export-data` template flow.
 - `data export-report` now validates report types locally and shows the allowed list immediately; run `socialseal data export-options` when choosing between export flows.
 - If an export returns metadata without a file URL (for example status `processing`), the CLI prints an explicit retry hint and returns the metadata JSON so automation can branch on status.
@@ -91,11 +103,13 @@ Optional config file:
 - If a scoped CLI key cannot safely infer a workspace, `agent run` now fails closed and tells you to set `--workspace-id` or configure a local default first.
 
 ## Errors and exit codes
+
 - Exit codes: `2` (usage), `3` (auth), `4` (not found), `5` (server), `1` (unknown)
 - Add `--json` to `tools call` or `data` commands to emit machine-readable errors.
 - Add `--verbose` to print error details plus agent session/tool progress diagnostics.
 
 ## Troubleshooting
+
 - `SUPABASE_ANON_KEY not configured`
   - This comes from the CLI gateway, not the local CLI install.
   - The deployed gateway is missing its `SUPABASE_ANON_KEY` secret, so `/cli/tools/*` cannot proxy to Supabase Edge Functions.
@@ -106,8 +120,10 @@ Optional config file:
   - If this reproduces from a supported Google AI region, treat it as an infrastructure/runtime issue. Practical workarounds are to run the agent from a worker placement/egress region that Google accepts, or switch the agent runtime to Vertex AI for server-side calls.
 
 ## Smoke Test (manual)
+
 1. `SOCIALSEAL_API_KEY=... socialseal agent run --message "ping"`
 2. `SOCIALSEAL_API_KEY=... socialseal tools call --function <tool> --body @payload.json`
 
 ## Maintainers
+
 - The public CLI base (`api.socialseal.co`) must route to the CLI gateway service.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socialseal/cli",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "private": false,
   "type": "module",
   "description": "SocialSeal CLI (non-interactive)",
@@ -13,7 +13,7 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/OpenSealAI/socialseal-cli.git"
+    "url": "git+https://github.com/OpenSealAI/socialseal-cli.git"
   },
   "bugs": {
     "url": "https://github.com/OpenSealAI/socialseal-cli/issues"

package/src/index.js

@@ -55,10 +55,10 @@ const EXPORT_OPTIONS = [
   {
     id: 'search_results_enriched',
     command: 'socialseal data export-search-results --group-ids <id,id,...>',
-    summary: 'Enriched ranked search rows (search results + video + latest metrics + analysis).',
+    summary: 'Enriched ranked search rows (search capture + video publish/observed dates + latest metrics + scoped resurfacing history + analysis).',
     formats: ['csv'],
     required: ['workspace id', '--group-ids'],
-    bestFor: 'SQL-like ranked-search datasets without using psql.',
+    bestFor: 'SQL-like ranked-search datasets and deck evidence that must distinguish capture, metrics, publish, and tracked-search resurfacing timestamps.',
     alias: 'socialseal data export-report --report-type search_results_enriched --format csv --payload @payload.json',
   },
   {
@@ -124,7 +124,7 @@ const KNOWN_TOOLS = [
     transport: 'post_edge_function',
     workspaceScoped: true,
     knownLocalDevState: 'disabled_by_default',
-    notes: 'Includes template `tracking_ranked_videos_raw` for ranked search results with video + metrics + analysis enrichment.',
+    notes: 'Includes template `tracking_ranked_videos_raw` for ranked search results with video publish/observed dates, latest metrics, scoped first/last seen, and analysis enrichment.',
   },
   {
     name: 'export_tracking_data',