flipstream 0.4.0

package/oclif.manifest.json

@@ -0,0 +1,851 @@
+{
+  "commands": {
+    "query": {
+      "aliases": [],
+      "args": {},
+      "description": "Send an OPAQUE JSON body (--body, --body-file, or piped stdin) to the Flipstream data API and print the structured JSON response. The CLI never constructs, validates, or transforms the query payload — the body is forwarded verbatim (your agent/Skill builds it).",
+      "examples": [
+        "<%= config.bin %> query --body '{\"opaque\":true}'",
+        "echo '{\"opaque\":true}' | <%= config.bin %> query",
+        "<%= config.bin %> query --body-file query.json --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "host": {
+          "char": "H",
+          "description": "OAuth provider host (defaults to the prod issuer).",
+          "name": "host",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ndjson": {
+          "description": "Stream output as NDJSON (one compact JSON object per line).",
+          "name": "ndjson",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Network timeout in milliseconds.",
+          "name": "timeout",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "aliases": [
+            "debug"
+          ],
+          "description": "Print redacted diagnostics to stderr.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "auth-host": {
+          "description": "OAuth issuer host for credentials/refresh (defaults to the prod issuer).",
+          "name": "auth-host",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "body": {
+          "description": "Opaque JSON request body as a string.",
+          "exclusive": [
+            "body-file"
+          ],
+          "name": "body",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "body-file": {
+          "description": "Path to a file holding the opaque JSON request body.",
+          "name": "body-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "query",
+      "pluginAlias": "flipstream",
+      "pluginName": "flipstream",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Run an opaque query against the Flipstream data API.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "query.js"
+      ]
+    },
+    "version": {
+      "aliases": [],
+      "args": {},
+      "description": "Print the CLI version, runtime, and agent-contract version as JSON.",
+      "examples": [
+        "<%= config.bin %> version",
+        "<%= config.bin %> version --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "host": {
+          "char": "H",
+          "description": "OAuth provider host (defaults to the prod issuer).",
+          "name": "host",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ndjson": {
+          "description": "Stream output as NDJSON (one compact JSON object per line).",
+          "name": "ndjson",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Network timeout in milliseconds.",
+          "name": "timeout",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "aliases": [
+            "debug"
+          ],
+          "description": "Print redacted diagnostics to stderr.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "version",
+      "pluginAlias": "flipstream",
+      "pluginName": "flipstream",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Print version, runtime, and agent-contract version.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "version.js"
+      ]
+    },
+    "auth:clear-all": {
+      "aliases": [],
+      "args": {},
+      "description": "Purge ALL Flipstream credentials: every keychain entry and the local config directory.",
+      "examples": [
+        "<%= config.bin %> auth clear-all",
+        "<%= config.bin %> auth clear-all --no-revoke"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "host": {
+          "char": "H",
+          "description": "OAuth provider host (defaults to the prod issuer).",
+          "name": "host",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ndjson": {
+          "description": "Stream output as NDJSON (one compact JSON object per line).",
+          "name": "ndjson",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Network timeout in milliseconds.",
+          "name": "timeout",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "aliases": [
+            "debug"
+          ],
+          "description": "Print redacted diagnostics to stderr.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-revoke": {
+          "description": "Clear local credentials only; skip the per-host server revocation calls.",
+          "name": "no-revoke",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:clear-all",
+      "pluginAlias": "flipstream",
+      "pluginName": "flipstream",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Purge ALL credentials: every keychain entry and the local config dir.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "clear-all.js"
+      ]
+    },
+    "auth:login": {
+      "aliases": [],
+      "args": {},
+      "description": "Log in to Flipstream in the browser (OAuth2 Authorization Code + PKCE).",
+      "examples": [
+        "<%= config.bin %> auth login",
+        "<%= config.bin %> auth login --no-browser"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "host": {
+          "char": "H",
+          "description": "OAuth provider host (defaults to the prod issuer).",
+          "name": "host",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ndjson": {
+          "description": "Stream output as NDJSON (one compact JSON object per line).",
+          "name": "ndjson",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Network timeout in milliseconds.",
+          "name": "timeout",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "aliases": [
+            "debug"
+          ],
+          "description": "Print redacted diagnostics to stderr.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-browser": {
+          "description": "Headless mode: print the authorization URL, then paste the redirected URL back (no browser).",
+          "name": "no-browser",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "scope": {
+          "description": "OAuth scope (repeatable).",
+          "name": "scope",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:login",
+      "pluginAlias": "flipstream",
+      "pluginName": "flipstream",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Log in via the browser (OAuth2 + PKCE).",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "login.js"
+      ]
+    },
+    "auth:logout": {
+      "aliases": [],
+      "args": {},
+      "description": "Log out of Flipstream: revoke the token (best-effort) and clear the keychain.",
+      "examples": [
+        "<%= config.bin %> auth logout",
+        "<%= config.bin %> auth logout --no-revoke"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "host": {
+          "char": "H",
+          "description": "OAuth provider host (defaults to the prod issuer).",
+          "name": "host",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ndjson": {
+          "description": "Stream output as NDJSON (one compact JSON object per line).",
+          "name": "ndjson",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Network timeout in milliseconds.",
+          "name": "timeout",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "aliases": [
+            "debug"
+          ],
+          "description": "Print redacted diagnostics to stderr.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-revoke": {
+          "description": "Clear local credentials only; skip the server revocation call.",
+          "name": "no-revoke",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:logout",
+      "pluginAlias": "flipstream",
+      "pluginName": "flipstream",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Log out: revoke the token (best-effort) and clear the keychain.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "logout.js"
+      ]
+    },
+    "auth:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Show the current Flipstream authentication status for a host.",
+      "examples": [
+        "<%= config.bin %> auth status",
+        "<%= config.bin %> auth status --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "host": {
+          "char": "H",
+          "description": "OAuth provider host (defaults to the prod issuer).",
+          "name": "host",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ndjson": {
+          "description": "Stream output as NDJSON (one compact JSON object per line).",
+          "name": "ndjson",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Network timeout in milliseconds.",
+          "name": "timeout",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "aliases": [
+            "debug"
+          ],
+          "description": "Print redacted diagnostics to stderr.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:status",
+      "pluginAlias": "flipstream",
+      "pluginName": "flipstream",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Show whether you are logged in, and your account, scopes, and expiry.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "status.js"
+      ]
+    },
+    "connections:list": {
+      "aliases": [
+        "conn:list"
+      ],
+      "args": {},
+      "description": "List connections (data sources) — org-wide, or for one workspace via --workspace (or `ws connections <id>`). Returns each connection id + source metadata; secret_id / parameters are redacted. Targets the OAuth/admin host.",
+      "examples": [
+        "<%= config.bin %> connections list",
+        "<%= config.bin %> connections list --workspace <id> --json",
+        "<%= config.bin %> conn list --all"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "host": {
+          "char": "H",
+          "description": "OAuth provider host (defaults to the prod issuer).",
+          "name": "host",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ndjson": {
+          "description": "Stream output as NDJSON (one compact JSON object per line).",
+          "name": "ndjson",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Network timeout in milliseconds.",
+          "name": "timeout",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "aliases": [
+            "debug"
+          ],
+          "description": "Print redacted diagnostics to stderr.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "all": {
+          "description": "Fetch every page (drains pagination).",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Page size.",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "offset": {
+          "description": "Starting offset.",
+          "name": "offset",
+          "default": 0,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "q": {
+          "description": "Free-text filter.",
+          "name": "q",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sort": {
+          "description": "Sort field.",
+          "name": "sort",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace": {
+          "description": "List only this workspace's connections (UUID).",
+          "name": "workspace",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "connections:list",
+      "pluginAlias": "flipstream",
+      "pluginName": "flipstream",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List connections, org-wide or for one workspace.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "connections",
+        "list.js"
+      ]
+    },
+    "workspaces:connections": {
+      "aliases": [
+        "ws:connections"
+      ],
+      "args": {
+        "id": {
+          "description": "Workspace id (UUID).",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "List one workspace's connections — the ergonomic form of `connections list --workspace <id>`. Targets the OAuth/admin host.",
+      "examples": [
+        "<%= config.bin %> workspaces connections <id>",
+        "<%= config.bin %> ws connections <id> --json",
+        "<%= config.bin %> ws connections <id> --all"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "host": {
+          "char": "H",
+          "description": "OAuth provider host (defaults to the prod issuer).",
+          "name": "host",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ndjson": {
+          "description": "Stream output as NDJSON (one compact JSON object per line).",
+          "name": "ndjson",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Network timeout in milliseconds.",
+          "name": "timeout",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "aliases": [
+            "debug"
+          ],
+          "description": "Print redacted diagnostics to stderr.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "all": {
+          "description": "Fetch every page (drains pagination).",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Page size.",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "offset": {
+          "description": "Starting offset.",
+          "name": "offset",
+          "default": 0,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "q": {
+          "description": "Free-text filter.",
+          "name": "q",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sort": {
+          "description": "Sort field.",
+          "name": "sort",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "workspaces:connections",
+      "pluginAlias": "flipstream",
+      "pluginName": "flipstream",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List one workspace's connections.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "workspaces",
+        "connections.js"
+      ]
+    },
+    "workspaces:get": {
+      "aliases": [
+        "ws:get"
+      ],
+      "args": {
+        "id": {
+          "description": "Workspace id (UUID).",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Fetch one workspace by id (the admin API \"Client\"). A foreign or missing id collapses to a single not-found message (no existence leak). Targets the OAuth/admin host.",
+      "examples": [
+        "<%= config.bin %> workspaces get <id>",
+        "<%= config.bin %> ws get <id> --json",
+        "<%= config.bin %> ws get <id> --with-connection-count"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "host": {
+          "char": "H",
+          "description": "OAuth provider host (defaults to the prod issuer).",
+          "name": "host",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ndjson": {
+          "description": "Stream output as NDJSON (one compact JSON object per line).",
+          "name": "ndjson",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Network timeout in milliseconds.",
+          "name": "timeout",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "aliases": [
+            "debug"
+          ],
+          "description": "Print redacted diagnostics to stderr.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "refresh": {
+          "description": "Ask the server to refresh derived data (refresh=true).",
+          "name": "refresh",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "with-connection-count": {
+          "description": "Include connection_count (one extra request to the connections endpoint).",
+          "name": "with-connection-count",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "workspaces:get",
+      "pluginAlias": "flipstream",
+      "pluginName": "flipstream",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Show one workspace by id.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "workspaces",
+        "get.js"
+      ]
+    },
+    "workspaces:list": {
+      "aliases": [
+        "ws:list"
+      ],
+      "args": {},
+      "description": "List the workspaces (the Flipstream business entity, \"Client\" in the admin API) in your organization. Account-scoped server-side (the CLI sends no org id). Targets the OAuth/admin host (whereas `query` targets the data host).",
+      "examples": [
+        "<%= config.bin %> workspaces list",
+        "<%= config.bin %> ws list --json",
+        "<%= config.bin %> ws list --all",
+        "<%= config.bin %> ws list --q acme --limit 10"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "host": {
+          "char": "H",
+          "description": "OAuth provider host (defaults to the prod issuer).",
+          "name": "host",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ndjson": {
+          "description": "Stream output as NDJSON (one compact JSON object per line).",
+          "name": "ndjson",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Network timeout in milliseconds.",
+          "name": "timeout",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "aliases": [
+            "debug"
+          ],
+          "description": "Print redacted diagnostics to stderr.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "all": {
+          "description": "Fetch every page (drains pagination).",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Page size.",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "offset": {
+          "description": "Starting offset.",
+          "name": "offset",
+          "default": 0,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "q": {
+          "description": "Free-text filter.",
+          "name": "q",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sort": {
+          "description": "Sort field.",
+          "name": "sort",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "with-connection-counts": {
+          "description": "Add connection_count per workspace (opt-in: one extra request each, N+1).",
+          "name": "with-connection-counts",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "workspaces:list",
+      "pluginAlias": "flipstream",
+      "pluginName": "flipstream",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List your organization's workspaces.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "workspaces",
+        "list.js"
+      ]
+    }
+  },
+  "version": "0.4.0"
+}