Release v1.2.0 — Privacy preview, audit diffs & Notion docs

[dkoryto]

New features
────────────

• flowhunt dry-run — collects all data exactly like a full audit, presents a privacy-friendly preview (counts + samples), asks for user confirmation, and only proceeds to analysis if approved. Perfect for privacy-sensitive users who want to see what
ts fed into the LLM.
• flowhunt diff — standalone mode that compares two existing audit reports and produces a progress summary: new patterns, resolved recommendations, shifting time allocation, new connectors added.
• Automated audit diff — during every flowhunt audit, if a previous audit exists, the agent auto-generates a ## Changes since last audit section (New / Resolved / Persistent / Data quality delta).
• Notion as document source — when Notion is the task tracker, the audit also reads recent pages (SOPs, meeting notes, decision logs) and databases the user actively maintains. Detects process signals that indicate where automation is already being c
sidered.
• ActivityWatch auto-discovery fallback — if find_bucket("aw-watcher-window_") fails, the agent lists all buckets, picks the most recently active window/AFK bucket by last_updated, and substitutes its literal name in the AQL query. No more "Bucket no
found" on custom hostnames or legacy installs.
Improvements
────────────

• Multi-account support (complete) — config.json stores additional_accounts[]; audit-collect.md iterates over them and writes suffixed raw files (gmail_secondary.json, slack_secondary.json, etc.).
• Token rotation reminder — when setting up Slack via the OSS korotovsky path using browser cookie tokens (xoxc/xoxd), the agent explicitly warns that these tokens expire after weeks/months and instructs how to refresh them.
• Cross-platform timestamps — all date commands replaced with Python3 one-liners to eliminate BSD/GNU date incompatibilities.
• Central state — ~/.flowhunt/config.json makes flowhunt status, flowhunt config, and flowhunt quick-audit stateful and idempotent.
• Modular architecture — setup.md and audit.md split into focused sub-modules (setup-activitywatch.md, setup-connectors.md, audit-precheck.md, audit-collect.md, audit-output.md).
Documentation
─────────────

• README.md completely rewritten to reflect all v1.2.0 commands, features, and project structure.
• AGENTS.md added — conventions and testing checklist for future maintainers.

[konradbachowski]

Review v1.2.0

Dzięki za solidny PR. Modularny split i nowe komendy mają sens, ale przed merge są rzeczy do poprawki.

Co solidne

• Rozbicie setup.md i audit.md na pod-moduły (precheck / collect / output, setup-activitywatch / setup-connectors) — te pliki były najbardziej spuchnięte.
• Auto-discovery bucketów AW gdy find_bucket("aw-watcher-window_") padnie na custom hostname — realny bugfix dla użytkowników z nietypowym hostnamem.
• Zamiana date -u -v-30d na Python3 datetime jednoliniowce — koniec rozjazdu BSD/GNU date.
• Token rotation warning przy Slack xoxc/xoxd w setup-connectors.md — wcześniej tego brakowało, użytkownicy nie wiedzieli czemu Slack przestaje odpowiadać po kilku tygodniach.
• Notion jako document source (SOPs / meeting notes / decision logs) — silny dodatkowy sygnał dla użytkowników Notion, bo tam często jest pół wiki firmy.
• ~/.flowhunt/config.json jako stateful truth — pozwala na flowhunt status bez re-runa setupu i robi commands idempotentne.
• additional_accounts[] (multi-Gmail, multi-Slack workspace) z sufiksami w raw files — czysto zrobione.
• Auto-diff ## Changes since last audit w każdym audycie — dobre pod retencję.

Czerwone flagi do poprawki przed merge

1. Halucynacja nazwy paczki npm (Todoist) — task-trackers.md

PR pokazuje wszędzie:

npx -y abhiz123/todoist-mcp-server

Sprawdziłem npm registry — ta paczka nazywa się @abhiz123/todoist-mcp-server (z @ i scope). Bez @ npx pójdzie szukać tarballa na GitHubie albo padnie z 404 Not Found. Trzeba poprawić w 3 snippetach (Claude Code ~/.claude.json, Gemini gemini mcp add, OpenCode opencode.json).

Pozostałe dwie paczki sprawdzone i istnieją:

• @taazkareem/clickup-mcp-server — 0.14.4 ✅
• @delorenj/mcp-server-trello — 1.7.1 ✅

2. Codex hand-wave w sekcji community MCPs

Dla ClickUp/Todoist/Trello jest exact block dla Claude / Gemini / OpenCode, ale Codex zbywany jednym zdaniem:

Codex: add the equivalent [mcp_servers.flowhunt-clickup|todoist|trello] block in ~/.codex/config.toml.

Niespójne z poziomem szczegółu dla pozostałych agentów. Dopisałbym konkretny TOML np.:

[mcp_servers.flowhunt-clickup]
command = "npx"
args = ["-y", "@taazkareem/clickup-mcp-server@latest"]
env = { CLICKUP_API_KEY = "pk_...", CLICKUP_TEAM_ID = "12345678", DOCUMENT_SUPPORT = "true" }

3. Scope creep — z 2 komend na 7

Pierwotnie skill miał dwie komendy: setup + audit. PR dodaje pięć: status, quick-audit, dry-run, config, diff. Każda osobno ma sens, ale razem to przeskakujesz z minimalistycznego „agent IS the LLM, dwie komendy" do kubectl-style CLI.

Imho:

• status — keep, naprawdę przydatne
• quick-audit — keep, najniższy próg wejścia
• config — keep, bez tego edytowanie kontekstu wymagało re-runa setupu
• diff — keep, ale audit-diff.md (auto-diff przy każdym audycie) częściowo go dubluje, warto dograć jasny podział: auto-diff = inline section, flowhunt diff = standalone porównanie dwóch dat
• dry-run — zastanowiłbym się czy nie skonsolidować jako flowhunt audit --preview zamiast osobnej komendy. Mniej dispatchu w SKILL.md.

To decyzja produktowa @konradbachowski, nie blocker.

Minor

• 1879 linii w jednym PR-ze to dużo, ciężko zrobić atomic review. Na przyszłość warto split: refactor split / state file / nowe komendy.
• additional_accounts opisane jako „since v1.1" w audit-collect.md i config.md, ale v1.1 nie było releasowane (skok z 1.0 → 1.2). Drobiazg, ale spójnie powinno być „since v1.2".

Action items przed merge

• Poprawić abhiz123/todoist-mcp-server → @abhiz123/todoist-mcp-server w connectors/task-trackers.md (3 snippety)
• Dopisać exact [mcp_servers.*] TOML block dla Codex w sekcji community MCPs
• (opcjonalnie) Decyzja: zostawiamy wszystkie 5 nowych komend czy konsolidujemy dry-run jako flagę?
• (opcjonalnie) Wyrównać wzmianki o wersji w nowych plikach (v1.1 → v1.2)

Po poprawce paczki todoist można merge'ować, reszta to nice-to-have.