refira-cli 0.1.2 → 0.2.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/README.md +8 -5
- package/dist/index.js +878 -148
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -102,17 +102,19 @@ Options:
|
|
|
102
102
|
|
|
103
103
|
---
|
|
104
104
|
|
|
105
|
-
### 5. Live Preview & Harness Validation
|
|
105
|
+
### 5. Live Preview, Push & Harness Validation
|
|
106
106
|
|
|
107
|
-
#### `refira preview`
|
|
107
|
+
#### `refira push` (or `refira preview`)
|
|
108
108
|
Inspects an HTML markup file using the Refira Agent Harness. If violations are detected, execution halts with Exit Code 1 and actionable remediation instructions. If valid, the markup is streamed directly to the Refira Canvas.
|
|
109
109
|
|
|
110
110
|
```bash
|
|
111
|
+
refira push checkout.html --page checkout
|
|
112
|
+
# Alternatively:
|
|
111
113
|
refira preview checkout.html --page checkout
|
|
112
114
|
```
|
|
113
115
|
|
|
114
116
|
Arguments:
|
|
115
|
-
- `<file>`: Path to the HTML file to inspect and preview.
|
|
117
|
+
- `<file>`: Path to the HTML file to inspect and push/preview.
|
|
116
118
|
|
|
117
119
|
Options:
|
|
118
120
|
- `--page <slug>`: Target page slug.
|
|
@@ -136,15 +138,16 @@ refira skill install --global
|
|
|
136
138
|
|
|
137
139
|
## Agent Harness Invariants
|
|
138
140
|
|
|
139
|
-
All markup submitted via `refira preview` must conform to these strict architectural rules:
|
|
141
|
+
All markup submitted via `refira push` / `refira preview` must conform to these strict architectural rules:
|
|
140
142
|
|
|
141
143
|
| Rule | Status | Description |
|
|
142
144
|
|---|---|---|
|
|
143
145
|
| **Standalone HTML5 + Tailwind** | Required | Markup must be valid native HTML5 with Tailwind CSS utility classes. |
|
|
144
146
|
| **No UI Frameworks** | Prohibited | React, Vue, Svelte, Angular, Solid, and JSX syntax (`className=`, `onClick={...}`, `<Component />`) are rejected. |
|
|
145
|
-
| **No External / Inter-Page Navigation** | Prohibited | Prototypes run inside sandboxed iframes. Anchors (`<a href="...">`) pointing to external URLs
|
|
147
|
+
| **No External / Inter-Page Navigation** | Prohibited | Prototypes run inside sandboxed iframes. Anchors (`<a href="...">`) pointing to external URLs, relative pages (e.g. `/checkout`), empty `href=""`, or `javascript:` navigation are rejected. Only in-page anchors (`href="#section"`) or placeholders (`href="#"`) are allowed. Target attributes (`target="_blank"`, `target="_top"`) and `<form action="...">` are prohibited. For interactive triggers, use `<button type="button">`. |
|
|
146
148
|
| **No Raw Emojis in Markup** | Prohibited | Raw unicode emojis (e.g. rocket, fire, sparkles) in HTML text nodes or attributes are rejected to maintain professional aesthetic quality. Use Lucide Icons or Heroicons SVG elements instead. |
|
|
147
149
|
| **Graphics & Animation Libraries** | Permitted | Standalone CDN scripts such as Three.js, GSAP, Spline Viewer, and Lucide Icons are explicitly allowed in document `<head>` or `<script>`. |
|
|
150
|
+
| **Mandatory Push Execution** | Required | AI agents are strictly forbidden from stopping after writing a local file. The task is only complete when `refira push` succeeds with exit code 0. |
|
|
148
151
|
|
|
149
152
|
---
|
|
150
153
|
|