flavor-code 1.2.11 → 1.2.14

package/dist/evolve/store.d.ts

@@ -0,0 +1,91 @@
+export interface EvolveSignal {
+    id: string;
+    tool: string;
+    errorCode?: string;
+    error: string;
+    /** Key names of the failing tool input — never values, so secrets stay out of the file. */
+    args: string[];
+    firstAt: string;
+    lastAt: string;
+    count: number;
+}
+export interface EvolveSuggestion {
+    id: string;
+    tool: string;
+    count: number;
+    error: string;
+    hint: string;
+    /** Trend of this tool's failure count since the last run (only when trends are supplied). */
+    trend?: "improving" | "stable" | "worsening";
+    /** Failure-count delta since the last run, from the supplied trends. */
+    delta?: number;
+}
+export interface ToolTrend {
+    /** Failure count of this tool in the run (per-run, not cumulative). */
+    failures: number;
+    /** Change vs the previous run: negative means the fix is working. */
+    delta: number;
+}
+export interface EvolveReflectionInput {
+    iterations: number;
+    reason: string;
+    toolCalls: number;
+    toolErrors: number;
+    steers: number;
+    totalFailures: number;
+    signalDelta: number;
+    failedTools: readonly string[];
+    perTool?: Record<string, ToolTrend>;
+}
+export interface EvolveReflection extends EvolveReflectionInput {
+    at: string;
+    perTool: Record<string, ToolTrend>;
+}
+export interface EvolveStoreOptions {
+    workspace: string;
+    maxSignals?: number;
+}
+/** Collapse whitespace and quoted values so equivalent messages coalesce. */
+export declare function normalizeError(message: unknown): string;
+/** Stable id for a (tool, errorCode, error) triple, so repeated failures coalesce. */
+export declare function fingerprint(tool: string, errorCode: string | undefined, error: unknown): string;
+/** Value-free summary of tool args: only key names, never secrets. */
+export declare function argKeys(args: unknown): string[];
+export declare class EvolveStore {
+    #private;
+    readonly dir: string;
+    readonly signalsFile: string;
+    readonly reflectionsFile: string;
+    readonly doneFile: string;
+    readonly verifiedFile: string;
+    readonly maxSignals: number;
+    constructor(options: EvolveStoreOptions);
+    /**
+     * Record one failed tool call. Dedupes by (tool, errorCode, normalized error):
+     * existing entries get count/lastAt bumped instead of growing unbounded.
+     */
+    recordSignal(input: {
+        tool: string;
+        errorCode?: string;
+        error: unknown;
+        args?: unknown;
+    }): Promise<{
+        added: boolean;
+        record: EvolveSignal;
+    }>;
+    signals(): Promise<EvolveSignal[]>;
+    clearSignals(): Promise<void>;
+    appendReflection(input: EvolveReflectionInput): Promise<EvolveReflection>;
+    reflections(limit?: number): Promise<EvolveReflection[]>;
+    /** Aggregate open suggestions from repeated failure signals. */
+    openSuggestions(input?: {
+        threshold?: number;
+        limit?: number;
+        trends?: Readonly<Record<string, number>>;
+    }): Promise<EvolveSuggestion[]>;
+    markSuggestionDone(id: string): Promise<void>;
+    /** Ids of suggestions whose underlying tool failure is improving (auto-verified). */
+    verifiedIds(): Promise<string[]>;
+    /** Mark a suggestion as verified so it is no longer proposed. */
+    markSuggestionVerified(id: string): Promise<void>;
+}

package/dist/hooks/types.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-export declare const HOOK_EVENT_NAMES: readonly ["SessionStart", "UserPromptSubmit", "Stop", "SessionEnd", "BeforePlan", "AfterPlan", "SubagentStart", "SubagentStop", "BeforeModelCall", "AfterModelCall", "PreToolUse", "PermissionRequest", "PostToolUse", "PostToolUseFailure", "PreCompact", "PostCompact", "PluginLoad", "PluginUnload", "Notification"];
+export declare const HOOK_EVENT_NAMES: readonly ["SessionStart", "UserPromptSubmit", "Stop", "SessionEnd", "BeforePlan", "AfterPlan", "SubagentStart", "SubagentStop", "BeforeModelCall", "AfterModelCall", "PreToolUse", "PermissionRequest", "PostToolUse", "PostToolUseFailure", "PreCompact", "PostCompact", "PluginLoad", "PluginUnload", "Notification", "LoopEnd"];
 export declare const HookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     version: z.ZodLiteral<1>;
     type: z.ZodLiteral<"SessionStart">;
@@ -76,6 +76,10 @@ export declare const HookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     version: z.ZodLiteral<1>;
     type: z.ZodLiteral<"Notification">;
     payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"LoopEnd">;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, z.core.$strip>], "type">;
 export declare const HookDecisionSchema: z.ZodObject<{
     decision: z.ZodEnum<{

package/dist/init/project.d.ts

@@ -13,6 +13,8 @@ export interface ProjectFacts {
     instructionFiles: string[];
     configFiles: string[];
     gitignorePath?: string;
+    /** True when an astgraph code-graph index (`.flavor/astgraph/index.db`) exists. */
+    hasCodeGraph: boolean;
     cautions: string[];
 }
 export interface InitResult {
@@ -22,4 +24,10 @@ export interface InitResult {
     facts: ProjectFacts;
 }
 export declare function inspectProject(cwd: string): Promise<ProjectFacts>;
+/**
+ * Copy the astgraph plugin (runtime + vendored WASM grammars + zod) into the
+ * workspace's project plugin directory. Mirrors the codeisland distribution
+ * pattern: an existing installation is never overwritten.
+ */
+export declare function copyAstgraphPlugin(cwd: string): Promise<void>;
 export declare function initializeFlavor(cwd: string): Promise<InitResult>;

package/dist/{load-6ZMEBHSG.js → load-GKA7P6RJ.js}

@@ -7,7 +7,7 @@ import {
   setProjectMcpServerDisabled,
   setProjectProviderConfig,
   setProjectSkillDisabled
-} from "./chunk-XFCJXRJ2.js";
+} from "./chunk-IG4Z23CL.js";
 import "./chunk-S32JRDZK.js";
 export {
   loadConfig,

package/dist/models/structured.d.ts

@@ -72,4 +72,18 @@ export declare class StructuredOutputError extends Error {
 }
 export declare function withStructuredOutput<T>(options: StructuredOutputOptions<T>): StructuredModel<T>;
 export declare function strictJsonSchema(schema: z.ZodType<unknown>): Record<string, unknown>;
+/**
+ * Extract the first JSON object or array from free-form model text (plain JSON,
+ * fenced ```json blocks, or JSON embedded in prose). Returns undefined when no
+ * parseable object is found.
+ */
+export declare function extractJsonObject(text: string): unknown;
+/**
+ * Best-effort type coercion guided by a JSON schema. Some providers serialize
+ * typed fields as strings (`"10"` for an integer). This rewrites string→number /
+ * string→boolean where the schema demands those types, recursing into object
+ * properties and anyOf branches. Values already matching the schema are
+ * returned unchanged, so a valid payload is a no-op.
+ */
+export declare function coerceByJsonSchema(value: unknown, schema: unknown): unknown;
 export declare function modelToolFromZod(name: string, description: string, schema: z.ZodType<unknown>): ModelTool;

package/dist/permissions/engine.d.ts

@@ -15,6 +15,8 @@ export interface PermissionRequest {
     args?: readonly string[];
     cwd?: string;
     allowAlways?: false;
+    /** Declared read-only by the tool definition; granted the same treatment as READ_TOOLS. */
+    readOnly?: boolean;
 }
 export interface PermissionEngineOptions {
     workspace: string;

package/dist/plugins/host.d.ts

@@ -11,5 +11,14 @@ export declare class PluginHost {
     get loadedPlugins(): readonly LoadedPlugin[];
     loadAll(): Promise<void>;
     unloadAll(): Promise<void>;
+    /**
+     * Reload one plugin from disk: unloads the active instance (if any), then
+     * re-discovers and activates the current version. Used by the evolve loop to
+     * hot-load fix plugins after verification.
+     */
+    reload(name: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
     unload(name: string): Promise<void>;
 }

package/dist/plugins/types.d.ts

@@ -24,6 +24,7 @@ export declare const PluginManifestSchema: z.ZodObject<{
                 AfterPlan: "AfterPlan";
                 BeforeModelCall: "BeforeModelCall";
                 BeforePlan: "BeforePlan";
+                LoopEnd: "LoopEnd";
                 Notification: "Notification";
                 PermissionRequest: "PermissionRequest";
                 PluginLoad: "PluginLoad";
@@ -81,7 +82,7 @@ export interface PluginContext {
     readonly config: unknown;
     readonly logger: PluginLogger;
     readonly services: PluginServices;
-    registerCommand(name: string, command: PluginCommandHandler): PluginDisposer;
+    registerCommand(name: string, command: PluginCommandHandler, description?: string): PluginDisposer;
     registerTool(name: string, tool: ToolDefinition<unknown>): PluginDisposer;
     registerHook(name: HookEventName, hook: HookHandler, options?: HookHandlerOptions): PluginDisposer;
     registerSkillRoot(name: string, root: string): PluginDisposer;
@@ -108,7 +109,7 @@ export interface LoadedPlugin {
     readonly root: string;
 }
 export interface PluginRegistrationCallbacks {
-    command(name: string, command: PluginCommandHandler): PluginDisposer;
+    command(name: string, command: PluginCommandHandler, description?: string): PluginDisposer;
     tool(name: string, tool: ToolDefinition<unknown>): PluginDisposer;
     hook(name: HookEventName, hook: HookHandler, options?: HookHandlerOptions): PluginDisposer;
     /** Consumers must revalidate identity before access, or delegate reading to SkillRegistry. */

package/dist/sdk/index.js

@@ -4,7 +4,7 @@ import {
   FlavorRpcServer,
   TraceRecordSchema,
   TraceRecorder
-} from "../chunk-EY6KE7L2.js";
+} from "../chunk-KL6TR2KG.js";
 import {
   AgentMessageQueue,
   DockerExecutionEnvironment,
@@ -13,8 +13,8 @@ import {
   WorkspaceCheckpointStore,
   buildDockerInvocation,
   createProductionRuntime
-} from "../chunk-OT5XIN6G.js";
-import "../chunk-XFCJXRJ2.js";
+} from "../chunk-4YXDGGIC.js";
+import "../chunk-IG4Z23CL.js";
 import "../chunk-RQTYHUMK.js";
 import "../chunk-S32JRDZK.js";
 

package/dist/tools/shell.d.ts

@@ -9,7 +9,7 @@ declare const ShellInput: z.ZodObject<{
     args: z.ZodArray<z.ZodString>;
     cwd: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     timeoutMs: z.ZodOptional<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;
-    background: z.ZodOptional<z.ZodBoolean>;
+    background: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString & z.ZodType<"false" | "true", string, z.core.$ZodTypeInternals<"false" | "true", string>>]>>;
 }, z.core.$strip>;
 export interface ShellToolOptions {
     maxOutputBytes?: number;
@@ -42,6 +42,19 @@ export interface ShellBackgroundResult extends ShellResult {
 type ShellTool = Omit<ToolDefinition<z.infer<typeof ShellInput>, ShellResult | ShellBackgroundResult>, "execute"> & {
     execute(input: z.infer<typeof ShellInput>, signal: AbortSignal, context?: import("./types.js").ToolContext): Promise<ShellResult | ShellBackgroundResult>;
 };
+/**
+ * Normalize weak model calls that stuff a whole command line into `command`
+ * (e.g. `command: "git log --oneline"`). Splits only when the first token is a
+ * bare command name (no path separators), so explicit paths with spaces —
+ * `command: "C:\\Program Files\\node.exe"` — are left untouched.
+ */
+export declare function normalizeShellCommand(input: {
+    command: string;
+    args: readonly string[];
+}): {
+    command: string;
+    args: string[];
+};
 export declare function createShellTool(workspace: string, options?: ShellToolOptions): ShellTool;
 export declare function executeShell(root: string, input: z.infer<typeof ShellInput>, cancellation: AbortSignal, maxBytes: number, onOutput?: (stream: "stdout" | "stderr", text: string) => void): Promise<ShellResult>;
 export {};

package/dist/tools/types.d.ts

@@ -89,6 +89,8 @@ export interface ToolDefinition<T, O = unknown> {
     modelInputSchema?: Record<string, unknown>;
     /** Whether providers should enforce strict function arguments. Defaults to true. */
     modelStrict?: boolean;
+    /** Declared read-only: allowed without approval, same as Read/Glob/Grep (including plan mode). */
+    readOnly?: boolean;
     paths(input: T): string[];
     /**
      * Optional short human-readable parameter summary, rendered dimmed next to the tool name.

package/dist/ui/commands.d.ts

@@ -1,4 +1,4 @@
-export declare const MVP_COMMANDS: readonly ["model", "init", "config", "login", "permissions", "skills", "plugins", "hooks", "tasks", "finish", "compact", "clear", "help", "exit", "audit", "usage", "loop", "goal", "mcp", "ide", "memory", "remember", "forget", "forget-cold", "checkpoint", "tree", "rewind", "unrevert", "fork", "pals", "chat", "co-work"];
+export declare const MVP_COMMANDS: readonly ["model", "init", "config", "login", "permissions", "skills", "plugins", "hooks", "tasks", "finish", "compact", "clear", "help", "exit", "audit", "usage", "loop", "goal", "evolve", "mcp", "ide", "memory", "remember", "forget", "forget-cold", "checkpoint", "tree", "rewind", "unrevert", "fork", "pals", "chat", "co-work"];
 export declare const COMMAND_DESCRIPTIONS: Record<(typeof MVP_COMMANDS)[number], string>;
 export type PermissionCommandMode = PermissionMode;
 export type ModelRole = "main" | "subagent";
@@ -81,10 +81,13 @@ export type SlashCommand = {
     target: string;
     goal: string;
 } | CoWorkSlashCommand | {
-    name: Exclude<(typeof MVP_COMMANDS)[number], "model" | "permissions" | "audit" | "loop" | "goal" | "mcp" | "remember" | "forget" | "checkpoint" | "rewind" | "fork" | "pals" | "chat" | "co-work">;
+    name: Exclude<(typeof MVP_COMMANDS)[number], "model" | "permissions" | "audit" | "loop" | "goal" | "evolve" | "mcp" | "remember" | "forget" | "checkpoint" | "rewind" | "fork" | "pals" | "chat" | "co-work">;
 } | {
     name: "audit";
     toolFilter?: string | undefined;
+} | {
+    name: "evolve";
+    args: string[];
 } | {
     name: "unknown";
     input: string;

package/dist/ui/session.d.ts

@@ -128,6 +128,7 @@ export interface SessionServices {
     hooksStatus(): readonly unknown[];
     tasks(): unknown;
     audit(toolFilter?: string): string | Promise<string>;
+    evolve(args: readonly string[]): string | Promise<string>;
     usage(): string | Promise<string>;
     cancelActiveTask(): void | Promise<void>;
     clearContext(): void | Promise<void>;
@@ -142,7 +143,10 @@ export interface SessionServices {
     forget(query: string): Promise<string>;
     forgetCold(): Promise<string>;
     finishTask(): Promise<string>;
-    pluginCommands(): readonly string[];
+    pluginCommands(): readonly {
+        name: string;
+        description?: string;
+    }[];
     runPluginCommand(name: string, args: readonly string[], signal: AbortSignal): Promise<unknown>;
     output(event: SessionOutput): void;
     questions: QuestionBridge;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flavor-code",
-  "version": "1.2.11",
+  "version": "1.2.14",
   "author": "YachuanWzh",
   "type": "module",
   "publishConfig": {
@@ -31,7 +31,7 @@
   "scripts": {
     "build": "npm run build:icons && npm run build:cli && npm run build:desktop",
     "build:icons": "node scripts/build-icons.mjs",
-    "build:cli": "tsup && tsc -p tsconfig.sdk.json && node -e \"require('fs').cpSync('src/init/codeisland','dist/codeisland',{recursive:true})\"",
+    "build:cli": "tsup && tsc -p tsconfig.sdk.json && node -e \"require('fs').cpSync('src/init/codeisland','dist/codeisland',{recursive:true});require('fs').cpSync('src/init/astgraph','dist/astgraph',{recursive:true})\"",
     "build:desktop": "npm run build:desktop:main && npm run build:desktop:renderer",
     "build:desktop:main": "tsup --config tsup.desktop.config.ts",
     "build:desktop:renderer": "vite build --config vite.desktop.config.ts",
@@ -127,9 +127,11 @@
     "electron-builder": "^26.15.3",
     "playwright-core": "^1.62.1",
     "sharp": "^0.35.3",
+    "tree-sitter-wasms": "0.1.13",
     "tsup": "^8.5.1",
     "vite": "^8.1.5",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.10",
+    "web-tree-sitter": "0.25.10"
   },
   "allowScripts": {
     "electron-winstaller@5.4.0": true,