@omagents/core 0.0.0-stage → 0.14.1
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.
- package/AGENTS.md +45 -0
- package/hooks/project-venv.js +74 -0
- package/hooks/python-env.js +283 -0
- package/hooks/setup-venv.js +53 -0
- package/mcp-servers/base.json +18 -0
- package/node_modules/superpowers/.agents/plugins/marketplace.json +20 -0
- package/node_modules/superpowers/.claude-plugin/marketplace.json +20 -0
- package/node_modules/superpowers/.claude-plugin/plugin.json +20 -0
- package/node_modules/superpowers/.codex-plugin/plugin.json +48 -0
- package/node_modules/superpowers/.cursor-plugin/plugin.json +23 -0
- package/node_modules/superpowers/.devin-plugin/plugin.json +22 -0
- package/node_modules/superpowers/.gitattributes +18 -0
- package/node_modules/superpowers/.github/FUNDING.yml +3 -0
- package/node_modules/superpowers/.github/ISSUE_TEMPLATE/bug_report.md +55 -0
- package/node_modules/superpowers/.github/ISSUE_TEMPLATE/config.yml +5 -0
- package/node_modules/superpowers/.github/ISSUE_TEMPLATE/diagnosis_report.md +42 -0
- package/node_modules/superpowers/.github/ISSUE_TEMPLATE/feature_request.md +47 -0
- package/node_modules/superpowers/.github/ISSUE_TEMPLATE/platform_support.md +34 -0
- package/node_modules/superpowers/.github/PULL_REQUEST_TEMPLATE.md +143 -0
- package/node_modules/superpowers/.hermes-plugin/__init__.py +104 -0
- package/node_modules/superpowers/.hermes-plugin/plugin.yaml +6 -0
- package/node_modules/superpowers/.kimi-plugin/plugin.json +38 -0
- package/node_modules/superpowers/.muse-plugin/marketplace.json +20 -0
- package/node_modules/superpowers/.muse-plugin/plugin.json +89 -0
- package/node_modules/superpowers/.opencode/INSTALL.md +166 -0
- package/node_modules/superpowers/.opencode/plugins/superpowers.js +383 -0
- package/node_modules/superpowers/.pi/extensions/superpowers.ts +121 -0
- package/node_modules/superpowers/.pre-commit-config.yaml +21 -0
- package/node_modules/superpowers/.version-bump.json +26 -0
- package/node_modules/superpowers/AGENTS.md +115 -0
- package/node_modules/superpowers/CODE_OF_CONDUCT.md +130 -0
- package/node_modules/superpowers/GEMINI.md +2 -0
- package/node_modules/superpowers/LICENSE +21 -0
- package/node_modules/superpowers/README.md +399 -0
- package/node_modules/superpowers/RELEASE-NOTES.md +1475 -0
- package/node_modules/superpowers/assets/app-icon.png +0 -0
- package/node_modules/superpowers/assets/superpowers-small.svg +1 -0
- package/node_modules/superpowers/docs/README.kimi.md +88 -0
- package/node_modules/superpowers/docs/README.opencode.md +244 -0
- package/node_modules/superpowers/docs/plans/2025-11-22-opencode-support-design.md +294 -0
- package/node_modules/superpowers/docs/plans/2025-11-22-opencode-support-implementation.md +1095 -0
- package/node_modules/superpowers/docs/plans/2025-11-28-skills-improvements-from-user-feedback.md +711 -0
- package/node_modules/superpowers/docs/plans/2026-01-17-visual-brainstorming.md +571 -0
- package/node_modules/superpowers/docs/porting-to-a-new-harness.md +841 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-01-22-document-review-system.md +301 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-02-19-visual-brainstorming-refactor.md +523 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-03-11-zero-dep-brainstorm-server.md +479 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-03-23-codex-app-compatibility.md +566 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-04-06-worktree-rototill.md +866 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-05-06-lift-drill-into-evals.md +1374 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-05-07-pi-extension-and-evals.md +143 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-06-09-sdd-task-scoped-review-dispatch.md +774 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-06-09-visual-companion-issues.md +352 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-06-10-visual-companion-auth-hardening.md +785 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-06-11-visual-companion-final-hardening-fixup.md +1126 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-07-06-sdd-plan-scoped-workspace.md +1134 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-07-15-sdd-fix-loop-redesign.md +1649 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-07-30-codex-efficiency-fixes.md +1009 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-08-06-hermes-version-bump-wiring.md +304 -0
- package/node_modules/superpowers/docs/superpowers/plans/2026-08-27-diagnosing-superpowers.md +1512 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-01-22-document-review-system-design.md +136 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-02-19-visual-brainstorming-refactor-design.md +162 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-03-11-zero-dep-brainstorm-server-design.md +118 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-03-23-codex-app-compatibility-design.md +244 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-04-06-worktree-rototill-design.md +341 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-05-05-platform-neutral-config-refs-design.md +77 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-05-05-platform-neutral-prose-design.md +94 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-05-05-platform-neutral-readme-design.md +47 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-05-06-lift-drill-into-evals-design.md +247 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-06-09-sdd-task-scoped-review-dispatch-design.md +160 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-06-10-positive-instruction-redesign-design.md +178 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-06-10-strict-cost-sdd-design.md +265 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-06-10-visual-companion-auth-hardening-design.md +225 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-06-11-visual-companion-final-hardening-fixup-design.md +254 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-07-06-sdd-plan-scoped-workspace-eval-results.md +543 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-07-06-sdd-plan-scoped-workspace.md +196 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-07-15-sdd-fix-loop-redesign-design.md +196 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-07-30-codex-efficiency-fixes-design.md +252 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-08-05-hermes-version-bump-wiring-design.md +56 -0
- package/node_modules/superpowers/docs/superpowers/specs/2026-08-27-diagnosing-superpowers-design.md +530 -0
- package/node_modules/superpowers/docs/testing.md +37 -0
- package/node_modules/superpowers/docs/windows/polyglot-hooks.md +158 -0
- package/node_modules/superpowers/gemini-extension.json +6 -0
- package/node_modules/superpowers/hooks/hooks-cursor.json +10 -0
- package/node_modules/superpowers/hooks/hooks.json +17 -0
- package/node_modules/superpowers/hooks/run-hook.cmd +46 -0
- package/node_modules/superpowers/hooks/session-start +53 -0
- package/node_modules/superpowers/index.js +9 -0
- package/node_modules/superpowers/package.json +23 -0
- package/node_modules/superpowers/scripts/bump-version.sh +282 -0
- package/node_modules/superpowers/scripts/lint-shell.sh +211 -0
- package/node_modules/superpowers/scripts/package-codex-plugin.sh +351 -0
- package/node_modules/superpowers/scripts/sync-to-codex-plugin.sh +468 -0
- package/node_modules/superpowers/skills/brainstorming/SKILL.md +285 -0
- package/node_modules/superpowers/skills/brainstorming/scripts/frame-template.html +213 -0
- package/node_modules/superpowers/skills/brainstorming/scripts/helper.js +167 -0
- package/node_modules/superpowers/skills/brainstorming/scripts/server.cjs +723 -0
- package/node_modules/superpowers/skills/brainstorming/scripts/start-server.sh +209 -0
- package/node_modules/superpowers/skills/brainstorming/scripts/stop-server.sh +120 -0
- package/node_modules/superpowers/skills/brainstorming/spec-document-reviewer-prompt.md +49 -0
- package/node_modules/superpowers/skills/brainstorming/visual-companion.md +299 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/SKILL.md +120 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/analyst-common.md +38 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/cost-and-time.md +28 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/plan-adherence.md +29 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/quality-evidence.md +26 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/repeated-work.md +30 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/request-conflicts.md +20 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/scrub-audit.md +33 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/scrub.md +29 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/similar-session.md +38 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/skill-timeline.md +30 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/stumbles.md +28 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/references/context-safety.md +22 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/references/github-issues.md +47 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/references/redaction-policy.md +34 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/references/session-discovery.md +31 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/templates/bundle-README.md +77 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/templates/case.md +64 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/templates/issue.md +51 -0
- package/node_modules/superpowers/skills/diagnosing-superpowers/templates/report.md +82 -0
- package/node_modules/superpowers/skills/dispatching-parallel-agents/SKILL.md +167 -0
- package/node_modules/superpowers/skills/executing-plans/SKILL.md +373 -0
- package/node_modules/superpowers/skills/executing-plans/scripts/task-done +52 -0
- package/node_modules/superpowers/skills/executing-plans/scripts/task-start +28 -0
- package/node_modules/superpowers/skills/finishing-a-development-branch/SKILL.md +225 -0
- package/node_modules/superpowers/skills/receiving-code-review/SKILL.md +205 -0
- package/node_modules/superpowers/skills/requesting-code-review/SKILL.md +95 -0
- package/node_modules/superpowers/skills/requesting-code-review/code-reviewer.md +198 -0
- package/node_modules/superpowers/skills/subagent-driven-development/SKILL.md +568 -0
- package/node_modules/superpowers/skills/subagent-driven-development/implementer-prompt.md +154 -0
- package/node_modules/superpowers/skills/subagent-driven-development/re-review-prompt.md +115 -0
- package/node_modules/superpowers/skills/subagent-driven-development/scripts/review-package +53 -0
- package/node_modules/superpowers/skills/subagent-driven-development/scripts/sdd-workspace +82 -0
- package/node_modules/superpowers/skills/subagent-driven-development/scripts/task-brief +43 -0
- package/node_modules/superpowers/skills/subagent-driven-development/task-reviewer-prompt.md +207 -0
- package/node_modules/superpowers/skills/systematic-debugging/CREATION-LOG.md +119 -0
- package/node_modules/superpowers/skills/systematic-debugging/SKILL.md +283 -0
- package/node_modules/superpowers/skills/systematic-debugging/condition-based-waiting-example.ts +158 -0
- package/node_modules/superpowers/skills/systematic-debugging/condition-based-waiting.md +115 -0
- package/node_modules/superpowers/skills/systematic-debugging/defense-in-depth.md +122 -0
- package/node_modules/superpowers/skills/systematic-debugging/find-polluter.sh +72 -0
- package/node_modules/superpowers/skills/systematic-debugging/root-cause-tracing.md +169 -0
- package/node_modules/superpowers/skills/systematic-debugging/test-academic.md +14 -0
- package/node_modules/superpowers/skills/systematic-debugging/test-pressure-1.md +58 -0
- package/node_modules/superpowers/skills/systematic-debugging/test-pressure-2.md +68 -0
- package/node_modules/superpowers/skills/systematic-debugging/test-pressure-3.md +69 -0
- package/node_modules/superpowers/skills/test-driven-development/SKILL.md +330 -0
- package/node_modules/superpowers/skills/test-driven-development/writing-good-tests.md +198 -0
- package/node_modules/superpowers/skills/using-git-worktrees/SKILL.md +167 -0
- package/node_modules/superpowers/skills/using-superpowers/SKILL.md +65 -0
- package/node_modules/superpowers/skills/using-superpowers/references/antigravity-tools.md +23 -0
- package/node_modules/superpowers/skills/using-superpowers/references/claude-code-tools.md +29 -0
- package/node_modules/superpowers/skills/using-superpowers/references/codex-tools.md +108 -0
- package/node_modules/superpowers/skills/using-superpowers/references/gemini-tools.md +63 -0
- package/node_modules/superpowers/skills/using-superpowers/references/hermes-tools.md +56 -0
- package/node_modules/superpowers/skills/using-superpowers/references/muse-tools.md +35 -0
- package/node_modules/superpowers/skills/using-superpowers/references/pi-tools.md +16 -0
- package/node_modules/superpowers/skills/verification-before-completion/SKILL.md +120 -0
- package/node_modules/superpowers/skills/writing-plans/SKILL.md +204 -0
- package/node_modules/superpowers/skills/writing-skills/SKILL.md +681 -0
- package/node_modules/superpowers/skills/writing-skills/anthropic-best-practices.md +1150 -0
- package/node_modules/superpowers/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
- package/node_modules/superpowers/skills/writing-skills/graphviz-conventions.dot +172 -0
- package/node_modules/superpowers/skills/writing-skills/persuasion-principles.md +187 -0
- package/node_modules/superpowers/skills/writing-skills/render-graphs.js +169 -0
- package/node_modules/superpowers/skills/writing-skills/testing-skills-with-subagents.md +384 -0
- package/node_modules/superpowers/tests/antigravity/run-tests.sh +16 -0
- package/node_modules/superpowers/tests/antigravity/test-antigravity-tools.sh +46 -0
- package/node_modules/superpowers/tests/brainstorm-server/auth.test.js +312 -0
- package/node_modules/superpowers/tests/brainstorm-server/branding.test.js +344 -0
- package/node_modules/superpowers/tests/brainstorm-server/browser-launcher.test.js +66 -0
- package/node_modules/superpowers/tests/brainstorm-server/helper.test.js +197 -0
- package/node_modules/superpowers/tests/brainstorm-server/lifecycle.test.js +515 -0
- package/node_modules/superpowers/tests/brainstorm-server/package-lock.json +36 -0
- package/node_modules/superpowers/tests/brainstorm-server/package.json +10 -0
- package/node_modules/superpowers/tests/brainstorm-server/server.test.js +592 -0
- package/node_modules/superpowers/tests/brainstorm-server/start-server.test.sh +115 -0
- package/node_modules/superpowers/tests/brainstorm-server/stop-server.test.sh +182 -0
- package/node_modules/superpowers/tests/brainstorm-server/windows-lifecycle.test.sh +394 -0
- package/node_modules/superpowers/tests/brainstorm-server/ws-protocol.test.js +407 -0
- package/node_modules/superpowers/tests/claude-code/README.md +165 -0
- package/node_modules/superpowers/tests/claude-code/analyze-token-usage.py +168 -0
- package/node_modules/superpowers/tests/claude-code/run-skill-tests.sh +191 -0
- package/node_modules/superpowers/tests/claude-code/test-executing-plans-scripts.sh +139 -0
- package/node_modules/superpowers/tests/claude-code/test-helpers.sh +208 -0
- package/node_modules/superpowers/tests/claude-code/test-sdd-workspace.sh +361 -0
- package/node_modules/superpowers/tests/claude-code/test-subagent-driven-development-integration.sh +333 -0
- package/node_modules/superpowers/tests/claude-code/test-subagent-driven-development.sh +179 -0
- package/node_modules/superpowers/tests/claude-code/test-worktree-native-preference.sh +181 -0
- package/node_modules/superpowers/tests/claude-code/test-worktree-path-policy.sh +69 -0
- package/node_modules/superpowers/tests/codex/test-marketplace-manifest.sh +76 -0
- package/node_modules/superpowers/tests/codex/test-package-codex-plugin.sh +297 -0
- package/node_modules/superpowers/tests/codex-plugin-sync/test-sync-to-codex-plugin.sh +744 -0
- package/node_modules/superpowers/tests/devin/test-devin-plugin.sh +63 -0
- package/node_modules/superpowers/tests/diagnosing-superpowers/test-skill-structure.sh +151 -0
- package/node_modules/superpowers/tests/explicit-skill-requests/prompts/action-oriented.txt +3 -0
- package/node_modules/superpowers/tests/explicit-skill-requests/prompts/after-planning-flow.txt +17 -0
- package/node_modules/superpowers/tests/explicit-skill-requests/prompts/claude-suggested-it.txt +11 -0
- package/node_modules/superpowers/tests/explicit-skill-requests/prompts/i-know-what-sdd-means.txt +8 -0
- package/node_modules/superpowers/tests/explicit-skill-requests/prompts/mid-conversation-execute-plan.txt +3 -0
- package/node_modules/superpowers/tests/explicit-skill-requests/prompts/please-use-brainstorming.txt +1 -0
- package/node_modules/superpowers/tests/explicit-skill-requests/prompts/skip-formalities.txt +3 -0
- package/node_modules/superpowers/tests/explicit-skill-requests/prompts/subagent-driven-development-please.txt +1 -0
- package/node_modules/superpowers/tests/explicit-skill-requests/prompts/use-systematic-debugging.txt +1 -0
- package/node_modules/superpowers/tests/explicit-skill-requests/run-all.sh +70 -0
- package/node_modules/superpowers/tests/explicit-skill-requests/run-extended-multiturn-test.sh +113 -0
- package/node_modules/superpowers/tests/explicit-skill-requests/run-haiku-test.sh +144 -0
- package/node_modules/superpowers/tests/explicit-skill-requests/run-multiturn-test.sh +143 -0
- package/node_modules/superpowers/tests/explicit-skill-requests/run-test.sh +136 -0
- package/node_modules/superpowers/tests/hermes/__init__.py +0 -0
- package/node_modules/superpowers/tests/hermes/conftest.py +30 -0
- package/node_modules/superpowers/tests/hermes/test_bootstrap.py +98 -0
- package/node_modules/superpowers/tests/hermes/test_plugin.py +142 -0
- package/node_modules/superpowers/tests/hooks/test-session-start.sh +225 -0
- package/node_modules/superpowers/tests/kimi/run-tests.sh +6 -0
- package/node_modules/superpowers/tests/kimi/test-plugin-manifest.sh +86 -0
- package/node_modules/superpowers/tests/opencode/run-tests.sh +169 -0
- package/node_modules/superpowers/tests/opencode/setup.sh +88 -0
- package/node_modules/superpowers/tests/opencode/test-bootstrap-caching.mjs +268 -0
- package/node_modules/superpowers/tests/opencode/test-bootstrap-caching.sh +32 -0
- package/node_modules/superpowers/tests/opencode/test-plugin-loading.sh +82 -0
- package/node_modules/superpowers/tests/opencode/test-priority.sh +217 -0
- package/node_modules/superpowers/tests/opencode/test-session-bootstrap.mjs +224 -0
- package/node_modules/superpowers/tests/opencode/test-session-bootstrap.sh +4 -0
- package/node_modules/superpowers/tests/opencode/test-skill-registration.mjs +205 -0
- package/node_modules/superpowers/tests/opencode/test-skill-registration.sh +22 -0
- package/node_modules/superpowers/tests/opencode/test-tools.sh +95 -0
- package/node_modules/superpowers/tests/pi/test-pi-extension.mjs +137 -0
- package/node_modules/superpowers/tests/shell-lint/test-lint-shell.sh +179 -0
- package/node_modules/superpowers/tests/systematic-debugging/test-find-polluter.sh +90 -0
- package/node_modules/superpowers/tests/version-bump/test-bump-version.sh +76 -0
- package/node_modules/superpowers/tests/writing-skills/test-render-graphs.sh +113 -0
- package/package.json +21 -4
- package/scripts/pack-superpowers.js +43 -0
- package/skills/_shared/scripts/loop_engine.py +214 -0
- package/skills/agents-python-tools/SKILL.md +84 -0
- package/skills/agents-python-tools/agents/openai.yaml +4 -0
- package/skills/ast-grep/SKILL.md +136 -0
- package/skills/ast-grep/agents/openai.yaml +4 -0
- package/skills/deep-research/SKILL.dsh.md +220 -0
- package/skills/deep-research/SKILL.md +588 -0
- package/skills/deep-research/agents/openai.yaml +4 -0
- package/skills/deep-research/prompts/polish_report.md +49 -0
- package/skills/deep-research/scripts/audit.py +264 -0
- package/skills/deep-research/scripts/deep_research.py +510 -0
- package/skills/deep-research/scripts/gap_analysis.py +315 -0
- package/skills/deep-research/scripts/layout.py +198 -0
- package/skills/deep-research/scripts/merge.py +104 -0
- package/skills/deep-research/scripts/orchestrate.py +782 -0
- package/skills/deep-research/scripts/package.py +229 -0
- package/skills/deep-research/scripts/plan.py +581 -0
- package/skills/deep-research/scripts/pre_research.py +391 -0
- package/skills/deep-research/scripts/provenance.py +151 -0
- package/skills/deep-research/scripts/svg_charts.py +376 -0
- package/skills/deep-research/scripts/synthesize.py +492 -0
- package/skills/deep-research/scripts/validate.py +170 -0
- package/skills/deep-research/templates/comparison.md.tmpl +158 -0
- package/skills/deep-research/templates/survey.md.tmpl +167 -0
- package/skills/deep-research/templates/technical.md.tmpl +155 -0
- package/skills/doctor/SKILL.dsh.md +125 -0
- package/skills/doctor/SKILL.md +150 -0
- package/skills/doctor/agents/openai.yaml +4 -0
- package/skills/github-triage/SKILL.md +129 -0
- package/skills/github-triage/agents/openai.yaml +4 -0
- package/skills/hyperplan/SKILL.codex.md +94 -0
- package/skills/hyperplan/SKILL.dsh.md +156 -0
- package/skills/hyperplan/SKILL.md +146 -0
- package/skills/hyperplan/agents/openai.yaml +4 -0
- package/skills/init-deep/SKILL.md +82 -0
- package/skills/init-deep/agents/openai.yaml +4 -0
- package/skills/lsp-guide/SKILL.dsh.md +62 -0
- package/skills/lsp-guide/SKILL.md +95 -0
- package/skills/lsp-guide/agents/openai.yaml +4 -0
- package/skills/markitdown-converter/SKILL.md +82 -0
- package/skills/markitdown-converter/agents/openai.yaml +3 -0
- package/skills/markitdown-converter/scripts/convert_to_markdown.py +78 -0
- package/skills/officecli/SKILL.md +417 -0
- package/skills/parallel-execution/SKILL.codex.md +30 -0
- package/skills/parallel-execution/SKILL.dsh.md +36 -0
- package/skills/parallel-execution/SKILL.md +44 -0
- package/skills/playwright-web-scraping/SKILL.md +112 -0
- package/skills/playwright-web-scraping/agents/openai.yaml +4 -0
- package/skills/playwright-web-scraping/scripts/fetch_page.py +72 -0
- package/skills/pre-publish-review/SKILL.md +82 -0
- package/skills/pre-publish-review/agents/openai.yaml +4 -0
- package/skills/refactor/SKILL.md +131 -0
- package/skills/refactor/agents/openai.yaml +4 -0
- package/skills/remove-ai-slops/SKILL.md +110 -0
- package/skills/remove-ai-slops/agents/openai.yaml +4 -0
- package/skills/remove-deadcode/SKILL.md +125 -0
- package/skills/remove-deadcode/agents/openai.yaml +4 -0
- package/skills/tech-debt-audit/SKILL.md +132 -0
- package/skills/tech-debt-audit/agents/openai.yaml +4 -0
- package/skills/work-with-pr/SKILL.md +153 -0
- package/skills/work-with-pr/agents/openai.yaml +4 -0
- package/src/index.js +20 -0
- package/src/job-board/job-board.js +345 -0
- package/src/job-board/presenters.js +106 -0
- package/src/job-board/records.js +39 -0
- package/src/mcp/resolve-servers.js +53 -0
- package/src/paths.js +49 -0
- package/src/skills/catalog.js +49 -0
- package/src/skills/render.js +248 -0
- package/src/storage/json-job-store.js +162 -0
- package/src/storage/schema.js +105 -0
- package/test/job-board.test.js +383 -0
- package/test/json-job-store.test.js +330 -0
- package/test/mcp.test.js +174 -0
- package/test/paths.test.js +103 -0
- package/test/presenters.test.js +187 -0
- package/test/recovery.test.js +527 -0
- package/README.md +0 -3
package/AGENTS.md
ADDED
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# Core Package Guide
|
|
2
|
+
|
|
3
|
+
`packages/core` is `@omagents/core`, the automatic shared dependency of OpenCode, Codex, and DSH. It is not a standalone user plugin and has no separate installation command. Read the root `AGENTS.md` first.
|
|
4
|
+
|
|
5
|
+
## Boundaries
|
|
6
|
+
|
|
7
|
+
Core must remain host-neutral. Do not import OpenCode, Codex, DSH, Cordis, React, or host SDK packages. Host adapters inject storage paths, lifecycle queries, cancellation, event delivery, and presentation behavior.
|
|
8
|
+
|
|
9
|
+
- `src/job-board/`: execution state, independent notification state, transitions, and presenters.
|
|
10
|
+
- `src/storage/`: validated, versioned, serialized, atomic JSON persistence and recovery.
|
|
11
|
+
- `src/skills/`: discovery and full-content rendering for exactly `opencode-v1`, `opencode-v2`, `codex`, and `dsh`.
|
|
12
|
+
- `src/mcp/` and `mcp-servers/base.json`: canonical environment-dependent MCP resolution.
|
|
13
|
+
- `src/paths.js`: packaged asset resolution through `import.meta.url`, never cwd. Superpowers resolution explicitly prefers the real workspace/app-hoisted installation, falls back to Core's bundled nested dependency, and remains stable across prepack materialization/postpack cleanup.
|
|
14
|
+
- `hooks/`: persistent Python base and on-demand project overlay management.
|
|
15
|
+
- `skills/`: 18 OmAgents skills, shared scripts, and research assets; pinned Superpowers supplies 15 process skills.
|
|
16
|
+
|
|
17
|
+
Execution and notification state are separate. Terminal states never regress, `interrupted` is not success, and cancellation admission alone is not `cancelled`. Consumers share one Board; do not create a second task database.
|
|
18
|
+
|
|
19
|
+
## Skills and Assets
|
|
20
|
+
|
|
21
|
+
`SKILL.md` is the fallback and `SKILL.<host>.md` is a complete override, not a runtime search-and-replace fragment. Do not add runtime host detection. Preserve native host delegation forms and the pinned Superpowers commit.
|
|
22
|
+
|
|
23
|
+
Jinja2 templates live only under `packages/core/skills/deep-research/templates/`. There is no root `templates/` directory. Deep-research internal state and public deliverables must remain separated through `skills/deep-research/scripts/layout.py`.
|
|
24
|
+
|
|
25
|
+
Only `jinja2` is automatically provisioned. Optional Python tools install on demand. Use the `agents-python-tools` skill for environment selection, paths, and CLI details rather than duplicating the full Python guide here. Never auto-delete the base or project environment.
|
|
26
|
+
|
|
27
|
+
## Verification
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
npm test --workspace @omagents/core
|
|
31
|
+
node --test tests/documentation.test.js
|
|
32
|
+
npm test
|
|
33
|
+
python -m compileall -q packages/core/skills/deep-research/scripts
|
|
34
|
+
python -m compileall -q packages/core/skills/_shared/scripts
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Core `prepack` materializes the pinned installed Superpowers dependency into an ignored package-local directory for npm packing; `postpack` removes only that marked materialized copy. Never commit a duplicate Superpowers source tree. Run `npm run pack:all` and `npm run test:packed` for asset and clean-room changes.
|
|
38
|
+
|
|
39
|
+
## Release
|
|
40
|
+
|
|
41
|
+
Core and all hosts share one exact version. Every release builds, tests, packs, and publishes all four packages. Core is published first, followed sequentially by OpenCode, Codex, and DSH:
|
|
42
|
+
|
|
43
|
+
`@omagents/core → @omagents/omagents → @omagents/omagents-codex → @omagents/omagents-dsh`
|
|
44
|
+
|
|
45
|
+
Do not add dependencies between host packages. Versioning, publication, and Git mutations require explicit user authorization.
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
import path from "node:path"
|
|
4
|
+
import { pathToFileURL } from "node:url"
|
|
5
|
+
import { ensureProjectEnvironment, runProjectPip, runProjectPython } from "./python-env.js"
|
|
6
|
+
|
|
7
|
+
const USAGE = "Usage: project-venv.js <ensure|python|pip|run> --root <dir> [-- <args...>]"
|
|
8
|
+
|
|
9
|
+
function parseArguments(argv) {
|
|
10
|
+
const [command, ...rest] = argv
|
|
11
|
+
if (!["ensure", "python", "pip", "run"].includes(command)) {
|
|
12
|
+
throw new Error(USAGE)
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
const separator = rest.indexOf("--")
|
|
16
|
+
const options = separator === -1 ? rest : rest.slice(0, separator)
|
|
17
|
+
const args = separator === -1 ? [] : rest.slice(separator + 1)
|
|
18
|
+
if (options.length !== 2 || options[0] !== "--root" || !options[1]) {
|
|
19
|
+
throw new Error(`--root <dir> is required. ${USAGE}`)
|
|
20
|
+
}
|
|
21
|
+
if (["ensure", "python"].includes(command) && separator !== -1) {
|
|
22
|
+
throw new Error(`${command} does not accept trailing arguments. ${USAGE}`)
|
|
23
|
+
}
|
|
24
|
+
if (["pip", "run"].includes(command) && (separator === -1 || args.length === 0)) {
|
|
25
|
+
throw new Error(`${command} requires arguments after --. ${USAGE}`)
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
return { command, projectRoot: options[1], args }
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export async function main(argv, dependencies = {}) {
|
|
32
|
+
const stdout = dependencies.stdout || ((line) => process.stdout.write(`${line}\n`))
|
|
33
|
+
const stderr = dependencies.stderr || ((line) => process.stderr.write(`${line}\n`))
|
|
34
|
+
let parsed
|
|
35
|
+
try {
|
|
36
|
+
parsed = parseArguments(argv)
|
|
37
|
+
} catch (error) {
|
|
38
|
+
stderr(error.message)
|
|
39
|
+
return 1
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
const logger = dependencies.logger || ((message) => stderr(message))
|
|
43
|
+
const options = { projectRoot: parsed.projectRoot, logger }
|
|
44
|
+
|
|
45
|
+
try {
|
|
46
|
+
if (parsed.command === "ensure" || parsed.command === "python") {
|
|
47
|
+
const ensure = dependencies.ensureProjectEnvironment || ensureProjectEnvironment
|
|
48
|
+
const project = await ensure(options)
|
|
49
|
+
stdout(
|
|
50
|
+
parsed.command === "ensure" ? `${project.status} ${project.pythonPath}` : project.pythonPath
|
|
51
|
+
)
|
|
52
|
+
return 0
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
if (parsed.command === "pip") {
|
|
56
|
+
const run = dependencies.runProjectPip || runProjectPip
|
|
57
|
+
const result = await run({ ...options, args: parsed.args })
|
|
58
|
+
return result.code
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
const run = dependencies.runProjectPython || runProjectPython
|
|
62
|
+
const result = await run({ ...options, args: parsed.args })
|
|
63
|
+
return result.code
|
|
64
|
+
} catch (error) {
|
|
65
|
+
stderr(error.message)
|
|
66
|
+
return 1
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
const isDirect =
|
|
71
|
+
process.argv[1] && import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href
|
|
72
|
+
if (isDirect) {
|
|
73
|
+
process.exitCode = await main(process.argv.slice(2))
|
|
74
|
+
}
|
|
@@ -0,0 +1,283 @@
|
|
|
1
|
+
import fs from "node:fs"
|
|
2
|
+
import os from "node:os"
|
|
3
|
+
import path from "node:path"
|
|
4
|
+
import { spawn } from "node:child_process"
|
|
5
|
+
|
|
6
|
+
const IS_WIN = process.platform === "win32"
|
|
7
|
+
const VENV_BIN = IS_WIN ? "Scripts" : "bin"
|
|
8
|
+
const PYTHON_CMD = IS_WIN ? "python" : "python3"
|
|
9
|
+
|
|
10
|
+
export const AGENT_VENV = path.join(os.homedir(), ".venvs", "omagents")
|
|
11
|
+
export const AGENT_VENV_BIN = path.join(AGENT_VENV, VENV_BIN)
|
|
12
|
+
export const CORE_PYTHON_PACKAGES = Object.freeze([
|
|
13
|
+
Object.freeze({ requirement: "jinja2", importName: "jinja2" }),
|
|
14
|
+
])
|
|
15
|
+
|
|
16
|
+
const PYTHON_PROBE = [
|
|
17
|
+
"import json, sys, sysconfig",
|
|
18
|
+
"print(json.dumps({",
|
|
19
|
+
' "version": ".".join(str(part) for part in sys.version_info[:3]),',
|
|
20
|
+
' "majorMinor": ".".join(str(part) for part in sys.version_info[:2]),',
|
|
21
|
+
' "prefix": sys.prefix,',
|
|
22
|
+
' "basePrefix": sys.base_prefix,',
|
|
23
|
+
' "purelib": sysconfig.get_path("purelib"),',
|
|
24
|
+
' "platlib": sysconfig.get_path("platlib"),',
|
|
25
|
+
' "sysPath": sys.path,',
|
|
26
|
+
"}))",
|
|
27
|
+
].join("\n")
|
|
28
|
+
|
|
29
|
+
export function getVenvPython(venvPath, platform = process.platform) {
|
|
30
|
+
if (platform === "win32") {
|
|
31
|
+
return path.win32.join(venvPath, "Scripts", "python.exe")
|
|
32
|
+
}
|
|
33
|
+
return path.join(venvPath, "bin", "python")
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
export function getProjectVenvPath(projectRoot) {
|
|
37
|
+
return path.join(path.resolve(projectRoot), ".omagents", "venv")
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
export function defaultRunner(command, args, options = {}) {
|
|
41
|
+
return new Promise((resolve, reject) => {
|
|
42
|
+
const inherit = options.stdio === "inherit"
|
|
43
|
+
const child = spawn(command, args, {
|
|
44
|
+
cwd: options.cwd,
|
|
45
|
+
env: options.env || process.env,
|
|
46
|
+
stdio: inherit ? "inherit" : ["pipe", "pipe", "pipe"],
|
|
47
|
+
windowsHide: true,
|
|
48
|
+
})
|
|
49
|
+
let stdout = ""
|
|
50
|
+
let stderr = ""
|
|
51
|
+
|
|
52
|
+
child.stdout?.setEncoding("utf8")
|
|
53
|
+
child.stderr?.setEncoding("utf8")
|
|
54
|
+
child.stdout?.on("data", (chunk) => {
|
|
55
|
+
stdout += chunk
|
|
56
|
+
})
|
|
57
|
+
child.stderr?.on("data", (chunk) => {
|
|
58
|
+
stderr += chunk
|
|
59
|
+
})
|
|
60
|
+
child.on("error", reject)
|
|
61
|
+
child.on("close", (code) => {
|
|
62
|
+
resolve({ code: code ?? 1, stdout, stderr })
|
|
63
|
+
})
|
|
64
|
+
})
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
function failureDetail(result) {
|
|
68
|
+
return result.stderr.trim() || result.stdout.trim() || `exit code ${result.code}`
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
function assertSupportedPython(info, pythonPath) {
|
|
72
|
+
const [major, minor] = info.majorMinor.split(".").map(Number)
|
|
73
|
+
if (major < 3 || (major === 3 && minor < 11)) {
|
|
74
|
+
throw new Error(`Python 3.11+ is required; ${pythonPath} reports ${info.version}`)
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
export async function inspectPython(
|
|
79
|
+
pythonPath,
|
|
80
|
+
{ runner = defaultRunner, env = process.env, cwd = process.cwd() } = {}
|
|
81
|
+
) {
|
|
82
|
+
const result = await runner(pythonPath, ["-I", "-c", PYTHON_PROBE], { env, cwd })
|
|
83
|
+
if (result.code !== 0) {
|
|
84
|
+
throw new Error(`Unable to inspect Python at ${pythonPath}: ${failureDetail(result)}`)
|
|
85
|
+
}
|
|
86
|
+
try {
|
|
87
|
+
return JSON.parse(result.stdout)
|
|
88
|
+
} catch (error) {
|
|
89
|
+
throw new Error(`Unable to parse Python inspection from ${pythonPath}: ${error.message}`)
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
export async function ensureBaseEnvironment({
|
|
94
|
+
venvPath = AGENT_VENV,
|
|
95
|
+
pythonCommand = PYTHON_CMD,
|
|
96
|
+
runner = defaultRunner,
|
|
97
|
+
corePackages = CORE_PYTHON_PACKAGES,
|
|
98
|
+
withPip = true,
|
|
99
|
+
logger = () => {},
|
|
100
|
+
env = process.env,
|
|
101
|
+
cwd = process.cwd(),
|
|
102
|
+
} = {}) {
|
|
103
|
+
const pythonPath = getVenvPython(venvPath)
|
|
104
|
+
let status = "reused"
|
|
105
|
+
|
|
106
|
+
if (!fs.existsSync(pythonPath)) {
|
|
107
|
+
const systemInfo = await inspectPython(pythonCommand, { runner, env, cwd })
|
|
108
|
+
assertSupportedPython(systemInfo, pythonCommand)
|
|
109
|
+
const args = ["-I", "-m", "venv", ...(withPip ? [] : ["--without-pip"]), venvPath]
|
|
110
|
+
const created = await runner(pythonCommand, args, { env, cwd })
|
|
111
|
+
if (created.code !== 0) {
|
|
112
|
+
throw new Error(`Unable to create Python venv at ${venvPath}: ${failureDetail(created)}`)
|
|
113
|
+
}
|
|
114
|
+
status = "created"
|
|
115
|
+
logger(`Created Python venv at ${venvPath}`)
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
const info = await inspectPython(pythonPath, { runner, env, cwd })
|
|
119
|
+
assertSupportedPython(info, pythonPath)
|
|
120
|
+
const installed = []
|
|
121
|
+
const skipped = []
|
|
122
|
+
|
|
123
|
+
for (const pkg of corePackages) {
|
|
124
|
+
const imported = await runner(pythonPath, ["-I", "-c", `import ${pkg.importName}`], {
|
|
125
|
+
env,
|
|
126
|
+
cwd,
|
|
127
|
+
})
|
|
128
|
+
if (imported.code === 0) {
|
|
129
|
+
skipped.push(pkg.requirement)
|
|
130
|
+
continue
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
logger(`Installing ${pkg.requirement} into ${venvPath}`)
|
|
134
|
+
const result = await runner(pythonPath, ["-I", "-m", "pip", "install", pkg.requirement], {
|
|
135
|
+
env,
|
|
136
|
+
cwd,
|
|
137
|
+
})
|
|
138
|
+
if (result.code !== 0) {
|
|
139
|
+
throw new Error(`Unable to install ${pkg.requirement}: ${failureDetail(result)}`)
|
|
140
|
+
}
|
|
141
|
+
installed.push(pkg.requirement)
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
if (status === "reused") logger(`Reused Python venv at ${venvPath}`)
|
|
145
|
+
return { status, venvPath, pythonPath, installed, skipped, info }
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
function writeFileIfChanged(filePath, content) {
|
|
149
|
+
if (fs.existsSync(filePath) && fs.readFileSync(filePath, "utf8") === content) return false
|
|
150
|
+
fs.mkdirSync(path.dirname(filePath), { recursive: true })
|
|
151
|
+
fs.writeFileSync(filePath, content, "utf8")
|
|
152
|
+
return true
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
function baseSitePackages(info) {
|
|
156
|
+
return [...new Set([info.purelib, info.platlib].filter(Boolean))]
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
function overlayContent(sitePackages) {
|
|
160
|
+
return (
|
|
161
|
+
sitePackages
|
|
162
|
+
.map(
|
|
163
|
+
(sitePackage) =>
|
|
164
|
+
`import os, site; os.environ.get("OMAGENTS_PROJECT_ONLY") != "1" and site.addsitedir(${JSON.stringify(sitePackage)})`
|
|
165
|
+
)
|
|
166
|
+
.join("\n") + "\n"
|
|
167
|
+
)
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
export async function ensureProjectEnvironment({
|
|
171
|
+
projectRoot,
|
|
172
|
+
baseVenvPath = AGENT_VENV,
|
|
173
|
+
pythonCommand = PYTHON_CMD,
|
|
174
|
+
runner = defaultRunner,
|
|
175
|
+
corePackages = CORE_PYTHON_PACKAGES,
|
|
176
|
+
withPip = true,
|
|
177
|
+
logger = () => {},
|
|
178
|
+
env = process.env,
|
|
179
|
+
cwd = process.cwd(),
|
|
180
|
+
}) {
|
|
181
|
+
const internalEnv = { ...env }
|
|
182
|
+
delete internalEnv.OMAGENTS_PROJECT_ONLY
|
|
183
|
+
const resolvedRoot = path.resolve(projectRoot)
|
|
184
|
+
if (!fs.existsSync(resolvedRoot) || !fs.statSync(resolvedRoot).isDirectory()) {
|
|
185
|
+
throw new Error(`Project root is not an existing directory: ${resolvedRoot}`)
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
const base = await ensureBaseEnvironment({
|
|
189
|
+
venvPath: baseVenvPath,
|
|
190
|
+
pythonCommand,
|
|
191
|
+
runner,
|
|
192
|
+
corePackages,
|
|
193
|
+
withPip,
|
|
194
|
+
logger,
|
|
195
|
+
env: internalEnv,
|
|
196
|
+
cwd,
|
|
197
|
+
})
|
|
198
|
+
const venvPath = getProjectVenvPath(resolvedRoot)
|
|
199
|
+
const pythonPath = getVenvPython(venvPath)
|
|
200
|
+
let status = "reused"
|
|
201
|
+
|
|
202
|
+
if (!fs.existsSync(pythonPath)) {
|
|
203
|
+
const args = ["-I", "-m", "venv", ...(withPip ? [] : ["--without-pip"]), venvPath]
|
|
204
|
+
const created = await runner(base.pythonPath, args, { env: internalEnv, cwd })
|
|
205
|
+
if (created.code !== 0) {
|
|
206
|
+
throw new Error(`Unable to create project venv at ${venvPath}: ${failureDetail(created)}`)
|
|
207
|
+
}
|
|
208
|
+
status = "created"
|
|
209
|
+
logger(`Created project venv at ${venvPath}`)
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
const inspected = await inspectPython(pythonPath, { runner, env: internalEnv, cwd })
|
|
213
|
+
if (inspected.majorMinor !== base.info.majorMinor) {
|
|
214
|
+
throw new Error(
|
|
215
|
+
`Python version mismatch: base uses ${base.info.majorMinor}, project uses ${inspected.majorMinor}; ` +
|
|
216
|
+
`repair ${venvPath} explicitly before retrying`
|
|
217
|
+
)
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
const sitePackages = baseSitePackages(base.info)
|
|
221
|
+
writeFileIfChanged(
|
|
222
|
+
path.join(inspected.purelib, "omagents-base.pth"),
|
|
223
|
+
overlayContent(sitePackages)
|
|
224
|
+
)
|
|
225
|
+
writeFileIfChanged(path.join(venvPath, ".gitignore"), "*\n")
|
|
226
|
+
const metadata = {
|
|
227
|
+
schemaVersion: 1,
|
|
228
|
+
baseVenv: base.venvPath,
|
|
229
|
+
basePython: base.pythonPath,
|
|
230
|
+
pythonMajorMinor: base.info.majorMinor,
|
|
231
|
+
baseSitePackages: sitePackages,
|
|
232
|
+
}
|
|
233
|
+
writeFileIfChanged(
|
|
234
|
+
path.join(venvPath, ".omagents-python.json"),
|
|
235
|
+
`${JSON.stringify(metadata, null, 2)}\n`
|
|
236
|
+
)
|
|
237
|
+
|
|
238
|
+
const info = await inspectPython(pythonPath, { runner, env: internalEnv, cwd })
|
|
239
|
+
for (const sitePackage of sitePackages) {
|
|
240
|
+
if (!info.sysPath.includes(sitePackage)) {
|
|
241
|
+
throw new Error(`Project overlay did not add base site-packages: ${sitePackage}`)
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
if (status === "reused") logger(`Reused project venv at ${venvPath}`)
|
|
246
|
+
return { status, projectRoot: resolvedRoot, venvPath, pythonPath, base, info }
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
export async function runProjectPip(options) {
|
|
250
|
+
const {
|
|
251
|
+
args,
|
|
252
|
+
env = process.env,
|
|
253
|
+
cwd = process.cwd(),
|
|
254
|
+
runner = defaultRunner,
|
|
255
|
+
...projectOptions
|
|
256
|
+
} = options
|
|
257
|
+
const project = await ensureProjectEnvironment({ ...projectOptions, runner, env, cwd })
|
|
258
|
+
const result = await runner(project.pythonPath, ["-I", "-m", "pip", ...args], {
|
|
259
|
+
env: { ...env, OMAGENTS_PROJECT_ONLY: "1" },
|
|
260
|
+
cwd,
|
|
261
|
+
stdio: "inherit",
|
|
262
|
+
})
|
|
263
|
+
return { code: result.code, project }
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
export async function runProjectPython(options) {
|
|
267
|
+
const {
|
|
268
|
+
args,
|
|
269
|
+
env = process.env,
|
|
270
|
+
cwd = process.cwd(),
|
|
271
|
+
runner = defaultRunner,
|
|
272
|
+
...projectOptions
|
|
273
|
+
} = options
|
|
274
|
+
const project = await ensureProjectEnvironment({ ...projectOptions, runner, env, cwd })
|
|
275
|
+
const childEnv = { ...env }
|
|
276
|
+
delete childEnv.OMAGENTS_PROJECT_ONLY
|
|
277
|
+
const result = await runner(project.pythonPath, args, {
|
|
278
|
+
env: childEnv,
|
|
279
|
+
cwd,
|
|
280
|
+
stdio: "inherit",
|
|
281
|
+
})
|
|
282
|
+
return { code: result.code, project }
|
|
283
|
+
}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* OmAgents venv setup hook (cross-platform).
|
|
4
|
+
*
|
|
5
|
+
* Creates ~/.venvs/omagents if missing, installs jinja2, and copies
|
|
6
|
+
* skill helper scripts into the venv. Called by Codex SessionStart hooks
|
|
7
|
+
* and OpenCode session.created.
|
|
8
|
+
*
|
|
9
|
+
* Outputs {} to stdout (Codex requires JSON), messages to stderr.
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
import fs from "fs"
|
|
13
|
+
import path from "path"
|
|
14
|
+
import { fileURLToPath } from "url"
|
|
15
|
+
import { ensureBaseEnvironment } from "./python-env.js"
|
|
16
|
+
|
|
17
|
+
const __dirname = path.dirname(fileURLToPath(import.meta.url))
|
|
18
|
+
|
|
19
|
+
function log(msg) {
|
|
20
|
+
process.stderr.write(`[omagents] ${msg}\n`)
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
async function run() {
|
|
24
|
+
try {
|
|
25
|
+
const result = await ensureBaseEnvironment({ logger: log })
|
|
26
|
+
for (const requirement of result.installed) log(`Installed ${requirement}`)
|
|
27
|
+
|
|
28
|
+
// Copy skill helper scripts into the venv
|
|
29
|
+
const skillsDir = path.resolve(__dirname, "..", "skills")
|
|
30
|
+
if (fs.existsSync(skillsDir)) {
|
|
31
|
+
const destScripts = path.join(result.venvPath, "scripts")
|
|
32
|
+
fs.mkdirSync(destScripts, { recursive: true })
|
|
33
|
+
for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
|
|
34
|
+
if (!entry.isDirectory()) continue
|
|
35
|
+
const srcScripts = path.join(skillsDir, entry.name, "scripts")
|
|
36
|
+
if (fs.existsSync(srcScripts)) {
|
|
37
|
+
for (const file of fs.readdirSync(srcScripts)) {
|
|
38
|
+
fs.copyFileSync(path.join(srcScripts, file), path.join(destScripts, file))
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
log(`venv ready at ${result.venvPath} (${result.status})`)
|
|
45
|
+
} catch (err) {
|
|
46
|
+
log(`venv setup failed: ${err.message}`)
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
run().finally(() => {
|
|
51
|
+
// Codex SessionStart hooks require JSON on stdout
|
|
52
|
+
process.stdout.write("{}")
|
|
53
|
+
})
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"agentmemory": {
|
|
3
|
+
"type": "local",
|
|
4
|
+
"command": ["npx", "-y", "@agentmemory/mcp"]
|
|
5
|
+
},
|
|
6
|
+
"codegraph": {
|
|
7
|
+
"type": "local",
|
|
8
|
+
"command": ["npx", "-y", "@colbymchenry/codegraph", "serve", "--mcp"]
|
|
9
|
+
},
|
|
10
|
+
"context7": {
|
|
11
|
+
"type": "remote",
|
|
12
|
+
"url": "https://mcp.context7.com/mcp"
|
|
13
|
+
},
|
|
14
|
+
"websearch": {
|
|
15
|
+
"type": "remote",
|
|
16
|
+
"url": "https://mcp.exa.ai/mcp"
|
|
17
|
+
}
|
|
18
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "superpowers-dev",
|
|
3
|
+
"interface": {
|
|
4
|
+
"displayName": "Superpowers Dev"
|
|
5
|
+
},
|
|
6
|
+
"plugins": [
|
|
7
|
+
{
|
|
8
|
+
"name": "superpowers",
|
|
9
|
+
"source": {
|
|
10
|
+
"source": "url",
|
|
11
|
+
"url": "./"
|
|
12
|
+
},
|
|
13
|
+
"policy": {
|
|
14
|
+
"installation": "AVAILABLE",
|
|
15
|
+
"authentication": "ON_INSTALL"
|
|
16
|
+
},
|
|
17
|
+
"category": "Developer Tools"
|
|
18
|
+
}
|
|
19
|
+
]
|
|
20
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "superpowers-dev",
|
|
3
|
+
"description": "Development marketplace for Superpowers core skills library",
|
|
4
|
+
"owner": {
|
|
5
|
+
"name": "Jesse Vincent",
|
|
6
|
+
"email": "jesse@fsck.com"
|
|
7
|
+
},
|
|
8
|
+
"plugins": [
|
|
9
|
+
{
|
|
10
|
+
"name": "superpowers",
|
|
11
|
+
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
|
|
12
|
+
"version": "6.4.2",
|
|
13
|
+
"source": "./",
|
|
14
|
+
"author": {
|
|
15
|
+
"name": "Jesse Vincent",
|
|
16
|
+
"email": "jesse@fsck.com"
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
]
|
|
20
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "superpowers",
|
|
3
|
+
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
|
|
4
|
+
"version": "6.4.2",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "Jesse Vincent",
|
|
7
|
+
"email": "jesse@fsck.com"
|
|
8
|
+
},
|
|
9
|
+
"homepage": "https://github.com/obra/superpowers",
|
|
10
|
+
"repository": "https://github.com/obra/superpowers",
|
|
11
|
+
"license": "MIT",
|
|
12
|
+
"keywords": [
|
|
13
|
+
"skills",
|
|
14
|
+
"tdd",
|
|
15
|
+
"debugging",
|
|
16
|
+
"collaboration",
|
|
17
|
+
"best-practices",
|
|
18
|
+
"workflows"
|
|
19
|
+
]
|
|
20
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "superpowers",
|
|
3
|
+
"version": "6.4.2",
|
|
4
|
+
"description": "An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "Jesse Vincent",
|
|
7
|
+
"email": "jesse@fsck.com",
|
|
8
|
+
"url": "https://github.com/obra"
|
|
9
|
+
},
|
|
10
|
+
"homepage": "https://github.com/obra/superpowers",
|
|
11
|
+
"repository": "https://github.com/obra/superpowers",
|
|
12
|
+
"license": "MIT",
|
|
13
|
+
"keywords": [
|
|
14
|
+
"brainstorming",
|
|
15
|
+
"subagent-driven-development",
|
|
16
|
+
"skills",
|
|
17
|
+
"planning",
|
|
18
|
+
"tdd",
|
|
19
|
+
"debugging",
|
|
20
|
+
"code-review",
|
|
21
|
+
"workflow"
|
|
22
|
+
],
|
|
23
|
+
"skills": "./skills/",
|
|
24
|
+
"hooks": {},
|
|
25
|
+
"interface": {
|
|
26
|
+
"displayName": "Superpowers",
|
|
27
|
+
"shortDescription": "Planning, TDD, debugging, and delivery workflows for coding agents",
|
|
28
|
+
"longDescription": "Use Superpowers to guide agent work through brainstorming, implementation planning, test-driven development, systematic debugging, parallel execution, code review, and finish-the-branch workflows.",
|
|
29
|
+
"developerName": "Jesse Vincent",
|
|
30
|
+
"category": "Developer Tools",
|
|
31
|
+
"capabilities": [
|
|
32
|
+
"Interactive",
|
|
33
|
+
"Read",
|
|
34
|
+
"Write"
|
|
35
|
+
],
|
|
36
|
+
"defaultPrompt": [
|
|
37
|
+
"I've got an idea for something I'd like to build.",
|
|
38
|
+
"Let's add a feature to this project."
|
|
39
|
+
],
|
|
40
|
+
"websiteURL": "https://github.com/obra/superpowers",
|
|
41
|
+
"privacyPolicyURL": "https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement",
|
|
42
|
+
"termsOfServiceURL": "https://docs.github.com/en/site-policy/github-terms/github-terms-of-service",
|
|
43
|
+
"brandColor": "#F59E0B",
|
|
44
|
+
"composerIcon": "./assets/superpowers-small.svg",
|
|
45
|
+
"logo": "./assets/app-icon.png",
|
|
46
|
+
"screenshots": []
|
|
47
|
+
}
|
|
48
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "superpowers",
|
|
3
|
+
"displayName": "Superpowers",
|
|
4
|
+
"description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques",
|
|
5
|
+
"version": "6.4.2",
|
|
6
|
+
"author": {
|
|
7
|
+
"name": "Jesse Vincent",
|
|
8
|
+
"email": "jesse@fsck.com"
|
|
9
|
+
},
|
|
10
|
+
"homepage": "https://github.com/obra/superpowers",
|
|
11
|
+
"repository": "https://github.com/obra/superpowers",
|
|
12
|
+
"license": "MIT",
|
|
13
|
+
"keywords": [
|
|
14
|
+
"skills",
|
|
15
|
+
"tdd",
|
|
16
|
+
"debugging",
|
|
17
|
+
"collaboration",
|
|
18
|
+
"best-practices",
|
|
19
|
+
"workflows"
|
|
20
|
+
],
|
|
21
|
+
"skills": "./skills/",
|
|
22
|
+
"hooks": "./hooks/hooks-cursor.json"
|
|
23
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "superpowers",
|
|
3
|
+
"version": "6.4.2",
|
|
4
|
+
"description": "An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "Jesse Vincent",
|
|
7
|
+
"email": "jesse@fsck.com"
|
|
8
|
+
},
|
|
9
|
+
"homepage": "https://github.com/obra/superpowers",
|
|
10
|
+
"repository": "https://github.com/obra/superpowers",
|
|
11
|
+
"license": "MIT",
|
|
12
|
+
"keywords": [
|
|
13
|
+
"brainstorming",
|
|
14
|
+
"subagent-driven-development",
|
|
15
|
+
"skills",
|
|
16
|
+
"planning",
|
|
17
|
+
"tdd",
|
|
18
|
+
"debugging",
|
|
19
|
+
"code-review",
|
|
20
|
+
"workflow"
|
|
21
|
+
]
|
|
22
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Ensure shell scripts always have LF line endings
|
|
2
|
+
*.sh text eol=lf
|
|
3
|
+
hooks/session-start text eol=lf
|
|
4
|
+
|
|
5
|
+
# Ensure the polyglot wrapper keeps LF (it's parsed by both cmd and bash)
|
|
6
|
+
*.cmd text eol=lf
|
|
7
|
+
|
|
8
|
+
# Common text files
|
|
9
|
+
*.md text eol=lf
|
|
10
|
+
*.json text eol=lf
|
|
11
|
+
*.js text eol=lf
|
|
12
|
+
*.mjs text eol=lf
|
|
13
|
+
*.ts text eol=lf
|
|
14
|
+
|
|
15
|
+
# Explicitly mark binary files
|
|
16
|
+
*.png binary
|
|
17
|
+
*.jpg binary
|
|
18
|
+
*.gif binary
|