Skip to content

Local code intelligence for developers and AI agents. Connect code, docs and infrastructure in a persistent graph, with CBM Lens, MCP tools, agent integrations and change-aware test selection.

5.0 KB
Raw Blame
/**
 * Die Befehle, die die Kommandozeile ausser Suchen und Fragen kennt.
 *
 * ## Warum es sie gibt
 *
 * AC3 des W8-Contracts verlangt einen Weg zurueck, der in EINEM Schritt geht:
 * wer sich mit vier Griffen ein Layout gebaut hat, das er nicht mehr mag, soll
 * nicht vier Doppelklicks suchen muessen. Seit W10 steht `settings` daneben, aus
 * demselben Grund: das Einstellungen-Panel ist die Stelle, an der ein Leser mit
 * einer schwachen Maschine die teuren Effekte abschaltet, und es ueber ein
 * Menuekuerzel allein erreichbar zu machen hiesse, es hinter einer Taste zu
 * verstecken, die man kennen muss. Seit W11a steht `live agents` daneben, und dort ist der Grund noch
 * schaerfer: der Live-Modus ist per Vorgabe AUS, und ein Modus, den man nur
 * ueber ein Menuekuerzel findet, ist fuer den, der das Kuerzel nicht kennt, gar
 * nicht da. Alle drei gibt es darum zweimal, im Menue und in der Zeile, und
 * beide Wege rufen dieselbe Funktion.
 *
 * ## Warum die Erkennung hier steht und nicht in commandIntent
 *
 * `src/chat/command-intent.ts` beantwortet eine andere Frage, naemlich ob eine
 * Zeile eine Suche oder eine Frage an das Modell ist. Ein Befehl ist keins von
 * beidem, und ihn dort einzubauen hiesse, die Prioritaetsregel jenes Moduls
 * anzufassen ("die Suche behaelt den Vortritt"), die auf einem Nutzerbefund
 * beruht. Er wird darum VOR jener Frage geprueft, an einer eigenen Stelle, die
 * genau drei Zeilen kennt.
 *
 * Drei Befehle an einer Stelle und nicht an dreien: die Frage "ist diese Zeile
 * ein Befehl" wird einmal beantwortet, mit einer Normalisierung und einem
 * Vergleich. Drei Module mit je einer Zeile waeren drei Normalisierungen, die
 * auseinanderlaufen koennen.
 *
 * ## Warum die Erkennung so eng ist
 *
 * Nur `reset layout`, `settings` und `live agents`, ohne Gross-/Kleinschreibung und ohne
 * doppelte Leerzeichen. Kein Praefix, kein Teilwort, keine Abkuerzung. Der Grund
 * ist derselbe wie beim Fragezeichen in command-intent.ts: diese Zeile sucht
 * auch, und jede Unschaerfe hier ist eine Suche, die stattdessen das Layout
 * umbaut oder ein Panel aufschlaegt. "reset" allein ist ein Wort, nach dem
 * jemand suchen wird; "reset layout" ist keins.
 *
 * `settings` ist ein einzelnes Wort und damit der engere Fall von beiden. Es ist
 * trotzdem vertretbar, und der Grund ist messbar: dieses Produkt sucht Symbole
 * eines indizierten Repositories, und ein Symbol heisst `getSettings`,
 * `SettingsPanel` oder `settingsStore`, aber nicht `settings` allein; die Suche
 * greift ausserdem ab zwei Zeichen und zeigt ihre Treffer, waehrend getippt
 * wird, also sieht ein Leser, der wirklich sucht, seine Treffer schon vor dem
 * achten Buchstaben. Wer die Zeile trotzdem abschickt, bekommt das Panel und
 * schliesst es mit Escape.
 */

import { experimentalAgentsEnabled } from '../app/feature-flags';

/** Was diese Zeile ist, soweit dieses Modul es beurteilt. */
export type LineCommand =
    | 'reset-layout'
    | 'open-settings'
    | 'toggle-live-agents'
    | 'toggle-fullscreen'
    | 'none';

/** Die Zeile, die das Layout zuruecksetzt. Woertlich, damit die Hilfe sie zeigen kann. */
export const RESET_LAYOUT_COMMAND = 'reset layout';

/** Die Zeile, die das Einstellungen-Panel aufschlaegt. */
export const SETTINGS_COMMAND = 'settings';

/**
 * Die Zeile, die den Live-Modus der Agenten umlegt (W11a).
 *
 * Zwei Woerter und nicht eines, aus demselben Grund wie bei "reset layout":
 * "agents" allein waere ein Wort, nach dem jemand sucht, "live agents" ist
 * keins. Sie SCHALTET und oeffnet nicht nur, weil der Modus zwei Lagen hat und
 * eine Zeile, die nur einschalten kann, den Weg zurueck an das Menue abgibt.
 */
export const LIVE_AGENTS_COMMAND = 'live agents';

/**
 * Die Zeile, die das Vollbild des Graphen umlegt (W11b).
 *
 * Sie heisst `fullscreen` und nicht `cinema`, und das ist keine Kosmetik: der
 * Nutzer hat den Modus am 2026-08-30 benutzt und woertlich gesagt, "bin jetzt
 * im cinema mode, sollte fullscreen heissen". Ein Schalter, der in der
 * Oberflaeche anders heisst als in der Zeile, waere zwei Namen fuer eine Sache.
 *
 * Ein einzelnes Wort, also der engere Fall, dieselbe Abwaegung wie bei
 * `settings`: ein Symbol heisst `toggleFullscreen` oder `FullscreenButton`,
 * aber nicht `fullscreen` allein, und wer wirklich sucht, sieht seine Treffer
 * schon beim Tippen. Der Modus haengt am Live-Modus der Agenten (er ist der
 * Rahmen JENER Ansicht); ist der aus, schaltet diese Zeile ihn mit an, statt
 * still nichts zu tun.
 */
export const FULLSCREEN_COMMAND = 'fullscreen';

/** Ob diese Zeile einer der vier Befehle ist. */
export function lineCommandOf(line: string, agentsEnabled = experimentalAgentsEnabled): LineCommand {
    const normalised = line.trim().toLowerCase().replace(/\s+/g, ' ');
    if (normalised === RESET_LAYOUT_COMMAND) {
        return 'reset-layout';
    }
    if (normalised === SETTINGS_COMMAND) {
        return 'open-settings';
    }
    if (agentsEnabled && normalised === FULLSCREEN_COMMAND) {
        return 'toggle-fullscreen';
    }
    return agentsEnabled && normalised === LIVE_AGENTS_COMMAND ? 'toggle-live-agents' : 'none';
}