@wolfx/oh-my-openagent 3.17.4-beta.2 → 3.17.4-beta.3

package/dist/config/schema/comment-checker.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+export declare const CommentCheckerConfigSchema: z.ZodObject<{
+    custom_prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CommentCheckerConfig = z.infer<typeof CommentCheckerConfigSchema>;

package/dist/config/schema/hooks.d.ts

@@ -7,6 +7,7 @@ export declare const HookNameSchema: z.ZodEnum<{
     "context-window-monitor": "context-window-monitor";
     "session-recovery": "session-recovery";
     "session-notification": "session-notification";
+    "comment-checker": "comment-checker";
     "tool-output-truncator": "tool-output-truncator";
     "question-label-truncator": "question-label-truncator";
     "directory-agents-injector": "directory-agents-injector";

package/dist/config/schema/oh-my-opencode-config.d.ts

@@ -1917,6 +1917,9 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
         replace_plan: z.ZodOptional<z.ZodBoolean>;
         tdd: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     }, z.core.$strip>>;
+    comment_checker: z.ZodOptional<z.ZodObject<{
+        custom_prompt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     experimental: z.ZodOptional<z.ZodObject<{
         aggressive_truncation: z.ZodOptional<z.ZodBoolean>;
         auto_resume: z.ZodOptional<z.ZodBoolean>;

package/dist/config/schema.d.ts

@@ -5,6 +5,7 @@ export * from "./schema/background-task";
 export * from "./schema/browser-automation";
 export * from "./schema/categories";
 export * from "./schema/claude-code";
+export * from "./schema/comment-checker";
 export * from "./schema/commands";
 export * from "./schema/dynamic-context-pruning";
 export * from "./schema/experimental";

package/dist/create-hooks.d.ts

@@ -10,6 +10,7 @@ type DisposableHook = {
 } | null | undefined;
 export type DisposableCreatedHooks = {
     claudeCodeHooks?: DisposableHook;
+    commentChecker?: DisposableHook;
     runtimeFallback?: DisposableHook;
     todoContinuationEnforcer?: DisposableHook;
     autoSlashCommand?: DisposableHook;
@@ -41,6 +42,7 @@ export declare function createHooks(args: {
     contextInjectorMessagesTransform: ReturnType<typeof import("./features/context-injector").createContextInjectorMessagesTransformHook>;
     thinkingBlockValidator: ReturnType<typeof import("./hooks").createThinkingBlockValidatorHook> | null;
     toolPairValidator: ReturnType<typeof import("./hooks").createToolPairValidatorHook> | null;
+    commentChecker: ReturnType<typeof import("./hooks").createCommentCheckerHooks> | null;
     toolOutputTruncator: ReturnType<typeof import("./hooks").createToolOutputTruncatorHook> | null;
     directoryAgentsInjector: ReturnType<typeof import("./hooks").createDirectoryAgentsInjectorHook> | null;
     directoryReadmeInjector: ReturnType<typeof import("./hooks").createDirectoryReadmeInjectorHook> | null;

package/dist/hooks/comment-checker/cli-runner.d.ts

@@ -0,0 +1,22 @@
+import type { PendingCall } from "./types";
+import { runCommentChecker } from "./cli";
+export declare function initializeCommentCheckerCli(debugLog: (...args: unknown[]) => void): void;
+export declare function getCommentCheckerCliPathPromise(): Promise<string | null> | null;
+export declare function processWithCli(input: {
+    tool: string;
+    sessionID: string;
+    callID: string;
+}, pendingCall: PendingCall, output: {
+    output: string;
+}, cliPath: string, customPrompt: string | undefined, debugLog: (...args: unknown[]) => void, deps?: {
+    runCommentChecker?: typeof runCommentChecker;
+}): Promise<void>;
+export interface ApplyPatchEdit {
+    filePath: string;
+    before: string;
+    after: string;
+}
+export declare function processApplyPatchEditsWithCli(sessionID: string, edits: ApplyPatchEdit[], output: {
+    output: string;
+}, cliPath: string, customPrompt: string | undefined, debugLog: (...args: unknown[]) => void): Promise<void>;
+export declare function isCliPathUsable(cliPath: string | null): cliPath is string;

package/dist/hooks/comment-checker/cli.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Asynchronously get comment-checker binary path.
+ * Will trigger lazy download if binary not found.
+ */
+export declare function getCommentCheckerPath(): Promise<string | null>;
+/**
+ * Synchronously get comment-checker path (no download).
+ * Returns cached path or searches known locations.
+ */
+export declare function getCommentCheckerPathSync(): string | null;
+/**
+ * Start background initialization.
+ * Call this early to trigger download while other init happens.
+ */
+export declare function startBackgroundInit(): void;
+export interface HookInput {
+    session_id: string;
+    tool_name: string;
+    transcript_path: string;
+    cwd: string;
+    hook_event_name: string;
+    tool_input: {
+        file_path?: string;
+        content?: string;
+        old_string?: string;
+        new_string?: string;
+        edits?: Array<{
+            old_string: string;
+            new_string: string;
+        }>;
+    };
+    tool_response?: unknown;
+}
+export interface CheckResult {
+    hasComments: boolean;
+    message: string;
+}
+/**
+ * Run comment-checker CLI with given input.
+ * @param input Hook input to check
+ * @param cliPath Optional explicit path to CLI binary
+ * @param customPrompt Optional custom prompt to replace default warning message
+ */
+export declare function runCommentChecker(input: HookInput, cliPath?: string, customPrompt?: string): Promise<CheckResult>;
+/**
+ * Check if CLI is available (sync check, no download).
+ */
+export declare function isCliAvailable(): boolean;
+/**
+ * Check if CLI will be available (async, may trigger download).
+ */
+export declare function ensureCliAvailable(): Promise<boolean>;

package/dist/hooks/comment-checker/downloader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Get the cache directory for oh-my-opencode binaries.
+ * On Windows: Uses %LOCALAPPDATA% or %APPDATA% (Windows conventions)
+ * On Unix: Follows XDG Base Directory Specification
+ */
+export declare function getCacheDir(): string;
+/**
+ * Get the binary name based on platform.
+ */
+export declare function getBinaryName(): string;
+/**
+ * Get the cached binary path if it exists.
+ */
+export declare function getCachedBinaryPath(): string | null;
+/**
+ * Download the comment-checker binary from GitHub Releases.
+ * Returns the path to the downloaded binary, or null on failure.
+ */
+export declare function downloadCommentChecker(): Promise<string | null>;
+/**
+ * Ensure the comment-checker binary is available.
+ * First checks cache, then downloads if needed.
+ * Returns the binary path or null if unavailable.
+ */
+export declare function ensureCommentCheckerBinary(): Promise<string | null>;

package/dist/hooks/comment-checker/hook.d.ts

@@ -0,0 +1,20 @@
+import type { CommentCheckerConfig } from "../../config/schema";
+export declare function createCommentCheckerHooks(config?: CommentCheckerConfig): {
+    "tool.execute.before": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        args: Record<string, unknown>;
+    }) => Promise<void>;
+    "tool.execute.after": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: unknown;
+    }) => Promise<void>;
+    dispose: () => void;
+};

package/dist/hooks/comment-checker/index.d.ts

@@ -0,0 +1 @@
+export { createCommentCheckerHooks } from "./hook";

package/dist/hooks/comment-checker/pending-calls.d.ts

@@ -0,0 +1,5 @@
+import type { PendingCall } from "./types";
+export declare function startPendingCallCleanup(): void;
+export declare function stopPendingCallCleanup(): void;
+export declare function registerPendingCall(callID: string, pendingCall: PendingCall): void;
+export declare function takePendingCall(callID: string): PendingCall | undefined;

package/dist/hooks/comment-checker/types.d.ts

@@ -0,0 +1,31 @@
+export type CommentType = "line" | "block" | "docstring";
+export interface CommentInfo {
+    text: string;
+    lineNumber: number;
+    filePath: string;
+    commentType: CommentType;
+    isDocstring: boolean;
+    metadata?: Record<string, string>;
+}
+export interface PendingCall {
+    filePath: string;
+    content?: string;
+    oldString?: string;
+    newString?: string;
+    edits?: Array<{
+        old_string: string;
+        new_string: string;
+    }>;
+    tool: "write" | "edit" | "multiedit";
+    sessionID: string;
+    timestamp: number;
+}
+export interface FileComments {
+    filePath: string;
+    comments: CommentInfo[];
+}
+export interface FilterResult {
+    shouldSkip: boolean;
+    reason?: string;
+}
+export type CommentFilter = (comment: CommentInfo) => FilterResult;

package/dist/hooks/index.d.ts

@@ -6,6 +6,7 @@ export { buildWindowsToastScript, escapeAppleScriptText, escapePowerShellSingleQ
 export { hasIncompleteTodos } from "./session-todo-status";
 export { createIdleNotificationScheduler } from "./session-notification-scheduler";
 export { createSessionRecoveryHook, type SessionRecoveryHook, type SessionRecoveryOptions } from "./session-recovery";
+export { createCommentCheckerHooks } from "./comment-checker";
 export { createToolOutputTruncatorHook } from "./tool-output-truncator";
 export { createDirectoryAgentsInjectorHook } from "./directory-agents-injector";
 export { createDirectoryReadmeInjectorHook } from "./directory-readme-injector";

package/dist/hooks/keyword-detector/search/default.d.ts

@@ -9,4 +9,4 @@
  * - Vietnamese: tìm kiếm, tra cứu, định vị, quét, phát hiện, truy tìm, tìm ra, ở đâu, liệt kê
  */
 export declare const SEARCH_PATTERN: RegExp;
-export declare const SEARCH_MESSAGE = "[search-mode]\nMAXIMIZE SEARCH EFFORT. Launch multiple background agents IN PARALLEL:\n- explore agents (codebase patterns, file structures)\n- librarian agents (remote repos, official docs, GitHub examples)\nPlus direct tools: Grep, ripgrep (rg)\nNEVER stop at first result - be exhaustive.";
+export declare const SEARCH_MESSAGE = "[search-mode]\nMAXIMIZE SEARCH EFFORT. Launch multiple background agents IN PARALLEL:\n- explore agents (codebase patterns, file structures, ast-grep)\n- librarian agents (remote repos, official docs, GitHub examples)\nPlus direct tools: Grep, ripgrep (rg), ast-grep (sg)\nNEVER stop at first result - be exhaustive.";