npm - @acrasie/dev-flow - Versions diffs - 0.0.0-stage → 1.0.1 - Mend

@acrasie/dev-flow 0.0.0-stage → 1.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 (58) hide show

package/.codex-plugin/plugin.json +20 -0
package/LICENSE +21 -0
package/README.md +181 -2
package/dist/codex-dev-flow.mjs +3 -0
package/dist/dev-flow.mjs +241 -0
package/docs/adr/0001-hybrid-portable-workflow.md +23 -0
package/docs/adr/0002-share-an-invalidable-context-capsule.md +55 -0
package/docs/adr/0004-scale-assurance-lanes-by-applicable-risk.md +36 -0
package/docs/adr/0006-make-intake-adaptive-user-authoritative-and-token-efficient.md +76 -0
package/docs/adr/0007-collect-opt-in-local-benchmark-feedback.md +82 -0
package/docs/adr/0008-automate-maintainer-releases-with-an-interactive-bun-workflow.md +121 -0
package/docs/adr/0009-separate-intake-decisions-from-shape-discovery.md +200 -0
package/docs/adr/0010-choose-quick-or-plan-after-discovery.md +161 -0
package/docs/adr/0011-separate-fast-local-and-authoritative-ci-quality-gates.md +49 -0
package/docs/adr/0012-use-bun-test-and-require-node-24.md +41 -0
package/docs/adr/0013-layer-source-distribution-and-runtime-tests.md +42 -0
package/docs/adr/0014-ratchet-source-coverage-with-bun.md +51 -0
package/docs/adr/0015-split-fast-and-type-aware-linting.md +41 -0
package/docs/adr/0016-use-husky-with-a-tested-bun-staged-file-adapter.md +45 -0
package/docs/adr/0017-format-conservatively-with-oxfmt.md +45 -0
package/docs/adr/0018-use-a-high-signal-oxlint-policy.md +53 -0
package/docs/adr/0019-gate-deterministic-size-and-observe-timing.md +44 -0
package/docs/adr/0020-support-linux-and-macos-with-targeted-ci.md +41 -0
package/docs/adr/0021-randomize-tests-without-retries.md +35 -0
package/docs/adr/0022-use-one-root-bun-workspace.md +41 -0
package/docs/adr/0024-make-gate-a-minimal-plan-approval.md +74 -0
package/docs/adr/0025-end-the-lifecycle-after-assure.md +55 -0
package/docs/adr/0026-keep-intake-product-stable-and-interview-shape-by-dependency.md +151 -0
package/docs/adr/0027-add-agentic-project-init-and-versioned-engineering-profiles.md +147 -0
package/docs/adr/0028-make-public-documentation-user-first-and-current.md +65 -0
package/docs/adr/0029-make-build-a-native-execution-boundary.md +51 -0
package/docs/adr/0030-unify-product-domain-and-technical-design-interviews.md +240 -0
package/docs/adr/0031-make-assure-the-success-boundary.md +205 -0
package/docs/artifacts.md +47 -0
package/docs/baselines/2026-07-18-p0-lifecycle.json +142 -0
package/docs/design.md +101 -0
package/docs/getting-started.md +204 -0
package/docs/glossary/dev-flow.md +527 -0
package/docs/lifecycle-contract.md +189 -0
package/docs/lifecycle-contract.projection.json +931 -0
package/docs/metrics-protocol.md +113 -0
package/docs/project-profile-contract.md +157 -0
package/docs/runbooks/maintainer-release.md +291 -0
package/docs/target-intake-shape-contract.md +416 -0
package/package.json +68 -4
package/schemas/config.schema.json +104 -0
package/schemas/policy.schema.json +17 -0
package/schemas/project-init-state.schema.json +159 -0
package/schemas/project-profile-local.schema.json +53 -0
package/schemas/project-profile.schema.json +285 -0
package/schemas/state.schema.json +826 -0
package/skills/debug-root-cause/SKILL.md +16 -0
package/skills/design-decisions/SKILL.md +24 -0
package/skills/dev-flow/SKILL.md +306 -0
package/skills/dev-flow/agents/openai.yaml +6 -0
package/skills/discover-change/SKILL.md +31 -0
package/skills/plan-change/SKILL.md +29 -0
package/skills/review-change/SKILL.md +21 -0

package/docs/lifecycle-contract.projection.json ADDED Viewed

@@ -0,0 +1,931 @@
+{
+  "macroPhases": [
+    "INTAKE",
+    "SHAPE",
+    "GATE",
+    "BUILD",
+    "ASSURE"
+  ],
+  "guards": [
+    "task_initialized",
+    "effective_constraints_valid",
+    "intake_complete",
+    "intake_reopened",
+    "routing_ready",
+    "workspace_ready",
+    "discovery_sufficient",
+    "profile_selected",
+    "contract_complete",
+    "approval_current",
+    "resume_metadata_valid",
+    "resume_reconciled",
+    "terminal_source_recorded",
+    "gate_decision_valid"
+  ],
+  "states": [
+    {
+      "status": "new",
+      "macroPhase": "INTAKE",
+      "stable": false,
+      "terminal": false,
+      "transitions": [
+        {
+          "target": "intaking",
+          "guards": [
+            "task_initialized",
+            "effective_constraints_valid"
+          ]
+        },
+        {
+          "target": "blocked",
+          "guards": [
+            "resume_metadata_valid"
+          ]
+        },
+        {
+          "target": "cancelled",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        },
+        {
+          "target": "failed",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        }
+      ],
+      "capsule": {
+        "consumes": [
+          "request",
+          "constraints",
+          "design.product-reopen"
+        ],
+        "produces": [
+          "design.product-baseline",
+          "design.glossary-deltas",
+          "design.domain-rules",
+          "design.question",
+          "risk",
+          "routing",
+          "workspace",
+          "freshness.config",
+          "freshness.policy"
+        ],
+        "invalidates": [
+          "intake.dependent-decisions",
+          "shape.dependency-closure",
+          "approvals"
+        ]
+      },
+      "events": [
+        "task.initialized",
+        "intake.checkpoint",
+        "advance.rejected",
+        "intake.reopened",
+        "design.question_recorded",
+        "design.answer_recorded",
+        "design.invalidated",
+        "routing.captured",
+        "state.transition"
+      ]
+    },
+    {
+      "status": "intaking",
+      "macroPhase": "INTAKE",
+      "stable": false,
+      "terminal": false,
+      "transitions": [
+        {
+          "target": "awaiting_intake_decision",
+          "guards": []
+        },
+        {
+          "target": "discovering",
+          "guards": [
+            "intake_complete",
+            "routing_ready",
+            "workspace_ready"
+          ]
+        },
+        {
+          "target": "blocked",
+          "guards": [
+            "resume_metadata_valid"
+          ]
+        },
+        {
+          "target": "cancelled",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        },
+        {
+          "target": "failed",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        }
+      ],
+      "capsule": {
+        "consumes": [
+          "request",
+          "constraints",
+          "design.product-reopen"
+        ],
+        "produces": [
+          "design.product-baseline",
+          "design.glossary-deltas",
+          "design.domain-rules",
+          "design.question",
+          "risk",
+          "routing",
+          "workspace",
+          "freshness.config",
+          "freshness.policy"
+        ],
+        "invalidates": [
+          "intake.dependent-decisions",
+          "shape.dependency-closure",
+          "approvals"
+        ]
+      },
+      "events": [
+        "task.initialized",
+        "intake.checkpoint",
+        "advance.rejected",
+        "intake.reopened",
+        "design.question_recorded",
+        "design.answer_recorded",
+        "design.invalidated",
+        "routing.captured",
+        "state.transition"
+      ]
+    },
+    {
+      "status": "discovering",
+      "macroPhase": "SHAPE",
+      "stable": false,
+      "terminal": false,
+      "transitions": [
+        {
+          "target": "awaiting_profile_choice",
+          "guards": [
+            "discovery_sufficient"
+          ]
+        },
+        {
+          "target": "awaiting_shape_decision",
+          "guards": []
+        },
+        {
+          "target": "awaiting_intake_decision",
+          "guards": []
+        },
+        {
+          "target": "intaking",
+          "guards": [
+            "intake_reopened"
+          ]
+        },
+        {
+          "target": "blocked",
+          "guards": [
+            "resume_metadata_valid"
+          ]
+        },
+        {
+          "target": "cancelled",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        },
+        {
+          "target": "failed",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        }
+      ],
+      "capsule": {
+        "consumes": [
+          "design.product-baseline",
+          "design.glossary-deltas",
+          "design.domain-rules",
+          "risk",
+          "constraints",
+          "routing",
+          "workspace",
+          "shape.state"
+        ],
+        "produces": [
+          "shape.targets",
+          "shape.evidence",
+          "shape.profile-choice",
+          "design.technical-decisions",
+          "design.question",
+          "shape.contract",
+          "shape.projection",
+          "freshness.sources"
+        ],
+        "invalidates": [
+          "shape.dependency-closure",
+          "approvals",
+          "build",
+          "assurance"
+        ]
+      },
+      "events": [
+        "discovery.target_recorded",
+        "discovery.evidence_recorded",
+        "discovery.completed",
+        "profile.choice_requested",
+        "profile.choice_recorded",
+        "design.question_recorded",
+        "design.answer_recorded",
+        "design.invalidated",
+        "contract.projected",
+        "projection.reconciliation_requested",
+        "evidence.invalidated",
+        "shape.checkpoint",
+        "state.transition"
+      ]
+    },
+    {
+      "status": "awaiting_shape_decision",
+      "macroPhase": "SHAPE",
+      "stable": false,
+      "terminal": false,
+      "transitions": [
+        {
+          "target": "discovering",
+          "guards": []
+        },
+        {
+          "target": "planning",
+          "guards": [
+            "discovery_sufficient",
+            "profile_selected"
+          ]
+        },
+        {
+          "target": "awaiting_intake_decision",
+          "guards": []
+        },
+        {
+          "target": "intaking",
+          "guards": [
+            "intake_reopened"
+          ]
+        },
+        {
+          "target": "blocked",
+          "guards": [
+            "resume_metadata_valid"
+          ]
+        },
+        {
+          "target": "cancelled",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        },
+        {
+          "target": "failed",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        }
+      ],
+      "capsule": {
+        "consumes": [
+          "design.product-baseline",
+          "design.glossary-deltas",
+          "design.domain-rules",
+          "risk",
+          "constraints",
+          "routing",
+          "workspace",
+          "shape.state"
+        ],
+        "produces": [
+          "shape.targets",
+          "shape.evidence",
+          "shape.profile-choice",
+          "design.technical-decisions",
+          "design.question",
+          "shape.contract",
+          "shape.projection",
+          "freshness.sources"
+        ],
+        "invalidates": [
+          "shape.dependency-closure",
+          "approvals",
+          "build",
+          "assurance"
+        ]
+      },
+      "events": [
+        "discovery.target_recorded",
+        "discovery.evidence_recorded",
+        "discovery.completed",
+        "profile.choice_requested",
+        "profile.choice_recorded",
+        "design.question_recorded",
+        "design.answer_recorded",
+        "design.invalidated",
+        "contract.projected",
+        "projection.reconciliation_requested",
+        "evidence.invalidated",
+        "shape.checkpoint",
+        "state.transition"
+      ]
+    },
+    {
+      "status": "awaiting_profile_choice",
+      "macroPhase": "SHAPE",
+      "stable": false,
+      "terminal": false,
+      "transitions": [
+        {
+          "target": "planning",
+          "guards": [
+            "profile_selected"
+          ]
+        },
+        {
+          "target": "discovering",
+          "guards": []
+        },
+        {
+          "target": "intaking",
+          "guards": [
+            "intake_reopened"
+          ]
+        },
+        {
+          "target": "blocked",
+          "guards": [
+            "resume_metadata_valid"
+          ]
+        },
+        {
+          "target": "cancelled",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        },
+        {
+          "target": "failed",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        }
+      ],
+      "capsule": {
+        "consumes": [
+          "design.product-baseline",
+          "design.glossary-deltas",
+          "design.domain-rules",
+          "risk",
+          "constraints",
+          "routing",
+          "workspace",
+          "shape.state"
+        ],
+        "produces": [
+          "shape.targets",
+          "shape.evidence",
+          "shape.profile-choice",
+          "design.technical-decisions",
+          "design.question",
+          "shape.contract",
+          "shape.projection",
+          "freshness.sources"
+        ],
+        "invalidates": [
+          "shape.dependency-closure",
+          "approvals",
+          "build",
+          "assurance"
+        ]
+      },
+      "events": [
+        "discovery.target_recorded",
+        "discovery.evidence_recorded",
+        "discovery.completed",
+        "profile.choice_requested",
+        "profile.choice_recorded",
+        "design.question_recorded",
+        "design.answer_recorded",
+        "design.invalidated",
+        "contract.projected",
+        "projection.reconciliation_requested",
+        "evidence.invalidated",
+        "shape.checkpoint",
+        "state.transition"
+      ]
+    },
+    {
+      "status": "planning",
+      "macroPhase": "SHAPE",
+      "stable": false,
+      "terminal": false,
+      "transitions": [
+        {
+          "target": "discovering",
+          "guards": []
+        },
+        {
+          "target": "awaiting_intake_decision",
+          "guards": []
+        },
+        {
+          "target": "awaiting_approval",
+          "guards": [
+            "discovery_sufficient",
+            "profile_selected",
+            "contract_complete"
+          ]
+        },
+        {
+          "target": "intaking",
+          "guards": [
+            "intake_reopened"
+          ]
+        },
+        {
+          "target": "blocked",
+          "guards": [
+            "resume_metadata_valid"
+          ]
+        },
+        {
+          "target": "cancelled",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        },
+        {
+          "target": "failed",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        }
+      ],
+      "capsule": {
+        "consumes": [
+          "design.product-baseline",
+          "design.glossary-deltas",
+          "design.domain-rules",
+          "risk",
+          "constraints",
+          "routing",
+          "workspace",
+          "shape.state"
+        ],
+        "produces": [
+          "shape.targets",
+          "shape.evidence",
+          "shape.profile-choice",
+          "design.technical-decisions",
+          "design.question",
+          "shape.contract",
+          "shape.projection",
+          "freshness.sources"
+        ],
+        "invalidates": [
+          "shape.dependency-closure",
+          "approvals",
+          "build",
+          "assurance"
+        ]
+      },
+      "events": [
+        "discovery.target_recorded",
+        "discovery.evidence_recorded",
+        "discovery.completed",
+        "profile.choice_requested",
+        "profile.choice_recorded",
+        "design.question_recorded",
+        "design.answer_recorded",
+        "design.invalidated",
+        "contract.projected",
+        "projection.reconciliation_requested",
+        "evidence.invalidated",
+        "shape.checkpoint",
+        "state.transition"
+      ]
+    },
+    {
+      "status": "awaiting_intake_decision",
+      "macroPhase": "INTAKE",
+      "stable": false,
+      "terminal": false,
+      "transitions": [
+        {
+          "target": "intaking",
+          "guards": [
+            "intake_reopened"
+          ]
+        },
+        {
+          "target": "discovering",
+          "guards": [
+            "intake_complete"
+          ]
+        },
+        {
+          "target": "planning",
+          "guards": [
+            "intake_complete",
+            "discovery_sufficient",
+            "profile_selected"
+          ]
+        },
+        {
+          "target": "blocked",
+          "guards": [
+            "resume_metadata_valid"
+          ]
+        },
+        {
+          "target": "cancelled",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        },
+        {
+          "target": "failed",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        }
+      ],
+      "capsule": {
+        "consumes": [
+          "request",
+          "constraints",
+          "design.product-reopen"
+        ],
+        "produces": [
+          "design.product-baseline",
+          "design.glossary-deltas",
+          "design.domain-rules",
+          "design.question",
+          "risk",
+          "routing",
+          "workspace",
+          "freshness.config",
+          "freshness.policy"
+        ],
+        "invalidates": [
+          "intake.dependent-decisions",
+          "shape.dependency-closure",
+          "approvals"
+        ]
+      },
+      "events": [
+        "task.initialized",
+        "intake.checkpoint",
+        "advance.rejected",
+        "intake.reopened",
+        "design.question_recorded",
+        "design.answer_recorded",
+        "design.invalidated",
+        "routing.captured",
+        "state.transition"
+      ]
+    },
+    {
+      "status": "awaiting_approval",
+      "macroPhase": "GATE",
+      "stable": false,
+      "terminal": false,
+      "transitions": [
+        {
+          "target": "planning",
+          "guards": [
+            "gate_decision_valid"
+          ]
+        },
+        {
+          "target": "executing",
+          "guards": [
+            "gate_decision_valid"
+          ]
+        },
+        {
+          "target": "cancelled",
+          "guards": [
+            "gate_decision_valid",
+            "terminal_source_recorded"
+          ]
+        },
+        {
+          "target": "intaking",
+          "guards": [
+            "intake_reopened"
+          ]
+        },
+        {
+          "target": "blocked",
+          "guards": [
+            "resume_metadata_valid"
+          ]
+        },
+        {
+          "target": "failed",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        }
+      ],
+      "capsule": {
+        "consumes": [
+          "shape.contract",
+          "shape.evidence",
+          "risk"
+        ],
+        "produces": [
+          "planApproval"
+        ],
+        "invalidates": [
+          "approvals"
+        ]
+      },
+      "events": [
+        "approval.requested",
+        "approval.recorded",
+        "approval.invalidated",
+        "state.transition"
+      ]
+    },
+    {
+      "status": "executing",
+      "macroPhase": "BUILD",
+      "stable": false,
+      "terminal": false,
+      "transitions": [
+        {
+          "target": "assuring",
+          "guards": []
+        },
+        {
+          "target": "planning",
+          "guards": []
+        },
+        {
+          "target": "intaking",
+          "guards": [
+            "intake_reopened"
+          ]
+        },
+        {
+          "target": "blocked",
+          "guards": [
+            "resume_metadata_valid"
+          ]
+        },
+        {
+          "target": "cancelled",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        },
+        {
+          "target": "failed",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        }
+      ],
+      "capsule": {
+        "consumes": [
+          "shape.contract",
+          "approvals",
+          "workspace"
+        ],
+        "produces": [],
+        "invalidates": [
+          "assurance"
+        ]
+      },
+      "events": [
+        "state.transition"
+      ]
+    },
+    {
+      "status": "assuring",
+      "macroPhase": "ASSURE",
+      "stable": false,
+      "terminal": false,
+      "transitions": [
+        {
+          "target": "planning",
+          "guards": []
+        },
+        {
+          "target": "intaking",
+          "guards": [
+            "intake_reopened"
+          ]
+        },
+        {
+          "target": "blocked",
+          "guards": [
+            "resume_metadata_valid"
+          ]
+        },
+        {
+          "target": "cancelled",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        },
+        {
+          "target": "failed",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        }
+      ],
+      "capsule": {
+        "consumes": [
+          "shape.contract",
+          "workspace",
+          "issues.active",
+          "freshness"
+        ],
+        "produces": [
+          "assurance",
+          "issues.active",
+          "freshness.commands"
+        ],
+        "invalidates": [
+          "assurance.findings",
+          "assurance.evidence",
+          "approvals"
+        ]
+      },
+      "events": [
+        "issue.recorded",
+        "correction.recorded",
+        "assurance.issue_resolved",
+        "assurance.evidence_recorded",
+        "assurance.evidence_invalidated",
+        "assurance.human_observation_requested",
+        "assure.completed",
+        "state.transition"
+      ]
+    },
+    {
+      "status": "blocked",
+      "macroPhase": "resumeTo",
+      "stable": true,
+      "terminal": false,
+      "transitions": [
+        {
+          "target": "intaking",
+          "guards": [
+            "resume_metadata_valid",
+            "resume_reconciled",
+            "task_initialized",
+            "effective_constraints_valid"
+          ]
+        },
+        {
+          "target": "discovering",
+          "guards": [
+            "resume_metadata_valid",
+            "resume_reconciled",
+            "intake_complete",
+            "routing_ready",
+            "workspace_ready"
+          ]
+        },
+        {
+          "target": "awaiting_shape_decision",
+          "guards": [
+            "resume_metadata_valid",
+            "resume_reconciled"
+          ]
+        },
+        {
+          "target": "awaiting_profile_choice",
+          "guards": [
+            "resume_metadata_valid",
+            "resume_reconciled",
+            "discovery_sufficient"
+          ]
+        },
+        {
+          "target": "planning",
+          "guards": [
+            "resume_metadata_valid",
+            "resume_reconciled",
+            "discovery_sufficient",
+            "profile_selected"
+          ]
+        },
+        {
+          "target": "awaiting_intake_decision",
+          "guards": [
+            "resume_metadata_valid",
+            "resume_reconciled"
+          ]
+        },
+        {
+          "target": "awaiting_approval",
+          "guards": [
+            "resume_metadata_valid",
+            "resume_reconciled",
+            "contract_complete"
+          ]
+        },
+        {
+          "target": "executing",
+          "guards": [
+            "resume_metadata_valid",
+            "resume_reconciled",
+            "approval_current"
+          ]
+        },
+        {
+          "target": "assuring",
+          "guards": [
+            "resume_metadata_valid",
+            "resume_reconciled"
+          ]
+        },
+        {
+          "target": "cancelled",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        },
+        {
+          "target": "failed",
+          "guards": [
+            "terminal_source_recorded"
+          ]
+        }
+      ],
+      "capsule": {
+        "consumes": [
+          "resume.metadata",
+          "freshness"
+        ],
+        "produces": [
+          "resume.reconciliation"
+        ],
+        "invalidates": []
+      },
+      "events": [
+        "task.resumed",
+        "state.transition"
+      ]
+    },
+    {
+      "status": "cancelled",
+      "macroPhase": "terminalSource",
+      "stable": true,
+      "terminal": true,
+      "transitions": [],
+      "capsule": {
+        "consumes": [
+          "terminal.source",
+          "freshness"
+        ],
+        "produces": [
+          "terminal.summary"
+        ],
+        "invalidates": []
+      },
+      "events": [
+        "task.cancelled"
+      ]
+    },
+    {
+      "status": "failed",
+      "macroPhase": "terminalSource",
+      "stable": true,
+      "terminal": true,
+      "transitions": [],
+      "capsule": {
+        "consumes": [
+          "terminal.source",
+          "issues.active",
+          "freshness"
+        ],
+        "produces": [
+          "terminal.summary"
+        ],
+        "invalidates": []
+      },
+      "events": [
+        "task.failed"
+      ]
+    }
+  ]
+}