Skip to content

plugin(caelestia-assistant): 07/12 natural-language settings capability (ladybug-me/caelestia-kde#120) - #12

Merged
ladybug-me merged 10 commits into
caelestia-kde:staging/caelestia-assistantfrom
0x0nYx:plugin/caelestia-assistant/07-settings
Oct 24, 2026
Merged

ladybug-me merged 10 commits into
caelestia-kde:staging/caelestia-assistantfrom
0x0nYx:plugin/caelestia-assistant/07-settings

Conversation

@0x0nYx

@0x0nYx 0x0nYx commented Oct 9, 2026

Copy link
Copy Markdown
Contributor

What does this PR do?

Part 7/12 of the caelestia-assistant migration. Adds the natural-language settings capability that motivates the plugin (see caelestia-kde/caelestia#120).

Plugin

  • id (folder name): caelestia-assistant
  • name: Caelestia Assistant
  • version: 0.1.0
  • type: quickshell
  • license (SPDX): GPL-3.0-or-later

What this part contains

33 files, +11,362 lines, all under assistant/capabilities/settings/:

  • Registry: the frozen tool registry over the shell's settings schema (build_registry.py, catalog.py, enumerate.py, curations.py).
  • Plan and apply: parser, planner, and an applier with bounded undo.
  • Quality of life: presets, profiles, wizard, lint.
  • Reasoning aids: causal.py (why-chains), consequences.py, accessibility.py.
  • Surfaces: CLI (cli.py, __main__.py) and a D-Bus surface (dbus_surface.py).

The flow is propose, then approve or reject: the capability produces a plan and the user confirms before anything is applied.

Stack

  • Builds on plugin/caelestia-assistant/06-diagnostics (part 6).
  • Review only this increment: 06...07.
  • Next: plugin/caelestia-assistant/08-brain.
  • Linear stack of 12; each PR targets main, so its diff is cumulative until earlier parts merge. Please use merge commit or rebase-and-merge (not squash).
  • Part 4's module-level imports of settings resolve from this part onward.

Provenance and verification

  • Byte-identical copy of 0x0nYx/caelestia-assistant@2c193e7 (v0.1); sha256-verified in the migration audit recorded in the commit message.
  • scripts/check_safety.py: 0 errors on this tip.
  • scripts/validate.py: OK (run on the final 12/12 tip; every earlier tip is a strict subset of it).
  • GPL-3.0-or-later; no AGPL text or headers.

Checklist

  • The plugin lives in its own folder under plugins/caelestia-assistant/ and the folder name equals the id in metadata.json
  • metadata.json is valid JSON and passes python scripts/validate.py
  • A LICENSE file is included in the plugin folder
  • No compiled binaries or archives are included (source-only policy)
  • version follows semver and was bumped for updates (new plugin: 0.1.0)
  • For deprecations: not applicable (new plugin)
  • I have reviewed my plugin's code for safety and malicious behavior

0x0nYx added 8 commits October 9, 2026 12:13
The store's safety audit opts out per line, with a trailing
'caelestia-audit: allow-*' comment. That mechanism cannot express three
legitimate cases:

* JSON data artifacts - JSON has no comment syntax, so a marker would
  corrupt the data;
* flagged tokens inside docstrings or string vocabularies - appending a
  comment would change the string (and with it potentially pinned
  behavior);
* assertion-target strings in tests, where the banned pattern IS the
  assertion.

This adds a per-plugin `.caelestia-audit-ignore` file, parsed next to
metadata.json. Entries name a plugin-relative path, optionally restricted
to a line or inclusive line range, each with a '# reason' comment:

    assistant/data/index/bm25.json   # data artifact, not code
    src/verbs.py:120-132             # string vocabulary, not a call

Semantics are deliberately narrow:

* entries suppress HARD errors for exactly the listed paths/lines;
* the same-line 'caelestia-audit: allow-*' markers keep working and stay
  the preferred mechanism;
* soft warnings (shell-outs etc.) still surface - the file never hides
  them;
* unknown/typo'd paths in the file are inert, matching the store's
  warning-only posture for reviewable noise.

CONTRIBUTING.md documents the mechanism next to the existing opt-out
rule. First consumer: the caelestia-assistant plugin migration, whose
safety-classification vocabularies and built index artifacts trip the
regex scanner as text, not behavior.
…ion chunk 1/12)

Introduces the caelestia-assistant plugin folder: the store manifest (type quickshell - the plugin ships real Quickshell QML surfaces), GPL-3.0-or-later license, plugin README (upstream README + store header), upstream packaging and repo-meta files, the package root, the launcher, and the adapters layer (frozen settings-tool registry + the shell integration QML surfaces). Adapters land first because every later layer imports them.

Chunk contents (14 files):
- .github/workflows/ci.yml
- .gitignore
- CONTRIBUTING.md
- LICENSE
- assistant/__init__.py
- assistant/adapters/__init__.py
- assistant/adapters/caelestia/__init__.py
- assistant/adapters/caelestia/registry.py
- assistant/adapters/caelestia/shell/modules/sidebar/AiAssistant.qml
- assistant/adapters/caelestia/shell/services/CommandGate.qml
- assistant/adapters/caelestia/shell/services/SettingsTools.qml
- assistant/adapters/caelestia/tools.json
- ... and 2 more

Source: 0x0nYx/caelestia-assistant@2c193e7 (main, v0.1)
Faithfulness: byte-identical copy (sha256-verified in the migration
audit; only metadata.json / README.md are plugin-store scaffolding,
and .caelestia-audit-ignore documents scanner false positives).
Safety audit: 0 errors; 14 line-level findings documented in .caelestia-audit-ignore (string vocabularies / rulepack prose / test assertion targets / opt-in provider calls - nothing executes).
Store CI: validate.py OK - check_safety.py OK - check_scope.py OK.

Next chunk: plugin/caelestia-assistant/02-capability-foundation
…w, issues, scan (migration chunk 2/12)

Zero-dependency capability tier: the capability package marker, its manifest registry, and the guard (memory pressure), dedupe, devflow, issues and scan capabilities. These import only the capability package itself, so they form a self-consistent stratum. (graph/ lands later: its query layer imports genius.)

Chunk contents (26 files):
- assistant/capabilities/__init__.py
- assistant/capabilities/_registry.py
- assistant/capabilities/dedupe/__init__.py
- assistant/capabilities/dedupe/manifest.py
- assistant/capabilities/dedupe/scan.py
- assistant/capabilities/devflow/__init__.py
- assistant/capabilities/devflow/__main__.py
- assistant/capabilities/devflow/diffstat.py
- assistant/capabilities/devflow/manifest.py
- assistant/capabilities/devflow/risk.py
- assistant/capabilities/devflow/todo.py
- assistant/capabilities/guard/__init__.py
- ... and 14 more

Source: 0x0nYx/caelestia-assistant@2c193e7 (main, v0.1)
Faithfulness: byte-identical copy (sha256-verified in the migration
audit; only metadata.json / README.md are plugin-store scaffolding,
and .caelestia-audit-ignore documents scanner false positives).
Safety audit: 0 errors; 14 line-level findings documented in .caelestia-audit-ignore (string vocabularies / rulepack prose / test assertion targets / opt-in provider calls - nothing executes).
Store CI: validate.py OK - check_safety.py OK - check_scope.py OK.

Next chunk: plugin/caelestia-assistant/03-core-nlu-foundation
…arners, vectorization (migration chunk 3/12)

The core engine's NLU foundation: lexicon and phonetics, confusables, concepts, context, features, corpus/FTS store, conformal/abers/adwin learners, CRF/slot taggers, vectorization. Everything above imports these primitives.

Chunk contents (25 files):
- assistant/core/__init__.py
- assistant/core/abers.py
- assistant/core/adwin.py
- assistant/core/concepts.py
- assistant/core/conformal.py
- assistant/core/confusable_pairs.json
- assistant/core/confusables.py
- assistant/core/conservative.py
- assistant/core/context.py
- assistant/core/corpus.py
- assistant/core/crf_tagger.py
- assistant/core/dp.py
- ... and 13 more

Source: 0x0nYx/caelestia-assistant@2c193e7 (main, v0.1)
Faithfulness: byte-identical copy (sha256-verified in the migration
audit; only metadata.json / README.md are plugin-store scaffolding,
and .caelestia-audit-ignore documents scanner false positives).
Safety audit: 0 errors; 14 line-level findings documented in .caelestia-audit-ignore (string vocabularies / rulepack prose / test assertion targets / opt-in provider calls - nothing executes).
Store CI: validate.py OK - check_safety.py OK - check_scope.py OK.

Next chunk: plugin/caelestia-assistant/04-core-cortex-eval
…d executor (migration chunk 4/12)

The rest of the core: cortex pipeline, router, dispatch, plans, schedules, inbox, personalization, refit, reranker, NL history, telemetry, the eval arena (dev/sealed sets) and the typed executor (argv-only, timeout-bounded plan runner). Note: dispatch and pipeline import the brain/settings capabilities at module level (upstream's own coupling); those imports resolve from chunks 07/08 onward.

Chunk contents (42 files):
- assistant/core/ask_pipeline.py
- assistant/core/cli.py
- assistant/core/coldstart.py
- assistant/core/compound.py
- assistant/core/coref.py
- assistant/core/delegate.py
- assistant/core/dispatch.py
- assistant/core/encoder_onnx.py
- assistant/core/engine_telemetry.py
- assistant/core/ensemble.py
- assistant/core/eval/__init__.py
- assistant/core/eval/__main__.py
- ... and 30 more

Source: 0x0nYx/caelestia-assistant@2c193e7 (main, v0.1)
Faithfulness: byte-identical copy (sha256-verified in the migration
audit; only metadata.json / README.md are plugin-store scaffolding,
and .caelestia-audit-ignore documents scanner false positives).
Safety audit: 0 errors; 14 line-level findings documented in .caelestia-audit-ignore (string vocabularies / rulepack prose / test assertion targets / opt-in provider calls - nothing executes).
Store CI: validate.py OK - check_safety.py OK - check_scope.py OK.

Next chunk: plugin/caelestia-assistant/05-data-corpus
…ifact (migration chunk 5/12)

Local data tier: troubleshooting corpus, resolved-issue corpus, architecture docs, mined synonyms, paraphrase candidates and the built BM25 index artifact. Data only; no code imports it at module load (retrieval consumes it lazily).

Chunk contents (45 files):
- assistant/data/__init__.py
- assistant/data/corpus/DOC-ARCH-KWIN.md
- assistant/data/corpus/DOC-ARCH-LOCKSCREEN.md
- assistant/data/corpus/DOC-ARCH-SHORTCUT.md
- assistant/data/corpus/DOC-README.md
- assistant/data/corpus/DOC-TS-01.md
- assistant/data/corpus/DOC-TS-02.md
- assistant/data/corpus/DOC-TS-03.md
- assistant/data/corpus/DOC-TS-04.md
- assistant/data/corpus/DOC-TS-05.md
- assistant/data/corpus/DOC-TS-06.md
- assistant/data/corpus/DOC-TS-07.md
- ... and 33 more

Source: 0x0nYx/caelestia-assistant@2c193e7 (main, v0.1)
Faithfulness: byte-identical copy (sha256-verified in the migration
audit; only metadata.json / README.md are plugin-store scaffolding,
and .caelestia-audit-ignore documents scanner false positives).
Safety audit: 0 errors; 15 line-level findings documented in .caelestia-audit-ignore (string vocabularies / rulepack prose / test assertion targets / opt-in provider calls - nothing executes).
Store CI: validate.py OK - check_safety.py OK - check_scope.py OK.

Next chunk: plugin/caelestia-assistant/06-diagnostics
…tion, forecasting (migration chunk 6/12)

The diagnostics capability: signed rulepacks (install/runtime/config_kde/known_regressions...), the diagnosis engine, rule rete, fusion, robust baselines, argumentation, forecast and telemetry.

Chunk contents (22 files):
- assistant/capabilities/diagnostics/__init__.py
- assistant/capabilities/diagnostics/argumentation.py
- assistant/capabilities/diagnostics/cli.py
- assistant/capabilities/diagnostics/drain.py
- assistant/capabilities/diagnostics/engine.py
- assistant/capabilities/diagnostics/forecast.py
- assistant/capabilities/diagnostics/fusion.py
- assistant/capabilities/diagnostics/manifest.py
- assistant/capabilities/diagnostics/rete.py
- assistant/capabilities/diagnostics/risk.py
- assistant/capabilities/diagnostics/robust_baseline.py
- assistant/capabilities/diagnostics/rulepack.py
- ... and 10 more

Source: 0x0nYx/caelestia-assistant@2c193e7 (main, v0.1)
Faithfulness: byte-identical copy (sha256-verified in the migration
audit; only metadata.json / README.md are plugin-store scaffolding,
and .caelestia-audit-ignore documents scanner false positives).
Safety audit: 0 errors; 36 line-level findings documented in .caelestia-audit-ignore (string vocabularies / rulepack prose / test assertion targets / opt-in provider calls - nothing executes).
Store CI: validate.py OK - check_safety.py OK - check_scope.py OK.

Next chunk: plugin/caelestia-assistant/07-settings
…egistry, planner, applier (migration chunk 7/12)

The natural-language settings capability (issue #120): the frozen tool registry over the shell's settings schema, parser, planner, applier with bounded undo, presets, profiles, wizard, lint and the D-Bus surface.

Chunk contents (33 files):
- assistant/capabilities/settings/__init__.py
- assistant/capabilities/settings/__main__.py
- assistant/capabilities/settings/accessibility.py
- assistant/capabilities/settings/applier.py
- assistant/capabilities/settings/build_registry.py
- assistant/capabilities/settings/catalog.py
- assistant/capabilities/settings/causal.py
- assistant/capabilities/settings/cli.py
- assistant/capabilities/settings/consequences.py
- assistant/capabilities/settings/curations.py
- assistant/capabilities/settings/dbus_surface.py
- assistant/capabilities/settings/enumerate.py
- ... and 21 more

Source: 0x0nYx/caelestia-assistant@2c193e7 (main, v0.1)
Faithfulness: byte-identical copy (sha256-verified in the migration
audit; only metadata.json / README.md are plugin-store scaffolding,
and .caelestia-audit-ignore documents scanner false positives).
Safety audit: 0 errors; 36 line-level findings documented in .caelestia-audit-ignore (string vocabularies / rulepack prose / test assertion targets / opt-in provider calls - nothing executes).
Store CI: validate.py OK - check_safety.py OK - check_scope.py OK.

Next chunk: plugin/caelestia-assistant/08-brain
@0x0nYx
0x0nYx marked this pull request as ready for review October 9, 2026 16:25
@0x0nYx
0x0nYx requested a review from 0xSolanaceae as a code owner October 9, 2026 16:25

@ladybug-me ladybug-me left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Settings Registry Upstream Synchronization:
In build_registry.py:24, REPO_COMMIT is pinned to 70ee7da115fde9012e28e393c73d274f55bd2dd7. Please re-run python -m assistant.capabilities.settings.build_registry against the active caelestia-kde tree (c72ef2ee) so tools.json and registry.py capture current Nexus configuration properties.

@0xSolanaceae
0xSolanaceae removed their request for review October 17, 2026 19:55
@ladybug-me
ladybug-me changed the base branch from main to staging/caelestia-assistant October 24, 2026 09:41

@ladybug-me ladybug-me left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rebuilt the mapping according to latest dev commit

@ladybug-me
ladybug-me merged commit 51fe22a into caelestia-kde:staging/caelestia-assistant Oct 24, 2026
1 check passed
@0x0nYx
0x0nYx deleted the plugin/caelestia-assistant/07-settings branch October 24, 2026 11:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants