@magnusekdahl/parallix 1.0.0

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 (123) hide show
  1. package/CHANGELOG.md +140 -0
  2. package/LICENSE +661 -0
  3. package/README.md +196 -0
  4. package/config/agents.json +25 -0
  5. package/config/agents.local.json.template +8 -0
  6. package/config/state-map.json +4 -0
  7. package/config/state-map.json.template +31 -0
  8. package/config/workflow.config.schema.json +98 -0
  9. package/data/.gitkeep +0 -0
  10. package/docs/adr/0031-ai-agent-instruction-boundary-and-command-floor.md +114 -0
  11. package/docs/adr/0032-mission-refinement-state-and-usage-budget-signals.md +135 -0
  12. package/docs/adr/0034-module-and-skill-invocation-model.md +202 -0
  13. package/docs/adr/0036-mission-sizing-and-dependency-wave-heuristics.md +79 -0
  14. package/docs/adr/0037-ai-workflow-coordination-architecture.md +162 -0
  15. package/docs/adr/0041-integration-pipeline-gates.md +165 -0
  16. package/docs/adr/0042-workflow-cli-color-rendering-approach.md +106 -0
  17. package/docs/adr/0043-git-target-resolution-strategy.md +185 -0
  18. package/docs/adr/0044-workflow-distribution-model.md +277 -0
  19. package/docs/adr/0045-parallax-branch-model.md +182 -0
  20. package/docs/adr/0046-npm-publish-process-and-security.md +138 -0
  21. package/docs/adr/index.md +20 -0
  22. package/docs/agents.md +212 -0
  23. package/docs/authority-reference.md +298 -0
  24. package/docs/forgejo-setup.md +31 -0
  25. package/docs/migration/extraction.md +61 -0
  26. package/docs/migration/task-classification.md +36 -0
  27. package/docs/operator-setup.md +76 -0
  28. package/docs/readme-rewrite-benchmark.md +188 -0
  29. package/docs/use-cases.md +105 -0
  30. package/examples/README.md +62 -0
  31. package/examples/run-enterprise-tarball-workflow-smoke.sh +257 -0
  32. package/examples/run-verify-env-smoke.sh +40 -0
  33. package/index.js +250 -0
  34. package/lib/README.md +13 -0
  35. package/lib/agents/agents.js +867 -0
  36. package/lib/agents/claude-telemetry.js +233 -0
  37. package/lib/agents/claude.js +139 -0
  38. package/lib/agents/codex-telemetry.js +202 -0
  39. package/lib/agents/codex.js +219 -0
  40. package/lib/agents/limit-hit.js +252 -0
  41. package/lib/agents/mistral-telemetry.js +44 -0
  42. package/lib/agents/mistral.js +68 -0
  43. package/lib/agents/opencode-export.js +110 -0
  44. package/lib/agents/opencode-telemetry.js +356 -0
  45. package/lib/agents/opencode.js +218 -0
  46. package/lib/agents/stage-telemetry.js +37 -0
  47. package/lib/commands/active.js +625 -0
  48. package/lib/commands/checkpoint.js +76 -0
  49. package/lib/commands/config.js +39 -0
  50. package/lib/commands/coverage-gate.js +358 -0
  51. package/lib/commands/diff.js +119 -0
  52. package/lib/commands/draft.js +854 -0
  53. package/lib/commands/handoff.js +501 -0
  54. package/lib/commands/integrate.js +1528 -0
  55. package/lib/commands/mission-start.js +246 -0
  56. package/lib/commands/rebase.js +597 -0
  57. package/lib/commands/repair-handoff.js +227 -0
  58. package/lib/commands/resolve-conflict.js +109 -0
  59. package/lib/commands/review.js +13 -0
  60. package/lib/commands/setup-review.js +13 -0
  61. package/lib/commands/setup.js +3 -0
  62. package/lib/commands/stats-backfill.js +395 -0
  63. package/lib/commands/stats.js +1601 -0
  64. package/lib/commands/status.js +183 -0
  65. package/lib/commands/verify.js +1 -0
  66. package/lib/core/fmt.js +202 -0
  67. package/lib/core/git.js +73 -0
  68. package/lib/core/gitignore.js +110 -0
  69. package/lib/core/mission-utils.js +1017 -0
  70. package/lib/core/persistent-data-migration.js +201 -0
  71. package/lib/core/product-config.js +508 -0
  72. package/lib/core/runtime-matrix.js +82 -0
  73. package/lib/core/spawn-tee.js +173 -0
  74. package/lib/core/state-map.js +89 -0
  75. package/lib/core/storage.js +165 -0
  76. package/lib/core/verification.js +149 -0
  77. package/lib/index.js +77 -0
  78. package/lib/review/rebase.js +163 -0
  79. package/lib/review/review-adapter.js +135 -0
  80. package/lib/review/review-artifacts.js +619 -0
  81. package/lib/review/review-commands.js +1375 -0
  82. package/lib/review/review-events.js +1007 -0
  83. package/lib/review/review-loop.js +1004 -0
  84. package/lib/review/review-polling.js +141 -0
  85. package/lib/review/review-prompts.js +212 -0
  86. package/lib/review/review-state.js +280 -0
  87. package/lib/review/review.js +96 -0
  88. package/lib/tools/backlog.js +680 -0
  89. package/lib/tools/forgejo.js +1585 -0
  90. package/lib/tools/gatekeeper.js +106 -0
  91. package/lib/tools/sessions.js +74 -0
  92. package/lib/tools/setup-review.js +1053 -0
  93. package/package.json +56 -0
  94. package/prompts/act-on-review-verbose.md +20 -0
  95. package/prompts/act-on-review.md +22 -0
  96. package/prompts/draft.md +20 -0
  97. package/prompts/execute.md +24 -0
  98. package/prompts/portfolio.md +30 -0
  99. package/prompts/review-verbose.md +20 -0
  100. package/prompts/review.md +17 -0
  101. package/px.js +236 -0
  102. package/templates/AGENTS-snippet.md +14 -0
  103. package/templates/AGENTS.md.template +34 -0
  104. package/templates/CLAUDE.md.template +27 -0
  105. package/templates/CODEX.md.template +38 -0
  106. package/templates/MISTRAL.md.template +24 -0
  107. package/templates/claude-commands/act-on-review.md +3 -0
  108. package/templates/claude-commands/area-review.md +3 -0
  109. package/templates/claude-commands/draft.md +6 -0
  110. package/templates/claude-commands/execute.md +6 -0
  111. package/templates/claude-commands/integrate.md +4 -0
  112. package/templates/claude-commands/portfolio.md +5 -0
  113. package/templates/claude-commands/review.md +4 -0
  114. package/templates/codex/config.toml +6 -0
  115. package/templates/mission-scaffold.md +39 -0
  116. package/templates/vibe/skills/act-on-review/SKILL.md +16 -0
  117. package/templates/vibe/skills/area-review/SKILL.md +16 -0
  118. package/templates/vibe/skills/draft/SKILL.md +16 -0
  119. package/templates/vibe/skills/execute/SKILL.md +16 -0
  120. package/templates/vibe/skills/integrate/SKILL.md +16 -0
  121. package/templates/vibe/skills/portfolio/SKILL.md +21 -0
  122. package/templates/vibe/skills/review/SKILL.md +16 -0
  123. package/tools/setup-forgejo-docker.sh +84 -0
package/lib/review/review.js ADDED
@@ -0,0 +1,96 @@
1
+ /**
2
+ * Review Module - Main Entry Point
3
+ * Refactored for task-1201: complexity reduction via service extraction
4
+ *
5
+ * This file now serves as a re-export hub for the extracted sub-modules:
6
+ * - review-commands.js (command dispatcher and CLI handlers)
7
+ * - review-loop.js (autonomous review loop orchestration)
8
+ * - review-artifacts.js (artifact handling and posting)
9
+ * - review-polling.js (polling utilities)
10
+ */
11
+
12
+ // Re-export from review-polling module
13
+ const { POLL_TIMEOUT, delay, resolvePollIntervalMs, resolvePollTimeoutMs, formatElapsed, isPollTimeout, pollForReview, pollForDisposition } = require('./review-polling');
14
+
15
+ // Re-export from review-artifacts module
16
+ const { buildMetadataFooter, reviewArtifactPath, readArtifactFile, deleteArtifactFile, normalizeReviewVerdict, normalizeDisposition, postWorkflowComment, postWorkflowReview, consumeReviewerArtifacts, consumeImplementerArtifacts } = require('./review-artifacts');
17
+
18
+ // Re-export from review-loop module
19
+ const { maybeUpdateGraphifyBeforeReview, commitSafeMissionArtifacts, rebaseBeforeReviewRound, applyAgentFallback, persistNormalizedPhaseRepair, startReviewLoop } = require('./review-loop');
20
+
21
+ // Re-export from review-commands module
22
+ const {
23
+ flagValue,
24
+ readTextFlag,
25
+ formatStaticReviewFindings,
26
+ formatStaticReviewSuccess,
27
+ postStaticReviewComment,
28
+ performStaticReview,
29
+ verifyReview,
30
+ submitForReview,
31
+ readComments,
32
+ pushRound,
33
+ showReviewStatus,
34
+ commentRound,
35
+ submitReviewRound,
36
+ closeMissionPr,
37
+ createEventHandler,
38
+ importLegacyHandler,
39
+ review
40
+ } = require('./review-commands');
41
+
42
+ // ============================================================================
43
+ // Module Exports
44
+ // ============================================================================
45
+ // Set module.exports to the main review function (for backward compatibility)
46
+ // then add all other exports as properties
47
+
48
+ module.exports = review;
49
+
50
+ // From review-polling
51
+ module.exports.POLL_TIMEOUT = POLL_TIMEOUT;
52
+ module.exports.delay = delay;
53
+ module.exports.resolvePollIntervalMs = resolvePollIntervalMs;
54
+ module.exports.resolvePollTimeoutMs = resolvePollTimeoutMs;
55
+ module.exports.formatElapsed = formatElapsed;
56
+ module.exports.isPollTimeout = isPollTimeout;
57
+ module.exports.pollForReview = pollForReview;
58
+ module.exports.pollForDisposition = pollForDisposition;
59
+
60
+ // From review-artifacts
61
+ module.exports.buildMetadataFooter = buildMetadataFooter;
62
+ module.exports.reviewArtifactPath = reviewArtifactPath;
63
+ module.exports.readArtifactFile = readArtifactFile;
64
+ module.exports.deleteArtifactFile = deleteArtifactFile;
65
+ module.exports.normalizeReviewVerdict = normalizeReviewVerdict;
66
+ module.exports.normalizeDisposition = normalizeDisposition;
67
+ module.exports.postWorkflowComment = postWorkflowComment;
68
+ module.exports.postWorkflowReview = postWorkflowReview;
69
+ module.exports.consumeReviewerArtifacts = consumeReviewerArtifacts;
70
+ module.exports.consumeImplementerArtifacts = consumeImplementerArtifacts;
71
+
72
+ // From review-loop
73
+ module.exports.maybeUpdateGraphifyBeforeReview = maybeUpdateGraphifyBeforeReview;
74
+ module.exports.commitSafeMissionArtifacts = commitSafeMissionArtifacts;
75
+ module.exports.rebaseBeforeReviewRound = rebaseBeforeReviewRound;
76
+ module.exports.applyAgentFallback = applyAgentFallback;
77
+ module.exports.persistNormalizedPhaseRepair = persistNormalizedPhaseRepair;
78
+ module.exports.startReviewLoop = startReviewLoop;
79
+
80
+ // From review-commands
81
+ module.exports.flagValue = flagValue;
82
+ module.exports.readTextFlag = readTextFlag;
83
+ module.exports.formatStaticReviewFindings = formatStaticReviewFindings;
84
+ module.exports.formatStaticReviewSuccess = formatStaticReviewSuccess;
85
+ module.exports.postStaticReviewComment = postStaticReviewComment;
86
+ module.exports.performStaticReview = performStaticReview;
87
+ module.exports.verifyReview = verifyReview;
88
+ module.exports.submitForReview = submitForReview;
89
+ module.exports.readComments = readComments;
90
+ module.exports.pushRound = pushRound;
91
+ module.exports.showReviewStatus = showReviewStatus;
92
+ module.exports.commentRound = commentRound;
93
+ module.exports.submitReviewRound = submitReviewRound;
94
+ module.exports.closeMissionPr = closeMissionPr;
95
+ module.exports.createEventHandler = createEventHandler;
96
+ module.exports.importLegacyHandler = importLegacyHandler;