Refresh project statistics and source audit

README.md

@@ -57,11 +57,15 @@ Current release: **v0.9.0**
 | Surface | Count |
 | --- | ---: |
 | Resources | 601 |
+| Research papers | 220 |
+| Model-layer resources | 29 |
 | Operational patterns | 20 |
 | Adaptable loop contracts | 20 |
 | Runtime starters | 8 |
+| Dataset fields | 50 |
+| Language entry points | 8 |
 
-At the **2026-07-20** source check, **547 public links opened successfully**, **6 required access**, **48 pointed to repository files**, and **0 were broken or unreachable**.
+At the **2026-07-20** source check, **548 public links opened successfully**, **5 required access**, **48 pointed to repository files**, and **0 were broken or unreachable**.
 
 ## What A Loop Contract Is
 

data/resources.parquet

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:2014d940a1076cb34c9403ca3aea038654eb3d49d0b1bbb111db15186ea03a31
-size 494773
+oid sha256:f58ce5585120e05a2d87f3d36cf94e83d933df69bf51a295d9e587bd9f270d7f
+size 497218

design-qa.md

@@ -78,7 +78,7 @@
 - Mobile navigation: opens all nine project links, reports `aria-expanded="true"`, closes on Escape, and restores focus to the menu button.
 - Pattern filter: `accessibility` returns exactly one of the 20 patterns.
 - Resource Atlas: remains idle above the fold, loads on approach or a direct resource anchor, and reports `601 of 601 resources | showing 8` on a fresh mobile load.
-- Resource interactions: the Model loop-layer filter returns 24 of 601 resources (23 papers plus Awesome Loop Models), paginates eight at a time on mobile, and renders LoopWM with its 2026 arXiv record and adjacent-scope label.
+- Resource interactions: the Model loop-layer filter returns 29 of 601 resources (28 papers plus Awesome Loop Models), paginates eight at a time on mobile, and renders Loopie and LoopWM with their 2026 arXiv records and adjacent-scope labels.
 - Resource row schema: desktop exposes Work, Year, Published at, and Evidence; mobile stacks the same labels. A `ReasoningBank` query returns one row with its ICLR venue, arXiv identifier, Tier A evidence, task fit, and source record without horizontal overflow.
 - Scene motion: the canvas frame counter advanced from 640 to 662 over 900 ms. Two canvas crops taken 1.2 seconds apart changed 17.79% of sampled RGB channels.
 - Scene pixels: the current desktop canvas has 7,062 colors with RGB standard deviations of 35.93, 29.76, and 22.29; mobile has 5,755 colors with deviations of 40.73, 30.54, and 19.70. Both renders are nonblank and well contrasted.
@@ -86,7 +86,7 @@
 - Future directions: direct-anchor restoration waits for the Resource Atlas reflow, all three audience tracks remain readable, and the agenda CTA is fully visible at desktop and mobile widths.
 - Console: no page-origin errors or warnings during mobile navigation, pattern filtering, and Resource Atlas interactions.
 - Narrow phone: 320 x 844, document width equals viewport width; the headline stays within 16 px gutters and the Three.js canvas remains fully inside the 288 px content width.
-- Source audit: 601 rows checked; 547 public sources reachable, 6 access-restricted, 48 repository-native, and 0 broken or unreachable as of 2026-07-20 UTC.
+- Source audit: 601 rows checked; 548 public sources reachable, 5 access-restricted, 48 repository-native, and 0 broken or unreachable as of 2026-07-20 UTC.
 - Data and copy: the website, README, translations, social preview source, release copy, and Hugging Face card all report 601 resources, 20 patterns, 20 contracts, 8 runtime starters, and version 0.9.0. The dataset exposes 50 fields, including `loop_layer` and `scope_fit`.
 - Semantic scene pass: the desktop hero crop paints 14.61% of pixels beyond the paper background with a 254.71 luminance range; the desktop stack paints 27.83% with a 249.98 range; the mobile hero paints 20.84% with a 229.45 range.
 - Stage interaction: selecting Verify updates `aria-pressed` across all six controls and replaces the live detail with the independent evidence-gate explanation.

docs/index.html

@@ -1770,7 +1770,7 @@
             </div>
             <p class="section-intro">Filter 601 resources by goal, loop layer, lifecycle, artifact type, and evidence class. Open any result to see its contribution, novelty, impact, scope, publication details, and original source.</p>
           </div>
-          <p class="audit-note"><strong>Last source check, 2026-07-20 UTC:</strong> 547 public links opened successfully, 6 required access, 48 point to files in this repository, and none were broken or unreachable. <a href="https://github.com/ChaoYue0307/awesome-loop-engineering/blob/main/data/resource_source_audit.csv">View the results</a> or <a href="https://github.com/ChaoYue0307/awesome-loop-engineering/issues/new?template=annotation-correction.yml">report a correction</a>.</p>
+          <p class="audit-note"><strong>Last source check, 2026-07-20 UTC:</strong> 548 public links opened successfully, 5 required access, 48 point to files in this repository, and none were broken or unreachable. <a href="https://github.com/ChaoYue0307/awesome-loop-engineering/blob/main/data/resource_source_audit.csv">View the results</a> or <a href="https://github.com/ChaoYue0307/awesome-loop-engineering/issues/new?template=annotation-correction.yml">report a correction</a>.</p>
           <div class="loop-layer-map" aria-label="Where different loop concepts live">
             <div class="loop-layer-item"><span>Inner loop</span><strong>Model recurrence</strong><p>A learned block refines hidden or latent state inside one inference. Included as an adjacent foundation.</p></div>
             <div class="loop-layer-item"><span>Task loop</span><strong>Agent execution</strong><p>The model reasons, calls tools, observes results, and updates working state while solving one task.</p></div>

meta/DISTRIBUTION.md

@@ -60,21 +60,21 @@ Do not use reciprocal-star requests, broad promotional pull requests, or unrelat
 
 GitHub retains repository traffic details for only 14 days. Record a snapshot weekly, using the same definitions each time.
 
-Snapshot captured on 2026-07-18 for the API window ending 2026-07-17:
+Snapshot captured on 2026-07-20 for the API window ending 2026-07-19:
 
 | Metric | Baseline |
 | --- | ---: |
-| Repository views | 452 |
-| Unique visitors | 146 |
-| Clones | 614 |
-| Unique cloners | 173 |
-| Stars | 31 |
-| Forks | 6 |
+| Repository views | 637 |
+| Unique visitors | 157 |
+| Clones | 720 |
+| Unique cloners | 199 |
+| Stars | 35 |
+| Forks | 7 |
 | Watchers | 1 |
 
-The repository overview reached 118 unique visitors. The Chinese README remained the second-most visited content path with 20 unique visitors. The largest identifiable referrers were Google (19 unique visitors), GitHub (18), Bing (12), and the project site (8); X contributed one identifiable visitor. Clone traffic rose sharply on July 16-17 and may include automated clients, so do not treat clone counts as human adoption without corroborating forks or contributions.
+The repository overview reached 126 unique visitors. The Chinese README remained the second-most visited content path with 20 unique visitors. The largest identifiable referrers were GitHub and Google (22 unique visitors each), Bing (11), and the project site (8); X contributed two identifiable visitors. Clone traffic remains unusually high and may include automated clients, so do not treat clone counts as human adoption without corroborating forks or contributions.
 
-Since the previous snapshot, stars increased from 26 to 31 and forks from 4 to 6 while watchers remained at 1. The next campaign should therefore prioritize qualified external reach and the low-noise release/digest subscription path, not more landing-page decoration.
+Since the previous snapshot, stars increased from 31 to 35 and forks from 6 to 7 while watchers remained at 1. Qualified discovery is improving, but release and discussion subscriptions remain the clearest gap; the next campaign should keep prioritizing useful external reach and the low-noise release/digest path.
 
 Working 30-day campaign targets:
 

meta/hf_card_body.md

@@ -24,9 +24,13 @@ Current release: **v{{VERSION}}**
 | Surface | Count |
 | --- | ---: |
 | Resources | {{RESOURCE_COUNT}} |
+| Research papers | {{PAPER_COUNT}} |
+| Model-layer resources | {{MODEL_COUNT}} |
 | Operational patterns | {{PATTERN_COUNT}} |
 | Adaptable loop contracts | {{CONTRACT_COUNT}} |
 | Runtime starters | {{RUNNABLE_COUNT}} |
+| Dataset fields | {{FIELD_COUNT}} |
+| Language entry points | {{LANGUAGE_COUNT}} |
 
 At the **{{AUDIT_DATE}}** source check, **{{REACHABLE_COUNT}} public links opened successfully**, **{{RESTRICTED_COUNT}} required access**, **{{LOCAL_COUNT}} pointed to repository files**, and **{{BROKEN_COUNT}} were broken or unreachable**.
 

scripts/build_hf_card.py

@@ -35,15 +35,24 @@ def load_rows() -> list[dict[str, str]]:
 def project_context() -> dict[str, str]:
     rows = load_rows()
     statuses = Counter(row.get("source_status", "") for row in rows)
+    resource_types = Counter(row.get("resource_type", "") for row in rows)
+    loop_layers = Counter(row.get("loop_layer", "") for row in rows)
     audit_dates = sorted({row.get("audited_at", "")[:10] for row in rows if row.get("audited_at")})
     version_match = re.search(r"^version:\s*([^\s]+)\s*$", CITATION.read_text(encoding="utf-8"), re.MULTILINE)
 
     patterns = [path for path in (ROOT / "patterns").glob("*.md") if path.name not in {"README.md", "MATRIX.md"}]
     contracts = list((ROOT / "examples").glob("*-loop.json"))
     runnable = [path for path in (ROOT / "examples" / "runnable").iterdir() if path.is_file() and path.name != "README.md"]
+    executable = [path for path in runnable if path.suffix != ".md"]
+    runtime_templates = [path for path in runnable if path.suffix == ".md"]
+    language_count = 1 + len(list(ROOT.glob("README.*.md")))
 
     return {
         "RESOURCE_COUNT": str(len(rows)),
+        "PAPER_COUNT": str(resource_types["Paper"]),
+        "MODEL_COUNT": str(loop_layers["model"]),
+        "MODEL_PAPER_COUNT": str(sum(row.get("loop_layer") == "model" and row.get("resource_type") == "Paper" for row in rows)),
+        "FIELD_COUNT": str(len(rows[0]) if rows else 0),
         "REACHABLE_COUNT": str(statuses["ok"]),
         "RESTRICTED_COUNT": str(statuses["restricted"]),
         "LOCAL_COUNT": str(statuses["local_ok"]),
@@ -52,6 +61,9 @@ def project_context() -> dict[str, str]:
         "PATTERN_COUNT": str(len(patterns)),
         "CONTRACT_COUNT": str(len(contracts)),
         "RUNNABLE_COUNT": str(len(runnable)),
+        "EXECUTABLE_COUNT": str(len(executable)),
+        "RUNTIME_TEMPLATE_COUNT": str(len(runtime_templates)),
+        "LANGUAGE_COUNT": str(language_count),
         "VERSION": version_match.group(1) if version_match else "unversioned",
     }
 

scripts/check_project_consistency.py

@@ -107,6 +107,11 @@ def main() -> int:
     context = project_context()
     count = context["RESOURCE_COUNT"]
     version = context["VERSION"]
+    source_summary = (
+        f"{context['REACHABLE_COUNT']} public links opened successfully, "
+        f"{context['RESTRICTED_COUNT']} required access, "
+        f"{context['LOCAL_COUNT']} pointed to files in this repository"
+    )
     failures: list[str] = []
 
     require(
@@ -114,7 +119,9 @@ def main() -> int:
         [
             f"resources-{count}-",
             f"**{count} resources**",
-            f"At the latest <a href=\"data/resource_source_audit.csv\">source check</a>",
+            source_summary,
+            f"**{context['RUNNABLE_COUNT']} runtime starters**: {context['EXECUTABLE_COUNT']} dependency-light executables plus {context['RUNTIME_TEMPLATE_COUNT']} copy/paste runtime templates",
+            f"**{context['LANGUAGE_COUNT']} language entry points**",
         ],
         failures,
     )
@@ -124,14 +131,34 @@ def main() -> int:
             f'content="Explore {count} resources',
             f">{count}</b><span>resources</span>",
             f"Filter {count} resources",
+            f"{context['REACHABLE_COUNT']} public links opened successfully, {context['RESTRICTED_COUNT']} required access",
             f'"version": "{version}"',
         ],
         failures,
     )
     require(ROOT / "meta" / "social-preview.html", [f">{count}</b>"], failures)
-    require(ROOT / "posts" / "launch.md", [f"# Awesome Loop Engineering v{version}", f"{count} resources"], failures)
+    require(
+        ROOT / "posts" / "launch.md",
+        [
+            f"# Awesome Loop Engineering v{version}",
+            f"{count} resources",
+            f"{context['MODEL_COUNT']} model-layer resources",
+            f"{context['FIELD_COUNT']}-field CSV",
+            f"{context['LANGUAGE_COUNT']} language entry points",
+        ],
+        failures,
+    )
     require(ROOT / "posts" / "launch.zh-CN.md", [f"# Awesome Loop Engineering v{version}", f"{count} 篇论文"], failures)
     require(ROOT / "meta" / "DISTRIBUTION.md", [f"v{version}", f"{count} resources"], failures)
+    require(
+        ROOT / "design-qa.md",
+        [
+            f"returns {context['MODEL_COUNT']} of {count} resources ({context['MODEL_PAPER_COUNT']} papers plus Awesome Loop Models)",
+            f"{context['REACHABLE_COUNT']} public sources reachable, {context['RESTRICTED_COUNT']} access-restricted, {context['LOCAL_COUNT']} repository-native",
+        ],
+        failures,
+    )
+    require(ROOT / "data" / "README.md", [f"Download all {count} resources"], failures)
 
     for translation in sorted(ROOT.glob("README.*.md")):
         require(translation, [count], failures)
@@ -143,6 +170,25 @@ def main() -> int:
         failures.append(f"data/resources.csv: expected {count} rows, found {csv_count}")
     validate_resource_rows(resource_rows, failures)
 
+    with (ROOT / "data" / "resource_source_audit.csv").open(encoding="utf-8", newline="") as handle:
+        audit_rows = list(csv.DictReader(handle))
+    if len(audit_rows) != int(count):
+        failures.append(f"data/resource_source_audit.csv: expected {count} rows, found {len(audit_rows)}")
+    audit_statuses: dict[str, int] = {}
+    for row in audit_rows:
+        status = row.get("audit_status", "")
+        audit_statuses[status] = audit_statuses.get(status, 0) + 1
+    expected_statuses = {
+        "ok": int(context["REACHABLE_COUNT"]),
+        "restricted": int(context["RESTRICTED_COUNT"]),
+        "local_ok": int(context["LOCAL_COUNT"]),
+    }
+    if audit_statuses != expected_statuses:
+        failures.append(
+            "data/resource_source_audit.csv: status counts do not match the generated resource exports "
+            f"({audit_statuses!r} != {expected_statuses!r})"
+        )
+
     site_payload = json.loads((ROOT / "docs" / "assets" / "resources.json").read_text(encoding="utf-8"))
     if site_payload.get("count") != int(count) or len(site_payload.get("resources", [])) != int(count):
         failures.append("docs/assets/resources.json: count or resources array is stale")
@@ -157,8 +203,9 @@ def main() -> int:
         return 1
 
     print(
-        f"Validated {count} resources, {context['PATTERN_COUNT']} patterns, "
-        f"{context['CONTRACT_COUNT']} contracts, and release v{version}."
+        f"Validated {count} resources, {context['MODEL_COUNT']} model-layer resources, "
+        f"{context['PATTERN_COUNT']} patterns, {context['CONTRACT_COUNT']} contracts, "
+        f"{context['RUNNABLE_COUNT']} runtime starters, and release v{version}."
     )
     return 0