nodal-data/nodal-analytics
v1.6.0Apache-2.0
Plan, verify, and challenge analytics with governed, multi-source context and interview-built ground truth.
Changelog
1.6.0 — 2026-09-16
- Add ACF 0.2 nested AND/OR filters, per-entity eligibility conditions, and same-file metric references with inherited lineage.
- Validate measure grammar, reference cycles and dimension subsets; optionally check lineage columns against local dbt manifests.
- Update authoring guidance, draft worked examples, and generated scaffolds.
1.5.4 — 2026-09-09
- Add the portable Agent Plugins manifest and production-ready Nodal logo for OpenAI's universal plugin directory while retaining Codex and Claude compatibility manifests.
- Add public privacy, terms, and support pages for the open-source plugin.
- Add OpenAI listing copy, release notes, starter prompts, and reproducible reviewer cases for a skills-only submission.
1.5.3 — 2026-09-09
- Require a fresh progress line immediately before every interview question, including selection-tool calls, follow-ups, and verification prompts.
- Reinforce the question loop across full interviews and test drives, retain visible progress when counts need rebuilding, and keep remaining estimates scoped to the domain round across stage transitions.
1.5.2 — 2026-09-08
- Show a combined text progress indicator during full interviews and test drives, with the current stage, answered questions or completed core topics, and an adaptive estimate of remaining questions.
- Explain added follow-ups, keep deferred topics outside the quick-test budget, and show live-verification progress separately from interview questions.
1.5.1 — 2026-09-04
- Add a shipped Sigma dashboard-verification playbook with explicit organization, workbook, and page resolution for multi-workbook deployments.
- Capture Sigma workbook/page identity, version, controls, resolved date state, and partial-filter limitations alongside each page-scoped result.
- Define safe tiered extraction for Sigma network payloads, visible elements, and local on-demand exports without credentials, scheduled delivery, or writeback.
1.5.0 — 2026-09-03
- Add opt-in isolated host-state testing with a fresh Codex home or Claude bare mode while preserving the existing clean-project default.
- Launch interactive Codex clean-room tests with the required
workspace-writesandbox so the sibling context repository is accepted as a writable root. - Install local or Git-ref Codex marketplace snapshots inside the isolated home and support authenticate-then-launch prepared rooms without copying secrets.
- Capture non-interactive transcripts and add a browser-install lifecycle scenario that checks configured state, restart and approval guidance, and suppression of repeated installation offers.
- Add a public agent onboarding guide and an isolated pre-install scenario that
verifies one-distribution installation, consent boundaries, and the new-task
handoff to
setup-nodal. - Document the separate macOS-account or VM smoke test required for faithful Codex Desktop, browser, approval, and restart coverage.
1.4.0 — 2026-09-02
- Clarify the current technical operator and domain-expert audiences, including enterprise adoption through verified domain-by-domain rollout.
- Separate representative evaluation from production onboarding and document optional automated dashboard verification before browser consent.
- Persist browser intent as ask-when-needed, manual, or automated; suppress repeated installation offers and distinguish a required restart from a missing binding.
- Clarify how Nodal's active interview, evidence, and human confirmation differ from passive documentation generation.
- State explicitly that the open-source package sends no data or credentials to Nodal, and distinguish it from the separate paid, opt-in hosted path.
1.3.0 — 2026-08-27
- Add read-only query-history visibility probes and document permissions, retention windows, degraded modes, and privacy caveats for Snowflake, BigQuery, and Redshift.
- Add product and context-validation diagrams covering the interview, governed answer, dashboard verification, and enterprise learning loops.
- Strengthen the five-question test drive and dashboard-validation handoff, including filter-aware captures and human-read fallback behavior.
1.2.0 — 2026-08-27
- Add
challenge-resultfor user-requested skeptical second reviews of completed analytics answers. - Add context-isolated and structured same-context challenge modes that test both the reported number and the user's expectation without treating either as ground truth.
- Add
UPHELD,REPLAN, andINCONCLUSIVEoutcomes with assumption and hypothesis ledgers, bounded read-only diagnostics, and escalation gates. - Route material corrections back through
analytics-planso a revised plan receives fresh approval before any new execution.
1.1.0 — 2026-08-27
- Add
analytics-planas the single plan-before-query workflow across ACF, KTX, dbt, local documentation, approved documentation MCPs, and warehouse evidence. - Add an auditable, explicitly uncalibrated uncertainty v0 with expert-escalation gates before and after execution.
- Add
verify-resultfor plan-fidelity, grain/join, and plausibility review. - Add
analyst-handoffas a transition-focused orchestrator overcontext-interview. - Replace generated
data-questionwith the universalanalytics-plan; generated context repos remain directly consumable throughAGENTS.mdandCLAUDE.md. - Extend
.nodal.local.jsonwith classified local and MCP context sources while continuing to reject secrets and raw connection errors.
1.0.0
- Package
context-interview,dashboard-verify, and explicit-onlysetup-nodalfor Claude, Codex, and skills.sh installation. - Add the manifest-driven, hash-checked context scaffold distribution mirror.
- Add guarded project-local configuration and consent-based browser binding setup.
- Preserve clone-and-run development and generated-repository workflows.
- Add a tracked, non-destructive clean-room integration harness while keeping operator briefs, connection configuration, and permissions local.
Release checklist
- Run
python3 scripts/sync_skill_payload.py --checkand all tool CI locally. - Install from a temporary checkout with Claude; confirm all seven namespaced skills and bundled hidden files/scripts are present.
- Install from a temporary checkout with Codex; list the available plugin and confirm all seven skills load.
- Install into a temporary project with
npx skills@latest add; confirm scripts, executable modes,.claude,.gitignore, and.gitkeepsurvive. - Invoke setup in each native host, confirm
.nodal.local.json, and consent to a test.mcp.jsonmerge without overwriting an existing binding. - With authenticated read-only connections, run all three capability probes.
- Complete a
context-interviewtest drive against a temporary context repo. - Exercise
analytics-planagainst ACF, KTX, and an approved documentation MCP; verify an evidence conflict produces a clarification and escalation. - Run
verify-resultagainst a missing mandatory filter and a fanout fixture. - Run
challenge-resultagainst an upheld answer, a material time/filter defect that producesREPLAN, and a missing-evidence case that producesINCONCLUSIVE; confirm no revised SQL runs before approval. - Complete an
analyst-handoffdomain and confirm it emits eval seeds. - Run the tracked clean-room harness against the source checkout, installed Claude and Codex plugins, and a temporary skills.sh installation; complete its resume check and generated-repository assertions.
- Install the Codex plugin in a fresh isolated host home and run the
browser-install-lifecyclescenario against both the local release candidate and its Git release ref. - Run
agent-guided-onboardingfrom an empty isolated Codex home, then paste the public agent-guide prompt into the clean Desktop smoke-test account. - From a separate macOS user or restored VM snapshot, smoke-test Codex Desktop installation, project-server approval, browser launch, and the post-install restart path.
- Invoke
dashboard-verifyagainst an authenticated dashboard and reconcile at least one value and filter window. - Confirm repository and isolated installed-skill scaffold smoke tests pass.
- Bump plugin semver for every published package change and add release notes.