@mengde1231/rudder 0.5.3
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/LICENSE +235 -0
- package/README.md +136 -0
- package/bin/rudder.js +3 -0
- package/dist/cli/index.d.ts +3 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +132 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/commands/init.d.ts +57 -0
- package/dist/commands/init.d.ts.map +1 -0
- package/dist/commands/init.js +1465 -0
- package/dist/commands/init.js.map +1 -0
- package/dist/commands/uninstall.d.ts +27 -0
- package/dist/commands/uninstall.d.ts.map +1 -0
- package/dist/commands/uninstall.js +322 -0
- package/dist/commands/uninstall.js.map +1 -0
- package/dist/commands/update.d.ts +72 -0
- package/dist/commands/update.d.ts.map +1 -0
- package/dist/commands/update.js +1911 -0
- package/dist/commands/update.js.map +1 -0
- package/dist/configurators/antigravity.d.ts +7 -0
- package/dist/configurators/antigravity.d.ts.map +1 -0
- package/dist/configurators/antigravity.js +19 -0
- package/dist/configurators/antigravity.js.map +1 -0
- package/dist/configurators/claude.d.ts +9 -0
- package/dist/configurators/claude.d.ts.map +1 -0
- package/dist/configurators/claude.js +69 -0
- package/dist/configurators/claude.js.map +1 -0
- package/dist/configurators/codebuddy.d.ts +10 -0
- package/dist/configurators/codebuddy.d.ts.map +1 -0
- package/dist/configurators/codebuddy.js +30 -0
- package/dist/configurators/codebuddy.js.map +1 -0
- package/dist/configurators/codex.d.ts +8 -0
- package/dist/configurators/codex.d.ts.map +1 -0
- package/dist/configurators/codex.js +85 -0
- package/dist/configurators/codex.js.map +1 -0
- package/dist/configurators/copilot.d.ts +10 -0
- package/dist/configurators/copilot.d.ts.map +1 -0
- package/dist/configurators/copilot.js +51 -0
- package/dist/configurators/copilot.js.map +1 -0
- package/dist/configurators/cursor.d.ts +10 -0
- package/dist/configurators/cursor.d.ts.map +1 -0
- package/dist/configurators/cursor.js +29 -0
- package/dist/configurators/cursor.js.map +1 -0
- package/dist/configurators/droid.d.ts +10 -0
- package/dist/configurators/droid.d.ts.map +1 -0
- package/dist/configurators/droid.js +30 -0
- package/dist/configurators/droid.js.map +1 -0
- package/dist/configurators/gemini.d.ts +16 -0
- package/dist/configurators/gemini.d.ts.map +1 -0
- package/dist/configurators/gemini.js +38 -0
- package/dist/configurators/gemini.js.map +1 -0
- package/dist/configurators/index.d.ts +65 -0
- package/dist/configurators/index.d.ts.map +1 -0
- package/dist/configurators/index.js +367 -0
- package/dist/configurators/index.js.map +1 -0
- package/dist/configurators/kilo.d.ts +7 -0
- package/dist/configurators/kilo.d.ts.map +1 -0
- package/dist/configurators/kilo.js +19 -0
- package/dist/configurators/kilo.js.map +1 -0
- package/dist/configurators/kiro.d.ts +8 -0
- package/dist/configurators/kiro.d.ts.map +1 -0
- package/dist/configurators/kiro.js +24 -0
- package/dist/configurators/kiro.js.map +1 -0
- package/dist/configurators/opencode.d.ts +14 -0
- package/dist/configurators/opencode.d.ts.map +1 -0
- package/dist/configurators/opencode.js +96 -0
- package/dist/configurators/opencode.js.map +1 -0
- package/dist/configurators/pi.d.ts +3 -0
- package/dist/configurators/pi.d.ts.map +1 -0
- package/dist/configurators/pi.js +45 -0
- package/dist/configurators/pi.js.map +1 -0
- package/dist/configurators/qoder.d.ts +11 -0
- package/dist/configurators/qoder.d.ts.map +1 -0
- package/dist/configurators/qoder.js +31 -0
- package/dist/configurators/qoder.js.map +1 -0
- package/dist/configurators/shared.d.ts +178 -0
- package/dist/configurators/shared.d.ts.map +1 -0
- package/dist/configurators/shared.js +546 -0
- package/dist/configurators/shared.js.map +1 -0
- package/dist/configurators/windsurf.d.ts +7 -0
- package/dist/configurators/windsurf.d.ts.map +1 -0
- package/dist/configurators/windsurf.js +19 -0
- package/dist/configurators/windsurf.js.map +1 -0
- package/dist/configurators/workflow.d.ts +34 -0
- package/dist/configurators/workflow.d.ts.map +1 -0
- package/dist/configurators/workflow.js +178 -0
- package/dist/configurators/workflow.js.map +1 -0
- package/dist/constants/paths.d.ts +70 -0
- package/dist/constants/paths.d.ts.map +1 -0
- package/dist/constants/paths.js +79 -0
- package/dist/constants/paths.js.map +1 -0
- package/dist/constants/version.d.ts +9 -0
- package/dist/constants/version.d.ts.map +1 -0
- package/dist/constants/version.js +15 -0
- package/dist/constants/version.js.map +1 -0
- package/dist/index.d.ts +9 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +9 -0
- package/dist/index.js.map +1 -0
- package/dist/migrations/index.d.ts +62 -0
- package/dist/migrations/index.d.ts.map +1 -0
- package/dist/migrations/index.js +187 -0
- package/dist/migrations/index.js.map +1 -0
- package/dist/migrations/manifests/0.1.9.json +30 -0
- package/dist/migrations/manifests/0.2.0.json +49 -0
- package/dist/migrations/manifests/0.2.12.json +9 -0
- package/dist/migrations/manifests/0.2.13.json +9 -0
- package/dist/migrations/manifests/0.2.14.json +175 -0
- package/dist/migrations/manifests/0.2.15.json +33 -0
- package/dist/migrations/manifests/0.3.0-beta.0.json +297 -0
- package/dist/migrations/manifests/0.3.0-beta.1.json +9 -0
- package/dist/migrations/manifests/0.3.0-beta.10.json +9 -0
- package/dist/migrations/manifests/0.3.0-beta.11.json +9 -0
- package/dist/migrations/manifests/0.3.0-beta.12.json +9 -0
- package/dist/migrations/manifests/0.3.0-beta.13.json +9 -0
- package/dist/migrations/manifests/0.3.0-beta.14.json +9 -0
- package/dist/migrations/manifests/0.3.0-beta.15.json +9 -0
- package/dist/migrations/manifests/0.3.0-beta.16.json +9 -0
- package/dist/migrations/manifests/0.3.0-beta.2.json +9 -0
- package/dist/migrations/manifests/0.3.0-beta.3.json +9 -0
- package/dist/migrations/manifests/0.3.0-beta.4.json +9 -0
- package/dist/migrations/manifests/0.3.0-beta.5.json +9 -0
- package/dist/migrations/manifests/0.3.0-beta.6.json +9 -0
- package/dist/migrations/manifests/0.3.0-beta.7.json +11 -0
- package/dist/migrations/manifests/0.3.0-beta.8.json +9 -0
- package/dist/migrations/manifests/0.3.0-beta.9.json +9 -0
- package/dist/migrations/manifests/0.3.0-rc.0.json +9 -0
- package/dist/migrations/manifests/0.3.0-rc.1.json +9 -0
- package/dist/migrations/manifests/0.3.0-rc.2.json +9 -0
- package/dist/migrations/manifests/0.3.0-rc.3.json +9 -0
- package/dist/migrations/manifests/0.3.0-rc.4.json +9 -0
- package/dist/migrations/manifests/0.3.0-rc.5.json +9 -0
- package/dist/migrations/manifests/0.3.0-rc.6.json +9 -0
- package/dist/migrations/manifests/0.3.0.json +11 -0
- package/dist/migrations/manifests/0.3.1.json +9 -0
- package/dist/migrations/manifests/0.3.10.json +9 -0
- package/dist/migrations/manifests/0.3.2.json +9 -0
- package/dist/migrations/manifests/0.3.3.json +9 -0
- package/dist/migrations/manifests/0.3.4.json +21 -0
- package/dist/migrations/manifests/0.3.5.json +9 -0
- package/dist/migrations/manifests/0.3.6.json +9 -0
- package/dist/migrations/manifests/0.3.7.json +9 -0
- package/dist/migrations/manifests/0.3.8.json +9 -0
- package/dist/migrations/manifests/0.3.9.json +9 -0
- package/dist/migrations/manifests/0.4.0-beta.1.json +228 -0
- package/dist/migrations/manifests/0.4.0-beta.10.json +9 -0
- package/dist/migrations/manifests/0.4.0-beta.2.json +9 -0
- package/dist/migrations/manifests/0.4.0-beta.3.json +9 -0
- package/dist/migrations/manifests/0.4.0-beta.4.json +9 -0
- package/dist/migrations/manifests/0.4.0-beta.5.json +9 -0
- package/dist/migrations/manifests/0.4.0-beta.6.json +9 -0
- package/dist/migrations/manifests/0.4.0-beta.7.json +9 -0
- package/dist/migrations/manifests/0.4.0-beta.8.json +34 -0
- package/dist/migrations/manifests/0.4.0-beta.9.json +9 -0
- package/dist/migrations/manifests/0.4.0-rc.0.json +9 -0
- package/dist/migrations/manifests/0.4.0-rc.1.json +9 -0
- package/dist/migrations/manifests/0.4.0.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.0.json +1646 -0
- package/dist/migrations/manifests/0.5.0-beta.1.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.10.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.11.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.12.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.13.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.14.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.15.json +116 -0
- package/dist/migrations/manifests/0.5.0-beta.16.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.17.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.18.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.19.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.2.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.3.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.4.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.5.json +222 -0
- package/dist/migrations/manifests/0.5.0-beta.6.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.7.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.8.json +9 -0
- package/dist/migrations/manifests/0.5.0-beta.9.json +48 -0
- package/dist/migrations/manifests/0.5.0-rc.0.json +9 -0
- package/dist/migrations/manifests/0.5.0-rc.1.json +9 -0
- package/dist/migrations/manifests/0.5.0-rc.2.json +9 -0
- package/dist/migrations/manifests/0.5.0-rc.3.json +9 -0
- package/dist/migrations/manifests/0.5.0-rc.4.json +9 -0
- package/dist/migrations/manifests/0.5.0-rc.5.json +9 -0
- package/dist/migrations/manifests/0.5.0-rc.6.json +9 -0
- package/dist/migrations/manifests/0.5.0-rc.7.json +9 -0
- package/dist/migrations/manifests/0.5.0.json +9 -0
- package/dist/migrations/manifests/0.5.1.json +9 -0
- package/dist/migrations/manifests/0.5.10.json +9 -0
- package/dist/migrations/manifests/0.5.11.json +16 -0
- package/dist/migrations/manifests/0.5.12.json +9 -0
- package/dist/migrations/manifests/0.5.13.json +9 -0
- package/dist/migrations/manifests/0.5.2.json +9 -0
- package/dist/migrations/manifests/0.5.3.json +9 -0
- package/dist/migrations/manifests/0.5.4.json +9 -0
- package/dist/migrations/manifests/0.5.5.json +9 -0
- package/dist/migrations/manifests/0.5.6.json +9 -0
- package/dist/migrations/manifests/0.5.7.json +16 -0
- package/dist/migrations/manifests/0.5.8.json +9 -0
- package/dist/migrations/manifests/0.5.9.json +9 -0
- package/dist/migrations/manifests/0.6.0-beta.0.json +16 -0
- package/dist/migrations/manifests/0.6.0-beta.1.json +9 -0
- package/dist/migrations/manifests/0.6.0-beta.2.json +9 -0
- package/dist/migrations/manifests/0.6.0-beta.3.json +9 -0
- package/dist/migrations/manifests/0.6.0-beta.4.json +9 -0
- package/dist/migrations/manifests/0.6.0-beta.5.json +9 -0
- package/dist/migrations/manifests/0.6.0-beta.6.json +16 -0
- package/dist/migrations/manifests/0.6.0-beta.7.json +9 -0
- package/dist/migrations/manifests/0.6.0-beta.8.json +9 -0
- package/dist/templates/claude/agents/rudder-check.md +143 -0
- package/dist/templates/claude/agents/rudder-implement.md +109 -0
- package/dist/templates/claude/agents/rudder-research.md +137 -0
- package/dist/templates/claude/index.d.ts +22 -0
- package/dist/templates/claude/index.d.ts.map +1 -0
- package/dist/templates/claude/index.js +46 -0
- package/dist/templates/claude/index.js.map +1 -0
- package/dist/templates/claude/settings.json +73 -0
- package/dist/templates/codebuddy/agents/rudder-check.md +143 -0
- package/dist/templates/codebuddy/agents/rudder-implement.md +109 -0
- package/dist/templates/codebuddy/agents/rudder-research.md +137 -0
- package/dist/templates/codebuddy/index.d.ts +15 -0
- package/dist/templates/codebuddy/index.d.ts.map +1 -0
- package/dist/templates/codebuddy/index.js +15 -0
- package/dist/templates/codebuddy/index.js.map +1 -0
- package/dist/templates/codebuddy/settings.json +59 -0
- package/dist/templates/codex/agents/rudder-check.toml +91 -0
- package/dist/templates/codex/agents/rudder-implement.toml +65 -0
- package/dist/templates/codex/agents/rudder-research.toml +73 -0
- package/dist/templates/codex/config.toml +35 -0
- package/dist/templates/codex/hooks/session-start.py +459 -0
- package/dist/templates/codex/hooks.json +15 -0
- package/dist/templates/codex/index.d.ts +39 -0
- package/dist/templates/codex/index.d.ts.map +1 -0
- package/dist/templates/codex/index.js +85 -0
- package/dist/templates/codex/index.js.map +1 -0
- package/dist/templates/codex/skills/before-dev/SKILL.md +34 -0
- package/dist/templates/codex/skills/brainstorm/SKILL.md +500 -0
- package/dist/templates/codex/skills/break-loop/SKILL.md +130 -0
- package/dist/templates/codex/skills/check/SKILL.md +30 -0
- package/dist/templates/codex/skills/check-cross-layer/SKILL.md +158 -0
- package/dist/templates/codex/skills/create-command/SKILL.md +101 -0
- package/dist/templates/codex/skills/finish-work/SKILL.md +90 -0
- package/dist/templates/codex/skills/improve-ut/SKILL.md +69 -0
- package/dist/templates/codex/skills/integrate-skill/SKILL.md +221 -0
- package/dist/templates/codex/skills/onboard/SKILL.md +363 -0
- package/dist/templates/codex/skills/record-session/SKILL.md +67 -0
- package/dist/templates/codex/skills/start/SKILL.md +354 -0
- package/dist/templates/codex/skills/update-spec/SKILL.md +335 -0
- package/dist/templates/common/bundled-skills/rudder-meta/SKILL.md +73 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/add-project-local-conventions.md +83 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-agents.md +54 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-context-loading.md +81 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-hooks.md +57 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-skills-or-commands.md +78 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-spec-structure.md +83 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-task-lifecycle.md +90 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-workflow.md +64 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/overview.md +55 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/context-injection.md +68 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/generated-files.md +80 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/overview.md +51 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/spec-system.md +102 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/task-system.md +101 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/workflow.md +75 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/workspace-memory.md +71 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/agents.md +79 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/hooks-and-settings.md +69 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/overview.md +59 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/platform-map.md +74 -0
- package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/skills-and-commands.md +83 -0
- package/dist/templates/common/commands/continue.md +55 -0
- package/dist/templates/common/commands/finish-work.md +66 -0
- package/dist/templates/common/commands/start.md +58 -0
- package/dist/templates/common/index.d.ts +48 -0
- package/dist/templates/common/index.d.ts.map +1 -0
- package/dist/templates/common/index.js +104 -0
- package/dist/templates/common/index.js.map +1 -0
- package/dist/templates/common/skills/before-dev.md +29 -0
- package/dist/templates/common/skills/brainstorm.md +543 -0
- package/dist/templates/common/skills/break-loop.md +125 -0
- package/dist/templates/common/skills/check.md +87 -0
- package/dist/templates/common/skills/update-spec.md +351 -0
- package/dist/templates/copilot/hooks/session-start.py +430 -0
- package/dist/templates/copilot/hooks.json +19 -0
- package/dist/templates/copilot/index.d.ts +23 -0
- package/dist/templates/copilot/index.d.ts.map +1 -0
- package/dist/templates/copilot/index.js +54 -0
- package/dist/templates/copilot/index.js.map +1 -0
- package/dist/templates/copilot/prompts/before-dev.prompt.md +33 -0
- package/dist/templates/copilot/prompts/brainstorm.prompt.md +499 -0
- package/dist/templates/copilot/prompts/break-loop.prompt.md +129 -0
- package/dist/templates/copilot/prompts/check-cross-layer.prompt.md +157 -0
- package/dist/templates/copilot/prompts/check.prompt.md +29 -0
- package/dist/templates/copilot/prompts/create-command.prompt.md +116 -0
- package/dist/templates/copilot/prompts/finish-work.prompt.md +99 -0
- package/dist/templates/copilot/prompts/integrate-skill.prompt.md +223 -0
- package/dist/templates/copilot/prompts/onboard.prompt.md +362 -0
- package/dist/templates/copilot/prompts/parallel.prompt.md +196 -0
- package/dist/templates/copilot/prompts/record-session.prompt.md +66 -0
- package/dist/templates/copilot/prompts/start.prompt.md +397 -0
- package/dist/templates/copilot/prompts/update-spec.prompt.md +358 -0
- package/dist/templates/cursor/agents/rudder-check.md +142 -0
- package/dist/templates/cursor/agents/rudder-implement.md +108 -0
- package/dist/templates/cursor/agents/rudder-research.md +136 -0
- package/dist/templates/cursor/hooks.json +24 -0
- package/dist/templates/cursor/index.d.ts +13 -0
- package/dist/templates/cursor/index.d.ts.map +1 -0
- package/dist/templates/cursor/index.js +13 -0
- package/dist/templates/cursor/index.js.map +1 -0
- package/dist/templates/droid/droids/rudder-check.md +135 -0
- package/dist/templates/droid/droids/rudder-implement.md +101 -0
- package/dist/templates/droid/droids/rudder-research.md +137 -0
- package/dist/templates/droid/index.d.ts +15 -0
- package/dist/templates/droid/index.d.ts.map +1 -0
- package/dist/templates/droid/index.js +15 -0
- package/dist/templates/droid/index.js.map +1 -0
- package/dist/templates/droid/settings.json +59 -0
- package/dist/templates/extract.d.ts +40 -0
- package/dist/templates/extract.d.ts.map +1 -0
- package/dist/templates/extract.js +106 -0
- package/dist/templates/extract.js.map +1 -0
- package/dist/templates/gemini/agents/rudder-check.md +135 -0
- package/dist/templates/gemini/agents/rudder-implement.md +101 -0
- package/dist/templates/gemini/agents/rudder-research.md +136 -0
- package/dist/templates/gemini/index.d.ts +13 -0
- package/dist/templates/gemini/index.d.ts.map +1 -0
- package/dist/templates/gemini/index.js +13 -0
- package/dist/templates/gemini/index.js.map +1 -0
- package/dist/templates/gemini/settings.json +28 -0
- package/dist/templates/kiro/agents/rudder-check.json +26 -0
- package/dist/templates/kiro/agents/rudder-implement.json +26 -0
- package/dist/templates/kiro/agents/rudder-research.json +30 -0
- package/dist/templates/kiro/index.d.ts +18 -0
- package/dist/templates/kiro/index.d.ts.map +1 -0
- package/dist/templates/kiro/index.js +18 -0
- package/dist/templates/kiro/index.js.map +1 -0
- package/dist/templates/markdown/agents.md +21 -0
- package/dist/templates/markdown/gitignore.txt +15 -0
- package/dist/templates/markdown/index.d.ts +27 -0
- package/dist/templates/markdown/index.d.ts.map +1 -0
- package/dist/templates/markdown/index.js +52 -0
- package/dist/templates/markdown/index.js.map +1 -0
- package/dist/templates/markdown/spec/backend/database-guidelines.md.txt +51 -0
- package/dist/templates/markdown/spec/backend/directory-structure.md.txt +54 -0
- package/dist/templates/markdown/spec/backend/error-handling.md.txt +51 -0
- package/dist/templates/markdown/spec/backend/index.md.txt +38 -0
- package/dist/templates/markdown/spec/backend/logging-guidelines.md.txt +51 -0
- package/dist/templates/markdown/spec/backend/quality-guidelines.md.txt +51 -0
- package/dist/templates/markdown/spec/frontend/component-guidelines.md.txt +59 -0
- package/dist/templates/markdown/spec/frontend/directory-structure.md.txt +54 -0
- package/dist/templates/markdown/spec/frontend/hook-guidelines.md.txt +51 -0
- package/dist/templates/markdown/spec/frontend/index.md.txt +39 -0
- package/dist/templates/markdown/spec/frontend/quality-guidelines.md.txt +51 -0
- package/dist/templates/markdown/spec/frontend/state-management.md.txt +51 -0
- package/dist/templates/markdown/spec/frontend/type-safety.md.txt +51 -0
- package/dist/templates/markdown/spec/guides/code-reuse-thinking-guide.md.txt +105 -0
- package/dist/templates/markdown/spec/guides/cross-layer-thinking-guide.md.txt +162 -0
- package/dist/templates/markdown/spec/guides/cross-platform-thinking-guide.md.txt +595 -0
- package/dist/templates/markdown/spec/guides/index.md.txt +79 -0
- package/dist/templates/markdown/workspace-index.md +125 -0
- package/dist/templates/markdown/worktree.yaml.txt +58 -0
- package/dist/templates/opencode/agents/rudder-check.md +150 -0
- package/dist/templates/opencode/agents/rudder-implement.md +117 -0
- package/dist/templates/opencode/agents/rudder-research.md +145 -0
- package/dist/templates/opencode/lib/rudder-context.js +381 -0
- package/dist/templates/opencode/lib/session-utils.js +432 -0
- package/dist/templates/opencode/package.json +5 -0
- package/dist/templates/opencode/plugins/inject-subagent-context.js +497 -0
- package/dist/templates/opencode/plugins/inject-workflow-state.js +162 -0
- package/dist/templates/opencode/plugins/session-start.js +101 -0
- package/dist/templates/pi/agents/rudder-check.md +103 -0
- package/dist/templates/pi/agents/rudder-implement.md +41 -0
- package/dist/templates/pi/agents/rudder-research.md +25 -0
- package/dist/templates/pi/extensions/rudder/index.ts.txt +1172 -0
- package/dist/templates/pi/index.d.ts +5 -0
- package/dist/templates/pi/index.d.ts.map +1 -0
- package/dist/templates/pi/index.js +12 -0
- package/dist/templates/pi/index.js.map +1 -0
- package/dist/templates/pi/settings.json +21 -0
- package/dist/templates/qoder/agents/rudder-check.md +136 -0
- package/dist/templates/qoder/agents/rudder-implement.md +102 -0
- package/dist/templates/qoder/agents/rudder-research.md +137 -0
- package/dist/templates/qoder/index.d.ts +15 -0
- package/dist/templates/qoder/index.d.ts.map +1 -0
- package/dist/templates/qoder/index.js +15 -0
- package/dist/templates/qoder/index.js.map +1 -0
- package/dist/templates/qoder/settings.json +47 -0
- package/dist/templates/rudder/config.yaml +131 -0
- package/dist/templates/rudder/config_local.yml +17 -0
- package/dist/templates/rudder/gitignore.txt +35 -0
- package/dist/templates/rudder/index.d.ts +53 -0
- package/dist/templates/rudder/index.d.ts.map +1 -0
- package/dist/templates/rudder/index.js +98 -0
- package/dist/templates/rudder/index.js.map +1 -0
- package/dist/templates/rudder/scripts/__init__.py +5 -0
- package/dist/templates/rudder/scripts/add_session.py +547 -0
- package/dist/templates/rudder/scripts/common/__init__.py +92 -0
- package/dist/templates/rudder/scripts/common/active_task.py +626 -0
- package/dist/templates/rudder/scripts/common/cli_adapter.py +811 -0
- package/dist/templates/rudder/scripts/common/config.py +532 -0
- package/dist/templates/rudder/scripts/common/developer.py +190 -0
- package/dist/templates/rudder/scripts/common/git.py +31 -0
- package/dist/templates/rudder/scripts/common/git_context.py +106 -0
- package/dist/templates/rudder/scripts/common/io.py +37 -0
- package/dist/templates/rudder/scripts/common/log.py +45 -0
- package/dist/templates/rudder/scripts/common/packages_context.py +238 -0
- package/dist/templates/rudder/scripts/common/paths.py +447 -0
- package/dist/templates/rudder/scripts/common/rudder_config.py +201 -0
- package/dist/templates/rudder/scripts/common/safe_commit.py +255 -0
- package/dist/templates/rudder/scripts/common/session_context.py +839 -0
- package/dist/templates/rudder/scripts/common/task_context.py +223 -0
- package/dist/templates/rudder/scripts/common/task_queue.py +188 -0
- package/dist/templates/rudder/scripts/common/task_store.py +636 -0
- package/dist/templates/rudder/scripts/common/task_utils.py +274 -0
- package/dist/templates/rudder/scripts/common/tasks.py +112 -0
- package/dist/templates/rudder/scripts/common/types.py +110 -0
- package/dist/templates/rudder/scripts/common/workflow_phase.py +215 -0
- package/dist/templates/rudder/scripts/get_context.py +16 -0
- package/dist/templates/rudder/scripts/get_developer.py +26 -0
- package/dist/templates/rudder/scripts/hooks/linear_sync.py +243 -0
- package/dist/templates/rudder/scripts/init_developer.py +51 -0
- package/dist/templates/rudder/scripts/task.py +500 -0
- package/dist/templates/rudder/tasks/.gitkeep +0 -0
- package/dist/templates/rudder/workflow.md +710 -0
- package/dist/templates/shared-hooks/index.d.ts +50 -0
- package/dist/templates/shared-hooks/index.d.ts.map +1 -0
- package/dist/templates/shared-hooks/index.js +88 -0
- package/dist/templates/shared-hooks/index.js.map +1 -0
- package/dist/templates/shared-hooks/inject-shell-session-context.py +183 -0
- package/dist/templates/shared-hooks/inject-subagent-context.py +749 -0
- package/dist/templates/shared-hooks/inject-workflow-state.py +404 -0
- package/dist/templates/shared-hooks/session-start.py +827 -0
- package/dist/templates/template-utils.d.ts +26 -0
- package/dist/templates/template-utils.d.ts.map +1 -0
- package/dist/templates/template-utils.js +60 -0
- package/dist/templates/template-utils.js.map +1 -0
- package/dist/types/ai-tools.d.ts +95 -0
- package/dist/types/ai-tools.d.ts.map +1 -0
- package/dist/types/ai-tools.js +280 -0
- package/dist/types/ai-tools.js.map +1 -0
- package/dist/types/migration.d.ts +125 -0
- package/dist/types/migration.d.ts.map +1 -0
- package/dist/types/migration.js +8 -0
- package/dist/types/migration.js.map +1 -0
- package/dist/utils/compare-versions.d.ts +12 -0
- package/dist/utils/compare-versions.d.ts.map +1 -0
- package/dist/utils/compare-versions.js +86 -0
- package/dist/utils/compare-versions.js.map +1 -0
- package/dist/utils/file-writer.d.ts +23 -0
- package/dist/utils/file-writer.d.ts.map +1 -0
- package/dist/utils/file-writer.js +145 -0
- package/dist/utils/file-writer.js.map +1 -0
- package/dist/utils/posix.d.ts +13 -0
- package/dist/utils/posix.d.ts.map +1 -0
- package/dist/utils/posix.js +15 -0
- package/dist/utils/posix.js.map +1 -0
- package/dist/utils/project-detector.d.ts +46 -0
- package/dist/utils/project-detector.d.ts.map +1 -0
- package/dist/utils/project-detector.js +666 -0
- package/dist/utils/project-detector.js.map +1 -0
- package/dist/utils/proxy.d.ts +25 -0
- package/dist/utils/proxy.d.ts.map +1 -0
- package/dist/utils/proxy.js +60 -0
- package/dist/utils/proxy.js.map +1 -0
- package/dist/utils/task-json.d.ts +46 -0
- package/dist/utils/task-json.d.ts.map +1 -0
- package/dist/utils/task-json.js +49 -0
- package/dist/utils/task-json.js.map +1 -0
- package/dist/utils/template-fetcher.d.ts +150 -0
- package/dist/utils/template-fetcher.d.ts.map +1 -0
- package/dist/utils/template-fetcher.js +907 -0
- package/dist/utils/template-fetcher.js.map +1 -0
- package/dist/utils/template-hash.d.ts +112 -0
- package/dist/utils/template-hash.d.ts.map +1 -0
- package/dist/utils/template-hash.js +343 -0
- package/dist/utils/template-hash.js.map +1 -0
- package/dist/utils/trellis-migrate.d.ts +45 -0
- package/dist/utils/trellis-migrate.d.ts.map +1 -0
- package/dist/utils/trellis-migrate.js +240 -0
- package/dist/utils/trellis-migrate.js.map +1 -0
- package/dist/utils/uninstall-scrubbers.d.ts +66 -0
- package/dist/utils/uninstall-scrubbers.d.ts.map +1 -0
- package/dist/utils/uninstall-scrubbers.js +342 -0
- package/dist/utils/uninstall-scrubbers.js.map +1 -0
- package/package.json +87 -0
|
@@ -0,0 +1,190 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Developer management utilities.
|
|
4
|
+
|
|
5
|
+
Provides:
|
|
6
|
+
init_developer - Initialize developer
|
|
7
|
+
ensure_developer - Ensure developer is initialized (exit if not)
|
|
8
|
+
show_developer_info - Show developer information
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
from __future__ import annotations
|
|
12
|
+
|
|
13
|
+
import sys
|
|
14
|
+
from datetime import datetime
|
|
15
|
+
from pathlib import Path
|
|
16
|
+
|
|
17
|
+
from .paths import (
|
|
18
|
+
DIR_WORKFLOW,
|
|
19
|
+
DIR_WORKSPACE,
|
|
20
|
+
DIR_TASKS,
|
|
21
|
+
FILE_DEVELOPER,
|
|
22
|
+
FILE_JOURNAL_PREFIX,
|
|
23
|
+
get_repo_root,
|
|
24
|
+
get_developer,
|
|
25
|
+
check_developer,
|
|
26
|
+
)
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
# =============================================================================
|
|
30
|
+
# Developer Initialization
|
|
31
|
+
# =============================================================================
|
|
32
|
+
|
|
33
|
+
def init_developer(name: str, repo_root: Path | None = None) -> bool:
|
|
34
|
+
"""Initialize developer.
|
|
35
|
+
|
|
36
|
+
Creates:
|
|
37
|
+
- .rudder/.developer file with developer info
|
|
38
|
+
- .rudder/workspace/<name>/ directory structure
|
|
39
|
+
- Initial journal file and index.md
|
|
40
|
+
|
|
41
|
+
Args:
|
|
42
|
+
name: Developer name.
|
|
43
|
+
repo_root: Repository root path. Defaults to auto-detected.
|
|
44
|
+
|
|
45
|
+
Returns:
|
|
46
|
+
True on success, False on error.
|
|
47
|
+
"""
|
|
48
|
+
if not name:
|
|
49
|
+
print("Error: developer name is required", file=sys.stderr)
|
|
50
|
+
return False
|
|
51
|
+
|
|
52
|
+
if repo_root is None:
|
|
53
|
+
repo_root = get_repo_root()
|
|
54
|
+
|
|
55
|
+
dev_file = repo_root / DIR_WORKFLOW / FILE_DEVELOPER
|
|
56
|
+
workspace_dir = repo_root / DIR_WORKFLOW / DIR_WORKSPACE / name
|
|
57
|
+
|
|
58
|
+
# Create .developer file
|
|
59
|
+
initialized_at = datetime.now().isoformat()
|
|
60
|
+
try:
|
|
61
|
+
dev_file.write_text(
|
|
62
|
+
f"name={name}\ninitialized_at={initialized_at}\n",
|
|
63
|
+
encoding="utf-8"
|
|
64
|
+
)
|
|
65
|
+
except (OSError, IOError) as e:
|
|
66
|
+
print(f"Error: Failed to create .developer file: {e}", file=sys.stderr)
|
|
67
|
+
return False
|
|
68
|
+
|
|
69
|
+
# Create workspace directory structure
|
|
70
|
+
try:
|
|
71
|
+
workspace_dir.mkdir(parents=True, exist_ok=True)
|
|
72
|
+
except (OSError, IOError) as e:
|
|
73
|
+
print(f"Error: Failed to create workspace directory: {e}", file=sys.stderr)
|
|
74
|
+
return False
|
|
75
|
+
|
|
76
|
+
# Create initial journal file
|
|
77
|
+
journal_file = workspace_dir / f"{FILE_JOURNAL_PREFIX}1.md"
|
|
78
|
+
if not journal_file.exists():
|
|
79
|
+
today = datetime.now().strftime("%Y-%m-%d")
|
|
80
|
+
journal_content = f"""# Journal - {name} (Part 1)
|
|
81
|
+
|
|
82
|
+
> AI development session journal
|
|
83
|
+
> Started: {today}
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
"""
|
|
88
|
+
try:
|
|
89
|
+
journal_file.write_text(journal_content, encoding="utf-8")
|
|
90
|
+
except (OSError, IOError) as e:
|
|
91
|
+
print(f"Error: Failed to create journal file: {e}", file=sys.stderr)
|
|
92
|
+
return False
|
|
93
|
+
|
|
94
|
+
# Create index.md with markers for auto-update
|
|
95
|
+
index_file = workspace_dir / "index.md"
|
|
96
|
+
if not index_file.exists():
|
|
97
|
+
index_content = f"""# Workspace Index - {name}
|
|
98
|
+
|
|
99
|
+
> Journal tracking for AI development sessions.
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## Current Status
|
|
104
|
+
|
|
105
|
+
<!-- @@@auto:current-status -->
|
|
106
|
+
- **Active File**: `journal-1.md`
|
|
107
|
+
- **Total Sessions**: 0
|
|
108
|
+
- **Last Active**: -
|
|
109
|
+
<!-- @@@/auto:current-status -->
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## Active Documents
|
|
114
|
+
|
|
115
|
+
<!-- @@@auto:active-documents -->
|
|
116
|
+
| File | Lines | Status |
|
|
117
|
+
|------|-------|--------|
|
|
118
|
+
| `journal-1.md` | ~0 | Active |
|
|
119
|
+
<!-- @@@/auto:active-documents -->
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
## Session History
|
|
124
|
+
|
|
125
|
+
<!-- @@@auto:session-history -->
|
|
126
|
+
| # | Date | Title | Commits | Branch |
|
|
127
|
+
|---|------|-------|---------|--------|
|
|
128
|
+
<!-- @@@/auto:session-history -->
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## Notes
|
|
133
|
+
|
|
134
|
+
- Sessions are appended to journal files
|
|
135
|
+
- New journal file created when current exceeds 2000 lines
|
|
136
|
+
- Use `add_session.py` to record sessions
|
|
137
|
+
"""
|
|
138
|
+
try:
|
|
139
|
+
index_file.write_text(index_content, encoding="utf-8")
|
|
140
|
+
except (OSError, IOError) as e:
|
|
141
|
+
print(f"Error: Failed to create index.md: {e}", file=sys.stderr)
|
|
142
|
+
return False
|
|
143
|
+
|
|
144
|
+
print(f"Developer initialized: {name}")
|
|
145
|
+
print(f" .developer file: {dev_file}")
|
|
146
|
+
print(f" Workspace dir: {workspace_dir}")
|
|
147
|
+
|
|
148
|
+
return True
|
|
149
|
+
|
|
150
|
+
|
|
151
|
+
def ensure_developer(repo_root: Path | None = None) -> None:
|
|
152
|
+
"""Ensure developer is initialized, exit if not.
|
|
153
|
+
|
|
154
|
+
Args:
|
|
155
|
+
repo_root: Repository root path. Defaults to auto-detected.
|
|
156
|
+
"""
|
|
157
|
+
if repo_root is None:
|
|
158
|
+
repo_root = get_repo_root()
|
|
159
|
+
|
|
160
|
+
if not check_developer(repo_root):
|
|
161
|
+
print("Error: Developer not initialized.", file=sys.stderr)
|
|
162
|
+
print(f"Run: python3 ./{DIR_WORKFLOW}/scripts/init_developer.py <your-name>", file=sys.stderr)
|
|
163
|
+
sys.exit(1)
|
|
164
|
+
|
|
165
|
+
|
|
166
|
+
def show_developer_info(repo_root: Path | None = None) -> None:
|
|
167
|
+
"""Show developer information.
|
|
168
|
+
|
|
169
|
+
Args:
|
|
170
|
+
repo_root: Repository root path. Defaults to auto-detected.
|
|
171
|
+
"""
|
|
172
|
+
if repo_root is None:
|
|
173
|
+
repo_root = get_repo_root()
|
|
174
|
+
|
|
175
|
+
developer = get_developer(repo_root)
|
|
176
|
+
|
|
177
|
+
if not developer:
|
|
178
|
+
print("Developer: (not initialized)")
|
|
179
|
+
else:
|
|
180
|
+
print(f"Developer: {developer}")
|
|
181
|
+
print(f"Workspace: {DIR_WORKFLOW}/{DIR_WORKSPACE}/{developer}/")
|
|
182
|
+
print(f"Tasks: {DIR_WORKFLOW}/{DIR_TASKS}/")
|
|
183
|
+
|
|
184
|
+
|
|
185
|
+
# =============================================================================
|
|
186
|
+
# Main Entry (for testing)
|
|
187
|
+
# =============================================================================
|
|
188
|
+
|
|
189
|
+
if __name__ == "__main__":
|
|
190
|
+
show_developer_info()
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
"""
|
|
2
|
+
Git command execution utility.
|
|
3
|
+
|
|
4
|
+
Single source of truth for running git commands across all Rudder scripts.
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
from __future__ import annotations
|
|
8
|
+
|
|
9
|
+
import subprocess
|
|
10
|
+
from pathlib import Path
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
def run_git(args: list[str], cwd: Path | None = None) -> tuple[int, str, str]:
|
|
14
|
+
"""Run a git command and return (returncode, stdout, stderr).
|
|
15
|
+
|
|
16
|
+
Uses UTF-8 encoding with -c i18n.logOutputEncoding=UTF-8 to ensure
|
|
17
|
+
consistent output across all platforms (Windows, macOS, Linux).
|
|
18
|
+
"""
|
|
19
|
+
try:
|
|
20
|
+
git_args = ["git", "-c", "i18n.logOutputEncoding=UTF-8"] + args
|
|
21
|
+
result = subprocess.run(
|
|
22
|
+
git_args,
|
|
23
|
+
cwd=cwd,
|
|
24
|
+
capture_output=True,
|
|
25
|
+
text=True,
|
|
26
|
+
encoding="utf-8",
|
|
27
|
+
errors="replace",
|
|
28
|
+
)
|
|
29
|
+
return result.returncode, result.stdout, result.stderr
|
|
30
|
+
except Exception as e:
|
|
31
|
+
return 1, "", str(e)
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# -*- coding: utf-8 -*-
|
|
3
|
+
"""
|
|
4
|
+
Git and Session Context utilities.
|
|
5
|
+
|
|
6
|
+
Entry shim — delegates to session_context and packages_context.
|
|
7
|
+
|
|
8
|
+
Provides:
|
|
9
|
+
output_json - Output context in JSON format
|
|
10
|
+
output_text - Output context in text format
|
|
11
|
+
"""
|
|
12
|
+
|
|
13
|
+
from __future__ import annotations
|
|
14
|
+
|
|
15
|
+
import json
|
|
16
|
+
|
|
17
|
+
from .git import run_git
|
|
18
|
+
from .session_context import (
|
|
19
|
+
get_context_json,
|
|
20
|
+
get_context_text,
|
|
21
|
+
get_context_record_json,
|
|
22
|
+
get_context_text_record,
|
|
23
|
+
output_json,
|
|
24
|
+
output_text,
|
|
25
|
+
)
|
|
26
|
+
from .packages_context import (
|
|
27
|
+
get_context_packages_text,
|
|
28
|
+
get_context_packages_json,
|
|
29
|
+
)
|
|
30
|
+
from .rudder_config import read_rudder_config
|
|
31
|
+
from .workflow_phase import (
|
|
32
|
+
filter_platform,
|
|
33
|
+
get_phase_index,
|
|
34
|
+
get_step,
|
|
35
|
+
resolve_effective_platform,
|
|
36
|
+
)
|
|
37
|
+
|
|
38
|
+
# Backward-compatible alias — external modules import this name
|
|
39
|
+
_run_git_command = run_git
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
# =============================================================================
|
|
43
|
+
# Main Entry
|
|
44
|
+
# =============================================================================
|
|
45
|
+
|
|
46
|
+
def main() -> None:
|
|
47
|
+
"""CLI entry point."""
|
|
48
|
+
import argparse
|
|
49
|
+
|
|
50
|
+
parser = argparse.ArgumentParser(description="Get Session Context for AI Agent")
|
|
51
|
+
parser.add_argument(
|
|
52
|
+
"--json",
|
|
53
|
+
"-j",
|
|
54
|
+
action="store_true",
|
|
55
|
+
help="Output in JSON format (works with any --mode)",
|
|
56
|
+
)
|
|
57
|
+
parser.add_argument(
|
|
58
|
+
"--mode",
|
|
59
|
+
"-m",
|
|
60
|
+
choices=["default", "record", "packages", "phase"],
|
|
61
|
+
default="default",
|
|
62
|
+
help="Output mode: default (full context), record (for record-session), packages (package info only), phase (workflow step extraction)",
|
|
63
|
+
)
|
|
64
|
+
parser.add_argument(
|
|
65
|
+
"--step",
|
|
66
|
+
help="Step id for --mode phase, e.g. 1.1, 2.2. Omit to get the Phase Index.",
|
|
67
|
+
)
|
|
68
|
+
parser.add_argument(
|
|
69
|
+
"--platform",
|
|
70
|
+
help="Platform name for --mode phase, e.g. cursor, claude-code. Filters platform-tagged blocks.",
|
|
71
|
+
)
|
|
72
|
+
|
|
73
|
+
args = parser.parse_args()
|
|
74
|
+
|
|
75
|
+
if args.mode == "record":
|
|
76
|
+
if args.json:
|
|
77
|
+
print(json.dumps(get_context_record_json(), indent=2, ensure_ascii=False))
|
|
78
|
+
else:
|
|
79
|
+
print(get_context_text_record())
|
|
80
|
+
elif args.mode == "packages":
|
|
81
|
+
if args.json:
|
|
82
|
+
print(json.dumps(get_context_packages_json(), indent=2, ensure_ascii=False))
|
|
83
|
+
else:
|
|
84
|
+
print(get_context_packages_text())
|
|
85
|
+
elif args.mode == "phase":
|
|
86
|
+
content = get_step(args.step) if args.step else get_phase_index()
|
|
87
|
+
if not content.strip():
|
|
88
|
+
if args.step:
|
|
89
|
+
parser.exit(2, f"Step not found: {args.step}\n")
|
|
90
|
+
else:
|
|
91
|
+
parser.exit(2, "Phase Index section not found in workflow.md\n")
|
|
92
|
+
if args.platform:
|
|
93
|
+
effective = resolve_effective_platform(
|
|
94
|
+
args.platform, read_rudder_config()
|
|
95
|
+
)
|
|
96
|
+
content = filter_platform(content, effective)
|
|
97
|
+
print(content, end="")
|
|
98
|
+
else:
|
|
99
|
+
if args.json:
|
|
100
|
+
output_json()
|
|
101
|
+
else:
|
|
102
|
+
output_text()
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
if __name__ == "__main__":
|
|
106
|
+
main()
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
"""
|
|
2
|
+
JSON file I/O utilities.
|
|
3
|
+
|
|
4
|
+
Provides read_json and write_json as the single source of truth
|
|
5
|
+
for JSON file operations across all Rudder scripts.
|
|
6
|
+
"""
|
|
7
|
+
|
|
8
|
+
from __future__ import annotations
|
|
9
|
+
|
|
10
|
+
import json
|
|
11
|
+
from pathlib import Path
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
def read_json(path: Path) -> dict | None:
|
|
15
|
+
"""Read and parse a JSON file.
|
|
16
|
+
|
|
17
|
+
Returns None if the file doesn't exist, is invalid JSON, or can't be read.
|
|
18
|
+
"""
|
|
19
|
+
try:
|
|
20
|
+
return json.loads(path.read_text(encoding="utf-8"))
|
|
21
|
+
except (FileNotFoundError, json.JSONDecodeError, OSError):
|
|
22
|
+
return None
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
def write_json(path: Path, data: dict) -> bool:
|
|
26
|
+
"""Write dict to JSON file with pretty formatting.
|
|
27
|
+
|
|
28
|
+
Returns True on success, False on error.
|
|
29
|
+
"""
|
|
30
|
+
try:
|
|
31
|
+
path.write_text(
|
|
32
|
+
json.dumps(data, indent=2, ensure_ascii=False),
|
|
33
|
+
encoding="utf-8",
|
|
34
|
+
)
|
|
35
|
+
return True
|
|
36
|
+
except (OSError, IOError):
|
|
37
|
+
return False
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
"""
|
|
2
|
+
Terminal output utilities: colors and structured logging.
|
|
3
|
+
|
|
4
|
+
Single source of truth for Colors and log_* functions
|
|
5
|
+
used across all Rudder scripts.
|
|
6
|
+
"""
|
|
7
|
+
|
|
8
|
+
from __future__ import annotations
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
class Colors:
|
|
12
|
+
"""ANSI color codes for terminal output."""
|
|
13
|
+
|
|
14
|
+
RED = "\033[0;31m"
|
|
15
|
+
GREEN = "\033[0;32m"
|
|
16
|
+
YELLOW = "\033[1;33m"
|
|
17
|
+
BLUE = "\033[0;34m"
|
|
18
|
+
CYAN = "\033[0;36m"
|
|
19
|
+
DIM = "\033[2m"
|
|
20
|
+
NC = "\033[0m" # No Color / Reset
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def colored(text: str, color: str) -> str:
|
|
24
|
+
"""Apply ANSI color to text."""
|
|
25
|
+
return f"{color}{text}{Colors.NC}"
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
def log_info(msg: str) -> None:
|
|
29
|
+
"""Print info-level message with [INFO] prefix."""
|
|
30
|
+
print(f"{Colors.BLUE}[INFO]{Colors.NC} {msg}")
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
def log_success(msg: str) -> None:
|
|
34
|
+
"""Print success message with [SUCCESS] prefix."""
|
|
35
|
+
print(f"{Colors.GREEN}[SUCCESS]{Colors.NC} {msg}")
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
def log_warn(msg: str) -> None:
|
|
39
|
+
"""Print warning message with [WARN] prefix."""
|
|
40
|
+
print(f"{Colors.YELLOW}[WARN]{Colors.NC} {msg}")
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
def log_error(msg: str) -> None:
|
|
44
|
+
"""Print error message with [ERROR] prefix."""
|
|
45
|
+
print(f"{Colors.RED}[ERROR]{Colors.NC} {msg}")
|
|
@@ -0,0 +1,238 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Package discovery and context output.
|
|
4
|
+
|
|
5
|
+
Provides:
|
|
6
|
+
get_packages_info - Get structured package info
|
|
7
|
+
get_packages_section - Build PACKAGES text section
|
|
8
|
+
get_context_packages_text - Full packages text output (--mode packages)
|
|
9
|
+
get_context_packages_json - Full packages JSON output (--mode packages --json)
|
|
10
|
+
"""
|
|
11
|
+
|
|
12
|
+
from __future__ import annotations
|
|
13
|
+
|
|
14
|
+
from pathlib import Path
|
|
15
|
+
|
|
16
|
+
from .config import _is_true_config_value, get_default_package, get_packages, get_spec_scope
|
|
17
|
+
from .paths import (
|
|
18
|
+
DIR_SPEC,
|
|
19
|
+
DIR_WORKFLOW,
|
|
20
|
+
get_current_task,
|
|
21
|
+
get_repo_root,
|
|
22
|
+
)
|
|
23
|
+
from .tasks import load_task
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
# =============================================================================
|
|
27
|
+
# Internal Helpers
|
|
28
|
+
# =============================================================================
|
|
29
|
+
|
|
30
|
+
def _scan_spec_layers(spec_dir: Path, package: str | None = None) -> list[str]:
|
|
31
|
+
"""Scan spec directory for available layers (subdirectories).
|
|
32
|
+
|
|
33
|
+
For monorepo: scans spec/<package>/
|
|
34
|
+
For single-repo: scans spec/
|
|
35
|
+
"""
|
|
36
|
+
target = spec_dir / package if package else spec_dir
|
|
37
|
+
if not target.is_dir():
|
|
38
|
+
return []
|
|
39
|
+
return sorted(
|
|
40
|
+
d.name for d in target.iterdir() if d.is_dir() and d.name != "guides"
|
|
41
|
+
)
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
def _get_active_task_package(repo_root: Path) -> str | None:
|
|
45
|
+
"""Get the package field from the active task's task.json."""
|
|
46
|
+
current = get_current_task(repo_root)
|
|
47
|
+
if not current:
|
|
48
|
+
return None
|
|
49
|
+
ct = load_task(repo_root / current)
|
|
50
|
+
return ct.package if ct and ct.package else None
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
def _resolve_scope_set(
|
|
54
|
+
packages: dict,
|
|
55
|
+
spec_scope,
|
|
56
|
+
task_pkg: str | None,
|
|
57
|
+
default_pkg: str | None,
|
|
58
|
+
) -> set | None:
|
|
59
|
+
"""Resolve spec_scope to a set of allowed package names, or None for full scan."""
|
|
60
|
+
if not packages:
|
|
61
|
+
return None
|
|
62
|
+
|
|
63
|
+
if spec_scope is None:
|
|
64
|
+
return None
|
|
65
|
+
|
|
66
|
+
if isinstance(spec_scope, str) and spec_scope == "active_task":
|
|
67
|
+
if task_pkg and task_pkg in packages:
|
|
68
|
+
return {task_pkg}
|
|
69
|
+
if default_pkg and default_pkg in packages:
|
|
70
|
+
return {default_pkg}
|
|
71
|
+
return None
|
|
72
|
+
|
|
73
|
+
if isinstance(spec_scope, list):
|
|
74
|
+
valid = {e for e in spec_scope if e in packages}
|
|
75
|
+
if valid:
|
|
76
|
+
return valid
|
|
77
|
+
# All invalid: fallback
|
|
78
|
+
if task_pkg and task_pkg in packages:
|
|
79
|
+
return {task_pkg}
|
|
80
|
+
if default_pkg and default_pkg in packages:
|
|
81
|
+
return {default_pkg}
|
|
82
|
+
return None
|
|
83
|
+
|
|
84
|
+
return None
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
# =============================================================================
|
|
88
|
+
# Public Functions
|
|
89
|
+
# =============================================================================
|
|
90
|
+
|
|
91
|
+
def get_packages_info(repo_root: Path) -> list[dict]:
|
|
92
|
+
"""Get structured package info for monorepo projects.
|
|
93
|
+
|
|
94
|
+
Returns list of dicts with keys: name, path, type, default, specLayers,
|
|
95
|
+
isSubmodule, isGitRepo.
|
|
96
|
+
Returns empty list for single-repo projects.
|
|
97
|
+
"""
|
|
98
|
+
packages = get_packages(repo_root)
|
|
99
|
+
if not packages:
|
|
100
|
+
return []
|
|
101
|
+
|
|
102
|
+
default_pkg = get_default_package(repo_root)
|
|
103
|
+
spec_dir = repo_root / DIR_WORKFLOW / DIR_SPEC
|
|
104
|
+
result = []
|
|
105
|
+
|
|
106
|
+
for pkg_name, pkg_config in packages.items():
|
|
107
|
+
pkg_path = pkg_config.get("path", pkg_name) if isinstance(pkg_config, dict) else str(pkg_config)
|
|
108
|
+
pkg_type = pkg_config.get("type", "local") if isinstance(pkg_config, dict) else "local"
|
|
109
|
+
pkg_git = pkg_config.get("git", False) if isinstance(pkg_config, dict) else False
|
|
110
|
+
layers = _scan_spec_layers(spec_dir, pkg_name)
|
|
111
|
+
|
|
112
|
+
result.append({
|
|
113
|
+
"name": pkg_name,
|
|
114
|
+
"path": pkg_path,
|
|
115
|
+
"type": pkg_type,
|
|
116
|
+
"default": pkg_name == default_pkg,
|
|
117
|
+
"specLayers": layers,
|
|
118
|
+
"isSubmodule": pkg_type == "submodule",
|
|
119
|
+
"isGitRepo": _is_true_config_value(pkg_git),
|
|
120
|
+
})
|
|
121
|
+
|
|
122
|
+
return result
|
|
123
|
+
|
|
124
|
+
|
|
125
|
+
def get_packages_section(repo_root: Path) -> str:
|
|
126
|
+
"""Build the PACKAGES section for text output."""
|
|
127
|
+
spec_dir = repo_root / DIR_WORKFLOW / DIR_SPEC
|
|
128
|
+
pkg_info = get_packages_info(repo_root)
|
|
129
|
+
|
|
130
|
+
lines: list[str] = []
|
|
131
|
+
lines.append("## PACKAGES")
|
|
132
|
+
|
|
133
|
+
if not pkg_info:
|
|
134
|
+
lines.append("(single-repo mode)")
|
|
135
|
+
layers = _scan_spec_layers(spec_dir)
|
|
136
|
+
if layers:
|
|
137
|
+
lines.append(f"Spec layers: {', '.join(layers)}")
|
|
138
|
+
return "\n".join(lines)
|
|
139
|
+
|
|
140
|
+
default_pkg = get_default_package(repo_root)
|
|
141
|
+
|
|
142
|
+
for pkg in pkg_info:
|
|
143
|
+
layers_str = f" [{', '.join(pkg['specLayers'])}]" if pkg["specLayers"] else ""
|
|
144
|
+
submodule_tag = " (submodule)" if pkg["isSubmodule"] else ""
|
|
145
|
+
git_repo_tag = " (git repo)" if pkg["isGitRepo"] else ""
|
|
146
|
+
default_tag = " *" if pkg["default"] else ""
|
|
147
|
+
lines.append(
|
|
148
|
+
f"- {pkg['name']:<16} {pkg['path']:<20}{layers_str}{submodule_tag}{git_repo_tag}{default_tag}"
|
|
149
|
+
)
|
|
150
|
+
|
|
151
|
+
if default_pkg:
|
|
152
|
+
lines.append(f"Default package: {default_pkg}")
|
|
153
|
+
|
|
154
|
+
return "\n".join(lines)
|
|
155
|
+
|
|
156
|
+
|
|
157
|
+
def get_context_packages_text(repo_root: Path | None = None) -> str:
|
|
158
|
+
"""Get packages context as formatted text (for --mode packages)."""
|
|
159
|
+
if repo_root is None:
|
|
160
|
+
repo_root = get_repo_root()
|
|
161
|
+
|
|
162
|
+
pkg_info = get_packages_info(repo_root)
|
|
163
|
+
lines: list[str] = []
|
|
164
|
+
|
|
165
|
+
if not pkg_info:
|
|
166
|
+
spec_dir = repo_root / DIR_WORKFLOW / DIR_SPEC
|
|
167
|
+
lines.append("Single-repo project (no packages configured)")
|
|
168
|
+
lines.append("")
|
|
169
|
+
layers = _scan_spec_layers(spec_dir)
|
|
170
|
+
if layers:
|
|
171
|
+
lines.append(f"Spec layers: {', '.join(layers)}")
|
|
172
|
+
return "\n".join(lines)
|
|
173
|
+
|
|
174
|
+
# Resolve scope for annotations
|
|
175
|
+
packages_dict = get_packages(repo_root) or {}
|
|
176
|
+
default_pkg = get_default_package(repo_root)
|
|
177
|
+
spec_scope = get_spec_scope(repo_root)
|
|
178
|
+
task_pkg = _get_active_task_package(repo_root)
|
|
179
|
+
scope_set = _resolve_scope_set(packages_dict, spec_scope, task_pkg, default_pkg)
|
|
180
|
+
|
|
181
|
+
lines.append("## PACKAGES")
|
|
182
|
+
lines.append("")
|
|
183
|
+
for pkg in pkg_info:
|
|
184
|
+
default_tag = " (default)" if pkg["default"] else ""
|
|
185
|
+
type_tag = f" [{pkg['type']}]" if pkg["type"] != "local" else ""
|
|
186
|
+
git_tag = " [git repo]" if pkg["isGitRepo"] else ""
|
|
187
|
+
|
|
188
|
+
# Scope annotation
|
|
189
|
+
scope_tag = ""
|
|
190
|
+
if scope_set is not None and pkg["name"] not in scope_set:
|
|
191
|
+
scope_tag = " (out of scope)"
|
|
192
|
+
|
|
193
|
+
lines.append(f"### {pkg['name']}{default_tag}{type_tag}{git_tag}{scope_tag}")
|
|
194
|
+
lines.append(f"Path: {pkg['path']}")
|
|
195
|
+
if pkg["specLayers"]:
|
|
196
|
+
lines.append(f"Spec layers: {', '.join(pkg['specLayers'])}")
|
|
197
|
+
for layer in pkg["specLayers"]:
|
|
198
|
+
lines.append(f" - .rudder/spec/{pkg['name']}/{layer}/index.md")
|
|
199
|
+
else:
|
|
200
|
+
lines.append("Spec: not configured")
|
|
201
|
+
lines.append("")
|
|
202
|
+
|
|
203
|
+
# Also show shared guides
|
|
204
|
+
guides_dir = repo_root / DIR_WORKFLOW / DIR_SPEC / "guides"
|
|
205
|
+
if guides_dir.is_dir():
|
|
206
|
+
lines.append("### Shared Guides (always included)")
|
|
207
|
+
lines.append("Path: .rudder/spec/guides/index.md")
|
|
208
|
+
lines.append("")
|
|
209
|
+
|
|
210
|
+
return "\n".join(lines)
|
|
211
|
+
|
|
212
|
+
|
|
213
|
+
def get_context_packages_json(repo_root: Path | None = None) -> dict:
|
|
214
|
+
"""Get packages context as a dictionary (for --mode packages --json)."""
|
|
215
|
+
if repo_root is None:
|
|
216
|
+
repo_root = get_repo_root()
|
|
217
|
+
|
|
218
|
+
pkg_info = get_packages_info(repo_root)
|
|
219
|
+
|
|
220
|
+
if not pkg_info:
|
|
221
|
+
spec_dir = repo_root / DIR_WORKFLOW / DIR_SPEC
|
|
222
|
+
layers = _scan_spec_layers(spec_dir)
|
|
223
|
+
return {
|
|
224
|
+
"mode": "single-repo",
|
|
225
|
+
"specLayers": layers,
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
default_pkg = get_default_package(repo_root)
|
|
229
|
+
spec_scope = get_spec_scope(repo_root)
|
|
230
|
+
task_pkg = _get_active_task_package(repo_root)
|
|
231
|
+
|
|
232
|
+
return {
|
|
233
|
+
"mode": "monorepo",
|
|
234
|
+
"packages": pkg_info,
|
|
235
|
+
"defaultPackage": default_pkg,
|
|
236
|
+
"specScope": spec_scope,
|
|
237
|
+
"activeTaskPackage": task_pkg,
|
|
238
|
+
}
|