oh-my-musacode 0.0.1

package/dist/tools/lsp/types.d.ts

@@ -0,0 +1,123 @@
+export interface LSPServerConfig {
+    id: string;
+    command: string[];
+    extensions: string[];
+    disabled?: boolean;
+    env?: Record<string, string>;
+    initialization?: Record<string, unknown>;
+}
+export interface Position {
+    line: number;
+    character: number;
+}
+export interface Range {
+    start: Position;
+    end: Position;
+}
+export interface Location {
+    uri: string;
+    range: Range;
+}
+export interface LocationLink {
+    targetUri: string;
+    targetRange: Range;
+    targetSelectionRange: Range;
+    originSelectionRange?: Range;
+}
+export interface SymbolInfo {
+    name: string;
+    kind: number;
+    location: Location;
+    containerName?: string;
+}
+export interface DocumentSymbol {
+    name: string;
+    kind: number;
+    range: Range;
+    selectionRange: Range;
+    children?: DocumentSymbol[];
+}
+export interface Diagnostic {
+    range: Range;
+    severity?: number;
+    code?: string | number;
+    source?: string;
+    message: string;
+}
+export interface TextDocumentIdentifier {
+    uri: string;
+}
+export interface VersionedTextDocumentIdentifier extends TextDocumentIdentifier {
+    version: number | null;
+}
+export interface TextEdit {
+    range: Range;
+    newText: string;
+}
+export interface TextDocumentEdit {
+    textDocument: VersionedTextDocumentIdentifier;
+    edits: TextEdit[];
+}
+export interface CreateFile {
+    kind: "create";
+    uri: string;
+    options?: {
+        overwrite?: boolean;
+        ignoreIfExists?: boolean;
+    };
+}
+export interface RenameFile {
+    kind: "rename";
+    oldUri: string;
+    newUri: string;
+    options?: {
+        overwrite?: boolean;
+        ignoreIfExists?: boolean;
+    };
+}
+export interface DeleteFile {
+    kind: "delete";
+    uri: string;
+    options?: {
+        recursive?: boolean;
+        ignoreIfNotExists?: boolean;
+    };
+}
+export interface WorkspaceEdit {
+    changes?: {
+        [uri: string]: TextEdit[];
+    };
+    documentChanges?: (TextDocumentEdit | CreateFile | RenameFile | DeleteFile)[];
+}
+export interface PrepareRenameResult {
+    range: Range;
+    placeholder?: string;
+}
+export interface PrepareRenameDefaultBehavior {
+    defaultBehavior: boolean;
+}
+export interface ServerLookupInfo {
+    id: string;
+    command: string[];
+    extensions: string[];
+}
+export type ServerLookupResult = {
+    status: "found";
+    server: ResolvedServer;
+} | {
+    status: "not_configured";
+    extension: string;
+    availableServers: string[];
+} | {
+    status: "not_installed";
+    server: ServerLookupInfo;
+    installHint: string;
+};
+export interface ResolvedServer {
+    id: string;
+    command: string[];
+    extensions: string[];
+    priority: number;
+    env?: Record<string, string>;
+    initialization?: Record<string, unknown>;
+}

package/dist/tools/lsp/utils.d.ts

@@ -0,0 +1,26 @@
+import { LSPClient } from "./client";
+import type { Location, LocationLink, DocumentSymbol, SymbolInfo, Diagnostic, PrepareRenameResult, PrepareRenameDefaultBehavior, Range, WorkspaceEdit, TextEdit, ServerLookupResult } from "./types";
+export declare function findWorkspaceRoot(filePath: string): string;
+export declare function uriToPath(uri: string): string;
+export declare function formatServerLookupError(result: Exclude<ServerLookupResult, {
+    status: "found";
+}>): string;
+export declare function withLspClient<T>(filePath: string, fn: (client: LSPClient) => Promise<T>): Promise<T>;
+export declare function formatLocation(loc: Location | LocationLink): string;
+export declare function formatSymbolKind(kind: number): string;
+export declare function formatSeverity(severity: number | undefined): string;
+export declare function formatDocumentSymbol(symbol: DocumentSymbol, indent?: number): string;
+export declare function formatSymbolInfo(symbol: SymbolInfo): string;
+export declare function formatDiagnostic(diag: Diagnostic): string;
+export declare function filterDiagnosticsBySeverity(diagnostics: Diagnostic[], severityFilter?: "error" | "warning" | "information" | "hint" | "all"): Diagnostic[];
+export declare function formatPrepareRenameResult(result: PrepareRenameResult | PrepareRenameDefaultBehavior | Range | null): string;
+export declare function formatTextEdit(edit: TextEdit): string;
+export declare function formatWorkspaceEdit(edit: WorkspaceEdit | null): string;
+export interface ApplyResult {
+    success: boolean;
+    filesModified: string[];
+    totalEdits: number;
+    errors: string[];
+}
+export declare function applyWorkspaceEdit(edit: WorkspaceEdit | null): ApplyResult;
+export declare function formatApplyResult(result: ApplyResult): string;

package/dist/tools/session-manager/constants.d.ts

@@ -0,0 +1,12 @@
+export declare const MUSACODE_STORAGE: string;
+export declare const MESSAGE_STORAGE: string;
+export declare const PART_STORAGE: string;
+export declare const SESSION_STORAGE: string;
+export declare const TODO_DIR: string;
+export declare const TRANSCRIPT_DIR: string;
+export declare const SESSION_LIST_DESCRIPTION = "List all MusaCode sessions with optional filtering.\n\nReturns a list of available session IDs with metadata including message count, date range, and agents used.\n\nArguments:\n- limit (optional): Maximum number of sessions to return\n- from_date (optional): Filter sessions from this date (ISO 8601 format)\n- to_date (optional): Filter sessions until this date (ISO 8601 format)\n\nExample output:\n| Session ID | Messages | First | Last | Agents |\n|------------|----------|-------|------|--------|\n| ses_abc123 | 45 | 2025-12-20 | 2025-12-24 | build, oracle |\n| ses_def456 | 12 | 2025-12-19 | 2025-12-19 | build |";
+export declare const SESSION_READ_DESCRIPTION = "Read messages and history from an MusaCode session.\n\nReturns a formatted view of session messages with role, timestamp, and content. Optionally includes todos and transcript data.\n\nArguments:\n- session_id (required): Session ID to read\n- include_todos (optional): Include todo list if available (default: false)\n- include_transcript (optional): Include transcript log if available (default: false)\n- limit (optional): Maximum number of messages to return (default: all)\n\nExample output:\nSession: ses_abc123\nMessages: 45\nDate Range: 2025-12-20 to 2025-12-24\n\n[Message 1] user (2025-12-20 10:30:00)\nHello, can you help me with...\n\n[Message 2] assistant (2025-12-20 10:30:15)\nOf course! Let me help you with...";
+export declare const SESSION_SEARCH_DESCRIPTION = "Search for content within MusaCode session messages.\n\nPerforms full-text search across session messages and returns matching excerpts with context.\n\nArguments:\n- query (required): Search query string\n- session_id (optional): Search within specific session only (default: all sessions)\n- case_sensitive (optional): Case-sensitive search (default: false)\n- limit (optional): Maximum number of results to return (default: 20)\n\nExample output:\nFound 3 matches across 2 sessions:\n\n[ses_abc123] Message msg_001 (user)\n...implement the **session manager** tool...\n\n[ses_abc123] Message msg_005 (assistant)\n...I'll create a **session manager** with full search...\n\n[ses_def456] Message msg_012 (user)\n...use the **session manager** to find...";
+export declare const SESSION_INFO_DESCRIPTION = "Get metadata and statistics about an MusaCode session.\n\nReturns detailed information about a session including message count, date range, agents used, and available data sources.\n\nArguments:\n- session_id (required): Session ID to inspect\n\nExample output:\nSession ID: ses_abc123\nMessages: 45\nDate Range: 2025-12-20 10:30:00 to 2025-12-24 15:45:30\nDuration: 4 days, 5 hours\nAgents Used: build, oracle, librarian\nHas Todos: Yes (12 items, 8 completed)\nHas Transcript: Yes (234 entries)";
+export declare const SESSION_DELETE_DESCRIPTION = "Delete an MusaCode session and all associated data.\n\nRemoves session messages, parts, todos, and transcript. This operation cannot be undone.\n\nArguments:\n- session_id (required): Session ID to delete\n- confirm (required): Must be true to confirm deletion\n\nExample:\nsession_delete(session_id=\"ses_abc123\", confirm=true)\nSuccessfully deleted session ses_abc123";
+export declare const TOOL_NAME_PREFIX = "session_";

package/dist/tools/session-manager/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./tools";
+export * from "./types";
+export * from "./constants";

package/dist/tools/session-manager/storage.d.ts

@@ -0,0 +1,12 @@
+import type { SessionMessage, SessionInfo, TodoItem, SessionMetadata } from "./types";
+export interface GetMainSessionsOptions {
+    directory?: string;
+}
+export declare function getMainSessions(options: GetMainSessionsOptions): Promise<SessionMetadata[]>;
+export declare function getAllSessions(): Promise<string[]>;
+export declare function getMessageDir(sessionID: string): string;
+export declare function sessionExists(sessionID: string): boolean;
+export declare function readSessionMessages(sessionID: string): Promise<SessionMessage[]>;
+export declare function readSessionTodos(sessionID: string): Promise<TodoItem[]>;
+export declare function readSessionTranscript(sessionID: string): Promise<number>;
+export declare function getSessionInfo(sessionID: string): Promise<SessionInfo | null>;

package/dist/tools/session-manager/storage.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/session-manager/tools.d.ts

@@ -0,0 +1,5 @@
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+export declare const session_list: ToolDefinition;
+export declare const session_read: ToolDefinition;
+export declare const session_search: ToolDefinition;
+export declare const session_info: ToolDefinition;

package/dist/tools/session-manager/tools.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/session-manager/types.d.ts

@@ -0,0 +1,89 @@
+export interface SessionMessage {
+    id: string;
+    role: "user" | "assistant";
+    agent?: string;
+    time?: {
+        created: number;
+        updated?: number;
+    };
+    parts: MessagePart[];
+}
+export interface MessagePart {
+    id: string;
+    type: string;
+    text?: string;
+    thinking?: string;
+    tool?: string;
+    callID?: string;
+    input?: Record<string, unknown>;
+    output?: string;
+    error?: string;
+}
+export interface SessionInfo {
+    id: string;
+    message_count: number;
+    first_message?: Date;
+    last_message?: Date;
+    agents_used: string[];
+    has_todos: boolean;
+    has_transcript: boolean;
+    todos?: TodoItem[];
+    transcript_entries?: number;
+}
+export interface TodoItem {
+    id: string;
+    content: string;
+    status: "pending" | "in_progress" | "completed" | "cancelled";
+    priority?: string;
+}
+export interface SearchResult {
+    session_id: string;
+    message_id: string;
+    role: string;
+    excerpt: string;
+    match_count: number;
+    timestamp?: number;
+}
+export interface SessionMetadata {
+    id: string;
+    version?: string;
+    projectID: string;
+    directory: string;
+    title?: string;
+    parentID?: string;
+    time: {
+        created: number;
+        updated: number;
+    };
+    summary?: {
+        additions: number;
+        deletions: number;
+        files: number;
+    };
+}
+export interface SessionListArgs {
+    limit?: number;
+    offset?: number;
+    from_date?: string;
+    to_date?: string;
+    project_path?: string;
+}
+export interface SessionReadArgs {
+    session_id: string;
+    include_todos?: boolean;
+    include_transcript?: boolean;
+    limit?: number;
+}
+export interface SessionSearchArgs {
+    query: string;
+    session_id?: string;
+    case_sensitive?: boolean;
+    limit?: number;
+}
+export interface SessionInfoArgs {
+    session_id: string;
+}
+export interface SessionDeleteArgs {
+    session_id: string;
+    confirm: boolean;
+}

package/dist/tools/session-manager/utils.d.ts

@@ -0,0 +1,11 @@
+import type { SessionInfo, SessionMessage, SearchResult } from "./types";
+export declare function formatSessionList(sessionIDs: string[]): Promise<string>;
+export declare function formatSessionMessages(messages: SessionMessage[], includeTodos?: boolean, todos?: Array<{
+    id: string;
+    content: string;
+    status: string;
+}>): string;
+export declare function formatSessionInfo(info: SessionInfo): string;
+export declare function formatSearchResults(results: SearchResult[]): string;
+export declare function filterSessionsByDate(sessionIDs: string[], fromDate?: string, toDate?: string): Promise<string[]>;
+export declare function searchInSession(sessionID: string, query: string, caseSensitive?: boolean, maxResults?: number): Promise<SearchResult[]>;

package/dist/tools/session-manager/utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/skill/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const TOOL_NAME: "skill";
+export declare const TOOL_DESCRIPTION_NO_SKILLS = "Load a skill to get detailed instructions for a specific task. No skills are currently available.";
+export declare const TOOL_DESCRIPTION_PREFIX = "Load a skill to get detailed instructions for a specific task.\n\nSkills provide specialized knowledge and step-by-step guidance.\nUse this when a task matches an available skill's description.";

package/dist/tools/skill/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./constants";
+export * from "./types";
+export { skill, createSkillTool } from "./tools";

package/dist/tools/skill/tools.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { SkillLoadOptions } from "./types";
+export declare function createSkillTool(options?: SkillLoadOptions): ToolDefinition;
+export declare const skill: ToolDefinition;

package/dist/tools/skill/tools.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/skill/types.d.ts

@@ -0,0 +1,28 @@
+import type { SkillScope, LoadedSkill } from "../../features/musacode-skill-loader/types";
+import type { SkillMcpManager } from "../../features/skill-mcp-manager";
+import type { GitMasterConfig } from "../../config/schema";
+export interface SkillArgs {
+    name: string;
+}
+export interface SkillInfo {
+    name: string;
+    description: string;
+    location?: string;
+    scope: SkillScope;
+    license?: string;
+    compatibility?: string;
+    metadata?: Record<string, string>;
+    allowedTools?: string[];
+}
+export interface SkillLoadOptions {
+    /** When true, only load from MusaCode paths (.musacode/skill/, ~/.config.musacode/skill/) */
+    musacodeOnly?: boolean;
+    /** Pre-merged skills to use instead of discovering */
+    skills?: LoadedSkill[];
+    /** MCP manager for querying skill-embedded MCP servers */
+    mcpManager?: SkillMcpManager;
+    /** Session ID getter for MCP client identification */
+    getSessionID?: () => string;
+    /** Git master configuration for watermark/co-author settings */
+    gitMasterConfig?: GitMasterConfig;
+}

package/dist/tools/skill-mcp/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const SKILL_MCP_TOOL_NAME = "skill_mcp";
+export declare const SKILL_MCP_DESCRIPTION = "Invoke MCP server operations from skill-embedded MCPs. Requires mcp_name plus exactly one of: tool_name, resource_name, or prompt_name.";

package/dist/tools/skill-mcp/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./constants";
+export * from "./types";
+export { createSkillMcpTool } from "./tools";

package/dist/tools/skill-mcp/tools.d.ts

@@ -0,0 +1,11 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { SkillMcpManager } from "../../features/skill-mcp-manager";
+import type { LoadedSkill } from "../../features/musacode-skill-loader/types";
+interface SkillMcpToolOptions {
+    manager: SkillMcpManager;
+    getLoadedSkills: () => LoadedSkill[];
+    getSessionID: () => string;
+}
+export declare function applyGrepFilter(output: string, pattern: string | undefined): string;
+export declare function createSkillMcpTool(options: SkillMcpToolOptions): ToolDefinition;
+export {};

package/dist/tools/skill-mcp/tools.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/skill-mcp/types.d.ts

@@ -0,0 +1,8 @@
+export interface SkillMcpArgs {
+    mcp_name: string;
+    tool_name?: string;
+    resource_name?: string;
+    prompt_name?: string;
+    arguments?: string | Record<string, unknown>;
+    grep?: string;
+}

package/dist/tools/slashcommand/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export { slashcommand, createSlashcommandTool, discoverCommandsSync } from "./tools";

package/dist/tools/slashcommand/tools.d.ts

@@ -0,0 +1,5 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { CommandInfo, SlashcommandToolOptions } from "./types";
+export declare function discoverCommandsSync(): CommandInfo[];
+export declare function createSlashcommandTool(options?: SlashcommandToolOptions): ToolDefinition;
+export declare const slashcommand: ToolDefinition;

package/dist/tools/slashcommand/types.d.ts

@@ -0,0 +1,24 @@
+import type { LoadedSkill, LazyContentLoader } from "../../features/musacode-skill-loader";
+export type CommandScope = "builtin" | "config" | "user" | "project" | "musacode" | "musacode-project";
+export interface CommandMetadata {
+    name: string;
+    description: string;
+    argumentHint?: string;
+    model?: string;
+    agent?: string;
+    subtask?: boolean;
+}
+export interface CommandInfo {
+    name: string;
+    path?: string;
+    metadata: CommandMetadata;
+    content?: string;
+    scope: CommandScope;
+    lazyContentLoader?: LazyContentLoader;
+}
+export interface SlashcommandToolOptions {
+    /** Pre-loaded commands (skip discovery if provided) */
+    commands?: CommandInfo[];
+    /** Pre-loaded skills (skip discovery if provided) */
+    skills?: LoadedSkill[];
+}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "oh-my-musacode",
+  "version": "0.0.1",
+  "description": "The Best AI Agent Harness - Batteries-Included MusaCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "oh-my-musacode": "./bin/oh-my-musacode.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "postinstall.mjs"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./schema.json": "./dist/oh-my-musacode.schema.json"
+  },
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target bun --format esm --external @ast-grep/napi && tsc --emitDeclarationOnly && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm --external @ast-grep/napi && bun run build:schema",
+    "build:all": "bun run build && bun run build:binaries",
+    "build:binaries": "bun run script/build-binaries.ts",
+    "build:schema": "bun run script/build-schema.ts",
+    "clean": "rm -rf dist",
+    "postinstall": "node postinstall.mjs",
+    "prepublishOnly": "bun run clean && bun run build",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "oracle",
+    "librarian",
+    "agents",
+    "ai",
+    "llm"
+  ],
+  "author": "YeonGyu-Kim",
+  "license": "SUL-1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/code-yeongyu/oh-my-opencode.git"
+  },
+  "bugs": {
+    "url": "https://github.com/code-yeongyu/oh-my-opencode/issues"
+  },
+  "homepage": "https://github.com/code-yeongyu/oh-my-opencode#readme",
+  "dependencies": {
+    "@ast-grep/cli": "^0.40.5",
+    "@ast-grep/napi": "^0.40.5",
+    "@clack/prompts": "^0.11.0",
+    "@code-yeongyu/comment-checker": "^0.6.1",
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "@opencode-ai/plugin": "^1.1.36",
+    "@opencode-ai/sdk": "^1.1.36",
+    "commander": "^14.0.2",
+    "detect-libc": "^2.1.2",
+    "js-yaml": "^4.1.1",
+    "jsonc-parser": "^3.3.1",
+    "picocolors": "^1.1.1",
+    "picomatch": "^4.0.3",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/picomatch": "^3.0.2",
+    "bun-types": "^1.3.6",
+    "typescript": "^5.9.3"
+  },
+  "optionalDependencies": {
+    "oh-my-musacode-darwin-arm64": "0.0.1",
+    "oh-my-musacode-darwin-x64": "0.0.1",
+    "oh-my-musacode-linux-arm64": "0.0.1",
+    "oh-my-musacode-linux-arm64-musl": "0.0.1",
+    "oh-my-musacode-linux-x64": "0.0.1",
+    "oh-my-musacode-linux-x64-musl": "0.0.1",
+    "oh-my-musacode-windows-x64": "0.0.1"
+  },
+  "trustedDependencies": [
+    "@ast-grep/cli",
+    "@ast-grep/napi",
+    "@code-yeongyu/comment-checker"
+  ]
+}

package/postinstall.mjs

@@ -0,0 +1,47 @@
+// postinstall.mjs
+// Runs after npm install to verify platform binary is available
+
+import { createRequire } from "node:module";
+import { getPlatformPackage, getBinaryPath } from "./bin/platform.js";
+
+const require = createRequire(import.meta.url);
+
+/**
+ * Detect libc family on Linux
+ */
+function getLibcFamily() {
+  if (process.platform !== "linux") {
+    return undefined;
+  }
+
+  try {
+    const detectLibc = require("detect-libc");
+    return detectLibc.familySync();
+  } catch {
+    return null;
+  }
+}
+
+function main() {
+  const { platform, arch } = process;
+  const libcFamily = getLibcFamily();
+
+  try {
+    const pkg = getPlatformPackage({ platform, arch, libcFamily });
+    const binPath = getBinaryPath(pkg, platform);
+    console.log(`DEBUG: platform=${platform}, arch=${arch}, libcFamily=${libcFamily}`);
+
+    console.log(`DEBUG: pkg=${pkg}`)
+
+    console.log(`DEBUG: binPath=${binPath}`)
+    // Try to resolve the binary
+    require.resolve(binPath);
+    console.log(`✓ oh-my-musacode binary installed for ${platform}-${arch}`);
+  } catch (error) {
+    console.warn(`⚠ oh-my-musacode: ${error.message}`);
+    console.warn(`  The CLI may not work on this platform.`);
+    // Don't fail installation - let user try anyway
+  }
+}
+
+main();