spell 0.8.8 → 0.8.9

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 (92) hide show
  1. package/README-epics.md +60 -20
  2. package/app/package.json +1 -1
  3. package/app/spaces/@spell/guides/SpellUI/SpellUI.spellml +486 -486
  4. package/app/spaces/@spell/sites/SpellApp/SpellApp.spellml +50 -124
  5. package/dist/app/app/pages/SiteBoardView.css +5 -5
  6. package/dist/app/app/pages/SiteBoardView.js +1 -1
  7. package/dist/app/app/pages/SiteEditorPage.js +6 -3
  8. package/dist/app/app/pages/SiteEdits.js +27 -10
  9. package/dist/app/app/pages/SiteWrites.js +11 -0
  10. package/dist/app/app/runner/spellRuntime.js +1 -0
  11. package/dist/epic/cli/EpicProgram.js +15 -6
  12. package/dist/epic/cli/epicGroups.js +5 -0
  13. package/dist/epic/command/BaseBranch.js +1 -1
  14. package/dist/epic/command/PullRequest.d.ts +45 -0
  15. package/dist/epic/command/PullRequest.js +100 -0
  16. package/dist/epic/command/RepoInit.d.ts +96 -47
  17. package/dist/epic/command/RepoInit.js +222 -96
  18. package/dist/epic/command/Requests.js +2 -1
  19. package/dist/epic/command/Worktrees.d.ts +5 -3
  20. package/dist/epic/command/Worktrees.js +9 -8
  21. package/dist/epic/components/__pack/epics.entry.js +43 -43
  22. package/dist/epic/components/__pack/epics.pack.js +2 -2
  23. package/dist/epic/config/CodeHost.d.ts +96 -0
  24. package/dist/epic/config/CodeHost.js +89 -0
  25. package/dist/epic/config/EpicConfig.d.ts +9 -2
  26. package/dist/epic/config/EpicConfig.js +16 -0
  27. package/dist/epic/config/EpicRepo.js +1 -1
  28. package/dist/epic/config/GitHub.d.ts +34 -2
  29. package/dist/epic/config/GitHub.js +36 -7
  30. package/dist/epic/config/GitLab.d.ts +138 -0
  31. package/dist/epic/config/GitLab.js +297 -0
  32. package/dist/epic/tool/PlanCommits.d.ts +7 -4
  33. package/dist/epic/tool/PlanCommits.js +7 -5
  34. package/dist/epic/tool/PlanDocCommands.js +3 -4
  35. package/dist/epic/tool/PlanDocFiles.d.ts +3 -1
  36. package/dist/epic/tool/PlanDocFiles.js +10 -3
  37. package/dist/parser/core/classes/View.d.ts +20 -0
  38. package/dist/parser/core/classes/View.js +91 -17
  39. package/dist/parser/core/core.declarations.json5 +18 -0
  40. package/dist/parser/core/core.scopes.js +5 -0
  41. package/dist/parser/core/sites.d.ts +10 -0
  42. package/dist/parser/core/sites.js +12 -0
  43. package/dist/parser/parser/tokenizer/Tokenizer.d.ts +9 -1
  44. package/dist/parser/parser/tokenizer/Tokenizer.js +43 -5
  45. package/dist/parser/parser/tokenizer/Tokens.d.ts +4 -0
  46. package/dist/parser/parser/tokenizer/Tokens.js +4 -0
  47. package/dist/parser/parser/tokenizer/tokenizer.types.d.ts +5 -0
  48. package/dist/parser/parser/tokenizer/tokenizer.types.js +2 -0
  49. package/dist/parser/py/core/spell_core/apps.py +2 -0
  50. package/dist/parser/spell/PARSING.md +21 -0
  51. package/dist/parser/spell/SpellParser.d.ts +2 -0
  52. package/dist/parser/spell/SpellParser.js +58 -3
  53. package/dist/parser/spell/SpellxTokenizer.js +2 -1
  54. package/dist/parser/spell/SpellxTwin.d.ts +4 -1
  55. package/dist/parser/spell/SpellxTwin.js +10 -3
  56. package/dist/parser/spell/builtinTypes.js +24 -1
  57. package/dist/parser/spell/ingest/PlaceIngest.js +3 -1
  58. package/dist/parser/spell/languages/Language.d.ts +11 -2
  59. package/dist/parser/spell/languages/en/words.js +3 -2
  60. package/dist/parser/spell/languages/es/words.js +7 -4
  61. package/dist/parser/spell/rules/Statement.js +1 -1
  62. package/dist/parser/spell/rules/classes/DrawSlot.js +6 -1
  63. package/dist/parser/spell/rules/sites/SitePage.d.ts +3 -3
  64. package/dist/parser/spell/rules/sites/SitePage.js +2 -2
  65. package/dist/parser/spell/rules/sites/sites.en.js +1 -1
  66. package/dist/parser/spell/rules/sites/sites.es.js +1 -1
  67. package/dist/parser/spell/rules/sites/sites.shared.d.ts +2 -2
  68. package/dist/parser/spell/spell.types.d.ts +7 -0
  69. package/dist/parser/spell/spellSyntax.es.json +6 -6
  70. package/dist/parser/spell/spellSyntax.json +6 -6
  71. package/dist/parser/spellx/SpellxView.js +2 -1
  72. package/dist/ui/components/ui-parts/UIHeader.d.ts +12 -2
  73. package/dist/ui/components/ui-parts/UIHeader.en.d.ts +5 -2
  74. package/dist/ui/components/ui-parts/UIHeader.en.js +6 -3
  75. package/dist/ui/components/ui-parts/UIHeader.js +45 -5
  76. package/dist/ui/components/ui-parts/UIParts.css +18 -0
  77. package/dist/ui/components/ui-parts/UIParts.css.inline.js +1 -1
  78. package/dist/ui/jsx.d.ts +4 -4
  79. package/dist/ui/vocabulary/defaults.generated.js +1 -1
  80. package/dist/util/spell/constants.js +1 -1
  81. package/epic/.claude-plugin/plugin.json +1 -1
  82. package/epic/.codex-plugin/plugin.json +1 -1
  83. package/epic/package.json +1 -1
  84. package/epic/skills/epic/SKILL.md +2 -2
  85. package/epic/skills/epic/guide.md +2 -3
  86. package/epic/skills/isolate/SKILL.md +25 -27
  87. package/epic/src/AGENTS.md +5 -0
  88. package/epic/vscode/package.json +1 -1
  89. package/epic/vscode/spell-epic.vsix +0 -0
  90. package/package.json +1 -1
  91. package/parser/package.json +1 -1
  92. package/ui/package.json +1 -1
@@ -326,43 +326,42 @@ It prints `true`: steps 2, 4, 7 and 8 are the ones in "Finish, when the base br
326
326
  - `git merge --abort`, say so, and list each file and why.
327
327
  - Then AskUserQuestion "Continue exiting?", options "Exit, unmerged" and "Stay isolated".
328
328
  - In Codex: in the chat too, its options numbered.
329
- 4. Pull request: an offer, ASKED first, since pushing publishes the branch on GitHub.
330
- - Only when GitHub's `main` is up to date with local `main` (Q16 of `review-review`, answer C).
329
+ 4. Pull request (a merge request on GitLab): an offer, ASKED first, since pushing publishes the branch on the
330
+ code host (GitHub or GitLab; `epic config codeHost` says which).
331
+ - Only when `origin`'s `main` is up to date with local `main` (Q16 of `review-review`, answer C).
331
332
  - All from the worktree.
332
333
  - `git fetch origin main`, then `git rev-list --count origin/main..main`:
333
- how far the local one is ahead of GitHub's.
334
+ how far the local one is ahead of `origin`'s.
334
335
  - Not 0: NO offer; say why in one line, e.g.
335
- "No pull request: GitHub's `main` is 62 commits behind local `main`,
336
- so a PR would list all 62 as well as this branch's. Push `main` first if you want one."
336
+ "No pull request: `origin`'s `main` is 62 commits behind local `main`,
337
+ so one would list all 62 as well as this branch's. Push `main` first if you want one."
337
338
  - NEVER push `main` from here.
338
- - The fetch fails (offline, not signed in): "No pull request: couldn't reach GitHub (<the error's gist>)".
339
- - `git rev-list --count origin/main..HEAD` is 0: nothing GitHub lacks, so nothing to show.
339
+ - The fetch fails (offline, not signed in): "No pull request: couldn't reach `origin` (<the error's gist>)".
340
+ - `git rev-list --count origin/main..HEAD` is 0: nothing `origin` lacks, so nothing to show.
340
341
  Skip, silently.
341
- - `gh pr list --head <name> --state open --json number,url`:
342
- one open already, so the offer is to push the branch, which updates it.
343
- - AskUserQuestion "Open a pull request for `<name>` on GitHub?",
344
- saying how many commits it shows and that pushing publishes them.
342
+ - AskUserQuestion "Open a pull request for `<name>` on the code host?",
343
+ saying how many commits it shows and that pushing publishes them; if one is open already, pushing just updates it.
345
344
  - In Codex: ask in the chat, yes or no.
346
- - Options: "Push and open a PR", and "No PR".
347
- - When one is open, the first is "Push `<name>` (updates PR #<n>)".
345
+ - Options: "Push and open a pull request", and "No pull request".
348
346
  - On yes:
349
- - `git push -u origin <name>`: never `--force`.
350
- Refused: say why, and stop the offer there.
351
- - Unless one was open, `gh pr create`:
347
+ - `epic pr`, which pushes the branch (`git push -u origin <name>`, never `--force`) and opens it on either host,
348
+ or says its address if one is open already:
352
349
 
353
350
  ```sh
354
- gh pr create --base main --head <name> --title "<title>" --body-file <file in the scratchpad>
351
+ epic pr <name> --title "<title>" --body-file <file in the scratchpad>
355
352
  ```
356
353
 
354
+ Refused, or the host's command missing: it says why and what to run; stop the offer there.
355
+
357
356
  - Title: the branch's changelog entry's header without its date
358
357
  (`2026-10-05 · Review Review` -> `Review Review`).
359
358
  No entry (left unmerged): the epic page's title, else the branch name.
360
359
  - Body:
361
360
  - the entry's bullets, as a markdown list (`- ...`)
362
- - plain text: its links point into shared docs, which aren't on GitHub
361
+ - plain text: its links point into shared docs, which aren't on the code host
363
362
  - then the attribution line the session's instructions give for pull requests
364
- - One line with the PR's URL.
365
- - Merged later (step 7) and `main` pushed: GitHub marks the PR merged by itself, its commits being in `main`.
363
+ - One line with its URL.
364
+ - Merged later (step 7) and `main` pushed: the code host marks it merged by itself, its commits being in `main`.
366
365
  5. NO move back: the session stays in the window it's in (the worktree's, or the one it stayed in).
367
366
  - Why: 2026-10-03 "we don't need to go back into the originating window.
368
367
  That's just confusing things".
@@ -430,22 +429,21 @@ These replace steps 2, 4, 7 and 8 of "Finish" above; the other steps stand.
430
429
  - "Leave it": go on to step 5.
431
430
  - On "Push and open a pull request":
432
431
  - 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:
432
+ - `epic worktree merge-main`, so the pull request starts from what `origin` has:
434
433
  it fast-forwards local `main` from `origin` first, when that's safe.
435
434
  Conflicts: step 3 above, with "Exit anyway" going on to step 5.
436
- - `git push -u origin <name>`: never `--force`, never `main`.
435
+ - `epic pr <name> --title "<title>" --body-file <file>`, its title and body as step 4 says:
436
+ it pushes (never `--force`, never `main`), and opens one, or says one was open and the push updated it.
437
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.
438
+ The host's command missing, or logged out: it prints the line to run; show it.
439
+ - One line with the address it printed.
442
440
  4. Nothing more: step 2 did it.
443
441
  - The check step 4 makes above doesn't apply.
444
442
  `git rev-list --count origin/main..main` not 0 means local `main` holds commits no pull request has:
445
443
  say so in one line, and leave them.
446
444
  7. Nothing to merge here: `epic session done` waits until the pull request is merged.
447
445
  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`."
446
+ "Once it's merged: `git pull` on main in the main checkout, then `epic worktree remove <name> --branches`."
449
447
  - `--branches` deletes the branch if its pull request was merged, a squash included: never unmerged work.
450
448
 
451
449
  ## Closing line
@@ -408,6 +408,10 @@ The `epic/` folder holds TWO things (Q23 of epic `people-and-orgs`, 2026-10-13):
408
408
  stand-in; plain `node` loads it
409
409
  - only `epic whoami`, `epic init` and `epic worktree remove --branches` (where the base branch takes only pull
410
410
  requests) run it: never a page served or a hook
411
+ - `CodeHost` (epic `epic-engine` I248): which server a repo's code is on (`codeHost`, `"github"` or `"gitlab"`,
412
+ worked out from `origin` when left out), and the ONE chooser of how to talk to it, `CodeHost.of(config)`: `GitHub`'s
413
+ statics or a `GitLab`, the same operations; nothing else compares host names
414
+ - `GitLab`: `glab`, on one instance, self-hosted too; `$SPELL_EPIC_GLAB` names a stand-in; plain `node` loads it
411
415
  - `Editor` (epic `epic-friend` P16): which editor the tools drive, VS Code (`code`) or Cursor (`cursor`), the ONE
412
416
  reader of it: `$SPELL_EPIC_EDITOR` (this machine's), else the window's own marks in the environment
413
417
  (`ofWindow()`: Cursor's `CURSOR_TRACE_ID`, its macOS bundle id, its folders in VS Code's `VSCODE_*` paths), else
@@ -506,6 +510,7 @@ The `epic/` folder holds TWO things (Q23 of epic `people-and-orgs`, 2026-10-13):
506
510
  - left out besides: `linguist-generated`, a `GENERATED` marker on the FIRST line only, bundles
507
511
  - `LocPage` rewrites the LOC guide's tables, dates and left-out list as DOM nodes (`Markup.plain()`), keeping
508
512
  its prose and ids; a missing page is made by `epic pages create durable`
513
+ - `PullRequest`: `epic pr <name>`, a branch pushed and its pull or merge request opened, on either host (`CodeHost`)
509
514
  - `BaseBranch`: the local base branch fast-forwarded from `origin`, where it takes only pull requests
510
515
  (`baseBranchProtected`): by the worktree hook and `MainMerge`, safe or not at all; plain `node` loads it by path
511
516
  - `CheckoutServers`: a checkout's web servers (page server, vite) stopped as it goes (epic `epic-engine` I53)
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "spell-epic",
3
3
  "displayName": "Spell Epic",
4
- "version": "0.1.2",
4
+ "version": "0.1.3",
5
5
  "private": true,
6
6
  "description": "spell-epic's side bar: the Review, Details and Epic Docs tabs, live from spell-epic's one page server per machine; the window bridge Claude Code sessions reach their window through, and the handoff.",
7
7
  "license": "MIT",
Binary file
package/package.json CHANGED
@@ -23,7 +23,7 @@
23
23
  "optional": true
24
24
  }
25
25
  },
26
- "version": "0.8.8",
26
+ "version": "0.8.9",
27
27
  "exports": {
28
28
  "./toolchain/lint/imports": {
29
29
  "types": "./dist/toolchain/lint.imports.d.ts",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "spell-parser",
3
- "version": "0.8.8",
3
+ "version": "0.8.9",
4
4
  "private": true,
5
5
  "type": "module",
6
6
  "spell": {
package/ui/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "spell-ui",
3
- "version": "0.8.8",
3
+ "version": "0.8.9",
4
4
  "private": true,
5
5
  "type": "module",
6
6
  "pageServer": {