glirastes 0.3.2 → 0.5.0

package/dist/codegen/tools/sources/ui-controls.js

@@ -0,0 +1,360 @@
+import ts from 'typescript';
+import { compareCodeUnits } from '../canonical.js';
+import { toolFinding } from '../findings.js';
+import { importBindings, importedName, uiDefinitionIdForAction } from './ui-tools.js';
+/**
+ * Stateful UI controls without a client action (concept
+ * `2026-10-28-ui-state-controls-concept.md`, option A). A control never
+ * becomes a tool here: the finding proposes the `useAiClientAction` the app
+ * adds where the state lives, and the `react-actions` source derives the tool
+ * from that registration on the next refresh.
+ */
+/** Text that makes a file worth parsing for controls. */
+export const CONTROL_TEXT = /createContext|next-themes/;
+/** Names that hint at a secret; such controls stay out of the chat. */
+const SECRET_NAME = /password|passwort|secret|token|api_?key|credential/i;
+function unwrap(expression) {
+    let current = expression;
+    while (ts.isParenthesizedExpression(current) || ts.isAsExpression(current)
+        || ts.isSatisfiesExpression(current) || ts.isNonNullExpression(current)) {
+        current = current.expression;
+    }
+    return current;
+}
+function resolved(app, symbol) {
+    return symbol && symbol.flags & ts.SymbolFlags.Alias ? app.checker.getAliasedSymbol(symbol) : symbol;
+}
+/** `UiSizeContext` → `ui-size`; `CompactModeContext` → `compact-mode`. */
+function kebab(name) {
+    return name.replace(/Context$/, '')
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
+        .toLowerCase();
+}
+/** A closed domain: a boolean or a union of at least two string literals. */
+function domainOf(type) {
+    if (type.flags & ts.TypeFlags.Boolean)
+        return [false, true];
+    if (!type.isUnion())
+        return undefined;
+    const values = [];
+    for (const member of type.types) {
+        if (!member.isStringLiteral())
+            return undefined;
+        values.push(member.value);
+    }
+    return values.length >= 2 ? [...new Set(values)].sort(compareCodeUnits) : undefined;
+}
+function literalText(value) {
+    return typeof value === 'string' ? `'${value.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'` : String(value);
+}
+function registrationOf(control) {
+    const schema = typeof control.values[0] === 'boolean'
+        ? 'z.boolean()'
+        : `z.enum([${control.values.map(literalText).join(', ')}])`;
+    const line = `useAiClientAction('${control.actionId}', ({ ${control.state} }) => ${control.setter}(${control.state}), `
+        + `z.object({ ${control.state}: ${schema} }));`;
+    return control.preamble ? `${control.preamble}\n${line}` : line;
+}
+/** The property a destructured binding reads, e.g. `setSize` of `const { setSize } = useUiSize()`. */
+function bindingProperty(app, declaration) {
+    if (!ts.isBindingElement(declaration) || !ts.isObjectBindingPattern(declaration.parent))
+        return undefined;
+    const name = declaration.propertyName ?? declaration.name;
+    if (!ts.isIdentifier(name))
+        return undefined;
+    return app.checker.getPropertyOfType(app.checker.getTypeAtLocation(declaration.parent), name.text);
+}
+/** The symbols a callee may stand for: itself, its alias target and the property it was read from. */
+function calleeSymbols(app, callee) {
+    const expression = unwrap(callee);
+    const symbols = [];
+    const own = resolved(app, app.checker.getSymbolAtLocation(ts.isPropertyAccessExpression(expression) ? expression.name : expression));
+    if (own)
+        symbols.push(own);
+    for (const declaration of own?.declarations ?? []) {
+        const property = bindingProperty(app, declaration);
+        if (property)
+            symbols.push(property);
+    }
+    return symbols;
+}
+function calleeName(callee) {
+    const expression = unwrap(callee);
+    if (ts.isIdentifier(expression))
+        return expression.text;
+    if (ts.isPropertyAccessExpression(expression))
+        return expression.name.text;
+    return undefined;
+}
+function contextControls(app, input, sources) {
+    const checker = app.checker;
+    const controls = [];
+    for (const [file, source] of sources) {
+        const bindings = importBindings(source, [{ module: 'react', names: ['createContext'] }]);
+        const defaults = new Set(source.statements.flatMap((statement) => (ts.isImportDeclaration(statement) && ts.isStringLiteral(statement.moduleSpecifier)
+            && statement.moduleSpecifier.text === 'react' && statement.importClause?.name
+            ? [statement.importClause.name.text] : [])));
+        const visit = (node) => {
+            ts.forEachChild(node, visit);
+            if (!ts.isCallExpression(node))
+                return;
+            const callee = node.expression;
+            const isCreate = importedName(callee, bindings) === 'createContext'
+                || (ts.isPropertyAccessExpression(callee) && callee.name.text === 'createContext'
+                    && ts.isIdentifier(callee.expression) && defaults.has(callee.expression.text));
+            if (!isCreate || !ts.isVariableDeclaration(node.parent) || !ts.isIdentifier(node.parent.name))
+                return;
+            const contextName = node.parent.name.text;
+            const contextSymbol = checker.getSymbolAtLocation(node.parent.name);
+            const typeNode = node.typeArguments?.[0];
+            const valueType = typeNode
+                ? checker.getTypeFromTypeNode(typeNode)
+                : node.arguments[0] ? checker.getTypeAtLocation(node.arguments[0]) : undefined;
+            if (!valueType || !contextSymbol)
+                return;
+            const provided = providerValues(app, sources, contextSymbol);
+            for (const property of checker.getPropertiesOfType(valueType)) {
+                const match = /^set([A-Z]\w*)$/.exec(property.name);
+                if (!match)
+                    continue;
+                const state = match[1].charAt(0).toLowerCase() + match[1].slice(1);
+                if (!checker.getPropertyOfType(valueType, state))
+                    continue;
+                if (SECRET_NAME.test(state) || SECRET_NAME.test(contextName))
+                    continue;
+                const signatures = checker.getTypeOfSymbolAtLocation(property, node).getCallSignatures();
+                const parameter = signatures.length === 1 ? signatures[0].parameters[0] : undefined;
+                const values = parameter ? domainOf(checker.getTypeOfSymbolAtLocation(parameter, node)) : undefined;
+                if (!values)
+                    continue;
+                const value = provided.get(property.name);
+                if (value && input.writes(input.functionOf(value.expression)))
+                    continue;
+                const identities = new Set([property, ...(value?.symbol ? [value.symbol] : [])]);
+                controls.push({
+                    ref: `${file.path}#${property.name}`,
+                    file: value?.file ?? file.path,
+                    setter: property.name,
+                    state,
+                    values,
+                    actionId: `${kebab(contextName) || state}.set`,
+                    reaches: (callee) => {
+                        const symbols = calleeSymbols(app, callee);
+                        // Without types (an `any` hook) the name is the only evidence left.
+                        if (symbols.length === 0)
+                            return calleeName(callee) === property.name;
+                        return symbols.some((symbol) => identities.has(symbol));
+                    },
+                });
+            }
+        };
+        visit(source);
+    }
+    return controls;
+}
+/** What `<Context.Provider value={{ … }}>` (or `<Context value>`) passes per property. */
+function providerValues(app, sources, contextSymbol) {
+    const values = new Map();
+    for (const [file, source] of sources) {
+        const visit = (node) => {
+            ts.forEachChild(node, visit);
+            if (!ts.isJsxOpeningElement(node) && !ts.isJsxSelfClosingElement(node))
+                return;
+            const tag = node.tagName;
+            const target = ts.isPropertyAccessExpression(tag) && tag.name.text === 'Provider' ? tag.expression : tag;
+            if (resolved(app, app.checker.getSymbolAtLocation(target)) !== contextSymbol)
+                return;
+            for (const attribute of node.attributes.properties) {
+                if (!ts.isJsxAttribute(attribute) || !ts.isIdentifier(attribute.name) || attribute.name.text !== 'value')
+                    continue;
+                const initializer = attribute.initializer;
+                const object = initializer && ts.isJsxExpression(initializer) && initializer.expression
+                    ? unwrap(initializer.expression) : undefined;
+                if (!object || !ts.isObjectLiteralExpression(object))
+                    continue;
+                for (const property of object.properties) {
+                    if (ts.isShorthandPropertyAssignment(property)) {
+                        values.set(property.name.text, {
+                            file: file.path,
+                            expression: property.name,
+                            symbol: resolved(app, app.checker.getShorthandAssignmentValueSymbol(property)),
+                        });
+                    }
+                    else if (ts.isPropertyAssignment(property) && ts.isIdentifier(property.name)) {
+                        const expression = unwrap(property.initializer);
+                        values.set(property.name.text, {
+                            file: file.path,
+                            expression,
+                            symbol: ts.isIdentifier(expression) ? resolved(app, app.checker.getSymbolAtLocation(expression)) : undefined,
+                        });
+                    }
+                }
+            }
+        };
+        visit(source);
+    }
+    return values;
+}
+const NEXT_THEMES = [{ module: 'next-themes', names: ['ThemeProvider', 'useTheme'] }];
+/** Whether an expression is a `useTheme()` call of next-themes, directly or through a variable. */
+function isUseThemeCall(app, expression) {
+    const value = unwrap(expression);
+    if (ts.isCallExpression(value)) {
+        return importedName(value.expression, importBindings(value.getSourceFile(), NEXT_THEMES)) === 'useTheme';
+    }
+    if (ts.isIdentifier(value)) {
+        const declaration = resolved(app, app.checker.getSymbolAtLocation(value))?.valueDeclaration;
+        return Boolean(declaration && ts.isVariableDeclaration(declaration) && declaration.initializer
+            && ts.isCallExpression(unwrap(declaration.initializer)) && isUseThemeCall(app, declaration.initializer));
+    }
+    return false;
+}
+/** `setTheme` read from `useTheme()`, by destructuring or property access. */
+function reachesSetTheme(app, callee) {
+    const expression = unwrap(callee);
+    if (ts.isPropertyAccessExpression(expression)) {
+        return expression.name.text === 'setTheme' && isUseThemeCall(app, expression.expression);
+    }
+    if (!ts.isIdentifier(expression))
+        return false;
+    const declaration = resolved(app, app.checker.getSymbolAtLocation(expression))?.valueDeclaration;
+    if (!declaration || !ts.isBindingElement(declaration) || !ts.isObjectBindingPattern(declaration.parent))
+        return false;
+    const name = declaration.propertyName ?? declaration.name;
+    const variable = declaration.parent.parent;
+    return ts.isIdentifier(name) && name.text === 'setTheme'
+        && ts.isVariableDeclaration(variable) && variable.initializer !== undefined && isUseThemeCall(app, variable.initializer);
+}
+function attributeValue(attribute) {
+    if (!attribute.initializer)
+        return 'present';
+    if (ts.isStringLiteral(attribute.initializer))
+        return attribute.initializer;
+    return ts.isJsxExpression(attribute.initializer) && attribute.initializer.expression
+        ? unwrap(attribute.initializer.expression) : undefined;
+}
+/** The next-themes `ThemeProvider` decides the themes: `themes`, else light and dark, plus system unless disabled. */
+function themeControls(app, sources) {
+    for (const [file, source] of sources) {
+        const bindings = importBindings(source, NEXT_THEMES);
+        let found;
+        const visit = (node) => {
+            if (found)
+                return;
+            ts.forEachChild(node, visit);
+            if (!ts.isJsxOpeningElement(node) && !ts.isJsxSelfClosingElement(node))
+                return;
+            if (importedName(node.tagName, bindings) !== 'ThemeProvider')
+                return;
+            let themes = ['dark', 'light'];
+            let system = true;
+            for (const attribute of node.attributes.properties) {
+                if (!ts.isJsxAttribute(attribute) || !ts.isIdentifier(attribute.name))
+                    continue;
+                const value = attributeValue(attribute);
+                if (attribute.name.text === 'enableSystem') {
+                    system = value === 'present' || value?.kind === ts.SyntaxKind.TrueKeyword;
+                }
+                else if (attribute.name.text === 'themes') {
+                    themes = value && value !== 'present' && ts.isArrayLiteralExpression(value)
+                        && value.elements.every(ts.isStringLiteralLike)
+                        ? value.elements.map((element) => element.text)
+                        : undefined;
+                }
+            }
+            if (themes)
+                found = [...new Set([...themes, ...(system ? ['system'] : [])])].sort(compareCodeUnits);
+        };
+        visit(source);
+        if (found && found.length >= 2) {
+            return [{
+                    ref: `${file.path}#setTheme`,
+                    file: file.path,
+                    setter: 'setTheme',
+                    state: 'theme',
+                    values: found,
+                    actionId: 'theme.set',
+                    preamble: 'const { setTheme } = useTheme();',
+                    reaches: (callee) => reachesSetTheme(app, callee),
+                }];
+        }
+    }
+    return [];
+}
+/** Every call inside a function body, including the body of a handler given by name. */
+function calleesOf(fn) {
+    const body = fn && 'body' in fn ? fn.body : undefined;
+    if (!body)
+        return [];
+    const callees = [];
+    const visit = (node) => {
+        if (ts.isCallExpression(node))
+            callees.push(node.expression);
+        ts.forEachChild(node, visit);
+    };
+    visit(body);
+    return callees;
+}
+/** String properties of a payload: at least one must stay within the setter's values. */
+function contractAllowsOthers(schema, values) {
+    if (!schema || typeof values[0] === 'boolean')
+        return false;
+    const properties = Object.values((schema.properties ?? {}))
+        .filter((property) => property.type === 'string');
+    if (properties.length === 0)
+        return false;
+    return !properties.some((property) => Array.isArray(property.enum)
+        && property.enum.every((value) => values.includes(value)));
+}
+export function analyzeUiControls(input) {
+    const sources = input.files
+        .filter((file) => CONTROL_TEXT.test(file.source) || /useAiClientAction|registerAiClientAction|subscribeById/.test(file.source))
+        .flatMap((file) => {
+        const source = input.app.sourceFile(file.absolute);
+        return source ? [[file, source]] : [];
+    });
+    const excluded = new Set((input.policy.excludeControls ?? []).map((entry) => entry.control));
+    const controls = [...contextControls(input.app, input, sources), ...themeControls(input.app, sources)]
+        .filter((control) => !excluded.has(control.ref))
+        .filter((control) => uiDefinitionIdForAction(control.actionId) !== undefined);
+    const findings = [];
+    const byStableKey = new Map();
+    for (const control of controls.sort((left, right) => compareCodeUnits(left.ref, right.ref))) {
+        const reaching = input.registrations.filter((registration) => {
+            const handler = registration.handler ? unwrap(registration.handler) : undefined;
+            if (handler && ts.isIdentifier(handler) && control.reaches(handler))
+                return true;
+            return calleesOf(input.functionOf(registration.handler)).some((callee) => control.reaches(callee));
+        });
+        if (reaching.length > 0) {
+            for (const registration of reaching) {
+                if (!contractAllowsOthers(registration.schema, control.values))
+                    continue;
+                byStableKey.set(registration.stableKey, [...byStableKey.get(registration.stableKey) ?? [],
+                    toolFinding('ui-control-contract-mismatch', 'needs_attention', registration.stableKey, `${registration.actionId} calls ${control.setter}, which takes ${control.values.join(', ')}; its contract allows other values.`)]);
+            }
+            continue;
+        }
+        const setterText = new RegExp(`\\b${control.setter}\\b`);
+        const definedIn = control.ref.slice(0, control.ref.indexOf('#'));
+        const usedIn = input.allFiles
+            .filter((file) => file.path !== control.file && file.path !== definedIn && setterText.test(file.source))
+            .map((file) => file.path)
+            .sort(compareCodeUnits);
+        findings.push({
+            ...toolFinding('ui-control-unbound', 'warning', control.ref, `${control.setter} (${control.values.join(', ')}) has no client action, so the chat cannot set ${control.state}.`),
+            expected: {
+                actionId: control.actionId,
+                file: control.file,
+                setter: control.setter,
+                state: control.state,
+                values: control.values,
+                usedIn,
+                registration: registrationOf(control),
+            },
+        });
+    }
+    return { findings, byStableKey };
+}
+//# sourceMappingURL=ui-controls.js.map

package/dist/codegen/tools/sources/ui-controls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-controls.js","sourceRoot":"","sources":["../../../../src/codegen/tools/sources/ui-controls.ts"],"names":[],"mappings":"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"}

package/dist/codegen/tools/sources/ui-tools.d.ts

@@ -0,0 +1,79 @@
+import ts from 'typescript';
+import type { GeneratedUiAction } from '../../../server/core/generated-ui-tool.js';
+import type { JsonSchemaLike, ObservedTool, ToolContract, ToolFinding, ToolProseHints, ToolSourceObservation } from '../types.js';
+import type { AppSourceFile } from './app-files.js';
+/** Action id the navigation bridge listens to; `ui.navigate` and every `ui.filter.<view>` use it. */
+export declare const NAVIGATE_ACTION_BINDING = "glirastes.navigate";
+export declare const NAVIGATE_STABLE_KEY = "UI navigate";
+export declare const NAVIGATE_DEFINITION_ID = "ui.navigate";
+export declare function filterStableKey(path: string): string;
+export declare function actionStableKey(actionId: string): string;
+/** What every generated UI tool returns (`uiActionToolToTool`). */
+export declare const UI_TOOL_OUTPUT_SCHEMA: JsonSchemaLike;
+/** `/tasks` → `tasks`, `/` → `home`, `/tasks/:id` → `tasksItem`: the `<view>` of `ui.filter.<view>`. */
+export declare function viewName(path: string): string;
+/**
+ * `tasks.highlight` → `ui.tasks.highlight`. A single segment or one that
+ * would shadow `ui.navigate`/`ui.filter.*` moves under `ui.action.`;
+ * undefined when the id cannot form a tool name.
+ */
+export declare function uiDefinitionIdForAction(actionId: string): string | undefined;
+/**
+ * Same base name for two stable keys: the later key gets a digest suffix,
+ * independent of order. A base over the cap is cut and suffixed the same way,
+ * and no id is handed out twice.
+ */
+export declare function uniqueDefinitionIds(entries: ReadonlyArray<{
+    stableKey: string;
+    base: string;
+}>): Map<string, string>;
+export declare function parseAppSource(file: Pick<AppSourceFile, 'path' | 'source'>): ts.SourceFile;
+export interface ImportSpec {
+    module: string;
+    names: ReadonlyArray<string>;
+}
+export interface ImportedCall {
+    /** The exported name the call resolves to, whatever the local alias. */
+    name: string;
+    call: ts.CallExpression;
+}
+export interface ImportBindings {
+    /** Local name → exported name. */
+    named: ReadonlyMap<string, string>;
+    /** Namespace alias → the exported names it may reach. */
+    namespaces: ReadonlyMap<string, ReadonlySet<string>>;
+}
+/** Value imports of the given names from the given modules; type-only imports never count. */
+export declare function importBindings(source: ts.SourceFile, specs: ReadonlyArray<ImportSpec>): ImportBindings;
+/** The exported name `node` refers to through `bindings`: `alias` or `namespace.name`. */
+export declare function importedName(node: ts.Node, bindings: ImportBindings): string | undefined;
+/**
+ * Calls of named or namespace imports from the given modules, read from
+ * syntax only: a same-named local function, a comment or an import that is
+ * never called does not count.
+ */
+export declare function importedCalls(source: ts.SourceFile, specs: ReadonlyArray<ImportSpec>): ImportedCall[];
+/** True when app code calls the navigation bridge that executes `ui.navigate` and `ui.filter.*`. */
+export declare function hasNavigationBridge(files: ReadonlyArray<Pick<AppSourceFile, 'path' | 'source'>>): boolean;
+export declare function mentionsNavigationBridge(source: string): boolean;
+export interface UiObservationInput {
+    stableKey: string;
+    definitionId: string;
+    actionBindingRef: string;
+    /** Undefined when the payload is untyped: the tool keeps its identity but has no contract. */
+    input?: JsonSchemaLike;
+    uiAction: GeneratedUiAction;
+    params?: ToolContract['params'];
+    /** Facts the tool depends on; a change of these is a changed tool. */
+    facts: unknown;
+    findings: ToolFinding[];
+    prose?: ToolProseHints;
+    jsDoc?: string;
+    uiMutation?: boolean;
+    /** App-relative files that register or read this tool, for the work lists. */
+    files?: string[];
+}
+/** An `ObservedTool` for a generated UI tool; its contract is JSON Schema read from code. */
+export declare function uiObservation(input: UiObservationInput): ObservedTool;
+/** One incomplete UI enumeration stops the refresh, like an unreadable route file. */
+export declare function incompleteUiSource(kind: string, reason: string): ToolSourceObservation;