npm - @tidyfactor/design - Versions diffs - 1.5.0 - Mend

@tidyfactor/design 1.5.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.

Files changed (136) hide show

package/.tidyfactor +52 -0
package/AGENTS.md +75 -0
package/CHANGELOG.md +210 -0
package/LICENSE +17 -0
package/README.ar.md +398 -0
package/README.de.md +44 -0
package/README.es.md +44 -0
package/README.fa.md +44 -0
package/README.fr.md +44 -0
package/README.md +418 -0
package/README.pt.md +44 -0
package/README.zh.md +44 -0
package/SKILL-REGISTRY.md +69 -0
package/SKILL.md +46 -0
package/VISION.md +43 -0
package/assets/blog.png +0 -0
package/assets/content_layout.png +0 -0
package/assets/content_output.png +0 -0
package/assets/dark.png +0 -0
package/assets/dashboard_layout.png +0 -0
package/assets/dashboard_output.png +0 -0
package/assets/ecommerce_layout.png +0 -0
package/assets/ecommerce_output.png +0 -0
package/assets/github-social-preview-2.png +0 -0
package/assets/github-social-preview.png +0 -0
package/assets/hero-banner.png +0 -0
package/assets/light.png +0 -0
package/assets/media_layout.png +0 -0
package/assets/media_output.png +0 -0
package/assets/og-default.png +0 -0
package/assets/video.png +0 -0
package/bin/add-skill.js +31 -0
package/bin/create-kit.js +372 -0
package/bin/remove-skill.js +137 -0
package/brand.json +279 -0
package/memory/01-design-schools.md +85 -0
package/memory/02-design-tokens.md +41 -0
package/memory/03-narrative-conversion.md +47 -0
package/memory/04-motion-principles.md +44 -0
package/memory/05-component-anatomy.md +34 -0
package/memory/06-quality-bar.md +83 -0
package/memory/07-consistency-contract.md +33 -0
package/memory/08-arabic-bilingual.md +54 -0
package/memory/09-prototype-flow.md +36 -0
package/memory/10-python-tooling.md +64 -0
package/memory/11-brand-json-v2.md +86 -0
package/memory/12-typography-matrix.md +31 -0
package/memory/13-layout-archetypes.md +30 -0
package/memory/14-nav-footer-catalog.md +26 -0
package/memory/15-performance-budget.md +18 -0
package/memory/16-design-movements-guide.md +1084 -0
package/memory/17-storytelling-industries-ux.md +143 -0
package/memory/18-design-decision-engine.md +81 -0
package/package.json +64 -0
package/references/commands/_template.md +27 -0
package/references/commands/assets.md +35 -0
package/references/commands/audit.md +15 -0
package/references/commands/brand.md +85 -0
package/references/commands/brief.md +107 -0
package/references/commands/clone.md +26 -0
package/references/commands/components.md +46 -0
package/references/commands/dashboard.md +45 -0
package/references/commands/deploy.md +45 -0
package/references/commands/flow.md +44 -0
package/references/commands/handoff.md +53 -0
package/references/commands/i18n.md +64 -0
package/references/commands/init.md +30 -0
package/references/commands/layout.md +81 -0
package/references/commands/motion.md +62 -0
package/references/commands/nav-footer.md +54 -0
package/references/commands/page.md +45 -0
package/references/commands/palette.md +35 -0
package/references/commands/perf.md +57 -0
package/references/commands/retrofit.md +15 -0
package/references/commands/school.md +41 -0
package/references/commands/states.md +48 -0
package/references/commands/study.md +98 -0
package/references/commands/tokens.md +45 -0
package/references/commands/typography.md +87 -0
package/references/foundations/daisyui.md +44 -0
package/references/foundations/hybrid.md +32 -0
package/references/foundations/native.md +31 -0
package/references/foundations/tailwind-utility.md +43 -0
package/references/memory/01-design-schools.md +85 -0
package/references/memory/02-design-tokens.md +41 -0
package/references/memory/03-narrative-conversion.md +47 -0
package/references/memory/04-motion-principles.md +44 -0
package/references/memory/05-component-anatomy.md +34 -0
package/references/memory/06-quality-bar.md +83 -0
package/references/memory/07-consistency-contract.md +33 -0
package/references/memory/08-arabic-bilingual.md +54 -0
package/references/memory/09-prototype-flow.md +36 -0
package/references/memory/10-python-tooling.md +64 -0
package/references/memory/11-brand-json-v2.md +86 -0
package/references/memory/12-typography-matrix.md +31 -0
package/references/memory/13-layout-archetypes.md +30 -0
package/references/memory/14-nav-footer-catalog.md +26 -0
package/references/memory/15-performance-budget.md +18 -0
package/references/memory/16-design-movements-guide.md +1084 -0
package/references/memory/17-storytelling-industries-ux.md +143 -0
package/references/memory/18-design-decision-engine.md +81 -0
package/references/memory/architecture.md +39 -0
package/references/memory/decision-points.md +50 -0
package/references/memory/foundations.md +15 -0
package/references/memory/quality-bar.md +20 -0
package/references/tidyfactor-vision.md +66 -0
package/references/workflow.md +49 -0
package/references/workflows/audit-prototype.md +26 -0
package/references/workflows/brief.md +30 -0
package/references/workflows/clone-prototype.md +27 -0
package/references/workflows/init-prototype.md +28 -0
package/references/workflows/retrofit-prototype.md +25 -0
package/scripts/__pycache__/_utils.cpython-312.pyc +0 -0
package/scripts/_utils.py +60 -0
package/scripts/build.py +194 -0
package/scripts/check_alpha.py +52 -0
package/scripts/extract_palette.py +139 -0
package/scripts/generate_transitions.py +105 -0
package/scripts/inspect_images.py +48 -0
package/scripts/minify_assets.py +140 -0
package/scripts/optimize_assets.py +91 -0
package/scripts/optimize_images.py +176 -0
package/scripts/prepare_images.py +67 -0
package/scripts/remove_backgrounds.py +61 -0
package/scripts/test_build.py +228 -0
package/templates/design-system/base.css +75 -0
package/templates/design-system/components.css +229 -0
package/templates/design-system/interactions.js +31 -0
package/templates/design-system/motion.js +42 -0
package/templates/design-system/tokens.css +81 -0
package/templates/design-system/utilities.css +47 -0
package/templates/index.html +84 -0
package/templates/proto-nav.js +56 -0
package/tools/build-skill.js +126 -0
package/tools/validate-skill.js +144 -0
package/tools/validate_skill.py +121 -0

package/templates/design-system/utilities.css ADDED Viewed

@@ -0,0 +1,47 @@
+/* ==========================================================================
+   TidyFactor Design System — Utility Classes (utilities.css)
+   Layout helpers, spatial utilities, text balance, & accessibility masks
+   ========================================================================== */
+.text-center { text-align: center; }
+.text-left { text-align: left; }
+.text-right { text-align: right; }
+.text-balance { text-wrap: balance; }
+.text-muted { color: var(--color-text-muted); }
+.text-primary { color: var(--color-primary); }
+.flex-center {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+.flex-between {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+.gap-2 { gap: var(--space-2); }
+.gap-4 { gap: var(--space-4); }
+.gap-6 { gap: var(--space-6); }
+.mt-4 { margin-top: var(--space-4); }
+.mt-8 { margin-top: var(--space-8); }
+.mt-12 { margin-top: var(--space-12); }
+.mb-4 { margin-bottom: var(--space-4); }
+.mb-8 { margin-bottom: var(--space-8); }
+.sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border-width: 0;
+}

package/templates/index.html ADDED Viewed

@@ -0,0 +1,84 @@
+<!doctype html>
+<html lang="en" dir="ltr" data-theme="light">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>TidyFactor Prototype Starter</title>
+  <meta name="description" content="Interactive prototype scaffold built with TidyFactor Design System" />
+  <!-- Google Fonts: El Messiri & Tajawal -->
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=El+Messiri:wght@600;700&family=Tajawal:wght@400;500;700&display=swap" rel="stylesheet">
+  <!-- Production Design System Files (Zero Inline Overrides) -->
+  <link rel="stylesheet" href="design-system/tokens.css" />
+  <link rel="stylesheet" href="design-system/base.css" />
+  <link rel="stylesheet" href="design-system/components.css" />
+  <link rel="stylesheet" href="design-system/utilities.css" />
+</head>
+<body>
+  <!-- Floating Sticky Header Navbar -->
+  <div class="container mt-4">
+    <nav class="navbar">
+      <a href="#" class="badge">🎨 TidyFactor Design</a>
+      <ul class="nav-links">
+        <li><a href="#features" class="nav-link active">Features</a></li>
+        <li><a href="#bento" class="nav-link">Bento Cards</a></li>
+        <li><a href="#about" class="nav-link">Governance</a></li>
+      </ul>
+      <div style="display: flex; gap: var(--space-2);">
+        <button class="btn btn-secondary" data-theme-toggle>🌓 Theme</button>
+        <button class="btn btn-primary" data-dir-toggle>🌐 RTL / LTR</button>
+      </div>
+    </nav>
+  </div>
+  <main class="container">
+    <!-- Hero Section -->
+    <section class="hero" data-reveal>
+      <span class="badge mb-4">🚀 Interactive Prototype Ready</span>
+      <h1 class="hero-title text-balance">Code-Native UI Design Engine</h1>
+      <p class="hero-subtitle text-balance">
+        Zero-bundler interactive prototype scaffolded with pluggable CSS foundations and 24 Slash Commands lifecycle skill suite.
+      </p>
+      <div class="flex-center gap-4">
+        <a href="#bento" class="btn btn-primary">Explore Bento Grid</a>
+        <a href="https://github.com/alwkala/tidyfactor-design" target="_blank" class="btn btn-outline">GitHub Repository</a>
+      </div>
+    </section>
+    <!-- Bento Grid Component Section -->
+    <section id="bento" class="mb-8" data-reveal>
+      <h2 class="text-center mb-8">Design System Foundations</h2>
+      <div class="bento-grid">
+        <div class="bento-tile">
+          <span class="badge mb-4">Foundation 1</span>
+          <h3>Pluggable CSS Systems</h3>
+          <p class="text-muted mt-4">Switch seamlessly between Native CSS, Tailwind, daisyUI, shadcn/ui, Pico, and Bootstrap without structural breaks.</p>
+        </div>
+        <div class="bento-tile">
+          <span class="badge mb-4">Foundation 2</span>
+          <h3>Design Decision Engine</h3>
+          <p class="text-muted mt-4">9-step decision tree protocol with YAML confidence matrices, compatibility rules, and Anti-Design-Soup enforcement.</p>
+        </div>
+        <div class="bento-tile">
+          <span class="badge mb-4">Foundation 3</span>
+          <h3>20 Visual Movements</h3>
+          <p class="text-muted mt-4">Complete executable signature specs for Swiss, Neo-Brutalism, Glassmorphism, Bento UI, Cyberpunk, and Material.</p>
+        </div>
+      </div>
+    </section>
+  </main>
+  <footer class="container text-center text-muted mb-8" style="padding-top: var(--space-8); border-top: 1px solid var(--border);">
+    <p>© 2026 TidyFactor Ecosystem • Built with @tidyfactor/design</p>
+  </footer>
+  <!-- Shared Scripts & Developer Prototype Toolbar -->
+  <script src="design-system/motion.js"></script>
+  <script src="design-system/interactions.js"></script>
+  <script src="proto-nav.js"></script>
+</body>
+</html>

package/templates/proto-nav.js ADDED Viewed

@@ -0,0 +1,56 @@
+/**
+ * TidyFactor Design — Prototype Toolbar (dev-only)
+ * Floating dev toolbar for page switching, state toggles, and theme inspection.
+ */
+(function () {
+  const PAGES = [
+    { label: '📄 Landing (index.html)', href: 'index.html' }
+  ];
+  function buildToolbar() {
+    if (document.querySelector('[data-proto-toolbar]')) return;
+    const bar = document.createElement('div');
+    bar.setAttribute('data-proto-toolbar', '');
+    bar.style.cssText = [
+      'position:fixed', 'bottom:16px', 'right:16px', 'z-index:99999',
+      'display:flex', 'gap:8px', 'padding:8px 14px',
+      'background:rgba(15,23,42,0.9)', 'backdrop-filter:blur(12px)',
+      'border-radius:9999px', 'font:12px/1.4 system-ui, sans-serif',
+      'color:#F8FAFC', 'align-items:center', 'border:1px solid rgba(255,255,255,0.2)',
+      'box-shadow:0 10px 25px rgba(0,0,0,0.3)'
+    ].join(';');
+    const badge = document.createElement('span');
+    badge.textContent = '🎨 TF Design';
+    badge.style.cssText = 'font-weight:700;color:#818CF8;';
+    bar.appendChild(badge);
+    const select = document.createElement('select');
+    select.style.cssText = 'background:transparent;color:#fff;border:none;font:inherit;outline:none;cursor:pointer;';
+    PAGES.forEach((p) => {
+      const opt = document.createElement('option');
+      opt.value = p.href;
+      opt.textContent = p.label;
+      opt.style.background = '#0F172A';
+      select.appendChild(opt);
+    });
+    select.addEventListener('change', (e) => {
+      if (e.target.value) window.location.href = e.target.value;
+    });
+    bar.appendChild(select);
+    document.body.appendChild(bar);
+  }
+  function getStateParam() {
+    return new URLSearchParams(window.location.search).get('state') || 'default';
+  }
+  window.protoNav = { getStateParam };
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', buildToolbar);
+  } else {
+    buildToolbar();
+  }
+})();

package/tools/build-skill.js ADDED Viewed

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+/**
+ * tools/build-skill.js — TidyFactor Design Build & Packaging Tool
+ */
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const SKILL_NAME = 'tidyfactor-design';
+const REPO_ROOT = path.resolve(__dirname, '..');
+const DIST_DIR = path.join(REPO_ROOT, 'dist');
+const STAGING_DIR = path.join(DIST_DIR, SKILL_NAME);
+const SKILLS_LAB_ROOT = path.resolve(REPO_ROOT, '..');
+const HOME = process.env.USERPROFILE || process.env.HOME;
+const GLOBAL_CONFIG_SKILL = path.join(HOME, '.gemini', 'config', 'skills', SKILL_NAME);
+const LOCAL_AGENT_SKILL = path.join(SKILLS_LAB_ROOT, '.agents', 'skills', SKILL_NAME);
+function log(msg) {
+  console.log(`[build-skill] ${msg}`);
+}
+function runValidation() {
+  log('running release validation checks...');
+  const pythonCmd = process.platform === 'win32' ? 'python' : 'python3';
+  execSync(`${pythonCmd} "${path.join(__dirname, 'validate_skill.py')}"`, { stdio: 'inherit' });
+}
+function copyRecursive(src, dest) {
+  if (!fs.existsSync(src)) return;
+  const stat = fs.statSync(src);
+  if (stat.isDirectory()) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const item of fs.readdirSync(src)) {
+      if (['node_modules', '.git', 'dist', '.agents'].includes(item)) continue;
+      copyRecursive(path.join(src, item), path.join(dest, item));
+    }
+  } else {
+    fs.copyFileSync(src, dest);
+  }
+}
+function zipDirectory(sourceDir, outZip) {
+  const pythonCmd = process.platform === 'win32' ? 'python' : 'python3';
+  const pyScript = `import shutil, os; shutil.make_archive(r'''${outZip.replace(/\\/g, '/').replace(/\.skill$/, '')}''', 'zip', r'''${sourceDir.replace(/\\/g, '/')}''')`;
+  execSync(`${pythonCmd} -c "${pyScript}"`);
+  const generatedZip = outZip.replace(/\.skill$/, '.zip');
+  if (generatedZip !== outZip) {
+    if (fs.existsSync(outZip)) fs.unlinkSync(outZip);
+    fs.renameSync(generatedZip, outZip);
+  }
+}
+function build() {
+  log(`repo root: ${REPO_ROOT}`);
+  runValidation();
+  log('cleaning previous build...');
+  if (fs.existsSync(DIST_DIR)) {
+    fs.rmSync(DIST_DIR, { recursive: true, force: true });
+  }
+  fs.mkdirSync(STAGING_DIR, { recursive: true });
+  const pkg = JSON.parse(fs.readFileSync(path.join(REPO_ROOT, 'package.json'), 'utf-8'));
+  const version = pkg.version;
+  log('staging single-source-of-truth files from repo root...');
+  const whitelist = [
+    'SKILL.md',
+    'references',
+    'memory',
+    'templates',
+    'scripts',
+    'tools',
+    'assets',
+    'bin',
+    'brand.json',
+    '.tidyfactor',
+    'package.json',
+    'AGENTS.md',
+    'README.md',
+    'README.ar.md',
+    'LICENSE',
+    'CHANGELOG.md'
+  ];
+  for (const item of whitelist) {
+    const srcPath = path.join(REPO_ROOT, item);
+    if (fs.existsSync(srcPath)) {
+      log(`  + ${item}`);
+      copyRecursive(srcPath, path.join(STAGING_DIR, item));
+    }
+  }
+  log('zipping skill archive...');
+  const archiveName = `${SKILL_NAME}.skill`;
+  const versionedArchiveName = `${SKILL_NAME}-v${version}.skill`;
+  const archivePath = path.join(DIST_DIR, archiveName);
+  const versionedArchivePath = path.join(DIST_DIR, versionedArchiveName);
+  zipDirectory(STAGING_DIR, archivePath);
+  fs.copyFileSync(archivePath, versionedArchivePath);
+  const stats = fs.statSync(archivePath);
+  log(`done → dist\\${archiveName} (${(stats.size / 1024).toFixed(1)} KB)`);
+  log(`✓ Created versioned archive → dist\\${versionedArchiveName}`);
+  // Copy to Skills-LAB root
+  fs.copyFileSync(archivePath, path.join(SKILLS_LAB_ROOT, archiveName));
+  fs.copyFileSync(versionedArchivePath, path.join(SKILLS_LAB_ROOT, versionedArchiveName));
+  log(`✓ Updated Skills-LAB root archives → ${archiveName} & ${versionedArchiveName}`);
+  // Cross-agent synchronization
+  const targets = [LOCAL_AGENT_SKILL, GLOBAL_CONFIG_SKILL];
+  for (const target of targets) {
+    log(`synchronizing to target location: ${target}`);
+    if (fs.existsSync(target)) {
+      fs.rmSync(target, { recursive: true, force: true });
+    }
+    copyRecursive(STAGING_DIR, target);
+  }
+  log('✓ Completed cross-agent synchronization across all target locations.');
+}
+build();

package/tools/validate-skill.js ADDED Viewed

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+/**
+ * validate-skill.js — Validates TidyFactor Design skill structure, frontmatter,
+ * command specifications, memory files, and parity between .agents, .claude-skill, and root wrappers.
+ */
+const fs = require('fs');
+const path = require('path');
+const ROOT = path.resolve(__dirname, '..');
+const AGENTS_SKILL_DIR = path.join(ROOT, '.agents', 'skills', 'tidyfactor-design');
+const CLAUDE_SKILL_DIR = path.join(ROOT, '.claude-skill');
+const REQUIRED_COMMANDS = [
+  'study', 'brief', 'init', 'brand', 'typography', 'school', 'tokens', 'palette',
+  'assets', 'layout', 'nav-footer', 'components', 'page', 'dashboard', 'motion',
+  'states', 'flow', 'i18n', 'perf', 'audit', 'clone', 'retrofit', 'handoff', 'deploy'
+];
+const autoSync = process.argv.includes('--sync') || process.argv.includes('--fix');
+let errors = [];
+let warnings = [];
+function log(msg) {
+  console.log(`[validate-skill] ${msg}`);
+}
+function checkFrontmatter(filePath) {
+  if (!fs.existsSync(filePath)) {
+    errors.push(`Missing SKILL.md file: ${path.relative(ROOT, filePath)}`);
+    return;
+  }
+  const content = fs.readFileSync(filePath, 'utf8');
+  if (!content.startsWith('---')) {
+    errors.push(`SKILL.md frontmatter must start with '---': ${path.relative(ROOT, filePath)}`);
+    return;
+  }
+  const parts = content.split('---');
+  if (parts.length < 3) {
+    errors.push(`Invalid frontmatter format in: ${path.relative(ROOT, filePath)}`);
+    return;
+  }
+  const yaml = parts[1];
+  if (!yaml.includes('name:') || !yaml.includes('description:')) {
+    errors.push(`Frontmatter missing required 'name' or 'description': ${path.relative(ROOT, filePath)}`);
+  } else {
+    log(`✓ Frontmatter valid for ${path.relative(ROOT, filePath)}`);
+  }
+}
+function checkCommandsAndParity() {
+  const agentsCmdDir = path.join(AGENTS_SKILL_DIR, 'references', 'commands');
+  const claudeCmdDir = path.join(CLAUDE_SKILL_DIR, 'references', 'commands');
+  const rootCmdDir = path.join(ROOT, 'references', 'commands');
+  // Sync root SKILL.md and .claude-skill SKILL.md from .agents/skills/tidyfactor-design/SKILL.md if --sync
+  const canonicalSkillMd = path.join(AGENTS_SKILL_DIR, 'SKILL.md');
+  if (fs.existsSync(canonicalSkillMd)) {
+    const canonicalContent = fs.readFileSync(canonicalSkillMd, 'utf8');
+    const rootSkillMd = path.join(ROOT, 'SKILL.md');
+    const claudeSkillMd = path.join(CLAUDE_SKILL_DIR, 'SKILL.md');
+    if (autoSync) {
+      fs.writeFileSync(rootSkillMd, canonicalContent, 'utf8');
+      fs.writeFileSync(claudeSkillMd, canonicalContent, 'utf8');
+      log(`⚡ Auto-synced SKILL.md to root and .claude-skill`);
+    }
+  }
+  for (const cmd of REQUIRED_COMMANDS) {
+    const agentsFile = path.join(agentsCmdDir, `${cmd}.md`);
+    const claudeFile = path.join(claudeCmdDir, `${cmd}.md`);
+    const rootFile = path.join(rootCmdDir, `${cmd}.md`);
+    if (!fs.existsSync(agentsFile)) {
+      errors.push(`Missing Antigravity command spec for '${cmd}': ${path.relative(ROOT, agentsFile)}`);
+      continue;
+    }
+    if (autoSync) {
+      fs.mkdirSync(path.dirname(claudeFile), { recursive: true });
+      fs.mkdirSync(path.dirname(rootFile), { recursive: true });
+      fs.copyFileSync(agentsFile, claudeFile);
+      fs.copyFileSync(agentsFile, rootFile);
+      log(`⚡ Auto-synced '${cmd}.md' across wrappers`);
+    } else {
+      if (!fs.existsSync(claudeFile)) errors.push(`Missing Claude command spec for '${cmd}'`);
+      if (!fs.existsSync(rootFile)) errors.push(`Missing root command spec for '${cmd}'`);
+    }
+  }
+  log(`✓ All ${REQUIRED_COMMANDS.length} command specs verified with parity check across targets`);
+}
+function checkDirectory(dirName, label) {
+  const targetDir = path.join(ROOT, dirName);
+  if (!fs.existsSync(targetDir)) {
+    errors.push(`Missing required directory: ${dirName}`);
+  } else {
+    log(`✓ Directory verified: ${label}`);
+  }
+}
+function checkMemoryFiles() {
+  const memoryDir = path.join(ROOT, 'memory');
+  if (!fs.existsSync(memoryDir)) return;
+  const files = fs.readdirSync(memoryDir).filter(f => f.endsWith('.md'));
+  log(`✓ Verified ${files.length} memory reference files in memory/`);
+}
+function main() {
+  log('Starting skill validation check...');
+  checkFrontmatter(path.join(AGENTS_SKILL_DIR, 'SKILL.md'));
+  checkFrontmatter(path.join(CLAUDE_SKILL_DIR, 'SKILL.md'));
+  checkFrontmatter(path.join(ROOT, 'SKILL.md'));
+  checkCommandsAndParity();
+  checkDirectory('memory', 'memory');
+  checkMemoryFiles();
+  checkDirectory('templates', 'templates/layouts');
+  const agentsMd = path.join(ROOT, 'AGENTS.md');
+  if (!fs.existsSync(agentsMd)) {
+    errors.push('Missing root AGENTS.md');
+  } else {
+    log('✓ Root AGENTS.md verified');
+  }
+  if (warnings.length > 0) {
+    console.warn('\n⚠ Validation warnings:');
+    warnings.forEach(w => console.warn(`  ${w}`));
+  }
+  if (errors.length > 0) {
+    console.error('\n✖ Validation failed with errors:');
+    errors.forEach(e => console.error(`  ❌ ${e}`));
+    process.exit(1);
+  }
+  log('✨ All skill validation checks passed successfully!\n');
+}
+main();

package/tools/validate_skill.py ADDED Viewed

@@ -0,0 +1,121 @@
+#!/usr/bin/env python3
+"""
+validate_skill.py — TidyFactor Design Release & Integrity Validator.
+Checks:
+1. SemVer synchronization across package.json, .tidyfactor, brand.json, CHANGELOG.md.
+2. License consistency (Apache-2.0).
+3. Existence of all files referenced in SKILL.md.
+4. Validation checklists in all workflow files.
+5. Absence of machine-specific absolute paths.
+"""
+import sys
+import os
+import json
+import re
+from pathlib import Path
+# Ensure UTF-8 output on Windows terminal
+if sys.platform == "win32":
+    sys.stdout.reconfigure(encoding="utf-8")
+    sys.stderr.reconfigure(encoding="utf-8")
+def main():
+    root = Path(__file__).resolve().parent.parent
+    errors = []
+    print("=" * 60)
+    print("  RUNNING TIDYFACTOR DESIGN RELEASE VALIDATION")
+    print("=" * 60)
+    # 1. SemVer Synchronization Check
+    print("\n[1] Checking SemVer synchronization across metadata...")
+    pkg_file = root / "package.json"
+    tf_file = root / ".tidyfactor"
+    brand_file = root / "brand.json"
+    cl_file = root / "CHANGELOG.md"
+    pkg_ver = json.loads(pkg_file.read_text(encoding="utf-8")).get("version") if pkg_file.exists() else None
+    tf_ver = json.loads(tf_file.read_text(encoding="utf-8")).get("version") if tf_file.exists() else None
+    brand_data = json.loads(brand_file.read_text(encoding="utf-8")) if brand_file.exists() else {}
+    brand_ver = brand_data.get("version") or brand_data.get("meta", {}).get("version")
+    print(f"  package.json : {pkg_ver}")
+    print(f"  .tidyfactor  : {tf_ver}")
+    print(f"  brand.json   : {brand_ver}")
+    if not (pkg_ver and tf_ver and brand_ver and pkg_ver == tf_ver == brand_ver):
+        errors.append(f"Version mismatch: package.json({pkg_ver}) vs .tidyfactor({tf_ver}) vs brand.json({brand_ver})")
+    else:
+        print(f"  [OK] Version {pkg_ver} synchronized across all JSON metadata.")
+    if cl_file.exists():
+        cl_text = cl_file.read_text(encoding="utf-8")
+        if f"## [{pkg_ver}]" not in cl_text and f"[{pkg_ver}]" not in cl_text:
+            errors.append(f"CHANGELOG.md is missing release entry for version [{pkg_ver}].")
+        else:
+            print(f"  [OK] CHANGELOG.md contains release entry for [{pkg_ver}].")
+    else:
+        errors.append("Missing CHANGELOG.md.")
+    # 2. License check
+    print("\n[2] Checking license consistency...")
+    license_file = root / "LICENSE"
+    if license_file.exists():
+        print("  [OK] LICENSE file exists (Apache-2.0).")
+    else:
+        errors.append("Missing LICENSE file.")
+    # 3. Check referenced files in SKILL.md
+    print("\n[3] Checking SKILL.md referenced files exist on disk...")
+    skill_md = root / "SKILL.md"
+    if skill_md.exists():
+        content = skill_md.read_text(encoding="utf-8")
+        refs = re.findall(r'(?:references|memory|commands|workflows)/[a-zA-Z0-9_\-\./]+(?:\.md|\.json)?', content)
+        for ref in sorted(set(refs)):
+            target = root / ref
+            if not target.exists() and not (root / "references" / ref).exists():
+                if not (root / ref).is_dir() and not (root / "references" / ref).is_dir():
+                    errors.append(f"SKILL.md references non-existent file: {ref}")
+            else:
+                print(f"  [OK] Found {ref}")
+    else:
+        errors.append("Missing SKILL.md.")
+    # 4. Check workflow validation checklists
+    print("\n[4] Checking workflow checklists...")
+    wf_dir = root / "references" / "workflows"
+    if wf_dir.exists():
+        for wf in wf_dir.glob("*.md"):
+            txt = wf.read_text(encoding="utf-8").lower()
+            if "validation checklist" not in txt:
+                errors.append(f"Workflow {wf.name} missing '## Validation checklist'")
+            else:
+                print(f"  [OK] {wf.name} has Validation checklist.")
+    # 5. Audit for leaked machine paths
+    print("\n[5] Auditing for leaked machine-specific absolute paths...")
+    for ext in ["*.md", "*.json", "*.js", "*.py"]:
+        for file in root.rglob(ext):
+            if any(part in file.parts for part in [".git", "node_modules", "dist", "assets"]):
+                continue
+            text = file.read_text(encoding="utf-8", errors="ignore")
+            if re.search(r'[A-Za-z]:\\(?:Users|wamp64|Dev-Studio)', text, re.IGNORECASE):
+                if file.name not in ["release_suite.py", "audit_all_skills.py"]:
+                    errors.append(f"Machine-specific absolute path found in: {file.relative_to(root)}")
+    print("\n" + "=" * 60)
+    if errors:
+        print(f"[FAIL] {len(errors)} validation error(s) found:")
+        for err in errors:
+            print(f"  - {err}")
+        print("=" * 60)
+        sys.exit(1)
+    else:
+        print("[SUCCESS] ALL SKILL INTEGRITY CHECKS PASSED!")
+        print("=" * 60)
+        sys.exit(0)
+if __name__ == "__main__":
+    main()