@mediadatafusion/pi-workflow-suite 0.0.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.
Files changed (61) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/CONTRIBUTING.md +9 -0
  3. package/LICENSE.md +201 -0
  4. package/NOTICE +6 -0
  5. package/README.md +1208 -0
  6. package/SECURITY.md +7 -0
  7. package/SUPPORT.md +9 -0
  8. package/TRADEMARKS.md +14 -0
  9. package/VERSION +1 -0
  10. package/agents/codebase-research.md +42 -0
  11. package/agents/general-worker.md +26 -0
  12. package/agents/implementation-planning.md +46 -0
  13. package/agents/quality-validation.md +43 -0
  14. package/agents/workflow-orchestrator.md +44 -0
  15. package/config/prompts/execute-approved-plan.md +43 -0
  16. package/config/prompts/mission-checkpoint.md +26 -0
  17. package/config/prompts/mission-final-validation.md +21 -0
  18. package/config/prompts/mission-plan.md +129 -0
  19. package/config/prompts/mission-repair.md +33 -0
  20. package/config/prompts/mission-run.md +37 -0
  21. package/config/prompts/validate-approved-plan.md +42 -0
  22. package/config/prompts/workflow-plan-prompt.md +93 -0
  23. package/config/prompts/workflow-repair.md +20 -0
  24. package/config/prompts/workflow-summary.md +23 -0
  25. package/config/workflow-settings.example.json +335 -0
  26. package/docs/assets/mediadatafusion-logo.png +0 -0
  27. package/docs/assets/pi-workflow-suite-card.png +0 -0
  28. package/docs/assets/pi-workflow-suite-header.png +0 -0
  29. package/docs/assets/pi-workflow-suite-video-thumb.png +0 -0
  30. package/docs/assets/readme-link-commands.svg +10 -0
  31. package/docs/assets/readme-link-install.svg +10 -0
  32. package/docs/assets/readme-link-quick-start.svg +10 -0
  33. package/docs/assets/readme-link-settings.svg +10 -0
  34. package/extensions/subagent/agents.ts +149 -0
  35. package/extensions/subagent/index.ts +1136 -0
  36. package/extensions/subagent/runner.ts +291 -0
  37. package/extensions/workflow-model-router.ts +1485 -0
  38. package/extensions/workflow-modes.ts +14778 -0
  39. package/extensions/workflow-parsers.ts +212 -0
  40. package/extensions/workflow-settings-capabilities.ts +282 -0
  41. package/extensions/workflow-state.ts +978 -0
  42. package/extensions/workflow-subagent-policy.ts +180 -0
  43. package/extensions/workflow-summary.ts +381 -0
  44. package/extensions/workflow-tool-guard.ts +302 -0
  45. package/extensions/workflow-validation-classifier.ts +102 -0
  46. package/extensions/workflow-web-tools.ts +356 -0
  47. package/package.json +1 -0
  48. package/scripts/audit-live.sh +69 -0
  49. package/scripts/audit-settings.sh +136 -0
  50. package/scripts/backup-live.sh +63 -0
  51. package/scripts/bootstrap-project.sh +220 -0
  52. package/scripts/install-to-live.sh +87 -0
  53. package/scripts/quarantine-live-junk.sh +69 -0
  54. package/scripts/verify-live.sh +128 -0
  55. package/skills/codebase-discovery/SKILL.md +20 -0
  56. package/skills/find-skills/SKILL.md +155 -0
  57. package/skills/git-safe-summary/SKILL.md +20 -0
  58. package/skills/implementation-planning/SKILL.md +20 -0
  59. package/skills/project-rules-audit/SKILL.md +20 -0
  60. package/skills/safe-execution/SKILL.md +20 -0
  61. package/skills/validation-review/SKILL.md +20 -0
@@ -0,0 +1,20 @@
1
+ ---
2
+ name: git-safe-summary
3
+ description: Generate safe git status, diff summaries, changed file summaries, and commit message suggestions without committing or pushing. Use after execution or validation.
4
+ ---
5
+
6
+ # Git Safe Summary
7
+
8
+ Summarize git status and diffs without committing, pushing, resetting, cleaning, switching branches, or staging files unless explicitly requested by the user outside this workflow.
9
+
10
+ Mermaid diagrams are rendered by Workflow Suite in a uniform dark-mode visual style. For user-facing workflows, export/share paths, request lifecycles, architecture, data flow, multi-step sequences, state transitions, dependencies, validation flow, or implementation phases, include a meaningful Mermaid diagram plus concise prose unless the user requested prose only or the response is trivial. Use concise labels and the right diagram type; do not hardcode random style/classDef/light-theme overrides unless the user explicitly asks.
11
+ ## Professional Constraints
12
+
13
+ - Check project instructions before recommendations when the task touches code, docs, settings, or workflow behavior.
14
+ - Keep scope bounded to the user request and approved workflow phase.
15
+ - Do not print secrets, credentials, tokens, auth/session values, private runtime state, or `.env` contents.
16
+ - Avoid destructive commands, deploys, pushes, resets, cleans, database mutations, and dependency installs unless explicitly approved outside this workflow.
17
+ - Prefer concise, evidence-based output with exact files or commands reviewed.
18
+ ## Skills vs Agents
19
+
20
+ Use this skill as in-process guidance for the current model. Use a sub-agent only when the task benefits from an isolated context window, parallel read-only research, forced preflight, or independent validation. Do not use both this skill and a same-purpose agent for the same narrow job unless the workflow or user explicitly requires it.
@@ -0,0 +1,20 @@
1
+ ---
2
+ name: implementation-planning
3
+ description: Convert a user task into an execution-ready implementation plan with assumptions, risks, files likely to change, validation steps, rollback notes, and approval readiness. Use during Plan Mode.
4
+ ---
5
+
6
+ # Implementation Planning
7
+
8
+ Produce concrete plans only. Ask follow-up questions when required. Include task summary, assumptions, files likely to change, off-limits files, implementation steps, risks, validation steps, rollback notes, and readiness status.
9
+
10
+ Mermaid diagrams are rendered by Workflow Suite in a uniform dark-mode visual style. For user-facing workflows, export/share paths, request lifecycles, architecture, data flow, multi-step sequences, state transitions, dependencies, validation flow, or implementation phases, include a meaningful Mermaid diagram plus concise prose unless the user requested prose only or the response is trivial. Use concise labels and the right diagram type; do not hardcode random style/classDef/light-theme overrides unless the user explicitly asks.
11
+ ## Professional Constraints
12
+
13
+ - Check project instructions before recommendations when the task touches code, docs, settings, or workflow behavior.
14
+ - Keep scope bounded to the user request and approved workflow phase.
15
+ - Do not print secrets, credentials, tokens, auth/session values, private runtime state, or `.env` contents.
16
+ - Avoid destructive commands, deploys, pushes, resets, cleans, database mutations, and dependency installs unless explicitly approved outside this workflow.
17
+ - Prefer concise, evidence-based output with exact files or commands reviewed.
18
+ ## Skills vs Agents
19
+
20
+ Use this skill as in-process guidance for the current model. Use a sub-agent only when the task benefits from an isolated context window, parallel read-only research, forced preflight, or independent validation. Do not use both this skill and a same-purpose agent for the same narrow job unless the workflow or user explicitly requires it.
@@ -0,0 +1,20 @@
1
+ ---
2
+ name: project-rules-audit
3
+ description: Find and respect project rules such as AGENTS.md, CLAUDE.md, README.md, .cursor/rules, .factory/rules, .pi, and .env.example before planning or execution.
4
+ ---
5
+
6
+ # Project Rules Audit
7
+
8
+ Before planning or execution, look for project instructions and safety rules. Check AGENTS.md, CLAUDE.md, README.md, .cursor/rules, .factory/rules, .pi, and .env.example. Preserve project-specific conventions and do not override existing agent rules.
9
+
10
+ Mermaid diagrams are rendered by Workflow Suite in a uniform dark-mode visual style. For user-facing workflows, export/share paths, request lifecycles, architecture, data flow, multi-step sequences, state transitions, dependencies, validation flow, or implementation phases, include a meaningful Mermaid diagram plus concise prose unless the user requested prose only or the response is trivial. Use concise labels and the right diagram type; do not hardcode random style/classDef/light-theme overrides unless the user explicitly asks.
11
+ ## Professional Constraints
12
+
13
+ - Check project instructions before recommendations when the task touches code, docs, settings, or workflow behavior.
14
+ - Keep scope bounded to the user request and approved workflow phase.
15
+ - Do not print secrets, credentials, tokens, auth/session values, private runtime state, or `.env` contents.
16
+ - Avoid destructive commands, deploys, pushes, resets, cleans, database mutations, and dependency installs unless explicitly approved outside this workflow.
17
+ - Prefer concise, evidence-based output with exact files or commands reviewed.
18
+ ## Skills vs Agents
19
+
20
+ Use this skill as in-process guidance for the current model. Use a sub-agent only when the task benefits from an isolated context window, parallel read-only research, forced preflight, or independent validation. Do not use both this skill and a same-purpose agent for the same narrow job unless the workflow or user explicitly requires it.
@@ -0,0 +1,20 @@
1
+ ---
2
+ name: safe-execution
3
+ description: Keep code changes bound to an approved plan, avoid unrelated refactors, respect off-limits files, and summarize changed files. Use during Execute Mode.
4
+ ---
5
+
6
+ # Safe Execution
7
+
8
+ Execute only the approved plan. Restate expected files before editing. Prefer surgical edits. Do not commit, push, switch branches, install dependencies, deploy, or run destructive commands. Stop and ask if the approved plan is insufficient.
9
+
10
+ Mermaid diagrams are rendered by Workflow Suite in a uniform dark-mode visual style. For user-facing workflows, export/share paths, request lifecycles, architecture, data flow, multi-step sequences, state transitions, dependencies, validation flow, or implementation phases, include a meaningful Mermaid diagram plus concise prose unless the user requested prose only or the response is trivial. Use concise labels and the right diagram type; do not hardcode random style/classDef/light-theme overrides unless the user explicitly asks.
11
+ ## Professional Constraints
12
+
13
+ - Check project instructions before recommendations when the task touches code, docs, settings, or workflow behavior.
14
+ - Keep scope bounded to the user request and approved workflow phase.
15
+ - Do not print secrets, credentials, tokens, auth/session values, private runtime state, or `.env` contents.
16
+ - Avoid destructive commands, deploys, pushes, resets, cleans, database mutations, and dependency installs unless explicitly approved outside this workflow.
17
+ - Prefer concise, evidence-based output with exact files or commands reviewed.
18
+ ## Skills vs Agents
19
+
20
+ Use this skill as in-process guidance for the current model. Use a sub-agent only when the task benefits from an isolated context window, parallel read-only research, forced preflight, or independent validation. Do not use both this skill and a same-purpose agent for the same narrow job unless the workflow or user explicitly requires it.
@@ -0,0 +1,20 @@
1
+ ---
2
+ name: validation-review
3
+ description: Review implementation against an approved plan and return PASS, PARTIAL PASS, or FAIL with missing requirements, unexpected changes, risks, and test/build status. Use during Validator Mode.
4
+ ---
5
+
6
+ # Validation Review
7
+
8
+ Use read-only review. Compare changed files and implementation behavior against the approved plan. Report PASS, PARTIAL PASS, or FAIL. Include coverage, missing requirements, unexpected changes, regression risks, test/build status, and next action.
9
+
10
+ Mermaid diagrams are rendered by Workflow Suite in a uniform dark-mode visual style. For user-facing workflows, export/share paths, request lifecycles, architecture, data flow, multi-step sequences, state transitions, dependencies, validation flow, or implementation phases, include a meaningful Mermaid diagram plus concise prose unless the user requested prose only or the response is trivial. Use concise labels and the right diagram type; do not hardcode random style/classDef/light-theme overrides unless the user explicitly asks.
11
+ ## Professional Constraints
12
+
13
+ - Check project instructions before recommendations when the task touches code, docs, settings, or workflow behavior.
14
+ - Keep scope bounded to the user request and approved workflow phase.
15
+ - Do not print secrets, credentials, tokens, auth/session values, private runtime state, or `.env` contents.
16
+ - Avoid destructive commands, deploys, pushes, resets, cleans, database mutations, and dependency installs unless explicitly approved outside this workflow.
17
+ - Prefer concise, evidence-based output with exact files or commands reviewed.
18
+ ## Skills vs Agents
19
+
20
+ Use this skill as in-process guidance for the current model. Use a sub-agent only when the task benefits from an isolated context window, parallel read-only research, forced preflight, or independent validation. Do not use both this skill and a same-purpose agent for the same narrow job unless the workflow or user explicitly requires it.