oh-my-opencode-kikokikok 2.13.0 → 2.14.0

package/dist/features/openspec/types.d.ts

@@ -0,0 +1,365 @@
+/**
+ * OpenSpec Lifecycle System Types
+ *
+ * A structured specification and task tracking system for multi-session AI agent work.
+ * Supports proposal → design → spec → tasks → implementation → verification workflow.
+ */
+/**
+ * Status of an OpenSpec change through its lifecycle.
+ */
+export type OpenSpecStatus = "proposal" | "design" | "spec" | "tasks" | "implementing" | "verify" | "done" | "cancelled";
+/**
+ * Valid state transitions in the OpenSpec lifecycle.
+ */
+export declare const VALID_TRANSITIONS: Record<OpenSpecStatus, OpenSpecStatus[]>;
+/**
+ * Task priority levels.
+ */
+export type TaskPriority = "high" | "medium" | "low";
+/**
+ * Task status within an OpenSpec change.
+ */
+export type TaskStatus = "pending" | "in_progress" | "completed" | "blocked" | "cancelled";
+/**
+ * Enforcement level for OpenSpec commitment.
+ */
+export type EnforcementLevel = "off" | "soft" | "hard";
+/**
+ * Types of changes that may require specification.
+ */
+export type ChangeType = "new_feature" | "enhancement" | "bug_fix" | "refactoring" | "breaking_change" | "documentation" | "infrastructure";
+/**
+ * Author of an OpenSpec change or amendment.
+ */
+export interface OpenSpecAuthor {
+    id: string;
+    name: string;
+    type: "user" | "agent";
+}
+/**
+ * Log entry for a session that worked on this change.
+ */
+export interface SessionLog {
+    sessionId: string;
+    startedAt: string;
+    endedAt?: string;
+    tasksCompleted: string[];
+    tasksStarted: string[];
+    notes?: string;
+    agentModel?: string;
+}
+/**
+ * A single task within an OpenSpec change.
+ */
+export interface OpenSpecTask {
+    /** Unique identifier within the change */
+    id: string;
+    /** Task description */
+    content: string;
+    /** Current status */
+    status: TaskStatus;
+    /** Priority level */
+    priority: TaskPriority;
+    /** Session ID that is/was working on this task */
+    assignedSession?: string;
+    /** ISO 8601 timestamp when completed */
+    completedAt?: string;
+    /** Additional notes or context */
+    notes?: string;
+    /** Link to session todo item */
+    linkedTodoId?: string;
+    /** Estimated effort */
+    estimate?: "xs" | "s" | "m" | "l" | "xl";
+    /** Tags for categorization */
+    tags?: string[];
+    /** Blocked reason if status is 'blocked' */
+    blockedReason?: string;
+}
+/**
+ * Dependency between tasks.
+ */
+export interface TaskDependency {
+    /** Task that depends on another */
+    taskId: string;
+    /** Task that must be completed first */
+    dependsOn: string;
+}
+/**
+ * The tasks document stored as tasks.json.
+ */
+export interface TasksDocument {
+    /** Schema version */
+    version: string;
+    /** Last updated timestamp */
+    updatedAt: string;
+    /** All tasks for this change */
+    tasks: OpenSpecTask[];
+    /** Dependencies between tasks */
+    dependencies: TaskDependency[];
+}
+/**
+ * A single change within an amendment.
+ */
+export interface AmendmentChange {
+    /** Which section of the spec changed */
+    section: string;
+    /** Summary of previous content */
+    before: string;
+    /** Summary of new content */
+    after: string;
+}
+/**
+ * Impact analysis for an amendment.
+ */
+export interface AmendmentImpact {
+    /** Task IDs that need rework */
+    tasksAffected: string[];
+    /** Estimated effort to address the amendment */
+    estimatedEffort: "low" | "medium" | "high";
+    /** Whether this is a breaking change */
+    breaking: boolean;
+    /** Additional notes */
+    notes?: string;
+}
+/**
+ * An amendment record tracking spec changes.
+ */
+export interface Amendment {
+    /** Sequential ID: "001", "002", etc. */
+    id: string;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Who made the amendment */
+    author: OpenSpecAuthor;
+    /** Why the change was needed */
+    reason: string;
+    /** What changed */
+    changes: AmendmentChange[];
+    /** Impact analysis */
+    impactAnalysis: AmendmentImpact;
+    /** File path to full amendment markdown */
+    filePath: string;
+}
+/**
+ * Metadata for an OpenSpec change.
+ */
+export interface ChangeMetadata {
+    /** Unique identifier */
+    id: string;
+    /** Human-readable title */
+    title: string;
+    /** One-line summary */
+    summary: string;
+    /** Current status in lifecycle */
+    status: OpenSpecStatus;
+    /** Type of change */
+    changeType?: ChangeType;
+    /** ISO 8601 creation timestamp */
+    createdAt: string;
+    /** ISO 8601 last update timestamp */
+    updatedAt: string;
+    /** Original author */
+    author: OpenSpecAuthor;
+    /** Sessions that have worked on this */
+    sessions: SessionLog[];
+    /** Amendments made after spec approval */
+    amendments: Amendment[];
+    /** Tags for categorization */
+    tags: string[];
+    /** Related change IDs */
+    relatedChanges?: string[];
+    /** Link to external issue tracker */
+    externalRef?: {
+        type: "github" | "jira" | "linear" | "other";
+        id: string;
+        url?: string;
+    };
+}
+/**
+ * Full change including content paths.
+ */
+export interface OpenSpecChange extends ChangeMetadata {
+    /** Path to proposal.md */
+    proposalPath: string;
+    /** Path to design.md (if exists) */
+    designPath?: string;
+    /** Path to spec.md (if exists) */
+    specPath?: string;
+    /** Path to tasks.json (if exists) */
+    tasksPath?: string;
+    /** Path to verification.md (if exists) */
+    verificationPath?: string;
+}
+/**
+ * Reference to the currently active change.
+ */
+export interface ActiveChange {
+    /** Change ID */
+    changeId: string;
+    /** When this change became active */
+    activatedAt: string;
+    /** Currently active task ID (if implementing) */
+    currentTaskId?: string;
+}
+/**
+ * Entry in the OpenSpec manifest.
+ */
+export interface ManifestEntry {
+    id: string;
+    title: string;
+    status: OpenSpecStatus;
+    createdAt: string;
+    updatedAt: string;
+    tasksTotal?: number;
+    tasksCompleted?: number;
+    archived: boolean;
+}
+/**
+ * The OpenSpec manifest indexing all changes.
+ */
+export interface OpenSpecManifest {
+    /** Schema version */
+    version: string;
+    /** Last generated timestamp */
+    generatedAt: string;
+    /** Total number of changes */
+    totalCount: number;
+    /** Active changes */
+    active: ManifestEntry[];
+    /** Archived changes */
+    archived: ManifestEntry[];
+    /** Statistics */
+    stats: {
+        byStatus: Record<OpenSpecStatus, number>;
+        byChangeType: Record<ChangeType, number>;
+    };
+}
+/**
+ * OpenSpec configuration.
+ */
+export interface OpenSpecConfig {
+    /** Whether OpenSpec is enabled */
+    enabled: boolean;
+    /** Enforcement level */
+    enforcement: EnforcementLevel;
+    /** Change types that require specification */
+    requireSpecFor: ChangeType[];
+    /** Root directory for OpenSpec storage */
+    rootDir?: string;
+    /** Whether to auto-sync with session todos */
+    autoSyncTodos: boolean;
+    /** Maximum amendments before requiring new spec */
+    maxAmendments?: number;
+}
+/**
+ * Default OpenSpec configuration.
+ */
+export declare const DEFAULT_OPENSPEC_CONFIG: OpenSpecConfig;
+/**
+ * Options for creating a new proposal.
+ */
+export interface CreateProposalOptions {
+    title: string;
+    summary: string;
+    content: string;
+    author: OpenSpecAuthor;
+    changeType?: ChangeType;
+    tags?: string[];
+    externalRef?: ChangeMetadata["externalRef"];
+}
+/**
+ * Options for transitioning to a new status.
+ */
+export interface TransitionOptions {
+    changeId: string;
+    content?: string;
+    author: OpenSpecAuthor;
+    notes?: string;
+}
+/**
+ * Options for creating an amendment.
+ */
+export interface CreateAmendmentOptions {
+    changeId: string;
+    reason: string;
+    changes: AmendmentChange[];
+    author: OpenSpecAuthor;
+    tasksAffected?: string[];
+}
+/**
+ * Options for updating a task.
+ */
+export interface UpdateTaskOptions {
+    changeId: string;
+    taskId: string;
+    status?: TaskStatus;
+    notes?: string;
+    linkedTodoId?: string;
+    blockedReason?: string;
+}
+/**
+ * Result of a state transition.
+ */
+export interface TransitionResult {
+    success: boolean;
+    change: OpenSpecChange;
+    message: string;
+    warnings?: string[];
+}
+/**
+ * Filter options for querying changes.
+ */
+export interface OpenSpecQueryFilter {
+    /** Filter by status */
+    status?: OpenSpecStatus | OpenSpecStatus[];
+    /** Filter by change type */
+    changeType?: ChangeType | ChangeType[];
+    /** Filter by tags */
+    tags?: string[];
+    /** Include archived changes */
+    includeArchived?: boolean;
+    /** Full-text search */
+    search?: string;
+    /** Maximum results */
+    limit?: number;
+    /** Pagination offset */
+    offset?: number;
+}
+/**
+ * Result of a query.
+ */
+export interface OpenSpecQueryResult {
+    items: OpenSpecChange[];
+    total: number;
+    hasMore: boolean;
+}
+/**
+ * Events emitted by the OpenSpec system.
+ */
+export type OpenSpecEvent = {
+    type: "change.created";
+    change: OpenSpecChange;
+} | {
+    type: "change.transitioned";
+    change: OpenSpecChange;
+    from: OpenSpecStatus;
+    to: OpenSpecStatus;
+} | {
+    type: "change.amended";
+    change: OpenSpecChange;
+    amendment: Amendment;
+} | {
+    type: "task.updated";
+    change: OpenSpecChange;
+    task: OpenSpecTask;
+} | {
+    type: "change.activated";
+    change: OpenSpecChange;
+} | {
+    type: "change.deactivated";
+    changeId: string;
+};
+/**
+ * Event listener for OpenSpec events.
+ */
+export type OpenSpecEventListener = (event: OpenSpecEvent) => void | Promise<void>;

package/dist/features/skill-mcp-manager/env-cleaner.d.ts

@@ -0,0 +1,2 @@
+export declare const EXCLUDED_ENV_PATTERNS: RegExp[];
+export declare function createCleanMcpEnvironment(customEnv?: Record<string, string>): Record<string, string>;

package/dist/features/skill-mcp-manager/env-cleaner.test.d.ts

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

package/dist/features/skill-mcp-manager/manager.d.ts

@@ -4,11 +4,19 @@ import type { ClaudeCodeMcpServer } from "../claude-code-mcp-loader/types";
 import type { SkillMcpClientInfo, SkillMcpServerContext } from "./types";
 export declare class SkillMcpManager {
     private clients;
+    private pendingConnections;
+    private cleanupRegistered;
+    private cleanupInterval;
+    private readonly IDLE_TIMEOUT;
     private getClientKey;
+    private registerProcessCleanup;
     getOrCreateClient(info: SkillMcpClientInfo, config: ClaudeCodeMcpServer): Promise<Client>;
     private createClient;
     disconnectSession(sessionID: string): Promise<void>;
     disconnectAll(): Promise<void>;
+    private startCleanupTimer;
+    private stopCleanupTimer;
+    private cleanupIdleClients;
     listTools(info: SkillMcpClientInfo, context: SkillMcpServerContext): Promise<Tool[]>;
     listResources(info: SkillMcpClientInfo, context: SkillMcpServerContext): Promise<Resource[]>;
     listPrompts(info: SkillMcpClientInfo, context: SkillMcpServerContext): Promise<Prompt[]>;

package/dist/hooks/index.d.ts

@@ -25,3 +25,6 @@ export { createRalphLoopHook, type RalphLoopHook } from "./ralph-loop";
 export { createAutoSlashCommandHook } from "./auto-slash-command";
 export { createEditErrorRecoveryHook } from "./edit-error-recovery";
 export { createKnowledgeMonitorHook, type KnowledgeMonitorHook, type KnowledgeMonitorConfig } from "./knowledge-monitor";
+export { createMemoryRehydrationHook, type MemoryRehydrationHook, type MemoryRehydrationConfig } from "./memory-rehydration";
+export { createOpenSpecContinuityHook } from "./openspec-continuity";
+export { createOpenSpecCommitmentHook } from "./openspec-commitment";

package/dist/hooks/knowledge-monitor/index.test.d.ts

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

package/dist/hooks/memory-rehydration/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const HOOK_NAME = "memory-rehydration";
+export declare const DEFAULT_REHYDRATE_LAYERS: readonly ["user", "project", "team"];
+export declare const DEFAULT_MEMORY_LIMIT = 20;
+export declare const REHYDRATION_PROMPT_HEADER = "[MEMORY REHYDRATION - Relevant memories from previous sessions]\n\nThe following memories have been retrieved from persistent storage. These represent learned patterns, preferences, and context from past interactions.\n";

package/dist/hooks/memory-rehydration/index.d.ts

@@ -0,0 +1,17 @@
+import type { Mem0Adapter } from "../../features/mem0-memory/adapter";
+import type { MemoryRehydrationConfig, RehydrationResult } from "./types";
+import { HOOK_NAME } from "./constants";
+export interface MemoryRehydrationHook {
+    event: (input: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
+    getRehydrationPrompt: (sessionID: string) => Promise<string | null>;
+    forceRehydrate: (sessionID: string) => Promise<RehydrationResult>;
+    clearSession: (sessionID: string) => void;
+}
+export declare function createMemoryRehydrationHook(adapter: Mem0Adapter, config?: MemoryRehydrationConfig): MemoryRehydrationHook;
+export { HOOK_NAME };
+export type { MemoryRehydrationConfig } from "./types";

package/dist/hooks/memory-rehydration/types.d.ts

@@ -0,0 +1,12 @@
+import type { MemoryLayer } from "../../features/mem0-memory/types";
+export interface MemoryRehydrationConfig {
+    enabled?: boolean;
+    layers?: MemoryLayer[];
+    limit?: number;
+    threshold?: number;
+}
+export interface RehydrationResult {
+    count: number;
+    layers: MemoryLayer[];
+    injected: boolean;
+}

package/dist/hooks/openspec-commitment/index.d.ts

@@ -0,0 +1,32 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import { type EnforcementLevel, type ChangeType } from "../../features/openspec";
+interface OpenSpecCommitmentConfig {
+    enforcement: EnforcementLevel;
+    requireSpecFor: ChangeType[];
+}
+interface ToolExecuteInput {
+    tool: string;
+    sessionID: string;
+}
+interface ToolExecuteBeforeOutput {
+    args?: unknown;
+    blocked?: boolean;
+    message?: string;
+}
+interface UserPromptSubmitInput {
+    sessionID: string;
+    prompt: string;
+}
+interface UserPromptSubmitOutput {
+    blocked?: boolean;
+    message?: string;
+    messages?: Array<{
+        role: "user" | "assistant";
+        content: string;
+    }>;
+}
+export declare function createOpenSpecCommitmentHook(ctx: PluginInput, config: OpenSpecCommitmentConfig): {
+    PreToolUse: (input: ToolExecuteInput) => Promise<ToolExecuteBeforeOutput>;
+    UserPromptSubmit: (input: UserPromptSubmitInput) => Promise<UserPromptSubmitOutput>;
+};
+export {};

package/dist/hooks/openspec-continuity/index.d.ts

@@ -0,0 +1,15 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+interface UserPromptSubmitInput {
+    sessionID: string;
+    prompt: string;
+}
+interface UserPromptSubmitOutput {
+    messages?: Array<{
+        role: "user" | "assistant";
+        content: string;
+    }>;
+}
+export declare function createOpenSpecContinuityHook(ctx: PluginInput): {
+    UserPromptSubmit: (input: UserPromptSubmitInput) => Promise<UserPromptSubmitOutput>;
+};
+export {};

package/dist/hooks/ralph-loop/types.d.ts

@@ -12,4 +12,5 @@ export interface RalphLoopOptions {
     config?: RalphLoopConfig;
     getTranscriptPath?: (sessionId: string) => string;
     apiTimeout?: number;
+    checkSessionExists?: (sessionId: string) => Promise<boolean>;
 }

package/dist/hooks/tool-output-truncator.test.d.ts

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