oh-my-opencode 4.5.1 → 4.5.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (584) hide show
  1. package/README.ja.md +33 -18
  2. package/README.ko.md +33 -18
  3. package/README.md +82 -24
  4. package/README.ru.md +33 -18
  5. package/README.zh-cn.md +45 -24
  6. package/bin/oh-my-opencode.js +47 -2
  7. package/bin/oh-my-opencode.test.ts +174 -0
  8. package/bin/platform.d.ts +6 -0
  9. package/bin/platform.js +19 -0
  10. package/bin/platform.test.ts +66 -1
  11. package/dist/cli/cli-program.d.ts +18 -0
  12. package/dist/cli/index.js +28472 -26159
  13. package/dist/cli/install-codex/codex-cache-bundled-mcps.d.ts +5 -0
  14. package/dist/cli/install-codex/codex-cache-command-shim.d.ts +1 -0
  15. package/dist/cli/install-codex/codex-cache-legacy-bins.d.ts +3 -0
  16. package/dist/cli/install-codex/codex-cache-local-dependencies.d.ts +1 -0
  17. package/dist/cli/install-codex/codex-cache-paths.d.ts +2 -0
  18. package/dist/cli/install-codex/codex-cache.d.ts +31 -0
  19. package/dist/cli/install-codex/codex-config-toml.d.ts +11 -0
  20. package/dist/cli/install-codex/codex-hook-trust.d.ts +6 -0
  21. package/dist/cli/install-codex/codex-marketplace-snapshot.d.ts +15 -0
  22. package/dist/cli/install-codex/codex-marketplace.d.ts +9 -0
  23. package/dist/cli/install-codex/codex-multi-agent-v2-config.d.ts +1 -0
  24. package/dist/cli/install-codex/codex-process.d.ts +2 -0
  25. package/dist/cli/install-codex/index.d.ts +7 -0
  26. package/dist/cli/install-codex/install-codex.d.ts +17 -0
  27. package/dist/cli/install-codex/link-cached-plugin-agents.d.ts +12 -0
  28. package/dist/cli/install-codex/toml-section-editor.d.ts +9 -0
  29. package/dist/cli/install-codex/types.d.ts +56 -0
  30. package/dist/cli/star-request.d.ts +2 -0
  31. package/dist/cli/tui-install-prompts.d.ts +3 -2
  32. package/dist/cli/types.d.ts +8 -0
  33. package/dist/config/schema/agent-names.d.ts +4 -1
  34. package/dist/config/schema/commands.d.ts +1 -2
  35. package/dist/config/schema/oh-my-opencode-config.d.ts +5 -3
  36. package/dist/create-managers.d.ts +1 -0
  37. package/dist/features/background-agent/parent-wake-message-activity.d.ts +23 -0
  38. package/dist/features/background-agent/parent-wake-notifier.d.ts +0 -1
  39. package/dist/features/boulder-state/storage.d.ts +1 -1
  40. package/dist/features/builtin-commands/templates/refactor.d.ts +1 -1
  41. package/dist/features/builtin-commands/templates/remove-ai-slops.d.ts +2 -2
  42. package/dist/features/builtin-commands/types.d.ts +1 -1
  43. package/dist/features/builtin-skills/skill-file-loader.d.ts +4 -0
  44. package/dist/features/builtin-skills/skills/index.d.ts +4 -1
  45. package/dist/features/builtin-skills/skills/init-deep.d.ts +2 -0
  46. package/dist/features/builtin-skills/skills/remove-ai-slops.d.ts +2 -0
  47. package/dist/features/builtin-skills/skills/security-research.d.ts +2 -0
  48. package/dist/features/builtin-skills/skills/security-review.d.ts +2 -0
  49. package/dist/features/opencode-runtime-skills/index.d.ts +2 -0
  50. package/dist/features/opencode-runtime-skills/runtime-skill-config.d.ts +17 -0
  51. package/dist/features/opencode-runtime-skills/skill-markdown.d.ts +7 -0
  52. package/dist/features/opencode-runtime-skills/source-server.d.ts +8 -0
  53. package/dist/hooks/claude-code-hooks/hook-text.d.ts +2 -0
  54. package/dist/hooks/session-recovery/storage/latest-assistant-message.d.ts +5 -0
  55. package/dist/hooks/session-recovery/storage/thinking-prepend.d.ts +3 -0
  56. package/dist/hooks/thinking-block-validator/hook.d.ts +0 -18
  57. package/dist/hooks/todo-continuation-enforcer/pending-question-detection.d.ts +4 -0
  58. package/dist/index.js +1684 -1801
  59. package/dist/oh-my-opencode.schema.json +4 -2
  60. package/dist/plugin-handlers/config-handler.d.ts +2 -1
  61. package/dist/shared/external-plugin-detector.d.ts +8 -0
  62. package/dist/shared/prompt-async-gate/message-inspection-error.d.ts +1 -0
  63. package/dist/shared/prompt-async-gate/pending-tool-turn.d.ts +1 -0
  64. package/dist/shared/prompt-async-gate/prompt-message-state.d.ts +8 -0
  65. package/dist/shared/prompt-timeout-context.d.ts +2 -0
  66. package/dist/testing/create-plugin-module.d.ts +5 -1
  67. package/dist/tools/delegate-task/sync-prompt-sender.d.ts +2 -2
  68. package/package.json +31 -16
  69. package/packages/ast-grep-mcp/dist/cli.js +245 -40
  70. package/packages/lsp-tools-mcp/dist/cli.js +1 -1
  71. package/packages/omo-codex/marketplace.json +17 -0
  72. package/packages/omo-codex/plugin/.codex-plugin/plugin.json +35 -0
  73. package/packages/omo-codex/plugin/.mcp.json +14 -0
  74. package/packages/omo-codex/plugin/README.md +13 -0
  75. package/packages/omo-codex/plugin/components/comment-checker/.gitattributes +13 -0
  76. package/packages/omo-codex/plugin/components/comment-checker/.github/CODEOWNERS +12 -0
  77. package/packages/omo-codex/plugin/components/comment-checker/.github/ISSUE_TEMPLATE/bug.yml +40 -0
  78. package/packages/omo-codex/plugin/components/comment-checker/.github/ISSUE_TEMPLATE/feature.yml +27 -0
  79. package/packages/omo-codex/plugin/components/comment-checker/.github/branch-ruleset.json +45 -0
  80. package/packages/omo-codex/plugin/components/comment-checker/.github/dependabot.yml +16 -0
  81. package/packages/omo-codex/plugin/components/comment-checker/.github/pull_request_template.md +19 -0
  82. package/packages/omo-codex/plugin/components/comment-checker/.github/workflows/ci.yml +47 -0
  83. package/packages/omo-codex/plugin/components/comment-checker/.github/workflows/publish.yml +51 -0
  84. package/packages/omo-codex/plugin/components/comment-checker/AGENTS.md +35 -0
  85. package/packages/omo-codex/plugin/components/comment-checker/CHANGELOG.md +33 -0
  86. package/packages/omo-codex/plugin/components/comment-checker/LICENSE +21 -0
  87. package/packages/omo-codex/plugin/components/comment-checker/NOTICE +6 -0
  88. package/packages/omo-codex/plugin/components/comment-checker/README.md +87 -0
  89. package/packages/omo-codex/plugin/components/comment-checker/biome.json +48 -0
  90. package/packages/omo-codex/plugin/components/comment-checker/hooks/hooks.json +17 -0
  91. package/packages/omo-codex/plugin/components/comment-checker/package.json +57 -0
  92. package/packages/omo-codex/plugin/components/comment-checker/skills/comment-checker/SKILL.md +16 -0
  93. package/packages/omo-codex/plugin/components/comment-checker/src/cli.ts +12 -0
  94. package/packages/omo-codex/plugin/components/comment-checker/src/codex-hook.ts +205 -0
  95. package/packages/omo-codex/plugin/components/comment-checker/src/core.ts +361 -0
  96. package/packages/omo-codex/plugin/components/comment-checker/src/runner.ts +195 -0
  97. package/packages/omo-codex/plugin/components/comment-checker/test/codex-hook-newline.test.ts +52 -0
  98. package/packages/omo-codex/plugin/components/comment-checker/test/codex-hook.test.ts +368 -0
  99. package/packages/omo-codex/plugin/components/comment-checker/test/fixtures/post-tool-use.json +15 -0
  100. package/packages/omo-codex/plugin/components/comment-checker/test/package-smoke.test.ts +93 -0
  101. package/packages/omo-codex/plugin/components/comment-checker/test/runner.test.ts +66 -0
  102. package/packages/omo-codex/plugin/components/comment-checker/tsconfig.build.json +12 -0
  103. package/packages/omo-codex/plugin/components/comment-checker/tsconfig.json +27 -0
  104. package/packages/omo-codex/plugin/components/comment-checker/vitest.config.ts +9 -0
  105. package/packages/omo-codex/plugin/components/lsp/.gitattributes +13 -0
  106. package/packages/omo-codex/plugin/components/lsp/.github/CODEOWNERS +1 -0
  107. package/packages/omo-codex/plugin/components/lsp/.github/ISSUE_TEMPLATE/bug.yml +26 -0
  108. package/packages/omo-codex/plugin/components/lsp/.github/ISSUE_TEMPLATE/feature.yml +19 -0
  109. package/packages/omo-codex/plugin/components/lsp/.github/branch-ruleset.json +45 -0
  110. package/packages/omo-codex/plugin/components/lsp/.github/dependabot.yml +11 -0
  111. package/packages/omo-codex/plugin/components/lsp/.github/pull_request_template.md +11 -0
  112. package/packages/omo-codex/plugin/components/lsp/.github/workflows/ci.yml +56 -0
  113. package/packages/omo-codex/plugin/components/lsp/.github/workflows/publish.yml +60 -0
  114. package/packages/omo-codex/plugin/components/lsp/.mcp.json +9 -0
  115. package/packages/omo-codex/plugin/components/lsp/AGENTS.md +25 -0
  116. package/packages/omo-codex/plugin/components/lsp/CHANGELOG.md +25 -0
  117. package/packages/omo-codex/plugin/components/lsp/LICENSE +21 -0
  118. package/packages/omo-codex/plugin/components/lsp/NOTICE +3 -0
  119. package/packages/omo-codex/plugin/components/lsp/README.md +148 -0
  120. package/packages/omo-codex/plugin/components/lsp/biome.json +48 -0
  121. package/packages/omo-codex/plugin/components/lsp/hooks/hooks.json +17 -0
  122. package/packages/omo-codex/plugin/components/lsp/package.json +64 -0
  123. package/packages/omo-codex/plugin/components/lsp/scripts/build-lsp-tools.mjs +46 -0
  124. package/packages/omo-codex/plugin/components/lsp/scripts/build-lsp-tools.test.mjs +104 -0
  125. package/packages/omo-codex/plugin/components/lsp/scripts/clean-dist.mjs +5 -0
  126. package/packages/omo-codex/plugin/components/lsp/scripts/test.mjs +8 -0
  127. package/packages/omo-codex/plugin/components/lsp/skills/lsp/SKILL.md +35 -0
  128. package/packages/omo-codex/plugin/components/lsp/src/cli.ts +44 -0
  129. package/packages/omo-codex/plugin/components/lsp/src/codex-hook.ts +285 -0
  130. package/packages/omo-codex/plugin/components/lsp/test/codex-hook.test.ts +358 -0
  131. package/packages/omo-codex/plugin/components/lsp/test/fixtures/broken.py +1 -0
  132. package/packages/omo-codex/plugin/components/lsp/test/fixtures/post-tool-use.json +15 -0
  133. package/packages/omo-codex/plugin/components/lsp/test/package-smoke.test.ts +153 -0
  134. package/packages/omo-codex/plugin/components/lsp/tsconfig.build.json +12 -0
  135. package/packages/omo-codex/plugin/components/lsp/tsconfig.json +27 -0
  136. package/packages/omo-codex/plugin/components/lsp/vitest.config.ts +9 -0
  137. package/packages/omo-codex/plugin/components/rules/.codex-plugin/plugin.json +3 -0
  138. package/packages/omo-codex/plugin/components/rules/.gitattributes +13 -0
  139. package/packages/omo-codex/plugin/components/rules/.github/CODEOWNERS +12 -0
  140. package/packages/omo-codex/plugin/components/rules/.github/ISSUE_TEMPLATE/bug.yml +49 -0
  141. package/packages/omo-codex/plugin/components/rules/.github/ISSUE_TEMPLATE/feature.yml +27 -0
  142. package/packages/omo-codex/plugin/components/rules/.github/branch-ruleset.json +45 -0
  143. package/packages/omo-codex/plugin/components/rules/.github/dependabot.yml +16 -0
  144. package/packages/omo-codex/plugin/components/rules/.github/pull_request_template.md +20 -0
  145. package/packages/omo-codex/plugin/components/rules/.github/workflows/ci.yml +47 -0
  146. package/packages/omo-codex/plugin/components/rules/.github/workflows/publish.yml +51 -0
  147. package/packages/omo-codex/plugin/components/rules/AGENTS.md +34 -0
  148. package/packages/omo-codex/plugin/components/rules/CHANGELOG.md +19 -0
  149. package/packages/omo-codex/plugin/components/rules/LICENSE +21 -0
  150. package/packages/omo-codex/plugin/components/rules/NOTICE +15 -0
  151. package/packages/omo-codex/plugin/components/rules/README.md +124 -0
  152. package/packages/omo-codex/plugin/components/rules/biome.json +48 -0
  153. package/packages/omo-codex/plugin/components/rules/bundled-rules/hephaestus.md +209 -0
  154. package/packages/omo-codex/plugin/components/rules/hooks/hooks.json +54 -0
  155. package/packages/omo-codex/plugin/components/rules/package.json +62 -0
  156. package/packages/omo-codex/plugin/components/rules/scripts/bench-codex-rules.mjs +268 -0
  157. package/packages/omo-codex/plugin/components/rules/skills/rules/SKILL.md +34 -0
  158. package/packages/omo-codex/plugin/components/rules/src/cli.ts +143 -0
  159. package/packages/omo-codex/plugin/components/rules/src/codex-hook-options.ts +4 -0
  160. package/packages/omo-codex/plugin/components/rules/src/codex-hook.ts +238 -0
  161. package/packages/omo-codex/plugin/components/rules/src/config.ts +107 -0
  162. package/packages/omo-codex/plugin/components/rules/src/context-pressure.ts +26 -0
  163. package/packages/omo-codex/plugin/components/rules/src/debug-log.ts +65 -0
  164. package/packages/omo-codex/plugin/components/rules/src/dynamic-target-fingerprints.ts +98 -0
  165. package/packages/omo-codex/plugin/components/rules/src/hook-output.ts +19 -0
  166. package/packages/omo-codex/plugin/components/rules/src/path-utils.ts +29 -0
  167. package/packages/omo-codex/plugin/components/rules/src/persistent-cache.ts +234 -0
  168. package/packages/omo-codex/plugin/components/rules/src/post-compact-budget.ts +104 -0
  169. package/packages/omo-codex/plugin/components/rules/src/post-compact-claim.ts +13 -0
  170. package/packages/omo-codex/plugin/components/rules/src/post-compact-state.ts +45 -0
  171. package/packages/omo-codex/plugin/components/rules/src/rules/cache.ts +64 -0
  172. package/packages/omo-codex/plugin/components/rules/src/rules/constants.ts +115 -0
  173. package/packages/omo-codex/plugin/components/rules/src/rules/engine.ts +535 -0
  174. package/packages/omo-codex/plugin/components/rules/src/rules/errors.ts +13 -0
  175. package/packages/omo-codex/plugin/components/rules/src/rules/finder-cache.ts +73 -0
  176. package/packages/omo-codex/plugin/components/rules/src/rules/finder-paths.ts +47 -0
  177. package/packages/omo-codex/plugin/components/rules/src/rules/finder-sources.ts +50 -0
  178. package/packages/omo-codex/plugin/components/rules/src/rules/finder.ts +207 -0
  179. package/packages/omo-codex/plugin/components/rules/src/rules/formatter.ts +123 -0
  180. package/packages/omo-codex/plugin/components/rules/src/rules/matcher.ts +142 -0
  181. package/packages/omo-codex/plugin/components/rules/src/rules/ordering.ts +33 -0
  182. package/packages/omo-codex/plugin/components/rules/src/rules/parser.ts +326 -0
  183. package/packages/omo-codex/plugin/components/rules/src/rules/plugin-root.ts +55 -0
  184. package/packages/omo-codex/plugin/components/rules/src/rules/project-root.ts +30 -0
  185. package/packages/omo-codex/plugin/components/rules/src/rules/scanner.ts +162 -0
  186. package/packages/omo-codex/plugin/components/rules/src/rules/truncator.ts +67 -0
  187. package/packages/omo-codex/plugin/components/rules/src/rules/types.ts +141 -0
  188. package/packages/omo-codex/plugin/components/rules/src/rules-engine-factory.ts +24 -0
  189. package/packages/omo-codex/plugin/components/rules/src/session-state-lock.ts +47 -0
  190. package/packages/omo-codex/plugin/components/rules/src/static-injection.ts +56 -0
  191. package/packages/omo-codex/plugin/components/rules/src/tool-paths.ts +192 -0
  192. package/packages/omo-codex/plugin/components/rules/src/transcript-rule-filter.ts +44 -0
  193. package/packages/omo-codex/plugin/components/rules/src/transcript-search.ts +108 -0
  194. package/packages/omo-codex/plugin/components/rules/test/bundled-rules-priority.test.ts +107 -0
  195. package/packages/omo-codex/plugin/components/rules/test/bundled-rules.test.ts +268 -0
  196. package/packages/omo-codex/plugin/components/rules/test/codex-hook-context-pressure.test.ts +243 -0
  197. package/packages/omo-codex/plugin/components/rules/test/codex-hook-performance.test.ts +99 -0
  198. package/packages/omo-codex/plugin/components/rules/test/codex-hook-post-compact-budget.test.ts +132 -0
  199. package/packages/omo-codex/plugin/components/rules/test/codex-hook-post-compact-context.test.ts +156 -0
  200. package/packages/omo-codex/plugin/components/rules/test/codex-hook-post-compact-dedup.test.ts +299 -0
  201. package/packages/omo-codex/plugin/components/rules/test/codex-hook-post-compact-lock.test.ts +46 -0
  202. package/packages/omo-codex/plugin/components/rules/test/codex-hook-post-compact-process.test.ts +83 -0
  203. package/packages/omo-codex/plugin/components/rules/test/codex-hook.test.ts +667 -0
  204. package/packages/omo-codex/plugin/components/rules/test/engine.test.ts +192 -0
  205. package/packages/omo-codex/plugin/components/rules/test/finder.test.ts +102 -0
  206. package/packages/omo-codex/plugin/components/rules/test/formatter.test.ts +168 -0
  207. package/packages/omo-codex/plugin/components/rules/test/hook-output.test.ts +42 -0
  208. package/packages/omo-codex/plugin/components/rules/test/matcher.test.ts +206 -0
  209. package/packages/omo-codex/plugin/components/rules/test/package-smoke.test.ts +151 -0
  210. package/packages/omo-codex/plugin/components/rules/test/persistent-cache.test.ts +63 -0
  211. package/packages/omo-codex/plugin/components/rules/test/post-compact-budget.test.ts +172 -0
  212. package/packages/omo-codex/plugin/components/rules/test/post-compact-test-fixture.ts +196 -0
  213. package/packages/omo-codex/plugin/components/rules/test/scanner.test.ts +63 -0
  214. package/packages/omo-codex/plugin/components/rules/test/tool-paths.test.ts +198 -0
  215. package/packages/omo-codex/plugin/components/rules/tsconfig.build.json +12 -0
  216. package/packages/omo-codex/plugin/components/rules/tsconfig.json +27 -0
  217. package/packages/omo-codex/plugin/components/rules/vitest.config.ts +8 -0
  218. package/packages/omo-codex/plugin/components/start-work-continuation/.gitattributes +13 -0
  219. package/packages/omo-codex/plugin/components/start-work-continuation/AGENTS.md +43 -0
  220. package/packages/omo-codex/plugin/components/start-work-continuation/CHANGELOG.md +5 -0
  221. package/packages/omo-codex/plugin/components/start-work-continuation/LICENSE +21 -0
  222. package/packages/omo-codex/plugin/components/start-work-continuation/NOTICE +5 -0
  223. package/packages/omo-codex/plugin/components/start-work-continuation/README.md +55 -0
  224. package/packages/omo-codex/plugin/components/start-work-continuation/biome.json +48 -0
  225. package/packages/omo-codex/plugin/components/start-work-continuation/directive.md +51 -0
  226. package/packages/omo-codex/plugin/components/start-work-continuation/hooks/hooks.json +28 -0
  227. package/packages/omo-codex/plugin/components/start-work-continuation/package.json +53 -0
  228. package/packages/omo-codex/plugin/components/start-work-continuation/src/boulder-reader.ts +167 -0
  229. package/packages/omo-codex/plugin/components/start-work-continuation/src/cli.ts +52 -0
  230. package/packages/omo-codex/plugin/components/start-work-continuation/src/codex-hook.ts +66 -0
  231. package/packages/omo-codex/plugin/components/start-work-continuation/src/directive.ts +6 -0
  232. package/packages/omo-codex/plugin/components/start-work-continuation/src/index.ts +5 -0
  233. package/packages/omo-codex/plugin/components/start-work-continuation/src/types.ts +23 -0
  234. package/packages/omo-codex/plugin/components/start-work-continuation/test/boulder-reader.test.ts +63 -0
  235. package/packages/omo-codex/plugin/components/start-work-continuation/test/cli.test.ts +124 -0
  236. package/packages/omo-codex/plugin/components/start-work-continuation/test/codex-hook.test.ts +160 -0
  237. package/packages/omo-codex/plugin/components/start-work-continuation/test/fixtures/boulder-completed.json +19 -0
  238. package/packages/omo-codex/plugin/components/start-work-continuation/test/fixtures/boulder-mixed-platforms.json +27 -0
  239. package/packages/omo-codex/plugin/components/start-work-continuation/test/fixtures/boulder-single-codex-work.json +19 -0
  240. package/packages/omo-codex/plugin/components/start-work-continuation/test/fixtures/plan-all-done.md +5 -0
  241. package/packages/omo-codex/plugin/components/start-work-continuation/test/fixtures/plan-with-nested-checkboxes.md +11 -0
  242. package/packages/omo-codex/plugin/components/start-work-continuation/test/fixtures/plan-with-unchecked.md +6 -0
  243. package/packages/omo-codex/plugin/components/start-work-continuation/tsconfig.build.json +12 -0
  244. package/packages/omo-codex/plugin/components/start-work-continuation/tsconfig.json +27 -0
  245. package/packages/omo-codex/plugin/components/start-work-continuation/vitest.config.ts +10 -0
  246. package/packages/omo-codex/plugin/components/telemetry/AGENTS.md +37 -0
  247. package/packages/omo-codex/plugin/components/telemetry/README.md +102 -0
  248. package/packages/omo-codex/plugin/components/telemetry/biome.json +48 -0
  249. package/packages/omo-codex/plugin/components/telemetry/hooks/hooks.json +16 -0
  250. package/packages/omo-codex/plugin/components/telemetry/package.json +56 -0
  251. package/packages/omo-codex/plugin/components/telemetry/src/atomic-write.ts +22 -0
  252. package/packages/omo-codex/plugin/components/telemetry/src/cli.ts +69 -0
  253. package/packages/omo-codex/plugin/components/telemetry/src/codex-hook.ts +49 -0
  254. package/packages/omo-codex/plugin/components/telemetry/src/data-path.ts +45 -0
  255. package/packages/omo-codex/plugin/components/telemetry/src/env-flags.ts +43 -0
  256. package/packages/omo-codex/plugin/components/telemetry/src/posthog-activity-state.ts +81 -0
  257. package/packages/omo-codex/plugin/components/telemetry/src/posthog.ts +165 -0
  258. package/packages/omo-codex/plugin/components/telemetry/src/product-identity.ts +35 -0
  259. package/packages/omo-codex/plugin/components/telemetry/test/codex-hook.test.ts +270 -0
  260. package/packages/omo-codex/plugin/components/telemetry/tsconfig.build.json +12 -0
  261. package/packages/omo-codex/plugin/components/telemetry/tsconfig.json +27 -0
  262. package/packages/omo-codex/plugin/components/telemetry/vitest.config.ts +8 -0
  263. package/packages/omo-codex/plugin/components/ultrawork/AGENTS.md +41 -0
  264. package/packages/omo-codex/plugin/components/ultrawork/CHANGELOG.md +25 -0
  265. package/packages/omo-codex/plugin/components/ultrawork/LICENSE +21 -0
  266. package/packages/omo-codex/plugin/components/ultrawork/NOTICE +5 -0
  267. package/packages/omo-codex/plugin/components/ultrawork/README.md +60 -0
  268. package/packages/omo-codex/plugin/components/ultrawork/agents/codex-ultrawork-reviewer.toml +17 -0
  269. package/packages/omo-codex/plugin/components/ultrawork/agents/explorer.toml +82 -0
  270. package/packages/omo-codex/plugin/components/ultrawork/agents/librarian.toml +221 -0
  271. package/packages/omo-codex/plugin/components/ultrawork/agents/metis.toml +65 -0
  272. package/packages/omo-codex/plugin/components/ultrawork/agents/momus.toml +69 -0
  273. package/packages/omo-codex/plugin/components/ultrawork/agents/plan.toml +163 -0
  274. package/packages/omo-codex/plugin/components/ultrawork/biome.json +48 -0
  275. package/packages/omo-codex/plugin/components/ultrawork/directive.md +264 -0
  276. package/packages/omo-codex/plugin/components/ultrawork/hooks/hooks.json +16 -0
  277. package/packages/omo-codex/plugin/components/ultrawork/package.json +54 -0
  278. package/packages/omo-codex/plugin/components/ultrawork/src/cli.ts +50 -0
  279. package/packages/omo-codex/plugin/components/ultrawork/src/codex-hook.ts +84 -0
  280. package/packages/omo-codex/plugin/components/ultrawork/src/directive.ts +3 -0
  281. package/packages/omo-codex/plugin/components/ultrawork/test/codex-hook.test.ts +252 -0
  282. package/packages/omo-codex/plugin/components/ultrawork/test/package-smoke.test.ts +78 -0
  283. package/packages/omo-codex/plugin/components/ultrawork/tsconfig.build.json +12 -0
  284. package/packages/omo-codex/plugin/components/ultrawork/tsconfig.json +27 -0
  285. package/packages/omo-codex/plugin/components/ulw-loop/.gitattributes +13 -0
  286. package/packages/omo-codex/plugin/components/ulw-loop/AGENTS.md +48 -0
  287. package/packages/omo-codex/plugin/components/ulw-loop/CHANGELOG.md +7 -0
  288. package/packages/omo-codex/plugin/components/ulw-loop/LICENSE +21 -0
  289. package/packages/omo-codex/plugin/components/ulw-loop/NOTICE +6 -0
  290. package/packages/omo-codex/plugin/components/ulw-loop/README.md +74 -0
  291. package/packages/omo-codex/plugin/components/ulw-loop/biome.json +48 -0
  292. package/packages/omo-codex/plugin/components/ulw-loop/hooks/hooks.json +29 -0
  293. package/packages/omo-codex/plugin/components/ulw-loop/package.json +55 -0
  294. package/packages/omo-codex/plugin/components/ulw-loop/skills/ulw-loop/.gitkeep +0 -0
  295. package/packages/omo-codex/plugin/components/ulw-loop/skills/ulw-loop/SKILL.md +222 -0
  296. package/packages/omo-codex/plugin/components/ulw-loop/skills/ulw-loop/agents/openai.yaml +6 -0
  297. package/packages/omo-codex/plugin/components/ulw-loop/src/.gitkeep +0 -0
  298. package/packages/omo-codex/plugin/components/ulw-loop/src/checkpoint.ts +155 -0
  299. package/packages/omo-codex/plugin/components/ulw-loop/src/cli-arg-parser.ts +95 -0
  300. package/packages/omo-codex/plugin/components/ulw-loop/src/cli-commands.ts +156 -0
  301. package/packages/omo-codex/plugin/components/ulw-loop/src/cli-output.ts +63 -0
  302. package/packages/omo-codex/plugin/components/ulw-loop/src/cli-steering.ts +94 -0
  303. package/packages/omo-codex/plugin/components/ulw-loop/src/cli.ts +40 -0
  304. package/packages/omo-codex/plugin/components/ulw-loop/src/codex-goal-instruction.ts +129 -0
  305. package/packages/omo-codex/plugin/components/ulw-loop/src/codex-goal-snapshot.ts +139 -0
  306. package/packages/omo-codex/plugin/components/ulw-loop/src/codex-hook.ts +177 -0
  307. package/packages/omo-codex/plugin/components/ulw-loop/src/evidence.ts +122 -0
  308. package/packages/omo-codex/plugin/components/ulw-loop/src/goal-status.ts +88 -0
  309. package/packages/omo-codex/plugin/components/ulw-loop/src/paths.ts +73 -0
  310. package/packages/omo-codex/plugin/components/ulw-loop/src/plan-crud.ts +113 -0
  311. package/packages/omo-codex/plugin/components/ulw-loop/src/plan-io.ts +124 -0
  312. package/packages/omo-codex/plugin/components/ulw-loop/src/quality-gate.ts +102 -0
  313. package/packages/omo-codex/plugin/components/ulw-loop/src/review-blockers.ts +81 -0
  314. package/packages/omo-codex/plugin/components/ulw-loop/src/steering.ts +270 -0
  315. package/packages/omo-codex/plugin/components/ulw-loop/src/types.ts +277 -0
  316. package/packages/omo-codex/plugin/components/ulw-loop/test/checkpoint.test.ts +213 -0
  317. package/packages/omo-codex/plugin/components/ulw-loop/test/cli-commands.test.ts +375 -0
  318. package/packages/omo-codex/plugin/components/ulw-loop/test/cli-helpers.test.ts +250 -0
  319. package/packages/omo-codex/plugin/components/ulw-loop/test/cli-steering.test.ts +407 -0
  320. package/packages/omo-codex/plugin/components/ulw-loop/test/codex-goal-instruction.test.ts +169 -0
  321. package/packages/omo-codex/plugin/components/ulw-loop/test/codex-goal-snapshot.test.ts +156 -0
  322. package/packages/omo-codex/plugin/components/ulw-loop/test/codex-hook.test.ts +275 -0
  323. package/packages/omo-codex/plugin/components/ulw-loop/test/evidence-criteria-gate.test.ts +100 -0
  324. package/packages/omo-codex/plugin/components/ulw-loop/test/evidence.test.ts +263 -0
  325. package/packages/omo-codex/plugin/components/ulw-loop/test/fixtures/.gitkeep +0 -0
  326. package/packages/omo-codex/plugin/components/ulw-loop/test/fixtures/codex-goal-snapshot.json +1 -0
  327. package/packages/omo-codex/plugin/components/ulw-loop/test/fixtures/sample-brief.md +5 -0
  328. package/packages/omo-codex/plugin/components/ulw-loop/test/fixtures/sample-plan.json +108 -0
  329. package/packages/omo-codex/plugin/components/ulw-loop/test/fixtures/sample-quality-gate.json +18 -0
  330. package/packages/omo-codex/plugin/components/ulw-loop/test/fixtures/steering-proposal.json +8 -0
  331. package/packages/omo-codex/plugin/components/ulw-loop/test/fixtures/user-prompt-submit.json +10 -0
  332. package/packages/omo-codex/plugin/components/ulw-loop/test/goal-status.test.ts +327 -0
  333. package/packages/omo-codex/plugin/components/ulw-loop/test/package-smoke.test.ts +164 -0
  334. package/packages/omo-codex/plugin/components/ulw-loop/test/paths.test.ts +62 -0
  335. package/packages/omo-codex/plugin/components/ulw-loop/test/plan-crud.test.ts +256 -0
  336. package/packages/omo-codex/plugin/components/ulw-loop/test/plan-io.test.ts +239 -0
  337. package/packages/omo-codex/plugin/components/ulw-loop/test/quality-gate.test.ts +203 -0
  338. package/packages/omo-codex/plugin/components/ulw-loop/test/review-blockers.test.ts +180 -0
  339. package/packages/omo-codex/plugin/components/ulw-loop/test/steering.test.ts +353 -0
  340. package/packages/omo-codex/plugin/components/ulw-loop/test/types.test.ts +79 -0
  341. package/packages/omo-codex/plugin/components/ulw-loop/tsconfig.build.json +12 -0
  342. package/packages/omo-codex/plugin/components/ulw-loop/tsconfig.json +27 -0
  343. package/packages/omo-codex/plugin/components/ulw-loop/vitest.config.ts +10 -0
  344. package/packages/omo-codex/plugin/hooks/hooks.json +138 -0
  345. package/packages/omo-codex/plugin/package-lock.json +1750 -0
  346. package/packages/omo-codex/plugin/package.json +26 -0
  347. package/packages/omo-codex/plugin/scripts/build-bundled-mcp-runtimes.mjs +50 -0
  348. package/packages/omo-codex/plugin/scripts/build-components.mjs +23 -0
  349. package/packages/omo-codex/plugin/scripts/hook-status-message.mjs +46 -0
  350. package/packages/omo-codex/plugin/scripts/sync-skills.mjs +75 -0
  351. package/packages/omo-codex/plugin/skills/comment-checker/SKILL.md +16 -0
  352. package/packages/omo-codex/plugin/skills/debugging/SKILL.md +116 -0
  353. package/packages/omo-codex/plugin/skills/debugging/references/methodology/00-setup.md +108 -0
  354. package/packages/omo-codex/plugin/skills/debugging/references/methodology/02-investigate.md +130 -0
  355. package/packages/omo-codex/plugin/skills/debugging/references/methodology/04-oracle-triple.md +136 -0
  356. package/packages/omo-codex/plugin/skills/debugging/references/methodology/05-escalate.md +69 -0
  357. package/packages/omo-codex/plugin/skills/debugging/references/methodology/06-fix.md +116 -0
  358. package/packages/omo-codex/plugin/skills/debugging/references/methodology/08-qa.md +94 -0
  359. package/packages/omo-codex/plugin/skills/debugging/references/methodology/09-cleanup.md +164 -0
  360. package/packages/omo-codex/plugin/skills/debugging/references/methodology/partial-runtime-evidence.md +229 -0
  361. package/packages/omo-codex/plugin/skills/debugging/references/runtimes/bundled-js-binary.md +415 -0
  362. package/packages/omo-codex/plugin/skills/debugging/references/runtimes/go.md +252 -0
  363. package/packages/omo-codex/plugin/skills/debugging/references/runtimes/native-binary.md +484 -0
  364. package/packages/omo-codex/plugin/skills/debugging/references/runtimes/node.md +260 -0
  365. package/packages/omo-codex/plugin/skills/debugging/references/runtimes/python.md +248 -0
  366. package/packages/omo-codex/plugin/skills/debugging/references/runtimes/rust.md +234 -0
  367. package/packages/omo-codex/plugin/skills/debugging/references/tools/ghidra.md +212 -0
  368. package/packages/omo-codex/plugin/skills/debugging/references/tools/playwright-cli.md +194 -0
  369. package/packages/omo-codex/plugin/skills/debugging/references/tools/pwndbg.md +263 -0
  370. package/packages/omo-codex/plugin/skills/debugging/references/tools/pwntools.md +265 -0
  371. package/packages/omo-codex/plugin/skills/frontend-ui-ux/SKILL.md +77 -0
  372. package/packages/omo-codex/plugin/skills/init-deep/SKILL.md +325 -0
  373. package/packages/omo-codex/plugin/skills/lsp/SKILL.md +35 -0
  374. package/packages/omo-codex/plugin/skills/programming/SKILL.md +463 -0
  375. package/packages/omo-codex/plugin/skills/programming/references/go/README.md +90 -0
  376. package/packages/omo-codex/plugin/skills/programming/references/go/backend-stack.md +641 -0
  377. package/packages/omo-codex/plugin/skills/programming/references/go/bootstrap.md +328 -0
  378. package/packages/omo-codex/plugin/skills/programming/references/go/bubbletea-v2.md +360 -0
  379. package/packages/omo-codex/plugin/skills/programming/references/go/cobra-stack.md +468 -0
  380. package/packages/omo-codex/plugin/skills/programming/references/go/concurrency.md +362 -0
  381. package/packages/omo-codex/plugin/skills/programming/references/go/data-modeling.md +329 -0
  382. package/packages/omo-codex/plugin/skills/programming/references/go/error-handling.md +359 -0
  383. package/packages/omo-codex/plugin/skills/programming/references/go/golangci-strict.md +236 -0
  384. package/packages/omo-codex/plugin/skills/programming/references/go/grpc-connect.md +375 -0
  385. package/packages/omo-codex/plugin/skills/programming/references/go/libraries.md +337 -0
  386. package/packages/omo-codex/plugin/skills/programming/references/go/one-liners.md +202 -0
  387. package/packages/omo-codex/plugin/skills/programming/references/go/sqlc-pgx.md +471 -0
  388. package/packages/omo-codex/plugin/skills/programming/references/go/testing.md +467 -0
  389. package/packages/omo-codex/plugin/skills/programming/references/go/type-patterns.md +298 -0
  390. package/packages/omo-codex/plugin/skills/programming/references/python/README.md +314 -0
  391. package/packages/omo-codex/plugin/skills/programming/references/python/async-anyio.md +442 -0
  392. package/packages/omo-codex/plugin/skills/programming/references/python/data-modeling.md +233 -0
  393. package/packages/omo-codex/plugin/skills/programming/references/python/data-processing.md +133 -0
  394. package/packages/omo-codex/plugin/skills/programming/references/python/error-handling.md +218 -0
  395. package/packages/omo-codex/plugin/skills/programming/references/python/fastapi-stack.md +316 -0
  396. package/packages/omo-codex/plugin/skills/programming/references/python/httpx2-optimization.md +360 -0
  397. package/packages/omo-codex/plugin/skills/programming/references/python/libraries.md +307 -0
  398. package/packages/omo-codex/plugin/skills/programming/references/python/one-liners.md +268 -0
  399. package/packages/omo-codex/plugin/skills/programming/references/python/orjson-stack.md +378 -0
  400. package/packages/omo-codex/plugin/skills/programming/references/python/pydantic-ai.md +285 -0
  401. package/packages/omo-codex/plugin/skills/programming/references/python/pyproject-strict.md +232 -0
  402. package/packages/omo-codex/plugin/skills/programming/references/python/textual-tui.md +201 -0
  403. package/packages/omo-codex/plugin/skills/programming/references/python/type-patterns.md +176 -0
  404. package/packages/omo-codex/plugin/skills/programming/references/rust/README.md +317 -0
  405. package/packages/omo-codex/plugin/skills/programming/references/rust/async-tokio.md +299 -0
  406. package/packages/omo-codex/plugin/skills/programming/references/rust/axum-stack.md +467 -0
  407. package/packages/omo-codex/plugin/skills/programming/references/rust/cargo-strict.md +317 -0
  408. package/packages/omo-codex/plugin/skills/programming/references/rust/clap-stack.md +409 -0
  409. package/packages/omo-codex/plugin/skills/programming/references/rust/concurrency.md +375 -0
  410. package/packages/omo-codex/plugin/skills/programming/references/rust/libraries.md +439 -0
  411. package/packages/omo-codex/plugin/skills/programming/references/rust/one-liners.md +291 -0
  412. package/packages/omo-codex/plugin/skills/programming/references/rust/proptest-insta.md +429 -0
  413. package/packages/omo-codex/plugin/skills/programming/references/rust/type-state.md +354 -0
  414. package/packages/omo-codex/plugin/skills/programming/references/rust/unsafe-discipline.md +250 -0
  415. package/packages/omo-codex/plugin/skills/programming/references/rust/zero-cost-safety.md +527 -0
  416. package/packages/omo-codex/plugin/skills/programming/references/rust-ub/README.md +289 -0
  417. package/packages/omo-codex/plugin/skills/programming/references/rust-ub/miri-sanitizers-loom.md +411 -0
  418. package/packages/omo-codex/plugin/skills/programming/references/rust-ub/ub-taxonomy.md +269 -0
  419. package/packages/omo-codex/plugin/skills/programming/references/typescript/README.md +195 -0
  420. package/packages/omo-codex/plugin/skills/programming/references/typescript/backend-hono.md +672 -0
  421. package/packages/omo-codex/plugin/skills/programming/references/typescript/bootstrap.md +199 -0
  422. package/packages/omo-codex/plugin/skills/programming/references/typescript/data-modeling.md +202 -0
  423. package/packages/omo-codex/plugin/skills/programming/references/typescript/error-handling.md +169 -0
  424. package/packages/omo-codex/plugin/skills/programming/references/typescript/tsconfig-strict.md +152 -0
  425. package/packages/omo-codex/plugin/skills/programming/references/typescript/type-patterns.md +196 -0
  426. package/packages/omo-codex/plugin/skills/programming/scripts/go/check-no-excuse-rules.sh +173 -0
  427. package/packages/omo-codex/plugin/skills/programming/scripts/go/new-project.py +138 -0
  428. package/packages/omo-codex/plugin/skills/programming/scripts/go/templates/.editorconfig +13 -0
  429. package/packages/omo-codex/plugin/skills/programming/scripts/go/templates/.golangci.yml +95 -0
  430. package/packages/omo-codex/plugin/skills/programming/scripts/go/templates/AGENTS.md.tmpl +24 -0
  431. package/packages/omo-codex/plugin/skills/programming/scripts/go/templates/README.md.tmpl +12 -0
  432. package/packages/omo-codex/plugin/skills/programming/scripts/go/templates/Taskfile.yml +40 -0
  433. package/packages/omo-codex/plugin/skills/programming/scripts/go/templates/ci.yml +37 -0
  434. package/packages/omo-codex/plugin/skills/programming/scripts/go/templates/config.go +24 -0
  435. package/packages/omo-codex/plugin/skills/programming/scripts/go/templates/gitignore +15 -0
  436. package/packages/omo-codex/plugin/skills/programming/scripts/go/templates/main.go.tmpl +22 -0
  437. package/packages/omo-codex/plugin/skills/programming/scripts/go/templates/run.go +15 -0
  438. package/packages/omo-codex/plugin/skills/programming/scripts/python/check-no-excuse-rules.py +687 -0
  439. package/packages/omo-codex/plugin/skills/programming/scripts/python/new-project.py +172 -0
  440. package/packages/omo-codex/plugin/skills/programming/scripts/python/new-script.py +116 -0
  441. package/packages/omo-codex/plugin/skills/programming/scripts/rust/check-no-excuse-rules.py +296 -0
  442. package/packages/omo-codex/plugin/skills/programming/scripts/rust/check-no-excuse-rules.sh +158 -0
  443. package/packages/omo-codex/plugin/skills/programming/scripts/rust/new-project.py +175 -0
  444. package/packages/omo-codex/plugin/skills/programming/scripts/typescript/check-no-excuse-rules.ts +282 -0
  445. package/packages/omo-codex/plugin/skills/programming/scripts/typescript/new-project.ts +177 -0
  446. package/packages/omo-codex/plugin/skills/refactor/SKILL.md +779 -0
  447. package/packages/omo-codex/plugin/skills/remove-ai-slops/SKILL.md +333 -0
  448. package/packages/omo-codex/plugin/skills/review-work/SKILL.md +549 -0
  449. package/packages/omo-codex/plugin/skills/rules/SKILL.md +34 -0
  450. package/packages/omo-codex/plugin/skills/start-work/SKILL.md +129 -0
  451. package/packages/omo-codex/plugin/skills/ulw-loop/.gitkeep +0 -0
  452. package/packages/omo-codex/plugin/skills/ulw-loop/SKILL.md +222 -0
  453. package/packages/omo-codex/plugin/skills/ulw-loop/agents/openai.yaml +6 -0
  454. package/packages/omo-codex/plugin/skills/ulw-plan/SKILL.md +399 -0
  455. package/packages/omo-codex/plugin/test/aggregate.test.mjs +330 -0
  456. package/packages/omo-codex/plugin/test/component-bin-names.test.mjs +66 -0
  457. package/packages/omo-codex/plugin/test/hook-status-message.test.mjs +150 -0
  458. package/packages/omo-codex/plugin/test/sync-skills.test.mjs +199 -0
  459. package/packages/omo-codex/scripts/install/agents.mjs +84 -0
  460. package/packages/omo-codex/scripts/install/cache.mjs +245 -0
  461. package/packages/omo-codex/scripts/install/command-shim.mjs +1 -0
  462. package/packages/omo-codex/scripts/install/config.mjs +229 -0
  463. package/packages/omo-codex/scripts/install/hook-trust.mjs +84 -0
  464. package/packages/omo-codex/scripts/install/legacy-bins.mjs +57 -0
  465. package/packages/omo-codex/scripts/install/marketplace.mjs +104 -0
  466. package/packages/omo-codex/scripts/install/mcp-runtime-cache.mjs +77 -0
  467. package/packages/omo-codex/scripts/install/multi-agent-v2-config.mjs +32 -0
  468. package/packages/omo-codex/scripts/install/process.mjs +19 -0
  469. package/packages/omo-codex/scripts/install/snapshot.mjs +54 -0
  470. package/packages/omo-codex/scripts/install/toml-editor.mjs +47 -0
  471. package/packages/omo-codex/scripts/install/utils.mjs +15 -0
  472. package/packages/omo-codex/scripts/install-agent-links.test.mjs +104 -0
  473. package/packages/omo-codex/scripts/install-bin-links.test.mjs +123 -0
  474. package/packages/omo-codex/scripts/install-cache-copy.test.mjs +30 -0
  475. package/packages/omo-codex/scripts/install-config.test.mjs +118 -0
  476. package/packages/omo-codex/scripts/install-local.mjs +192 -0
  477. package/packages/omo-codex/scripts/install-local.test.mjs +379 -0
  478. package/packages/omo-codex/scripts/install-mcp-runtime.test.mjs +173 -0
  479. package/packages/omo-codex/scripts/install-test-fixtures.mjs +58 -0
  480. package/packages/omo-codex/scripts/sync-telemetry-component.mjs +115 -0
  481. package/packages/omo-codex/scripts/sync-telemetry-component.test.mjs +94 -0
  482. package/packages/shared-skills/index.mjs +5 -0
  483. package/packages/shared-skills/package.json +14 -0
  484. package/packages/shared-skills/skills/debugging/SKILL.md +116 -0
  485. package/packages/shared-skills/skills/debugging/references/methodology/00-setup.md +108 -0
  486. package/packages/shared-skills/skills/debugging/references/methodology/02-investigate.md +130 -0
  487. package/packages/shared-skills/skills/debugging/references/methodology/04-oracle-triple.md +136 -0
  488. package/packages/shared-skills/skills/debugging/references/methodology/05-escalate.md +69 -0
  489. package/packages/shared-skills/skills/debugging/references/methodology/06-fix.md +116 -0
  490. package/packages/shared-skills/skills/debugging/references/methodology/08-qa.md +94 -0
  491. package/packages/shared-skills/skills/debugging/references/methodology/09-cleanup.md +164 -0
  492. package/packages/shared-skills/skills/debugging/references/methodology/partial-runtime-evidence.md +229 -0
  493. package/packages/shared-skills/skills/debugging/references/runtimes/bundled-js-binary.md +415 -0
  494. package/packages/shared-skills/skills/debugging/references/runtimes/go.md +252 -0
  495. package/packages/shared-skills/skills/debugging/references/runtimes/native-binary.md +484 -0
  496. package/packages/shared-skills/skills/debugging/references/runtimes/node.md +260 -0
  497. package/packages/shared-skills/skills/debugging/references/runtimes/python.md +248 -0
  498. package/packages/shared-skills/skills/debugging/references/runtimes/rust.md +234 -0
  499. package/packages/shared-skills/skills/debugging/references/tools/ghidra.md +212 -0
  500. package/packages/shared-skills/skills/debugging/references/tools/playwright-cli.md +194 -0
  501. package/packages/shared-skills/skills/debugging/references/tools/pwndbg.md +263 -0
  502. package/packages/shared-skills/skills/debugging/references/tools/pwntools.md +265 -0
  503. package/packages/shared-skills/skills/frontend-ui-ux/SKILL.md +77 -0
  504. package/packages/shared-skills/skills/init-deep/SKILL.md +309 -0
  505. package/packages/shared-skills/skills/programming/SKILL.md +463 -0
  506. package/packages/shared-skills/skills/programming/references/go/README.md +90 -0
  507. package/packages/shared-skills/skills/programming/references/go/backend-stack.md +641 -0
  508. package/packages/shared-skills/skills/programming/references/go/bootstrap.md +328 -0
  509. package/packages/shared-skills/skills/programming/references/go/bubbletea-v2.md +360 -0
  510. package/packages/shared-skills/skills/programming/references/go/cobra-stack.md +468 -0
  511. package/packages/shared-skills/skills/programming/references/go/concurrency.md +362 -0
  512. package/packages/shared-skills/skills/programming/references/go/data-modeling.md +329 -0
  513. package/packages/shared-skills/skills/programming/references/go/error-handling.md +359 -0
  514. package/packages/shared-skills/skills/programming/references/go/golangci-strict.md +236 -0
  515. package/packages/shared-skills/skills/programming/references/go/grpc-connect.md +375 -0
  516. package/packages/shared-skills/skills/programming/references/go/libraries.md +337 -0
  517. package/packages/shared-skills/skills/programming/references/go/one-liners.md +202 -0
  518. package/packages/shared-skills/skills/programming/references/go/sqlc-pgx.md +471 -0
  519. package/packages/shared-skills/skills/programming/references/go/testing.md +467 -0
  520. package/packages/shared-skills/skills/programming/references/go/type-patterns.md +298 -0
  521. package/packages/shared-skills/skills/programming/references/python/README.md +314 -0
  522. package/packages/shared-skills/skills/programming/references/python/async-anyio.md +442 -0
  523. package/packages/shared-skills/skills/programming/references/python/data-modeling.md +233 -0
  524. package/packages/shared-skills/skills/programming/references/python/data-processing.md +133 -0
  525. package/packages/shared-skills/skills/programming/references/python/error-handling.md +218 -0
  526. package/packages/shared-skills/skills/programming/references/python/fastapi-stack.md +316 -0
  527. package/packages/shared-skills/skills/programming/references/python/httpx2-optimization.md +360 -0
  528. package/packages/shared-skills/skills/programming/references/python/libraries.md +307 -0
  529. package/packages/shared-skills/skills/programming/references/python/one-liners.md +268 -0
  530. package/packages/shared-skills/skills/programming/references/python/orjson-stack.md +378 -0
  531. package/packages/shared-skills/skills/programming/references/python/pydantic-ai.md +285 -0
  532. package/packages/shared-skills/skills/programming/references/python/pyproject-strict.md +232 -0
  533. package/packages/shared-skills/skills/programming/references/python/textual-tui.md +201 -0
  534. package/packages/shared-skills/skills/programming/references/python/type-patterns.md +176 -0
  535. package/packages/shared-skills/skills/programming/references/rust/README.md +317 -0
  536. package/packages/shared-skills/skills/programming/references/rust/async-tokio.md +299 -0
  537. package/packages/shared-skills/skills/programming/references/rust/axum-stack.md +467 -0
  538. package/packages/shared-skills/skills/programming/references/rust/cargo-strict.md +317 -0
  539. package/packages/shared-skills/skills/programming/references/rust/clap-stack.md +409 -0
  540. package/packages/shared-skills/skills/programming/references/rust/concurrency.md +375 -0
  541. package/packages/shared-skills/skills/programming/references/rust/libraries.md +439 -0
  542. package/packages/shared-skills/skills/programming/references/rust/one-liners.md +291 -0
  543. package/packages/shared-skills/skills/programming/references/rust/proptest-insta.md +429 -0
  544. package/packages/shared-skills/skills/programming/references/rust/type-state.md +354 -0
  545. package/packages/shared-skills/skills/programming/references/rust/unsafe-discipline.md +250 -0
  546. package/packages/shared-skills/skills/programming/references/rust/zero-cost-safety.md +527 -0
  547. package/packages/shared-skills/skills/programming/references/rust-ub/README.md +289 -0
  548. package/packages/shared-skills/skills/programming/references/rust-ub/miri-sanitizers-loom.md +411 -0
  549. package/packages/shared-skills/skills/programming/references/rust-ub/ub-taxonomy.md +269 -0
  550. package/packages/shared-skills/skills/programming/references/typescript/README.md +195 -0
  551. package/packages/shared-skills/skills/programming/references/typescript/backend-hono.md +672 -0
  552. package/packages/shared-skills/skills/programming/references/typescript/bootstrap.md +199 -0
  553. package/packages/shared-skills/skills/programming/references/typescript/data-modeling.md +202 -0
  554. package/packages/shared-skills/skills/programming/references/typescript/error-handling.md +169 -0
  555. package/packages/shared-skills/skills/programming/references/typescript/tsconfig-strict.md +152 -0
  556. package/packages/shared-skills/skills/programming/references/typescript/type-patterns.md +196 -0
  557. package/packages/shared-skills/skills/programming/scripts/go/check-no-excuse-rules.sh +173 -0
  558. package/packages/shared-skills/skills/programming/scripts/go/new-project.py +138 -0
  559. package/packages/shared-skills/skills/programming/scripts/go/templates/.editorconfig +13 -0
  560. package/packages/shared-skills/skills/programming/scripts/go/templates/.golangci.yml +95 -0
  561. package/packages/shared-skills/skills/programming/scripts/go/templates/AGENTS.md.tmpl +24 -0
  562. package/packages/shared-skills/skills/programming/scripts/go/templates/README.md.tmpl +12 -0
  563. package/packages/shared-skills/skills/programming/scripts/go/templates/Taskfile.yml +40 -0
  564. package/packages/shared-skills/skills/programming/scripts/go/templates/ci.yml +37 -0
  565. package/packages/shared-skills/skills/programming/scripts/go/templates/config.go +24 -0
  566. package/packages/shared-skills/skills/programming/scripts/go/templates/gitignore +15 -0
  567. package/packages/shared-skills/skills/programming/scripts/go/templates/main.go.tmpl +22 -0
  568. package/packages/shared-skills/skills/programming/scripts/go/templates/run.go +15 -0
  569. package/packages/shared-skills/skills/programming/scripts/python/check-no-excuse-rules.py +687 -0
  570. package/packages/shared-skills/skills/programming/scripts/python/new-project.py +172 -0
  571. package/packages/shared-skills/skills/programming/scripts/python/new-script.py +116 -0
  572. package/packages/shared-skills/skills/programming/scripts/rust/check-no-excuse-rules.py +296 -0
  573. package/packages/shared-skills/skills/programming/scripts/rust/check-no-excuse-rules.sh +158 -0
  574. package/packages/shared-skills/skills/programming/scripts/rust/new-project.py +175 -0
  575. package/packages/shared-skills/skills/programming/scripts/typescript/check-no-excuse-rules.ts +282 -0
  576. package/packages/shared-skills/skills/programming/scripts/typescript/new-project.ts +177 -0
  577. package/packages/shared-skills/skills/refactor/SKILL.md +763 -0
  578. package/packages/shared-skills/skills/remove-ai-slops/SKILL.md +317 -0
  579. package/packages/shared-skills/skills/review-work/SKILL.md +549 -0
  580. package/packages/shared-skills/skills/start-work/SKILL.md +129 -0
  581. package/packages/shared-skills/skills/ulw-plan/SKILL.md +383 -0
  582. package/postinstall.mjs +6 -2
  583. package/dist/features/builtin-commands/templates/init-deep.d.ts +0 -1
  584. package/dist/features/builtin-skills/skills/ai-slop-remover.d.ts +0 -2
@@ -0,0 +1,107 @@
1
+ import { SOURCE_PRIORITY } from "./rules/constants.js";
2
+ import { defaultConfig } from "./rules/engine.js";
3
+ import type { PiRulesConfig, RuleSource } from "./rules/types.js";
4
+
5
+ export function configFromEnvironment(env: NodeJS.ProcessEnv = process.env): PiRulesConfig {
6
+ const config = defaultConfig();
7
+ const disableBundledRules = isTruthy(firstEnv(env, "CODEX_RULES_DISABLE_BUNDLED", "PI_RULES_DISABLE_BUNDLED"));
8
+ config.disabled = isTruthy(firstEnv(env, "CODEX_RULES_DISABLED", "PI_RULES_DISABLED"));
9
+ config.mode = parseMode(firstEnv(env, "CODEX_RULES_MODE", "PI_RULES_MODE")) ?? config.mode;
10
+ config.maxRuleChars =
11
+ parsePositiveInteger(firstEnv(env, "CODEX_RULES_MAX_RULE_CHARS", "PI_RULES_MAX_RULE_CHARS")) ??
12
+ config.maxRuleChars;
13
+ config.maxResultChars =
14
+ parsePositiveInteger(firstEnv(env, "CODEX_RULES_MAX_RESULT_CHARS", "PI_RULES_MAX_RESULT_CHARS")) ??
15
+ config.maxResultChars;
16
+ config.postCompactMaxRuleChars =
17
+ parsePositiveInteger(
18
+ firstEnv(env, "CODEX_RULES_POST_COMPACT_MAX_RULE_CHARS", "PI_RULES_POST_COMPACT_MAX_RULE_CHARS"),
19
+ ) ?? config.postCompactMaxRuleChars;
20
+ config.postCompactMaxResultChars =
21
+ parsePositiveInteger(
22
+ firstEnv(env, "CODEX_RULES_POST_COMPACT_MAX_RESULT_CHARS", "PI_RULES_POST_COMPACT_MAX_RESULT_CHARS"),
23
+ ) ?? config.postCompactMaxResultChars;
24
+ config.enabledSources = parseEnabledSources(
25
+ firstEnv(env, "CODEX_RULES_ENABLED_SOURCES", "PI_RULES_ENABLED_SOURCES"),
26
+ disableBundledRules,
27
+ );
28
+ return config;
29
+ }
30
+
31
+ function firstEnv(env: NodeJS.ProcessEnv, ...names: string[]): string | undefined {
32
+ for (const name of names) {
33
+ const value = env[name];
34
+ if (typeof value === "string" && value.trim().length > 0) {
35
+ return value;
36
+ }
37
+ }
38
+ return undefined;
39
+ }
40
+
41
+ function isTruthy(value: string | undefined): boolean {
42
+ if (value === undefined) return false;
43
+ return ["1", "true", "yes", "on"].includes(value.trim().toLowerCase());
44
+ }
45
+
46
+ function parseMode(value: string | undefined): PiRulesConfig["mode"] | undefined {
47
+ if (value === undefined) return undefined;
48
+ const normalized = value.trim().toLowerCase();
49
+ switch (normalized) {
50
+ case "static":
51
+ case "dynamic":
52
+ case "both":
53
+ case "off":
54
+ return normalized;
55
+ default:
56
+ return undefined;
57
+ }
58
+ }
59
+
60
+ function parsePositiveInteger(value: string | undefined): number | undefined {
61
+ if (value === undefined) return undefined;
62
+ const parsed = Number.parseInt(value.trim(), 10);
63
+ return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : undefined;
64
+ }
65
+
66
+ function parseEnabledSources(value: string | undefined, disableBundledRules: boolean): RuleSource[] | "auto" {
67
+ if (value === undefined || value.trim().toLowerCase() === "auto") {
68
+ return disableBundledRules ? sourcesWithoutBundledRules() : "auto";
69
+ }
70
+
71
+ const sources: RuleSource[] = [];
72
+ for (const rawSource of value.split(",")) {
73
+ const source = toRuleSource(rawSource.trim());
74
+ if (source === null) {
75
+ continue;
76
+ }
77
+ sources.push(source);
78
+ }
79
+ const enabledSources = disableBundledRules ? sources.filter((source) => source !== "plugin-bundled") : sources;
80
+ return enabledSources.length > 0 || sources.length > 0 ? enabledSources : "auto";
81
+ }
82
+
83
+ function sourcesWithoutBundledRules(): RuleSource[] {
84
+ return [...SOURCE_PRIORITY.keys()].filter((source) => source !== "plugin-bundled");
85
+ }
86
+
87
+ function toRuleSource(value: string): RuleSource | null {
88
+ switch (value) {
89
+ case ".omo/rules":
90
+ case ".claude/rules":
91
+ case ".cursor/rules":
92
+ case ".github/instructions":
93
+ case ".github/copilot-instructions.md":
94
+ case "AGENTS.md":
95
+ case "CLAUDE.md":
96
+ case "CONTEXT.md":
97
+ case "plugin-bundled":
98
+ case "~/.omo/rules":
99
+ case "~/.opencode/rules":
100
+ case "~/.claude/rules":
101
+ case "~/.config/opencode/AGENTS.md":
102
+ case "~/.claude/CLAUDE.md":
103
+ return value;
104
+ default:
105
+ return null;
106
+ }
107
+ }
@@ -0,0 +1,26 @@
1
+ import { readFileSync } from "node:fs";
2
+
3
+ const CONTEXT_PRESSURE_MARKERS = [
4
+ "context compacted",
5
+ "context_length_exceeded",
6
+ "skill descriptions were shortened",
7
+ "context_too_large",
8
+ "codex ran out of room in the model's context window",
9
+ "your input exceeds the context window",
10
+ "long threads and multiple compactions",
11
+ ] as const;
12
+
13
+ export function hasContextPressureMarker(text: string): boolean {
14
+ const normalizedText = text.toLowerCase();
15
+ return CONTEXT_PRESSURE_MARKERS.some((marker) => normalizedText.includes(marker));
16
+ }
17
+
18
+ export function transcriptHasContextPressureMarker(transcriptPath: string | null | undefined): boolean {
19
+ if (transcriptPath === undefined || transcriptPath === null) return false;
20
+ try {
21
+ return hasContextPressureMarker(readFileSync(transcriptPath, "utf8"));
22
+ } catch (error) {
23
+ if (error instanceof Error) return false;
24
+ throw error;
25
+ }
26
+ }
@@ -0,0 +1,65 @@
1
+ import { performance } from "node:perf_hooks";
2
+ import { debuglog } from "node:util";
3
+
4
+ type DebugFieldValue = boolean | number | string | null;
5
+
6
+ type DebugFields = Record<string, DebugFieldValue>;
7
+
8
+ const debug = debuglog("codex-rules");
9
+ const noopTimer: HookDebugTimer = {
10
+ lap: () => {},
11
+ done: () => {},
12
+ };
13
+
14
+ export interface HookDebugTimer {
15
+ lap(phase: string, fields?: DebugFields): void;
16
+ done(fields?: DebugFields): void;
17
+ }
18
+
19
+ export function createHookDebugTimer(hookName: string): HookDebugTimer {
20
+ if (!debug.enabled) {
21
+ return noopTimer;
22
+ }
23
+
24
+ const startMs = performance.now();
25
+ let lastMs = startMs;
26
+
27
+ return {
28
+ lap: (phase, fields = {}) => {
29
+ const nowMs = performance.now();
30
+ writeDebugLine(hookName, phase, nowMs - lastMs, nowMs - startMs, fields);
31
+ lastMs = nowMs;
32
+ },
33
+ done: (fields = {}) => {
34
+ const nowMs = performance.now();
35
+ writeDebugLine(hookName, "done", nowMs - lastMs, nowMs - startMs, fields);
36
+ lastMs = nowMs;
37
+ },
38
+ };
39
+ }
40
+
41
+ function writeDebugLine(
42
+ hookName: string,
43
+ phase: string,
44
+ durationMs: number,
45
+ totalMs: number,
46
+ fields: DebugFields,
47
+ ): void {
48
+ debug(
49
+ "%s phase=%s ms=%s total_ms=%s%s",
50
+ hookName,
51
+ phase,
52
+ durationMs.toFixed(3),
53
+ totalMs.toFixed(3),
54
+ formatFields(fields),
55
+ );
56
+ }
57
+
58
+ function formatFields(fields: DebugFields): string {
59
+ const entries = Object.entries(fields);
60
+ if (entries.length === 0) {
61
+ return "";
62
+ }
63
+
64
+ return ` ${entries.map(([key, value]) => `${key}=${String(value)}`).join(" ")}`;
65
+ }
@@ -0,0 +1,98 @@
1
+ import { statSync } from "node:fs";
2
+ import { resolve } from "node:path";
3
+ import { isSameOrChildPath, toPosixPath, uniqueStrings } from "./path-utils.js";
4
+ import { SOURCE_PRIORITY } from "./rules/constants.js";
5
+ import { createRuleDiscoveryCache, findRuleCandidates } from "./rules/finder.js";
6
+ import { hashContent } from "./rules/matcher.js";
7
+ import { sortCandidates } from "./rules/ordering.js";
8
+ import { findProjectRoot } from "./rules/project-root.js";
9
+ import type { PiRulesConfig, RuleCandidate } from "./rules/types.js";
10
+
11
+ export interface DynamicTargetFingerprint {
12
+ targetPath: string;
13
+ cacheKey: string;
14
+ fingerprint: string;
15
+ }
16
+
17
+ export function fingerprintDynamicTargets(
18
+ cwd: string,
19
+ targetPaths: ReadonlyArray<string>,
20
+ config: PiRulesConfig,
21
+ ): DynamicTargetFingerprint[] {
22
+ const disabledSources = disabledSourcesFor(config);
23
+ const discoveryCache = createRuleDiscoveryCache();
24
+ const cwdProjectRoot = findProjectRoot(cwd);
25
+ const fingerprints: DynamicTargetFingerprint[] = [];
26
+
27
+ for (const targetPath of uniqueStrings(targetPaths)) {
28
+ const projectRoot =
29
+ cwdProjectRoot !== null && isSameOrChildPath(targetPath, cwdProjectRoot)
30
+ ? cwdProjectRoot
31
+ : findProjectRoot(targetPath);
32
+ const findOptions: {
33
+ projectRoot: string | null;
34
+ targetFile: string;
35
+ disabledSources?: ReadonlySet<string>;
36
+ cache: ReturnType<typeof createRuleDiscoveryCache>;
37
+ } = {
38
+ projectRoot,
39
+ targetFile: targetPath,
40
+ cache: discoveryCache,
41
+ };
42
+ if (disabledSources !== undefined) {
43
+ findOptions.disabledSources = disabledSources;
44
+ }
45
+ const candidates = findRuleCandidates(findOptions);
46
+ const candidateFingerprint = sortCandidates(candidates).map(fingerprintCandidate).join("\u0001");
47
+ const cacheKey = dynamicTargetCacheKey(targetPath);
48
+ fingerprints.push({
49
+ targetPath,
50
+ cacheKey,
51
+ fingerprint: hashContent(
52
+ [
53
+ "v1",
54
+ config.enabledSources === "auto" ? "auto" : config.enabledSources.join(","),
55
+ projectRoot ?? "",
56
+ cacheKey,
57
+ candidateFingerprint,
58
+ ].join("\u0000"),
59
+ ),
60
+ });
61
+ }
62
+
63
+ return fingerprints;
64
+ }
65
+
66
+ function fingerprintCandidate(candidate: RuleCandidate): string {
67
+ return [
68
+ candidate.realPath,
69
+ candidate.relativePath,
70
+ candidate.source,
71
+ candidate.isGlobal ? "global" : "project",
72
+ candidate.isSingleFile ? "single" : "multi",
73
+ String(candidate.distance),
74
+ fileFingerprint(candidate.path),
75
+ ].join("\u0000");
76
+ }
77
+
78
+ function fileFingerprint(filePath: string): string {
79
+ try {
80
+ const stats = statSync(filePath, { bigint: true });
81
+ return `${stats.mtimeNs}:${stats.ctimeNs}:${stats.size}`;
82
+ } catch {
83
+ return "missing";
84
+ }
85
+ }
86
+
87
+ function disabledSourcesFor(config: PiRulesConfig): ReadonlySet<string> | undefined {
88
+ if (config.enabledSources === "auto") {
89
+ return undefined;
90
+ }
91
+
92
+ const enabledSources = new Set(config.enabledSources);
93
+ return new Set([...SOURCE_PRIORITY.keys()].filter((source) => !enabledSources.has(source)));
94
+ }
95
+
96
+ function dynamicTargetCacheKey(targetPath: string): string {
97
+ return toPosixPath(resolve(targetPath));
98
+ }
@@ -0,0 +1,19 @@
1
+ export type ContextInjectionHookEventName = "SessionStart" | "UserPromptSubmit" | "PostToolUse";
2
+
3
+ export function formatAdditionalContextOutput(
4
+ eventName: ContextInjectionHookEventName,
5
+ additionalContext: string,
6
+ ): string {
7
+ const normalizedContext = normalizeAdditionalContext(additionalContext);
8
+ if (normalizedContext.length === 0) return "";
9
+ return `${JSON.stringify({
10
+ hookSpecificOutput: {
11
+ hookEventName: eventName,
12
+ additionalContext: normalizedContext,
13
+ },
14
+ })}\n`;
15
+ }
16
+
17
+ function normalizeAdditionalContext(additionalContext: string): string {
18
+ return additionalContext.replace(/\r\n/g, "\n").replace(/\r/g, "\n").trim();
19
+ }
@@ -0,0 +1,29 @@
1
+ import { isAbsolute, relative, resolve } from "node:path";
2
+
3
+ export function displayPath(cwd: string, filePath: string): string {
4
+ const rel = isAbsolute(filePath) ? relative(cwd, filePath) : filePath;
5
+ return toPosixPath(rel);
6
+ }
7
+
8
+ export function isSameOrChildPath(childPath: string, parentPath: string): boolean {
9
+ const childRelativePath = relative(parentPath, resolve(childPath));
10
+ return childRelativePath === "" || (!childRelativePath.startsWith("..") && !isAbsolute(childRelativePath));
11
+ }
12
+
13
+ export function toPosixPath(path: string): string {
14
+ return path.replaceAll("\\", "/");
15
+ }
16
+
17
+ export function uniqueStrings(values: ReadonlyArray<string>): string[] {
18
+ const uniqueValues: string[] = [];
19
+ const seenValues = new Set<string>();
20
+ for (const value of values) {
21
+ if (seenValues.has(value)) {
22
+ continue;
23
+ }
24
+
25
+ seenValues.add(value);
26
+ uniqueValues.push(value);
27
+ }
28
+ return uniqueValues;
29
+ }
@@ -0,0 +1,234 @@
1
+ import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
2
+ import { homedir } from "node:os";
3
+ import { dirname, join } from "node:path";
4
+
5
+ import {
6
+ type PostCompactPendingKind,
7
+ type PostCompactPendingState,
8
+ postCompactKindState,
9
+ postCompactPendingKinds,
10
+ postCompactRecoveringKinds,
11
+ } from "./post-compact-state.js";
12
+ import type { Engine } from "./rules/engine.js";
13
+ import { SESSION_STATE_LOCK_CONTENDED, withSessionStateLock } from "./session-state-lock.js";
14
+
15
+ export type PostCompactClaimResult = "claimed" | "not-pending" | "contended";
16
+
17
+ interface SerializedSessionState {
18
+ staticDedup: string[];
19
+ dynamicDedup: Record<string, string[]>;
20
+ dynamicTargetFingerprints?: Record<string, string>;
21
+ postCompactPending?: PostCompactPendingState;
22
+ postCompactRecovering?: PostCompactPendingState;
23
+ compacted?: boolean;
24
+ }
25
+
26
+ export function hydrateEngineState(engine: Engine, cachePath: string): void {
27
+ const state = readSessionState(cachePath);
28
+ engine.state.staticDedup.clear();
29
+ engine.state.dynamicDedup.clear();
30
+ engine.state.dynamicTargetFingerprints.clear();
31
+
32
+ for (const key of state.staticDedup) {
33
+ engine.state.staticDedup.add(key);
34
+ }
35
+ for (const [scope, keys] of Object.entries(state.dynamicDedup)) {
36
+ engine.state.dynamicDedup.set(scope, new Set(keys));
37
+ }
38
+ for (const [targetKey, fingerprint] of Object.entries(state.dynamicTargetFingerprints ?? {})) {
39
+ engine.state.dynamicTargetFingerprints.set(targetKey, fingerprint);
40
+ }
41
+ }
42
+
43
+ export function persistEngineState(
44
+ engine: Engine,
45
+ cachePath: string,
46
+ completedPostCompactKind?: PostCompactPendingKind,
47
+ ): void {
48
+ const currentState = readSessionState(cachePath);
49
+ const dynamicDedup: Record<string, string[]> = {};
50
+ for (const [scope, keys] of engine.state.dynamicDedup.entries()) {
51
+ dynamicDedup[scope] = [...keys];
52
+ }
53
+
54
+ const postCompactPending = nextPostCompactPending(currentState, completedPostCompactKind);
55
+ const postCompactRecovering = nextPostCompactRecovering(currentState, completedPostCompactKind);
56
+ writeSessionState(cachePath, {
57
+ staticDedup: [...engine.state.staticDedup],
58
+ dynamicDedup,
59
+ dynamicTargetFingerprints: Object.fromEntries(engine.state.dynamicTargetFingerprints.entries()),
60
+ ...(postCompactPending === undefined ? {} : { postCompactPending }),
61
+ ...(postCompactRecovering === undefined ? {} : { postCompactRecovering }),
62
+ });
63
+ }
64
+
65
+ export function clearSessionState(cachePath: string): void {
66
+ rmSync(cachePath, { force: true });
67
+ }
68
+
69
+ export function markSessionCompacted(cachePath: string): void {
70
+ const state = readSessionState(cachePath);
71
+ writeSessionState(cachePath, {
72
+ staticDedup: state.staticDedup,
73
+ dynamicDedup: state.dynamicDedup,
74
+ ...(state.dynamicTargetFingerprints === undefined
75
+ ? {}
76
+ : { dynamicTargetFingerprints: state.dynamicTargetFingerprints }),
77
+ postCompactPending: { static: true, dynamic: true },
78
+ });
79
+ }
80
+
81
+ export function hasPostCompactPending(cachePath: string): boolean {
82
+ const state = readSessionState(cachePath);
83
+ return postCompactPendingKinds(state).size > 0 || postCompactRecoveringKinds(state).size > 0;
84
+ }
85
+
86
+ export function isPostCompactPending(cachePath: string, kind: PostCompactPendingKind): boolean {
87
+ return postCompactPendingKinds(readSessionState(cachePath)).has(kind);
88
+ }
89
+
90
+ export function claimPostCompactPending(cachePath: string, kind: PostCompactPendingKind): PostCompactClaimResult {
91
+ const result = withSessionStateLock(cachePath, () => {
92
+ const state = readSessionState(cachePath);
93
+ const pendingKinds = postCompactPendingKinds(state);
94
+ if (!pendingKinds.has(kind)) {
95
+ return "not-pending";
96
+ }
97
+
98
+ pendingKinds.delete(kind);
99
+ const recoveringKinds = postCompactRecoveringKinds(state);
100
+ recoveringKinds.add(kind);
101
+ writeSessionState(cachePath, stateWithPostCompactKinds(state, pendingKinds, recoveringKinds));
102
+ return "claimed";
103
+ });
104
+ return result === SESSION_STATE_LOCK_CONTENDED ? "contended" : result;
105
+ }
106
+
107
+ export function isPostCompactRecoveryInProgress(cachePath: string, kind: PostCompactPendingKind): boolean {
108
+ return postCompactRecoveringKinds(readSessionState(cachePath)).has(kind);
109
+ }
110
+
111
+ export function completePostCompactRecovery(cachePath: string, kind: PostCompactPendingKind): void {
112
+ withSessionStateLock(cachePath, () => {
113
+ const state = readSessionState(cachePath);
114
+ const pendingKinds = postCompactPendingKinds(state);
115
+ const recoveringKinds = postCompactRecoveringKinds(state);
116
+ recoveringKinds.delete(kind);
117
+ writeSessionState(cachePath, stateWithPostCompactKinds(state, pendingKinds, recoveringKinds));
118
+ });
119
+ }
120
+
121
+ export function sessionCachePath(sessionId: string, pluginDataRoot: string | undefined): string {
122
+ const root = pluginDataRoot ?? process.env["PLUGIN_DATA"] ?? join(homedir(), ".codex", "codex-rules");
123
+ return join(root, "sessions", `${safePathSegment(sessionId)}.json`);
124
+ }
125
+
126
+ function readSessionState(cachePath: string): SerializedSessionState {
127
+ try {
128
+ const parsed = JSON.parse(readFileSync(cachePath, "utf8"));
129
+ if (!isSerializedSessionState(parsed)) return emptyState();
130
+ return parsed;
131
+ } catch {
132
+ return emptyState();
133
+ }
134
+ }
135
+
136
+ function writeSessionState(cachePath: string, state: SerializedSessionState): void {
137
+ mkdirSync(dirname(cachePath), { recursive: true });
138
+ writeFileSync(cachePath, `${JSON.stringify(state)}\n`);
139
+ }
140
+
141
+ function emptyState(): SerializedSessionState {
142
+ return { staticDedup: [], dynamicDedup: {}, dynamicTargetFingerprints: {} };
143
+ }
144
+
145
+ function nextPostCompactPending(
146
+ state: SerializedSessionState,
147
+ completedKind: PostCompactPendingKind | undefined,
148
+ ): PostCompactPendingState | undefined {
149
+ const pendingKinds = postCompactPendingKinds(state);
150
+ if (completedKind !== undefined) {
151
+ pendingKinds.delete(completedKind);
152
+ }
153
+
154
+ if (pendingKinds.size === 0) {
155
+ return undefined;
156
+ }
157
+
158
+ return {
159
+ ...(pendingKinds.has("static") ? { static: true } : {}),
160
+ ...(pendingKinds.has("dynamic") ? { dynamic: true } : {}),
161
+ };
162
+ }
163
+
164
+ function nextPostCompactRecovering(
165
+ state: SerializedSessionState,
166
+ completedKind: PostCompactPendingKind | undefined,
167
+ ): PostCompactPendingState | undefined {
168
+ const recoveringKinds = postCompactRecoveringKinds(state);
169
+ if (completedKind !== undefined) {
170
+ recoveringKinds.delete(completedKind);
171
+ }
172
+
173
+ return postCompactKindState(recoveringKinds);
174
+ }
175
+
176
+ function stateWithPostCompactKinds(
177
+ state: SerializedSessionState,
178
+ pendingKinds: ReadonlySet<PostCompactPendingKind>,
179
+ recoveringKinds: ReadonlySet<PostCompactPendingKind>,
180
+ ): SerializedSessionState {
181
+ const postCompactPending = postCompactKindState(pendingKinds);
182
+ const postCompactRecovering = postCompactKindState(recoveringKinds);
183
+ return {
184
+ staticDedup: state.staticDedup,
185
+ dynamicDedup: state.dynamicDedup,
186
+ ...(state.dynamicTargetFingerprints === undefined
187
+ ? {}
188
+ : { dynamicTargetFingerprints: state.dynamicTargetFingerprints }),
189
+ ...(postCompactPending === undefined ? {} : { postCompactPending }),
190
+ ...(postCompactRecovering === undefined ? {} : { postCompactRecovering }),
191
+ };
192
+ }
193
+
194
+ function safePathSegment(value: string): string {
195
+ return value.replace(/[^A-Za-z0-9._-]/g, "_").slice(0, 120) || "unknown-session";
196
+ }
197
+
198
+ function isSerializedSessionState(value: unknown): value is SerializedSessionState {
199
+ if (!isRecord(value) || !Array.isArray(value["staticDedup"]) || !isRecord(value["dynamicDedup"])) {
200
+ return false;
201
+ }
202
+ const staticDedup = value["staticDedup"];
203
+ const dynamicDedup = value["dynamicDedup"];
204
+ const dynamicTargetFingerprints = value["dynamicTargetFingerprints"];
205
+ const postCompactPending = value["postCompactPending"];
206
+ const postCompactRecovering = value["postCompactRecovering"];
207
+ const compacted = value["compacted"];
208
+ return (
209
+ staticDedup.every((item) => typeof item === "string") &&
210
+ Object.values(dynamicDedup).every(
211
+ (item) => Array.isArray(item) && item.every((nestedItem) => typeof nestedItem === "string"),
212
+ ) &&
213
+ (dynamicTargetFingerprints === undefined ||
214
+ (isRecord(dynamicTargetFingerprints) &&
215
+ Object.entries(dynamicTargetFingerprints).every(
216
+ ([targetKey, fingerprint]) => typeof targetKey === "string" && typeof fingerprint === "string",
217
+ ))) &&
218
+ (postCompactPending === undefined || isPostCompactPendingState(postCompactPending)) &&
219
+ (postCompactRecovering === undefined || isPostCompactPendingState(postCompactRecovering)) &&
220
+ (compacted === undefined || typeof compacted === "boolean")
221
+ );
222
+ }
223
+
224
+ function isPostCompactPendingState(value: unknown): value is PostCompactPendingState {
225
+ return (
226
+ isRecord(value) &&
227
+ (value["static"] === undefined || typeof value["static"] === "boolean") &&
228
+ (value["dynamic"] === undefined || typeof value["dynamic"] === "boolean")
229
+ );
230
+ }
231
+
232
+ function isRecord(value: unknown): value is Record<string, unknown> {
233
+ return typeof value === "object" && value !== null && !Array.isArray(value);
234
+ }
@@ -0,0 +1,104 @@
1
+ import { hasContextPressureMarker } from "./context-pressure.js";
2
+ import type { PiRulesConfig } from "./rules/types.js";
3
+ import { readTranscriptSearchText } from "./transcript-search.js";
4
+
5
+ export interface PostCompactBudgetContext {
6
+ readonly model: string;
7
+ readonly transcriptPath: string | null;
8
+ }
9
+
10
+ interface ModelContextBudget {
11
+ readonly slug: string;
12
+ readonly contextWindowTokens: number;
13
+ readonly effectivePercent: number;
14
+ }
15
+
16
+ const DEFAULT_EFFECTIVE_CONTEXT_WINDOW_PERCENT = 95;
17
+ const ESTIMATED_TRANSCRIPT_CHARS_PER_TOKEN = 3;
18
+ const PROJECTED_INJECTION_CHARS_PER_TOKEN = 2;
19
+ const POST_COMPACT_RESERVED_CONTEXT_PERCENT = 5;
20
+ const POST_COMPACT_MIN_RESERVED_TOKENS = 8_000;
21
+ const POST_COMPACT_MIN_GUIDE_CHARS = 500;
22
+ const FALLBACK_CONTEXT_WINDOW_TOKENS = 200_000;
23
+ const MODEL_CONTEXT_BUDGETS: readonly ModelContextBudget[] = [
24
+ { slug: "gpt-5.5", contextWindowTokens: 272_000, effectivePercent: DEFAULT_EFFECTIVE_CONTEXT_WINDOW_PERCENT },
25
+ { slug: "gpt-5.4", contextWindowTokens: 272_000, effectivePercent: DEFAULT_EFFECTIVE_CONTEXT_WINDOW_PERCENT },
26
+ { slug: "gpt-5.4-mini", contextWindowTokens: 272_000, effectivePercent: DEFAULT_EFFECTIVE_CONTEXT_WINDOW_PERCENT },
27
+ { slug: "gpt-5.3-codex", contextWindowTokens: 272_000, effectivePercent: DEFAULT_EFFECTIVE_CONTEXT_WINDOW_PERCENT },
28
+ { slug: "gpt-5.2", contextWindowTokens: 272_000, effectivePercent: DEFAULT_EFFECTIVE_CONTEXT_WINDOW_PERCENT },
29
+ {
30
+ slug: "codex-auto-review",
31
+ contextWindowTokens: 272_000,
32
+ effectivePercent: DEFAULT_EFFECTIVE_CONTEXT_WINDOW_PERCENT,
33
+ },
34
+ ];
35
+
36
+ export function withPostCompactBudget(config: PiRulesConfig, context?: PostCompactBudgetContext): PiRulesConfig {
37
+ const postCompactMaxResultChars = dynamicPostCompactMaxResultChars(context) ?? config.postCompactMaxResultChars;
38
+ const maxResultChars = Math.min(config.maxResultChars, config.postCompactMaxResultChars, postCompactMaxResultChars);
39
+ const maxRuleChars = Math.min(config.maxRuleChars, config.postCompactMaxRuleChars, maxResultChars);
40
+ return {
41
+ ...config,
42
+ maxRuleChars,
43
+ maxResultChars,
44
+ };
45
+ }
46
+
47
+ function dynamicPostCompactMaxResultChars(context: PostCompactBudgetContext | undefined): number | undefined {
48
+ if (context === undefined || context.transcriptPath === null) {
49
+ return undefined;
50
+ }
51
+
52
+ const transcript = estimateTranscript(context.transcriptPath);
53
+ if (transcript === undefined) {
54
+ return undefined;
55
+ }
56
+
57
+ if (hasContextPressureMarker(transcript.text)) {
58
+ return POST_COMPACT_MIN_GUIDE_CHARS;
59
+ }
60
+
61
+ const modelBudget = modelContextBudgetFor(context.model) ?? fallbackModelContextBudget();
62
+ const effectiveContextWindow = Math.floor((modelBudget.contextWindowTokens * modelBudget.effectivePercent) / 100);
63
+ const reservedTokens = Math.max(
64
+ POST_COMPACT_MIN_RESERVED_TOKENS,
65
+ Math.floor((effectiveContextWindow * POST_COMPACT_RESERVED_CONTEXT_PERCENT) / 100),
66
+ );
67
+ const injectableTokens = Math.max(0, effectiveContextWindow - reservedTokens - transcript.tokens);
68
+ return Math.max(POST_COMPACT_MIN_GUIDE_CHARS, Math.floor(injectableTokens * PROJECTED_INJECTION_CHARS_PER_TOKEN));
69
+ }
70
+
71
+ function modelContextBudgetFor(model: string): ModelContextBudget | undefined {
72
+ const normalizedModel = model.trim().toLowerCase();
73
+ for (const budget of MODEL_CONTEXT_BUDGETS) {
74
+ if (
75
+ normalizedModel === budget.slug ||
76
+ normalizedModel.endsWith(`.${budget.slug}`) ||
77
+ normalizedModel.endsWith(`/${budget.slug}`)
78
+ ) {
79
+ return budget;
80
+ }
81
+ }
82
+ return undefined;
83
+ }
84
+
85
+ function fallbackModelContextBudget(): ModelContextBudget {
86
+ return {
87
+ slug: "unknown",
88
+ contextWindowTokens: FALLBACK_CONTEXT_WINDOW_TOKENS,
89
+ effectivePercent: DEFAULT_EFFECTIVE_CONTEXT_WINDOW_PERCENT,
90
+ };
91
+ }
92
+
93
+ function estimateTranscript(transcriptPath: string): { readonly text: string; readonly tokens: number } | undefined {
94
+ const transcriptText =
95
+ readTranscriptSearchText(transcriptPath, { latestCompactedReplacementOnly: true }) ??
96
+ readTranscriptSearchText(transcriptPath);
97
+ if (transcriptText === null) {
98
+ return undefined;
99
+ }
100
+ return {
101
+ text: transcriptText,
102
+ tokens: Math.ceil(Buffer.byteLength(transcriptText, "utf8") / ESTIMATED_TRANSCRIPT_CHARS_PER_TOKEN),
103
+ };
104
+ }