@ai.all/ds7 1.0.0 → 2.0.0

package/SPEC.md

@@ -1,58 +1,102 @@
-# DS7 Technical Specification & Standards
+# DS7 Technical Specification
 
-## 1. Стек технологий
-- **Framework:** Nuxt 4 (Vue 3.5+, Composition API `<script setup lang="ts">`).
-- **Styling:** Tailwind CSS v4 + Semantic CSS Custom Properties (Design Tokens in `theme.css`).
-- **Rendering:** Full Static Generation (`npx nuxt generate`), Nitro prerendering for all routes, sitemap.xml, robots.txt.
-- **i18n:** `@nuxtjs/i18n` (prefix-except-default strategy, single hub in `i18n/locales/`).
-- **Typing:** Strict TypeScript (`typescript: { strict: true }`).
-- **Testing:** Vitest (unit tests) + Playwright (end-to-end and visual regression).
+> **How it fits with AI-ALL.** [AI-ALL](https://github.com/ai-all-ai/aiall) (`@ai.all/aiall`) creates the agent entrypoints and the routing file, and keeps them in sync. This document is delivered to agents as the `ds7` pack of AI-ALL. AI-ALL works without DS7; for web projects, install both.
+
+
+Version 1.1.0. This document is the technical baseline. Rules for agents are in `ALL.md`; this file describes the stack, the layout and the quality gates.
 
 ---
 
-## 2. Иерархия директорий эталонного проекта
+## 1. Stack
+
+- **Framework:** Nuxt 4, Vue 3.5+, Composition API with `<script setup lang="ts">`.
+- **Styling:** Tailwind CSS v4 and CSS custom properties defined in `theme.css`.
+- **Rendering:** static generation (`nuxt generate`), prerendered routes, `sitemap.xml`, `robots.txt`.
+- **i18n:** `@nuxtjs/i18n`, prefix-except-default strategy, one locale hub in `i18n/locales/`.
+- **Types:** strict TypeScript.
+- **Tests:** Vitest for unit and composable tests; Playwright for flows and browser checks; axe for accessibility.
+- **Quality tooling:** a single `qa` script runs the gates listed in section 5.
+
+---
+
+## 2. Directory layout
 
 ```
 project-root/
 ├── app/
-│   ├── app.vue                # Корневой шаблон приложения
+│   ├── app.vue
 │   ├── assets/css/
-│   │   ├── main.css           # Точка сборки стилей
-│   │   ├── theme.css          # Дизайн-токены (цвета, шрифты, отступы, тени)
-│   │   ├── base.css           # Глобальный ресет и теги
-│   │   └── components.css     # Базовые классы и модификаторы компонентов
+│   │   ├── main.css           # entry point for styles
+│   │   ├── theme.css          # foundations: tokens
+│   │   ├── base.css           # reset and element defaults
+│   │   └── components.css     # base classes and modifiers
 │   ├── components/
-│   │   ├── ui/                # Атомы и Молекулы (UiButton, UiProductCard, UiPrice...)
-│   │   ├── sections/          # Автономные секции и Организмы (UiCardSlider, CalcSection...)
-│   │   └── site/              # Каркас сайта (SiteHeader, SiteFooter, SiteModalHost...)
-│   ├── composables/           # Переиспользуемая логика (usePageSeo, useModal, useCalc...)
-│   ├── data/                  # Бизнес-данные и схемы (каталог, статьи, FAQ, маршруты)
-│   ├── domain/                # Чистая бизнес-математика (калькуляторы без привязки к Vue)
-│   └── pages/                 # Маршруты Nuxt (только связка данных с секциями)
+│   │   ├── ui/                # atoms and molecules
+│   │   ├── sections/          # sections and organisms
+│   │   └── site/              # site shell: header, footer, modal host
+│   ├── composables/           # reusable logic
+│   ├── data/                  # business data and schemas
+│   ├── domain/                # pure business maths, no Vue imports
+│   └── pages/                 # routes: data in, sections out
 ├── i18n/
-│   └── locales/               # Единый хаб локализации ({es,en,uk,de}.ts)
-├── public/                    # Статические ассеты (картинки, шрифты, favicon, лого)
-├── docs/                      # Документация проекта для человека и команды
-└── nuxt.config.ts             # Конфигурация Nuxt 4
+│   └── locales/               # one file per language, same keys
+├── public/                    # static assets: images, fonts, favicon
+├── docs/                      # project documentation
+│   ├── ARCHITECTURE.md        # layer map and browser storage keys
+│   ├── DECISIONS.md           # dated decisions and reasons
+│   └── METRICS.md             # dated measurements, with machine and build
+└── nuxt.config.ts
 ```
 
 ---
 
-## 3. Матрица соглашений по именованию классов (CSS Naming)
+## 3. Class naming
 
-| Роль | Формат имени | Пример |
+| Role | Format | Example |
 |---|---|---|
-| **Базовый компонент** | Короткий семантический кебаб-кейс | `.p-card`, `.btn`, `.slider`, `.field` |
-| **Элемент компонента** | Двойное подчеркивание (BEM-light) | `.p-card__title`, `.p-card__price`, `.btn__icon` |
-| **Модификатор** | Отдельный класс с дефисом | `.-top`, `.-new`, `.-dark`, `.-compact`, `.-outline` |
-| **Состояние** | Префикс `is-` | `.is-active`, `.is-open`, `.is-loading` |
-| **Контекст страницы** | Класс на теге `body` | `body.page-home`, `body.page-hogares`, `body.page-empresas` |
+| Base component | short kebab-case | `.p-card`, `.btn`, `.field` |
+| Element | double underscore | `.p-card__title` |
+| Modifier | separate class with a leading dash | `.-top`, `.-compact`, `.-lg` |
+| State | `is-` prefix | `.is-open`, `.is-active` |
+| Page context | class on `<body>` | `body.page-home` |
+
+---
+
+## 4. Targets
+
+These are design targets for a finished page on a mid-range phone over a 4G connection. They are not measured results. Measure them on the target device and record the results in `docs/METRICS.md`.
+
+| Metric | Target |
+|---|---|
+| Lighthouse Performance | ≥ 95 |
+| Lighthouse Accessibility | ≥ 95 |
+| Lighthouse Best Practices | ≥ 95 |
+| Lighthouse SEO | 100 |
+| First Contentful Paint | ≤ 1.0 s |
+| Largest Contentful Paint | ≤ 2.5 s |
+| Cumulative Layout Shift | ≤ 0.01 (CLS 0 is the aim) |
+| Total Blocking Time | ≤ 200 ms |
+| Interaction to Next Paint | ≤ 200 ms |
+
+Lab tools in CI or in a sandbox do not produce reliable LCP or INP values. Use them for regressions only, not as proof.
+
+---
+
+## 5. Quality gates
+
+A change is done when these pass:
+
+1. Unit and composable tests.
+2. Type check.
+3. Locale parity: every key exists in every locale.
+4. Asset references: every `/images/…` and `/fonts/…` path exists in `public/`.
+5. HTML check: valid markup on every generated page.
+6. Console check: no errors or warnings on load.
+7. Accessibility: axe reports 0 violations at 390, 820 and 1440 px.
+8. Build: `nuxt generate` completes.
 
 ---
 
-## 4. Контрольные показатели качества (Quality Gates)
+## 6. Versioning and release
 
-1. **Lighthouse:** Performance ≥ 95, Accessibility ≥ 95, Best Practices ≥ 95, SEO = 100.
-2. **Core Web Vitals:** FCP ≤ 0.4s, LCP ≤ 1.2s, CLS = 0.000, TBT ≤ 50ms, INP ≤ 50ms.
-3. **A11y (Доступность):** 0 ошибок axe-core, строгий контраст текста (WCAG AA), уникальные `useId()` для SVG/фильтров.
-4. **Bundle Size:** Нулевой избыточный JS/CSS на первом экране, 100% покрытие шрифтов прелоадом.
+See `ALL.md` section 11 and `README.md`. Summary: semantic versions, one changelog entry per user-visible change, tag `vX.Y.Z` on release, publish by the maintainer.

package/bin/ds7.js

@@ -1,141 +1,224 @@
 #!/usr/bin/env node
 'use strict';
 
-// DS7 CLI — bootstraps the DS7 architecture standard in any project.
-// Usage: npx @ai-all-ai/ds7 [init|sync|update|--version]
+// 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');
 
-// ─── ANSI colours ──────────────────────────────────────────────────────────
 const C = {
-  reset:  '\x1b[0m',
-  bold:   '\x1b[1m',
-  dim:    '\x1b[2m',
-  green:  '\x1b[32m',
-  yellow: '\x1b[33m',
-  cyan:   '\x1b[36m',
-  red:    '\x1b[31m',
+  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, skipped)${C.reset}`);
+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}`);
 
-// ─── Paths ──────────────────────────────────────────────────────────────────
-const PKG    = path.resolve(__dirname, '..');   // package root (ds7/)
-const TARGET = process.cwd();                   // user's project root
+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'));
 
-// ─── Helpers ────────────────────────────────────────────────────────────────
-function copyDir(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-  for (const e of fs.readdirSync(src, { withFileTypes: true })) {
-    const s = path.join(src, e.name);
-    const d = path.join(dest, e.name);
-    if (e.isDirectory()) copyDir(s, d);
-    else if (!fs.existsSync(d)) { fs.copyFileSync(s, d); return true; }
-  }
-}
-
-function copyFile(src, dest) {
-  if (fs.existsSync(dest)) { skip(path.relative(TARGET, dest)); return false; }
-  fs.mkdirSync(path.dirname(dest), { recursive: true });
-  fs.copyFileSync(src, dest);
-  ok(path.relative(TARGET, dest));
-  return true;
-}
-
-// ─── Directories published to npm (not meta files) ──────────────────────────
+// 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',
 ];
-const DS7_FILES = ['README.md', 'SPEC.md', 'ALL.md', 'ANDALUSIA.md', 'ff.md'];
+// 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;
+}
 
-// ─── Commands ────────────────────────────────────────────────────────────────
-function cmdInit() {
-  console.log(`\n${C.bold}${C.cyan}⚡ DS7 v${version} — Architecture Setup${C.reset}\n`);
+// 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;
+}
 
-  // 1. Copy ds7/ docs structure
-  const ds7Target = path.join(TARGET, 'ds7');
-  let copied = 0;
+// Every file of the standard, as [relative path in package, destination].
+function standardFiles() {
+  const pairs = [];
   for (const dir of DS7_DIRS) {
-    const src  = path.join(PKG, dir);
-    const dest = path.join(ds7Target, dir);
-    if (!fs.existsSync(src)) continue;
-    const entries = fs.readdirSync(src, { withFileTypes: true });
-    fs.mkdirSync(dest, { recursive: true });
-    for (const e of entries) {
-      const s = path.join(src, e.name);
-      const d = path.join(dest, e.name);
-      if (e.isDirectory()) {
-        if (copyDir(s, d)) copied++;
-      } else if (!fs.existsSync(d)) {
-        fs.copyFileSync(s, d);
-        ok(`ds7/${dir}/${e.name}`);
-        copied++;
-      } else {
-        skip(`ds7/${dir}/${e.name}`);
-      }
-    }
-  }
-  for (const f of DS7_FILES) {
-    if (copyFile(path.join(PKG, f), path.join(ds7Target, f))) copied++;
+    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));
+}
 
-  // 2. Create ALL.md in project root if missing
-  copyFile(path.join(PKG, 'ALL.md'), path.join(TARGET, 'ALL.md'));
+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; }
+}
 
-  console.log(`\n${C.yellow}⚡ Syncing AI agent entrypoints...${C.reset}`);
+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;
+}
 
-  // 3. Run @ai.all/aiall
-  const r = spawnSync('npx', ['--yes', '@ai.all/aiall'], {
-    stdio: 'inherit', cwd: TARGET, shell: true,
-  });
-  if (r.status !== 0) {
-    info("Could not run @ai.all/aiall automatically.");
-    info("Run manually: npx @ai.all/aiall");
+// 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 ready.${C.reset}`);
-  console.log(`   Open ${C.cyan}ds7/README.md${C.reset} to explore the standard.`);
-  console.log(`   Open ${C.cyan}ALL.md${C.reset} to review and customise agent rules.\n`);
+  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 via @ai.all/aiall...${C.reset}\n`);
-  const r = spawnSync('npx', ['--yes', '@ai.all/aiall'], {
-    stdio: 'inherit', cwd: TARGET, shell: true,
-  });
-  if (r.status !== 0) err('Sync failed — run npx @ai.all/aiall manually.');
-  else ok('All agent entrypoints are in sync.');
+  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 ds7/ from package v${version}...${C.reset}\n`);
-  const ds7Target = path.join(TARGET, 'ds7');
-  for (const dir of DS7_DIRS) {
-    const src = path.join(PKG, dir);
-    if (!fs.existsSync(src)) continue;
-    copyDir(src, path.join(ds7Target, dir));
-    ok(`ds7/${dir}/`);
+  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;
   }
-  console.log(`\n${C.green}✅ ds7/ updated to v${version}.${C.reset}\n`);
+  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');
 }
 
-// ─── Dispatch ────────────────────────────────────────────────────────────────
-const cmd = process.argv[2];
-if (cmd === '--version' || cmd === '-v') {
-  console.log(version);
-} else if (cmd === 'sync') {
-  cmdSync();
-} else if (cmd === 'update') {
-  cmdUpdate();
-} else {
-  // default: init
-  cmdInit();
+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,10 +1,12 @@
 {
   "name": "@ai.all/ds7",
-  "version": "1.0.0",
-  "description": "AI-ready architecture standard for web projects — structured for humans, optimized for AI agents",
+  "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",
@@ -13,8 +15,7 @@
     "ai",
     "agents",
     "i18n",
-    "performance",
-    "lighthouse"
+    "accessibility"
   ],
   "homepage": "https://github.com/ai-all-ai/ds7#readme",
   "repository": {
@@ -25,7 +26,7 @@
     "url": "https://github.com/ai-all-ai/ds7/issues"
   },
   "license": "MIT",
-  "author": "Igor Orlov & The Human-AI Crafting Collective",
+  "author": "Igor Orlov",
   "bin": {
     "ds7": "bin/ds7.js"
   },
@@ -41,24 +42,22 @@
     "08-token-optimization/",
     "templates/",
     "ALL.md",
-    "AIALL.md",
-    "ANDALUSIA.md",
+    "CHANGELOG.md",
     "README.md",
-    "SPEC.md",
-    "ff.md"
+    "SPEC.md"
   ],
   "engines": {
     "node": ">=18"
   },
   "dependencies": {
-    "@ai.all/aiall": "^0.2.0"
+    "@ai.all/aiall": "^0.3.0"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "test": "node bin/ds7.js --version",
+    "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

@@ -1,7 +1,7 @@
 <script setup lang="ts">
 /**
- * DS7 Component Template
- * Эталонная структура Vue 3 SFC (Composition API, Atomic Design, Container Queries)
+ * DS7 component template: product card molecule (CARD-01).
+ * Atomic level: molecule. Modifiers: -top, -new, -compact, -dark.
  */
 
 interface SpecItem {
@@ -9,14 +9,12 @@ interface SpecItem {
   value: string
 }
 
-// 1. Типизированные пропсы с модификаторами
 const props = withDefaults(defineProps<{
   title: string
   description?: string
   price?: number | null
   badge?: 'top' | 'new' | 'sale'
   specs?: SpecItem[]
-  // Булевые пропсы-модификаторы:
   top?: boolean
   compact?: boolean
   dark?: boolean
@@ -26,27 +24,26 @@ const props = withDefaults(defineProps<{
   specs: () => [],
   top: false,
   compact: false,
-  dark: false
+  dark: false,
 })
 
-// 2. Вычисление минималистичных классов
 const classes = computed(() => [
   'p-card',
   props.top && '-top',
   props.compact && '-compact',
   props.dark && '-dark',
-  props.badge && `-${props.badge}`
+  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>
@@ -59,7 +56,7 @@ const classes = computed(() => [
       </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>
@@ -70,8 +67,9 @@ const classes = computed(() => [
 </template>
 
 <style>
-/* 
- * Стили компонента: изолируются через префикс и используют CSS Custom Properties
+/*
+ * 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);
@@ -89,7 +87,6 @@ const classes = computed(() => [
   transition: transform 0.2s ease, box-shadow 0.2s ease;
 }
 
-/* Модификатор TOP */
 .p-card.-top {
   --card-border: var(--color-sun, #ffd84d);
   box-shadow: var(--shadow-lift);
@@ -98,19 +95,16 @@ const classes = computed(() => [
   font-weight: 700;
 }
 
-/* Модификатор Dark */
 .p-card.-dark {
   --card-bg: var(--color-ink-950, #12100d);
   --card-ink: #ffffff;
   --card-border: rgba(255, 255, 255, 0.12);
 }
 
-/* Модификатор Compact */
 .p-card.-compact {
   padding: var(--space-2, 8px);
 }
 
-/* Контейнерная адаптивность */
 @container (max-width: 320px) {
   .p-card {
     padding: var(--space-2, 8px);