agnes-the-ai-analyst/docs
Petr 67df4acd73 Add --stdin JSON mode to avoid shell escaping nightmare
Agent was failing 3x on SSH commands due to backticks (BQ table names)
and single quotes (SQL string literals) getting mangled by nested shell
interpretation (local -> SSH -> bash -> Python).

New --stdin mode reads query spec as JSON from stdin via heredoc:
  cat <<'QUERY' | ssh alias 'bash remote_query.sh --stdin'
  {"register_bq": {"alias": "SELECT ... FROM \`table\` ..."}, "sql": "..."}
  QUERY

Heredoc with <<'QUERY' (quoted) passes everything literally -- no
escaping needed for backticks, quotes, or parentheses.

Updated claude_md_template.txt to use --stdin as the primary method.
2026-03-21 12:15:50 +01:00
..
future Restructure docs for OSS readability 2026-03-09 10:42:45 +01:00
metrics/revenue Add sample metric YAML as fallback when OpenMetadata metrics unavailable 2026-03-12 15:14:04 +01:00
setup Add --stdin JSON mode to avoid shell escaping nightmare 2026-03-21 12:15:50 +01:00
testing docs 2026-03-10 11:43:11 +01:00
architecture.md docs 2026-03-10 11:43:11 +01:00
auto-install.md Remove hardcoded Jira and Telemetry cards from catalog 2026-03-10 22:48:07 +01:00
CONFIGURATION.md Initial commit: OSS data distribution platform 2026-03-08 23:31:28 +01:00
DATA_SOURCES.md Branding cleanup: remove Keboola-specific references from docs and config 2026-03-09 12:22:27 +01:00
DEPLOYMENT.md Initial commit: OSS data distribution platform 2026-03-08 23:31:28 +01:00
PLAN.md Move standalone services from server/ to services/ 2026-03-09 12:54:30 +01:00
QUICKSTART.md Initial commit: OSS data distribution platform 2026-03-08 23:31:28 +01:00
sample-data.md Add --format parquet using project's ParquetManager 2026-03-10 21:46:20 +01:00
theme-reference.html Fix clipped annotation badges in theme-reference.html 2026-03-11 14:09:04 +01:00