Repository navigation
plugin(caelestia-assistant): 07/12 natural-language settings capability (ladybug-me/caelestia-kde#120) - #12
Merged
ladybug-me merged 10 commits intoOct 24, 2026
Conversation
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
ladybug-me
requested changes
Oct 17, 2026
ladybug-me
left a comment
Collaborator
There was a problem hiding this comment.
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.
ladybug-me
approved these changes
Oct 24, 2026
ladybug-me
left a comment
Collaborator
There was a problem hiding this comment.
Rebuilt the mapping according to latest dev commit
ladybug-me
merged commit Oct 24, 2026
51fe22a
into
caelestia-kde:staging/caelestia-assistant
1 check passed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What does this PR do?
Part 7/12 of the
caelestia-assistantmigration. Adds the natural-language settings capability that motivates the plugin (see caelestia-kde/caelestia#120).Plugin
caelestia-assistant0.1.0quickshellGPL-3.0-or-laterWhat this part contains
33 files, +11,362 lines, all under
assistant/capabilities/settings/:build_registry.py,catalog.py,enumerate.py,curations.py).causal.py(why-chains),consequences.py,accessibility.py.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
plugin/caelestia-assistant/06-diagnostics(part 6).plugin/caelestia-assistant/08-brain.main, so its diff is cumulative until earlier parts merge. Please use merge commit or rebase-and-merge (not squash).settingsresolve from this part onward.Provenance and verification
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).Checklist
plugins/caelestia-assistant/and the folder name equals theidinmetadata.jsonmetadata.jsonis valid JSON and passespython scripts/validate.pyLICENSEfile is included in the plugin folderversionfollows semver and was bumped for updates (new plugin:0.1.0)