1.0.0-gamma.5: 3 automatic repairs before a stop (named levers, then the AI's own fix); a site nested in a folder is taken from that folder (from d68e89f)

Author: iOSDevSK

.claude-plugin/marketplace.json

@@ -14,7 +14,7 @@
       "source": "./",
       "displayName": "html2wp — HTML to WordPress",
       "description": "BETA. Convert a static HTML site into a standalone WordPress block theme, verified against the original at three viewport widths — and reviewed by you before handover. The conversion runs through a verified Astro 5 build, so the Astro project is a real output too — compared pixel by pixel against the source before anything WordPress-shaped is generated.",
-      "version": "1.0.0-gamma.4",
+      "version": "1.0.0-gamma.5",
       "author": {
         "name": "BELNEM s.r.o.",
         "email": "hello@html2wp.dev",

.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "html2wp",
   "displayName": "html2wp — HTML to WordPress",
   "description": "BETA. Convert a static HTML site — or anything that builds to one (Lovable, Bolt, v0, Next export) — into a standalone WordPress block theme: verified pixel by pixel, pages, blog, forms, menus, SEO and redirects, with no plugin required and verification gates at every stage. Two modes: Full (every gate repaired until green, then your own page-by-page review) and Flash (every stage once, no repair loop, the gates reported). The gates catch most fidelity drift, not all of it.",
-  "version": "1.0.0-gamma.4",
+  "version": "1.0.0-gamma.5",
   "author": {
     "name": "BELNEM s.r.o.",
     "email": "hello@html2wp.dev",

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "html2wp",
-  "version": "1.0.0-gamma.4",
+  "version": "1.0.0-gamma.5",
   "description": "Convert static HTML or buildable web projects into verified, editable WordPress block themes.",
   "author": {
     "name": "BELNEM s.r.o.",

VERSION

@@ -1 +1 @@
-1.0.0-gamma.4
+1.0.0-gamma.5

skills/html2wp/SKILL.md

@@ -423,11 +423,20 @@ a stuck fix gives up; the attempts are in the report.
   `h2wp-signature: <key>` (make-zip, article-part.py, preflight-listings,
   check-manifest `--flash`, stage3-remote's WordPress, check-prereqs, the Woo
   audit's cart probe). `assets/repair-levers.json` maps each key to its
-  levers, in order — the only repairs Flash may try for it. A failure with no
-  signature has no lever: record it.
-- **The budget:** 4 attempts per run, at most 2 per stage, never the same lever
-  on the same failure twice. `progress.sh` counts them and refuses (exit 3)
-  anything beyond — that refusal is the rule.
+  levers, in order — tried first, each once.
+- **Then the AI's own fix (`ai-fix`).** When a failure that would stop the run
+  has spent its named levers, or no script named it (signature `unnamed`),
+  the attempts left are yours: read the failing command's output and logs,
+  find the cause, change only what causes it — never a gate, a check or its
+  thresholds — run the failing command once, and say in the close note what
+  you changed and why: `progress.sh repair <stage> ai-fix <signature|unnamed>`.
+  A failure that is only recorded red (`warn`) gets its named levers, not
+  `ai-fix`.
+- **The budget:** 9 attempts per run, at most 3 per stage, never the same
+  named lever on the same failure twice. `progress.sh` counts them and refuses
+  (exit 3) anything beyond — that refusal is the rule. A run stops only after
+  its stage's 3 attempts; the app then offers Repair and continue, where the
+  owner may pick a stronger model first.
 - **A repair happens INSIDE the stage that failed,** before the stage is
   closed — never as a second run of it:
 
@@ -487,7 +496,7 @@ container has no `apply_patch` command.
 | mode | `progress.sh mode flash` | — | — |
 | -4 | `whats-here.sh {workspace}` (a finished or part-finished workspace: follow its route — a Continue resumes, never restarts); `allowance.sh` (print its line verbatim); `detect-project.py <project> --out {workspace}/detect.json` | — | kind `none`; a site over the page allowance (say it, with the service's words) |
 | -3 | `$S/check-prereqs.sh` — in the app exactly `/opt/html2wp/skills/html2wp/assets/scripts/check-prereqs.sh` | — | a missing tool (it prints what to install) |
-| -1 | by kind — `static-html`: `rsync -a --exclude .git --exclude node_modules --exclude .html2wp <project>/ {input}/`; `web-app`: `prerender-spa.py --project <project> --out {input} --no-verify --flash` (a group of pages — a route table's `/product/:id`, or pages sharing a path with one varying last segment like a TanStack `/blog/<slug>` — is recorded once, on its first page, and each other page shares that recording only when its controls are the same; the pages are captured in `--jobs` browsers, entrance motion is waited for at most 6 s; it says "N of M" as it goes); `static-site`: `static-site.py --project <project> --out {input}` (exit 3 → `prerender-spa.py … --no-verify --flash` instead, once); `html2wp-astro`: `detect-project.py <project> --prepare {workspace}` | — | no pages written (exit 2; 1 from static-site.py) |
+| -1 | by kind — `static-html`: `rsync -a --exclude .git --exclude node_modules --exclude .html2wp <root>/ {input}/` — `<root>` is detect.json's `root`, never `<project>` itself (a site nested in a folder, `<project>/<name>/index.html`, is taken from that folder); `web-app`: `prerender-spa.py --project <project> --out {input} --no-verify --flash` (a group of pages — a route table's `/product/:id`, or pages sharing a path with one varying last segment like a TanStack `/blog/<slug>` — is recorded once, on its first page, and each other page shares that recording only when its controls are the same; the pages are captured in `--jobs` browsers, entrance motion is waited for at most 6 s; it says "N of M" as it goes); `static-site`: `static-site.py --project <project> --out {input}` (exit 3 → `prerender-spa.py … --no-verify --flash` instead, once); `html2wp-astro`: `detect-project.py <project> --prepare {workspace}` | — | no pages written (exit 2; 1 from static-site.py) |
 | 0 | `cp -a {input} {workspace}/input-untouched`; `analyze-input.mjs {input} --out={workspace}/analysis.json`; `flash-manifest.py --analysis {workspace}/analysis.json --input {input} --workspace {workspace}`; decide (below); `check-manifest.py --manifest={workspace}/conversion-manifest.json --flash` | — | analyze exit 2 (refusal, key collision); check-manifest still red after its lever |
 | -1b | a shop: `capture-commerce-specimen.py --dist {input} --out {workspace}/style-specimens`; no shop: `skip` (it comes after stage 0 because stage 0 decides the shop) | a nonzero exit | — |
 | 0.5 | `optimize-images.py --input {input} --remote --apply --out {workspace}/optimize-images-report.json` (`skip` for `html2wp-astro`) | a nonzero exit | — |
@@ -510,7 +519,7 @@ Flash writes no `anchors` and no Gate-0 summary into the manifest — the
 decisions go into the report.
 
 **The stop path** — only when there is no theme to deliver and the stage's
-levers are spent (or it has none): `progress.sh fail <stage> "<why>"`; write
+3 attempts are spent (named levers, then `ai-fix`): `progress.sh fail <stage> "<why>"`; write
 `CONVERSION-REPORT.md` with what ran, what stopped it (the script's own words),
 the repairs tried and what the owner can do; when stage 3 opened a service
 job, `send-verdicts.sh {workspace} --outcome=abandoned`; then
@@ -679,8 +688,8 @@ message (and Continue) on a stopped run comes with `H2WP_MODE=repair-stop`.
    the log is gone — that is reading, not a repair). What the owner wrote may
    name the fix; it still goes through a lever.
 2. **Spend the levers of that stage** ("Flash repairs", above): each owner
-   message allows 2 attempts on the stage that stopped the run, apart from the
-   run's own 4 —
+   message allows 3 attempts on the stage that stopped the run (its named
+   levers, then `ai-fix`), apart from the run's own 9 —
 
    ```
    progress.sh repair <the stopped stage> <lever> <signature>
@@ -694,7 +703,7 @@ message (and Continue) on a stopped run comes with `H2WP_MODE=repair-stop`.
    stage 6.5 and `write-result.py` included (Flash: the "Flash mode" table;
    the mode is the one the run started with, whatever `H2WP_MODE` says about
    the turn). Never the stages before it, never `mode`, never a new run.
-4. **Not fixed** (the attempts are spent, or no lever fits): write the stop
+4. **Not fixed** (the message's 3 attempts are spent): write the stop
    again — `write-result.py {workspace} --status stopped --stopped-stage
    <stage> --stopped-reason "<why>"` — and tell the owner plainly what could
    not be fixed and why, in their words, with what they can do (a different

skills/html2wp/VERSION

@@ -1 +1 @@
-1.0.0-gamma.4
+1.0.0-gamma.5

skills/html2wp/assets/repair-levers.json

@@ -1,9 +1,9 @@
 {
   "schema": "h2wp-repair-levers/1",
-  "about": "Flash's repair budget (SKILL.md, \"Flash repairs\"). A refusing script prints `h2wp-signature: <key>`; the key names the failure, and its levers are the only repairs Flash may try for it, in this order. progress.sh repair counts every attempt: 4 per run, at most 2 per stage, never the same lever on the same failure twice. A remedy is followed by the failing command again, then progress.sh repaired.",
-  "pool": 4,
-  "perStage": 2,
-  "perOwnerMessage": 2,
+  "about": "Flash's repair budget (SKILL.md, \"Flash repairs\"). A refusing script prints `h2wp-signature: <key>`; the key names the failure, and its levers are the only repairs Flash may try for it, in this order. progress.sh repair counts every attempt: 9 per run, at most 3 per stage (3 per owner message on a stopped run), never the same named lever on the same failure twice; when a failure's named levers are spent, or no script named it (`unnamed`), the attempts left are the AI's own diagnosed fix (`ai-fix`). A remedy is followed by the failing command again, then progress.sh repaired.",
+  "pool": 9,
+  "perStage": 3,
+  "perOwnerMessage": 3,
   "signatures": {
     "manifest-undecided": {
       "stages": [
@@ -97,6 +97,13 @@
       "levers": [
         "prereqs-again"
       ]
+    },
+    "unnamed": {
+      "stages": [
+        "*"
+      ],
+      "what": "a failure that stops the run and that no script named with h2wp-signature",
+      "levers": []
     }
   },
   "levers": {
@@ -156,6 +163,11 @@
       "label": "check the prerequisites again",
       "remedy": "The owner installed what check-prereqs named; run it again.",
       "again": "$S/check-prereqs.sh"
+    },
+    "ai-fix": {
+      "label": "the AI's own diagnosed fix",
+      "remedy": "Read the failing command's output and logs, find the cause, and change only what causes it (never a gate, a check or its thresholds). Say in the close note what you changed and why.",
+      "again": "the failing command, once"
     }
   }
 }

skills/html2wp/assets/scripts/detect-project.py

@@ -49,12 +49,16 @@
 def input_root(root):
     """The project inside an upload: the directory itself when it holds a
     package.json or an index.html, else its one subdirectory (a ZIP that
-    unpacked into a folder)."""
-    if (root / "package.json").exists() or (root / "index.html").exists():
-        return root
-    children = [c for c in root.iterdir() if not c.name.startswith((".", "__MACOSX"))]
-    if len(children) == 1 and children[0].is_dir() and not children[0].is_symlink():
-        return children[0]
+    unpacked into a folder, or a site in a named folder beside a README),
+    a few levels down at most."""
+    for _ in range(3):
+        if (root / "package.json").exists() or (root / "index.html").exists():
+            return root
+        dirs = [c for c in root.iterdir() if c.is_dir() and not c.is_symlink()
+                and not c.name.startswith((".", "__MACOSX")) and c.name != "node_modules"]
+        if len(dirs) != 1 or any(c.suffix.lower() in (".html", ".htm") for c in root.iterdir() if c.is_file()):
+            return root
+        root = dirs[0]
     return root
 
 

skills/html2wp/assets/scripts/lib/repair_budget.py

@@ -14,10 +14,12 @@
 failed is never started again — the repair happens inside it, before it is
 closed with done, warn or fail.
 
-The caps (from the table): 4 attempts per run, at most 2 per stage, never the
-same lever on the same failure twice. A stopped run (result.json status
+The caps (from the table): 9 attempts per run, at most 3 per stage, never the
+same named lever on the same failure twice. When a failure's named levers are
+spent, or no script named it (signature `unnamed`), the attempts left are the
+AI's own diagnosed fix (lever `ai-fix`), each counted like any other. A stopped run (result.json status
 "stopped") is repaired only in a turn the owner started (H2WP_MODE=repair-stop):
-each owner message allows 2 attempts on the stage that stopped the run, apart
+each owner message allows 3 attempts on the stage that stopped the run, apart
 from the run's own 4 — a message is the app's turn id (H2WP_TURN), else (a
 CLI) the stopped result it answers. A fixed attempt there puts the stopped
 result aside and sets the run running again, so it continues from that stage;
@@ -93,9 +95,16 @@ def open_attempt(pf, rf, stage, lever, signature):
     if not sig:
         return refuse(f"no such failure signature '{signature}'. A script that refuses prints "
                       f"`h2wp-signature: <key>`; the keys: {', '.join(sorted(signatures))}")
-    if stage not in sig.get("stages", []):
+    if stage not in sig.get("stages", []) and "*" not in sig.get("stages", []):
         return refuse(f"'{signature}' is a failure of stage {' or '.join(sig.get('stages', []))}, not of stage {stage}.")
-    if lever not in sig.get("levers", []):
+    if lever == "ai-fix":
+        untried = [lv for lv in sig.get("levers", []) if not any(
+            r.get("stage") == stage and r.get("signature") == signature and r.get("lever") == lv
+            for r in progress.get("repairs") or [] if isinstance(r, dict))]
+        if untried:
+            return refuse(f"'{signature}' still has a named lever: {untried[0]}. The AI's own fix comes "
+                          "after the named levers are spent.")
+    elif lever not in sig.get("levers", []):
         return refuse(f"'{lever}' is not a lever for '{signature}'. Its levers, in order: "
                       f"{', '.join(sig.get('levers', []))}.")
     repairs = [r for r in progress.get("repairs") or [] if isinstance(r, dict)]
@@ -113,7 +122,7 @@ def open_attempt(pf, rf, stage, lever, signature):
                           "the owner started (SKILL.md, \"A stopped run — repair, then continue\").")
         if stage != at:
             return refuse(f"the run stopped at stage {at}: only that stage's levers can be spent now.")
-        by, turn, cap = "owner", owner_turn(result), int(meta.get("perOwnerMessage", 2))
+        by, turn, cap = "owner", owner_turn(result), int(meta.get("perOwnerMessage", 3))
         mine = [r for r in repairs if r.get("by") == "owner" and r.get("turn") == turn]
         if len(mine) >= cap:
             return refuse(f"this message's {cap} repair attempts on stage {stage} are spent. Record the stop again "
@@ -125,25 +134,25 @@ def open_attempt(pf, rf, stage, lever, signature):
             return refuse(f"stage {stage} is not running. A repair happens INSIDE the stage that failed, before it "
                           "is closed with done, warn or fail — never as a second run of it.")
         by, turn = "run", None
-        pool, per = int(meta.get("pool", 4)), int(meta.get("perStage", 2))
+        pool, per = int(meta.get("pool", 9)), int(meta.get("perStage", 3))
         mine = [r for r in repairs if r.get("by", "run") == "run"]
         if len(mine) >= pool:
             return refuse(f"the run's {pool} repair attempts are spent. Record stage {stage} red "
                           "(progress.sh warn, or fail when there is no theme and no fallback) and go on.")
         if len([r for r in mine if r.get("stage") == stage]) >= per:
             return refuse(f"stage {stage} has had its {per} repair attempts. Record it red "
                           "(progress.sh warn, or fail when there is no theme and no fallback) and go on.")
-    if any(r.get("stage") == stage and r.get("signature") == signature and r.get("lever") == lever
+    if lever != "ai-fix" and any(r.get("stage") == stage and r.get("signature") == signature and r.get("lever") == lever
            and r.get("by", "run") == by and (by == "run" or r.get("turn") == turn) for r in repairs):
         untried = [lv for lv in sig.get("levers", []) if not any(
             r.get("stage") == stage and r.get("signature") == signature and r.get("lever") == lv for r in repairs)]
         return refuse(f"'{lever}' was already tried on '{signature}' at stage {stage} — the same lever on the same "
                       "failure again is a loop. "
-                      + (f"Next lever: {untried[0]}." if untried else "No lever is left for it: record it red."))
+                      + (f"Next lever: {untried[0]}." if untried else "Next: ai-fix, the AI's own diagnosed fix."))
 
     n = len([r for r in repairs if r.get("stage") == stage and r.get("by", "run") == by
              and (by == "run" or r.get("turn") == turn)]) + 1
-    of = int(meta.get("perOwnerMessage", 2)) if by == "owner" else int(meta.get("perStage", 2))
+    of = int(meta.get("perOwnerMessage", 3)) if by == "owner" else int(meta.get("perStage", 3))
     row = {"stage": stage, "attempt": n, "of": of, "lever": lever, "signature": signature,
            "label": (levers.get(lever) or {}).get("label", lever), "what": sig.get("what", ""),
            "outcome": "open", "at": now(), "by": by}
@@ -155,7 +164,7 @@ def open_attempt(pf, rf, stage, lever, signature):
     progress["repairs"] = repairs
     write(pf, progress)
     spec = levers.get(lever) or {}
-    where = f"pool {row['pool']}/{meta.get('pool', 4)}" if by == "run" else "the owner's message"
+    where = f"pool {row['pool']}/{meta.get('pool', 9)}" if by == "run" else "the owner's message"
     print(f"\n  repair {n}/{of} of stage {stage} ({where}) — {spec.get('label', lever)}")
     print(f"    remedy: {spec.get('remedy', '')}")
     if spec.get("again"):

skills/html2wp/assets/scripts/stage2-gates.sh

@@ -146,4 +146,12 @@ done
 echo
 echo "==> stage2-gates: $(( T1 - T0 ))s wall clock"
 printf '%s' "$SUMMARY"
+# Gate A / A2 red never stops a run: they are recorded (warn) and the run goes
+# on. Only what the upload needs (chrome-groups, capture-chrome,
+# detect-collections; bits 4, 8, 16) can stop stage 2.
+if [ $(( STATUS & 28 )) -ne 0 ]; then
+  echo "==> stage 2 verdict: the upload needs the FAILED step(s) above — repair them inside stage 2; stop only after its 3 attempts"
+elif [ "$STATUS" -ne 0 ]; then
+  echo "==> stage 2 verdict: gate A/A2 red — record it (progress.sh warn 2 …) and go on to stage 3; this never stops the run"
+fi
 exit "$STATUS"