oh-my-opencode 5.0.0-beta.6 → 5.0.0-beta.62

package/dist/mcp/index.d.ts

@@ -1,8 +1,6 @@
 import { createWebsearchConfig } from "./websearch";
-import { type CodegraphMcpConfigOptions } from "./codegraph";
 import { type LocalMcpConfig } from "./lsp";
 import type { RuntimeExecutableResolver } from "./runtime-executable";
-import type { CodegraphConfig } from "../config/schema/codegraph";
 export { McpNameSchema, type McpName } from "./types";
 type RemoteMcpConfig = {
     type: "remote";
@@ -13,12 +11,10 @@ type RemoteMcpConfig = {
 };
 type BuiltinMcpConfig = RemoteMcpConfig | LocalMcpConfig;
 type BuiltinMcpOptions = {
-    readonly codegraph?: Pick<CodegraphMcpConfigOptions, "env" | "fileExists" | "homeDir" | "provisioned" | "requireResolve">;
     readonly cwd?: string;
     readonly resolveExecutable?: RuntimeExecutableResolver;
 };
 type BuiltinMcpSourceConfig = {
-    readonly codegraph?: Partial<CodegraphConfig>;
     readonly disabled_tools?: readonly string[];
     readonly websearch?: Parameters<typeof createWebsearchConfig>[0];
 };

package/dist/mcp/types.d.ts

@@ -1,6 +1,5 @@
 import { z } from "zod";
 export declare const McpNameSchema: z.ZodEnum<{
-    codegraph: "codegraph";
     context7: "context7";
     grep_app: "grep_app";
     lsp: "lsp";

package/dist/oh-my-opencode.schema.json

@@ -61,7 +61,7 @@
         "enum": [
           "goal",
           "refactor",
-          "start-work",
+          "ulw-execute",
           "stop-continuation",
           "remove-ai-slops",
           "hyperplan"
@@ -90,7 +90,7 @@
       "type": "boolean"
     },
     "telemetry": {
-      "description": "Enable or disable anonymous telemetry. Default: enabled when omitted. Set to false to disable. Independent of codegraph.telemetry.",
+      "description": "Enable or disable anonymous telemetry. Default: enabled when omitted. Set to false to disable.",
       "type": "boolean"
     },
     "model_fallback": {
@@ -9206,7 +9206,7 @@
       "properties": {
         "defaultConcurrency": {
           "type": "number",
-          "minimum": 1
+          "minimum": 0
         },
         "providerConcurrency": {
           "type": "object",
@@ -9233,6 +9233,11 @@
           "minimum": 1,
           "maximum": 9007199254740991
         },
+        "maxLiveDescendantsPerRoot": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
         "staleTimeoutMs": {
           "type": "number",
           "minimum": 60000
@@ -9544,50 +9549,6 @@
       ],
       "additionalProperties": false
     },
-    "codegraph": {
-      "type": "object",
-      "properties": {
-        "auto_init": {
-          "default": true,
-          "type": "boolean"
-        },
-        "auto_provision": {
-          "default": true,
-          "type": "boolean"
-        },
-        "daemon": {
-          "default": true,
-          "type": "boolean"
-        },
-        "enabled": {
-          "default": true,
-          "type": "boolean"
-        },
-        "excluded_roots": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        "install_dir": {
-          "type": "string"
-        },
-        "telemetry": {
-          "type": "boolean"
-        },
-        "watch_debounce_ms": {
-          "type": "number",
-          "minimum": 0
-        }
-      },
-      "required": [
-        "auto_init",
-        "auto_provision",
-        "daemon",
-        "enabled"
-      ],
-      "additionalProperties": false
-    },
     "team_mode": {
       "type": "object",
       "properties": {
@@ -9890,6 +9851,19 @@
       },
       "additionalProperties": false
     },
+    "ulw_execute": {
+      "type": "object",
+      "properties": {
+        "auto_commit": {
+          "default": true,
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "auto_commit"
+      ],
+      "additionalProperties": false
+    },
     "start_work": {
       "type": "object",
       "properties": {

package/dist/plugin/chat-message/types.d.ts

@@ -19,7 +19,7 @@ export type ChatMessageInput = {
         readonly modelID: string;
     };
 };
-export type StartWorkHookOutput = {
+export type UlwExecuteHookOutput = {
     readonly parts: Array<{
         readonly type: string;
         readonly text?: string;
@@ -29,7 +29,7 @@ export type SessionModelOverride = {
     readonly providerID: string;
     readonly modelID: string;
 };
-export type WorkStartingCommand = "start-work" | "ralph-loop" | "ulw-loop";
+export type WorkStartingCommand = "ulw-execute" | "ralph-loop" | "ulw-loop";
 type ChatMessageHook = {
     "chat.message"?: (input: ChatMessageInput, output: ChatMessageHandlerOutput) => Promise<void>;
 };
@@ -70,14 +70,16 @@ export type ChatMessageHooks = {
     stopContinuationGuard?: StopContinuationGuard | null;
     backgroundNotificationHook?: ChatMessageHook | null;
     runtimeFallback?: ChatMessageHook | null;
-    keywordDetector?: ChatMessageHook | null;
+    keywordDetector?: (ChatMessageHook & {
+        clearSession?: (sessionID: string) => void;
+    }) | null;
     thinkMode?: ChatMessageHook | null;
     claudeCodeHooks?: ChatMessageHook | null;
     autoSlashCommand?: ChatMessageHook | null;
     noSisyphusGpt?: ChatMessageHook | null;
     noHephaestusNonGpt?: ChatMessageHook | null;
     hephaestusAgentsMdInjector?: ChatMessageHook | null;
-    startWork?: ChatMessageHook | null;
+    ulwExecute?: ChatMessageHook | null;
     goal?: GoalHook | null;
     todoContinuationEnforcer?: TodoContinuationEnforcerHook | null;
 };

package/dist/plugin/chat-message/ulw-execute-message.d.ts

@@ -0,0 +1,5 @@
+import type { ChatMessageHooks, ChatMessageInput, ChatMessageHandlerOutput, UlwExecuteHookOutput, WorkStartingCommand } from "./types";
+export declare function isUlwExecuteHookOutput(value: unknown): value is UlwExecuteHookOutput;
+export declare function isUlwExecuteFallbackTemplate(promptText: string): boolean;
+export declare function clearStoppedContinuationBeforeUlwExecute(hooks: ChatMessageHooks, sessionID: string, command: WorkStartingCommand): void;
+export declare function runUlwExecuteHookIfApplicable(hooks: ChatMessageHooks, input: ChatMessageInput, output: ChatMessageHandlerOutput): Promise<void>;

package/dist/plugin/event-session-lifecycle.d.ts

@@ -3,6 +3,7 @@ import type { Managers } from "../create-managers";
 import type { FirstMessageVariantGate, PluginEventContext } from "./event-types";
 export declare const TMUX_ACTIVITY_EVENT_TYPES: ReadonlySet<string>;
 export declare function isCompactionAgent(agent: string): boolean;
+export declare function shouldDispatchOpenClawSessionEvent(sessionID: string): boolean;
 export declare function dispatchOpenClawSessionEvent(args: {
     pluginConfig: OhMyOpenCodeConfig;
     pluginContext: PluginEventContext;

package/dist/plugin/hooks/create-core-hooks.d.ts

@@ -20,7 +20,6 @@ export declare function createCoreHooks(args: {
     modelFallback: ReturnType<typeof import("../../hooks").createModelFallbackHook> | null;
     anthropicContextWindowLimitRecovery: ReturnType<typeof import("../../hooks").createAnthropicContextWindowLimitRecoveryHook> | null;
     autoUpdateChecker: ReturnType<typeof import("../../hooks").createAutoUpdateCheckerHook> | null;
-    codegraphBootstrap: ReturnType<typeof import("../../hooks").createCodegraphBootstrapHook> | null;
     astGrepSgProvision: ReturnType<typeof import("../../hooks").createAstGrepSgProvisionHook> | null;
     agentUsageReminder: ReturnType<typeof import("../../hooks").createAgentUsageReminderHook> | null;
     nonInteractiveEnv: ReturnType<typeof import("../../hooks").createNonInteractiveEnvHook> | null;
@@ -28,7 +27,7 @@ export declare function createCoreHooks(args: {
     goal: ReturnType<typeof import("../../hooks").createGoalHook> | null;
     editErrorRecovery: ReturnType<typeof import("../../hooks").createEditErrorRecoveryHook> | null;
     delegateTaskRetry: ReturnType<typeof import("../../hooks").createDelegateTaskRetryHook> | null;
-    startWork: ReturnType<typeof import("../../hooks").createStartWorkHook> | null;
+    ulwExecute: ReturnType<typeof import("../../hooks").createUlwExecuteHook> | null;
     prometheusMdOnly: ReturnType<typeof import("../../hooks").createPrometheusMdOnlyHook> | null;
     sisyphusJuniorNotepad: ReturnType<typeof import("../../hooks").createSisyphusJuniorNotepadHook> | null;
     noSisyphusGpt: ReturnType<typeof import("../../hooks").createNoSisyphusGptHook> | null;
@@ -58,6 +57,7 @@ export declare function createCoreHooks(args: {
     planFormatValidator: ReturnType<typeof import("../../hooks").createPlanFormatValidatorHook> | null;
     claudeCodeHooks: ReturnType<typeof import("../../hooks").createClaudeCodeHooksHook> | null;
     keywordDetector: ReturnType<typeof import("../../hooks").createKeywordDetectorHook> | null;
+    btwSideContextInjector: ReturnType<typeof import("../../features/btw-side").createBtwSideContextInjectorHook>;
     contextInjectorMessagesTransform: ReturnType<typeof import("../../features/context-injector").createContextInjectorMessagesTransformHook>;
     teamModeStatusInjector: ReturnType<typeof import("../../hooks").createTeamModeStatusInjector> | null;
     teamMailboxInjector: ReturnType<typeof import("../../hooks").createTeamMailboxInjector> | null;

package/dist/plugin/hooks/create-session-hooks.d.ts

@@ -3,7 +3,7 @@ import type { BackgroundManager } from "../../features/background-agent";
 import type { ModelFallbackControllerAccessor } from "../../hooks/model-fallback";
 import type { ModelCacheState } from "../../plugin-state";
 import type { PluginContext } from "../types";
-import { createSessionNotification, createThinkModeHook, createModelFallbackHook, createAnthropicContextWindowLimitRecoveryHook, createAutoUpdateCheckerHook, createCodegraphBootstrapHook, createAstGrepSgProvisionHook, createAgentUsageReminderHook, createNonInteractiveEnvHook, createInteractiveBashSessionHook, createEditErrorRecoveryHook, createDelegateTaskRetryHook, createTaskResumeInfoHook, createStartWorkHook, createPrometheusMdOnlyHook, createSisyphusJuniorNotepadHook, createNoSisyphusGptHook, createNoHephaestusNonGptHook, createHephaestusAgentsMdInjectorHook, createQuestionLabelTruncatorHook, createPreemptiveCompactionHook, createRuntimeFallbackHook, createLegacyPluginToastHook } from "../../hooks";
+import { createSessionNotification, createThinkModeHook, createModelFallbackHook, createAnthropicContextWindowLimitRecoveryHook, createAutoUpdateCheckerHook, createAstGrepSgProvisionHook, createAgentUsageReminderHook, createNonInteractiveEnvHook, createInteractiveBashSessionHook, createEditErrorRecoveryHook, createDelegateTaskRetryHook, createTaskResumeInfoHook, createUlwExecuteHook, createPrometheusMdOnlyHook, createSisyphusJuniorNotepadHook, createNoSisyphusGptHook, createNoHephaestusNonGptHook, createHephaestusAgentsMdInjectorHook, createQuestionLabelTruncatorHook, createPreemptiveCompactionHook, createRuntimeFallbackHook, createLegacyPluginToastHook } from "../../hooks";
 import { createGoalHook } from "../../hooks/goal";
 export type SessionHooks = {
     preemptiveCompaction: ReturnType<typeof createPreemptiveCompactionHook> | null;
@@ -12,7 +12,6 @@ export type SessionHooks = {
     modelFallback: ReturnType<typeof createModelFallbackHook> | null;
     anthropicContextWindowLimitRecovery: ReturnType<typeof createAnthropicContextWindowLimitRecoveryHook> | null;
     autoUpdateChecker: ReturnType<typeof createAutoUpdateCheckerHook> | null;
-    codegraphBootstrap: ReturnType<typeof createCodegraphBootstrapHook> | null;
     astGrepSgProvision: ReturnType<typeof createAstGrepSgProvisionHook> | null;
     agentUsageReminder: ReturnType<typeof createAgentUsageReminderHook> | null;
     nonInteractiveEnv: ReturnType<typeof createNonInteractiveEnvHook> | null;
@@ -20,7 +19,7 @@ export type SessionHooks = {
     goal: ReturnType<typeof createGoalHook> | null;
     editErrorRecovery: ReturnType<typeof createEditErrorRecoveryHook> | null;
     delegateTaskRetry: ReturnType<typeof createDelegateTaskRetryHook> | null;
-    startWork: ReturnType<typeof createStartWorkHook> | null;
+    ulwExecute: ReturnType<typeof createUlwExecuteHook> | null;
     prometheusMdOnly: ReturnType<typeof createPrometheusMdOnlyHook> | null;
     sisyphusJuniorNotepad: ReturnType<typeof createSisyphusJuniorNotepadHook> | null;
     noSisyphusGpt: ReturnType<typeof createNoSisyphusGptHook> | null;

package/dist/plugin/hooks/create-transform-hooks.d.ts

@@ -3,9 +3,11 @@ import type { MonitorManager } from "../../features/monitor";
 import type { PluginContext } from "../types";
 import { createClaudeCodeHooksHook, createKeywordDetectorHook, createMonitorStatusInjectorHook, createTeamMailboxInjector, createTeamModeStatusInjector, createToolPairValidatorHook } from "../../hooks";
 import { createContextInjectorMessagesTransformHook } from "../../features/context-injector";
+import { createBtwSideContextInjectorHook } from "../../features/btw-side";
 export type TransformHooks = {
     claudeCodeHooks: ReturnType<typeof createClaudeCodeHooksHook> | null;
     keywordDetector: ReturnType<typeof createKeywordDetectorHook> | null;
+    btwSideContextInjector: ReturnType<typeof createBtwSideContextInjectorHook>;
     contextInjectorMessagesTransform: ReturnType<typeof createContextInjectorMessagesTransformHook>;
     teamModeStatusInjector: ReturnType<typeof createTeamModeStatusInjector> | null;
     teamMailboxInjector: ReturnType<typeof createTeamMailboxInjector> | null;

package/dist/plugin/messages-transform.d.ts

@@ -8,6 +8,7 @@ type MessagesTransformOutput = {
     messages: MessageWithParts[];
 };
 type MessagesTransformHooks = {
+    btwSideContextInjector?: CreatedHooks["btwSideContextInjector"];
     contextInjectorMessagesTransform?: CreatedHooks["contextInjectorMessagesTransform"];
     teamModeStatusInjector?: CreatedHooks["teamModeStatusInjector"];
     teamMailboxInjector?: CreatedHooks["teamMailboxInjector"];

package/dist/plugin/stop-continuation.d.ts

@@ -1,4 +1,7 @@
 type StopContinuationHooks = {
+    readonly keywordDetector?: {
+        readonly clearSession?: (sessionID: string) => void;
+    } | null;
     readonly stopContinuationGuard?: {
         readonly stop?: (sessionID: string) => void;
     } | null;

package/dist/plugin/system-transform.d.ts

@@ -1,5 +1,8 @@
 import type { DefaultModeConfig } from "../config/schema/default-mode";
-export declare function createSystemTransformHandler(defaultMode?: DefaultModeConfig, getUltraworkMessage?: (agentName?: string, modelID?: string) => string): (input: {
+type UltraworkRestoration = {
+    getSystemTransformGuidance?: (sessionID: string, modelID?: string) => string | undefined;
+};
+export declare function createSystemTransformHandler(defaultMode?: DefaultModeConfig, getUltraworkMessage?: (agentName?: string, modelID?: string) => string, ultraworkRestoration?: UltraworkRestoration | null): (input: {
     sessionID?: string;
     model: {
         id: string;
@@ -9,3 +12,4 @@ export declare function createSystemTransformHandler(defaultMode?: DefaultModeCo
 }, output: {
     system: string[];
 }) => Promise<void>;
+export {};

package/dist/plugin-dispose.d.ts

@@ -6,5 +6,8 @@ export declare function createPluginDispose(args: {
     skillMcpManager: {
         disconnectAll: () => Promise<void>;
     };
+    tuiStateMirror?: {
+        stop: () => void;
+    };
     disposeHooks: () => void;
 }): PluginDispose;

package/dist/shared/agent-tool-restrictions.d.ts

@@ -2,5 +2,4 @@ type AgentToolRestrictionsOptions = {
     includeTeamToolDenylist?: boolean;
 };
 export declare function getAgentToolRestrictions(agentName: string, options?: AgentToolRestrictionsOptions): Record<string, boolean>;
-export declare function hasAgentToolRestrictions(agentName: string): boolean;
 export {};

package/dist/shared/compaction-agent-config-checkpoint.d.ts

@@ -3,6 +3,7 @@ export type CompactionAgentConfigCheckpoint = {
     model?: {
         providerID: string;
         modelID: string;
+        variant?: string;
     };
     tools?: Record<string, boolean>;
 };

package/dist/shared/index.d.ts

@@ -67,9 +67,11 @@ export * from "./prompt-tools";
 export * from "./prompt-failure-classifier";
 export * from "./compaction-marker";
 export * from "./internal-initiator-marker";
+export * from "./runtime-fallback-retry-marker";
 export * from "./plugin-command-discovery";
 export { SessionCategoryRegistry } from "./session-category-registry";
 export * from "./plugin-identity";
+export * from "./plugin-entry-shape";
 export * from "./log-legacy-plugin-startup-warning";
 export * from "./legacy-workspace-migration";
 export * from "./task-system-enabled";

package/dist/shared/legacy-plugin-warning.d.ts

@@ -1,7 +1,8 @@
+import { type PluginEntry } from "./plugin-entry-shape";
 export interface LegacyPluginCheckResult {
     hasLegacyEntry: boolean;
     hasCanonicalEntry: boolean;
-    legacyEntries: string[];
+    legacyEntries: PluginEntry[];
     configPath: string | null;
 }
 export declare function checkForLegacyPluginEntry(overrideConfigDir?: string): LegacyPluginCheckResult;

package/dist/shared/normalize-sdk-response.d.ts

@@ -1,4 +1,5 @@
 export interface NormalizeSDKResponseOptions {
+    /** Return the raw response when data is missing, except when the fallback requires an array. */
     preferResponseOnMissingData?: boolean;
 }
 export declare function normalizeSDKResponse<TData>(response: unknown, fallback: TData, options?: NormalizeSDKResponseOptions): TData;

package/dist/shared/omo-process-sweep.d.ts

@@ -1,17 +1,15 @@
-import { sweepCodegraphZombies, sweepOrphanedLspDaemonProxies, sweepStaleLspDaemonVersions } from "@oh-my-opencode/utils/process-sweep";
+import { sweepOrphanedLspDaemonProxies, sweepStaleLspDaemonVersions } from "@oh-my-opencode/utils/process-sweep";
 export interface OmoFamilySweepOptions {
     readonly log?: (message: string) => void;
 }
 export interface OmoFamilySweeps {
-    readonly sweepCodegraph: typeof sweepCodegraphZombies;
     readonly sweepLspProxies: typeof sweepOrphanedLspDaemonProxies;
     readonly sweepStaleLspDaemons: typeof sweepStaleLspDaemonVersions;
 }
-export declare function sweepCodegraphZombiesBestEffort(options: OmoFamilySweepOptions, sweep?: typeof sweepCodegraphZombies): Promise<void>;
 export declare function sweepOrphanedLspDaemonProxiesBestEffort(options: OmoFamilySweepOptions, sweep?: typeof sweepOrphanedLspDaemonProxies): Promise<void>;
 export declare function sweepStaleLspDaemonVersionsBestEffort(options: OmoFamilySweepOptions, sweep?: typeof sweepStaleLspDaemonVersions): Promise<void>;
 /**
- * Runs all three omo sweep families concurrently. NEVER rejects: each family
+ * Runs every omo sweep family concurrently. NEVER rejects: each family
  * is wrapped best-effort so a sweep failure can only produce a log line, not
  * a startup failure. Callers fire-and-forget the returned promise.
  */

package/dist/shared/plugin-entry-migrator.d.ts

@@ -1,3 +1,4 @@
-export declare function isLegacyEntry(entry: string): boolean;
-export declare function isCanonicalEntry(entry: string): boolean;
-export declare function toCanonicalEntry(entry: string): string;
+import { type PluginEntry } from "./plugin-entry-shape";
+export declare function isLegacyEntry(entry: PluginEntry): boolean;
+export declare function isCanonicalEntry(entry: PluginEntry): boolean;
+export declare function toCanonicalEntry(entry: PluginEntry): PluginEntry;

package/dist/shared/plugin-entry-shape.d.ts

@@ -0,0 +1,6 @@
+export type PluginEntryOptions = Record<string, unknown>;
+export type PluginTupleEntry = readonly [string, PluginEntryOptions];
+export type PluginEntry = string | PluginTupleEntry;
+export declare function isPluginTupleEntry(entry: unknown): entry is PluginTupleEntry;
+export declare function getPluginEntryName(entry: PluginEntry): string;
+export declare function withPluginEntryName(entry: PluginEntry, name: string): PluginEntry;

package/dist/shared/runtime-fallback-retry-marker.d.ts

@@ -0,0 +1,16 @@
+export declare const OMO_RUNTIME_FALLBACK_RETRY_MARKER = "<!-- OMO_RUNTIME_FALLBACK_RETRY -->";
+type RuntimeFallbackRetryTextPartLike = {
+    type?: string;
+    text?: string;
+};
+export declare function hasRuntimeFallbackRetryMarker(text: string): boolean;
+export declare function createRuntimeFallbackRetryTextPart(text: string): {
+    type: "text";
+    synthetic: true;
+    metadata: {
+        compaction_continue: true;
+    };
+    text: string;
+};
+export declare function isRuntimeFallbackRetryTextParts(parts: readonly RuntimeFallbackRetryTextPartLike[] | undefined): boolean;
+export {};

package/dist/shared/shell-env.d.ts

@@ -13,7 +13,7 @@ export type ShellType = "unix" | "powershell" | "cmd" | "csh";
  * specific (BASH_VERSION, MSYSTEM, WSL_DISTRO_NAME) — TERM is excluded
  * because some PowerShell users set it manually.
  */
-export declare function detectShellType(): ShellType;
+export declare function detectShellType(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): ShellType;
 /**
  * Shell-escape a value for use in environment variable assignment.
  *

package/dist/skills/ast-grep/AGENTS.md

@@ -0,0 +1,51 @@
+# ast-grep — Vendored Structural-Search Skill
+
+**Generated:** 2026-08-24 (f3642fcda)
+
+## OVERVIEW
+
+Vendored skill teaching agents ast-grep (`sg`) structural search/rewrite, plus a stdlib-Python helper CLI that wraps the `sg` binary. Vendoring pin in `SOURCE`: upstream `code-yeongyu/ast-grep-skill @ 3148c69` (ast-grep 0.45.0), "vendored as a sync; do not fork-drift". Earned this file: own executable surface (749-LOC helper + installers + smoke tests) and a no-fork-drift upstream contract that has no analogue elsewhere in `shared-skills`.
+
+## STRUCTURE
+
+```
+ast-grep/
+├── SKILL.md / README.md          # agent workflow / user overview
+├── SOURCE                        # upstream pin — the no-fork-drift contract
+├── scripts/ast_grep_helper.py    # 749-LOC stdlib CLI (argparse; no deps)
+├── install.sh / install.ps1      # macOS/Linux + Windows installers
+├── references/                   # cli, install, patterns, pitfalls, recipes, yaml-rules (510 LOC), sgconfig
+└── tests/smoke.{sh,ps1}          # POSIX + PowerShell smoke (also shell syntax + content checks)
+```
+
+## HELPER CLI (`scripts/ast_grep_helper.py`)
+
+Subcommands: `search`, `replace` (dry-run; `--apply` to write), `scan`, `test`, `new`, `langs`, `doctor`, `install`, `validate`. Resolves the `sg`/`ast-grep` binary across PATH, Homebrew, npm, and OMO caches, validates patterns before executing, and shells out — it never links ast-grep as a library. Internal handlers `cmd_*`; utilities `validate_pattern`, `normalize_lang`, `resolve_binary`, `run_sg`. Nothing in-repo imports it; docs and skills invoke it by path. `omo-opencode/src/cli/install-ast-grep-sg.ts` locates this skill dir to install the binary.
+
+## CONVENTIONS
+
+- AST patterns, never regex, for syntax-shaped queries; `$VAR` singles, `$$$` multis; patterns must parse as complete code in the target language.
+- Two-pass rewrites: preview with `--json=compact`, apply separately with `--update-all` — the flags are mutually exclusive in `sg`.
+- `sgconfig.yml` discovered upward; `ruleDirs`, optional `testConfigs`/`utilDirs`, language globs, custom languages, injections.
+- Upstream syncs land as whole vendored refreshes matching `SOURCE`; local edits ride along until the next sync absorbs or reverts them.
+
+## ANTI-PATTERNS
+
+- NO regex constructs (`.*`, `.+`, `\w`, `\d`, literal `|`) inside AST patterns — that is the skill's #1 pitfall.
+- No incomplete patterns (e.g. Python `def $F($$$):` without a body).
+- NEVER `--apply` a rewrite without the dry-run preview first.
+- Text/comment/byte queries go to `rg`, not structural matching.
+- Do not fork-drift from the `SOURCE` pin; a sync is a vendored refresh, not a merge.
+
+## COMMANDS
+
+```bash
+# from packages/shared-skills/skills/ast-grep/
+python3 scripts/ast_grep_helper.py search '<PATTERN>' --lang ts [path]
+python3 scripts/ast_grep_helper.py replace '<PATTERN>' '<REWRITE>' --lang ts   # dry-run; add --apply
+python3 scripts/ast_grep_helper.py doctor
+bash tests/smoke.sh          # or: pwsh tests/smoke.ps1
+# direct:  sg run -p '<PATTERN>' --lang ts path
+```
+
+- Parent: [`packages/shared-skills/AGENTS.md`](../../AGENTS.md).

package/dist/skills/ast-grep/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ast-grep
-description: "Use ast-grep (sg) for AST-aware code search and rewrite across 25 languages. Trigger for structural code matching or deterministic codemods: find every function/call/class/import shaped like X, rewrite console.log to logger.info, strip `as any`, migrate require() to import, find empty catch blocks or missing await, and scan/apply YAML rules. Prefer this over rg/grep when the target is syntax shape rather than text; use rg for string contents, comments, filenames, or regex-style byte searches."
+description: "Searches and rewrites code by AST shape across 25 languages. Use when the target is a syntax pattern (every call/class/import shaped like X, a codemod, a YAML rule) rather than literal text; for plain strings, comments, or filenames, use rg."
 ---
 
 # ast-grep

package/dist/skills/coding-agent-sessions/AGENTS.md

@@ -0,0 +1,62 @@
+# coding-agent-sessions — Cross-Platform Session Finder (Python)
+
+**Generated:** 2026-08-24 (f3642fcda)
+
+## OVERVIEW
+
+The only shared skill besides `ultimate-browsing` carrying a real sub-project: a Python package + CLI that finds, lists, searches, and reads local coding-agent session transcripts across ~25 platforms (Codex, Claude, OpenCode, OMO/Senpi/pi, and a long tail), normalizing them into one `Session` model. Earned this file: 33 files, 23 Python modules, own test suite, own `pyrightconfig.json`, own `.npmignore` (ships in the npm package minus tests/caches).
+
+## STRUCTURE
+
+```
+coding-agent-sessions/
+├── SKILL.md                      # router: platform table → references/<platform>.md
+├── references/                   # codex, claude, opencode, senpi, all-platforms (store layouts per platform)
+├── agents/openai.yaml            # Codex agent role declaration
+├── scripts/
+│   ├── find-agent-sessions.py    # thin shebang entry (PEP 723, >=3.11); runpy → agent_sessions.cli
+│   ├── agent_sessions/           # the package (12 modules)
+│   └── tests/                    # 6 pytest modules
+└── pyrightconfig.json            # extraPaths scripts/, excludes scripts/tests
+```
+
+## PUBLIC API (`scripts/agent_sessions/`)
+
+| Module | Key exports |
+|--------|-------------|
+| `scanners.py` | `scan`, `DEFAULT_PLATFORMS`, `PLATFORM_SCANNERS`, per-platform `scan_*` (codex, claude, opencode, senpi, oh_my_pi, gajae_code, …) |
+| `types.py` | `Session`, `Options`, `Json`, `JsonMap` — imported by nearly every module and test |
+| `transcript.py` | parallel file reads, normalization, timestamps, session ids; `recent`, `MAX_PLATFORM_FILES` |
+| `cli.py` | command parsing, filtering, payload construction, JSON emission (283 LOC — behavioral hotspot) |
+| platform adapters | `file_scanners.py` (file-backed providers), `opencode.py` (CLI/SQLite/storage fallbacks), `sqlite_scanners.py`, `sqlite_optional_scanners.py`, `pi_family.py`, `aside_scanner.py`, `kiro_scanner.py` |
+
+## CLI CONTRACT
+
+`python3 scripts/find-agent-sessions.py <command>`; aliases `find`=`search`, `read`=`get`. Commands: `list`, `find`/`search` (repeated `--query` lanes, `--from 7d`, repeated `--platform`, `--workers`, `--cwd/--model`, `--include-subagents`, `--limit`), `get`/`read <session-id>`. Output is JSON with `match_reasons` and reconstructed first/last user prompts — that JSON shape is the stable contract.
+
+## CONVENTIONS
+
+- Stdlib-only Python (`>=3.11`), `from __future__ import annotations`, pathlib everywhere; no third-party deps at runtime.
+- Probe-first, bounded discovery: platform-specific roots checked before broad globbing; optional platforms excluded from default search when they cannot reconstruct user prompts.
+- Main sessions hide subagent children by default but report child counts; `--include-subagents` flips it. Parent/child linkage preserved and records deduplicated.
+- Tests are pytest with `tmp_path` + `MonkeyPatch` isolation; in-file `# pyright: ignore[reportMissingImports]`-style relaxations for import diagnostics only.
+- `.npmignore` strips `scripts/tests/`, `pyrightconfig.json`, and caches from the shipped skill.
+
+## ANTI-PATTERNS
+
+- NEVER answer from normalized previews alone — pull the raw transcript (`read`/`get`) for exact evidence.
+- Usage-only stores are NOT transcript sources.
+- A Claude subagent's embedded `sessionId` is NOT its identity — use its `agentId` + parent-directory linkage.
+- Don't add a platform by globbing blindly; register it in `PLATFORM_SCANNERS`/`DEFAULT_PLATFORMS` with a bounded root probe.
+
+## COMMANDS
+
+```bash
+# from packages/shared-skills/skills/coding-agent-sessions/
+python3 scripts/find-agent-sessions.py list --limit 20
+python3 scripts/find-agent-sessions.py find "commit" --from 7d --platform senpi --platform opencode
+python3 scripts/find-agent-sessions.py read <session-id>
+pytest scripts/tests
+```
+
+- Parent: [`packages/shared-skills/AGENTS.md`](../../AGENTS.md).

package/dist/skills/coding-agent-sessions/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: coding-agent-sessions
-description: "MUST USE when asked to find, read, list, search, inspect, fetch, export, or reconstruct coding-agent sessions across Codex, Claude Code/Desktop, OpenCode, OMO/Senpi/pi, oh-my-pi (omp), gajae-code (gjc), OpenClaw, Factory Droid, Amp, Gemini/Kimi/Qwen CLIs, Codebuff, Roo/Kilo/Cline, Kodu, Cursor CLI, Aider, Aside browser-agent sessions, or unknown local agent logs. Covers transcripts, session IDs, rollout JSONL, state SQLite, Claude projects/pre-compact histories, OpenCode messages/parts, child/subagent linkage, cwd/model/time/token filters, archives, and cost clues. Expands fuzzy recall into parallel query lanes and first probes known stores so absent platforms are skipped cheaply. Triggers: coding agent sessions, Codex/Claude/OpenCode/OMO/Senpi/pi/oh-my-pi/omp/gajae-code/gjc/OpenClaw/Droid/Amp/Kodu/Cursor/Aider/Aside sessions, transcript search, session history, session ID, read transcript, token usage, subagent sessions, what did I do yesterday, did we already do this."
+description: "Finds, reads, and reconstructs coding-agent sessions across Codex, Claude, OpenCode, OMO/Senpi, and other local agent logs. Use when asked to find or search past sessions, transcripts, or subagent runs, or to recover what an earlier session did."
 ---
 
 # Coding Agent Sessions