spell 0.8.7 → 0.8.8

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 (243) hide show
  1. package/README-epics.md +96 -36
  2. package/app/package.json +25 -1
  3. package/dist/cli/publish/PublishedPackage.d.ts +2 -1
  4. package/dist/cli/publish/PublishedPackage.js +6 -3
  5. package/dist/cli/publish/ScratchInstall.d.ts +14 -3
  6. package/dist/cli/publish/ScratchInstall.js +69 -8
  7. package/dist/epic/cli/EpicProgram.js +7 -1
  8. package/dist/epic/cli/epicGroups.js +2 -1
  9. package/dist/epic/command/BaseBranch.d.ts +35 -0
  10. package/dist/epic/command/BaseBranch.js +58 -0
  11. package/dist/epic/command/EpicCheckout.d.ts +1 -1
  12. package/dist/epic/command/EpicCheckout.js +4 -4
  13. package/dist/epic/command/EpicGuide.js +3 -2
  14. package/dist/epic/command/EpicTools.d.ts +5 -0
  15. package/dist/epic/command/EpicTools.js +14 -3
  16. package/dist/epic/command/MainMerge.d.ts +26 -15
  17. package/dist/epic/command/MainMerge.js +60 -16
  18. package/dist/epic/command/RepoInit.d.ts +116 -8
  19. package/dist/epic/command/RepoInit.js +308 -13
  20. package/dist/epic/command/Requests.d.ts +1 -0
  21. package/dist/epic/command/Requests.js +6 -1
  22. package/dist/epic/command/SessionMoves.js +2 -1
  23. package/dist/epic/command/SkillsCheck.js +3 -2
  24. package/dist/epic/command/Stock.js +3 -1
  25. package/dist/epic/command/TurnEnd.d.ts +1 -1
  26. package/dist/epic/command/TurnEnd.js +4 -3
  27. package/dist/epic/command/Worktrees.d.ts +18 -3
  28. package/dist/epic/command/Worktrees.js +38 -7
  29. package/dist/epic/command/command.types.d.ts +3 -0
  30. package/dist/epic/components/__pack/epics.entry.js +43 -43
  31. package/dist/epic/components/__pack/epics.pack.js +36 -12794
  32. package/dist/epic/config/EngineFiles.mjs +60 -0
  33. package/dist/epic/config/EpicConfig.d.ts +12 -2
  34. package/dist/epic/config/EpicConfig.js +9 -1
  35. package/dist/epic/config/GitHub.d.ts +41 -1
  36. package/dist/epic/config/GitHub.js +75 -3
  37. package/dist/epic/config/LayeredSettings.js +3 -2
  38. package/dist/epic/server/EpicServer.d.ts +1 -1
  39. package/dist/epic/server/EpicServer.js +26 -12
  40. package/dist/epic/tool/InboxPoller.mjs +2 -1
  41. package/dist/epic/tool/MigrateCommands.js +6 -8
  42. package/dist/epic/tool/PlanDocFiles.js +3 -2
  43. package/dist/epic/tool/ServedFolders.d.ts +1 -1
  44. package/dist/epic/tool/ServedFolders.js +4 -4
  45. package/dist/epic/tools/PageInboxes.js +3 -3
  46. package/dist/epic/tools/_assets/commands.entry.js +149 -68
  47. package/dist/epic/tools/_assets/commands.js +20 -2073
  48. package/dist/epic/tools/_assets/core-reference.entry.js +244 -124
  49. package/dist/epic/tools/_assets/core-reference.js +20 -2142
  50. package/dist/epic/tools/_assets/emoji/cldr/0.js +2 -2
  51. package/dist/epic/tools/_assets/emoji/cldr/a.js +2 -2
  52. package/dist/epic/tools/_assets/emoji/cldr/b.js +2 -2
  53. package/dist/epic/tools/_assets/emoji/cldr/c.js +2 -2
  54. package/dist/epic/tools/_assets/emoji/cldr/d.js +2 -2
  55. package/dist/epic/tools/_assets/emoji/cldr/e.js +2 -2
  56. package/dist/epic/tools/_assets/emoji/cldr/f.js +2 -2
  57. package/dist/epic/tools/_assets/emoji/cldr/g.js +2 -2
  58. package/dist/epic/tools/_assets/emoji/cldr/h.js +2 -2
  59. package/dist/epic/tools/_assets/emoji/cldr/i.js +2 -2
  60. package/dist/epic/tools/_assets/emoji/cldr/j.js +2 -2
  61. package/dist/epic/tools/_assets/emoji/cldr/k.js +2 -2
  62. package/dist/epic/tools/_assets/emoji/cldr/l.js +2 -2
  63. package/dist/epic/tools/_assets/emoji/cldr/m.js +2 -2
  64. package/dist/epic/tools/_assets/emoji/cldr/n.js +2 -2
  65. package/dist/epic/tools/_assets/emoji/cldr/o.js +2 -2
  66. package/dist/epic/tools/_assets/emoji/cldr/p.js +2 -2
  67. package/dist/epic/tools/_assets/emoji/cldr/r.js +2 -2
  68. package/dist/epic/tools/_assets/emoji/cldr/s.js +2 -2
  69. package/dist/epic/tools/_assets/emoji/cldr/t.js +2 -2
  70. package/dist/epic/tools/_assets/emoji/cldr/u.js +2 -2
  71. package/dist/epic/tools/_assets/emoji/cldr/v.js +2 -2
  72. package/dist/epic/tools/_assets/emoji/cldr/w.js +2 -2
  73. package/dist/epic/tools/_assets/emoji/cldr/x.js +2 -2
  74. package/dist/epic/tools/_assets/emoji/cldr/y.js +2 -2
  75. package/dist/epic/tools/_assets/emoji/cldr/z.js +2 -2
  76. package/dist/epic/tools/_assets/emoji/fomantic/0.js +2 -2
  77. package/dist/epic/tools/_assets/emoji/fomantic/a.js +2 -2
  78. package/dist/epic/tools/_assets/emoji/fomantic/b.js +2 -2
  79. package/dist/epic/tools/_assets/emoji/fomantic/c.js +2 -2
  80. package/dist/epic/tools/_assets/emoji/fomantic/d.js +2 -2
  81. package/dist/epic/tools/_assets/emoji/fomantic/e.js +2 -2
  82. package/dist/epic/tools/_assets/emoji/fomantic/f.js +2 -2
  83. package/dist/epic/tools/_assets/emoji/fomantic/g.js +2 -2
  84. package/dist/epic/tools/_assets/emoji/fomantic/h.js +2 -2
  85. package/dist/epic/tools/_assets/emoji/fomantic/i.js +2 -2
  86. package/dist/epic/tools/_assets/emoji/fomantic/j.js +2 -2
  87. package/dist/epic/tools/_assets/emoji/fomantic/k.js +2 -2
  88. package/dist/epic/tools/_assets/emoji/fomantic/l.js +2 -2
  89. package/dist/epic/tools/_assets/emoji/fomantic/m.js +2 -2
  90. package/dist/epic/tools/_assets/emoji/fomantic/n.js +2 -2
  91. package/dist/epic/tools/_assets/emoji/fomantic/o.js +2 -2
  92. package/dist/epic/tools/_assets/emoji/fomantic/p.js +2 -2
  93. package/dist/epic/tools/_assets/emoji/fomantic/q.js +2 -2
  94. package/dist/epic/tools/_assets/emoji/fomantic/r.js +2 -2
  95. package/dist/epic/tools/_assets/emoji/fomantic/s.js +2 -2
  96. package/dist/epic/tools/_assets/emoji/fomantic/t.js +2 -2
  97. package/dist/epic/tools/_assets/emoji/fomantic/u.js +2 -2
  98. package/dist/epic/tools/_assets/emoji/fomantic/v.js +2 -2
  99. package/dist/epic/tools/_assets/emoji/fomantic/w.js +2 -2
  100. package/dist/epic/tools/_assets/emoji/fomantic/x.js +2 -2
  101. package/dist/epic/tools/_assets/emoji/fomantic/y.js +2 -2
  102. package/dist/epic/tools/_assets/emoji/fomantic/z.js +2 -2
  103. package/dist/epic/tools/_assets/goals-live.js +318 -210
  104. package/dist/epic/tools/_assets/highlight.min.js +5764 -5269
  105. package/dist/epic/tools/_assets/lazy/code-engine.js +5 -1270
  106. package/dist/epic/tools/_assets/lazy/markdown-engine.js +67 -1513
  107. package/dist/epic/tools/_assets/lazy/markdown-sanitizer.js +3 -753
  108. package/dist/epic/tools/_assets/spell-comments.entry.js +282 -159
  109. package/dist/epic/tools/_assets/spell-comments.js +24 -3716
  110. package/dist/epic/tools/_assets/spell-doc-comments.js +1243 -816
  111. package/dist/epic/tools/_assets/spell-doc-helpers.js +298 -165
  112. package/dist/epic/tools/_assets/spell-doc-runtime.js +2760 -1415
  113. package/dist/epic/tools/_assets/spell-doc-toolbar.js +396 -227
  114. package/dist/epic/tools/_assets/spell-syntax.entry.js +505 -285
  115. package/dist/epic/tools/_assets/spell-syntax.js +22 -2916
  116. package/dist/epic/tools/_assets/spell-ui-sources.js +102 -60
  117. package/dist/epic/tools/_assets/spell-ui.entry.js +108 -40
  118. package/dist/epic/tools/_assets/spell-ui.js +3131 -46465
  119. package/dist/epic/tools/pages.d.ts +5 -6
  120. package/dist/epic/tools/pages.js +7 -6
  121. package/dist/epic/window.mjs +2 -3
  122. package/dist/ui/components/ui-accordion/UIAccordion.d.ts +1 -0
  123. package/dist/ui/components/ui-ad/UIAd.d.ts +1 -0
  124. package/dist/ui/components/ui-breadcrumbs/UIBreadcrumb.d.ts +1 -0
  125. package/dist/ui/components/ui-breadcrumbs/UIBreadcrumbs.d.ts +1 -0
  126. package/dist/ui/components/ui-button/UIButton.d.ts +8 -3
  127. package/dist/ui/components/ui-button/UIButton.fallback.d.ts +8 -3
  128. package/dist/ui/components/ui-button/UIButtons.d.ts +1 -0
  129. package/dist/ui/components/ui-button/UIOr.d.ts +1 -0
  130. package/dist/ui/components/ui-calendar/UICalendar.d.ts +6 -0
  131. package/dist/ui/components/ui-calendar/UICalendar.fallback.d.ts +6 -0
  132. package/dist/ui/components/ui-card/UICards.d.ts +31 -0
  133. package/dist/ui/components/ui-checkbox/UICheckbox.d.ts +7 -0
  134. package/dist/ui/components/ui-checkbox/UICheckbox.fallback.d.ts +7 -0
  135. package/dist/ui/components/ui-comment/UIComment.d.ts +1 -0
  136. package/dist/ui/components/ui-comment/UIComments.d.ts +1 -0
  137. package/dist/ui/components/ui-components/UIComponents.d.ts +1 -0
  138. package/dist/ui/components/ui-dimmer/UIDimmer.d.ts +1 -0
  139. package/dist/ui/components/ui-divider/UIDivider.d.ts +2 -0
  140. package/dist/ui/components/ui-dropdown/UIDropdown.d.ts +6 -0
  141. package/dist/ui/components/ui-dropdown/UIDropdown.fallback.d.ts +6 -0
  142. package/dist/ui/components/ui-embed/UIEmbed.d.ts +1 -0
  143. package/dist/ui/components/ui-emoji/UIEmoji.d.ts +1 -0
  144. package/dist/ui/components/ui-feed/UIFeed.d.ts +1 -0
  145. package/dist/ui/components/ui-feed/UIFeedEvent.d.ts +1 -0
  146. package/dist/ui/components/ui-flag/UIFlag.d.ts +1 -0
  147. package/dist/ui/components/ui-flyout/UIFlyout.d.ts +1 -0
  148. package/dist/ui/components/ui-form/UIFields.d.ts +1 -0
  149. package/dist/ui/components/ui-form/UIRepeat.d.ts +1 -0
  150. package/dist/ui/components/ui-grid/UIColumn.d.ts +1 -0
  151. package/dist/ui/components/ui-grid/UIGrid.d.ts +1 -0
  152. package/dist/ui/components/ui-grid/UIRow.d.ts +1 -0
  153. package/dist/ui/components/ui-icon/UIIcon.d.ts +3 -2
  154. package/dist/ui/components/ui-icon/UIIcons.d.ts +1 -0
  155. package/dist/ui/components/ui-icon-picker/UIIconPicker.d.ts +6 -0
  156. package/dist/ui/components/ui-icon-picker/UIIconPicker.fallback.d.ts +6 -0
  157. package/dist/ui/components/ui-image/UIImages.d.ts +1 -0
  158. package/dist/ui/components/ui-include/UIInclude.d.ts +1 -0
  159. package/dist/ui/components/ui-input/UIInput.fallback.d.ts +9 -2
  160. package/dist/ui/components/ui-items/UIItems.d.ts +1 -0
  161. package/dist/ui/components/ui-keys/UIKeys.d.ts +1 -0
  162. package/dist/ui/components/ui-label/UILabel.d.ts +2 -0
  163. package/dist/ui/components/ui-label/UILabels.d.ts +1 -0
  164. package/dist/ui/components/ui-list/UIList.d.ts +2 -0
  165. package/dist/ui/components/ui-loader/UILoader.d.ts +1 -0
  166. package/dist/ui/components/ui-message/UIMessage.d.ts +2 -0
  167. package/dist/ui/components/ui-modal/UIModal.d.ts +1 -0
  168. package/dist/ui/components/ui-nag/UINag.d.ts +1 -0
  169. package/dist/ui/components/ui-page/UIPage.d.ts +15 -0
  170. package/dist/ui/components/ui-page/UIPage.es.d.ts +1 -0
  171. package/dist/ui/components/ui-parts/UIActions.d.ts +1 -0
  172. package/dist/ui/components/ui-parts/UIAuthor.d.ts +1 -0
  173. package/dist/ui/components/ui-parts/UIAvatar.d.ts +1 -0
  174. package/dist/ui/components/ui-parts/UIContent.d.ts +1 -0
  175. package/dist/ui/components/ui-parts/UIDate.d.ts +1 -0
  176. package/dist/ui/components/ui-parts/UIDescription.d.ts +1 -0
  177. package/dist/ui/components/ui-parts/UIDetail.d.ts +1 -0
  178. package/dist/ui/components/ui-parts/UIExtra.d.ts +1 -0
  179. package/dist/ui/components/ui-parts/UIHeader.d.ts +3 -1
  180. package/dist/ui/components/ui-parts/UIMeta.d.ts +1 -0
  181. package/dist/ui/components/ui-parts/UIParts.types.d.ts +15 -1
  182. package/dist/ui/components/ui-parts/UISummary.d.ts +1 -0
  183. package/dist/ui/components/ui-parts/UITitle.d.ts +1 -0
  184. package/dist/ui/components/ui-parts/UIValue.d.ts +1 -0
  185. package/dist/ui/components/ui-placeholder/UIPlaceholder.d.ts +1 -0
  186. package/dist/ui/components/ui-placeholder/UIPlaceholderHeader.d.ts +1 -0
  187. package/dist/ui/components/ui-placeholder/UIPlaceholderImage.d.ts +1 -0
  188. package/dist/ui/components/ui-placeholder/UIPlaceholderLine.d.ts +1 -0
  189. package/dist/ui/components/ui-placeholder/UIPlaceholderParagraph.d.ts +1 -0
  190. package/dist/ui/components/ui-progress/UIProgress.d.ts +2 -0
  191. package/dist/ui/components/ui-quote/UIQuote.d.ts +1 -0
  192. package/dist/ui/components/ui-rail/UIRail.d.ts +1 -0
  193. package/dist/ui/components/ui-rating/UIRating.d.ts +6 -0
  194. package/dist/ui/components/ui-rating/UIRating.fallback.d.ts +6 -0
  195. package/dist/ui/components/ui-reveal/UIReveal.d.ts +1 -0
  196. package/dist/ui/components/ui-search/UISearch.fallback.d.ts +13 -1
  197. package/dist/ui/components/ui-section/UISections.d.ts +1 -0
  198. package/dist/ui/components/ui-segment/UISegment.d.ts +2 -0
  199. package/dist/ui/components/ui-segment/UISegments.d.ts +1 -0
  200. package/dist/ui/components/ui-select/UISelect.d.ts +6 -0
  201. package/dist/ui/components/ui-select/UISelect.fallback.d.ts +6 -0
  202. package/dist/ui/components/ui-shape/UISide.d.ts +4 -0
  203. package/dist/ui/components/ui-sidebar/UIPushable.d.ts +1 -0
  204. package/dist/ui/components/ui-sidebar/UIPusher.d.ts +1 -0
  205. package/dist/ui/components/ui-sidebar/UISidebar.d.ts +1 -0
  206. package/dist/ui/components/ui-sides/UISides.d.ts +6 -0
  207. package/dist/ui/components/ui-sides/UISides.fallback.d.ts +6 -0
  208. package/dist/ui/components/ui-slider/UISlider.d.ts +7 -0
  209. package/dist/ui/components/ui-slider/UISlider.fallback.d.ts +7 -0
  210. package/dist/ui/components/ui-space/UISpace.d.ts +1 -0
  211. package/dist/ui/components/ui-statistic/UIStatistic.d.ts +1 -0
  212. package/dist/ui/components/ui-statistic/UIStatistics.d.ts +1 -0
  213. package/dist/ui/components/ui-step/UIStep.d.ts +1 -0
  214. package/dist/ui/components/ui-step/UISteps.d.ts +1 -0
  215. package/dist/ui/components/ui-table/UICell.d.ts +1 -0
  216. package/dist/ui/components/ui-terms/UITerm.d.ts +1 -0
  217. package/dist/ui/components/ui-terms/UITerms.d.ts +1 -0
  218. package/dist/ui/components/ui-theme-editor/UIColorChip.d.ts +1 -0
  219. package/dist/ui/components/ui-theme-editor/UIThemeToken.d.ts +1 -0
  220. package/dist/ui/components/ui-toast/UIToast.d.ts +1 -0
  221. package/dist/ui/components/ui-toc/UIToc.d.ts +1 -0
  222. package/dist/ui/components/ui-transition/UITransition.d.ts +1 -0
  223. package/dist/ui/components/ui-video/UIAudio.d.ts +1 -0
  224. package/dist/ui/components/ui-video/UIVideo.d.ts +1 -0
  225. package/dist/ui/components/ui-visibility/UIVisibility.d.ts +1 -0
  226. package/dist/ui/components/ui-zoom/UIZoom.d.ts +1 -0
  227. package/dist/util/spell/constants.js +1 -1
  228. package/epic/.claude-plugin/plugin.json +1 -1
  229. package/epic/.codex-plugin/plugin.json +1 -1
  230. package/epic/hooks/handoff.mjs +4 -3
  231. package/epic/hooks/worktree.mjs +22 -3
  232. package/epic/package.json +41 -2
  233. package/epic/skills/details/SKILL.md +2 -1
  234. package/epic/skills/epic/SKILL.md +7 -1
  235. package/epic/skills/epic/guide.md +4 -0
  236. package/epic/skills/isolate/SKILL.md +35 -0
  237. package/epic/src/AGENTS.md +6 -2
  238. package/epic/templates/durable.html +1 -1
  239. package/epic/vscode/package.json +1 -1
  240. package/epic/vscode/spell-epic.vsix +0 -0
  241. package/package.json +1 -1
  242. package/parser/package.json +1 -1
  243. package/ui/package.json +15 -2
@@ -20,6 +20,7 @@ import { sectionsVocabulary } from "./UISections.en";
20
20
  export declare class UISections extends E.UIComponent<typeof sectionsVocabulary> {
21
21
  static vocabulary: {
22
22
  readonly tag: "ui-sections";
23
+ readonly icon: "list alternate outline";
23
24
  readonly topics: readonly ["layout", "containers"];
24
25
  readonly aka: readonly ["accordion", "section group", "collapsible group", "outline"];
25
26
  readonly noun: "sections";
@@ -23,6 +23,8 @@ import { segmentVocabulary } from "./UISegment.en";
23
23
  export declare class UISegment extends E.UIComponent<typeof segmentVocabulary> {
24
24
  static vocabulary: {
25
25
  readonly tag: "ui-segment";
26
+ readonly icon: "square outline";
27
+ readonly snippet: "<ui-segment>A box for things</ui-segment>";
26
28
  readonly topics: readonly ["containers", "layout", "basic", "elements"];
27
29
  readonly aka: readonly ["panel", "box", "section", "well", "paper", "card"];
28
30
  readonly skeleton: "header, paragraph";
@@ -11,6 +11,7 @@ import { segmentsVocabulary } from "./UISegments.en";
11
11
  export declare class UISegments extends E.UIComponent<typeof segmentsVocabulary> {
12
12
  static vocabulary: {
13
13
  readonly tag: "ui-segments";
14
+ readonly icon: "clone outline";
14
15
  readonly topics: readonly ["containers", "layout", "elements"];
15
16
  readonly aka: readonly ["panel group", "stacked panels"];
16
17
  readonly noun: "segments";
@@ -30,6 +30,7 @@ import { type SelectBlock, type Vocabulary } from "./UISelect.types";
30
30
  export declare class UISelect extends F.FormComponent<Vocabulary> {
31
31
  static vocabulary: {
32
32
  readonly tag: "ui-select";
33
+ readonly icon: "caret square down outline";
33
34
  readonly formControl: true;
34
35
  readonly topics: readonly ["forms", "inputs", "selection", "controls", "modules"];
35
36
  readonly aka: readonly ["select box", "native select", "picker", "option list"];
@@ -99,6 +100,11 @@ export declare class UISelect extends F.FormComponent<Vocabulary> {
99
100
  readonly group: "name";
100
101
  readonly kind: "string";
101
102
  readonly description: "Form field name; `multiple` submits one entry per value.";
103
+ }, {
104
+ readonly name: "parameter";
105
+ readonly group: "form";
106
+ readonly kind: "string";
107
+ readonly description: string;
102
108
  }, {
103
109
  readonly name: "required";
104
110
  readonly group: "form";
@@ -22,6 +22,7 @@ import { type Vocabulary } from "./UISelect.types";
22
22
  export declare class SelectFallback extends E.NativeFallback<Vocabulary> {
23
23
  static vocabulary: {
24
24
  readonly tag: "ui-select";
25
+ readonly icon: "caret square down outline";
25
26
  readonly formControl: true;
26
27
  readonly topics: readonly ["forms", "inputs", "selection", "controls", "modules"];
27
28
  readonly aka: readonly ["select box", "native select", "picker", "option list"];
@@ -91,6 +92,11 @@ export declare class SelectFallback extends E.NativeFallback<Vocabulary> {
91
92
  readonly group: "name";
92
93
  readonly kind: "string";
93
94
  readonly description: "Form field name; `multiple` submits one entry per value.";
95
+ }, {
96
+ readonly name: "parameter";
97
+ readonly group: "form";
98
+ readonly kind: "string";
99
+ readonly description: string;
94
100
  }, {
95
101
  readonly name: "required";
96
102
  readonly group: "form";
@@ -18,6 +18,7 @@ import { sideVocabulary } from "./UISide.en";
18
18
  export declare class UISide extends E.UIComponent<typeof sideVocabulary> {
19
19
  static vocabulary: {
20
20
  readonly tag: "ui-side";
21
+ readonly icon: "square outline";
21
22
  readonly topics: readonly ["animation", "content parts", "modules"];
22
23
  readonly aka: readonly ["shape side", "face"];
23
24
  readonly noun: "side";
@@ -48,6 +49,9 @@ export declare class UISide extends E.UIComponent<typeof sideVocabulary> {
48
49
  }, {
49
50
  readonly name: "leaving";
50
51
  readonly description: "Turning out of view (set by the shape).";
52
+ }, {
53
+ readonly name: "in-flip-card";
54
+ readonly description: string;
51
55
  }];
52
56
  readonly texts: readonly [];
53
57
  };
@@ -18,6 +18,7 @@ import { type PushableVocabulary } from "./UISidebar.types";
18
18
  export declare class UIPushable extends E.UIComponent<PushableVocabulary> {
19
19
  static vocabulary: {
20
20
  readonly tag: "ui-pushable";
21
+ readonly icon: "arrows alternate horizontal";
21
22
  readonly topics: readonly ["layout", "navigation", "modules"];
22
23
  readonly aka: readonly ["sidebar container", "pushable area"];
23
24
  readonly noun: "pushable";
@@ -14,6 +14,7 @@ import { pusherVocabulary } from "./UIPusher.en";
14
14
  export declare class UIPusher extends E.UIComponent<typeof pusherVocabulary> {
15
15
  static vocabulary: {
16
16
  readonly tag: "ui-pusher";
17
+ readonly icon: "arrows alternate horizontal";
17
18
  readonly topics: readonly ["layout", "navigation", "modules"];
18
19
  readonly aka: readonly ["page content", "pushed content"];
19
20
  readonly noun: "pusher";
@@ -32,6 +32,7 @@ import { type SidebarVocabulary } from "./UISidebar.types";
32
32
  export declare class UISidebar extends E.UIComponent<SidebarVocabulary> {
33
33
  static vocabulary: {
34
34
  readonly tag: "ui-sidebar";
35
+ readonly icon: "columns";
35
36
  readonly topics: readonly ["navigation", "overlays", "layout", "menus", "modules"];
36
37
  readonly aka: readonly ["drawer", "off canvas", "side menu", "nav drawer", "hamburger menu"];
37
38
  readonly noun: "sidebar";
@@ -30,6 +30,7 @@ export declare class DOMSidesElement extends F.DOMFormControl<UISides> {
30
30
  export declare class UISides extends F.FormComponent<typeof sidesVocabulary> {
31
31
  static vocabulary: {
32
32
  readonly tag: "ui-sides";
33
+ readonly icon: "cubes";
33
34
  readonly formControl: true;
34
35
  readonly topics: readonly ["inputs", "forms", "controls"];
35
36
  readonly aka: readonly ["margin", "padding", "box model", "spacing", "insets", "sides"];
@@ -69,6 +70,11 @@ export declare class UISides extends F.FormComponent<typeof sidesVocabulary> {
69
70
  readonly group: "name";
70
71
  readonly kind: "string";
71
72
  readonly description: "Form field name.";
73
+ }, {
74
+ readonly name: "parameter";
75
+ readonly group: "form";
76
+ readonly kind: "string";
77
+ readonly description: string;
72
78
  }, {
73
79
  readonly name: "required";
74
80
  readonly group: "form";
@@ -12,6 +12,7 @@ import { sidesVocabulary } from "./UISides.en";
12
12
  export declare class SidesFallback extends E.NativeFallback<typeof sidesVocabulary> {
13
13
  static vocabulary: {
14
14
  readonly tag: "ui-sides";
15
+ readonly icon: "cubes";
15
16
  readonly formControl: true;
16
17
  readonly topics: readonly ["inputs", "forms", "controls"];
17
18
  readonly aka: readonly ["margin", "padding", "box model", "spacing", "insets", "sides"];
@@ -51,6 +52,11 @@ export declare class SidesFallback extends E.NativeFallback<typeof sidesVocabula
51
52
  readonly group: "name";
52
53
  readonly kind: "string";
53
54
  readonly description: "Form field name.";
55
+ }, {
56
+ readonly name: "parameter";
57
+ readonly group: "form";
58
+ readonly kind: "string";
59
+ readonly description: string;
54
60
  }, {
55
61
  readonly name: "required";
56
62
  readonly group: "form";
@@ -46,6 +46,8 @@ import { SliderScale } from "./SliderScale";
46
46
  export declare class UISlider extends F.FormComponent<typeof sliderVocabulary> {
47
47
  static vocabulary: {
48
48
  readonly tag: "ui-slider";
49
+ readonly icon: "sliders horizontal";
50
+ readonly snippet: "<ui-slider></ui-slider>";
49
51
  readonly formControl: true;
50
52
  readonly topics: readonly ["inputs", "forms", "controls", "modules"];
51
53
  readonly aka: readonly ["range", "range slider", "volume", "scrubber", "track bar"];
@@ -182,6 +184,11 @@ export declare class UISlider extends F.FormComponent<typeof sliderVocabulary> {
182
184
  readonly group: "name";
183
185
  readonly kind: "string";
184
186
  readonly description: "Form field name.";
187
+ }, {
188
+ readonly name: "parameter";
189
+ readonly group: "form";
190
+ readonly kind: "string";
191
+ readonly description: string;
185
192
  }, {
186
193
  readonly name: "required";
187
194
  readonly group: "form";
@@ -19,6 +19,8 @@ import { sliderVocabulary } from "./UISlider.en";
19
19
  export declare class SliderFallback extends E.NativeFallback<typeof sliderVocabulary> {
20
20
  static vocabulary: {
21
21
  readonly tag: "ui-slider";
22
+ readonly icon: "sliders horizontal";
23
+ readonly snippet: "<ui-slider></ui-slider>";
22
24
  readonly formControl: true;
23
25
  readonly topics: readonly ["inputs", "forms", "controls", "modules"];
24
26
  readonly aka: readonly ["range", "range slider", "volume", "scrubber", "track bar"];
@@ -155,6 +157,11 @@ export declare class SliderFallback extends E.NativeFallback<typeof sliderVocabu
155
157
  readonly group: "name";
156
158
  readonly kind: "string";
157
159
  readonly description: "Form field name.";
160
+ }, {
161
+ readonly name: "parameter";
162
+ readonly group: "form";
163
+ readonly kind: "string";
164
+ readonly description: string;
158
165
  }, {
159
166
  readonly name: "required";
160
167
  readonly group: "form";
@@ -16,6 +16,7 @@ import { spaceVocabulary } from "./UISpace.en";
16
16
  export declare class UISpace extends E.UIComponent<typeof spaceVocabulary> {
17
17
  static vocabulary: {
18
18
  readonly tag: "ui-space";
19
+ readonly icon: "arrows alternate vertical";
19
20
  readonly topics: readonly ["layout", "basic"];
20
21
  readonly aka: readonly ["spacer", "gap", "line break", "br", "spring", "filler", "strut"];
21
22
  readonly noun: "space";
@@ -26,6 +26,7 @@ import { statisticVocabulary } from "./UIStatistic.en";
26
26
  export declare class UIStatistic extends E.UIComponent<typeof statisticVocabulary> {
27
27
  static vocabulary: {
28
28
  readonly tag: "ui-statistic";
29
+ readonly icon: "chart bar outline";
29
30
  readonly topics: readonly ["data display", "text", "views"];
30
31
  readonly aka: readonly ["stat", "kpi", "metric", "counter", "number display"];
31
32
  readonly skeleton: "inline 6 x 4";
@@ -14,6 +14,7 @@ import { statisticsVocabulary } from "./UIStatistics.en";
14
14
  export declare class UIStatistics extends E.UIComponent<typeof statisticsVocabulary> {
15
15
  static vocabulary: {
16
16
  readonly tag: "ui-statistics";
17
+ readonly icon: "chart bar";
17
18
  readonly topics: readonly ["data display", "layout", "views"];
18
19
  readonly aka: readonly ["stats", "kpis", "metrics", "dashboard numbers"];
19
20
  readonly noun: "statistics";
@@ -37,6 +37,7 @@ import { stepVocabulary } from "./UIStep.en";
37
37
  export declare class UIStep extends E.UIComponent<typeof stepVocabulary> {
38
38
  static vocabulary: {
39
39
  readonly tag: "ui-step";
40
+ readonly icon: "shoe prints";
40
41
  readonly topics: readonly ["navigation", "progress", "content parts", "elements"];
41
42
  readonly aka: readonly ["wizard step", "stage"];
42
43
  readonly noun: "step";
@@ -30,6 +30,7 @@ import { stepsVocabulary } from "./UISteps.en";
30
30
  export declare class UISteps extends E.UIComponent<typeof stepsVocabulary> {
31
31
  static vocabulary: {
32
32
  readonly tag: "ui-steps";
33
+ readonly icon: "shoe prints";
33
34
  readonly topics: readonly ["navigation", "progress", "status", "elements"];
34
35
  readonly aka: readonly ["stepper", "wizard", "progress steps", "checkout steps"];
35
36
  readonly skeleton: "5 tall";
@@ -19,6 +19,7 @@ import { cellVocabulary } from "./UICell.en";
19
19
  export declare class UICell extends E.UIComponent<typeof cellVocabulary> {
20
20
  static vocabulary: {
21
21
  readonly tag: "ui-cell";
22
+ readonly icon: "square outline";
22
23
  readonly topics: readonly ["tables", "collections"];
23
24
  readonly aka: readonly ["table cell", "td", "th", "header cell"];
24
25
  readonly noun: "cell";
@@ -14,6 +14,7 @@ import { termVocabulary } from "./UITerm.en";
14
14
  export declare class UITerm extends E.UIComponent<typeof termVocabulary> {
15
15
  static vocabulary: {
16
16
  readonly tag: "ui-term";
17
+ readonly icon: "book";
17
18
  readonly topics: readonly ["text", "data display"];
18
19
  readonly aka: readonly ["dt", "dd", "term", "key value", "property", "name value"];
19
20
  readonly noun: "term";
@@ -14,6 +14,7 @@ import { termsVocabulary } from "./UITerms.en";
14
14
  export declare class UITerms extends E.UIComponent<typeof termsVocabulary> {
15
15
  static vocabulary: {
16
16
  readonly tag: "ui-terms";
17
+ readonly icon: "book open";
17
18
  readonly topics: readonly ["text", "data display", "collections"];
18
19
  readonly aka: readonly ["dl", "definition list", "description list", "key value list", "properties", "details"];
19
20
  readonly noun: "terms";
@@ -12,6 +12,7 @@ import { colorChipVocabulary } from "./UIColorChip.en";
12
12
  export declare class UIColorChip extends E.UIComponent<typeof colorChipVocabulary> {
13
13
  static vocabulary: {
14
14
  readonly tag: "ui-color-chip";
15
+ readonly icon: "tint";
15
16
  readonly topics: readonly ["media", "typography"];
16
17
  readonly aka: readonly ["color chip", "swatch", "colour sample", "color preview", "color dot"];
17
18
  readonly skeleton: "inline 1.4 x 1.4";
@@ -29,6 +29,7 @@ import type { TokenRow } from "./UIThemeEditor.types";
29
29
  export declare class UIThemeToken extends E.UIComponent<typeof themeTokenVocabulary> {
30
30
  static vocabulary: {
31
31
  readonly tag: "ui-theme-token";
32
+ readonly icon: "tint";
32
33
  readonly topics: readonly ["forms", "controls"];
33
34
  readonly aka: readonly ["theme token", "design token", "token row", "css variable", "custom property editor"];
34
35
  readonly skeleton: "2 tall";
@@ -52,6 +52,7 @@ export declare class DOMToastElement extends E.DOMElement<UIToast> {
52
52
  export declare class UIToast extends E.UIComponent<Vocabulary> {
53
53
  static vocabulary: {
54
54
  readonly tag: "ui-toast";
55
+ readonly icon: "bell";
55
56
  readonly topics: readonly ["notifications", "messages", "feedback", "overlays", "modules"];
56
57
  readonly aka: readonly ["snackbar", "notification", "growl", "flash message", "toaster"];
57
58
  readonly noun: "toast";
@@ -49,6 +49,7 @@ import { type TocVocabulary, type TocAllFolds, type TocFolds, type TocSection }
49
49
  export declare class UIToc extends E.UIComponent<TocVocabulary> {
50
50
  static vocabulary: {
51
51
  readonly tag: "ui-toc";
52
+ readonly icon: "list ol";
52
53
  readonly topics: readonly ["navigation", "documentation"];
53
54
  readonly aka: readonly ["table of contents", "on this page", "page index", "scrollspy", "toc", "following menu"];
54
55
  readonly skeleton: "short line, 6 line paragraph";
@@ -56,6 +56,7 @@ export declare class DOMTransitionElement extends E.DOMElement<UITransition> {
56
56
  export declare class UITransition extends E.UIComponent<typeof transitionVocabulary> {
57
57
  static vocabulary: {
58
58
  readonly tag: "ui-transition";
59
+ readonly icon: "magic";
59
60
  readonly topics: readonly ["animation", "modules"];
60
61
  readonly aka: readonly ["animate", "fade", "slide", "motion", "effect"];
61
62
  readonly noun: "transition";
@@ -15,6 +15,7 @@ import { MediaPlayer } from "./MediaPlayer";
15
15
  export declare class UIAudio extends MediaPlayer<typeof audioVocabulary> {
16
16
  static vocabulary: {
17
17
  readonly tag: "ui-audio";
18
+ readonly icon: "volume up";
18
19
  readonly topics: readonly ["media", "elements"];
19
20
  readonly aka: readonly ["audio", "sound", "music", "sound effect", "audio player"];
20
21
  readonly noun: "audio";
@@ -15,6 +15,7 @@ import { MediaPlayer } from "./MediaPlayer";
15
15
  export declare class UIVideo extends MediaPlayer<typeof videoVocabulary> {
16
16
  static vocabulary: {
17
17
  readonly tag: "ui-video";
18
+ readonly icon: "video";
18
19
  readonly topics: readonly ["media", "elements"];
19
20
  readonly aka: readonly ["video", "movie", "clip", "player", "video player"];
20
21
  readonly noun: "video";
@@ -20,6 +20,7 @@ import { visibilityVocabulary } from "./UIVisibility.en";
20
20
  export declare class UIVisibility extends E.UIComponent<VisibilityVocabulary> {
21
21
  static vocabulary: {
22
22
  readonly tag: "ui-visibility";
23
+ readonly icon: "eye";
23
24
  readonly topics: readonly ["animation", "media", "modules"];
24
25
  readonly aka: readonly ["scroll spy", "in view", "intersection", "lazy load", "on screen"];
25
26
  readonly noun: "visibility";
@@ -27,6 +27,7 @@ import { zoomVocabulary } from "./UIZoom.en";
27
27
  export declare class UIZoom extends E.UIComponent<typeof zoomVocabulary> {
28
28
  static vocabulary: {
29
29
  readonly tag: "ui-zoom";
30
+ readonly icon: "search plus";
30
31
  readonly topics: readonly ["images", "media", "overlays"];
31
32
  readonly aka: readonly ["lightbox", "zoom", "full size", "image viewer", "magnifier", "expand", "screenshot", "thumbnail"];
32
33
  readonly noun: "zoom";
@@ -2,7 +2,7 @@
2
2
  var OPTIONAL = "OPTIONAL";
3
3
  var REQUIRED = "REQUIRED";
4
4
  var NONE = "NONE";
5
- var PACKAGE_VERSION = true ? "0.8.7" : "unknown";
5
+ var PACKAGE_VERSION = true ? "0.8.8" : "unknown";
6
6
  var TaskStatus = {
7
7
  UNSTARTED: "UNSTARTED",
8
8
  ACTIVE: "ACTIVE",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "epic",
3
3
  "displayName": "Spell Epic",
4
- "version": "0.8.7",
4
+ "version": "0.8.8",
5
5
  "description": "Epics for Claude Code: epic pages, worktrees and windows, the review loop and the epic command, for any repo with an .epic/config.json5",
6
6
  "author": {
7
7
  "name": "Owen Williams"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "epic",
3
- "version": "0.8.7",
3
+ "version": "0.8.8",
4
4
  "description": "Epics for Codex: the epic skills ($epic review, $wtf, $details ...), the end-of-turn commit and sync of the shared plans, and the session-start notices, for any repo with an .epic/config.json5",
5
5
  "author": {
6
6
  "name": "Owen Williams"
@@ -26,10 +26,11 @@
26
26
  */
27
27
  import { spawn } from "node:child_process"
28
28
  import { existsSync, openSync, readFileSync, renameSync } from "node:fs"
29
- import { dirname, join } from "node:path"
29
+ import { join } from "node:path"
30
+ import { fileURLToPath } from "node:url"
30
31
 
31
- /** The window script, beside this plugin's `hooks/`. */
32
- const SCRIPT = join(dirname(import.meta.dirname), "src", "window.mjs")
32
+ /** The window script: by its package name, so it's the code the plugin depends on, in a checkout or an npm install. */
33
+ const SCRIPT = fileURLToPath(import.meta.resolve("spell/epic/window.mjs"))
33
34
 
34
35
  try {
35
36
  const input = JSON.parse(readFileSync(0, "utf8") || "{}")
@@ -16,6 +16,8 @@
16
16
  * - checked with CLI 2.1.287
17
17
  * - Names agree: worktree `../<repo>.worktrees/<name>`, branch `<name>` (Claude's own adds `worktree-`).
18
18
  * - Branches from the LOCAL base branch (unpushed work included), not `origin/main`.
19
+ * - where it takes only pull requests (`baseBranchProtected`), fast-forwarded from `origin` first when that's safe
20
+ * (`BaseBranch.catchUp()`): nothing else ever moves it there
19
21
  * - The folders and the branch come from the repo's `.epic/config.json5` (`EpicConfig`):
20
22
  * `worktreesFolder`, `baseBranch`, `contentFolder`; a key left out, the repo's own (`EpicConfig.defaultsFor()`).
21
23
  * - `worktreesFolder` BESIDE the repo since epic `epic-eject` P8: new worktrees go there,
@@ -132,14 +134,16 @@ import { basename, dirname, isAbsolute, join, relative, resolve } from "node:pat
132
134
 
133
135
  import { Git } from "spell/server/Git"
134
136
  import { pathInside } from "spell/server/RealPath"
137
+ import { BaseBranch } from "spell/epic/command/BaseBranch.ts"
135
138
  import { CheckoutPatches } from "spell/epic/command/CheckoutPatches.ts"
136
139
  import { CheckoutServers } from "spell/epic/command/CheckoutServers.ts"
137
140
  import { EpicRepo } from "spell/epic/config/EpicRepo.ts"
141
+ import { EngineFiles } from "spell/epic/config/EngineFiles.mjs"
138
142
  import { EpicConfig } from "spell/epic/config/EpicConfig.ts"
139
143
  import { SessionFolders } from "spell/epic/config/SessionFolders.ts"
140
144
 
141
- /** This plugin's `bin/epic`: `hooks/` is beside `bin/`. */
142
- const EPIC = join(dirname(import.meta.dirname), "bin", "epic")
145
+ /** The `epic` command of the code this plugin runs on (`EngineFiles.bin`). */
146
+ const EPIC = EngineFiles.bin
143
147
 
144
148
  /** The main checkout's git-ignored page server settings, copied into a new worktree (`copyLocalServer()`). */
145
149
  const LOCAL_SERVER = "page-server.local.json5"
@@ -231,6 +235,7 @@ class Worktree {
231
235
  return path
232
236
  }
233
237
  const reused = Worktree.hasBranch(root, name)
238
+ if (!reused) Worktree.catchUpBase(root, config)
234
239
  const args = reused ? [path, name] : ["-b", name, path, config.baseBranch]
235
240
  console.error(`worktree hook: git worktree add ${args.join(" ")}`)
236
241
  mkdirSync(dirname(path), { recursive: true })
@@ -287,8 +292,10 @@ class Worktree {
287
292
  console.error(`worktree hook: reusing ${worktree}`)
288
293
  continue
289
294
  }
290
- const base = new EpicConfig(main).baseBranch
295
+ const repoConfig = new EpicConfig(main)
296
+ const base = repoConfig.baseBranch
291
297
  const reused = Worktree.hasBranch(main, name)
298
+ if (!reused) Worktree.catchUpBase(main, repoConfig)
292
299
  const args = reused ? [worktree, name] : ["-b", name, worktree, base]
293
300
  console.error(`worktree hook: ${repo}: git worktree add ${args.join(" ")}`)
294
301
  mkdirSync(dirname(worktree), { recursive: true })
@@ -305,6 +312,18 @@ class Worktree {
305
312
  return path
306
313
  }
307
314
 
315
+ /**
316
+ * A new worktree is cut from the LOCAL base branch: where that takes only pull requests (`baseBranchProtected`),
317
+ * bring it up to date with `origin` first (`BaseBranch.catchUp()`), so the worktree starts from what GitHub merged.
318
+ * - can't, safely (offline, diverged, uncommitted changes): one line on stderr, and the worktree is cut as it is
319
+ * - NEVER throws
320
+ */
321
+ static catchUpBase(root, config) {
322
+ if (!config.baseBranchProtected) return
323
+ const { line } = BaseBranch.catchUp(root, config.baseBranch)
324
+ if (line) console.error(`worktree hook: ${line}`)
325
+ }
326
+
308
327
  /**
309
328
  * Copy main checkout `root`'s `page-server.local.json5` into new worktree `path`, its `projects` made absolute
310
329
  * (epic-engine's P49): the outside projects the page server serves (spell-brand's Brand tab, Q49), which a
package/epic/package.json CHANGED
@@ -1,6 +1,45 @@
1
1
  {
2
2
  "name": "spell-epic",
3
- "version": "0.8.7",
3
+ "version": "0.8.8",
4
4
  "private": true,
5
- "type": "module"
5
+ "type": "module",
6
+ "pageServer": {
7
+ "bundles": [
8
+ "../dist/epic/components/__pack",
9
+ "../dist/epic/tools/_assets"
10
+ ],
11
+ "routes": [
12
+ "../dist/epic/tools/detailsRoutes.js",
13
+ "../dist/epic/tools/choicesRoutes.js",
14
+ "../dist/epic/tools/runRoutes.js",
15
+ "../dist/epic/tools/commentsRoutes.js",
16
+ "../dist/epic/tool/reviewRoutes.js",
17
+ "../dist/epic/tool/epicRoutes.js",
18
+ "../dist/epic/tool/linkRoutes.js",
19
+ "../dist/epic/list/runningRoutes.js",
20
+ "../dist/epic/tools/agentRoutes.js",
21
+ "../dist/epic/tools/showRoutes.js",
22
+ "../dist/epic/tools/airplaneRoutes.js",
23
+ "../dist/epic/tools/personRoutes.js"
24
+ ],
25
+ "watch": [
26
+ "../dist/epic/tools/_assets",
27
+ "../dist/epic/components/__pack"
28
+ ],
29
+ "componentSets": {
30
+ "epics": {
31
+ "name": "Epic UI",
32
+ "dir": "../dist/epic/docs",
33
+ "assets": "../ui/site/_assets"
34
+ }
35
+ },
36
+ "engineRoutes": {
37
+ "/_epic/assets/": "../dist/epic/tools/_assets",
38
+ "/_epic/pack/": "../dist/epic/components/__pack",
39
+ "/templates/": "templates"
40
+ },
41
+ "localCopies": {
42
+ "https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js": "/_epic/assets/highlight.min.js"
43
+ }
44
+ }
6
45
  }
@@ -126,7 +126,8 @@ the page is the same for both agents.
126
126
  - The page NEVER locks: the person sends partial answers, and sends again whenever they like (2026-10-08).
127
127
  - a picture page: delete the question sections and `<epic-send>`; nothing to send
128
128
  3. In an epic: format the page once it's written, as the engine's tools do:
129
- `yarn vp fmt <its ABSOLUTE path>`, from the kit's root
129
+ `yarn vp fmt <its ABSOLUTE path>`, run from the plugin's own folder (`${CLAUDE_PLUGIN_ROOT}`), never your repo's root
130
+ (no `vp` there: skip this step)
130
131
  ([epics' AGENTS.md](${CLAUDE_PLUGIN_ROOT}/src/AGENTS.md), "Finishing a page", step 2).
131
132
 
132
133
  ### Asking the same question again: a new ROUND, never a new page
@@ -651,6 +651,11 @@ than just being able to move on").
651
651
  the repo's text-rewriting skill (spell-app's `/fussbudget`) on the files the phase changed,
652
652
  and the guide and the READMEs the phase made untrue brought in line, in the readme voice
653
653
  ("6. Doc Review"), before the commit.
654
+ - `epic config baseBranchProtected` prints `true`: the base branch takes only pull requests, so `epic merge` refuses
655
+ and steps 1-2 below don't apply.
656
+ No asking, as below: `epic worktree merge-main`, `git push -u origin <name>`, and `gh pr create` unless one's open
657
+ ([the isolate skill](../isolate/SKILL.md), "Finish, when the base branch takes only pull requests").
658
+ The phase reaches `main` when GitHub merges it; its changelog entry stays under "2. In worktrees" until then.
654
659
  - Then, no asking (the standing epic is the ask):
655
660
  1. `main` moved (`git log --oneline HEAD..main` not empty): `epic worktree merge-main`.
656
661
  - A multi-repo top (`epic config repos` prints names; [the isolate skill](../isolate/SKILL.md), "A
@@ -1318,7 +1323,8 @@ Write an idea down as a FUTURE epic (epic `epic-future`, 2026-10-07).
1318
1323
  - a rough size
1319
1324
  - one question per HIGH-LEVEL open choice (what, where, how far, when): options side by side, one recommended.
1320
1325
  Not the small ones: those are the plan's.
1321
- - Then format it: `yarn vp fmt <its ABSOLUTE path>`, from the kit's root
1326
+ - Then format it: `yarn vp fmt <its ABSOLUTE path>`, run from the plugin's own folder (`${CLAUDE_PLUGIN_ROOT}`), never
1327
+ your repo's root (no `vp` there: skip this step)
1322
1328
  ([epics' AGENTS.md](${CLAUDE_PLUGIN_ROOT}/src/AGENTS.md), "Finishing a page", step 2).
1323
1329
  - Then `epic ask show <name>/analysis --wait`: Bash, in the background.
1324
1330
  It opens in the side bar's Review tab.
@@ -115,6 +115,10 @@ epic turn end
115
115
  1. The Doc Review phase: the epic's guide, its changelog entry, and every doc it touched made true to what was built.
116
116
  2. Merge the worktree's branch into the base branch, when the person says so, and remove the worktree:
117
117
  `epic worktree remove <epic>`, never a bare `git worktree remove`.
118
+ - `epic config baseBranchProtected` prints `true`: the base branch takes only pull requests, and `epic merge` refuses.
119
+ Offer two things, in the chat: "Push and open a pull request" (`epic worktree merge-main`, `git push -u origin <epic>`,
120
+ `gh pr create`) or "Leave it".
121
+ The rest happens once GitHub merges it: `git pull` on the base branch, then `epic worktree remove <epic> --branches`.
118
122
  3. Say what shipped, with the page's links (`epic pages link <page> --show`).
119
123
 
120
124
  ## tidy -- Close what other work made obsolete
@@ -239,9 +239,14 @@ A STANDING epic merges each phase into `main` at once, and never leaves its work
239
239
  - no `ExitWorktree` and back: entering asks the person every time (epic `epic-engine` P12)
240
240
  - In Codex: the same: stay in the worktree's folder.
241
241
  - `/isolate done` in a standing epic's session: say it stands, and ask first ("Stop standing, and finish?").
242
+ - The base branch takes only pull requests (`epic config baseBranchProtected`): `epic merge` refuses; the epic skill's
243
+ step 5 says what a phase does instead.
242
244
 
243
245
  ## Finish: `/isolate done`
244
246
 
247
+ Read `epic config baseBranchProtected` first.
248
+ It prints `true`: steps 2, 4, 7 and 8 are the ones in "Finish, when the base branch takes only pull requests", below.
249
+
245
250
  0. Not in a worktree: say so in one line, then offer to clean up.
246
251
  - Not in one: the session's folder isn't a worktree's, in `.claude/worktrees/` or beside the repo.
247
252
  - Candidates, from `epic worktree list`: each worktree `<name>` that
@@ -413,6 +418,36 @@ A STANDING epic merges each phase into `main` at once, and never leaves its work
413
418
  - Agents' worktrees: how many step 7b removed, and any it kept.
414
419
  - Then close the reply as "Closing line" below says.
415
420
 
421
+ ## Finish, when the base branch takes only pull requests
422
+
423
+ `epic config baseBranchProtected` prints `true`: `main` can't be pushed to, and `epic merge` refuses.
424
+ These replace steps 2, 4, 7 and 8 of "Finish" above; the other steps stand.
425
+
426
+ 2. Unmerged commits (`main..HEAD` not empty): AskUserQuestion, listing the commits in the question.
427
+ - In Codex: ask in the chat, the two options numbered.
428
+ - "Push `<name>` and open a pull request?", options "Push and open a pull request" and "Leave it".
429
+ No "Merge now": nothing merges from here.
430
+ - "Leave it": go on to step 5.
431
+ - On "Push and open a pull request":
432
+ - the changelog, if the repo keeps one: this branch's entry, under "2. In worktrees": it isn't merged yet
433
+ - `epic worktree merge-main`, so the pull request starts from what GitHub has:
434
+ it fast-forwards local `main` from `origin` first, when that's safe.
435
+ Conflicts: step 3 above, with "Exit anyway" going on to step 5.
436
+ - `git push -u origin <name>`: never `--force`, never `main`.
437
+ Refused: say why, and stop here.
438
+ - `gh pr list --head <name> --state open --json number,url`: one open already, the push updated it.
439
+ Else `gh pr create`, its title and body as step 4 says.
440
+ - No `gh`, or logged out: print the `gh pr create` line to run.
441
+ - One line with the pull request's URL.
442
+ 4. Nothing more: step 2 did it.
443
+ - The check step 4 makes above doesn't apply.
444
+ `git rev-list --count origin/main..main` not 0 means local `main` holds commits no pull request has:
445
+ say so in one line, and leave them.
446
+ 7. Nothing to merge here: `epic session done` waits until the pull request is merged.
447
+ 8. One line, where the rest happens, then close the reply as "Closing line" below says:
448
+ "Once GitHub merges it: `git pull` on main in the main checkout, then `epic worktree remove <name> --branches`."
449
+ - `--branches` deletes the branch if its pull request was merged, a squash included: never unmerged work.
450
+
416
451
  ## Closing line
417
452
 
418
453
  A reply that closes out the session's work ends with a line of its own, `*You can close this tab*`