@bluelovers/opencode-arise 0.1.6

package/dist/cli/index.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env bun
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { getBanner } from "../hooks";
+import { PLUGIN_NAME, findOpencodeConfig, getAriseConfigPath, createDefaultAriseConfig, } from "../config/paths";
+function parseJsonc(content) {
+    // More robust JSONC parsing:
+    // 1. Remove single-line comments (but not inside strings)
+    // 2. Remove multi-line comments
+    // 3. Remove trailing commas
+    let result = "";
+    let inString = false;
+    let inSingleLineComment = false;
+    let inMultiLineComment = false;
+    let i = 0;
+    while (i < content.length) {
+        const char = content[i];
+        const nextChar = content[i + 1];
+        if (inSingleLineComment) {
+            if (char === "\n") {
+                inSingleLineComment = false;
+                result += char;
+            }
+            i++;
+            continue;
+        }
+        if (inMultiLineComment) {
+            if (char === "*" && nextChar === "/") {
+                inMultiLineComment = false;
+                i += 2;
+                continue;
+            }
+            i++;
+            continue;
+        }
+        if (inString) {
+            result += char;
+            if (char === "\\") {
+                // Skip escaped character
+                result += nextChar ?? "";
+                i += 2;
+                continue;
+            }
+            if (char === '"') {
+                inString = false;
+            }
+            i++;
+            continue;
+        }
+        // Not in string or comment
+        if (char === '"') {
+            inString = true;
+            result += char;
+            i++;
+            continue;
+        }
+        if (char === "/" && nextChar === "/") {
+            inSingleLineComment = true;
+            i += 2;
+            continue;
+        }
+        if (char === "/" && nextChar === "*") {
+            inMultiLineComment = true;
+            i += 2;
+            continue;
+        }
+        result += char;
+        i++;
+    }
+    // Remove trailing commas
+    result = result.replace(/,(\s*[}\]])/g, "$1");
+    return JSON.parse(result);
+}
+function addPluginToConfig(configPath) {
+    let content;
+    try {
+        content = readFileSync(configPath, "utf-8");
+    }
+    catch (err) {
+        console.error(`✗ Failed to read config file: ${configPath}`);
+        console.error(`  Error: ${err instanceof Error ? err.message : err}`);
+        return false;
+    }
+    let config;
+    try {
+        config = parseJsonc(content);
+    }
+    catch (err) {
+        console.error(`✗ Failed to parse config file: ${configPath}`);
+        console.error(`  Error: ${err instanceof Error ? err.message : err}`);
+        console.error(`\n  Your config file may have invalid JSON syntax.`);
+        console.error(`  You can manually add "${PLUGIN_NAME}" to the "plugin" array.`);
+        return false;
+    }
+    try {
+        if (!config.plugin) {
+            config.plugin = [];
+        }
+        const plugins = config.plugin;
+        if (plugins.includes(PLUGIN_NAME)) {
+            console.log(`✓ ${PLUGIN_NAME} already registered in OpenCode config`);
+            return true;
+        }
+        plugins.push(PLUGIN_NAME);
+        const newContent = JSON.stringify(config, null, 2);
+        writeFileSync(configPath, newContent, "utf-8");
+        console.log(`✓ Added ${PLUGIN_NAME} to ${configPath}`);
+        return true;
+    }
+    catch (err) {
+        console.error(`✗ Failed to update config:`, err);
+        return false;
+    }
+}
+function createDefaultAriseConfigHandler() {
+    const configPath = getAriseConfigPath();
+    const success = createDefaultAriseConfig(configPath);
+    if (success) {
+        console.log(`✓ Created default config at ${configPath}`);
+    }
+    else {
+        console.log(`✓ opencode-arise.json already exists at ${configPath}`);
+    }
+}
+function install() {
+    console.log(getBanner());
+    console.log("\n🌑 Installing opencode-arise...\n");
+    const configPath = findOpencodeConfig();
+    if (!configPath) {
+        console.error("✗ OpenCode config not found. Is OpenCode installed?");
+        console.error("  Expected: ~/.config/opencode/opencode.json");
+        process.exit(1);
+    }
+    // TypeScript narrowing: configPath is guaranteed to be string here after check
+    const success = addPluginToConfig(configPath);
+    if (!success) {
+        process.exit(1);
+    }
+    createDefaultAriseConfigHandler();
+    console.log("\n⚔️  Installation complete!");
+    console.log("\n  The Shadow Army awaits. Run 'opencode' to begin.\n");
+    console.log("  Shadows available:");
+    console.log("    @beru      - Fast codebase scout (Ant King)");
+    console.log("    @igris     - Precise implementation (Loyal Knight)");
+    console.log("    @bellion   - Strategic planning (Grand Marshal)");
+    console.log("    @tusk      - UI/UX specialist");
+    console.log("    @tank      - External research");
+    console.log("    @shadow-sovereign - Deep reasoning (Full Power)");
+    console.log("");
+}
+function doctor() {
+    console.log("🔍 Checking opencode-arise installation...\n");
+    const configPath = findOpencodeConfig();
+    if (!configPath) {
+        console.log(`✗ OpenCode config not found: ${configPath}`);
+        // process.exit(1);
+    }
+    else {
+        console.log(`✓ OpenCode config: ${configPath}`);
+        try {
+            const content = readFileSync(configPath, "utf-8");
+            const config = parseJsonc(content);
+            const plugins = config.plugin ?? [];
+            if (plugins.includes(PLUGIN_NAME)) {
+                console.log(`✓ ${PLUGIN_NAME} is registered`);
+            }
+            else {
+                console.log(`✗ ${PLUGIN_NAME} is NOT registered`);
+                console.log(`  Run: bunx ${PLUGIN_NAME} install`);
+            }
+        }
+        catch (err) {
+            console.log(`✗ Failed to read config:`, err instanceof Error ? err.message : err);
+        }
+    }
+    const ariseConfigPath = getAriseConfigPath();
+    if (existsSync(ariseConfigPath)) {
+        console.log(`✓ opencode-arise.json exists: ${ariseConfigPath}`);
+    }
+    else {
+        console.log(`○ opencode-arise.json not found (optional): ${ariseConfigPath}`);
+    }
+    console.log("\n✅ Doctor check complete");
+}
+function showHelp() {
+    console.log(`
+${getBanner()}
+Usage: opencode-arise <command>
+
+Commands:
+  install   Register plugin with OpenCode and create default config
+  doctor    Check installation status
+  help      Show this help message
+
+Examples:
+  bunx opencode-arise install
+  npx opencode-arise install
+`);
+}
+// Main
+const args = process.argv.slice(2);
+const command = args[0];
+switch (command) {
+    case "install":
+        install();
+        break;
+    case "doctor":
+        doctor();
+        break;
+    case "help":
+    case "--help":
+    case "-h":
+        showHelp();
+        break;
+    default:
+        if (command) {
+            console.error(`Unknown command: ${command}`);
+        }
+        showHelp();
+        process.exit(command ? 1 : 0);
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/config/paths.d.ts

@@ -0,0 +1,91 @@
+/**
+ * 配置路徑工具函數
+ * Configuration path utility functions
+ *
+ * 集中管理所有與配置文件路徑相關的邏輯
+ * Centralized management of all config file path related logic
+ */
+import { type AriseConfig } from "./schema";
+/**
+ * OpenCode 插件名稱
+ * OpenCode plugin name
+ */
+export declare const PLUGIN_NAME = "opencode-arise";
+/**
+ * Arise 配置檔案名稱
+ * Arise config file name
+ */
+export declare const CONFIG_FILENAME = "opencode-arise.json";
+/**
+ * OpenCode 配置檔案路徑列表
+ * OpenCode config file path list
+ *
+ * @type {string[]}
+ */
+export declare const OPENCODE_CONFIG_PATHS: string[];
+/**
+ * 取得 OpenCode 配置目錄路徑
+ * Get OpenCode config directory path
+ *
+ * @returns {string} OpenCode 配置目錄路徑
+ */
+export declare function getOpencodeConfigDir(): string;
+/**
+ * 取得 Arise 配置檔案路徑
+ * Get Arise config file path
+ *
+ * @returns {string} Arise 配置檔案完整路徑
+ */
+export declare function getAriseConfigPath(): string;
+/**
+ * 取得 Arise 配置檔案搜尋路徑列表
+ * Get Arise config file search path list
+ *
+ * 依序為：
+ * 1. 工作目錄下的 .opencode/ 目錄
+ * 2. 使用者配置目錄 (~/.config/opencode/)
+ *
+ * @param worktree - 工作目錄路徑，若為空則只返回全局配置路徑
+ * @returns {string[]} 配置檔案搜尋路徑列表（順序：由局部到全局）
+ */
+export declare function getAriseConfigPaths(worktree?: string): string[];
+/**
+ * 查詢 OpenCode 配置檔案路徑
+ * Find OpenCode config file path
+ *
+ * @returns {string | null} 配置檔案路徑，若不存在則返回 null
+ */
+export declare function findOpencodeConfig(): string | null;
+/**
+ * 檢查 OpenCode 配置檔案是否存在
+ * Check if OpenCode config file exists
+ *
+ * @returns {boolean} 配置檔案是否存在
+ */
+export declare function hasOpencodeConfig(): boolean;
+/**
+ * 檢查 Arise 配置檔案是否存在
+ * Check if Arise config file exists
+ *
+ * @param worktree - 可選的工作目錄路徑
+ * @returns {boolean} 配置檔案是否存在
+ */
+export declare function hasAriseConfig(worktree?: string): boolean;
+/**
+ * 取得預設 Arise 配置物件
+ * Get default Arise config object
+ *
+ * @returns {AriseConfig} 預設配置物件
+ */
+export declare function getDefaultAriseConfig(): AriseConfig;
+/**
+ * 建立預設 Arise 配置檔案
+ * Create default Arise config file
+ *
+ * 當配置檔案不存在時，会建立預設配置
+ * Creates default config when config file does not exist
+ *
+ * @param configPath - 自定義配置檔案路徑（可選，預設為全局配置路徑）
+ * @returns {boolean} 是否成功建立配置檔案
+ */
+export declare function createDefaultAriseConfig(configPath?: string): boolean;

package/dist/config/paths.js

@@ -0,0 +1,166 @@
+/**
+ * 配置路徑工具函數
+ * Configuration path utility functions
+ *
+ * 集中管理所有與配置文件路徑相關的邏輯
+ * Centralized management of all config file path related logic
+ */
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { resolve } from "path";
+import { SHADOW_AGENTS } from "../agents/shadows";
+/**
+ * 取得使用者主目錄
+ * Get user home directory
+ *
+ * 使用 os.homedir() 確保跨平台相容性
+ * Use os.homedir() for cross-platform compatibility
+ *
+ * @returns {string} 使用者主目錄路徑
+ */
+function getHomeDir() {
+    return homedir();
+}
+/**
+ * OpenCode 插件名稱
+ * OpenCode plugin name
+ */
+export const PLUGIN_NAME = "opencode-arise";
+/**
+ * Arise 配置檔案名稱
+ * Arise config file name
+ */
+export const CONFIG_FILENAME = "opencode-arise.json";
+/**
+ * OpenCode 配置檔案路徑列表
+ * OpenCode config file path list
+ *
+ * @type {string[]}
+ */
+export const OPENCODE_CONFIG_PATHS = [
+    resolve(getHomeDir(), ".config/opencode/opencode.json"),
+    resolve(getHomeDir(), ".config/opencode/opencode.jsonc"),
+];
+/**
+ * 取得 OpenCode 配置目錄路徑
+ * Get OpenCode config directory path
+ *
+ * @returns {string} OpenCode 配置目錄路徑
+ */
+export function getOpencodeConfigDir() {
+    return resolve(getHomeDir(), ".config/opencode");
+}
+/**
+ * 取得 Arise 配置檔案路徑
+ * Get Arise config file path
+ *
+ * @returns {string} Arise 配置檔案完整路徑
+ */
+export function getAriseConfigPath() {
+    return resolve(getOpencodeConfigDir(), CONFIG_FILENAME);
+}
+/**
+ * 取得 Arise 配置檔案搜尋路徑列表
+ * Get Arise config file search path list
+ *
+ * 依序為：
+ * 1. 工作目錄下的 .opencode/ 目錄
+ * 2. 使用者配置目錄 (~/.config/opencode/)
+ *
+ * @param worktree - 工作目錄路徑，若為空則只返回全局配置路徑
+ * @returns {string[]} 配置檔案搜尋路徑列表（順序：由局部到全局）
+ */
+export function getAriseConfigPaths(worktree) {
+    const globalPath = resolve(getOpencodeConfigDir(), CONFIG_FILENAME);
+    if (!worktree) {
+        return [globalPath];
+    }
+    const localPath = resolve(worktree, ".opencode", CONFIG_FILENAME);
+    // 返回順序：先局部（local），後全局（global）
+    // 載入時需要反序（先全局，後局部）
+    return [localPath, globalPath];
+}
+/**
+ * 查詢 OpenCode 配置檔案路徑
+ * Find OpenCode config file path
+ *
+ * @returns {string | null} 配置檔案路徑，若不存在則返回 null
+ */
+export function findOpencodeConfig() {
+    for (const path of OPENCODE_CONFIG_PATHS) {
+        if (existsSync(path)) {
+            return path;
+        }
+    }
+    return null;
+}
+/**
+ * 檢查 OpenCode 配置檔案是否存在
+ * Check if OpenCode config file exists
+ *
+ * @returns {boolean} 配置檔案是否存在
+ */
+export function hasOpencodeConfig() {
+    return findOpencodeConfig() !== null;
+}
+/**
+ * 檢查 Arise 配置檔案是否存在
+ * Check if Arise config file exists
+ *
+ * @param worktree - 可選的工作目錄路徑
+ * @returns {boolean} 配置檔案是否存在
+ */
+export function hasAriseConfig(worktree) {
+    const paths = getAriseConfigPaths(worktree);
+    return paths.some((path) => existsSync(path));
+}
+/**
+ * 取得預設 Arise 配置物件
+ * Get default Arise config object
+ *
+ * @returns {AriseConfig} 預設配置物件
+ */
+export function getDefaultAriseConfig() {
+    // 從 SHADOW_AGENTS 產生預設的 agents 設定
+    // Generate default agents config from SHADOW_AGENTS
+    const defaultAgents = Object.fromEntries(Object.entries(SHADOW_AGENTS).map(([name, agent]) => [
+        name,
+        { model: agent.model },
+    ]));
+    return {
+        show_banner: true,
+        disabled_shadows: [],
+        disabled_hooks: [],
+        agents: defaultAgents,
+    };
+}
+/**
+ * 建立預設 Arise 配置檔案
+ * Create default Arise config file
+ *
+ * 當配置檔案不存在時，会建立預設配置
+ * Creates default config when config file does not exist
+ *
+ * @param configPath - 自定義配置檔案路徑（可選，預設為全局配置路徑）
+ * @returns {boolean} 是否成功建立配置檔案
+ */
+export function createDefaultAriseConfig(configPath) {
+    const targetPath = configPath || getAriseConfigPath();
+    if (existsSync(targetPath)) {
+        return false;
+    }
+    const configDir = resolve(targetPath, "..");
+    const defaultConfig = getDefaultAriseConfig();
+    try {
+        if (!existsSync(configDir)) {
+            mkdirSync(configDir, { recursive: true });
+        }
+        writeFileSync(targetPath, JSON.stringify(defaultConfig, null, 2), "utf-8");
+        return true;
+    }
+    catch (err) {
+        console.error("✗ Failed to create config:", err);
+        return false;
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/config/paths.js.map

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

package/dist/config/schema.d.ts

@@ -0,0 +1,64 @@
+import { z } from "zod";
+export declare const ShadowName: z.ZodEnum<{
+    monarch: "monarch";
+    beru: "beru";
+    igris: "igris";
+    bellion: "bellion";
+    tusk: "tusk";
+    tank: "tank";
+    "shadow-sovereign": "shadow-sovereign";
+}>;
+export type ShadowName = z.infer<typeof ShadowName>;
+export declare const HookName: z.ZodEnum<{
+    "arise-banner": "arise-banner";
+    "output-shaper": "output-shaper";
+    "compaction-preserver": "compaction-preserver";
+    "todo-enforcer": "todo-enforcer";
+}>;
+export type HookName = z.infer<typeof HookName>;
+export declare const AgentOverride: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const AriseConfigSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    disabled_shadows: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        monarch: "monarch";
+        beru: "beru";
+        igris: "igris";
+        bellion: "bellion";
+        tusk: "tusk";
+        tank: "tank";
+        "shadow-sovereign": "shadow-sovereign";
+    }>>>;
+    disabled_hooks: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "arise-banner": "arise-banner";
+        "output-shaper": "output-shaper";
+        "compaction-preserver": "compaction-preserver";
+        "todo-enforcer": "todo-enforcer";
+    }>>>;
+    show_banner: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    banner_every_session: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    agents: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        monarch: "monarch";
+        beru: "beru";
+        igris: "igris";
+        bellion: "bellion";
+        tusk: "tusk";
+        tank: "tank";
+        "shadow-sovereign": "shadow-sovereign";
+    }>, z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    output_shaping: z.ZodOptional<z.ZodObject<{
+        max_chars: z.ZodDefault<z.ZodNumber>;
+        preserve_errors: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    compaction: z.ZodOptional<z.ZodObject<{
+        threshold_percent: z.ZodDefault<z.ZodNumber>;
+        preserve_todos: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AriseConfig = z.infer<typeof AriseConfigSchema>;
+export declare const DEFAULT_CONFIG: AriseConfig;

package/dist/config/schema.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+export const ShadowName = z.enum([
+    "monarch",
+    "beru",
+    "igris",
+    "bellion",
+    "tusk",
+    "tank",
+    "shadow-sovereign",
+]);
+export const HookName = z.enum([
+    "arise-banner",
+    "output-shaper",
+    "compaction-preserver",
+    "todo-enforcer",
+]);
+export const AgentOverride = z.object({
+    model: z.string().optional(),
+    disabled: z.boolean().optional(),
+});
+export const AriseConfigSchema = z.object({
+    $schema: z.string().optional(),
+    disabled_shadows: z.array(ShadowName).optional(),
+    disabled_hooks: z.array(HookName).optional(),
+    show_banner: z.boolean().default(true).optional(),
+    banner_every_session: z.boolean().default(false).optional(),
+    agents: z.record(ShadowName, AgentOverride).optional(),
+    output_shaping: z
+        .object({
+        max_chars: z.number().default(12000),
+        preserve_errors: z.boolean().default(true),
+    })
+        .optional(),
+    compaction: z
+        .object({
+        threshold_percent: z.number().min(50).max(95).default(80),
+        preserve_todos: z.boolean().default(true),
+    })
+        .optional(),
+});
+export const DEFAULT_CONFIG = {
+    show_banner: true,
+    banner_every_session: false,
+    disabled_shadows: [],
+    disabled_hooks: [],
+    output_shaping: {
+        max_chars: 12000,
+        preserve_errors: true,
+    },
+    compaction: {
+        threshold_percent: 80,
+        preserve_todos: true,
+    },
+};
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC;IAC/B,SAAS;IACT,MAAM;IACN,OAAO;IACP,SAAS;IACT,MAAM;IACN,MAAM;IACN,kBAAkB;CACnB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC;IAC7B,cAAc;IACd,eAAe;IACf,sBAAsB;IACtB,eAAe;CAChB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IAChD,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE;IAC5C,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IACjD,oBAAoB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IAC3D,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,QAAQ,EAAE;IACtD,cAAc,EAAE,CAAC;SACd,MAAM,CAAC;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QACpC,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;KAC3C,CAAC;SACD,QAAQ,EAAE;IACb,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;KAC1C,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,WAAW,EAAE,IAAI;IACjB,oBAAoB,EAAE,KAAK;IAC3B,gBAAgB,EAAE,EAAE;IACpB,cAAc,EAAE,EAAE;IAClB,cAAc,EAAE;QACd,SAAS,EAAE,KAAK;QAChB,eAAe,EAAE,IAAI;KACtB;IACD,UAAU,EAAE;QACV,iBAAiB,EAAE,EAAE;QACrB,cAAc,EAAE,IAAI;KACrB;CACF,CAAC"}

package/dist/hooks/arise-banner.d.ts

@@ -0,0 +1,6 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function createAriseBannerHook(ctx: PluginInput): {
+    onSessionCreated(): Promise<void>;
+};
+export declare function getBanner(): string;
+export declare function printBannerToConsole(): void;

package/dist/hooks/arise-banner.js

@@ -0,0 +1,50 @@
+const BANNER_ASCII = `
+╔═══════════════════════════════════════════════════════╗
+║                                                       ║
+║               ⚔️  A R I S E !  ⚔️                     ║
+║                                                       ║
+║         ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░           ║
+║         ░░    Shadow Army Assembled    ░░░           ║
+║         ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░           ║
+║                                                       ║
+║   Monarch ready. Shadows await your command.          ║
+║                                                       ║
+╚═══════════════════════════════════════════════════════╝
+`;
+const TOAST_MESSAGE = "⚔️ ARISE! Shadow Army Assembled. Monarch ready.";
+let bannerShownThisProcess = false;
+export function createAriseBannerHook(ctx) {
+    const showToast = async () => {
+        try {
+            await ctx.client.tui.showToast({
+                body: {
+                    title: "opencode-arise",
+                    message: TOAST_MESSAGE,
+                    variant: "info",
+                    duration: 4000,
+                },
+            });
+        }
+        catch {
+            // TUI might not be available (non-interactive mode)
+        }
+    };
+    return {
+        async onSessionCreated() {
+            if (!bannerShownThisProcess) {
+                bannerShownThisProcess = true;
+                await showToast();
+            }
+        },
+    };
+}
+export function getBanner() {
+    return BANNER_ASCII;
+}
+export function printBannerToConsole() {
+    if (!bannerShownThisProcess) {
+        console.log(BANNER_ASCII);
+        bannerShownThisProcess = true;
+    }
+}
+//# sourceMappingURL=arise-banner.js.map

package/dist/hooks/arise-banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arise-banner.js","sourceRoot":"","sources":["../../src/hooks/arise-banner.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG;;;;;;;;;;;;CAYpB,CAAC;AAEF,MAAM,aAAa,GAAG,iDAAiD,CAAC;AAExE,IAAI,sBAAsB,GAAG,KAAK,CAAC;AAEnC,MAAM,UAAU,qBAAqB,CAAC,GAAgB;IACpD,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;gBAC7B,IAAI,EAAE;oBACJ,KAAK,EAAE,gBAAgB;oBACvB,OAAO,EAAE,aAAa;oBACtB,OAAO,EAAE,MAAM;oBACf,QAAQ,EAAE,IAAI;iBACf;aACF,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;QACtD,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,gBAAgB;YACpB,IAAI,CAAC,sBAAsB,EAAE,CAAC;gBAC5B,sBAAsB,GAAG,IAAI,CAAC;gBAC9B,MAAM,SAAS,EAAE,CAAC;YACpB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1B,sBAAsB,GAAG,IAAI,CAAC;IAChC,CAAC;AACH,CAAC"}