diff --git a/.tidyfactor b/.tidyfactor index ddd1895..27c1b5a 100644 --- a/.tidyfactor +++ b/.tidyfactor @@ -2,7 +2,7 @@ "ecosystem": "tidyfactor", "track": "html", "name": "tidyfactor-html", - "version": "1.2.0", + "version": "1.3.0", "npmPackage": "@alwkala/tidyfactor-html", "github": "https://github.com/TidyFactor/HTML", "skillFile": "../tidyfactor-html-v1.1.0.skill", diff --git a/CHANGELOG.md b/CHANGELOG.md index 127483a..b5cb2fb 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,18 @@ All notable changes to the **[@tidyfactor/html](https://www.npmjs.com/package/@tidyfactor/html)** package will be documented in this file. +## [1.3.0] - 2026-09-10 + +### Added — Agentic Browsing Readiness & llms.txt Discovery +- **SEO & Machine Discovery Command Update (`references/commands/seo.md`)**: + - Injected standard `` discovery tag into ``. + - Added deterministic check for AI-agent-friendly semantic HTML controls and non-blocking `robots.txt` configuration for `GPTBot` and `ClaudeBot`. +- **Quality Gate Expansion (`references/memory/quality-bar.md`)**: + - Expanded Axis S to enforce Agentic Browsing readiness, accessible names for interactive nodes, and `/llms.txt` discovery tags. + - Added CLS threshold (≤ 0.05) to Axis V to prevent autonomous agent click targeting failures. + +--- + ## [1.2.0] - 2026-08-29 ### Added - Global Multi-Tier & Multi-Language Documentation Architecture diff --git a/README.ar.md b/README.ar.md index f64646a..d3bc8f4 100644 --- a/README.ar.md +++ b/README.ar.md @@ -1,7 +1,7 @@
-# 🌐 مهارة تايتفكتور للمواقع الثابتة `TidyFactor HTML v1.2.0` -### محرك المواقع الثابتة بنسبة 100% ومكونات الويب Web Components لوكلاء الذكاء الاصطناعي +# 🌐 مهارة تايتفكتور للمواقع الثابتة `TidyFactor HTML v1.3.0` +### محرك المواقع الثابتة بنسبة 100%، مكونات الويب، وجاهزية تصفح الوكلاء (Agentic Browsing) [![npm version](https://img.shields.io/npm/v/@tidyfactor/html.svg?style=for-the-badge&color=E34F26&logo=npm)](https://www.npmjs.com/package/@tidyfactor/html) [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE) diff --git a/README.md b/README.md index 02fc35b..fc14ba3 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@
-# 🌐 TidyFactor HTML `v1.2.0` -### 100% Static Platform Starter, Web Components & Contextual Decision Engine +# 🌐 TidyFactor HTML `v1.3.0` +### 100% Static Platform Starter, Web Components, Agentic Browsing & Contextual Decision Engine **The official static web engineering track within the TidyFactor Architecture Ecosystem.** diff --git a/brand.json b/brand.json index 1cbf2bc..b1ecc89 100644 --- a/brand.json +++ b/brand.json @@ -1,6 +1,6 @@ { "name": "TidyFactor HTML", - "version": "1.2.0", + "version": "1.3.0", "schemaVersion": "brand-core-v2", "meta": { "product": "TidyFactor HTML", diff --git a/package.json b/package.json index 97861d6..e840ca2 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "@tidyfactor/html", - "version": "1.2.0", - "description": "TidyFactor HTML track — 100% static HTML/CSS/JS platform starter with Contextual Decision Layer (CDL)", + "version": "1.3.0", + "description": "TidyFactor HTML track — 100% static HTML/CSS/JS platform starter with Contextual Decision Layer (CDL) & Agentic Browsing Readiness", "main": "SKILL.md", "bin": { "tidyfactor-html": "bin/add-skill.js", diff --git a/references/commands/seo.md b/references/commands/seo.md index 8a24e24..157e61b 100644 --- a/references/commands/seo.md +++ b/references/commands/seo.md @@ -26,16 +26,18 @@ sitemap, robots. 4. Structured data (JSON-LD) where it clearly applies (Article, Product, Organization, BreadcrumbList) — don't force schema types that don't fit the content. -5. Generate/update `sitemap.xml` by walking the final `/dist` (or source) - page tree, and `robots.txt` pointing to it. -6. Bilingual mode: cross-reference `i18n.md`'s `hreflang` requirement — +5. AI Agent & LLM Discovery: Add `` + to `` of main layout/index to enable seamless agentic ingestion. +6. Generate/update `sitemap.xml` by walking the final `/dist` (or source) + page tree, and `robots.txt` pointing to it (ensuring AI bots like GPTBot/ClaudeBot are not blanket blocked). +7. Bilingual mode: cross-reference `i18n.md`'s `hreflang` requirement — `seo` is what actually adds it if `i18n` hasn't run yet. ## Output convention ``` /dist/sitemap.xml (or /sitemap.xml in runtime mode) /dist/robots.txt -Per-page: , <meta description>, og:*, twitter:*, canonical, JSON-LD +Per-page: <title>, <meta description>, og:*, twitter:*, canonical, JSON-LD, llms.txt discovery ``` ## Checklist @@ -44,3 +46,5 @@ Per-page: <title>, <meta description>, og:*, twitter:*, canonical, JSON-LD - [ ] `sitemap.xml` matches the actual final page tree, no stale entries - [ ] `robots.txt` present and correctly points to the sitemap - [ ] Canonical URLs match the structure `pages.md` established +- [ ] `llms.txt` discovery tag included in HTML `<head>` +- [ ] All interactive buttons/links declare semantic tags and accessible names for AI agents diff --git a/references/memory/quality-bar.md b/references/memory/quality-bar.md index d6f3088..6535b5b 100644 --- a/references/memory/quality-bar.md +++ b/references/memory/quality-bar.md @@ -14,7 +14,7 @@ Every generated static page, component, or config must be stamped: | **P** | **Philosophy & Zero Runtime** | Requires Node runtime, SSR, or backend server to view. | 100% static HTML/CSS/JS; runs by double-clicking or uploading to cPanel. | | **H** | **HTML5 Semantics & Structure** | `<div>` soup; missing `main`, `header`, `nav`, `section`, `footer`. | Semantic HTML5 structure with proper heading hierarchy (`h1` -> `h2` -> `h3`). | | **E** | **Encapsulation & Links** | Absolute workstation paths (`file:///C:/...`) or broken relative links. | Clean relative links (`./css/style.css`, `../assets/icon.svg`). | -| **S** | **SEO & Metadata Integrity** | Missing OpenGraph tags, meta description, or viewport meta tag. | Complete OpenGraph, Twitter Cards, canonical URL, and favicon links. | +| **S** | **SEO & Agentic Readiness** | Missing OpenGraph tags, no `llms.txt` discovery, non-semantic div-buttons causing agent click failures. | Complete OpenGraph, Twitter Cards, canonical URL, `/llms.txt` discovery tag, and accessible semantic controls for AI agents. | | **R** | **RTL & Internationalization** | Hardcoded text in markup preventing localization; broken RTL. | `dir="rtl"` / `lang="ar"` support with CSS logical properties (`margin-inline`). | -| **V** | **Velocity & Asset Hygiene** | Uncompressed 5MB hero images; blocking render scripts. | Optimized SVGs, WebP images with explicit width/height, deferred scripts. | +| **V** | **Velocity & Asset Hygiene** | Uncompressed 5MB hero images; blocking render scripts; layout shifts (CLS > 0.1). | Optimized SVGs, WebP images with explicit width/height (CLS ≤ 0.05), deferred scripts. | | **D** | **Decision Alignment** | Inconsistent foundation ignoring `.tidyfactor/html-brief.md`. | 100% compliant with confirmed Component Model and CSS strategy. |