@ai.all/ds7 0.0.0-stage → 2.0.0

package/bin/ds7.js

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+'use strict';
+
+// DS7 CLI. Installs the DS7 standard into ds7/ and enables it as the `ds7`
+// pack of AI-ALL (@ai.all/aiall). The agent entrypoints and the root ALL.md
+// belong to AI-ALL; this CLI never writes them.
+//
+// Usage: npx @ai.all/ds7 [init|sync|update|--version|--help]
+//
+// Ownership:
+//   ds7/**                 the standard, vendored; overwritten by `update`
+//   ds7/aiall-pack.json    pack manifest, generated from this version; overwritten by `update`
+//   ds7/VERSION            installed version; written by `init` and `update`
+//   ALL.md (project root)  AI-ALL routing file; its packs block is managed by AI-ALL,
+//                          the text outside that block is the project's own
+
+const fs   = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const C = {
+  reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m',
+  green: '\x1b[32m', yellow: '\x1b[33m', cyan: '\x1b[36m', red: '\x1b[31m',
+};
+const ok   = (s) => console.log(`  ${C.green}✓${C.reset} ${s}`);
+const skip = (s) => console.log(`  ${C.dim}· ${s} (exists, kept)${C.reset}`);
+const info = (s) => console.log(`  ${C.yellow}→${C.reset} ${s}`);
+const err  = (s) => console.log(`  ${C.red}✗${C.reset} ${s}`);
+
+const PKG    = path.resolve(__dirname, '..');
+const TARGET = process.cwd();
+const DS7    = path.join(TARGET, 'ds7');
+const PACK_REF = 'ds7/aiall-pack.json';
+
+const { version } = require(path.join(PKG, 'package.json'));
+
+// Folders that make up the standard (copied into ds7/).
+const DS7_DIRS = [
+  '01-architecture', '02-design-system', '03-performance-web-vitals',
+  '04-seo-ai-optimization', '05-internationalization', '06-business-conversion',
+  '07-testing', '08-token-optimization', 'templates',
+];
+// Root-level documents of the standard (copied into ds7/).
+const DS7_FILES = ['README.md', 'SPEC.md', 'ALL.md', 'CHANGELOG.md'];
+
+// Collect every file under a folder of the package, as paths relative to PKG.
+function listFiles(relDir) {
+  const out = [];
+  const walk = (abs, rel) => {
+    for (const e of fs.readdirSync(abs, { withFileTypes: true })) {
+      const a = path.join(abs, e.name);
+      const r = path.join(rel, e.name);
+      if (e.isDirectory()) walk(a, r);
+      else out.push(r);
+    }
+  };
+  walk(path.join(PKG, relDir), relDir);
+  return out;
+}
+
+// Copy one file. `overwrite` decides whether an existing file is replaced.
+function copyOne(relFromPkg, destAbs, overwrite) {
+  const label = path.relative(TARGET, destAbs);
+  if (fs.existsSync(destAbs) && !overwrite) { skip(label); return false; }
+  fs.mkdirSync(path.dirname(destAbs), { recursive: true });
+  fs.copyFileSync(path.join(PKG, relFromPkg), destAbs);
+  ok(label);
+  return true;
+}
+
+// Every file of the standard, as [relative path in package, destination].
+function standardFiles() {
+  const pairs = [];
+  for (const dir of DS7_DIRS) {
+    if (!fs.existsSync(path.join(PKG, dir))) continue;
+    for (const rel of listFiles(dir)) pairs.push([rel, path.join(DS7, rel)]);
+  }
+  for (const f of DS7_FILES) pairs.push([f, path.join(DS7, f)]);
+  return pairs;
+}
+
+// The pack manifest that AI-ALL reads. Paths are project-relative, because the
+// standard is vendored into ds7/ and AI-ALL links to them from the project's ALL.md.
+function packManifest() {
+  const doc = (p) => `ds7/${p}`;
+  return {
+    name: '@ai.all/ds7',
+    version,
+    title: 'DS7 web architecture standard',
+    directives: [
+      { id: 'ds7.rules', title: 'DS7 agent rules',
+        summary: 'Read before any change in a DS7 web project: ground rules, build order, components and the pre-finish checklist.',
+        doc: doc('ALL.md') },
+      { id: 'ds7.spec', title: 'DS7 stack and quality gates',
+        summary: 'Read for the stack, directory layout, naming, performance targets and quality gates.',
+        doc: doc('SPEC.md') },
+      { id: 'ds7.architecture', title: 'Atomic architecture',
+        summary: 'Read before creating or changing components, variants or modifiers.',
+        doc: doc('01-architecture/COMPONENT-ANATOMY.md') },
+      { id: 'ds7.brand', title: 'Brand tokens and brandbook',
+        summary: 'Read before changing colours, type, spacing or the brandbook page.',
+        doc: doc('02-design-system/TOKENS-SPEC.md') },
+      { id: 'ds7.i18n', title: 'Internationalisation',
+        summary: 'Read before adding a locale, a route or a translated string.',
+        doc: doc('05-internationalization/I18N-ARCHITECTURE.md') },
+      { id: 'ds7.testing', title: 'Testing strategy',
+        summary: 'Read before adding or changing tests or quality checks.',
+        doc: doc('07-testing/TESTING-STRATEGY.md') },
+    ],
+  };
+}
+
+function writePackManifest(overwrite) {
+  const dest = path.join(DS7, 'aiall-pack.json');
+  if (fs.existsSync(dest) && !overwrite) { skip(path.relative(TARGET, dest)); return; }
+  fs.mkdirSync(DS7, { recursive: true });
+  fs.writeFileSync(dest, `${JSON.stringify(packManifest(), null, 2)}\n`);
+  ok(path.relative(TARGET, dest));
+}
+
+function writeVersion() {
+  fs.mkdirSync(DS7, { recursive: true });
+  fs.writeFileSync(path.join(DS7, 'VERSION'), `${version}\n`);
+}
+
+// Run an AI-ALL command with the @ai.all/aiall version this package depends on.
+// The dependency is pinned, so the tested version is the one that runs.
+function runAiall(args) {
+  let bin;
+  try { bin = require.resolve('@ai.all/aiall/bin/cli.js'); }
+  catch { err('@ai.all/aiall is not installed. Reinstall with: npm i -D @ai.all/ds7'); return false; }
+  const r = spawnSync(process.execPath, [bin, ...args, '--path', TARGET], { stdio: 'inherit' });
+  return r.status === 0;
+}
+
+// True when .ai/aiall.json already lists the DS7 pack.
+function packEnabled() {
+  try {
+    const cfg = JSON.parse(fs.readFileSync(path.join(TARGET, '.ai', 'aiall.json'), 'utf8'));
+    return Array.isArray(cfg.packs) && cfg.packs.includes(PACK_REF);
+  } catch { return false; }
+}
+
+function enablePack() {
+  if (packEnabled()) { skip(`pack ${PACK_REF}`); return true; }
+  if (!runAiall(['packs', 'add', PACK_REF])) return false;
+  ok(`pack ${PACK_REF} enabled`);
+  return true;
+}
+
+// Warn about files left by DS7 1.x. Nothing is deleted or rewritten automatically.
+function legacyWarnings() {
+  const rootAll = path.join(TARGET, 'ALL.md');
+  if (fs.existsSync(rootAll) && fs.readFileSync(rootAll, 'utf8').includes('Agent Rules for DS7 Projects')) {
+    info('Root ALL.md still holds the DS7 1.x rules. Those rules now live in ds7/ALL.md.');
+    info('Remove the copied rules from root ALL.md and keep the aiall packs block.');
+  }
+  if (fs.existsSync(path.join(TARGET, 'ALL.project.md'))) {
+    info('ALL.project.md is from DS7 1.x and is no longer used. Move its project values into');
+    info('root ALL.md (below the aiall packs block), then delete the file.');
+  }
+}
+
+function cmdInit() {
+  console.log(`\n${C.bold}${C.cyan}DS7 v${version} — setup${C.reset}\n`);
+
+  for (const [rel, dest] of standardFiles()) copyOne(rel, dest, false);
+  writePackManifest(false);
+  writeVersion();
+
+  console.log(`\n${C.yellow}Configuring AI-ALL…${C.reset}\n`);
+  if (!runAiall(['init'])) { err('AI-ALL init failed. Run: npx @ai.all/aiall init'); process.exitCode = 1; return; }
+  if (!enablePack()) { err(`Could not enable the pack. Run: npx @ai.all/aiall packs add ${PACK_REF}`); process.exitCode = 1; return; }
+  legacyWarnings();
+
+  console.log(`\n${C.bold}${C.green}DS7 is installed.${C.reset}`);
+  console.log(`  1. Read ${C.cyan}ds7/README.md${C.reset} for the standard and the build order.`);
+  console.log(`  2. Add this project's values to the root ${C.cyan}ALL.md${C.reset}, below the aiall packs block.`);
+  console.log(`  3. Run ${C.cyan}npx @ai.all/ds7 update${C.reset} to get new versions of the standard.\n`);
+}
+
+function cmdSync() {
+  console.log(`\n${C.yellow}Syncing agent entrypoints…${C.reset}\n`);
+  if (runAiall(['sync'])) ok('Agent entrypoints are in sync.');
+  else { err('Sync failed. Run: npx @ai.all/aiall sync'); process.exitCode = 1; }
+}
+
+function cmdUpdate() {
+  console.log(`\n${C.yellow}Updating the standard to v${version}…${C.reset}\n`);
+  if (!fs.existsSync(DS7)) {
+    err('ds7/ not found. Run `npx @ai.all/ds7` (init) first.');
+    process.exitCode = 1;
+    return;
+  }
+  for (const [rel, dest] of standardFiles()) copyOne(rel, dest, true);
+  writePackManifest(true);
+  writeVersion();
+
+  if (!runAiall(['sync'])) { err('Sync failed. Run: npx @ai.all/aiall sync'); process.exitCode = 1; return; }
+  if (!enablePack()) { process.exitCode = 1; return; }
+  legacyWarnings();
+
+  console.log(`\n${C.green}Standard updated to v${version}. See ds7/CHANGELOG.md for what changed.${C.reset}`);
+  info('The root ALL.md outside the aiall packs block was not changed.\n');
+}
+
+function cmdHelp() {
+  console.log(`
+DS7 ${version}
+
+  npx @ai.all/ds7           install the standard and enable the ds7 pack (init)
+  npx @ai.all/ds7 sync      sync agent entrypoints (AI-ALL sync)
+  npx @ai.all/ds7 update    update ds7/ to this version and refresh the pack
+  npx @ai.all/ds7 --version print the version
+`);
+}
+
+const cmd = process.argv[2];
+if (cmd === '--version' || cmd === '-v') console.log(version);
+else if (cmd === '--help' || cmd === '-h' || cmd === 'help') cmdHelp();
+else if (cmd === 'sync') cmdSync();
+else if (cmd === 'update') cmdUpdate();
+else if (!cmd || cmd === 'init') cmdInit();
+else { err(`Unknown command: ${cmd}`); cmdHelp(); process.exitCode = 1; }

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "@ai.all/ds7",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.0.0",
+  "description": "AI-ready architecture standard for web projects: brand-first foundations, Atomic Design and agent rules in one place",
+  "keywords": [
+    "architecture",
+    "design-system",
+    "design-tokens",
+    "brandbook",
+    "atomic-design",
+    "nuxt",
+    "vue",
+    "web-vitals",
+    "seo",
+    "ai",
+    "agents",
+    "i18n",
+    "accessibility"
+  ],
+  "homepage": "https://github.com/ai-all-ai/ds7#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ai-all-ai/ds7.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ai-all-ai/ds7/issues"
+  },
+  "license": "MIT",
+  "author": "Igor Orlov",
+  "bin": {
+    "ds7": "bin/ds7.js"
+  },
+  "files": [
+    "bin/",
+    "01-architecture/",
+    "02-design-system/",
+    "03-performance-web-vitals/",
+    "04-seo-ai-optimization/",
+    "05-internationalization/",
+    "06-business-conversion/",
+    "07-testing/",
+    "08-token-optimization/",
+    "templates/",
+    "ALL.md",
+    "CHANGELOG.md",
+    "README.md",
+    "SPEC.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@ai.all/aiall": "^0.3.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "test": "node bin/ds7.js --version && node bin/ds7.js --help > /dev/null && node --test test/integration.test.js",
+    "prepublishOnly": "npm test"
+  }
+}

package/templates/component.vue

@@ -0,0 +1,116 @@
+<script setup lang="ts">
+/**
+ * DS7 component template: product card molecule (CARD-01).
+ * Atomic level: molecule. Modifiers: -top, -new, -compact, -dark.
+ */
+
+interface SpecItem {
+  label: string
+  value: string
+}
+
+const props = withDefaults(defineProps<{
+  title: string
+  description?: string
+  price?: number | null
+  badge?: 'top' | 'new' | 'sale'
+  specs?: SpecItem[]
+  top?: boolean
+  compact?: boolean
+  dark?: boolean
+}>(), {
+  description: '',
+  price: null,
+  specs: () => [],
+  top: false,
+  compact: false,
+  dark: false,
+})
+
+const classes = computed(() => [
+  'p-card',
+  props.top && '-top',
+  props.compact && '-compact',
+  props.dark && '-dark',
+  props.badge && `-${props.badge}`,
+])
+</script>
+
+<template>
+  <article :class="classes" data-ref="CARD-01">
+    <!-- Artwork or logo slot -->
+    <div class="p-card__art">
+      <slot name="art" />
+    </div>
+
+    <!-- Text body -->
+    <div class="p-card__body">
+      <h3 class="p-card__title">{{ title }}</h3>
+      <p v-if="description" class="p-card__desc">{{ description }}</p>
+
+      <dl v-if="specs.length" class="p-card__specs">
+        <div v-for="s in specs" :key="s.label">
+          <dt>{{ s.label }}</dt>
+          <dd>{{ s.value }}</dd>
+        </div>
+      </dl>
+    </div>
+
+    <!-- Footer: price and action. The price is formatted by the project's price atom. -->
+    <div class="p-card__footer">
+      <div v-if="price !== null" class="p-card__price">
+        <span class="p-card__price-val">{{ price }} €</span>
+      </div>
+      <slot name="action" />
+    </div>
+  </article>
+</template>
+
+<style>
+/*
+ * Component styles. Not scoped: the prefix isolates them, and parents can
+ * override the custom properties. Values come from the tokens in theme.css.
+ */
+.p-card {
+  --card-bg: var(--color-white, #fff);
+  --card-ink: var(--color-ink, #1f1b16);
+  --card-border: var(--color-ink-100, rgba(31, 27, 22, 0.08));
+
+  container-type: inline-size;
+  display: flex;
+  flex-direction: column;
+  background: var(--card-bg);
+  color: var(--card-ink);
+  border: 1px solid var(--card-border);
+  border-radius: var(--radius-md, 12px);
+  padding: var(--space-4, 16px);
+  transition: transform 0.2s ease, box-shadow 0.2s ease;
+}
+
+.p-card.-top {
+  --card-border: var(--color-sun, #ffd84d);
+  box-shadow: var(--shadow-lift);
+}
+.p-card.-top .p-card__title {
+  font-weight: 700;
+}
+
+.p-card.-dark {
+  --card-bg: var(--color-ink-950, #12100d);
+  --card-ink: #ffffff;
+  --card-border: rgba(255, 255, 255, 0.12);
+}
+
+.p-card.-compact {
+  padding: var(--space-2, 8px);
+}
+
+@container (max-width: 320px) {
+  .p-card {
+    padding: var(--space-2, 8px);
+  }
+  .p-card__title {
+    font-size: 0.95rem;
+  }
+}
+</style>

package/templates/nuxt.config.ts

@@ -0,0 +1,64 @@
+import tailwindcss from '@tailwindcss/vite'
+
+/**
+ * DS7 reference Nuxt 4 configuration.
+ * Static generation, inlined critical CSS, one i18n hub.
+ * Replace the placeholders in [brackets] with project values.
+ */
+export default defineNuxtConfig({
+  compatibilityDate: '2025-07-15',
+  devtools: { enabled: false },
+
+  css: ['~/assets/css/main.css'],
+
+  modules: [
+    '@nuxtjs/i18n',
+  ],
+
+  vite: {
+    plugins: [tailwindcss()],
+  },
+
+  experimental: {
+    inlineSSRStyles: true,   // critical CSS per page, see 03-performance-web-vitals/CRITICAL-CSS.md
+    viewTransition: false,
+  },
+
+  i18n: {
+    strategy: 'prefix_except_default',
+    defaultLocale: 'es',
+    locales: [
+      { code: 'es', language: 'es-ES', name: 'Español', file: 'es.ts' },
+      { code: 'en', language: 'en-GB', name: 'English', file: 'en.ts' },
+      { code: 'uk', language: 'uk-UA', name: 'Українська', file: 'uk.ts' },
+    ],
+    langDir: '../i18n/locales',
+    detectBrowserLanguage: false,
+  },
+
+  app: {
+    head: {
+      htmlAttrs: { lang: 'es' },
+      meta: [
+        { name: 'theme-color', content: '#f7f5ef' },
+        { name: 'color-scheme', content: 'light' },
+        { name: 'robots', content: 'index, follow, max-image-preview:large, max-snippet:-1' },
+      ],
+      link: [
+        { rel: 'icon', type: 'image/svg+xml', href: '/favicon.svg' },
+        // Preload the brand font used on the first screen (see 03-performance-web-vitals/FONTS-ZERO-CLS.md):
+        // { rel: 'preload', href: '/fonts/[brand-font].woff2', as: 'font', type: 'font/woff2', crossorigin: 'anonymous' },
+      ],
+    },
+  },
+
+  nitro: {
+    prerender: {
+      crawlLinks: true,
+    },
+  },
+
+  typescript: {
+    strict: true,
+  },
+})

package/templates/theme.css

@@ -0,0 +1,55 @@
+/*
+ * DS7 foundations: design tokens.
+ * Components read these variables only. Add a value here before using it anywhere.
+ * See 02-design-system/TOKENS-SPEC.md.
+ */
+
+:root {
+  /* 1. Surfaces and text */
+  --color-paper: #f7f5ef;
+  --color-white: #ffffff;
+  --color-ink: #1f1b16;
+  --color-ink-500: #6b6459;
+  --color-ink-100: rgba(31, 27, 22, 0.08);
+  --color-ink-950: #12100d;
+
+  /* 2. Brand accent (fill only, never text) */
+  --color-sun: #ffd84d;
+  --color-sun-hover: #ffcf2e;
+
+  /* 3. Spacing scale */
+  --space-1: 0.25rem;
+  --space-2: 0.5rem;
+  --space-3: 0.75rem;
+  --space-4: 1rem;
+  --space-6: 1.5rem;
+  --space-8: 2rem;
+  --space-12: 3rem;
+  --space-16: 4rem;
+
+  /* Section rhythm */
+  --space-single: clamp(1.2rem, 3vw, 2.2rem);
+  --space-double: clamp(2.4rem, 6vw, 4.5rem);
+  --space-triple: clamp(3.6rem, 9vw, 6.5rem);
+
+  /* Page grid */
+  --content-width: 78rem;
+  --page-gutter: clamp(1rem, 3.5vw, 2rem);
+
+  /* 4. Elevation */
+  --shadow-lift: 0 4px 16px -2px rgba(31, 27, 22, 0.06);
+  --shadow-hover: 0 12px 32px -4px rgba(31, 27, 22, 0.12);
+  --shadow-modal: 0 24px 64px -8px rgba(18, 16, 13, 0.24);
+
+  /* 5. Radius */
+  --radius-sm: 0.375rem;
+  --radius-md: 0.75rem;
+  --radius-lg: 1.25rem;
+  --radius-full: 9999px;
+
+  /* 6. Breakpoints (for media queries; components use container queries) */
+  --bp-sm: 480px;
+  --bp-md: 800px;
+  --bp-lg: 900px;
+  --bp-xl: 1200px;
+}