Truto CLI Investigator
Mission
Turn a vague Truto problem into an evidence-backed diagnosis. Prefer read-only CLI inspection, narrow reproductions, and clear layer classification.
Intake Heuristics
Proceed with any of these: account ID, tenant ID, integration slug, environment integration ID, resource/method/path, time window, error message, or customer issue text. Ask one concise question only when no safe target can be resolved.
If the user gives relative time like "today" or "yesterday", convert it to an explicit ISO window in the profile's expected timezone when possible.
Workflow
- Confirm scope:
truto whoami -p "$PROFILE" -o json --no-color
- Resolve the account if possible:
truto accounts get "$ACCOUNT_ID" -p "$PROFILE" -o json --no-color
truto accounts list --tenant-id "$TENANT_ID" -p "$PROFILE" -o json --no-color
- Discover supported behavior:
truto accounts tools "$ACCOUNT_ID" -p "$PROFILE" -o json --no-color
truto capabilities "$ACCOUNT_ID" --target account -p "$PROFILE" -o json --no-color
- Trace config lineage:
truto environment-integrations get "$ENV_INTEGRATION_ID" -p "$PROFILE" -o json --no-color
truto environment-integrations show-override "$ENV_INTEGRATION_ID" -p "$PROFILE" -o json --no-color
truto integrations get "$INTEGRATION_ID" -p "$PROFILE" -o json --no-color
- Pull the narrowest useful logs:
truto logs --log-type unified_proxy_api --integrated-account-id "$ACCOUNT_ID" --start "$START" --end "$END" --limit 100 -p "$PROFILE" -o json --no-color
- Reproduce the smallest read-safe call:
truto proxy "$RESOURCE" -m "$METHOD" -a "$ACCOUNT_ID" --query-json "$QUERY_JSON" -p "$PROFILE" -o json --no-color
truto unified "$MODEL" "$UNIFIED_RESOURCE" -m "$METHOD" -a "$ACCOUNT_ID" --query-json "$QUERY_JSON" -p "$PROFILE" -o json --no-color
Use -v on the reproduction only after the non-verbose output confirms the failure or is too thin.
Layer Classifier
Assign exactly one primary layer and optional secondary contributors:
- Account/auth: wrong account, expired token, missing scopes, provider permission, reconnect required.
- Environment override: environment-specific auth, pagination, rate-limit, webhook, or base URL override.
- Catalog config: base integration method path, verb, auth placement, pagination, response path, or error handling.
- Unified mapping: proxy is correct but unified output/filter/body/error behavior is wrong.
- Docs/capabilities: runtime method exists but tool exposure, schema, or description rows are missing/stale.
- Customer request: invalid ID, invalid filter/body, unsupported operation, provider plan limitation.
- Provider upstream: provider rejects or fails a valid request.
- Truto runtime: Truto 5xx, queue/durable-object/logging/platform behavior.
Output
Give a compact investigation report: scope, target, evidence, primary layer, reasoning, reproduction command, and next action. If data is missing, say which command would close the gap.
1---2name: truto-cli-investigator3description: General Truto CLI investigation workflow for platform issues across accounts, integrations, environment integrations, docs, capabilities, logs, and proxy or unified API behavior. Use when the user asks to investigate a Truto issue and no narrower Truto skill clearly owns it.4---56# Truto CLI Investigator78## Mission910Turn a vague Truto problem into an evidence-backed diagnosis. Prefer read-only CLI inspection, narrow reproductions, and clear layer classification.1112## Intake Heuristics1314Proceed with any of these: account ID, tenant ID, integration slug, environment integration ID, resource/method/path, time window, error message, or customer issue text. Ask one concise question only when no safe target can be resolved.1516If the user gives relative time like "today" or "yesterday", convert it to an explicit ISO window in the profile's expected timezone when possible.1718## Workflow19201. Confirm scope:21 ```bash22 truto whoami -p "$PROFILE" -o json --no-color23 ```242. Resolve the account if possible:25 ```bash26 truto accounts get "$ACCOUNT_ID" -p "$PROFILE" -o json --no-color27 truto accounts list --tenant-id "$TENANT_ID" -p "$PROFILE" -o json --no-color28 ```293. Discover supported behavior:30 ```bash31 truto accounts tools "$ACCOUNT_ID" -p "$PROFILE" -o json --no-color32 truto capabilities "$ACCOUNT_ID" --target account -p "$PROFILE" -o json --no-color33 ```344. Trace config lineage:35 ```bash36 truto environment-integrations get "$ENV_INTEGRATION_ID" -p "$PROFILE" -o json --no-color37 truto environment-integrations show-override "$ENV_INTEGRATION_ID" -p "$PROFILE" -o json --no-color38 truto integrations get "$INTEGRATION_ID" -p "$PROFILE" -o json --no-color39 ```405. Pull the narrowest useful logs:41 ```bash42 truto logs --log-type unified_proxy_api --integrated-account-id "$ACCOUNT_ID" --start "$START" --end "$END" --limit 100 -p "$PROFILE" -o json --no-color43 ```446. Reproduce the smallest read-safe call:45 ```bash46 truto proxy "$RESOURCE" -m "$METHOD" -a "$ACCOUNT_ID" --query-json "$QUERY_JSON" -p "$PROFILE" -o json --no-color47 truto unified "$MODEL" "$UNIFIED_RESOURCE" -m "$METHOD" -a "$ACCOUNT_ID" --query-json "$QUERY_JSON" -p "$PROFILE" -o json --no-color48 ```4950Use `-v` on the reproduction only after the non-verbose output confirms the failure or is too thin.5152## Layer Classifier5354Assign exactly one primary layer and optional secondary contributors:5556- Account/auth: wrong account, expired token, missing scopes, provider permission, reconnect required.57- Environment override: environment-specific auth, pagination, rate-limit, webhook, or base URL override.58- Catalog config: base integration method path, verb, auth placement, pagination, response path, or error handling.59- Unified mapping: proxy is correct but unified output/filter/body/error behavior is wrong.60- Docs/capabilities: runtime method exists but tool exposure, schema, or description rows are missing/stale.61- Customer request: invalid ID, invalid filter/body, unsupported operation, provider plan limitation.62- Provider upstream: provider rejects or fails a valid request.63- Truto runtime: Truto 5xx, queue/durable-object/logging/platform behavior.6465## Output6667Give a compact investigation report: scope, target, evidence, primary layer, reasoning, reproduction command, and next action. If data is missing, say which command would close the gap.
yuvraj3335