@gallop.software/canon 1.0.0

package/README.md

@@ -0,0 +1,83 @@
+# @gallop/canon
+
+**Gallop Enterprise Architecture Canon** — A versioned, AI-compatible, auditable system of approved web architecture patterns.
+
+## What is the Canon?
+
+The Canon is a closed set of authoritative patterns that define how serious web applications should be built. Each pattern is:
+
+- **Versioned** — Pin to a specific version, upgrade deliberately
+- **Documented** — Decision-level documentation, not just code comments
+- **Enforced** — ESLint rules, CI validation, or AI constraints
+- **Immutable** — Once released, patterns don't change
+
+## Installation
+
+```bash
+npm install @gallop/canon
+```
+
+## Usage
+
+### Access Pattern Metadata
+
+```typescript
+import { patterns, getPattern, getPatternsByCategory } from '@gallop/canon'
+
+// Get all patterns
+console.log(patterns)
+
+// Get a specific pattern
+const pattern = getPattern('001')
+console.log(pattern.title) // "Server-First Blocks"
+
+// Get patterns by category
+const renderingPatterns = getPatternsByCategory('rendering')
+```
+
+### Pattern Categories
+
+| Category | Description |
+|----------|-------------|
+| `rendering` | Server/client component boundaries |
+| `layout` | Layout hierarchy and spacing |
+| `typography` | Text component usage |
+| `structure` | File and folder organization |
+| `styling` | CSS and Tailwind patterns |
+| `components` | Component design patterns |
+| `seo` | SEO and metadata patterns |
+
+## Patterns
+
+See the [patterns/](./patterns) directory for full documentation of each pattern.
+
+### Enforced by ESLint
+
+- **001** Server-First Blocks
+- **002** Layout Hierarchy
+- **003** Typography Components
+- **004** Component Props
+
+### Documentation-Only
+
+- **005** Page Structure
+- **006** Block Naming
+- **007** Import Paths
+- **008** Tailwind Only
+- **009** Color Tokens
+- **010** Spacing System
+- **011** Responsive Mobile-First
+- **012** Icon System
+- **013** New Component Pattern
+- **014** clsx Not classnames
+- **015** No Inline Hover Styles
+- **016** Client Extraction
+- **017** SEO Metadata
+
+## Guarantees
+
+See [guarantees.md](./guarantees.md) for version-specific promises.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+/**
+ * @gallop/canon
+ *
+ * Gallop Enterprise Architecture Canon
+ * Versioned, AI-compatible, auditable web architecture patterns
+ */
+export interface Pattern {
+    id: string;
+    title: string;
+    file: string;
+    category: PatternCategory;
+    status: 'stable' | 'proposed' | 'deprecated';
+    enforcement: 'eslint' | 'documentation' | 'ci';
+    rule: string | null;
+    summary: string;
+}
+export interface Category {
+    id: string;
+    name: string;
+    description: string;
+}
+export interface Guarantee {
+    id: string;
+    name: string;
+    since: string;
+    status: 'stable' | 'proposed' | 'deprecated';
+    patterns: string[];
+}
+export type PatternCategory = 'rendering' | 'layout' | 'typography' | 'structure' | 'styling' | 'components' | 'seo';
+export interface CanonSchema {
+    name: string;
+    version: string;
+    description: string;
+    categories: Category[];
+    patterns: Pattern[];
+    guarantees: Guarantee[];
+}
+export declare const canon: CanonSchema;
+export declare const version: string;
+export declare const patterns: Pattern[];
+export declare const categories: Category[];
+export declare const guarantees: Guarantee[];
+/**
+ * Get a pattern by ID
+ * @param id - Pattern ID (e.g., "001", "002")
+ * @returns Pattern object or undefined if not found
+ */
+export declare function getPattern(id: string): Pattern | undefined;
+/**
+ * Get all patterns in a category
+ * @param category - Category ID (e.g., "rendering", "typography")
+ * @returns Array of patterns in that category
+ */
+export declare function getPatternsByCategory(category: PatternCategory): Pattern[];
+/**
+ * Get all patterns enforced by ESLint
+ * @returns Array of ESLint-enforced patterns
+ */
+export declare function getEnforcedPatterns(): Pattern[];
+/**
+ * Get all patterns with a specific ESLint rule
+ * @param rule - ESLint rule name (e.g., "gallop/no-client-blocks")
+ * @returns Array of patterns using that rule
+ */
+export declare function getPatternsByRule(rule: string): Pattern[];
+/**
+ * Get a guarantee by ID
+ * @param id - Guarantee ID (e.g., "SEO_STABLE")
+ * @returns Guarantee object or undefined if not found
+ */
+export declare function getGuarantee(id: string): Guarantee | undefined;
+/**
+ * Get all patterns associated with a guarantee
+ * @param guaranteeId - Guarantee ID (e.g., "SEO_STABLE")
+ * @returns Array of patterns that support this guarantee
+ */
+export declare function getPatternsForGuarantee(guaranteeId: string): Pattern[];
+/**
+ * Check if a pattern ID is valid
+ * @param id - Pattern ID to check
+ * @returns true if valid, false otherwise
+ */
+export declare function isValidPattern(id: string): boolean;
+/**
+ * Get pattern count by enforcement type
+ * @returns Object with counts per enforcement type
+ */
+export declare function getEnforcementStats(): Record<string, number>;
+declare const _default: {
+    version: string;
+    patterns: Pattern[];
+    categories: Category[];
+    guarantees: Guarantee[];
+    getPattern: typeof getPattern;
+    getPatternsByCategory: typeof getPatternsByCategory;
+    getEnforcedPatterns: typeof getEnforcedPatterns;
+    getPatternsByRule: typeof getPatternsByRule;
+    getGuarantee: typeof getGuarantee;
+    getPatternsForGuarantee: typeof getPatternsForGuarantee;
+    isValidPattern: typeof isValidPattern;
+    getEnforcementStats: typeof getEnforcementStats;
+};
+export default _default;

package/dist/index.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * @gallop/canon
+ *
+ * Gallop Enterprise Architecture Canon
+ * Versioned, AI-compatible, auditable web architecture patterns
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.guarantees = exports.categories = exports.patterns = exports.version = exports.canon = void 0;
+exports.getPattern = getPattern;
+exports.getPatternsByCategory = getPatternsByCategory;
+exports.getEnforcedPatterns = getEnforcedPatterns;
+exports.getPatternsByRule = getPatternsByRule;
+exports.getGuarantee = getGuarantee;
+exports.getPatternsForGuarantee = getPatternsForGuarantee;
+exports.isValidPattern = isValidPattern;
+exports.getEnforcementStats = getEnforcementStats;
+const schema_json_1 = __importDefault(require("../schema.json"));
+// Export the full schema
+exports.canon = schema_json_1.default;
+// Export version
+exports.version = schema_json_1.default.version;
+// Export patterns array
+exports.patterns = schema_json_1.default.patterns;
+// Export categories array
+exports.categories = schema_json_1.default.categories;
+// Export guarantees array
+exports.guarantees = schema_json_1.default.guarantees;
+/**
+ * Get a pattern by ID
+ * @param id - Pattern ID (e.g., "001", "002")
+ * @returns Pattern object or undefined if not found
+ */
+function getPattern(id) {
+    return exports.patterns.find((p) => p.id === id);
+}
+/**
+ * Get all patterns in a category
+ * @param category - Category ID (e.g., "rendering", "typography")
+ * @returns Array of patterns in that category
+ */
+function getPatternsByCategory(category) {
+    return exports.patterns.filter((p) => p.category === category);
+}
+/**
+ * Get all patterns enforced by ESLint
+ * @returns Array of ESLint-enforced patterns
+ */
+function getEnforcedPatterns() {
+    return exports.patterns.filter((p) => p.enforcement === 'eslint');
+}
+/**
+ * Get all patterns with a specific ESLint rule
+ * @param rule - ESLint rule name (e.g., "gallop/no-client-blocks")
+ * @returns Array of patterns using that rule
+ */
+function getPatternsByRule(rule) {
+    return exports.patterns.filter((p) => p.rule === rule);
+}
+/**
+ * Get a guarantee by ID
+ * @param id - Guarantee ID (e.g., "SEO_STABLE")
+ * @returns Guarantee object or undefined if not found
+ */
+function getGuarantee(id) {
+    return exports.guarantees.find((g) => g.id === id);
+}
+/**
+ * Get all patterns associated with a guarantee
+ * @param guaranteeId - Guarantee ID (e.g., "SEO_STABLE")
+ * @returns Array of patterns that support this guarantee
+ */
+function getPatternsForGuarantee(guaranteeId) {
+    const guarantee = getGuarantee(guaranteeId);
+    if (!guarantee)
+        return [];
+    return exports.patterns.filter((p) => guarantee.patterns.includes(p.id));
+}
+/**
+ * Check if a pattern ID is valid
+ * @param id - Pattern ID to check
+ * @returns true if valid, false otherwise
+ */
+function isValidPattern(id) {
+    return exports.patterns.some((p) => p.id === id);
+}
+/**
+ * Get pattern count by enforcement type
+ * @returns Object with counts per enforcement type
+ */
+function getEnforcementStats() {
+    const stats = {};
+    for (const pattern of exports.patterns) {
+        stats[pattern.enforcement] = (stats[pattern.enforcement] || 0) + 1;
+    }
+    return stats;
+}
+// Default export
+exports.default = {
+    version: exports.version,
+    patterns: exports.patterns,
+    categories: exports.categories,
+    guarantees: exports.guarantees,
+    getPattern,
+    getPatternsByCategory,
+    getEnforcedPatterns,
+    getPatternsByRule,
+    getGuarantee,
+    getPatternsForGuarantee,
+    isValidPattern,
+    getEnforcementStats,
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7OztHQUtHOzs7Ozs7QUFvRUgsZ0NBRUM7QUFPRCxzREFFQztBQU1ELGtEQUVDO0FBT0QsOENBRUM7QUFPRCxvQ0FFQztBQU9ELDBEQUlDO0FBT0Qsd0NBRUM7QUFNRCxrREFNQztBQXZJRCxpRUFBbUM7QUE4Q25DLHlCQUF5QjtBQUNaLFFBQUEsS0FBSyxHQUFnQixxQkFBcUIsQ0FBQTtBQUV2RCxpQkFBaUI7QUFDSixRQUFBLE9BQU8sR0FBRyxxQkFBTSxDQUFDLE9BQU8sQ0FBQTtBQUVyQyx3QkFBd0I7QUFDWCxRQUFBLFFBQVEsR0FBYyxxQkFBTSxDQUFDLFFBQXFCLENBQUE7QUFFL0QsMEJBQTBCO0FBQ2IsUUFBQSxVQUFVLEdBQWUscUJBQU0sQ0FBQyxVQUFVLENBQUE7QUFFdkQsMEJBQTBCO0FBQ2IsUUFBQSxVQUFVLEdBQWdCLHFCQUFNLENBQUMsVUFBeUIsQ0FBQTtBQUV2RTs7OztHQUlHO0FBQ0gsU0FBZ0IsVUFBVSxDQUFDLEVBQVU7SUFDbkMsT0FBTyxnQkFBUSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsS0FBSyxFQUFFLENBQUMsQ0FBQTtBQUMxQyxDQUFDO0FBRUQ7Ozs7R0FJRztBQUNILFNBQWdCLHFCQUFxQixDQUFDLFFBQXlCO0lBQzdELE9BQU8sZ0JBQVEsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxRQUFRLEtBQUssUUFBUSxDQUFDLENBQUE7QUFDeEQsQ0FBQztBQUVEOzs7R0FHRztBQUNILFNBQWdCLG1CQUFtQjtJQUNqQyxPQUFPLGdCQUFRLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsV0FBVyxLQUFLLFFBQVEsQ0FBQyxDQUFBO0FBQzNELENBQUM7QUFFRDs7OztHQUlHO0FBQ0gsU0FBZ0IsaUJBQWlCLENBQUMsSUFBWTtJQUM1QyxPQUFPLGdCQUFRLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsSUFBSSxLQUFLLElBQUksQ0FBQyxDQUFBO0FBQ2hELENBQUM7QUFFRDs7OztHQUlHO0FBQ0gsU0FBZ0IsWUFBWSxDQUFDLEVBQVU7SUFDckMsT0FBTyxrQkFBVSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsS0FBSyxFQUFFLENBQUMsQ0FBQTtBQUM1QyxDQUFDO0FBRUQ7Ozs7R0FJRztBQUNILFNBQWdCLHVCQUF1QixDQUFDLFdBQW1CO0lBQ3pELE1BQU0sU0FBUyxHQUFHLFlBQVksQ0FBQyxXQUFXLENBQUMsQ0FBQTtJQUMzQyxJQUFJLENBQUMsU0FBUztRQUFFLE9BQU8sRUFBRSxDQUFBO0lBQ3pCLE9BQU8sZ0JBQVEsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLFNBQVMsQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFBO0FBQ2xFLENBQUM7QUFFRDs7OztHQUlHO0FBQ0gsU0FBZ0IsY0FBYyxDQUFDLEVBQVU7SUFDdkMsT0FBTyxnQkFBUSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsS0FBSyxFQUFFLENBQUMsQ0FBQTtBQUMxQyxDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsU0FBZ0IsbUJBQW1CO0lBQ2pDLE1BQU0sS0FBSyxHQUEyQixFQUFFLENBQUE7SUFDeEMsS0FBSyxNQUFNLE9BQU8sSUFBSSxnQkFBUSxFQUFFLENBQUM7UUFDL0IsS0FBSyxDQUFDLE9BQU8sQ0FBQyxXQUFXLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsV0FBVyxDQUFDLElBQUksQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFBO0lBQ3BFLENBQUM7SUFDRCxPQUFPLEtBQUssQ0FBQTtBQUNkLENBQUM7QUFFRCxpQkFBaUI7QUFDakIsa0JBQWU7SUFDYixPQUFPLEVBQVAsZUFBTztJQUNQLFFBQVEsRUFBUixnQkFBUTtJQUNSLFVBQVUsRUFBVixrQkFBVTtJQUNWLFVBQVUsRUFBVixrQkFBVTtJQUNWLFVBQVU7SUFDVixxQkFBcUI7SUFDckIsbUJBQW1CO0lBQ25CLGlCQUFpQjtJQUNqQixZQUFZO0lBQ1osdUJBQXVCO0lBQ3ZCLGNBQWM7SUFDZCxtQkFBbUI7Q0FDcEIsQ0FBQSIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQGdhbGxvcC9jYW5vblxuICpcbiAqIEdhbGxvcCBFbnRlcnByaXNlIEFyY2hpdGVjdHVyZSBDYW5vblxuICogVmVyc2lvbmVkLCBBSS1jb21wYXRpYmxlLCBhdWRpdGFibGUgd2ViIGFyY2hpdGVjdHVyZSBwYXR0ZXJuc1xuICovXG5cbmltcG9ydCBzY2hlbWEgZnJvbSAnLi4vc2NoZW1hLmpzb24nXG5cbi8vIFR5cGVzXG5leHBvcnQgaW50ZXJmYWNlIFBhdHRlcm4ge1xuICBpZDogc3RyaW5nXG4gIHRpdGxlOiBzdHJpbmdcbiAgZmlsZTogc3RyaW5nXG4gIGNhdGVnb3J5OiBQYXR0ZXJuQ2F0ZWdvcnlcbiAgc3RhdHVzOiAnc3RhYmxlJyB8ICdwcm9wb3NlZCcgfCAnZGVwcmVjYXRlZCdcbiAgZW5mb3JjZW1lbnQ6ICdlc2xpbnQnIHwgJ2RvY3VtZW50YXRpb24nIHwgJ2NpJ1xuICBydWxlOiBzdHJpbmcgfCBudWxsXG4gIHN1bW1hcnk6IHN0cmluZ1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIENhdGVnb3J5IHtcbiAgaWQ6IHN0cmluZ1xuICBuYW1lOiBzdHJpbmdcbiAgZGVzY3JpcHRpb246IHN0cmluZ1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIEd1YXJhbnRlZSB7XG4gIGlkOiBzdHJpbmdcbiAgbmFtZTogc3RyaW5nXG4gIHNpbmNlOiBzdHJpbmdcbiAgc3RhdHVzOiAnc3RhYmxlJyB8ICdwcm9wb3NlZCcgfCAnZGVwcmVjYXRlZCdcbiAgcGF0dGVybnM6IHN0cmluZ1tdXG59XG5cbmV4cG9ydCB0eXBlIFBhdHRlcm5DYXRlZ29yeSA9XG4gIHwgJ3JlbmRlcmluZydcbiAgfCAnbGF5b3V0J1xuICB8ICd0eXBvZ3JhcGh5J1xuICB8ICdzdHJ1Y3R1cmUnXG4gIHwgJ3N0eWxpbmcnXG4gIHwgJ2NvbXBvbmVudHMnXG4gIHwgJ3NlbydcblxuZXhwb3J0IGludGVyZmFjZSBDYW5vblNjaGVtYSB7XG4gIG5hbWU6IHN0cmluZ1xuICB2ZXJzaW9uOiBzdHJpbmdcbiAgZGVzY3JpcHRpb246IHN0cmluZ1xuICBjYXRlZ29yaWVzOiBDYXRlZ29yeVtdXG4gIHBhdHRlcm5zOiBQYXR0ZXJuW11cbiAgZ3VhcmFudGVlczogR3VhcmFudGVlW11cbn1cblxuLy8gRXhwb3J0IHRoZSBmdWxsIHNjaGVtYVxuZXhwb3J0IGNvbnN0IGNhbm9uOiBDYW5vblNjaGVtYSA9IHNjaGVtYSBhcyBDYW5vblNjaGVtYVxuXG4vLyBFeHBvcnQgdmVyc2lvblxuZXhwb3J0IGNvbnN0IHZlcnNpb24gPSBzY2hlbWEudmVyc2lvblxuXG4vLyBFeHBvcnQgcGF0dGVybnMgYXJyYXlcbmV4cG9ydCBjb25zdCBwYXR0ZXJuczogUGF0dGVybltdID0gc2NoZW1hLnBhdHRlcm5zIGFzIFBhdHRlcm5bXVxuXG4vLyBFeHBvcnQgY2F0ZWdvcmllcyBhcnJheVxuZXhwb3J0IGNvbnN0IGNhdGVnb3JpZXM6IENhdGVnb3J5W10gPSBzY2hlbWEuY2F0ZWdvcmllc1xuXG4vLyBFeHBvcnQgZ3VhcmFudGVlcyBhcnJheVxuZXhwb3J0IGNvbnN0IGd1YXJhbnRlZXM6IEd1YXJhbnRlZVtdID0gc2NoZW1hLmd1YXJhbnRlZXMgYXMgR3VhcmFudGVlW11cblxuLyoqXG4gKiBHZXQgYSBwYXR0ZXJuIGJ5IElEXG4gKiBAcGFyYW0gaWQgLSBQYXR0ZXJuIElEIChlLmcuLCBcIjAwMVwiLCBcIjAwMlwiKVxuICogQHJldHVybnMgUGF0dGVybiBvYmplY3Qgb3IgdW5kZWZpbmVkIGlmIG5vdCBmb3VuZFxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0UGF0dGVybihpZDogc3RyaW5nKTogUGF0dGVybiB8IHVuZGVmaW5lZCB7XG4gIHJldHVybiBwYXR0ZXJucy5maW5kKChwKSA9PiBwLmlkID09PSBpZClcbn1cblxuLyoqXG4gKiBHZXQgYWxsIHBhdHRlcm5zIGluIGEgY2F0ZWdvcnlcbiAqIEBwYXJhbSBjYXRlZ29yeSAtIENhdGVnb3J5IElEIChlLmcuLCBcInJlbmRlcmluZ1wiLCBcInR5cG9ncmFwaHlcIilcbiAqIEByZXR1cm5zIEFycmF5IG9mIHBhdHRlcm5zIGluIHRoYXQgY2F0ZWdvcnlcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldFBhdHRlcm5zQnlDYXRlZ29yeShjYXRlZ29yeTogUGF0dGVybkNhdGVnb3J5KTogUGF0dGVybltdIHtcbiAgcmV0dXJuIHBhdHRlcm5zLmZpbHRlcigocCkgPT4gcC5jYXRlZ29yeSA9PT0gY2F0ZWdvcnkpXG59XG5cbi8qKlxuICogR2V0IGFsbCBwYXR0ZXJucyBlbmZvcmNlZCBieSBFU0xpbnRcbiAqIEByZXR1cm5zIEFycmF5IG9mIEVTTGludC1lbmZvcmNlZCBwYXR0ZXJuc1xuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0RW5mb3JjZWRQYXR0ZXJucygpOiBQYXR0ZXJuW10ge1xuICByZXR1cm4gcGF0dGVybnMuZmlsdGVyKChwKSA9PiBwLmVuZm9yY2VtZW50ID09PSAnZXNsaW50Jylcbn1cblxuLyoqXG4gKiBHZXQgYWxsIHBhdHRlcm5zIHdpdGggYSBzcGVjaWZpYyBFU0xpbnQgcnVsZVxuICogQHBhcmFtIHJ1bGUgLSBFU0xpbnQgcnVsZSBuYW1lIChlLmcuLCBcImdhbGxvcC9uby1jbGllbnQtYmxvY2tzXCIpXG4gKiBAcmV0dXJucyBBcnJheSBvZiBwYXR0ZXJucyB1c2luZyB0aGF0IHJ1bGVcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldFBhdHRlcm5zQnlSdWxlKHJ1bGU6IHN0cmluZyk6IFBhdHRlcm5bXSB7XG4gIHJldHVybiBwYXR0ZXJucy5maWx0ZXIoKHApID0+IHAucnVsZSA9PT0gcnVsZSlcbn1cblxuLyoqXG4gKiBHZXQgYSBndWFyYW50ZWUgYnkgSURcbiAqIEBwYXJhbSBpZCAtIEd1YXJhbnRlZSBJRCAoZS5nLiwgXCJTRU9fU1RBQkxFXCIpXG4gKiBAcmV0dXJucyBHdWFyYW50ZWUgb2JqZWN0IG9yIHVuZGVmaW5lZCBpZiBub3QgZm91bmRcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldEd1YXJhbnRlZShpZDogc3RyaW5nKTogR3VhcmFudGVlIHwgdW5kZWZpbmVkIHtcbiAgcmV0dXJuIGd1YXJhbnRlZXMuZmluZCgoZykgPT4gZy5pZCA9PT0gaWQpXG59XG5cbi8qKlxuICogR2V0IGFsbCBwYXR0ZXJucyBhc3NvY2lhdGVkIHdpdGggYSBndWFyYW50ZWVcbiAqIEBwYXJhbSBndWFyYW50ZWVJZCAtIEd1YXJhbnRlZSBJRCAoZS5nLiwgXCJTRU9fU1RBQkxFXCIpXG4gKiBAcmV0dXJucyBBcnJheSBvZiBwYXR0ZXJucyB0aGF0IHN1cHBvcnQgdGhpcyBndWFyYW50ZWVcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldFBhdHRlcm5zRm9yR3VhcmFudGVlKGd1YXJhbnRlZUlkOiBzdHJpbmcpOiBQYXR0ZXJuW10ge1xuICBjb25zdCBndWFyYW50ZWUgPSBnZXRHdWFyYW50ZWUoZ3VhcmFudGVlSWQpXG4gIGlmICghZ3VhcmFudGVlKSByZXR1cm4gW11cbiAgcmV0dXJuIHBhdHRlcm5zLmZpbHRlcigocCkgPT4gZ3VhcmFudGVlLnBhdHRlcm5zLmluY2x1ZGVzKHAuaWQpKVxufVxuXG4vKipcbiAqIENoZWNrIGlmIGEgcGF0dGVybiBJRCBpcyB2YWxpZFxuICogQHBhcmFtIGlkIC0gUGF0dGVybiBJRCB0byBjaGVja1xuICogQHJldHVybnMgdHJ1ZSBpZiB2YWxpZCwgZmFsc2Ugb3RoZXJ3aXNlXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc1ZhbGlkUGF0dGVybihpZDogc3RyaW5nKTogYm9vbGVhbiB7XG4gIHJldHVybiBwYXR0ZXJucy5zb21lKChwKSA9PiBwLmlkID09PSBpZClcbn1cblxuLyoqXG4gKiBHZXQgcGF0dGVybiBjb3VudCBieSBlbmZvcmNlbWVudCB0eXBlXG4gKiBAcmV0dXJucyBPYmplY3Qgd2l0aCBjb3VudHMgcGVyIGVuZm9yY2VtZW50IHR5cGVcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldEVuZm9yY2VtZW50U3RhdHMoKTogUmVjb3JkPHN0cmluZywgbnVtYmVyPiB7XG4gIGNvbnN0IHN0YXRzOiBSZWNvcmQ8c3RyaW5nLCBudW1iZXI+ID0ge31cbiAgZm9yIChjb25zdCBwYXR0ZXJuIG9mIHBhdHRlcm5zKSB7XG4gICAgc3RhdHNbcGF0dGVybi5lbmZvcmNlbWVudF0gPSAoc3RhdHNbcGF0dGVybi5lbmZvcmNlbWVudF0gfHwgMCkgKyAxXG4gIH1cbiAgcmV0dXJuIHN0YXRzXG59XG5cbi8vIERlZmF1bHQgZXhwb3J0XG5leHBvcnQgZGVmYXVsdCB7XG4gIHZlcnNpb24sXG4gIHBhdHRlcm5zLFxuICBjYXRlZ29yaWVzLFxuICBndWFyYW50ZWVzLFxuICBnZXRQYXR0ZXJuLFxuICBnZXRQYXR0ZXJuc0J5Q2F0ZWdvcnksXG4gIGdldEVuZm9yY2VkUGF0dGVybnMsXG4gIGdldFBhdHRlcm5zQnlSdWxlLFxuICBnZXRHdWFyYW50ZWUsXG4gIGdldFBhdHRlcm5zRm9yR3VhcmFudGVlLFxuICBpc1ZhbGlkUGF0dGVybixcbiAgZ2V0RW5mb3JjZW1lbnRTdGF0cyxcbn1cbiJdfQ==

package/guarantees.md

@@ -0,0 +1,136 @@
+# Gallop Canon v1.0 Guarantees
+
+These guarantees are promises made by Canon v1.0. They are versioned and immutable once released.
+
+## SEO Stability
+
+**Guarantee ID:** `SEO_STABLE`  
+**Since:** v1.0
+
+### Promise
+
+Applications built following Canon v1.0 patterns will not experience SEO regressions from architectural decisions.
+
+### What This Means
+
+- **Server-rendered by default** — All blocks render on the server, content is visible to crawlers
+- **No hydration mismatches** — Client/server boundaries are clearly defined
+- **Structured metadata** — All pages have complete OG, Twitter, and Schema.org data
+- **Canonical URLs** — Every page declares its canonical URL
+- **Crawlable content** — No content hidden behind client-only rendering
+
+### Patterns That Enforce This
+
+- [001 Server-First Blocks](./patterns/001-server-first-blocks.md)
+- [016 Client Extraction](./patterns/016-client-extraction.md)
+- [017 SEO Metadata](./patterns/017-seo-metadata.md)
+
+---
+
+## Performance Baseline
+
+**Guarantee ID:** `PERF_BASELINE`  
+**Since:** v1.0
+
+### Promise
+
+Applications built following Canon v1.0 patterns will have predictable, minimal client-side JavaScript in blocks.
+
+### What This Means
+
+- **Minimal client bundle** — Blocks don't add to client JavaScript
+- **No layout shift** — Typography and spacing are predictable
+- **Efficient hydration** — Only interactive components hydrate
+- **Tree-shakeable imports** — Unused code is eliminated
+
+### Patterns That Enforce This
+
+- [001 Server-First Blocks](./patterns/001-server-first-blocks.md)
+- [007 Import Paths](./patterns/007-import-paths.md)
+- [010 Spacing System](./patterns/010-spacing-system.md)
+- [016 Client Extraction](./patterns/016-client-extraction.md)
+
+---
+
+## Maintainability
+
+**Guarantee ID:** `MAINTAIN`  
+**Since:** v1.0
+
+### Promise
+
+Applications built following Canon v1.0 patterns will be maintainable by any developer familiar with the Canon.
+
+### What This Means
+
+- **Consistent file structure** — Blocks, components, and pages follow naming conventions
+- **Traceable component usage** — Components are imported from known locations
+- **Auditable styling** — Tailwind classes and component props are searchable
+- **Documented patterns** — Every decision is explained with rationale
+
+### Patterns That Enforce This
+
+- [005 Page Structure](./patterns/005-page-structure.md)
+- [006 Block Naming](./patterns/006-block-naming.md)
+- [007 Import Paths](./patterns/007-import-paths.md)
+- [004 Component Props](./patterns/004-component-props.md)
+- [013 New Component Pattern](./patterns/013-new-component-pattern.md)
+
+---
+
+## Design System Compliance
+
+**Guarantee ID:** `DESIGN_SYSTEM`  
+**Since:** v1.0
+
+### Promise
+
+Applications built following Canon v1.0 patterns will have consistent visual design through typography, spacing, and color systems.
+
+### What This Means
+
+- **Semantic typography** — Text uses Heading, Paragraph, Label components
+- **Consistent spacing** — Margins and paddings follow the spacing scale
+- **Semantic colors** — Colors use tokens, not raw values
+- **Responsive patterns** — Mobile-first breakpoints are standard
+
+### Patterns That Enforce This
+
+- [003 Typography Components](./patterns/003-typography-components.md)
+- [004 Component Props](./patterns/004-component-props.md)
+- [009 Color Tokens](./patterns/009-color-tokens.md)
+- [010 Spacing System](./patterns/010-spacing-system.md)
+- [011 Responsive Mobile-First](./patterns/011-responsive-mobile-first.md)
+
+---
+
+## Versioning Policy
+
+### Guarantee Lifecycle
+
+1. **Proposed** — Under consideration, may change
+2. **Stable** — Committed, won't change in this major version
+3. **Deprecated** — Will be removed in next major version
+4. **Removed** — No longer applies
+
+### Breaking Changes
+
+Guarantees are never removed or weakened within a major version. If a guarantee must change:
+
+1. It is deprecated in a minor release
+2. Migration guidance is provided
+3. It is removed in the next major release
+
+### Version Pinning
+
+Organizations can pin to a specific Canon version:
+
+```json
+{
+  "dependencies": {
+    "@gallop/canon": "1.0.0"
+  }
+}
+```
+
+Upgrades should be deliberate and tested.

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@gallop.software/canon",
+  "version": "1.0.0",
+  "description": "Gallop Enterprise Architecture Canon - Versioned, AI-compatible, auditable web architecture patterns",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "patterns",
+    "guarantees.md",
+    "schema.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "gallop",
+    "architecture",
+    "patterns",
+    "canon",
+    "nextjs",
+    "react",
+    "governance",
+    "ai-compatible"
+  ],
+  "author": {
+    "name": "Gallop",
+    "url": "https://gallop.software"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gallop-software/gallop",
+    "directory": "canon"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}

package/patterns/001-server-first-blocks.md

@@ -0,0 +1,84 @@
+# Pattern 001: Server-First Blocks
+
+**Canon Version:** 1.0  
+**Status:** Stable  
+**Category:** Rendering  
+**Enforcement:** ESLint
+
+## Decision
+
+Blocks in `src/blocks/` must be server components. They must not use the `'use client'` directive.
+
+## Rationale
+
+Server components provide significant benefits for web applications:
+
+1. **Smaller client bundle** — Server components don't add to JavaScript shipped to browsers
+2. **SEO-safe by default** — Content is rendered on the server, visible to crawlers
+3. **Predictable hydration** — No hydration mismatches when blocks are server-rendered
+4. **Faster initial load** — Less JavaScript to parse and execute
+
+Blocks are compositional units that should remain static and SEO-friendly. Interactive behavior belongs in components, not blocks.
+
+## Examples
+
+### Bad
+
+```tsx
+// src/blocks/hero-1.tsx
+'use client'
+import { useState } from 'react'
+
+export default function Hero1() {
+  const [isOpen, setIsOpen] = useState(false)
+  // ...
+}
+```
+
+### Good
+
+```tsx
+// src/blocks/hero-1.tsx (server component)
+import { InteractiveFeature } from '@/components/interactive-feature'
+
+export default function Hero1() {
+  return (
+    <Section>
+      <Heading>Welcome</Heading>
+      <InteractiveFeature /> {/* Client logic extracted */}
+    </Section>
+  )
+}
+```
+
+```tsx
+// src/components/interactive-feature.tsx
+'use client'
+import { useState } from 'react'
+
+export function InteractiveFeature() {
+  const [isOpen, setIsOpen] = useState(false)
+  // Client-side logic lives here
+}
+```
+
+## Enforcement
+
+- **ESLint rule:** `gallop/no-client-blocks`
+- **Severity:** Warning (upgradeable to error)
+
+## Escape Hatch
+
+If a block absolutely requires client-side logic that cannot be extracted:
+
+1. Document why extraction is impossible
+2. Consider if it should be a component instead of a block
+3. Use `// eslint-disable-next-line gallop/no-client-blocks` with a comment explaining why
+
+This should be extremely rare. Most "exceptions" indicate a design issue.
+
+## References
+
+- `src/blocks/hero-1.tsx` — Server block with extracted video player
+- `src/blocks/hero-16.tsx` — Server block with extracted animation init
+- `src/components/gallery-popup.tsx` — Client component extracted from block

package/patterns/002-layout-hierarchy.md

@@ -0,0 +1,84 @@
+# Pattern 002: Layout Hierarchy
+
+**Canon Version:** 1.0  
+**Status:** Stable  
+**Category:** Layout  
+**Enforcement:** ESLint
+
+## Decision
+
+Do not use `Container` inside `Section`. The `Section` component already handles containment.
+
+## Rationale
+
+1. **Redundant nesting** — `Section` already provides max-width and padding
+2. **Consistent spacing** — Avoids double-padding issues
+3. **Simpler DOM** — Fewer wrapper elements
+4. **Predictable layout** — One component handles section layout
+
+The layout hierarchy should be:
+```
+Section → Columns → Column → Content
+```
+
+Not:
+```
+Section → Container → Columns → Column → Content
+```
+
+## Examples
+
+### Bad
+
+```tsx
+<Section>
+  <Container>
+    <Heading>Title</Heading>
+    <Paragraph>Content here</Paragraph>
+  </Container>
+</Section>
+```
+
+### Good
+
+```tsx
+<Section>
+  <Heading>Title</Heading>
+  <Paragraph>Content here</Paragraph>
+</Section>
+```
+
+```tsx
+<Section innerAlign="content">
+  <Heading>Title</Heading>
+  <Paragraph>Content here</Paragraph>
+</Section>
+```
+
+If you need custom max-width, use a plain `div`:
+
+```tsx
+<Section>
+  <div className="max-w-4xl">
+    <Heading>Title</Heading>
+    <Paragraph>Content here</Paragraph>
+  </div>
+</Section>
+```
+
+## Enforcement
+
+- **ESLint rule:** `gallop/no-container-in-section`
+- **Severity:** Warning
+
+## Escape Hatch
+
+If you need nested containment for a specific design:
+
+1. Use a plain `div` with Tailwind classes instead of `Container`
+2. Document why the nested structure is necessary
+
+## References
+
+- `src/components/section.tsx` — Section component with built-in containment
+- `src/blocks/section-35.tsx` — Example using div for custom max-width