Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,19 @@
# Changelog

## 1.0.2 — October 30, 2026

- Compile eligible larger fresh SPL boards from a shared-source plan with explicit page membership, native bindings and destination-local row navigation. Keep the existing search and recovery budgets.
- Reuse compatible stats and identically bucketed timechart outputs without changing aliases, missing-value populations or explicit consumer projections.
- Remove unused model search declarations before dispatch, and reject overall KPI bindings to a grouped summary's last row.
- Separate basic larger Ollama/AITK source planning from page composition, combining compatible recipes and binding the second internal step to verified output fields within the existing recovery budget.
- Compute repeated aggregates once and retain their aliases through value copies. Keep one exact reference definition in focused repairs and expose explicitly named table additions after output verification.
- Compile unambiguous named numeric aggregate additions on selected ordinary tables locally, cloning shared sources and retaining all search/output validation. Ambiguous or compound requests retain model authoring.
- Validate numeric chart axes, both network endpoint sets and node-array alignment against actual output. Revalidate unchanged chain descendants when their parent changes.
- Give newly created stats-backed single values non-temporal display defaults and bounded precision for verified fractions, preserving explicit options and existing native work.
- Retain the general authoring path for requests outside the bounded initial planner; reject unavailable native chart families before inference.

- Qualify three eight-page, 24-chart creation/editing cycles per provider with ordinary authors, plus focused browser edits, native saves, cancellation and calculation probes. See [validation](docs/validation.md#102--october-30-2026).

## 1.0.1 — October 30, 2026

- Preview the active page's chart and input sources, including global inputs and auxiliary chart aliases, within the existing search limits. Resolve chain/report ancestry and cancel obsolete page work without changing native definitions.
Expand Down
18 changes: 9 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

Create and edit **Splunk Dashboard Studio** dashboards through a conversation beside a live canvas. Choose data your Splunk account can search, refine a selected chart or input, and save a normal native Studio dashboard.

**Version 1.0.1** · [Download](https://github.com/LeiterConsulting/constellation/releases/tag/v1.0.1) · [User guide](docs/user-guide.md) · [Documentation](docs/README.md)
**Version 1.0.2** · [Download](https://github.com/LeiterConsulting/constellation/releases/tag/v1.0.2) · [User guide](docs/user-guide.md) · [Documentation](docs/README.md)

**New in 1.0.1:** previews follow the active page, reuse fresh results and cancel obsolete work. Draft-save receipts distinguish uncertain delivery from genuine conflicts. [Release evidence](docs/validation.md#101--october-30-2026) records the bounded three-provider checks.
**New in 1.0.2:** shared-search planning for larger multi-page dashboards, stronger native chart bindings and verified additions to selected tables. The existing validation and recovery limits remain in place. [Release evidence](docs/validation.md#102--october-30-2026) records nine repeated ordinary-author flows across all three providers.

## Start here

Expand Down Expand Up @@ -35,13 +35,13 @@ Constellation runs inside Splunk. It does not require a separate agent service o

| File | Purpose |
| --- | --- |
| [Installable app](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.1/constellation-1.0.1.tar.gz) | Install or update through Splunk app management. |
| [App and documentation bundle](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.1/constellation-1.0.1-handoff.zip) | The same app, user guide, screenshots and administrator/reference material. |
| [User guide · Markdown](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.1/constellation-1.0.1-user-guide.md) | Standalone guide text. The bundle includes its local images. |
| [User guide · PDF](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.1/constellation-1.0.1-user-guide.pdf) | Illustrated guide for reading or printing. |
| [MIT license](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.1/LICENSE) | First-party license accompanying the app and documentation. |
| [Dependency notices](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.1/constellation-1.0.1-third-party-notices.zip) | Upstream notices, also embedded in the app and included in the handoff. |
| [SHA256SUMS](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.1/SHA256SUMS) | Verify every release download. |
| [Installable app](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.2/constellation-1.0.2.tar.gz) | Install or update through Splunk app management. |
| [App and documentation bundle](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.2/constellation-1.0.2-handoff.zip) | The same app, user guide, screenshots and administrator/reference material. |
| [User guide · Markdown](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.2/constellation-1.0.2-user-guide.md) | Standalone guide text. The bundle includes its local images. |
| [User guide · PDF](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.2/constellation-1.0.2-user-guide.pdf) | Illustrated guide for reading or printing. |
| [MIT license](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.2/LICENSE) | First-party license accompanying the app and documentation. |
| [Dependency notices](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.2/constellation-1.0.2-third-party-notices.zip) | Upstream notices, also embedded in the app and included in the handoff. |
| [SHA256SUMS](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.2/SHA256SUMS) | Verify every release download. |

## Supported scope

Expand Down
4 changes: 2 additions & 2 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Before changing repository visibility, use the [publication review](publication-review.md). Upstream attribution sources are recorded in [dependency notices](../third_party/README.md).

Choose a path by what you need to do. These guides describe **Constellation 1.0.1**; historical records are kept separately.
Choose a path by what you need to do. These guides describe **Constellation 1.0.2**; historical records are kept separately.

## Use Constellation

Expand All @@ -13,7 +13,7 @@ Choose a path by what you need to do. These guides describe **Constellation 1.0.
5. [Save a native dashboard](user-guide.md#use-the-result-in-splunk).
6. [Move artwork and dependencies](assets-and-portability.md).

The [illustrated user guide](user-guide.md) covers the complete workflow. Download its [PDF edition](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.1/constellation-1.0.1-user-guide.pdf) for offline reading.
The [illustrated user guide](user-guide.md) covers the complete workflow. Download its [PDF edition](https://github.com/LeiterConsulting/constellation/releases/download/v1.0.2/constellation-1.0.2-user-guide.pdf) for offline reading.

[Glossary](glossary.md) explains draft, native copy, scope, token and snapshot.

Expand Down
12 changes: 12 additions & 0 deletions docs/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,8 @@ Paths below are under the Python app bin directory or src as appropriate.
| Provider transport/messages | provider_service.py, provider_adapters.py, provider_messages.py | Native API formats, fixed/guarded endpoints, controlled errors |
| Model capability/workload | model_capabilities.py, model_readiness.py, authoring_budget.py | Unknown capacity stays unknown; unsupported files fail before inference |
| Native definition and intent | studio_contract.py, native_options.py, native_bindings.py, authoring_intent.py | Preserve unknown/unrelated work; gate new unsupported behavior |
| Larger initial boards | dashboard_plan.py, board_batches.py, planning_sources.py, native_builders.py | Explicit page membership, shared compatible outputs, bounded expansion and verified native bindings |
| Exact table edits | table_sort.py, table_aggregates.py, table_projection.py | Narrow literal intent, verified numeric inputs/outputs, shared-source isolation and unchanged unrelated work |
| Source resolution and field evidence | source_service.py, data_service.py, token_service.py | Exact caller/report namespace, unresolved scope syntax, no result rows in model context |
| Guarded searches and lifecycle | search_service.py, preview_jobs.py, population_guard.py, measurement_constraints.py | Read-only subset, bounded current-user jobs, explicit partial evidence |
| Drafts/history/management | draft_service.py, draft_migrations.py, dashboard_library.py, draft_history.py | Ownership, revisions, no future-schema rewrite, recoverable deletion |
Expand All @@ -35,6 +37,16 @@ Paths below are under the Python app bin directory or src as appropriate.

The [design notes](reference/design-notes.md) and [upgrade contracts](reference/upgrade-contracts.md) retain detailed compiler strategies and versioned invariants. Verify actual module names when changing a boundary.

Version 1.0.2 adds a provider-neutral plan for eligible empty, inspected SPL canvases with explicit larger page/panel counts. The model chooses calculations and page membership; the compiler constructs native geometry, field bindings, shared searches and destination-local row navigation. The complete expansion must fit eight pages, 24 panels and eight affected sources, including filtered clones and network node dependencies. These are initial-plan bounds, not limits on imported native documents. Unsupported complex requests retain the general authoring path.

Compatible typed stats recipes and timecharts can share a search only when their grouping, time buckets and aggregate aliases agree and every consumer projects explicit fields. Only exact literal aggregate subsets of raw SPL can join the same verified recipe pool; complex pipelines, different bucket settings, split-series charts, all-fields tables and dynamic frames are not merged. Unconsumed declarations in the new model plan are discarded before compilation or dispatch; every requested panel and every consumed output still passes the existing validators. Overall KPI cards cannot select the last row of a grouped summary; the basic batch path also excludes time buckets and raw rows for these cards. Route tokens avoid collisions with existing defaults and expressions. Measurement masks and all existing source, placement, intent and actual-output checks still apply. Rejected plans are repaired against the original blank document; accepted user work is never treated as disposable staging.

Native bindings select explicit output fields or, for an explicit split timechart, the actual numeric series after `_time`. Network charts share separate chains for source-column membership (including null-target rows for sink nodes) and aligned node styling, while other consumers retain the original edge weights. New stats-backed single values receive non-temporal display defaults; fractional verified values receive bounded display precision only when the user has not specified it. These corrections change presentation, not queries, indexed rows or existing elements.

For eligible larger basic aggregate requests through Ollama or AITK, a first internal call plans a recipe-only source pool. Compatible independent aggregates are combined before verification with the caller's searches. A second call composes pages against immutable source definitions and actual output-field choices; a source/field mismatch fails before final search validation. Only calculation definitions and field metadata pass to that call, without indexed rows. Both steps and any repair share the existing three-call, sixteen-query-check and elapsed-time admission budgets; no partial board is staged or saved. OpenAI and more complex native requests keep the single-plan path. Requests such as native table sparklines, which require richer formatting, retain general authoring.

Repeated aggregate expressions use one native specifier followed by alias copies, retaining every requested output name and null value. This avoids native timechart rejection of conflicting renames for the same calculation. Focused edit repairs carry one exact reference definition, alongside the original verified focused receipt and durable brief, rather than duplicate full dashboards. Explicitly named new table columns are exposed only after their actual outputs verify; existing columns, formatting and interactions remain intact.

## Authority and credentials

Main and control handlers use only the caller's session. Two separate handlers receive system authentication: opt-in shared AITK inference and owner-only OpenAI credential custody. Selecting an execution namespace does not reduce the system token's authority; fixed endpoint code and administrator-only policy are the privilege boundary.
Expand Down
6 changes: 6 additions & 0 deletions docs/documentation-review.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
# Documentation assessment and closeout

## 1.0.2 release edition — October 30, 2026

The README, current guides and release links identify 1.0.2 / build 62 and retain the exact lab-qualified app archive. The author guide adds concise examples for multi-page requests and calculated table columns. The validation record distinguishes repeated provider/API flows, operated browser checks, partial previews and separately labelled synthetic calculation probes. Historical evidence and screenshot provenance remain unchanged.

The PDF is regenerated from this edition of the Markdown guide, rendered and visually inspected before distribution. The release includes matching Markdown/PDF guides, the offline handoff, MIT license, dependency notices and checksums.

## 1.0.1 release edition — October 30, 2026

The README, documentation index, installation/upgrade steps, author guide and troubleshooting now describe 1.0.1, active-page preview bounds and save-conflict diagnosis. Release links and the app checksum identify build 61; the app retains the exact bytes used for the recorded patch qualification. Historical 1.0.0 evidence remains dated separately.
Expand Down
8 changes: 4 additions & 4 deletions docs/installation.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Install Constellation

This guide is for Splunk administrators installing **1.0.1**. Authors can start with the [user guide](user-guide.md) once installation and provider access are ready.
This guide is for Splunk administrators installing **1.0.2**. Authors can start with the [user guide](user-guide.md) once installation and provider access are ready.

## Check the deployment

Expand All @@ -17,16 +17,16 @@ Node/npm and a separate Python installation are **not required to install the re

## Download and verify

Get the app, **LICENSE**, **third-party-notices ZIP** and **SHA256SUMS** from [release v1.0.1](https://github.com/LeiterConsulting/constellation/releases/tag/v1.0.1). Install the app archive inside the documentation ZIP, or download the standalone tar.gz.
Get the app, **LICENSE**, **third-party-notices ZIP** and **SHA256SUMS** from [release v1.0.2](https://github.com/LeiterConsulting/constellation/releases/tag/v1.0.2). Install the app archive inside the documentation ZIP, or download the standalone tar.gz.

~~~sh
shasum -a 256 constellation-1.0.1.tar.gz
shasum -a 256 constellation-1.0.2.tar.gz
~~~

Compare the digest with its line in SHA256SUMS. The qualified app digest is:

~~~text
8f875e0a204630589df32c1bec8b8d4e6e4d50d49fd01b6951c38617b4b79515
7df2620bb442ac4617f46cae677c29af1719d99984e5cddb010eb461288958fc
~~~

First-party code and documentation use the [MIT License](../LICENSE). The app embeds it and the collected [dependency notices](../third_party/README.md). Both are also supplied beside the installer and inside the handoff bundle; keep them with redistributed copies.
Expand Down
1 change: 1 addition & 0 deletions docs/studio-support.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,7 @@ Search-result completion is not proof of analytical correctness. New actual-data
| Ordinary preview in 1.0.1 | 200 rows / five seconds per query / eight consumer sources on the active page, including global/page inputs and chart aliases; chain/report ancestry resolves within each guarded request |
| Preview windows | 15 minutes, one hour, 24 hours or seven days |
| Field inspection | Bounded current-user sample; wide/large events can reduce retained rows; missing fields are not proof of absence |
| Larger initial plan, 1.0.2 | Eligible empty inspected SPL boards: eight pages / 24 panels / eight expanded affected sources, including filtered clones and auxiliary sources. Unsupported complex requests use general authoring; imported boards retain their native structure. |
| Search freshness | Snapshots become stale after one minute; refresh for current results |
| Chat references | Two files / 4 MB each |
| Draft storage | 200 retained records including Trash/recovery; 11.5 MB snapshot bound |
Expand Down
2 changes: 2 additions & 0 deletions docs/upgrade-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,8 @@ Version 1.0.1 also retains schema 3 and portable format 5. Its optional save rec

## Verify after updating

Version 1.0.2 also retains schema 3, portable format 5 and the existing credential permissions. Larger initial-board planning requires no stored-document migration. Existing definitions and conversations are preserved. The [1.0.2 qualification](validation.md#102--october-30-2026) records the update checks separately from 1.0.1.

As an intended ordinary author:

1. Reopen a draft and its conversation, brief, page/input state and pending files.
Expand Down
6 changes: 5 additions & 1 deletion docs/user-guide.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Constellation user guide

Create a dashboard from a question and Splunk data, refine it through chat, and save a native Dashboard Studio copy. This guide describes version **1.0.1**.
Create a dashboard from a question and Splunk data, refine it through chat, and save a native Dashboard Studio copy. This guide describes version **1.0.2**.

**Before you begin:** Constellation must be installed in Splunk, your account must be able to search the chosen data, and a provider must be configured. If **Settings** or **Test model** needs attention, follow [provider setup](providers.md) or ask your administrator.

Expand Down Expand Up @@ -29,6 +29,8 @@ Turn on **Select element** and choose an element on the canvas. Alternatively, e

> Change only this table: round latency to one decimal and keep its existing columns and row links.

For a calculated table column, name the measurement and the result you want. For example: “For only this selected table, add minimum and maximum latency columns named minimum_latency and maximum_latency alongside its existing columns.” Use **Inspect fields** if a measurement name or unit is unclear. The app checks new columns against the returned search fields.

**Keep exploring** offers follow-on requests. Selecting one fills the composer; you can edit it before sending. A suggestion is a proposed next step, not proof of a relationship in the data.

Choose **Float** to move the conversation over the canvas, **Dock** to return it beside the canvas, or **Hide** to collapse it. **Show conversation** opens it again.
Expand All @@ -55,6 +57,8 @@ Explain recorded units explicitly. A name hint is not evidence of a physical uni

Use **Pages** to add or rename a page and give it a purpose. Page purposes help organize the conversation; they do not create an access boundary.

When creating several pages, state their names, purposes and required charts together. For example: “Create Overview, Trends and Device detail, with three charts on each page.” Related charts can share searches; larger requests may take more than one internal planning step. Watch progress or use **Stop**; the board changes only after validation.

For linked pages, name the source, destination and filter:

> Create Overview and Service detail. Keep Overview unfiltered. Clicking a service in the summary should open Service detail filtered to that service. Add a return button to Overview.
Expand Down
Loading
Loading