oh-my-opencode-slim 0.9.14 → 1.0.0

package/src/skills/simplify/SKILL.md

@@ -0,0 +1,138 @@
+---
+name: simplify
+description: Simplifies code for clarity without changing behavior. Use for readability, maintainability, and complexity reduction after behavior is understood.
+---
+
+# Code Simplification
+
+## Overview
+
+Simplify code by reducing complexity while preserving exact behavior. The goal is not fewer lines — it's code that is easier to read, understand, modify, and debug. Every simplification must pass a simple test: "Would a new team member understand this faster than the original?"
+
+## When to Use
+
+- After a feature is working and tests pass, but the implementation feels heavier than it needs to be
+- During code review when readability or complexity issues are flagged
+- When you encounter deeply nested logic, long functions, or unclear names
+- When refactoring code written under time pressure
+- When consolidating related logic scattered across files
+- After merging changes that introduced duplication or inconsistency
+
+**When NOT to use:**
+
+- Code is already clean and readable — don't simplify for the sake of it
+- You don't understand what the code does yet — comprehend before you simplify
+- The code is performance-critical and the "simpler" version would be measurably slower
+- You're about to rewrite the module entirely — simplifying throwaway code wastes effort
+
+## The Five Principles
+
+### 1. Preserve Behavior Exactly
+
+Don't change what the code does — only how it expresses it. All inputs, outputs, side effects, error behavior, and edge cases must remain identical. If you're not sure a simplification preserves behavior, don't make it.
+
+Before every change, ask:
+
+- Does this produce the same output for every input?
+- Does this maintain the same error behavior?
+- Does this preserve the same side effects and ordering?
+- Do all existing tests still pass without modification?
+
+### 2. Follow Project Conventions
+
+Simplification means making code more consistent with the codebase, not imposing external preferences.
+
+Before simplifying:
+
+1. Read `AGENTS.md` / project conventions
+2. Study how neighboring code handles similar patterns
+3. Match the project's style for imports, naming, function style, error handling, and type annotations
+
+Simplification that breaks project consistency is not simplification — it's churn.
+
+### 3. Prefer Clarity Over Cleverness
+
+Explicit code is better than compact code when the compact version requires a mental pause to parse.
+
+- Replace nested ternaries with readable control flow
+- Replace dense inline transforms with named intermediate steps when they clarify intent
+- Keep helpful names even if they cost a few extra lines
+
+### 4. Maintain Balance
+
+Watch for over-simplification:
+
+- Don't inline away names that carry meaning
+- Don't merge unrelated logic into one larger function
+- Don't remove abstractions that serve testability or extensibility
+- Don't optimize for line count over comprehension
+
+### 5. Scope to What Changed
+
+Default to simplifying recently modified code. Avoid unrelated drive-by refactors unless explicitly asked.
+
+## Process
+
+### Step 1: Understand Before Touching
+
+Before changing or removing anything, understand why it exists.
+
+Answer:
+
+- What is this code's responsibility?
+- What calls it? What does it call?
+- What are the edge cases and error paths?
+- Are there tests that define expected behavior?
+- Why might it have been written this way?
+
+If you can't answer these, read more context first.
+
+### Step 2: Look for Simplification Opportunities
+
+Signals:
+
+- Deep nesting
+- Long functions with mixed responsibilities
+- Nested ternaries
+- Boolean flag arguments
+- Repeated conditionals
+- Generic or misleading names
+- Duplicated logic
+- Dead code
+- Wrappers or abstractions that add no value
+
+### Step 3: Apply Changes Incrementally
+
+Make one simplification at a time.
+
+For each simplification:
+
+1. Make the change
+2. Run relevant tests
+3. Keep it only if behavior is preserved
+
+Separate refactoring from feature work whenever possible.
+
+### Step 4: Verify the Result
+
+After simplifying, confirm:
+
+- The code is genuinely easier to understand
+- The diff is clean and reviewable
+- Project conventions still match
+- No behavior, error handling, or side effects changed
+
+## Guidance for This Repository
+
+- Prefer straightforward TypeScript over clever compression
+- Preserve existing runtime behavior, tests, and hooks
+- Favor explicit names and smaller focused helpers when they improve readability
+- Keep refactors tightly scoped to the task or review feedback
+
+## Verification Checklist
+
+- [ ] Existing tests pass without modification
+- [ ] Build/typecheck/lint still pass
+- [ ] No unrelated files were refactored
+- [ ] No error handling was weakened or removed
+- [ ] The result is simpler to review than the original

package/src/skills/simplify/codemap.md

@@ -0,0 +1,36 @@
+# src/skills/simplify/
+
+## Responsibility
+
+- Provide a behavior-preserving refactoring skill contract that constrains code cleanup to clarity-focused,
+  low-risk changes.
+- Define explicit quality gates (understand-before-edit, behavior parity, incremental simplification, rollback-friendly diffs)
+  for any simplification task.
+- Ship only metadata; no local runtime state machine is kept in this directory.
+
+## Design
+
+- Contract layer: `SKILL.md` is the executable prompt specification with explicit phases:
+  - pre-change understanding
+  - simplification candidate selection
+  - incremental transformation and verification
+  - final review checklist.
+- Documentation layer: `README.md` explains intent, source provenance, and plugin install behavior.
+- Policy model is declarative (`description`, allowed usage, checklist) consumed by the OpenCode skill executor,
+  without helper scripts or plugin code dependencies.
+
+## Flow
+
+- Agent discovery resolves `src/skills/simplify` as a custom skill entrypoint, then reads `SKILL.md` at runtime.
+- Runtime behavior is gated by `src/cli/custom-skills.ts` (`allowedAgents: ['oracle']`) and by skill permissions
+  computed in `getSkillPermissionsForAgent()`.
+- In practice the workflow is read-only and context-driven: simplify instructions require understanding of callers,
+  edge cases, and tests before mutation, then apply local, scoped refactors with validation.
+- Consumers (Fixer/Oracle/Reviewer tasks) rely on this contract as operational constraints, not as executable TypeScript.
+
+## Integration
+
+- Installed by plugin installer (`installCustomSkills`) using `src/cli/install.ts` via `installCustomSkill()`.
+- Permission surface is enforced by hook layer in `src/hooks/filter-available-skills/index.ts` (`permissionRules`).
+- Release integrity: `scripts/verify-release-artifact.ts` checks for `src/skills/simplify/SKILL.md` in package tarballs.
+- Operationally paired with codemap/fixer flows in `src/index.ts` orchestrations for post-feature readability hardening.

package/dist/background/tmux-session-manager.d.ts

@@ -1,63 +0,0 @@
-import type { PluginInput } from '@opencode-ai/plugin';
-import type { TmuxConfig } from '../config/schema';
-/**
- * Event shape for session events
- */
-interface SessionEvent {
-    type: string;
-    properties?: {
-        info?: {
-            id?: string;
-            parentID?: string;
-            title?: string;
-        };
-        sessionID?: string;
-        status?: {
-            type: string;
-        };
-    };
-}
-/**
- * TmuxSessionManager tracks child sessions and spawns/closes tmux panes for them.
- *
- * Uses session.status events for completion detection instead of polling.
- */
-export declare class TmuxSessionManager {
-    private client;
-    private tmuxConfig;
-    private serverUrl;
-    private sessions;
-    private pollInterval?;
-    private enabled;
-    constructor(ctx: PluginInput, tmuxConfig: TmuxConfig);
-    /**
-     * Handle session.created events.
-     * Spawns a tmux pane for child sessions (those with parentID).
-     */
-    onSessionCreated(event: SessionEvent): Promise<void>;
-    /**
-     * Handle session.status events for completion detection.
-     * Uses session.status instead of deprecated session.idle.
-     *
-     * When a session becomes idle (completed), close its pane.
-     */
-    onSessionStatus(event: SessionEvent): Promise<void>;
-    /**
-     * Handle session.deleted events.
-     * When a session is deleted, close its tmux pane immediately.
-     */
-    onSessionDeleted(event: SessionEvent): Promise<void>;
-    private startPolling;
-    private stopPolling;
-    /**
-     * Poll sessions for status updates (fallback for reliability).
-     * Also handles timeout and missing session detection.
-     */
-    private pollSessions;
-    private closeSession;
-    /**
-     * Clean up all tracked sessions.
-     */
-    cleanup(): Promise<void>;
-}
-export {};

package/dist/cli/chutes-selection.d.ts

@@ -1,3 +0,0 @@
-import type { OpenCodeFreeModel } from './types';
-export declare function pickBestCodingChutesModel(models: OpenCodeFreeModel[]): OpenCodeFreeModel | null;
-export declare function pickSupportChutesModel(models: OpenCodeFreeModel[], primaryModel?: string): OpenCodeFreeModel | null;

package/dist/cli/dynamic-model-selection.d.ts

@@ -1,14 +0,0 @@
-import type { DiscoveredModel, DynamicModelPlan, ExternalSignalMap, InstallConfig, ScoringEngineVersion } from './types';
-declare const AGENTS: readonly ["orchestrator", "oracle", "designer", "explorer", "librarian", "fixer"];
-type AgentName = (typeof AGENTS)[number];
-export type V1RankedScore = {
-    model: string;
-    totalScore: number;
-    baseScore: number;
-    externalSignalBoost: number;
-};
-export declare function rankModelsV1WithBreakdown(models: DiscoveredModel[], agent: AgentName, externalSignals?: ExternalSignalMap): V1RankedScore[];
-export declare function buildDynamicModelPlan(catalog: DiscoveredModel[], config: InstallConfig, externalSignals?: ExternalSignalMap, options?: {
-    scoringEngineVersion?: ScoringEngineVersion;
-}): DynamicModelPlan | null;
-export {};

package/dist/cli/external-rankings.d.ts

@@ -1,8 +0,0 @@
-import type { ExternalSignalMap } from './types';
-export declare function fetchExternalModelSignals(options?: {
-    artificialAnalysisApiKey?: string;
-    openRouterApiKey?: string;
-}): Promise<{
-    signals: ExternalSignalMap;
-    warnings: string[];
-}>;

package/dist/cli/model-selection.d.ts

@@ -1,30 +0,0 @@
-export interface ModelSelectionCandidate {
-    model: string;
-    status?: 'alpha' | 'beta' | 'deprecated' | 'active';
-    contextLimit?: number;
-    outputLimit?: number;
-    reasoning?: boolean;
-    toolcall?: boolean;
-    attachment?: boolean;
-    tags?: string[];
-    meta?: Record<string, unknown>;
-}
-export interface RankedModel<T extends ModelSelectionCandidate> {
-    candidate: T;
-    score: number;
-}
-export interface SelectionOptions<T extends ModelSelectionCandidate> {
-    excludeModels?: string[];
-    tieBreaker?: (left: T, right: T) => number;
-}
-export type ScoreFunction<T extends ModelSelectionCandidate> = (candidate: T) => number;
-export interface RoleScoring<T extends ModelSelectionCandidate> {
-    primary: ScoreFunction<T>;
-    support: ScoreFunction<T>;
-}
-export declare function rankModels<T extends ModelSelectionCandidate>(models: T[], scoreFn: ScoreFunction<T>, options?: SelectionOptions<T>): RankedModel<T>[];
-export declare function pickBestModel<T extends ModelSelectionCandidate>(models: T[], scoreFn: ScoreFunction<T>, options?: SelectionOptions<T>): T | null;
-export declare function pickPrimaryAndSupport<T extends ModelSelectionCandidate>(models: T[], scoring: RoleScoring<T>, preferredPrimaryModel?: string): {
-    primary: T | null;
-    support: T | null;
-};

package/dist/cli/opencode-models.d.ts

@@ -1,18 +0,0 @@
-import type { DiscoveredModel, OpenCodeFreeModel } from './types';
-export declare function parseOpenCodeModelsVerboseOutput(output: string, providerFilter?: string, freeOnly?: boolean): DiscoveredModel[];
-export declare function discoverModelCatalog(): Promise<{
-    models: DiscoveredModel[];
-    error?: string;
-}>;
-export declare function discoverOpenCodeFreeModels(): Promise<{
-    models: OpenCodeFreeModel[];
-    error?: string;
-}>;
-export declare function discoverProviderFreeModels(providerID: string): Promise<{
-    models: OpenCodeFreeModel[];
-    error?: string;
-}>;
-export declare function discoverProviderModels(providerID: string): Promise<{
-    models: DiscoveredModel[];
-    error?: string;
-}>;

package/dist/cli/opencode-selection.d.ts

@@ -1,3 +0,0 @@
-import type { OpenCodeFreeModel } from './types';
-export declare function pickBestCodingOpenCodeModel(models: OpenCodeFreeModel[]): OpenCodeFreeModel | null;
-export declare function pickSupportOpenCodeModel(models: OpenCodeFreeModel[], primaryModel?: string): OpenCodeFreeModel | null;

package/dist/cli/precedence-resolver.d.ts

@@ -1,16 +0,0 @@
-import type { AgentResolutionProvenance } from './types';
-export interface AgentLayerInput {
-    agentName: string;
-    openCodeDirectOverride?: string;
-    manualUserPlan?: string[];
-    pinnedModel?: string;
-    dynamicRecommendation?: string[];
-    providerFallbackPolicy?: string[];
-    systemDefault: string[];
-}
-export interface ResolvedAgentLayerResult {
-    model: string;
-    chain: string[];
-    provenance: AgentResolutionProvenance;
-}
-export declare function resolveAgentWithPrecedence(input: AgentLayerInput): ResolvedAgentLayerResult;

package/dist/cli/scoring-v2/engine.d.ts

@@ -1,4 +0,0 @@
-import type { DiscoveredModel, ExternalSignalMap } from '../types';
-import type { ScoredCandidate, ScoringAgentName } from './types';
-export declare function scoreCandidateV2(model: DiscoveredModel, agent: ScoringAgentName, externalSignals?: ExternalSignalMap): ScoredCandidate;
-export declare function rankModelsV2(models: DiscoveredModel[], agent: ScoringAgentName, externalSignals?: ExternalSignalMap): ScoredCandidate[];

package/dist/cli/scoring-v2/features.d.ts

@@ -1,3 +0,0 @@
-import type { DiscoveredModel, ExternalSignalMap } from '../types';
-import type { FeatureVector, ScoringAgentName } from './types';
-export declare function extractFeatureVector(model: DiscoveredModel, agent: ScoringAgentName, externalSignals?: ExternalSignalMap): FeatureVector;

package/dist/cli/scoring-v2/index.d.ts

@@ -1,4 +0,0 @@
-export { rankModelsV2, scoreCandidateV2 } from './engine';
-export { extractFeatureVector } from './features';
-export type { FeatureVector, ScoredCandidate, ScoringAgentName, } from './types';
-export { getFeatureWeights } from './weights';

package/dist/cli/scoring-v2/types.d.ts

@@ -1,17 +0,0 @@
-import type { DiscoveredModel, ExternalSignalMap } from '../types';
-export type ScoreFeatureName = 'status' | 'context' | 'output' | 'versionBonus' | 'reasoning' | 'toolcall' | 'attachment' | 'quality' | 'coding' | 'latencyPenalty' | 'pricePenalty';
-export type FeatureVector = Record<ScoreFeatureName, number>;
-export type FeatureWeights = Record<ScoreFeatureName, number>;
-export type ScoringAgentName = 'orchestrator' | 'oracle' | 'designer' | 'explorer' | 'librarian' | 'fixer';
-export interface ScoringContext {
-    agent: ScoringAgentName;
-    externalSignals?: ExternalSignalMap;
-}
-export interface ScoredCandidate {
-    model: DiscoveredModel;
-    totalScore: number;
-    scoreBreakdown: {
-        features: FeatureVector;
-        weighted: FeatureVector;
-    };
-}

package/dist/cli/scoring-v2/weights.d.ts

@@ -1,2 +0,0 @@
-import type { FeatureWeights, ScoringAgentName } from './types';
-export declare function getFeatureWeights(agent: ScoringAgentName): FeatureWeights;

package/dist/hooks/post-read-nudge/index.d.ts

@@ -1,18 +0,0 @@
-/**
- * Post-Read nudge - appends a delegation reminder after file reads.
- * Catches the "read files → implement myself" anti-pattern.
- */
-interface ToolExecuteAfterInput {
-    tool: string;
-    sessionID?: string;
-    callID?: string;
-}
-interface ToolExecuteAfterOutput {
-    title: string;
-    output: string;
-    metadata: Record<string, unknown>;
-}
-export declare function createPostReadNudgeHook(): {
-    'tool.execute.after': (input: ToolExecuteAfterInput, output: ToolExecuteAfterOutput) => Promise<void>;
-};
-export {};

package/dist/interview/store.d.ts

@@ -1,9 +0,0 @@
-import type { InterviewAssistantState, InterviewMessage, InterviewRecord } from './types';
-export declare function transcriptPath(directory: string, id: string): string;
-export declare function summaryPath(directory: string, id: string): string;
-export declare function writeInterviewRecord(record: InterviewRecord): Promise<void>;
-export declare function readInterviewRecord(directory: string, id: string): Promise<InterviewRecord | null>;
-export declare function findActiveInterviewBySession(directory: string, sessionID: string): Promise<InterviewRecord | null>;
-export declare function writeTranscript(record: InterviewRecord, messages: InterviewMessage[]): Promise<void>;
-export declare function writeSummary(record: InterviewRecord, state: InterviewAssistantState, answerCount: number): Promise<void>;
-export declare function ensureInterviewDirectory(directory: string): Promise<void>;

package/dist/tools/grep/cli.d.ts

@@ -1,3 +0,0 @@
-import type { CountResult, GrepOptions, GrepResult } from './types';
-export declare function runRg(options: GrepOptions): Promise<GrepResult>;
-export declare function runRgCount(options: Omit<GrepOptions, 'context'>): Promise<CountResult[]>;

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

@@ -1,18 +0,0 @@
-export type GrepBackend = 'rg' | 'grep';
-interface ResolvedCli {
-    path: string;
-    backend: GrepBackend;
-}
-export declare function getDataDir(): string;
-export declare function resolveGrepCli(): ResolvedCli;
-export declare function resolveGrepCliWithAutoInstall(): Promise<ResolvedCli>;
-export declare const DEFAULT_MAX_DEPTH = 20;
-export declare const DEFAULT_MAX_FILESIZE = "10M";
-export declare const DEFAULT_MAX_COUNT = 500;
-export declare const DEFAULT_MAX_COLUMNS = 1000;
-export declare const DEFAULT_CONTEXT = 2;
-export declare const DEFAULT_TIMEOUT_MS = 300000;
-export declare const DEFAULT_MAX_OUTPUT_BYTES: number;
-export declare const RG_SAFETY_FLAGS: readonly ["--no-follow", "--color=never", "--no-heading", "--line-number", "--with-filename"];
-export declare const GREP_SAFETY_FLAGS: readonly ["-n", "-H", "--color=never"];
-export {};

package/dist/tools/grep/downloader.d.ts

@@ -1,3 +0,0 @@
-export declare function findFileRecursive(dir: string, filename: string): string | null;
-export declare function downloadAndInstallRipgrep(): Promise<string>;
-export declare function getInstalledRipgrepPath(): string | null;

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

@@ -1,5 +0,0 @@
-export { runRg, runRgCount } from './cli';
-export { resolveGrepCli, resolveGrepCliWithAutoInstall } from './constants';
-export { downloadAndInstallRipgrep, getInstalledRipgrepPath, } from './downloader';
-export { grep } from './tools';
-export type { CountResult, GrepMatch, GrepOptions, GrepResult } from './types';

package/dist/tools/grep/tools.d.ts

@@ -1,2 +0,0 @@
-import { type ToolDefinition } from '@opencode-ai/plugin/tool';
-export declare const grep: ToolDefinition;

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

@@ -1,35 +0,0 @@
-export interface GrepMatch {
-    file: string;
-    line: number;
-    text: string;
-}
-export interface GrepResult {
-    matches: GrepMatch[];
-    totalMatches: number;
-    filesSearched: number;
-    truncated: boolean;
-    error?: string;
-}
-export interface CountResult {
-    file: string;
-    count: number;
-}
-export interface GrepOptions {
-    pattern: string;
-    paths?: string[];
-    globs?: string[];
-    excludeGlobs?: string[];
-    context?: number;
-    caseSensitive?: boolean;
-    wholeWord?: boolean;
-    fixedStrings?: boolean;
-    multiline?: boolean;
-    hidden?: boolean;
-    noIgnore?: boolean;
-    fileType?: string[];
-    maxDepth?: number;
-    maxFilesize?: string;
-    maxCount?: number;
-    maxColumns?: number;
-    timeout?: number;
-}

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

@@ -1,2 +0,0 @@
-import type { GrepResult } from './types';
-export declare function formatGrepResult(result: GrepResult): string;

package/dist/tools/quota/api.d.ts

@@ -1,5 +0,0 @@
-import type { Account, AccountQuotaResult, AccountsConfig } from './types';
-export declare const CONFIG_PATHS: string[];
-export declare function loadAccountsConfig(): AccountsConfig | null;
-export declare function fetchAccountQuota(account: Account): Promise<AccountQuotaResult>;
-export declare function fetchAllQuotas(accounts: Account[]): Promise<AccountQuotaResult[]>;

package/dist/tools/quota/command.d.ts

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

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

@@ -1,21 +0,0 @@
-/**
- * Compact quota display tool - groups models by quota family
- *
- * Output format:
- * ```
- * tornikevault
- *   Claude   [░░░░░░░░░░]   0%  3h23m
- *   G-Flash  [██████████] 100%  4h59m
- *   G-Pro    [██████████] 100%  4h59m
- *
- * tzedgin
- *   Claude   [░░░░░░░░░░]   0%  1h41m
- *   G-Flash  [██████████] 100%  4h59m
- *   G-Pro    [██████████] 100%  4h59m
- * ```
- */
-export declare const antigravity_quota: {
-    description: string;
-    args: {};
-    execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
-};

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

@@ -1,41 +0,0 @@
-export interface Account {
-    email: string;
-    refreshToken: string;
-    projectId?: string;
-    managedProjectId?: string;
-    rateLimitResetTimes: Record<string, number>;
-}
-export interface AccountsConfig {
-    accounts: Account[];
-    activeIndex: number;
-}
-export interface QuotaInfo {
-    remainingFraction?: number;
-    resetTime?: string;
-}
-export interface ModelInfo {
-    displayName?: string;
-    model?: string;
-    quotaInfo?: QuotaInfo;
-    recommended?: boolean;
-}
-export interface QuotaResponse {
-    models?: Record<string, ModelInfo>;
-}
-export interface TokenResponse {
-    access_token: string;
-}
-export interface LoadCodeAssistResponse {
-    cloudaicompanionProject?: unknown;
-}
-export interface ModelQuota {
-    name: string;
-    percent: number;
-    resetIn: string;
-}
-export interface AccountQuotaResult {
-    email: string;
-    success: boolean;
-    error?: string;
-    models: ModelQuota[];
-}

package/dist/utils/tmux.d.ts

@@ -1,32 +0,0 @@
-import type { TmuxConfig } from '../config/schema';
-/**
- * Reset the server availability cache (useful when server might have started)
- */
-export declare function resetServerCheck(): void;
-/**
- * Get cached tmux path, initializing if needed
- */
-export declare function getTmuxPath(): Promise<string | null>;
-/**
- * Check if we're running inside tmux
- */
-export declare function isInsideTmux(): boolean;
-export interface SpawnPaneResult {
-    success: boolean;
-    paneId?: string;
-}
-/**
- * Spawn a new tmux pane running `opencode attach <serverUrl> --session <sessionId>`
- * This connects the new TUI to the existing server so it receives streaming updates.
- * After spawning, applies the configured layout to auto-rebalance all panes.
- * Returns the pane ID so it can be closed later.
- */
-export declare function spawnTmuxPane(sessionId: string, description: string, config: TmuxConfig, serverUrl: string): Promise<SpawnPaneResult>;
-/**
- * Close a tmux pane by its ID and reapply layout to rebalance remaining panes
- */
-export declare function closeTmuxPane(paneId: string): Promise<boolean>;
-/**
- * Start background check for tmux availability
- */
-export declare function startTmuxCheck(): void;