openplanr 1.4.3 → 1.5.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 (59) hide show
  1. package/README.md +256 -250
  2. package/dist/ai/prompts/prompt-builder.d.ts +1 -1
  3. package/dist/ai/prompts/prompt-builder.js +1 -1
  4. package/dist/ai/prompts/system-prompts.d.ts +1 -1
  5. package/dist/ai/prompts/system-prompts.d.ts.map +1 -1
  6. package/dist/ai/prompts/system-prompts.js +2 -2
  7. package/dist/ai/prompts/system-prompts.js.map +1 -1
  8. package/dist/ai/schemas/ai-response-schemas.js +4 -4
  9. package/dist/ai/schemas/ai-response-schemas.js.map +1 -1
  10. package/dist/cli/commands/init.d.ts.map +1 -1
  11. package/dist/cli/commands/init.js +14 -1
  12. package/dist/cli/commands/init.js.map +1 -1
  13. package/dist/cli/commands/rules.d.ts.map +1 -1
  14. package/dist/cli/commands/rules.js +43 -2
  15. package/dist/cli/commands/rules.js.map +1 -1
  16. package/dist/cli/commands/spec.d.ts +1 -1
  17. package/dist/cli/commands/spec.js +9 -9
  18. package/dist/cli/commands/spec.js.map +1 -1
  19. package/dist/generators/base-generator.d.ts +15 -1
  20. package/dist/generators/base-generator.d.ts.map +1 -1
  21. package/dist/generators/base-generator.js +21 -0
  22. package/dist/generators/base-generator.js.map +1 -1
  23. package/dist/generators/claude-generator.d.ts.map +1 -1
  24. package/dist/generators/claude-generator.js +25 -8
  25. package/dist/generators/claude-generator.js.map +1 -1
  26. package/dist/generators/codex-generator.d.ts.map +1 -1
  27. package/dist/generators/codex-generator.js +17 -2
  28. package/dist/generators/codex-generator.js.map +1 -1
  29. package/dist/generators/cursor-generator.d.ts +4 -0
  30. package/dist/generators/cursor-generator.d.ts.map +1 -1
  31. package/dist/generators/cursor-generator.js +67 -8
  32. package/dist/generators/cursor-generator.js.map +1 -1
  33. package/dist/models/types.d.ts +12 -1
  34. package/dist/models/types.d.ts.map +1 -1
  35. package/dist/services/spec-service.d.ts +5 -5
  36. package/dist/services/spec-service.js +7 -7
  37. package/dist/services/spec-service.js.map +1 -1
  38. package/dist/templates/rules/claude/CLAUDE.md.hbs +14 -0
  39. package/dist/templates/rules/claude/planr-pipeline.md.hbs +68 -0
  40. package/dist/templates/rules/codex/_pipeline-section.md.hbs +150 -0
  41. package/dist/templates/rules/cursor/agents/backend-agent.md +299 -0
  42. package/dist/templates/rules/cursor/agents/db-agent.md +163 -0
  43. package/dist/templates/rules/cursor/agents/designer-agent.md +219 -0
  44. package/dist/templates/rules/cursor/agents/devops-agent.md +197 -0
  45. package/dist/templates/rules/cursor/agents/doc-gen-agent.md +203 -0
  46. package/dist/templates/rules/cursor/agents/frontend-agent.md +220 -0
  47. package/dist/templates/rules/cursor/agents/qa-agent.md +170 -0
  48. package/dist/templates/rules/cursor/agents/specification-agent.md +282 -0
  49. package/dist/templates/rules/cursor/planr-pipeline-plan.mdc.hbs +194 -0
  50. package/dist/templates/rules/cursor/planr-pipeline-ship.mdc.hbs +242 -0
  51. package/dist/templates/rules/cursor/planr-pipeline.mdc.hbs +134 -0
  52. package/dist/templates/spec/spec-shaped.md.hbs +1 -1
  53. package/dist/templates/spec/spec.md.hbs +3 -3
  54. package/dist/templates/spec/task.md.hbs +1 -1
  55. package/dist/utils/constants.d.ts +24 -3
  56. package/dist/utils/constants.d.ts.map +1 -1
  57. package/dist/utils/constants.js +24 -3
  58. package/dist/utils/constants.js.map +1 -1
  59. package/package.json +1 -1
@@ -5,6 +5,27 @@ const __dirname = path.dirname(__filename);
5
5
  export const CONFIG_FILENAME = '.planr/config.json';
6
6
  export const DEFAULT_AGILE_DIR = '.planr';
7
7
  export const DEFAULT_CURSOR_RULES_DIR = '.cursor/rules';
8
+ /**
9
+ * OpenPlanr Protocol version that the `--scope pipeline` rule generators
10
+ * conform to. The protocol is the runtime-agnostic contract for spec-driven
11
+ * mode artifacts (SPEC, US, Task schemas; PLAN/SHIP command contracts; agent
12
+ * roles). Bumps RARELY — only on artifact-schema breaks or workflow
13
+ * contract changes, NOT on pipeline plugin patches.
14
+ *
15
+ * NOT to be confused with the planr-pipeline plugin version (which moves
16
+ * fast and is tracked in the marketplace pin file, not here). Generated rule
17
+ * files reference the protocol contract; the runtime adapter (Claude Code
18
+ * plugin / Cursor MDC / Codex AGENTS.md) writes its own actual version into
19
+ * the `.pipeline-shipped` marker at execution time.
20
+ *
21
+ * Read by:
22
+ * - CursorGenerator (renders into Cursor MDC headers)
23
+ * - ClaudeGenerator (renders into the sibling `planr-pipeline.md` reference card)
24
+ * - CodexGenerator (renders into the AGENTS.md pipeline section)
25
+ *
26
+ * See `planr-pipeline/docs/protocol/` for the full protocol spec.
27
+ */
28
+ export const OPENPLANR_PROTOCOL_VERSION = '1.0.0';
8
29
  export const ARTIFACT_DIRS = {
9
30
  epics: 'epics',
10
31
  features: 'features',
@@ -38,14 +59,14 @@ export const VALID_STATUSES = {
38
59
  /**
39
60
  * Spec-driven mode (third planning posture) uses a richer status lifecycle
40
61
  * because each phase corresponds to a different role transition:
41
- * PO authoring → AI decomposition → human review → handoff to openplanr-pipeline.
62
+ * PO authoring → AI decomposition → human review → handoff to planr-pipeline.
42
63
  *
43
64
  * - pending — SPEC created, body not yet written
44
65
  * - shaping — SPEC body authored (manually or via `planr spec shape`)
45
66
  * - decomposing — `planr spec decompose` is running (AI generating US + tasks)
46
67
  * - decomposed — US + Task files written, awaiting human review
47
- * - ready-for-pipeline — `planr spec promote` validated; ready for openplanr-pipeline
48
- * - in-pipeline — openplanr-pipeline `/plan` or `/ship` is running
68
+ * - ready-for-pipeline — `planr spec promote` validated; ready for planr-pipeline
69
+ * - in-pipeline — planr-pipeline `/plan` or `/ship` is running
49
70
  * - done — DEV phase complete, code shipped
50
71
  */
51
72
  export const VALID_SPEC_STATUSES = [
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAEpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAC1C,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAExD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,YAAY;CAChB,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAqD;IAC9E,IAAI,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC;IACvC,MAAM,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC;CAC5C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS;IACT,SAAS;IACT,aAAa;IACb,YAAY;IACZ,oBAAoB;IACpB,aAAa;IACb,MAAM;CACE,CAAC;AAIX,wEAAwE;AACxE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AACjG,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAE/F,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AACpD,CAAC"}
1
+ {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAEpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAC1C,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAExD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAElD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,YAAY;CAChB,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAqD;IAC9E,IAAI,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC;IACvC,MAAM,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC;CAC5C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS;IACT,SAAS;IACT,aAAa;IACb,YAAY;IACZ,oBAAoB;IACpB,aAAa;IACb,MAAM;CACE,CAAC;AAIX,wEAAwE;AACxE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AACjG,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAE/F,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AACpD,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openplanr",
3
- "version": "1.4.3",
3
+ "version": "1.5.1",
4
4
  "description": "AI-powered planning CLI — backlog, sprints, task templates, estimation, GitHub and Linear sync, and AI agent rules for Cursor, Claude Code, and Codex",
5
5
  "type": "module",
6
6
  "main": "./dist/cli/index.js",