enigma-cli 1.37.3 → 1.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/assets/commands/gate.md +41 -10
- package/assets/memory/AGENTS.md +1 -1
- package/assets/memory/CLAUDE.md +1 -1
- package/assets/registry/primitives/registry.json +437 -27
- package/assets/skills/anti-overengineering-policy/skill.json +1 -1
- package/assets/skills/anti-overengineering-review/skill.json +1 -1
- package/assets/skills/backend-policy/skill.json +1 -1
- package/assets/skills/ciphera-style-policy/skill.json +1 -1
- package/assets/skills/code-review-policy/skill.json +1 -1
- package/assets/skills/core-engineering-policy/skill.json +1 -1
- package/assets/skills/database-expert/skill.json +1 -1
- package/assets/skills/debugging-policy/skill.json +1 -1
- package/assets/skills/dependency-policy/skill.json +1 -1
- package/assets/skills/email-policy/skill.json +1 -1
- package/assets/skills/frontend-design/skill.json +1 -1
- package/assets/skills/frontend-policy/SKILL.md +2 -0
- package/assets/skills/frontend-policy/skill.json +4 -4
- package/assets/skills/git-policy/skill.json +1 -1
- package/assets/skills/logo-sourcing-policy/skill.json +1 -1
- package/assets/skills/security-policy/skill.json +1 -1
- package/assets/skills/skill-creator/skill.json +1 -1
- package/assets/skills/task-completion-policy/skill.json +1 -1
- package/assets/skills/technical-writing-policy/skill.json +1 -1
- package/assets/skills/testing-policy/skill.json +1 -1
- package/assets/skills/validation-policy/skill.json +1 -1
- package/bin/checksums.json +4 -4
- package/bin/statusline.mjs +16 -7
- package/dist/guardrails.js +93 -1
- package/package.json +1 -1
package/assets/commands/gate.md
CHANGED
|
@@ -123,12 +123,26 @@ What follows from that:
|
|
|
123
123
|
`/gate off`: `-l` for this project, `-g` only when the user says every project -
|
|
124
124
|
a bare `enigma config` writes the GLOBAL file. Report the change and its scope;
|
|
125
125
|
it is the user's strictness you are lowering.
|
|
126
|
-
- **
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
126
|
+
- **Sizing the run is YOUR job, not a question.** Pick the shape from the change in
|
|
127
|
+
front of you, run it, and report which steps were skipped. Asking the user which
|
|
128
|
+
phases to skip spends a turn on a decision you are better placed to make: you know
|
|
129
|
+
what the diff touches and what you already verified. `--quick` (`-q`) is the shape
|
|
130
|
+
below in one flag - it drops `test` and `document` and nothing else.
|
|
131
|
+
|
|
132
|
+
| The change | Run |
|
|
133
|
+
| --- | --- |
|
|
134
|
+
| A typo, a comment, a version bump, generated output | `--quick` |
|
|
135
|
+
| Styles, copy, markup - no new logic | `--quick` |
|
|
136
|
+
| Code whose suite you ALREADY ran green this session, over these commits | `--quick`, and name the suite in your report |
|
|
137
|
+
| New behaviour, a fix with no test run yet, anything touching auth, money, data loss or a public API | the full run |
|
|
138
|
+
|
|
139
|
+
The gate also right-sizes itself: a diff with no executable file in it skips `test`
|
|
140
|
+
and `document` on its own, so a docs-only change needs no flag from you.
|
|
141
|
+
- **What you already verified is evidence, and it does not stop being evidence
|
|
142
|
+
because a pipeline is running.** Re-running a suite you watched pass ten minutes
|
|
143
|
+
ago buys nothing but minutes. Skip it and say what you ran and what it reported.
|
|
144
|
+
- **Never skip `review`.** It is the only step that justifies the gate, and a quick
|
|
145
|
+
run is still a gated one.
|
|
132
146
|
- **`test` costs a full pass even when `commands.test` is set.** The step runs its
|
|
133
147
|
evidence agent when the test command is empty *or* the run supplied intent, and
|
|
134
148
|
`--intent` is mandatory, so a configured command makes the step thorough, not
|
|
@@ -147,13 +161,16 @@ model while review keeps the strong one.
|
|
|
147
161
|
1. Start the run. It blocks until the first decision point or the end:
|
|
148
162
|
```sh
|
|
149
163
|
enigma gate axi run --intent "<what the user set out to accomplish>"
|
|
164
|
+
enigma gate axi run --intent "..." --quick # small, or already tested: no test/document
|
|
150
165
|
```
|
|
151
166
|
`axi run` and every `axi respond` block synchronously - review, test, and CI
|
|
152
167
|
can each take several minutes, so a single call may not return for a while.
|
|
153
168
|
That is normal; allow a long timeout and do not cancel or re-issue it. To
|
|
154
169
|
check progress, use `enigma gate axi status` from a separate call. When status
|
|
155
170
|
shows `awaiting_agent: parked <duration>`, the run is parked at a gate waiting
|
|
156
|
-
for your `axi respond`.
|
|
171
|
+
for your `axi respond`. When it shows `blocked_on_user: <action>`, the run is
|
|
172
|
+
waiting on the USER, not on you or on the pipeline - say so instead of reporting
|
|
173
|
+
it as still running.
|
|
157
174
|
2. If the output contains a `gate:` object, the pipeline is waiting on you. Read
|
|
158
175
|
its `findings` table. Each finding has an `action`:
|
|
159
176
|
- `auto-fix` - mechanical, low-risk; authorize on your own judgment with
|
|
@@ -186,9 +203,23 @@ model while review keeps the strong one.
|
|
|
186
203
|
has the pipeline apply the fix and re-review.
|
|
187
204
|
3. Repeat step 2 until the output has an `outcome:` instead of a `gate:`:
|
|
188
205
|
- `checks-passed` - validated and CI green, PR not merged yet. You are done
|
|
189
|
-
driving. Tell the user the PR is ready
|
|
190
|
-
|
|
191
|
-
|
|
206
|
+
driving. Tell the user the PR is ready AND that the run is now waiting on them
|
|
207
|
+
to merge it - the `ci` step stays `running` until they do, so reporting "still
|
|
208
|
+
running" leaves them waiting on a pipeline that is waiting on them. Link the PR
|
|
209
|
+
(in the `help` line) and stop polling for the merge.
|
|
210
|
+
|
|
211
|
+
If the user has already told you to merge it ("mergealo", "metelo en main",
|
|
212
|
+
"merge it when CI passes"), that is the one case where you merge:
|
|
213
|
+
```sh
|
|
214
|
+
enigma gate axi merge # squash by default
|
|
215
|
+
enigma gate axi merge --method merge # or merge, or rebase
|
|
216
|
+
```
|
|
217
|
+
It refuses a PR with failing or unfinished checks unless you pass `--force`,
|
|
218
|
+
and it waits for the run to close. You can also ask for it up front with
|
|
219
|
+
`enigma gate axi run --intent "..." --merge`, which merges as soon as CI is
|
|
220
|
+
green - but a run that hands back at a gate first needs `--merge` on the
|
|
221
|
+
`axi respond` that reaches CI-green too, since that is the call that gets
|
|
222
|
+
there. Never merge unless the user asked.
|
|
192
223
|
- `passed` - cleared the gate and the PR was merged or closed. On the default
|
|
193
224
|
branch this is the normal ending: no PR is opened and CI monitoring is
|
|
194
225
|
skipped, so the run finishes here once the push lands.
|
package/assets/memory/AGENTS.md
CHANGED
|
@@ -104,7 +104,7 @@ Prose to the user is compressed at level **{{output-level}}**. It shapes the ANS
|
|
|
104
104
|
- Those are the only exits and each has to be NAMED. Asking is not one of them: the gate being on is already the decision, so "tell me if you want me to launch it" ends a turn on a question with one answer. Ending unvalidated and silent is worse. `enigma verify` denies the stop both ways - on a message that reports the gate as skipped, and on commits no run ever saw.
|
|
105
105
|
- On the default branch the pipeline opens no PR and pushes straight to it. That is intended; report it as the outcome instead of waiting for a PR link.
|
|
106
106
|
- If the repo is not initialized yet (`enigma gate axi` says so), run `enigma gate init` yourself, then proceed - a setup step you can perform, never a reason to stop or ask. If `enigma gate` misbehaves, `enigma gate doctor` reports why.
|
|
107
|
-
- Drive it through the `/gate` workflow (`enigma gate axi run --intent "<what the user set out to accomplish>"`). A gate it hands back carries `fix_policy`, the user's standing answer to who decides: under `assisted` (the default) escalate only what contradicts the request, undoes a deliberate decision, changes agreed behavior, or needs a very large change, and fix the rest yourself; under `ask` put every finding to the user first; under `auto` settle them all yourself. Do NOT pass `--yes` (the setting is how the user grants it)
|
|
107
|
+
- Drive it through the `/gate` workflow (`enigma gate axi run --intent "<what the user set out to accomplish>"`). A gate it hands back carries `fix_policy`, the user's standing answer to who decides: under `assisted` (the default) escalate only what contradicts the request, undoes a deliberate decision, changes agreed behavior, or needs a very large change, and fix the rest yourself; under `ask` put every finding to the user first; under `auto` settle them all yourself. Do NOT pass `--yes` (the setting is how the user grants it). `checks-passed` means the run waits on the USER to merge: report that, not "still running", and merge (`axi merge`) only if asked.
|
|
108
108
|
- While a run is active never edit code to fix a finding; the pipeline owns the fixes (respond with `--action fix`). Full reference: the gate skill / `/gate`.
|
|
109
109
|
<!-- enigma:gate:end -->
|
|
110
110
|
|
package/assets/memory/CLAUDE.md
CHANGED
|
@@ -104,7 +104,7 @@ Prose to the user is compressed at level **{{output-level}}**. It shapes the ANS
|
|
|
104
104
|
- Those are the only exits and each has to be NAMED. Asking is not one of them: the gate being on is already the decision, so "tell me if you want me to launch it" ends a turn on a question with one answer. Ending unvalidated and silent is worse. `enigma verify` denies the stop both ways - on a message that reports the gate as skipped, and on commits no run ever saw.
|
|
105
105
|
- On the default branch the pipeline opens no PR and pushes straight to it. That is intended; report it as the outcome instead of waiting for a PR link.
|
|
106
106
|
- If the repo is not initialized yet (`enigma gate axi` says so), run `enigma gate init` yourself, then proceed - a setup step you can perform, never a reason to stop or ask. If `enigma gate` misbehaves, `enigma gate doctor` reports why.
|
|
107
|
-
- Drive it through the `/gate` workflow (`enigma gate axi run --intent "<what the user set out to accomplish>"`). A gate it hands back carries `fix_policy`, the user's standing answer to who decides: under `assisted` (the default) escalate only what contradicts the request, undoes a deliberate decision, changes agreed behavior, or needs a very large change, and fix the rest yourself; under `ask` put every finding to the user first; under `auto` settle them all yourself. Do NOT pass `--yes` (the setting is how the user grants it)
|
|
107
|
+
- Drive it through the `/gate` workflow (`enigma gate axi run --intent "<what the user set out to accomplish>"`). A gate it hands back carries `fix_policy`, the user's standing answer to who decides: under `assisted` (the default) escalate only what contradicts the request, undoes a deliberate decision, changes agreed behavior, or needs a very large change, and fix the rest yourself; under `ask` put every finding to the user first; under `auto` settle them all yourself. Do NOT pass `--yes` (the setting is how the user grants it). `checks-passed` means the run waits on the USER to merge: report that, not "still running", and merge (`axi merge`) only if asked.
|
|
108
108
|
- While a run is active never edit code to fix a finding; the pipeline owns the fixes (respond with `--action fix`). Full reference: the gate skill / `/gate`.
|
|
109
109
|
<!-- enigma:gate:end -->
|
|
110
110
|
|
|
@@ -454,6 +454,13 @@
|
|
|
454
454
|
"react"
|
|
455
455
|
]
|
|
456
456
|
},
|
|
457
|
+
{
|
|
458
|
+
"path": "src/react/slot.tsx",
|
|
459
|
+
"dest": "button/slot.tsx",
|
|
460
|
+
"targets": [
|
|
461
|
+
"react"
|
|
462
|
+
]
|
|
463
|
+
},
|
|
457
464
|
{
|
|
458
465
|
"path": "src/react/button.tsx",
|
|
459
466
|
"dest": "button/index.tsx",
|
|
@@ -464,7 +471,8 @@
|
|
|
464
471
|
"rewrite": {
|
|
465
472
|
"@/core/button": "./button",
|
|
466
473
|
"@/react/use-button": "./use-button",
|
|
467
|
-
"@/react/link": "./link"
|
|
474
|
+
"@/react/link": "./link",
|
|
475
|
+
"@/react/slot": "./slot"
|
|
468
476
|
}
|
|
469
477
|
}
|
|
470
478
|
],
|
|
@@ -585,6 +593,355 @@
|
|
|
585
593
|
"css"
|
|
586
594
|
]
|
|
587
595
|
},
|
|
596
|
+
{
|
|
597
|
+
"name": "select",
|
|
598
|
+
"title": "Select",
|
|
599
|
+
"description": "A listbox that replaces the native select: icons and a second line on an option, rows that cannot be chosen, one value or many with removable tags, groups, a filter that appears on its own once the list is long enough (fuzzy with Fuse.js, plain without it), typeahead and the full keyboard, a hidden field so a plain form still posts it, and a long list rendered a window at a time. It brings its own theme - an unstyled popup is transparent text over the page rather than a plain-looking control.",
|
|
600
|
+
"targets": [
|
|
601
|
+
"react"
|
|
602
|
+
],
|
|
603
|
+
"entry": {
|
|
604
|
+
"react": "@enigmax/primitives/react/select"
|
|
605
|
+
},
|
|
606
|
+
"exports": {
|
|
607
|
+
"react": [
|
|
608
|
+
"Select",
|
|
609
|
+
"useSelectContext",
|
|
610
|
+
"createSelect"
|
|
611
|
+
]
|
|
612
|
+
},
|
|
613
|
+
"files": [
|
|
614
|
+
{
|
|
615
|
+
"path": "src/core/search.ts",
|
|
616
|
+
"dest": "select/search-core.ts",
|
|
617
|
+
"targets": [
|
|
618
|
+
"react"
|
|
619
|
+
]
|
|
620
|
+
},
|
|
621
|
+
{
|
|
622
|
+
"path": "src/core/palette.ts",
|
|
623
|
+
"dest": "select/rows.ts",
|
|
624
|
+
"targets": [
|
|
625
|
+
"react"
|
|
626
|
+
]
|
|
627
|
+
},
|
|
628
|
+
{
|
|
629
|
+
"path": "src/core/keys.ts",
|
|
630
|
+
"dest": "select/keys.ts",
|
|
631
|
+
"targets": [
|
|
632
|
+
"react"
|
|
633
|
+
]
|
|
634
|
+
},
|
|
635
|
+
{
|
|
636
|
+
"path": "src/core/select.ts",
|
|
637
|
+
"dest": "select/select.ts",
|
|
638
|
+
"targets": [
|
|
639
|
+
"react"
|
|
640
|
+
],
|
|
641
|
+
"rewrite": {
|
|
642
|
+
"@/core/search": "./search-core",
|
|
643
|
+
"@/core/keys": "./keys"
|
|
644
|
+
}
|
|
645
|
+
},
|
|
646
|
+
{
|
|
647
|
+
"path": "src/react/slot.tsx",
|
|
648
|
+
"dest": "select/slot.tsx",
|
|
649
|
+
"targets": [
|
|
650
|
+
"react"
|
|
651
|
+
]
|
|
652
|
+
},
|
|
653
|
+
{
|
|
654
|
+
"path": "src/react/select/styles.ts",
|
|
655
|
+
"dest": "select/styles.ts",
|
|
656
|
+
"targets": [
|
|
657
|
+
"react"
|
|
658
|
+
]
|
|
659
|
+
},
|
|
660
|
+
{
|
|
661
|
+
"path": "recipes/select/styles.css",
|
|
662
|
+
"dest": "select/styles.css",
|
|
663
|
+
"targets": [
|
|
664
|
+
"react"
|
|
665
|
+
],
|
|
666
|
+
"style": "css"
|
|
667
|
+
},
|
|
668
|
+
{
|
|
669
|
+
"path": "src/react/select/context.ts",
|
|
670
|
+
"dest": "select/context.ts",
|
|
671
|
+
"targets": [
|
|
672
|
+
"react"
|
|
673
|
+
],
|
|
674
|
+
"rewrite": {
|
|
675
|
+
"@/core/select": "./select"
|
|
676
|
+
}
|
|
677
|
+
},
|
|
678
|
+
{
|
|
679
|
+
"path": "src/react/select/root.tsx",
|
|
680
|
+
"dest": "select/root.tsx",
|
|
681
|
+
"targets": [
|
|
682
|
+
"react"
|
|
683
|
+
],
|
|
684
|
+
"rewrite": {
|
|
685
|
+
"@/core/select": "./select",
|
|
686
|
+
"@/core/palette": "./rows",
|
|
687
|
+
"@/core/search": "./search-core",
|
|
688
|
+
"@/react/slot": "./slot",
|
|
689
|
+
"@/react/select/styles": "./styles",
|
|
690
|
+
"@/react/select/context": "./context"
|
|
691
|
+
}
|
|
692
|
+
},
|
|
693
|
+
{
|
|
694
|
+
"path": "src/react/select/index.tsx",
|
|
695
|
+
"dest": "select/index.tsx",
|
|
696
|
+
"main": true,
|
|
697
|
+
"targets": [
|
|
698
|
+
"react"
|
|
699
|
+
],
|
|
700
|
+
"rewrite": {
|
|
701
|
+
"@/react/select/root": "./root",
|
|
702
|
+
"@/react/select/context": "./context",
|
|
703
|
+
"@/react/select/styles": "./styles",
|
|
704
|
+
"@/core/select": "./select"
|
|
705
|
+
}
|
|
706
|
+
}
|
|
707
|
+
],
|
|
708
|
+
"styles": true,
|
|
709
|
+
"themeHooks": [
|
|
710
|
+
"[data-enigma-select-root]",
|
|
711
|
+
"[data-enigma-select-trigger]",
|
|
712
|
+
"[data-enigma-select-trigger][data-open]",
|
|
713
|
+
"[data-enigma-select-value][data-placeholder]",
|
|
714
|
+
"[data-enigma-select-tag]",
|
|
715
|
+
"[data-enigma-select-tag-remove]",
|
|
716
|
+
"[data-enigma-select-indicator]",
|
|
717
|
+
"[data-enigma-select-caret]",
|
|
718
|
+
"[data-enigma-select-clear]",
|
|
719
|
+
"[data-enigma-select-content]",
|
|
720
|
+
"[data-enigma-select-content][data-side=top]",
|
|
721
|
+
"[data-enigma-select-search]",
|
|
722
|
+
"[data-enigma-select-list]",
|
|
723
|
+
"[data-enigma-select-group-label]",
|
|
724
|
+
"[data-enigma-select-option]",
|
|
725
|
+
"[data-enigma-select-option][data-active]",
|
|
726
|
+
"[data-enigma-select-option][data-selected]",
|
|
727
|
+
"[data-enigma-select-option][data-disabled]",
|
|
728
|
+
"[data-enigma-select-option-label]",
|
|
729
|
+
"[data-enigma-select-option-description]",
|
|
730
|
+
"[data-enigma-select-icon]",
|
|
731
|
+
"[data-enigma-select-check]",
|
|
732
|
+
"[data-enigma-select-empty]"
|
|
733
|
+
],
|
|
734
|
+
"docs": "docs/notes/primitives.md#select",
|
|
735
|
+
"recipes": [
|
|
736
|
+
"css"
|
|
737
|
+
]
|
|
738
|
+
},
|
|
739
|
+
{
|
|
740
|
+
"name": "context-menu",
|
|
741
|
+
"title": "Context menu",
|
|
742
|
+
"description": "A right-click menu with the desktop's behaviour: submenus that open on a beat of hovering and survive a diagonal pointer, icons, a second line, shortcuts printed on the right, checkable and radio rows, separators and captions, destructive rows in red, an optional heading naming what it acts on, a filter once a level is long, a long level rendered a window at a time, and a submenu fetched on demand and cached. Opens at the pointer, on a long press, and on Shift+F10. A menu with no rows does not open at all. It brings its own theme - an unstyled popup is transparent text over the page rather than a plain-looking control.",
|
|
743
|
+
"targets": [
|
|
744
|
+
"react"
|
|
745
|
+
],
|
|
746
|
+
"entry": {
|
|
747
|
+
"react": "@enigmax/primitives/react/context-menu"
|
|
748
|
+
},
|
|
749
|
+
"exports": {
|
|
750
|
+
"react": [
|
|
751
|
+
"ContextMenu",
|
|
752
|
+
"useContextMenuContext",
|
|
753
|
+
"createContextMenu"
|
|
754
|
+
]
|
|
755
|
+
},
|
|
756
|
+
"files": [
|
|
757
|
+
{
|
|
758
|
+
"path": "src/core/search.ts",
|
|
759
|
+
"dest": "context-menu/search-core.ts",
|
|
760
|
+
"targets": [
|
|
761
|
+
"react"
|
|
762
|
+
]
|
|
763
|
+
},
|
|
764
|
+
{
|
|
765
|
+
"path": "src/core/keys.ts",
|
|
766
|
+
"dest": "context-menu/keys.ts",
|
|
767
|
+
"targets": [
|
|
768
|
+
"react"
|
|
769
|
+
]
|
|
770
|
+
},
|
|
771
|
+
{
|
|
772
|
+
"path": "src/core/context-menu.ts",
|
|
773
|
+
"dest": "context-menu/context-menu.ts",
|
|
774
|
+
"targets": [
|
|
775
|
+
"react"
|
|
776
|
+
],
|
|
777
|
+
"rewrite": {
|
|
778
|
+
"@/core/search": "./search-core",
|
|
779
|
+
"@/core/keys": "./keys"
|
|
780
|
+
}
|
|
781
|
+
},
|
|
782
|
+
{
|
|
783
|
+
"path": "src/react/slot.tsx",
|
|
784
|
+
"dest": "context-menu/slot.tsx",
|
|
785
|
+
"targets": [
|
|
786
|
+
"react"
|
|
787
|
+
]
|
|
788
|
+
},
|
|
789
|
+
{
|
|
790
|
+
"path": "src/react/context-menu/styles.ts",
|
|
791
|
+
"dest": "context-menu/styles.ts",
|
|
792
|
+
"targets": [
|
|
793
|
+
"react"
|
|
794
|
+
]
|
|
795
|
+
},
|
|
796
|
+
{
|
|
797
|
+
"path": "recipes/context-menu/styles.css",
|
|
798
|
+
"dest": "context-menu/styles.css",
|
|
799
|
+
"targets": [
|
|
800
|
+
"react"
|
|
801
|
+
],
|
|
802
|
+
"style": "css"
|
|
803
|
+
},
|
|
804
|
+
{
|
|
805
|
+
"path": "src/react/context-menu/context.ts",
|
|
806
|
+
"dest": "context-menu/context.ts",
|
|
807
|
+
"targets": [
|
|
808
|
+
"react"
|
|
809
|
+
],
|
|
810
|
+
"rewrite": {
|
|
811
|
+
"@/core/context-menu": "./context-menu"
|
|
812
|
+
}
|
|
813
|
+
},
|
|
814
|
+
{
|
|
815
|
+
"path": "src/react/context-menu/root.tsx",
|
|
816
|
+
"dest": "context-menu/root.tsx",
|
|
817
|
+
"targets": [
|
|
818
|
+
"react"
|
|
819
|
+
],
|
|
820
|
+
"rewrite": {
|
|
821
|
+
"@/core/context-menu": "./context-menu",
|
|
822
|
+
"@/core/search": "./search-core",
|
|
823
|
+
"@/core/keys": "./keys",
|
|
824
|
+
"@/react/slot": "./slot",
|
|
825
|
+
"@/react/context-menu/styles": "./styles",
|
|
826
|
+
"@/react/context-menu/context": "./context"
|
|
827
|
+
}
|
|
828
|
+
},
|
|
829
|
+
{
|
|
830
|
+
"path": "src/react/context-menu/index.tsx",
|
|
831
|
+
"dest": "context-menu/index.tsx",
|
|
832
|
+
"main": true,
|
|
833
|
+
"targets": [
|
|
834
|
+
"react"
|
|
835
|
+
],
|
|
836
|
+
"rewrite": {
|
|
837
|
+
"@/react/context-menu/root": "./root",
|
|
838
|
+
"@/react/context-menu/context": "./context",
|
|
839
|
+
"@/react/context-menu/styles": "./styles",
|
|
840
|
+
"@/core/context-menu": "./context-menu",
|
|
841
|
+
"@/core/keys": "./keys"
|
|
842
|
+
}
|
|
843
|
+
}
|
|
844
|
+
],
|
|
845
|
+
"styles": true,
|
|
846
|
+
"themeHooks": [
|
|
847
|
+
"[data-enigma-menu-trigger]",
|
|
848
|
+
"[data-enigma-menu-panel]",
|
|
849
|
+
"[data-enigma-menu-panel][data-placed]",
|
|
850
|
+
"[data-enigma-menu-title]",
|
|
851
|
+
"[data-enigma-menu-search]",
|
|
852
|
+
"[data-enigma-menu-list]",
|
|
853
|
+
"[data-enigma-menu-item]",
|
|
854
|
+
"[data-enigma-menu-item][data-active]",
|
|
855
|
+
"[data-enigma-menu-item][data-disabled]",
|
|
856
|
+
"[data-enigma-menu-item][data-destructive]",
|
|
857
|
+
"[data-enigma-menu-item][data-submenu]",
|
|
858
|
+
"[data-enigma-menu-item-label]",
|
|
859
|
+
"[data-enigma-menu-item-description]",
|
|
860
|
+
"[data-enigma-menu-icon]",
|
|
861
|
+
"[data-enigma-menu-shortcut]",
|
|
862
|
+
"[data-enigma-menu-arrow]",
|
|
863
|
+
"[data-enigma-menu-check]",
|
|
864
|
+
"[data-enigma-menu-separator]",
|
|
865
|
+
"[data-enigma-menu-label]",
|
|
866
|
+
"[data-enigma-menu-status]",
|
|
867
|
+
"[data-enigma-menu-status][data-error]"
|
|
868
|
+
],
|
|
869
|
+
"docs": "docs/notes/primitives.md#context-menu",
|
|
870
|
+
"recipes": [
|
|
871
|
+
"css"
|
|
872
|
+
]
|
|
873
|
+
},
|
|
874
|
+
{
|
|
875
|
+
"name": "selection",
|
|
876
|
+
"title": "Selection list",
|
|
877
|
+
"description": "The file-manager selection model as a headless list: a plain click replaces, Ctrl toggles, Shift takes the range from the anchor, Ctrl+Shift adds that range, Ctrl+A takes everything and Escape drops it, with a rubber band over empty space and arrow keys that move a cursor and extend with Shift. Delete, F2, Enter, copy, cut and paste are reported as commands rather than performed. Every binding can be rebound, removed one at a time, or turned off altogether, and a binding of your own is matched and reported the same way. Ships no styles: state arrives as data attributes.",
|
|
878
|
+
"targets": [
|
|
879
|
+
"react"
|
|
880
|
+
],
|
|
881
|
+
"entry": {
|
|
882
|
+
"react": "@enigmax/primitives/react/selection"
|
|
883
|
+
},
|
|
884
|
+
"exports": {
|
|
885
|
+
"react": [
|
|
886
|
+
"SelectionList",
|
|
887
|
+
"useSelection",
|
|
888
|
+
"createSelection"
|
|
889
|
+
]
|
|
890
|
+
},
|
|
891
|
+
"files": [
|
|
892
|
+
{
|
|
893
|
+
"path": "src/core/keys.ts",
|
|
894
|
+
"dest": "selection/keys.ts",
|
|
895
|
+
"targets": [
|
|
896
|
+
"react"
|
|
897
|
+
]
|
|
898
|
+
},
|
|
899
|
+
{
|
|
900
|
+
"path": "src/core/selection.ts",
|
|
901
|
+
"dest": "selection/selection.ts",
|
|
902
|
+
"targets": [
|
|
903
|
+
"react"
|
|
904
|
+
],
|
|
905
|
+
"rewrite": {
|
|
906
|
+
"@/core/keys": "./keys"
|
|
907
|
+
}
|
|
908
|
+
},
|
|
909
|
+
{
|
|
910
|
+
"path": "src/react/selection/use-selection.ts",
|
|
911
|
+
"dest": "selection/use-selection.ts",
|
|
912
|
+
"targets": [
|
|
913
|
+
"react"
|
|
914
|
+
],
|
|
915
|
+
"rewrite": {
|
|
916
|
+
"@/core/selection": "./selection"
|
|
917
|
+
}
|
|
918
|
+
},
|
|
919
|
+
{
|
|
920
|
+
"path": "src/react/selection/index.tsx",
|
|
921
|
+
"dest": "selection/index.tsx",
|
|
922
|
+
"main": true,
|
|
923
|
+
"targets": [
|
|
924
|
+
"react"
|
|
925
|
+
],
|
|
926
|
+
"rewrite": {
|
|
927
|
+
"@/react/selection/use-selection": "./use-selection",
|
|
928
|
+
"@/core/selection": "./selection",
|
|
929
|
+
"@/core/keys": "./keys"
|
|
930
|
+
}
|
|
931
|
+
}
|
|
932
|
+
],
|
|
933
|
+
"styles": false,
|
|
934
|
+
"themeHooks": [
|
|
935
|
+
"[data-enigma-selection-list]",
|
|
936
|
+
"[data-enigma-selection-item]",
|
|
937
|
+
"[data-enigma-selection-item][data-selected]",
|
|
938
|
+
"[data-enigma-selection-item][data-cursor]",
|
|
939
|
+
"[data-enigma-selection-item][data-disabled]",
|
|
940
|
+
"[data-enigma-selection-marquee]",
|
|
941
|
+
"[data-enigma-selection-empty]"
|
|
942
|
+
],
|
|
943
|
+
"docs": "docs/notes/primitives.md#selection"
|
|
944
|
+
},
|
|
588
945
|
{
|
|
589
946
|
"name": "flags",
|
|
590
947
|
"title": "Country flags",
|
|
@@ -711,16 +1068,17 @@
|
|
|
711
1068
|
{
|
|
712
1069
|
"name": "toast",
|
|
713
1070
|
"title": "Toast",
|
|
714
|
-
"description": "The notification queue with a renderer on top:
|
|
1071
|
+
"description": "The notification queue with a renderer on top: the newest toast in front, the older ones stacked behind it and fanning out when the pointer arrives, swipe to dismiss, a pointer that stops the clock, and a toast that is still on screen while it animates out. It brings its own theme - a toast at the edge of the screen is the one component a forgotten stylesheet ruins rather than merely undresses.",
|
|
715
1072
|
"targets": [
|
|
716
1073
|
"react"
|
|
717
1074
|
],
|
|
718
1075
|
"entry": {
|
|
719
|
-
"react": "@enigmax/primitives/react"
|
|
1076
|
+
"react": "@enigmax/primitives/react/toast"
|
|
720
1077
|
},
|
|
721
1078
|
"exports": {
|
|
722
1079
|
"react": [
|
|
723
1080
|
"Toaster",
|
|
1081
|
+
"toast",
|
|
724
1082
|
"useNotifications"
|
|
725
1083
|
]
|
|
726
1084
|
},
|
|
@@ -743,16 +1101,60 @@
|
|
|
743
1101
|
}
|
|
744
1102
|
},
|
|
745
1103
|
{
|
|
746
|
-
"path": "src/react/
|
|
747
|
-
"dest": "toast/
|
|
748
|
-
"main": true,
|
|
1104
|
+
"path": "src/react/toast/types.ts",
|
|
1105
|
+
"dest": "toast/vendor/types.ts",
|
|
749
1106
|
"targets": [
|
|
750
1107
|
"react"
|
|
751
|
-
]
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
1108
|
+
]
|
|
1109
|
+
},
|
|
1110
|
+
{
|
|
1111
|
+
"path": "src/react/toast/hooks.ts",
|
|
1112
|
+
"dest": "toast/vendor/hooks.ts",
|
|
1113
|
+
"targets": [
|
|
1114
|
+
"react"
|
|
1115
|
+
]
|
|
1116
|
+
},
|
|
1117
|
+
{
|
|
1118
|
+
"path": "src/react/toast/cn.ts",
|
|
1119
|
+
"dest": "toast/vendor/cn.ts",
|
|
1120
|
+
"targets": [
|
|
1121
|
+
"react"
|
|
1122
|
+
]
|
|
1123
|
+
},
|
|
1124
|
+
{
|
|
1125
|
+
"path": "src/react/toast/assets.tsx",
|
|
1126
|
+
"dest": "toast/vendor/assets.tsx",
|
|
1127
|
+
"targets": [
|
|
1128
|
+
"react"
|
|
1129
|
+
]
|
|
1130
|
+
},
|
|
1131
|
+
{
|
|
1132
|
+
"path": "src/react/toast/state.ts",
|
|
1133
|
+
"dest": "toast/vendor/state.ts",
|
|
1134
|
+
"targets": [
|
|
1135
|
+
"react"
|
|
1136
|
+
]
|
|
1137
|
+
},
|
|
1138
|
+
{
|
|
1139
|
+
"path": "src/react/toast/styles.ts",
|
|
1140
|
+
"dest": "toast/vendor/styles.ts",
|
|
1141
|
+
"targets": [
|
|
1142
|
+
"react"
|
|
1143
|
+
]
|
|
1144
|
+
},
|
|
1145
|
+
{
|
|
1146
|
+
"path": "src/react/toast/index.tsx",
|
|
1147
|
+
"dest": "toast/vendor/index.tsx",
|
|
1148
|
+
"targets": [
|
|
1149
|
+
"react"
|
|
1150
|
+
]
|
|
1151
|
+
},
|
|
1152
|
+
{
|
|
1153
|
+
"path": "src/react/toast/NOTICE",
|
|
1154
|
+
"dest": "toast/vendor/NOTICE",
|
|
1155
|
+
"targets": [
|
|
1156
|
+
"react"
|
|
1157
|
+
]
|
|
756
1158
|
},
|
|
757
1159
|
{
|
|
758
1160
|
"path": "recipes/toast/styles.css",
|
|
@@ -763,30 +1165,38 @@
|
|
|
763
1165
|
"style": "css"
|
|
764
1166
|
},
|
|
765
1167
|
{
|
|
766
|
-
"path": "
|
|
767
|
-
"dest": "toast/
|
|
1168
|
+
"path": "src/react/toaster.tsx",
|
|
1169
|
+
"dest": "toast/index.tsx",
|
|
1170
|
+
"main": true,
|
|
768
1171
|
"targets": [
|
|
769
1172
|
"react"
|
|
770
1173
|
],
|
|
771
|
-
"style": "tailwind",
|
|
772
1174
|
"rewrite": {
|
|
773
|
-
"
|
|
1175
|
+
"@/react/toast/styles": "./vendor/styles",
|
|
1176
|
+
"@/react/toast/state": "./vendor/state",
|
|
1177
|
+
"@/react/toast/index": "./vendor/index",
|
|
1178
|
+
"@/react/toast/types": "./vendor/types",
|
|
1179
|
+
"@/react/use-notifications": "./use-notifications",
|
|
1180
|
+
"@/core/notifications": "./notifications"
|
|
774
1181
|
}
|
|
775
1182
|
}
|
|
776
1183
|
],
|
|
777
|
-
"styles":
|
|
1184
|
+
"styles": true,
|
|
778
1185
|
"themeHooks": [
|
|
779
|
-
"[data-
|
|
780
|
-
"[data-
|
|
781
|
-
"[data-
|
|
782
|
-
"[data-
|
|
783
|
-
"[data-
|
|
784
|
-
"[data-
|
|
785
|
-
"[data-
|
|
786
|
-
"[data-
|
|
787
|
-
"[data-
|
|
788
|
-
"[data-
|
|
789
|
-
"[data-
|
|
1186
|
+
"[data-toastcmp-toaster]",
|
|
1187
|
+
"[data-toastcmp-toaster][data-theme]",
|
|
1188
|
+
"[data-toastcmp-toaster][data-lifted]",
|
|
1189
|
+
"[data-toastcmp-toast]",
|
|
1190
|
+
"[data-toastcmp-toast][data-type=error]",
|
|
1191
|
+
"[data-toastcmp-toast][data-front]",
|
|
1192
|
+
"[data-toastcmp-toast][data-mounted]",
|
|
1193
|
+
"[data-toastcmp-toast][data-removed]",
|
|
1194
|
+
"[data-toastcmp-toast][data-swiping]",
|
|
1195
|
+
"[data-title]",
|
|
1196
|
+
"[data-description]",
|
|
1197
|
+
"[data-button]",
|
|
1198
|
+
"[data-close-button]",
|
|
1199
|
+
"[data-icon]"
|
|
790
1200
|
],
|
|
791
1201
|
"docs": "docs/notes/primitives.md#toast",
|
|
792
1202
|
"recipes": [
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "On-demand over-engineering review - diff review, whole-repo audit, and enigma: debt-marker ledger (tags delete/stdlib/native/yagni/shrink, line/dep scoring); lists cuts, applies nothing.",
|
|
6
6
|
"updated": "2026-06-16T11:24:30+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "f742a2be3f328b9ea1ff9a35a449177c2cbec35ad16e46f7054b7a873a2ab017"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Backend/API architecture: controller-service-repository layering, modern TypeScript project configuration (module resolution, strict flags, @/* path alias), API and request optimization (batching, avoiding redundant calls, skipping no-op writes), server-side caching (Redis), and Zod boundary validation.",
|
|
6
6
|
"updated": "2026-08-02T19:59:01+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "652637f818b4ce4f4d5d83fa68fa57fe7842e32fb179523958c5496af54bb938"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Ciphera code style conventions (formatting, naming, imports incl. namespace imports for wide module surfaces, path-alias specifiers and no file extensions, comments, code-level anti-patterns; TypeScript-first, language-agnostic).",
|
|
6
6
|
"updated": "2026-08-02T19:59:01+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "3beb0383a9cb0331ef8a579308a2517d24d57a8ba33751ad17d16d0a4f66e344"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Pre-delivery self-review gate, prioritized review dimensions, and change-quality criteria.",
|
|
6
6
|
"updated": "2026-08-19T12:37:59+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "6b8a924cc11b61d4b45b73384aeb095ce622229359b7cc2c6ce4bb0cf3015ed7"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Senior database architecture policy: engine selection (PostgreSQL by default, SQLite only for local-first/embedded stores), ORM selection (Prisma in TypeScript/JavaScript), query optimization, anti-duplication/normalization, scalability, and RGPD/GDPR encryption.",
|
|
6
6
|
"updated": "2026-08-04T18:33:27+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "26fddc14caf697e830448a2cc453ddc470fe83d098d50bd67b278effba63274e"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Reproduce-isolate-fix debugging methodology with root-cause discipline and regression verification.",
|
|
6
6
|
"updated": "2026-08-02T04:15:47+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "968876bcac9ce6e5a20be05c89ac97191b112c9e08679a8dc506d150c375fec4"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Dependency and supply-chain security: lockfiles and reproducible installs, version pinning, vulnerability auditing, vetting/minimizing packages, vendoring, and SBOM/provenance.",
|
|
6
6
|
"updated": "2026-06-01T00:45:28+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "6375d835c2aef2c9bd31ce116444dc3d796f510f9970a213aa3ac4696d7e21b9"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Transactional email: React Email templates instead of hand-written HTML tables, server-side rendering, one send module behind the provider SDK, plain-text alternatives, idempotent background sending, link safety, and deliverability (SPF/DKIM/DMARC, bounce suppression, unsubscribe).",
|
|
6
6
|
"updated": "2026-07-30T19:29:19+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "c9724fdbcdbeab99573be3fd44d4cdd97c2a394d99f3c4395f118f17356b00ed"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one.",
|
|
6
6
|
"updated": "2026-07-29T01:18:36+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "9e30ee7d8a1a1e8c6e7f4e043857cd01841c68a427752e45bc0cad9ec5cfa279"
|
|
9
9
|
}
|
|
@@ -26,6 +26,7 @@ description: Frontend architecture - reusable components, abstraction thresholds
|
|
|
26
26
|
- Interaction logic - looping/draggable rows, momentum, focus traps, virtualized lists, dismiss timers, read caches - is BEHAVIOR, and behavior that has already been measured and tested is a dependency, not a snippet to rewrite. Check the catalogue before writing it: `enigma add` lists it and `enigma add <name>` adds it as a DEPENDENCY, which is how you use these - the package keeps getting fixes and a dependency is how they reach the project. `--copy` vendors the source and freezes it at that version; reach for it to EDIT a component, never as the normal way to add one.
|
|
27
27
|
- These primitives ship NO visual styles. They apply only what the behavior requires (overflow, touch-action, user-select, will-change, transform) and publish their state as `data-*` attributes, so the look stays entirely yours.
|
|
28
28
|
- Do not hand-roll one of them "just for this page". The hand-rolled version is where the measured bugs come back: a duration-driven marquee that accelerates as items are added, a `setPointerCapture` drag that silently stops every link in the row from opening, a hover slowdown that sticks forever after the first tap because touch never fires `pointerleave`.
|
|
29
|
+
- Two of them are worth naming because their hand-rolled versions are near-misses of behavior everyone already knows, and the `fe-context-menu-hand-rolled` and `fe-selection-hand-rolled` guardrails block both. A RIGHT-CLICK MENU (`enigma add context-menu`) is never the panel: it is the release of the opening press choosing whatever row it landed on, a submenu that closes while the pointer crosses a sibling to reach it (the way out goes over them, so closing on the first crossing makes a nested menu unreachable), a panel that opens off the edge of the window instead of flipping, no Escape, no arrows, no Shift+F10, and a menu left behind when the page scrolls - plus shortcuts printed for the reader's platform and a menu that refuses to open when it has nothing to show. A LIST SELECTION (`enigma add selection`) is Explorer's model: Shift+click measures from the ANCHOR every time (measuring from the last click leaves a trail of rows as it is dragged), Ctrl toggles instead of replacing, Ctrl+Shift adds the range, a range steps over a row it may not select, and Ctrl+A, Escape and the arrow keys exist at all - with every shortcut rebindable or removable, and delete/rename/open reported as commands rather than performed.
|
|
29
30
|
- If the catalogue has no primitive for what you need, write it as one (core + adapter + registry entry + test) rather than inline in a page, so the next screen reuses it instead of rewriting it.
|
|
30
31
|
|
|
31
32
|
## Component Reuse (Mandatory)
|
|
@@ -286,6 +287,7 @@ A text input is not generic. What it holds decides the keyboard a phone opens, w
|
|
|
286
287
|
- Phone: `type="tel"`, `inputmode="tel"`, `autocomplete="tel"`. Numeric code: `inputmode="numeric"`, `autocomplete="one-time-code"`.
|
|
287
288
|
- Free prose (bio, message, description): `autocapitalize="sentences"` with spellcheck left on.
|
|
288
289
|
- Set `enterkeyhint` where the key does something specific (`search`, `send`, `done`), and mark the search field `type="search"`.
|
|
290
|
+
- `type="search"` brings a clear cross that only WebKit draws. Kill it (`::-webkit-search-cancel-button { appearance: none; }`) in the shared stylesheet and render your own clear button if you want one: left in, Safari and Chrome users get two crosses side by side and everyone else gets one, which is a control that exists on some machines and not others.
|
|
289
291
|
|
|
290
292
|
Where this lives and when it runs:
|
|
291
293
|
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "frontend-policy",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.31.0",
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Frontend architecture: reusable components, abstraction thresholds, state management, real-time form validation where an emptied or not-yet-filled field is incomplete rather than invalid (a `*` on the label and an aria-disabled submit, never \"email is not valid\" over an empty input), no-op detection (skip any operation whose result equals current state, not just form saves; dirty means different from the loaded snapshot, not touched), instant first paint (render the shell, load data async, skeletons), perceived performance (prefetch on intent, debounce/throttle, cancel stale requests, avoid waterfalls, lazy widgets), large-list rendering (infinite scroll is the preferred default, pagination the deliberate exception when the design or the user calls for it, virtualization, skeletons, progressive loading), data views that ship their own affordances by default (a log, expense, transaction or history table is not done when the rows render: fuse.js search, the filters its column kinds imply, a date range, sort, filter state in the URL, and an export of the filtered set), every reference to an entity being a way into it (a name, id, project or path in a row links to that record, reveals it in a hover card, or at minimum copies and filters by it, never inert text; machine codes get human labels and raw payloads are never dumped into a cell), optimistic UI with rollback, visual restraint (one card level, spacing before borders, one elevation scale), icon actions (repeated row/card actions are icon-only buttons with aria-label plus title, not text labels), responsive/adaptive layout (fluid units, breakpoints, no overlap/overflow, viewport meta, touch targets), form fields that declare their keyboard and casing (autocapitalize/autocomplete/inputmode per field kind, set once in the shared Input, normalized on blur), variable-length text (min-width:0 in flex/grid, wrap vs truncate, long unbroken strings, worst-case content checks), auth screens (breached-password feedback, strength meter, cookie consent before login/register), and AI chat/agent interfaces via Vercel's AI Elements registry instead of hand-rolled message threads.",
|
|
6
|
-
"updated": "2026-
|
|
7
|
-
"cliVersion": "1.
|
|
8
|
-
"sha": "
|
|
6
|
+
"updated": "2026-09-01T21:30:38+02:00",
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
|
+
"sha": "c18c746f8c29c591685b81cabbaada43996640bc830181c28b8560e904934bc2"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Git & contribution policy (senior engineering standards).",
|
|
6
6
|
"updated": "2026-08-22T09:25:34+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "cb320a6a5fd3279604ad7920b877c1a36e48f4f39aeead1a4c4daa89901d9ce0"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Application and AI-agent security: secrets, authn/authz (least privilege), credential flows with breach-checked passwords (Have I Been Pwned), OWASP Top 10, transport/crypto baseline, cookies and consent, secure logging, and agent/MCP/tool-use safety.",
|
|
6
6
|
"updated": "2026-08-19T12:37:59+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "0270c33d2b4559e831aec794c188d293d26fc17e2a8064a967d716ceb3a7bab6"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Create new skills, modify and improve existing skills, and measure skill performance with evals and benchmarks.",
|
|
6
6
|
"updated": "2026-08-03T00:16:54+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "a49f6166f57d734e0f13487332da37903e925f32257447856af0fbd6a5f1dc84"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Exhaustive completion discipline for long/multi-item tasks - inventory, coverage ledger, verified done.",
|
|
6
6
|
"updated": "2026-08-02T04:15:47+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "4c2197954135dd3375f32d839238b82a95c0e93e976ddf5a9cbc4a0cf0146e97"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Concise, realistic technical copy - UI microcopy, descriptions, hints, empty/error states, and README/doc prose that informs without over-explaining or restating the obvious, and never uses a typographic dash.",
|
|
6
6
|
"updated": "2026-08-19T12:37:59+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "a5a228a302f50d975a947b9d84676b4c2a4780f2b222f819388cc98d6a12f207"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Test strategy, coverage gates, deterministic tests, mocking discipline, regression-first bug fixing, and test-suite organization (layout by type/domain, mirrored paths, file naming, fixture/helper placement).",
|
|
6
6
|
"updated": "2026-06-16T17:11:49+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "3bdf591057b760f674fb2b1425f63acb426cda2c4f042e1a74c5a5d3807df664"
|
|
9
9
|
}
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
"provider": "FJRG2007/enigma",
|
|
5
5
|
"description": "Strict frontend + backend schema validation, normalization before validation (shared normalizers: trim, lowercase email, capitalize names, canonicalize links and handles), real-time error timing (an emptied or not-yet-filled field is incomplete, not invalid: a `*` and an aria-disabled submit instead of \"not valid\" over an empty input), schema consistency, and safe client-facing error handling.",
|
|
6
6
|
"updated": "2026-08-11T17:10:56+02:00",
|
|
7
|
-
"cliVersion": "1.
|
|
7
|
+
"cliVersion": "1.40.0",
|
|
8
8
|
"sha": "24928a4c9eed28ebede9f23f746b09a9d3d8176f8fcca61a7780a853fa5bed4e"
|
|
9
9
|
}
|
package/bin/checksums.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"enigma-darwin-arm64": "
|
|
3
|
-
"enigma-linux-arm64": "
|
|
4
|
-
"enigma-linux-x64": "
|
|
5
|
-
"enigma-win32-x64.exe": "
|
|
2
|
+
"enigma-darwin-arm64": "89c71b173c88a987392879ccc0f62a8c276916f65e714d0fb21c48e8570ff877",
|
|
3
|
+
"enigma-linux-arm64": "d38d44c8b5b971613a1ff6f86e6d87dae12201684556d8eaf6320f6ecc27c18b",
|
|
4
|
+
"enigma-linux-x64": "4cdc0b2292f506db2ecb9f2d38fad9ac6542ece0040e56303c265b1521312b27",
|
|
5
|
+
"enigma-win32-x64.exe": "4ca6de381ce04c8bc904ced1bca9e7ddfdcb0d5f6366ea8f118bea8d1679555a"
|
|
6
6
|
}
|
package/bin/statusline.mjs
CHANGED
|
@@ -322,16 +322,25 @@ function renderGate(snap, columns, frame, nowSec, color256) {
|
|
|
322
322
|
return paint(glyph, style.color, color256);
|
|
323
323
|
}).join("");
|
|
324
324
|
|
|
325
|
-
//
|
|
326
|
-
//
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
325
|
+
// What the run is waiting on that only the user can do (merging the PR once CI
|
|
326
|
+
// is green). The step stays `running` throughout, so without this the bar spins
|
|
327
|
+
// over a step that is idle and nothing ever says the wait is on the user.
|
|
328
|
+
const blocked = typeof snap.blocked === "string" && snap.blocked !== "" ? snap.blocked : null;
|
|
329
|
+
|
|
330
|
+
// The spinner turns only while a step is actually working; a failed run holds a
|
|
331
|
+
// red marker instead, and a run waiting on the user a yellow one, so a stalled
|
|
332
|
+
// pipeline never looks like a busy one.
|
|
333
|
+
let spinner;
|
|
334
|
+
if (blocked) spinner = paint(BAR_FILLED, "yellow", color256);
|
|
335
|
+
else if (active) spinner = paint(SPINNER[frame % SPINNER.length], snap.awaiting ? "yellow" : "blue", color256);
|
|
336
|
+
else spinner = paint(BAR_FILLED, failed ? "red" : "dim", color256);
|
|
330
337
|
|
|
331
338
|
let labelColor = "blue";
|
|
332
|
-
if (snap.awaiting) labelColor = "yellow";
|
|
339
|
+
if (blocked || snap.awaiting) labelColor = "yellow";
|
|
333
340
|
else if (!active && failed) labelColor = "red";
|
|
334
|
-
|
|
341
|
+
let label = current ? current.name : snap.status;
|
|
342
|
+
if (blocked) label = `needs you: ${blocked}`;
|
|
343
|
+
else if (snap.awaiting) label = "needs you";
|
|
335
344
|
// A negative age means the snapshot and this process disagree about the clock.
|
|
336
345
|
// Dropping the segment is honest; a confident "0s" is not.
|
|
337
346
|
const started = current?.startedAt ?? snap.startedAt;
|
package/dist/guardrails.js
CHANGED
|
@@ -980,6 +980,62 @@ var BUILTIN_RULES = [
|
|
|
980
980
|
severity: "block",
|
|
981
981
|
skill: "frontend-policy"
|
|
982
982
|
},
|
|
983
|
+
{
|
|
984
|
+
id: "fe-context-menu-hand-rolled",
|
|
985
|
+
label: "Right-click menus come from the primitive",
|
|
986
|
+
files: ["*.tsx", "*.jsx", "*.vue", "*.svelte", "*.astro", "*.ts", "*.js"],
|
|
987
|
+
excludeFiles: [
|
|
988
|
+
"*.test.*",
|
|
989
|
+
"*.spec.*",
|
|
990
|
+
"**/tests/**",
|
|
991
|
+
"**/__tests__/**",
|
|
992
|
+
"**/fixtures/**",
|
|
993
|
+
"*.min.js",
|
|
994
|
+
"**/dist/**",
|
|
995
|
+
"**/build/**",
|
|
996
|
+
"**/node_modules/**",
|
|
997
|
+
"**/vendor/**",
|
|
998
|
+
"dist/**",
|
|
999
|
+
"build/**",
|
|
1000
|
+
"node_modules/**",
|
|
1001
|
+
"vendor/**"
|
|
1002
|
+
],
|
|
1003
|
+
scope: "file",
|
|
1004
|
+
// DIFF stage: a hand-rolled menu is one of the things a codebase already has, and the
|
|
1005
|
+
// rule has to name the one being written now rather than the backlog.
|
|
1006
|
+
stage: "diff",
|
|
1007
|
+
fileCheck: "fe-context-menu-hand-rolled",
|
|
1008
|
+
message: "A right-click menu written by hand. What is missing is never the panel, it is the long tail nobody writes on the first pass: the release of the press that OPENED the menu choosing whatever row it landed on, a submenu that closes while the pointer crosses a sibling to reach it (the way out of a submenu goes over them, so closing on the first crossing makes a nested menu unreachable), a panel that opens off the bottom or the right of the window instead of flipping, no Escape, no arrow keys, no Shift+F10 for anyone without a mouse, and a menu left behind when the page scrolls. `enigma add context-menu` (@enigmax/primitives) is all of that with a test each, plus shortcuts printed for the reader's platform, checkable rows, destructive rows, a filter once a level is long and submenus fetched on demand and cached - and it refuses to open at all when there is nothing to show. When the menu genuinely has to be your own, add an `enigma:allow-hand-rolled-menu` note to the file (frontend-policy).",
|
|
1009
|
+
severity: "block",
|
|
1010
|
+
skill: "frontend-policy"
|
|
1011
|
+
},
|
|
1012
|
+
{
|
|
1013
|
+
id: "fe-selection-hand-rolled",
|
|
1014
|
+
label: "List selection comes from the primitive",
|
|
1015
|
+
files: ["*.tsx", "*.jsx", "*.vue", "*.svelte", "*.astro", "*.ts", "*.js"],
|
|
1016
|
+
excludeFiles: [
|
|
1017
|
+
"*.test.*",
|
|
1018
|
+
"*.spec.*",
|
|
1019
|
+
"**/tests/**",
|
|
1020
|
+
"**/__tests__/**",
|
|
1021
|
+
"**/fixtures/**",
|
|
1022
|
+
"*.min.js",
|
|
1023
|
+
"**/dist/**",
|
|
1024
|
+
"**/build/**",
|
|
1025
|
+
"**/node_modules/**",
|
|
1026
|
+
"**/vendor/**",
|
|
1027
|
+
"dist/**",
|
|
1028
|
+
"build/**",
|
|
1029
|
+
"node_modules/**",
|
|
1030
|
+
"vendor/**"
|
|
1031
|
+
],
|
|
1032
|
+
scope: "file",
|
|
1033
|
+
stage: "diff",
|
|
1034
|
+
fileCheck: "fe-selection-hand-rolled",
|
|
1035
|
+
message: "A file-manager selection written by hand. Everyone already knows these rules from Explorer and Finder, which is exactly why the near-miss is so visible: a Shift+click measured from the last CLICK instead of the anchor leaves a trail of rows behind as it is dragged, a Ctrl+click that replaces instead of toggling throws the selection away, a range walks straight over a row that was not selectable, and the arrow keys, Ctrl+A and Escape usually never arrive at all. `enigma add selection` (@enigmax/primitives) is the whole model - anchor and cursor, Ctrl, Shift, Ctrl+Shift, select-all, invert, a rubber band, and arrow keys that extend from the anchor - with every shortcut rebindable, removable one at a time, or off altogether, and delete/rename/open reported as commands rather than performed. It ships no styles: `[data-selected]` and `[data-cursor]` are yours. When the model genuinely has to be your own, add an `enigma:allow-hand-rolled-selection` note to the file (frontend-policy).",
|
|
1036
|
+
severity: "block",
|
|
1037
|
+
skill: "frontend-policy"
|
|
1038
|
+
},
|
|
983
1039
|
{
|
|
984
1040
|
id: "fe-icon-action-button",
|
|
985
1041
|
label: "Repeated actions are icon buttons, not text labels",
|
|
@@ -1776,7 +1832,9 @@ var FILE_CHECKS = {
|
|
|
1776
1832
|
"ts-alias-deep-relative": (content, file) => deepRelativeImports(content, file),
|
|
1777
1833
|
"ts-alias-paths": (content, file) => missingPathAlias(content, file),
|
|
1778
1834
|
"sec-operator-env-leak": (content) => operatorHomePathLeak(content),
|
|
1779
|
-
"fe-new-password-affordance-on-signin": (content) => newPasswordAffordanceOnSignIn(content)
|
|
1835
|
+
"fe-new-password-affordance-on-signin": (content) => newPasswordAffordanceOnSignIn(content),
|
|
1836
|
+
"fe-context-menu-hand-rolled": (content) => handRolledContextMenu(content),
|
|
1837
|
+
"fe-selection-hand-rolled": (content) => handRolledSelection(content)
|
|
1780
1838
|
};
|
|
1781
1839
|
var FIXERS = {
|
|
1782
1840
|
"fe-name-input-capitalize": (line, file) => {
|
|
@@ -2033,6 +2091,38 @@ function unboundedRemoteList(content) {
|
|
|
2033
2091
|
}
|
|
2034
2092
|
return out;
|
|
2035
2093
|
}
|
|
2094
|
+
var MENU_HANDLER = /onContextMenu|addEventListener\(\s*["'`]contextmenu["'`]|@contextmenu|on:contextmenu/;
|
|
2095
|
+
var MENU_POINT = /\bclient[XY]\b|\bpage[XY]\b/;
|
|
2096
|
+
var MENU_STATE = /\bset(?:ContextMenu|Menu(?:Pos|Position|Point|Anchor|Coords|Origin|At)?)\b|\bmenu(?:Pos|Position|Point|Anchor|Coords)\s*[:=]/i;
|
|
2097
|
+
var MENU_MITIGATED = /@enigmax\/primitives|createContextMenu|useContextMenuContext|<ContextMenu|ContextMenu\.|radix-ui|@headlessui|@szhsin\/react-menu|primereact|@mui\/material|antd|enigma:allow-hand-rolled-menu/;
|
|
2098
|
+
function handRolledContextMenu(content) {
|
|
2099
|
+
if (MENU_MITIGATED.test(content)) return [];
|
|
2100
|
+
if (!MENU_HANDLER.test(content) || !MENU_POINT.test(content) || !MENU_STATE.test(content)) return [];
|
|
2101
|
+
const lines = content.split("\n");
|
|
2102
|
+
for (let i = 0; i < lines.length; i++) {
|
|
2103
|
+
const line = lines[i];
|
|
2104
|
+
if (COMMENT_LINE.test(line) || /enigma:/.test(line)) continue;
|
|
2105
|
+
if (!MENU_HANDLER.test(line)) continue;
|
|
2106
|
+
return [{ line: i + 1, detail: "a contextmenu handler, pointer coordinates and the state holding them" }];
|
|
2107
|
+
}
|
|
2108
|
+
return [];
|
|
2109
|
+
}
|
|
2110
|
+
var SELECT_RANGE_KEY = /\bshiftKey\b/;
|
|
2111
|
+
var SELECT_ADD_KEY = /\bctrlKey\b|\bmetaKey\b/;
|
|
2112
|
+
var SELECT_STATE = /\bset(?:Selected|Selection|SelectedIds|SelectedRows|Checked)\b|\bselected(?:Ids|Rows|Keys|Items)\b/;
|
|
2113
|
+
var SELECT_MITIGATED = /@enigmax\/primitives|createSelection|useSelection|<SelectionList|enigma:allow-hand-rolled-selection/;
|
|
2114
|
+
function handRolledSelection(content) {
|
|
2115
|
+
if (SELECT_MITIGATED.test(content)) return [];
|
|
2116
|
+
if (!SELECT_RANGE_KEY.test(content) || !SELECT_ADD_KEY.test(content) || !SELECT_STATE.test(content)) return [];
|
|
2117
|
+
const lines = content.split("\n");
|
|
2118
|
+
for (let i = 0; i < lines.length; i++) {
|
|
2119
|
+
const line = lines[i];
|
|
2120
|
+
if (COMMENT_LINE.test(line) || /enigma:/.test(line)) continue;
|
|
2121
|
+
if (!SELECT_RANGE_KEY.test(line)) continue;
|
|
2122
|
+
return [{ line: i + 1, detail: "Shift and Ctrl over a set of selected ids" }];
|
|
2123
|
+
}
|
|
2124
|
+
return [];
|
|
2125
|
+
}
|
|
2036
2126
|
var CLIP_ONE_LINE = /\btruncate\b|\btext-ellipsis\b|text-overflow\s*:\s*ellipsis/;
|
|
2037
2127
|
var DYNAMIC_CHILD = /(?<![=!<>-])>\s*\{(?![#/:@])/;
|
|
2038
2128
|
var VALUE_REACHABLE = /\btitle\s*=|aria-label\s*=|<\s*Tooltip|TooltipTrigger|data-tooltip|hoverCard|HoverCard/i;
|
|
@@ -2610,6 +2700,8 @@ export {
|
|
|
2610
2700
|
extensionImports,
|
|
2611
2701
|
findProjectRoot,
|
|
2612
2702
|
formatFindings,
|
|
2703
|
+
handRolledContextMenu,
|
|
2704
|
+
handRolledSelection,
|
|
2613
2705
|
loadRules,
|
|
2614
2706
|
missingPathAlias,
|
|
2615
2707
|
missingWindowsHide,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "enigma-cli",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.40.0",
|
|
4
4
|
"description": "Everything you need to work with a coding agent: install shared policy skills for Claude Code, OpenAI Codex and opencode, and set up portable git security hooks.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|