| name | flow-hybrid-search |
| description | Execute and troubleshoot Supabase edge function `flow_hybrid_search`, which rewrites flow descriptions and calls `hybrid_search_flows` with optional filters. Use when validating flow query/filter behavior, tuning retrieval prompts, or debugging auth, embedding, and RPC failures. |
Flow Hybrid Search
Run Workflow
- The wrapper uses the repository-pinned published CLI. Use
TIANGONG_LCA_CLI_DIR or --cli-dir only for an exact local dev/CI override.
- Official Production needs no environment setup: the CLI owns its public profile. Only Dev/self-hosted/custom clients need the complete matching configuration in
references/env.md.
- Run
tiangong-lca auth status --json. If it returns login-required, stop and ask the human user to run tiangong-lca auth login in a trusted terminal.
- Execute
node scripts/run-flow-hybrid-search.mjs with standard tiangong-lca search flow flags.
- The wrapper delegates to
tiangong-lca search flow; the CLI resolves and refreshes its private OAuth session.
- Confirm response shape, then debug with focused references.
Never ask an AI user for a username, password, authorization code, access token, refresh token, or the deprecated encoded API key. Headless runs require an explicit destination/publishable key and may use only an orchestrator-injected short-lived TIANGONG_LCA_ACCESS_TOKEN; do not pass it through argv, prompts, logs, or artifacts.
Commands
pnpm dlx --package=@tiangong-lca/cli@0.1.8 tiangong-lca auth status --json
pnpm dlx --package=@tiangong-lca/cli@0.1.8 tiangong-lca auth login
node scripts/run-flow-hybrid-search.mjs --dry-run
node scripts/run-flow-hybrid-search.mjs --input ./assets/example-request.json
node scripts/run-flow-hybrid-search.mjs --cli-dir /path/to/tiangong-lca-cli --dry-run
Fast Triage
- An independently installed skill includes its launcher and example input; no Skills/CLI/Data Foundry checkout is required. The launcher is a byte-checked bundle of the repository authority, not a separate auth implementation.
- Fresh
auth status / doctor-auth returns login-required (exit 1), not a missing Production client. A custom --base-url requires matching complete custom configuration.
400: missing or invalid query.500: embedding provider or hybrid_search_flows RPC failure.- Empty
data: query/filter mismatch; inspect generated retrieval query and filter structure.
Load References On Demand
references/env.md: auth, region, and endpoint overrides.references/request-response.md: payload contract and RPC expectations.references/prompts.md: query-rewrite prompt constraints.references/testing.md: smoke test checklist.
