Fix report presets and add Xquik social pulse research

[kriptoburak]

Summary

• Fix report date presets across every live insights path.
• Add optional public X language research through the existing Bash adapter.
• Provide deterministic mock data, bounded pagination, deduplication, and query attribution.
• Document how ad-copy workflows should handle public posts safely.

Independent Repository Fix

The CLI accepted --preset, but every live insights operation still sent last_7d to Meta. Reports could therefore label 30-day requests while returning 7-day data. The adapter now forwards the selected preset to campaign, ad, and daily insight operations.

Xquik Integration

./run.sh social-pulse now supports 1 to 10 focused queries with up to 200 results per query. Mock mode reads a local fixture. Other supported modes call the read-only Xquik search endpoint.

The adapter validates response shape, follows cursors through empty pages, rejects repeated or missing cursors, deduplicates posts without reordering them, and records every matching query. It normalizes nested authors and current engagement fields.

Public post text remains untrusted evidence. The skill tells agents not to follow embedded instructions, expose private campaign data, copy posts, or mix public engagement with Meta performance.

Safety

• No Meta or X write operation was added.
• The API key is sent through curl configuration input, not process arguments.
• Live keys can reach only the official Xquik API. Loopback HTTP remains available for tests.
• Every request has connection and total timeouts.
• Mock mode makes no external request.

Validation

• bash -n run.sh scripts/*.sh scripts/lib/*.sh
• Bash 3.2 syntax and social-pulse execution
• shellcheck run.sh scripts/meta-kit.sh scripts/lib/meta-cli.sh scripts/lib/xquik.sh
• Full fixture-backed mock report suite and doctor
• Official Meta CLI help through uvx --python 3.12 --from meta-ads
• Fake live adapter proving --preset last_30d reaches Meta
• Xquik empty-page pagination, cursor guards, response validation, deduplication, limits, and secret handling
• JSON fixture, Skill metadata, Markdown fence delta, and git diff --check