@spenceriam/impulse 0.15.0

package/dist/ui/design.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Design Constants
+ * Single source of truth for colors, indicators, and visual elements
+ *
+ * Design Philosophy: Brutally Minimal
+ * - Function over decoration
+ * - Raw and honest
+ * - Dense and information-forward
+ * - High contrast
+ * - Monospace precision
+ * - No emojis
+ */
+/**
+ * Color Palette
+ */
+export declare const Colors: {
+    /**
+     * Mode-specific colors (used in mode indicators, input borders)
+     */
+    readonly mode: {
+        readonly AUTO: "#ffffff";
+        readonly AGENT: "#5cffff";
+        readonly PLANNER: "#b48eff";
+        readonly "PLAN-PRD": "#5c8fff";
+        readonly DEBUG: "#ffaa5c";
+    };
+    /**
+     * Status colors (used in tool results, messages)
+     */
+    readonly status: {
+        readonly success: "#6fca6f";
+        readonly warning: "#e6c655";
+        readonly error: "#ff6b6b";
+        readonly info: "#5c8fff";
+    };
+    /**
+     * UI element colors
+     */
+    readonly ui: {
+        readonly primary: "#5cffff";
+        readonly secondary: "#666666";
+        readonly text: "#ffffff";
+        readonly dim: "#666666";
+        readonly background: "#000000";
+    };
+    /**
+     * Diff colors (used in file changes)
+     */
+    readonly diff: {
+        readonly addition: "#6fca6f";
+        readonly deletion: "#ff6b6b";
+    };
+};
+/**
+ * ASCII Indicators (no emojis)
+ */
+export declare const Indicators: {
+    /**
+     * Expand/collapse indicators
+     */
+    readonly collapsed: "▶";
+    readonly expanded: "▼";
+    /**
+     * Status dot
+     */
+    readonly dot: "●";
+    /**
+     * Todo status indicators
+     */
+    readonly todo: {
+        readonly pending: "[ ]";
+        readonly in_progress: "[>]";
+        readonly completed: "[x]";
+        readonly cancelled: "[-]";
+    };
+    /**
+     * Tool result indicators
+     */
+    readonly tool: {
+        readonly success: "[OK]";
+        readonly error: "[FAIL]";
+    };
+    /**
+     * Progress bar characters
+     */
+    readonly progress: {
+        readonly filled: "█";
+        readonly empty: "░";
+    };
+    /**
+     * Separators
+     */
+    readonly separator: {
+        readonly vertical: "│";
+        readonly horizontal: "─";
+        readonly cross: "┼";
+        readonly topLeft: "┌";
+        readonly topRight: "┐";
+        readonly bottomLeft: "└";
+        readonly bottomRight: "┘";
+        readonly teeLeft: "├";
+        readonly teeRight: "┤";
+        readonly teeTop: "┬";
+        readonly teeBottom: "┴";
+    };
+};
+/**
+ * Layout Constants
+ */
+export declare const Layout: {
+    /**
+     * Padding values
+     */
+    readonly padding: {
+        readonly none: 0;
+        readonly xs: 1;
+        readonly sm: 2;
+        readonly md: 4;
+        readonly lg: 8;
+    };
+    /**
+     * Sidebar width
+     */
+    readonly sidebar: {
+        readonly width: 40;
+        readonly minWidth: 30;
+        readonly maxWidth: 60;
+    };
+    /**
+     * Input height
+     */
+    readonly input: {
+        readonly minHeight: 3;
+        readonly maxHeight: 10;
+    };
+    /**
+     * Progress bar width
+     */
+    readonly progressBar: {
+        readonly width: 10;
+    };
+};
+/**
+ * Animation Timing (milliseconds)
+ */
+export declare const Timing: {
+    /**
+     * Event batching interval for streaming
+     */
+    readonly batchInterval: 16;
+    /**
+     * Debounce delay for input
+     */
+    readonly debounce: 100;
+    /**
+     * Animation duration
+     */
+    readonly animation: 150;
+};
+export type Mode = keyof typeof Colors.mode;
+export type Status = keyof typeof Colors.status;
+export type TodoStatus = keyof typeof Indicators.todo;
+export type ToolStatus = keyof typeof Indicators.tool;
+/**
+ * Get mode color by mode name
+ */
+export declare function getModeColor(mode: Mode): string;
+/**
+ * Get status color by status name
+ */
+export declare function getStatusColor(status: Status): string;
+/**
+ * Get todo indicator by status
+ */
+export declare function getTodoIndicator(status: TodoStatus): string;
+/**
+ * Create a progress bar string
+ * @param percent - Progress percentage (0-100)
+ * @param width - Width in characters (default 10)
+ */
+export declare function createProgressBar(percent: number, width?: number): string;
+//# sourceMappingURL=design.d.ts.map

package/dist/ui/design.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design.d.ts","sourceRoot":"","sources":["../../src/ui/design.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;;;;;;;;IASH;;OAEG;;;;;;;IAQH;;OAEG;;;;;;;;IASH;;OAEG;;;;;CAKK,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;;;IAIH;;OAEG;;IAGH;;OAEG;;;;;;;IAQH;;OAEG;;;;;IAMH;;OAEG;;;;;IAMH;;OAEG;;;;;;;;;;;;;;CAcK,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;;;;;;;;IASH;;OAEG;;;;;;IAOH;;OAEG;;;;;IAMH;;OAEG;;;;CAIK,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAEK,CAAC;AAGX,MAAM,MAAM,IAAI,GAAG,MAAM,OAAO,MAAM,CAAC,IAAI,CAAC;AAC5C,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,MAAM,CAAC,MAAM,CAAC;AAChD,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,UAAU,CAAC,IAAI,CAAC;AACtD,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,UAAU,CAAC,IAAI,CAAC;AAEtD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAiC,GAAG,MAAM,CAMnG"}

package/dist/ui/design.js

@@ -0,0 +1,189 @@
+/**
+ * Design Constants
+ * Single source of truth for colors, indicators, and visual elements
+ *
+ * Design Philosophy: Brutally Minimal
+ * - Function over decoration
+ * - Raw and honest
+ * - Dense and information-forward
+ * - High contrast
+ * - Monospace precision
+ * - No emojis
+ */
+/**
+ * Color Palette
+ */
+export const Colors = {
+    /**
+     * Mode-specific colors (used in mode indicators, input borders)
+     */
+    mode: {
+        AUTO: "#ffffff", // White - AI decides
+        AGENT: "#5cffff", // Cyan - Full execution
+        PLANNER: "#b48eff", // Purple - Research + docs
+        "PLAN-PRD": "#5c8fff", // Blue - Quick PRD
+        DEBUG: "#ffaa5c", // Orange - Systematic debugging
+    },
+    /**
+     * Status colors (used in tool results, messages)
+     */
+    status: {
+        success: "#6fca6f", // Green - Operation succeeded
+        warning: "#e6c655", // Yellow - Caution/attention
+        error: "#ff6b6b", // Red - Operation failed
+        info: "#5c8fff", // Blue - Informational
+    },
+    /**
+     * UI element colors
+     */
+    ui: {
+        primary: "#5cffff", // Cyan - Primary accent
+        secondary: "#666666", // Gray - Secondary/muted
+        text: "#ffffff", // White - Primary text
+        dim: "#666666", // Gray - Dimmed text
+        background: "#000000", // Black - Background
+    },
+    /**
+     * Diff colors (used in file changes)
+     */
+    diff: {
+        addition: "#6fca6f", // Green - Added lines
+        deletion: "#ff6b6b", // Red - Removed lines
+    },
+};
+/**
+ * ASCII Indicators (no emojis)
+ */
+export const Indicators = {
+    /**
+     * Expand/collapse indicators
+     */
+    collapsed: "▶",
+    expanded: "▼",
+    /**
+     * Status dot
+     */
+    dot: "●",
+    /**
+     * Todo status indicators
+     */
+    todo: {
+        pending: "[ ]", // Not started
+        in_progress: "[>]", // Currently working
+        completed: "[x]", // Done
+        cancelled: "[-]", // No longer needed
+    },
+    /**
+     * Tool result indicators
+     */
+    tool: {
+        success: "[OK]", // Tool succeeded
+        error: "[FAIL]", // Tool failed
+    },
+    /**
+     * Progress bar characters
+     */
+    progress: {
+        filled: "█", // Completed portion
+        empty: "░", // Remaining portion
+    },
+    /**
+     * Separators
+     */
+    separator: {
+        vertical: "│",
+        horizontal: "─",
+        cross: "┼",
+        topLeft: "┌",
+        topRight: "┐",
+        bottomLeft: "└",
+        bottomRight: "┘",
+        teeLeft: "├",
+        teeRight: "┤",
+        teeTop: "┬",
+        teeBottom: "┴",
+    },
+};
+/**
+ * Layout Constants
+ */
+export const Layout = {
+    /**
+     * Padding values
+     */
+    padding: {
+        none: 0,
+        xs: 1,
+        sm: 2,
+        md: 4,
+        lg: 8,
+    },
+    /**
+     * Sidebar width
+     */
+    sidebar: {
+        width: 40,
+        minWidth: 30,
+        maxWidth: 60,
+    },
+    /**
+     * Input height
+     */
+    input: {
+        minHeight: 3,
+        maxHeight: 10,
+    },
+    /**
+     * Progress bar width
+     */
+    progressBar: {
+        width: 10,
+    },
+};
+/**
+ * Animation Timing (milliseconds)
+ */
+export const Timing = {
+    /**
+     * Event batching interval for streaming
+     */
+    batchInterval: 16, // ~60fps
+    /**
+     * Debounce delay for input
+     */
+    debounce: 100,
+    /**
+     * Animation duration
+     */
+    animation: 150,
+};
+/**
+ * Get mode color by mode name
+ */
+export function getModeColor(mode) {
+    return Colors.mode[mode];
+}
+/**
+ * Get status color by status name
+ */
+export function getStatusColor(status) {
+    return Colors.status[status];
+}
+/**
+ * Get todo indicator by status
+ */
+export function getTodoIndicator(status) {
+    return Indicators.todo[status];
+}
+/**
+ * Create a progress bar string
+ * @param percent - Progress percentage (0-100)
+ * @param width - Width in characters (default 10)
+ */
+export function createProgressBar(percent, width = Layout.progressBar.width) {
+    const clamped = Math.max(0, Math.min(100, percent));
+    const filled = Math.round((clamped / 100) * width);
+    const empty = width - filled;
+    return `[${Indicators.progress.filled.repeat(filled)}${Indicators.progress.empty.repeat(empty)}]`;
+}
+//# sourceMappingURL=design.js.map

package/dist/ui/design.js.map

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

package/dist/ui/index.d.ts

@@ -0,0 +1,4 @@
+export { App } from "./App";
+export { Colors, Indicators, Layout, Timing } from "./design";
+export type { Mode, Status, TodoStatus, ToolStatus } from "./design";
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAE9D,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/ui/index.js

@@ -0,0 +1,3 @@
+export { App } from "./App";
+export { Colors, Indicators, Layout, Timing } from "./design";
+//# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/util/config.d.ts

@@ -0,0 +1,22 @@
+import z from "zod";
+declare const ConfigSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    defaultModel: z.ZodDefault<z.ZodString>;
+    defaultMode: z.ZodDefault<z.ZodString>;
+    thinking: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    apiKey: string;
+    defaultModel: string;
+    defaultMode: string;
+    thinking: boolean;
+}, {
+    apiKey: string;
+    defaultModel?: string | undefined;
+    defaultMode?: string | undefined;
+    thinking?: boolean | undefined;
+}>;
+type Config = z.infer<typeof ConfigSchema>;
+export declare function load(): Promise<Config>;
+export declare function save(config: Config): Promise<void>;
+export type { Config };
+//# sourceMappingURL=config.d.ts.map

package/dist/util/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/util/config.ts"],"names":[],"mappings":"AAGA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;EAKhB,CAAC;AAEH,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAqC3C,wBAAsB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAU5C;AAED,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxD;AAED,YAAY,EAAE,MAAM,EAAE,CAAC"}

package/dist/util/config.js

@@ -0,0 +1,55 @@
+import { Global } from "../global";
+import fs from "fs/promises";
+import path from "path";
+import z from "zod";
+const ConfigSchema = z.object({
+    apiKey: z.string().describe("Z.AI API key for authentication"),
+    defaultModel: z.string().default("glm-4.7").describe("Default GLM model to use"),
+    defaultMode: z.string().default("AUTO").describe("Default mode: AUTO, AGENT, PLANNER, PLAN-PRD, DEBUG"),
+    thinking: z.boolean().default(true).describe("Enable thinking mode"),
+});
+const configPath = path.join(Global.Path.config, "config.json");
+async function loadConfigFile() {
+    try {
+        const content = await fs.readFile(configPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch (e) {
+        if (e.code !== "ENOENT") {
+            throw e;
+        }
+        return {};
+    }
+}
+async function loadEnvVars() {
+    const env = {};
+    if (process.env["GLM_API_KEY"]) {
+        env.apiKey = process.env["GLM_API_KEY"];
+    }
+    return env;
+}
+function applyDefaults(config) {
+    return ConfigSchema.parse({
+        apiKey: config.apiKey,
+        defaultModel: config.defaultModel,
+        defaultMode: config.defaultMode,
+        thinking: config.thinking,
+    });
+}
+let cachedConfig = null;
+export async function load() {
+    if (cachedConfig !== null) {
+        return cachedConfig;
+    }
+    const fileConfig = await loadConfigFile();
+    const envConfig = await loadEnvVars();
+    const merged = { ...fileConfig, ...envConfig };
+    cachedConfig = applyDefaults(merged);
+    return cachedConfig;
+}
+export async function save(config) {
+    await fs.mkdir(Global.Path.config, { recursive: true });
+    await fs.writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
+    cachedConfig = config;
+}
+//# sourceMappingURL=config.js.map

package/dist/util/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/util/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC9D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAChF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IACvG,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CACrE,CAAC,CAAC;AAIH,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEhE,KAAK,UAAU,cAAc;IAC3B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,CAAC,CAAC;QACV,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW;IACxB,MAAM,GAAG,GAAoB,EAAE,CAAC;IAEhC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,MAAuB;IAC5C,OAAO,YAAY,CAAC,KAAK,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,cAAc,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,WAAW,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,EAAE,GAAG,UAAU,EAAE,GAAG,SAAS,EAAE,CAAC;IAC/C,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,MAAc;IACvC,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACzE,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC"}

package/dist/util/instructions.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Instruction File Discovery
+ * Finds and loads project instruction files in priority order
+ */
+declare const INSTRUCTION_FILES: readonly [".glm-cli/instructions.md", "AGENTS.md", "CLAUDE.md", "GEMINI.md", "QWEN.md", "KIMI.md", "COPILOT.md", ".cursorrules", ".windsurfrules"];
+export type InstructionFileName = typeof INSTRUCTION_FILES[number];
+export interface InstructionFile {
+    path: string;
+    name: InstructionFileName;
+    content: string;
+}
+/**
+ * Find the first instruction file in priority order
+ * @param dir - Directory to search in (defaults to cwd)
+ * @returns Path to found file, or null if none found
+ */
+export declare function findInstructions(dir?: string): Promise<string | null>;
+/**
+ * Load instruction file from a directory
+ * Results are cached per directory for the session
+ * @param dir - Directory to search in (defaults to cwd)
+ * @returns InstructionFile or null if none found
+ */
+export declare function loadInstructions(dir?: string): Promise<InstructionFile | null>;
+/**
+ * Clear the instruction cache
+ * Useful for testing or when files may have changed
+ */
+export declare function clearInstructionCache(): void;
+/**
+ * Clear cache for a specific directory
+ */
+export declare function clearInstructionCacheFor(dir: string): void;
+/**
+ * Get all supported instruction file names
+ */
+export declare function getInstructionFileNames(): readonly string[];
+export {};
+//# sourceMappingURL=instructions.d.ts.map

package/dist/util/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/util/instructions.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAGH,QAAA,MAAM,iBAAiB,oJAUb,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAEnE,MAAM,WAAW,eAAe;IAE9B,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,EAAE,mBAAmB,CAAC;IAE1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAiBD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWxB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA2BjC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAG1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,SAAS,MAAM,EAAE,CAE3D"}

package/dist/util/instructions.js

@@ -0,0 +1,96 @@
+import fs from "fs/promises";
+import path from "path";
+/**
+ * Instruction File Discovery
+ * Finds and loads project instruction files in priority order
+ */
+// Priority order for instruction files (first found wins)
+const INSTRUCTION_FILES = [
+    ".glm-cli/instructions.md",
+    "AGENTS.md",
+    "CLAUDE.md",
+    "GEMINI.md",
+    "QWEN.md",
+    "KIMI.md",
+    "COPILOT.md",
+    ".cursorrules",
+    ".windsurfrules",
+];
+// Cache for loaded instructions (per directory)
+const cache = new Map();
+/**
+ * Check if a file exists
+ */
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Find the first instruction file in priority order
+ * @param dir - Directory to search in (defaults to cwd)
+ * @returns Path to found file, or null if none found
+ */
+export async function findInstructions(dir = process.cwd()) {
+    const absoluteDir = path.resolve(dir);
+    for (const filename of INSTRUCTION_FILES) {
+        const filePath = path.join(absoluteDir, filename);
+        if (await fileExists(filePath)) {
+            return filePath;
+        }
+    }
+    return null;
+}
+/**
+ * Load instruction file from a directory
+ * Results are cached per directory for the session
+ * @param dir - Directory to search in (defaults to cwd)
+ * @returns InstructionFile or null if none found
+ */
+export async function loadInstructions(dir = process.cwd()) {
+    const absoluteDir = path.resolve(dir);
+    // Check cache first
+    if (cache.has(absoluteDir)) {
+        return cache.get(absoluteDir) ?? null;
+    }
+    // Find and load
+    const filePath = await findInstructions(absoluteDir);
+    if (!filePath) {
+        cache.set(absoluteDir, null);
+        return null;
+    }
+    const content = await fs.readFile(filePath, "utf-8");
+    const name = path.relative(absoluteDir, filePath);
+    const result = {
+        path: filePath,
+        name,
+        content,
+    };
+    cache.set(absoluteDir, result);
+    return result;
+}
+/**
+ * Clear the instruction cache
+ * Useful for testing or when files may have changed
+ */
+export function clearInstructionCache() {
+    cache.clear();
+}
+/**
+ * Clear cache for a specific directory
+ */
+export function clearInstructionCacheFor(dir) {
+    const absoluteDir = path.resolve(dir);
+    cache.delete(absoluteDir);
+}
+/**
+ * Get all supported instruction file names
+ */
+export function getInstructionFileNames() {
+    return INSTRUCTION_FILES;
+}
+//# sourceMappingURL=instructions.js.map

package/dist/util/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/util/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;GAGG;AAEH,0DAA0D;AAC1D,MAAM,iBAAiB,GAAG;IACxB,0BAA0B;IAC1B,WAAW;IACX,WAAW;IACX,WAAW;IACX,SAAS;IACT,SAAS;IACT,YAAY;IACZ,cAAc;IACd,gBAAgB;CACR,CAAC;AAaX,gDAAgD;AAChD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkC,CAAC;AAExD;;GAEG;AACH,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAc,OAAO,CAAC,GAAG,EAAE;IAE3B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEtC,KAAK,MAAM,QAAQ,IAAI,iBAAiB,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,MAAM,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAc,OAAO,CAAC,GAAG,EAAE;IAE3B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEtC,oBAAoB;IACpB,IAAI,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;IACxC,CAAC;IAED,gBAAgB;IAChB,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAErD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAwB,CAAC;IAEzE,MAAM,MAAM,GAAoB;QAC9B,IAAI,EAAE,QAAQ;QACd,IAAI;QACJ,OAAO;KACR,CAAC;IAEF,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/util/lock.d.ts

@@ -0,0 +1,18 @@
+interface Disposable {
+    [Symbol.dispose](): void;
+}
+interface AsyncDisposable extends Disposable {
+    [Symbol.asyncDispose](): Promise<void>;
+}
+declare class LockImpl implements AsyncDisposable {
+    private readonly lockFile;
+    constructor(lockFile: string);
+    [Symbol.dispose](): void;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+export declare namespace Lock {
+    const read: (target: string) => Promise<LockImpl>;
+    const write: (target: string) => Promise<LockImpl>;
+}
+export {};
+//# sourceMappingURL=lock.d.ts.map

package/dist/util/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/util/lock.ts"],"names":[],"mappings":"AAKA,UAAU,UAAU;IAClB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED,UAAU,eAAgB,SAAQ,UAAU;IAC1C,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAOD,cAAM,QAAS,YAAW,eAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,QAAQ,EAAE,MAAM;IAI5B,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAQlB,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAS7C;AAED,yBAAiB,IAAI,CAAC;IAuBb,MAAM,IAAI,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,QAAQ,CAI3D,CAAC;IAEK,MAAM,KAAK,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,QAAQ,CAI5D,CAAC;CACH"}