@njeybe/nativ 2.6.0 → 2.8.0

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # Changelog
 
+## 2.8.0
+
+### Changed
+
+- **One set of Studio state words.** Every page says Up next, Running, Done or Stuck. "Ready", "Blocked", "Waiting", "Just finished", "Idle" and "completed / started" are gone. A failed run shows as Stuck. A stopped run, or a claim older than 4 hours with no active run, shows as Up next.
+- **Plain agent names.** Home, Tasks and Team show names such as "QA tester" instead of `qa-tester`. Team merges alias rows of the same agent.
+- **Quieter shell.** The pulse strip shows only non-zero counts and hides when everything is zero. The dispatch button hides when nothing is ready instead of showing a grey "Nothing ready". "Abort" is now "Stop". The Benchmarks nav badge is gone. The workspace path no longer breaks mid-word.
+- **Slimmer runner console.** Stop shows only while a run is active. Open diff, Clear and Auto-scroll sit in a More menu. An idle console hides its empty stepper and zero totals.
+- **Tasks page.** A list row opens the task drawer, the same as a Board card. Filters with no tasks are hidden. The Board always shows its four lanes, and an empty lane says "None". The drawer has "Watch live", and "How it is checked" wraps.
+- **Home.** Recent activity shows one row per task with its title and state, for example "Done, took 4m 00s".
+- **Flow.** Plan cards show titles on up to two lines.
+- **Database and Benchmarks.** "Not set up" is neutral, and red means only a configured connection that is offline. The header Connection Settings button is the single way in. Benchmarks lists scenarios that were not run on one line.
+- **Option trade-offs.** The architect, the project manager and the shared directive add one line on when the non-recommended option would be the better choice.
+- **Verifier report.** The verifier reports contract findings and code style findings in separate parts.
+
+## 2.7.0
+
+### Added
+
+- **Design profiles.** The Design Profile in `.ai/ui_specs.md` picks `taste-v1` or `taste-v2`. Workers follow the chosen profile's rules before they build UI. Native mobile and terminal UI get no profile and follow only their own spec; an unset profile makes frontend workers escalate.
+- **Bundled taste-skill v1 and v2.** init and update install `.ai/design/taste/` with each version's `SKILL.md` and a short `DIGEST.md` that workers read first. Untouched copies refresh on update. Credit: Leonxlnx, MIT License, pinned at commit `717446e`.
+- **`nativ init --design`.** Choose the design profile when scaffolding a project.
+- **`nativ design check`.** Scans UI files with eight rules for emoji, em and en dashes, `h-screen`, scroll listeners, pure black, Google Fonts links, hand-rolled icons and custom cursors. Exits 1 on errors; warnings never fail. Supports `--profile` and `--json`.
+- **Frontend pre-flight.** The frontend guide runs `nativ design check` on the task's UI files before a worker finishes.
+- **Doctor findings.** `nativ doctor` reports the design profile (`specs:design-profile`) and the bundle (`design:taste-bundle`).
+
+### Changed
+
+- **Studio redesign.** Studio follows the taste-v1 design profile in a monochrome "Ink" direction. It has light and dark themes, and color is used only for status.
+- **New wordmark.** The nativ wordmark replaces the old letter logo and follows the theme.
+- **Phosphor icons.** Studio icons are now Phosphor (MIT). See Third-party notices in the README.
+- **Pulse strip.** A strip under the top bar shows milestone progress and running, blocked and decision counts on every page.
+- **Dispatch button.** The top bar has a "Dispatch `<next task>`" button.
+- **Inspector.** The console drawer is now a right-side inspector. On narrow screens it is a sheet.
+- **Home is a "now" page.** It shows decisions, running tasks, up next, milestone progress and recent activity.
+- **Tasks list.** Tasks defaults to a list grouped by milestone, with filters and a Board toggle.
+- **Team roster.** Team is a roster table.
+- **Worktrees.** Worktree changes open in the inspector.
+- **Restyled pages.** Flow, Benchmarks, Database and dialogs are restyled.
+
+### Removed
+
+- The `nativ` design profile and every nativ-authored design rule. `nativ init --design` and `--profile` accept only `taste-v1` or `taste-v2`; `nativ design check` exits 1 until a profile is set or passed.
+- The Anti-Generic Checklist (Web, Marketing pages, Mobile) from `ui_specs.md`, and the Transitions and Active state lines of its Accessibility section.
+- Frontend guide: Visual style, Anti-generic rules and Build-time details, plus the `nativ` fallback and the style and Marketing pages checks in Before you finish.
+- Flutter guide: Anti-generic rules.
+- Architect guides: the `nativ` profile choice, the Inter typeface rule and the Anti-Generic and Marketing pages checks.
+- Doctor finding `specs:marketing`.
+- `nativ update` does not change an existing project's `.ai/ui_specs.md`, so projects keep their own text. Their frontend workers escalate UI tasks until the architect fills the Design Profile.
+
 ## 2.6.0
 
 ### Improved: token usage and autonomy

package/README.md

@@ -26,6 +26,7 @@ cd your-project && nativ init    # scaffold .ai/ and the Claude Code configurati
 | | [Database](#database) | [Troubleshooting](#troubleshooting) |
 | | [Worktrees](#worktrees) | [For maintainers](#for-maintainers) |
 | | [Studio, tests and benchmarks](#studio-tests-and-benchmarks) | |
+| | | [Design profiles](#design-profiles) |
 
 ---
 
@@ -140,7 +141,8 @@ Every command takes an optional `[targetDir]` (default: the current directory) a
 
 | Command | What it does | Who |
 | :--- | :--- | :--- |
-| [`init`](#nativ-init) | Scaffold `.ai/` and the Claude Code configuration | You |
+| [`init`](#nativ-init) | Scaffold `.ai/` and the Claude Code configuration; `--design` picks a design profile | You |
+| [`design check`](#nativ-design-check) | Scan UI files for design-rule violations | You, Agent |
 | [`setup`](#nativ-setup) | Write or merge the Claude Code configuration | You |
 | [`profile`](#nativ-profile) | Inspect or switch ceremony profile (`prototype`, `solo`, `enterprise`) | You, Agent |
 | [`doctor`](#nativ-doctor) | Check the integration and the harness; `--fix` repairs | You, Agent (read-only) |
@@ -190,6 +192,20 @@ nativ init [targetDir] [-f, --force]
 | Option | Description |
 | :--- | :--- |
 | `-f, --force` | Overwrite existing specification and directive files |
+| `--design <taste-v1|taste-v2>` | Set the design profile in `.ai/ui_specs.md` and install the taste-skill bundle |
+
+#### `nativ design check`
+
+Scan UI source files for design-rule violations. Exits 1 on any error.
+
+```bash
+nativ design check [paths...] [--profile <id>] [--json]
+```
+
+| Option | Description |
+| :--- | :--- |
+| `--profile <id>` | `taste-v1` or `taste-v2`; default is the profile in `.ai/ui_specs.md`. With neither, the command exits 1 |
+| `--json` | Print findings as JSON |
 
 #### `nativ setup`
 
@@ -656,6 +672,29 @@ Run the MCP server over stdio. `setup` registers it; see [MCP server](#mcp-serve
 
 ---
 
+## Design profiles
+
+nativ can hold web UI work to a design profile. Pick one per web project; it is recorded in the
+Design Profile section of `.ai/ui_specs.md`.
+
+| Profile | Use for |
+| :--- | :--- |
+| `taste-v2` | Landing sites, portfolios, editorial pages and web redesigns |
+| `taste-v1` | Web apps, SaaS screens and dashboards |
+
+Native mobile (Flutter) and terminal UI get no profile. They follow only their own spec.
+
+Set it with `nativ init --design taste-v2` (or `taste-v1`), or let the architect pick one during
+planning. An unset profile is a spec gap: frontend workers escalate, and `nativ design check`
+exits 1 until a profile is set or passed with `--profile`. An architect must pick one. Init and update install the bundle in `.ai/design/taste/`: the
+LICENSE, SOURCE.md, and `v1/` and `v2/` folders, each with `SKILL.md` and a short `DIGEST.md`
+that workers read first. Run `nativ design check` to scan UI files for rule violations.
+
+Credit: the taste-skill prompts are by Leonxlnx, [github.com/Leonxlnx/taste-skill](https://github.com/Leonxlnx/taste-skill),
+MIT License, pinned at commit `717446e`.
+
+---
+
 ## Configuration
 
 ### `.nativ/config.json`
@@ -907,3 +946,34 @@ npm run sync-plugin      # after changing a template or the setup generator; a t
 ## License
 
 MIT (c) JB Natividad. See [LICENSE](LICENSE).
+
+## Third-party notices
+
+- **Phosphor Icons** (`@phosphor-icons/core` 2.1.1) is vendored into Studio under the MIT license:
+
+  ```
+  MIT License
+
+  Copyright (c) 2023 Phosphor Icons
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+  ```
+
+- **taste-skill** by Leonxlnx (MIT). The bundled copy keeps its own LICENSE under
+  `templates/design/taste/`.

package/dist/commands/design-check.d.ts

@@ -0,0 +1,4 @@
+export declare function runDesignCheck(paths: string[] | undefined, options: {
+    profile?: string;
+    json?: boolean;
+}): void;

package/dist/commands/design-check.js

@@ -0,0 +1,76 @@
+import fs from 'fs';
+import path from 'path';
+import { DESIGN_PROFILES, SCAN_EXTENSIONS, checkText, readProfile, } from '../core/design-rules.js';
+const SKIP_DIRS = new Set(['node_modules', 'dist', 'build', '.next', '.ai']);
+let jsonMode = false;
+function fail(msg) {
+    if (jsonMode)
+        console.log(JSON.stringify({ error: msg }));
+    else
+        console.error(msg);
+    process.exit(1);
+}
+function isScannable(name) {
+    if (/\.(test|spec)\./.test(name))
+        return false;
+    return SCAN_EXTENSIONS.includes(path.extname(name));
+}
+function collect(target, out) {
+    const stat = fs.statSync(target);
+    if (stat.isFile()) {
+        if (isScannable(path.basename(target)))
+            out.push(target);
+        return;
+    }
+    for (const entry of fs.readdirSync(target, { withFileTypes: true })) {
+        if (entry.isDirectory() && SKIP_DIRS.has(entry.name))
+            continue;
+        collect(path.join(target, entry.name), out);
+    }
+}
+function resolveProfile(opt, cwd) {
+    if (opt !== undefined) {
+        if (!DESIGN_PROFILES.includes(opt)) {
+            fail(`Unknown profile "${opt}". Use one of: ${DESIGN_PROFILES.join(', ')}`);
+        }
+        return opt;
+    }
+    const specs = path.join(cwd, '.ai', 'ui_specs.md');
+    const found = fs.existsSync(specs) ? readProfile(fs.readFileSync(specs, 'utf8')) : null;
+    if (found)
+        return found;
+    return fail('No design profile is set. Pass --profile taste-v1|taste-v2, or ask the architect '
+        + 'to fill the Design Profile in .ai/ui_specs.md.');
+}
+export function runDesignCheck(paths, options) {
+    jsonMode = !!options.json;
+    const cwd = process.cwd();
+    const profile = resolveProfile(options.profile, cwd);
+    const files = [];
+    for (const p of paths && paths.length ? paths : ['src']) {
+        const abs = path.resolve(cwd, p);
+        if (!fs.existsSync(abs))
+            fail(`Path not found: ${p}`);
+        collect(abs, files);
+    }
+    const findings = [];
+    for (const abs of files) {
+        const file = path.relative(cwd, abs).split(path.sep).join('/');
+        const text = fs.readFileSync(abs, 'utf8');
+        for (const f of checkText(text, path.extname(abs), profile))
+            findings.push({ file, ...f });
+    }
+    const errors = findings.filter((f) => f.severity === 'error').length;
+    const warnings = findings.length - errors;
+    if (options.json) {
+        const out = { profile, filesScanned: files.length, findings, errors, warnings };
+        console.log(JSON.stringify(out, null, 2));
+    }
+    else {
+        for (const f of findings) {
+            console.log(`${f.file}:${f.line}:${f.column}  ${f.rule}  ${f.message}`);
+        }
+        console.log(`${files.length} files scanned (${profile}): ${errors} errors, ${warnings} warnings`);
+    }
+    process.exit(errors > 0 ? 1 : 0);
+}

package/dist/commands/init.d.ts

@@ -1,3 +1,4 @@
 export declare function runInit(targetDirArg?: string, options?: {
     force?: boolean;
+    design?: string;
 }): Promise<void>;

package/dist/commands/init.js

@@ -1,11 +1,13 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { createHash } from 'node:crypto';
 import pc from 'picocolors';
 import { detectProject } from '../scanner/detector.js';
 import { buildContextContent } from '../scanner/context-builder.js';
 import { runSetup, printSetupResult } from './setup.js';
 import { stampManaged } from '../core/setup-assets.js';
+import { DESIGN_PROFILES } from '../core/design-rules.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 function getTemplatesDir() {
@@ -16,7 +18,55 @@ function getTemplatesDir() {
     // Fallback for direct development: src/../templates
     return path.resolve(__dirname, '../templates');
 }
+// Sets the Profile line, and the Digest line for taste profiles, in the ui_specs template.
+function applyDesignProfile(spec, profile) {
+    let out = spec.replace(/^(- \*\*Profile:\*\*).*$/m, `$1 ${profile}`);
+    if (profile.startsWith('taste-')) {
+        const digest = `.ai/design/taste/${profile.slice('taste-'.length)}/DIGEST.md`;
+        out = out.replace(/^(- \*\*Digest:\*\*).*$/m, `$1 ${digest}`);
+    }
+    return out;
+}
+function listBundle(dir, base = dir, out = []) {
+    if (!fs.existsSync(dir))
+        return out;
+    for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, e.name);
+        if (e.isDirectory())
+            listBundle(full, base, out);
+        else
+            out.push(path.relative(base, full));
+    }
+    return out;
+}
+function installTasteBundle(templatesDir, aiDir, force) {
+    const src = path.join(templatesDir, 'design', 'taste');
+    const manifestPath = path.join(aiDir, 'design', 'taste', '.manifest.json');
+    let manifest = {};
+    try {
+        manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    }
+    catch { /* none yet */ }
+    for (const rel of listBundle(src)) {
+        const dest = path.join(aiDir, 'design', 'taste', rel);
+        if (fs.existsSync(dest) && !force)
+            continue;
+        fs.mkdirSync(path.dirname(dest), { recursive: true });
+        fs.copyFileSync(path.join(src, rel), dest);
+        const text = fs.readFileSync(dest, 'utf8').replace(/\r/g, '');
+        manifest[rel.split(path.sep).join('/')] = createHash('sha256').update(text).digest('hex');
+    }
+    fs.mkdirSync(path.dirname(manifestPath), { recursive: true });
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n', 'utf8');
+    console.log(pc.green('✔ Installed design bundle .ai/design/taste/'));
+}
 export async function runInit(targetDirArg, options = {}) {
+    if (options.design !== undefined && !DESIGN_PROFILES.includes(options.design)) {
+        const list = DESIGN_PROFILES.join(', ');
+        console.error(pc.red(`✖ Unknown design profile "${options.design}". Use one of: ${list}`));
+        process.exitCode = 1;
+        return;
+    }
     const targetDir = path.resolve(targetDirArg || process.cwd());
     const templatesDir = getTemplatesDir();
     console.log(pc.bold(pc.cyan('\nNativ: Initializing Multi-Tier Pipeline...')));
@@ -81,9 +131,11 @@ export async function runInit(targetDirArg, options = {}) {
     const uiTemplate = fs.readFileSync(path.join(templatesDir, 'dot-ai/ui_specs.md'), 'utf8');
     const uiPath = path.join(aiDir, 'ui_specs.md');
     if (!fs.existsSync(uiPath) || options.force) {
-        fs.writeFileSync(uiPath, uiTemplate, 'utf8');
+        const uiContent = options.design ? applyDesignProfile(uiTemplate, options.design) : uiTemplate;
+        fs.writeFileSync(uiPath, uiContent, 'utf8');
         console.log(pc.green('✔ Created .ai/ui_specs.md'));
     }
+    installTasteBundle(templatesDir, aiDir, options.force);
     // 7. Write .ai/master_plan.json
     const planTemplate = fs.readFileSync(path.join(templatesDir, 'dot-ai/master_plan.json'), 'utf8');
     const planContent = planTemplate

package/dist/commands/update.js

@@ -1,10 +1,54 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { createHash } from 'node:crypto';
 import pc from 'picocolors';
 import { detectProject } from '../scanner/detector.js';
 import { applySetup, getTemplatesDir, planTemplateFile } from '../core/setup-assets.js';
 import { printSetupResult } from './setup.js';
 import { runValidate } from './validate.js';
+const noCr = (text) => text.replace(/\r/g, '');
+function walkFiles(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    return fs.readdirSync(dir, { withFileTypes: true })
+        .flatMap((e) => (e.isDirectory() ? walkFiles(path.join(dir, e.name)) : [path.join(dir, e.name)]));
+}
+// Plain copies (no stamp) so doctor can compare them; edited files are kept unless forced.
+function syncTasteBundle(templatesDir, aiDir, force) {
+    const src = path.join(templatesDir, 'design', 'taste');
+    let kept = 0;
+    const manifestPath = path.join(aiDir, 'design', 'taste', '.manifest.json');
+    let manifest = {};
+    try {
+        manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    }
+    catch { /* installed before manifests */ }
+    const hash = (t) => createHash('sha256').update(noCr(t)).digest('hex');
+    for (const file of walkFiles(src)) {
+        const rel = path.relative(src, file).split(path.sep).join('/');
+        const dest = path.join(aiDir, 'design', 'taste', ...rel.split('/'));
+        const text = fs.readFileSync(file, 'utf8');
+        const existing = fs.existsSync(dest) ? fs.readFileSync(dest, 'utf8') : null;
+        const shown = `.ai/design/taste/${rel}`;
+        if (existing !== null && noCr(existing) === noCr(text)) {
+            printChange({ path: shown, action: 'unchanged' });
+            manifest[rel] ??= hash(text);
+        }
+        else if (existing !== null && !force && manifest[rel] !== hash(existing)) {
+            kept++;
+            printChange({ path: shown, action: 'skipped', detail: 'differs from the template' });
+        }
+        else {
+            fs.mkdirSync(path.dirname(dest), { recursive: true });
+            fs.writeFileSync(dest, text, 'utf8');
+            manifest[rel] = hash(text);
+            printChange({ path: shown, action: existing === null ? 'created' : 'updated' });
+        }
+    }
+    fs.mkdirSync(path.dirname(manifestPath), { recursive: true });
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n', 'utf8');
+    return kept;
+}
 const ICON = { created: '+', updated: '~', unchanged: '=', skipped: '!' };
 function printChange(change) {
     const paint = change.action === 'created' ? pc.green : change.action === 'updated' ? pc.cyan : change.action === 'skipped' ? pc.yellow : pc.dim;
@@ -62,6 +106,8 @@ export async function runUpdate(targetDirArg, options = {}) {
             kept++;
         printChange({ path: item.rel, action: plan.action, detail: plan.detail });
     }
+    console.log(pc.bold('\nDesign bundle'));
+    kept += syncTasteBundle(templatesDir, aiDir, options.force);
     // 2. Everything `nativ setup` manages: AGENTS.md, .claude/agents/, settings, MCP server
     console.log(pc.bold('\nClaude Code configuration'));
     const setup = applySetup(targetDir, { force: options.force });

package/dist/core/design-rules.d.ts

@@ -0,0 +1,23 @@
+export declare const DESIGN_PROFILES: readonly ["taste-v1", "taste-v2"];
+export type DesignProfile = (typeof DESIGN_PROFILES)[number];
+export interface DesignFinding {
+    line: number;
+    column: number;
+    rule: string;
+    severity: 'error' | 'warning';
+    message: string;
+}
+interface Rule {
+    id: string;
+    profiles: readonly DesignProfile[];
+    severity: 'error' | 'warning';
+    message: string;
+    pattern?: RegExp;
+    exts?: readonly string[];
+}
+export declare const DESIGN_RULES: readonly Rule[];
+export declare const SCAN_EXTENSIONS: string[];
+export declare function readProfile(uiSpecsText: string): DesignProfile | null;
+export declare function isCommentLine(line: string): boolean;
+export declare function checkText(text: string, ext: string, profile: DesignProfile): DesignFinding[];
+export {};

package/dist/core/design-rules.js

@@ -0,0 +1,115 @@
+export const DESIGN_PROFILES = ['taste-v1', 'taste-v2'];
+const TASTE = ['taste-v1', 'taste-v2'];
+export const DESIGN_RULES = [
+    {
+        id: 'no-emoji', profiles: DESIGN_PROFILES, severity: 'error',
+        message: 'Emoji found; use an icon from the catalog',
+        pattern: /\p{Extended_Pictographic}/gu,
+    },
+    {
+        id: 'no-em-dash', profiles: ['taste-v2'], severity: 'error',
+        message: 'Em or en dash found; use a comma, colon or hyphen',
+        pattern: /[–—]/g,
+    },
+    {
+        id: 'no-h-screen', profiles: TASTE, severity: 'error',
+        message: 'h-screen found; use min-h-[100dvh]',
+        pattern: /(?<![\w-])h-screen(?![\w-])/g,
+    },
+    {
+        id: 'no-scroll-listener', profiles: TASTE, severity: 'error',
+        message: 'Scroll listener found; use IntersectionObserver or CSS',
+        pattern: /addEventListener\(\s*['"`]scroll['"`]/g,
+    },
+    {
+        id: 'no-pure-black', profiles: TASTE, severity: 'warning',
+        message: 'Pure black found; use an off-black token',
+        pattern: /#000(?:000)?(?![0-9a-fA-F])|rgba?\(\s*0\s*,\s*0\s*,\s*0\s*[,)]/g,
+    },
+    {
+        id: 'no-google-fonts-link', profiles: ['taste-v2'], severity: 'warning',
+        message: 'Google Fonts link found; self-host the font',
+        pattern: /fonts\.googleapis\.com/g,
+    },
+    {
+        id: 'no-custom-cursor', profiles: TASTE, severity: 'warning',
+        message: 'Custom cursor found',
+        pattern: /cursor:\s*url\(|cursor-\[url/g,
+    },
+    {
+        id: 'no-hand-rolled-icon', profiles: TASTE, severity: 'warning',
+        message: 'Inline svg with a path; use an icon from the catalog',
+        exts: ['.tsx', '.jsx'],
+    },
+];
+export const SCAN_EXTENSIONS = [
+    '.tsx', '.jsx', '.ts', '.js', '.html', '.vue', '.svelte', '.astro', '.mdx', '.css',
+];
+const PROFILE_LINE = /^- \*\*Profile:\*\*\s*(taste-v1|taste-v2)\s*$/m;
+export function readProfile(uiSpecsText) {
+    const m = PROFILE_LINE.exec(uiSpecsText);
+    return m ? m[1] : null;
+}
+export function isCommentLine(line) {
+    const t = line.trim();
+    return ['//', '/*', '*', '{/*', '<!--'].some((p) => t.startsWith(p));
+}
+function active(profile, ext) {
+    return DESIGN_RULES.filter((r) => r.profiles.includes(profile) && (!r.exts || r.exts.includes(ext)));
+}
+function lineStarts(text) {
+    const starts = [0];
+    for (let i = 0; i < text.length; i++)
+        if (text[i] === '\n')
+            starts.push(i + 1);
+    return starts;
+}
+function locate(starts, index) {
+    let lo = 0;
+    let hi = starts.length - 1;
+    while (lo < hi) {
+        const mid = (lo + hi + 1) >> 1;
+        if (starts[mid] <= index)
+            lo = mid;
+        else
+            hi = mid - 1;
+    }
+    return { line: lo + 1, column: index - starts[lo] + 1 };
+}
+function svgFindings(text, rule, starts, lines) {
+    const out = [];
+    const re = /<svg\b/g;
+    let m;
+    while ((m = re.exec(text))) {
+        const end = text.indexOf('</svg>', m.index);
+        const body = text.slice(m.index, end === -1 ? text.length : end);
+        const pos = locate(starts, m.index);
+        if (/<path\b/.test(body) && !isCommentLine(lines[pos.line - 1])) {
+            out.push({ ...pos, rule: rule.id, severity: rule.severity, message: rule.message });
+        }
+    }
+    return out;
+}
+export function checkText(text, ext, profile) {
+    const rules = active(profile, ext);
+    const lines = text.split('\n');
+    const starts = lineStarts(text);
+    const found = [];
+    for (const rule of rules) {
+        if (!rule.pattern) {
+            found.push(...svgFindings(text, rule, starts, lines));
+            continue;
+        }
+        lines.forEach((line, i) => {
+            if (isCommentLine(line))
+                return;
+            for (const m of line.matchAll(rule.pattern)) {
+                found.push({
+                    line: i + 1, column: (m.index ?? 0) + 1,
+                    rule: rule.id, severity: rule.severity, message: rule.message,
+                });
+            }
+        });
+    }
+    return found.sort((a, b) => a.line - b.line || a.column - b.column);
+}

package/dist/core/harness-integrity.js

@@ -169,18 +169,37 @@ function checkLearnings(root) {
     }
     return findings;
 }
-function checkUiSpecs(root) {
-    const specs = readText(path.join(root, '.ai', 'ui_specs.md'));
-    if (specs === null || /Marketing pages/i.test(specs))
+function checkDesignProfile(specs) {
+    if (specs === null || /^##\s+Design Profile\b/m.test(specs))
         return [];
     return [{
-            id: 'specs:marketing',
+            id: 'specs:design-profile',
             status: 'info',
             category: 'specs',
-            message: '.ai/ui_specs.md predates the Marketing pages checks. Ask the architect to add that part '
-                + 'of the Anti-Generic Checklist from the current nativ template.',
+            message: '.ai/ui_specs.md has no Design Profile section. Ask the architect to add it from the '
+                + 'current nativ template (templates/dot-ai/ui_specs.md).',
         }];
 }
+function checkTasteBundle(root, templatesDir) {
+    const mk = (message) => [{ id: 'design:taste-bundle', status: 'info', category: 'specs', message }];
+    const dir = path.join(root, '.ai', 'design', 'taste');
+    if (!fs.existsSync(dir)) {
+        return mk('The design bundle .ai/design/taste/ is missing. Run `nativ update` to install it.');
+    }
+    const differs = ['LICENSE', 'v1/SKILL.md', 'v2/SKILL.md'].filter((rel) => {
+        const want = readText(path.join(templatesDir, 'design', 'taste', rel));
+        const have = readText(path.join(dir, rel));
+        return want !== null && (have === null || have.replace(/\r/g, '') !== want.replace(/\r/g, ''));
+    });
+    if (!differs.length)
+        return [];
+    return mk(`Design bundle files differ from the nativ package: ${differs.join(', ')}. `
+        + 'Run `nativ update` (or `nativ update --force` to replace edited ones).');
+}
+function checkUiSpecs(root, templatesDir) {
+    const specs = readText(path.join(root, '.ai', 'ui_specs.md'));
+    return [...checkDesignProfile(specs), ...checkTasteBundle(root, templatesDir)];
+}
 export function checkHarnessIntegrity(root, options = {}) {
     const findings = [
         ...checkGuardrailOverrides(root),
@@ -188,7 +207,7 @@ export function checkHarnessIntegrity(root, options = {}) {
         ...checkMissingRoleGuides(root),
         ...checkEditedRoleGuides(root, options.templatesDir ?? getTemplatesDir()),
         ...checkLearnings(root),
-        ...checkUiSpecs(root),
+        ...checkUiSpecs(root, options.templatesDir ?? getTemplatesDir()),
     ];
     if (!findings.some((f) => f.category === 'guardrail' || f.category === 'secret')) {
         const message = 'No guardrail overrides and no secrets in files agents read';

package/dist/core/setup/pm-playbook.d.ts

@@ -2,4 +2,4 @@
  * The project manager's playbook. The SessionStart hook prints it into the main session only:
  * subagents load CLAUDE.md and AGENTS.md on every turn, so anything kept there is paid for by every worker.
  */
-export declare const PM_PLAYBOOK = "## Working as Project Manager\n\n- Start each session with `nativ task next --json` (or the `nativ_task_next` MCP tool).\n- Delegate, do not implement. Hand each task to the `worker` agent by task id, passing the task's `recommendedModel` (haiku, sonnet or opus) as the Agent tool's `model`; with none, the worker's default applies. Ask the `verifier` agent for an independent check before you mark a milestone done. Ask the `architect` agent for anything that changes a contract.\n- Before the architect designs on existing code, run the `explorer` when `.ai/codebase_map.md` is missing or its commit is well behind `HEAD`, and pass its report to the architect. Give the explorer the current commit (`git rev-parse --short HEAD`); it cannot look it up. Pass `model: haiku` for a single lookup such as \"where is the auth middleware?\".\n- Keep usage low. Run this session on Sonnet. Agent defaults: architect Opus, worker Sonnet, verifier Haiku. Pass `haiku` for mechanical tasks (wording, docs, renames) and `sonnet` for the verifier at the end of a milestone. Never pass a model the human did not choose.\n- Independent tasks can run in parallel in worktrees (`nativ worktree create <taskId>`). On a Claude subscription every agent draws from the same usage limit, so run two or three at a time, not ten.\n- You may not edit `.ai/`. If the enforcement hook warns about a file, that is a scope or contract gap: escalate with `nativ task escalate`, do not edit around it.\n- `nativ doctor` confirms the integration is intact. Run it after updating Claude Code or nativ, and whenever hooks or MCP tools seem to be missing.\n\n## Autonomous execution\n\nWhen told to run autonomously (\"run the queue\", \"execute milestone\", AFK mode):\n1. `nativ_task_next`, then `nativ_task_start`.\n2. Delegate to the `worker` agent with the task id and recommended model.\n3. The worker completes the task itself; `nativ task complete` already ran the check. Do not run `nativ_verify` or `nativ_task_complete` again for it.\n4. Loop to the next task immediately, without asking the human.\n5. Stop only when the milestone is done (ask the `verifier` for a milestone check, then tell the human) or when a task is blocked or escalated (present the four-part summary).\n\n## Talking to the human\n\nThe human is the product owner, not a log reader. For a blocker, trade-off or escalation use four parts in plain words: what the user would see; why it happens, as simple cause and effect; what is affected and what is safe; two or three options with the best marked `(Recommended)`, then one direct question. Say \"the app tried to link a record to an item that does not exist yet\", not \"foreign key constraint violation\". Never paste stack traces; put raw output in a collapsed `<details>` block.";
+export declare const PM_PLAYBOOK = "## Working as Project Manager\n\n- Start each session with `nativ task next --json` (or the `nativ_task_next` MCP tool).\n- Delegate, do not implement. Hand each task to the `worker` agent by task id, passing the task's `recommendedModel` (haiku, sonnet or opus) as the Agent tool's `model`; with none, the worker's default applies. Ask the `verifier` agent for an independent check before you mark a milestone done. Ask the `architect` agent for anything that changes a contract.\n- Before the architect designs on existing code, run the `explorer` when `.ai/codebase_map.md` is missing or its commit is well behind `HEAD`, and pass its report to the architect. Give the explorer the current commit (`git rev-parse --short HEAD`); it cannot look it up. Pass `model: haiku` for a single lookup such as \"where is the auth middleware?\".\n- Keep usage low. Run this session on Sonnet. Agent defaults: architect Opus, worker Sonnet, verifier Haiku. Pass `haiku` for mechanical tasks (wording, docs, renames) and `sonnet` for the verifier at the end of a milestone. Never pass a model the human did not choose.\n- Independent tasks can run in parallel in worktrees (`nativ worktree create <taskId>`). On a Claude subscription every agent draws from the same usage limit, so run two or three at a time, not ten.\n- You may not edit `.ai/`. If the enforcement hook warns about a file, that is a scope or contract gap: escalate with `nativ task escalate`, do not edit around it.\n- `nativ doctor` confirms the integration is intact. Run it after updating Claude Code or nativ, and whenever hooks or MCP tools seem to be missing.\n\n## Autonomous execution\n\nWhen told to run autonomously (\"run the queue\", \"execute milestone\", AFK mode):\n1. `nativ_task_next`, then `nativ_task_start`.\n2. Delegate to the `worker` agent with the task id and recommended model.\n3. The worker completes the task itself; `nativ task complete` already ran the check. Do not run `nativ_verify` or `nativ_task_complete` again for it.\n4. Loop to the next task immediately, without asking the human.\n5. Stop only when the milestone is done (ask the `verifier` for a milestone check, then tell the human) or when a task is blocked or escalated (present the four-part summary).\n\n## Talking to the human\n\nThe human is the product owner, not a log reader. For a blocker, trade-off or escalation use four parts in plain words: what the user would see; why it happens, as simple cause and effect; what is affected and what is safe; two or three options with the best marked `(Recommended)`, plus one line on when the other option would be the better choice, then one direct question. Say \"the app tried to link a record to an item that does not exist yet\", not \"foreign key constraint violation\". Never paste stack traces; put raw output in a collapsed `<details>` block.";

package/dist/core/setup/pm-playbook.js

@@ -23,4 +23,4 @@ When told to run autonomously ("run the queue", "execute milestone", AFK mode):
 
 ## Talking to the human
 
-The human is the product owner, not a log reader. For a blocker, trade-off or escalation use four parts in plain words: what the user would see; why it happens, as simple cause and effect; what is affected and what is safe; two or three options with the best marked \`(Recommended)\`, then one direct question. Say "the app tried to link a record to an item that does not exist yet", not "foreign key constraint violation". Never paste stack traces; put raw output in a collapsed \`<details>\` block.`;
+The human is the product owner, not a log reader. For a blocker, trade-off or escalation use four parts in plain words: what the user would see; why it happens, as simple cause and effect; what is affected and what is safe; two or three options with the best marked \`(Recommended)\`, plus one line on when the other option would be the better choice, then one direct question. Say "the app tried to link a record to an item that does not exist yet", not "foreign key constraint violation". Never paste stack traces; put raw output in a collapsed \`<details>\` block.`;

package/dist/index.js

@@ -18,6 +18,7 @@ import { runTriage } from './commands/triage.js';
 import { runNotifyTest } from './commands/notify.js';
 import { runLearnPropose, runLearnDecide, runLearnList } from './commands/learn.js';
 import { runProfileCommand } from './commands/profile.js';
+import { runDesignCheck } from './commands/design-check.js';
 import { packageVersion } from './core/version.js';
 export function createProgram() {
     const program = new Command();
@@ -29,6 +30,7 @@ export function createProgram() {
         .command('init [targetDir]')
         .description('Scaffold the workflow (.ai/, AGENTS.md, directives) and the Claude Code configuration in the target directory')
         .option('-f, --force', 'Overwrite existing specification and directive files')
+        .option('--design <profile>', 'Design profile: nativ, taste-v1 or taste-v2')
         .action(async (targetDir, options) => {
         await runInit(targetDir, options);
     });
@@ -239,6 +241,15 @@ export function createProgram() {
         .action(async (taskId, targetDir, options) => {
         await runTaskUnlock(taskId, targetDir, { reason: options.reason, revoke: options.revoke });
     });
+    const design = program.command('design').description('Design profile tools');
+    design
+        .command('check [paths...]')
+        .description('Scan source files for design-rule violations (default path: src)')
+        .option('--profile <id>', 'Design profile: nativ, taste-v1 or taste-v2')
+        .option('--json', 'Output findings as JSON')
+        .action((paths, options) => {
+        runDesignCheck(paths, options);
+    });
     const learn = program
         .command('learn')
         .description('Project lessons the contracts do not capture: agents propose, a human approves');