@ryuenn3123/agentic-senior-core 6.16.1 → 6.16.2

package/.agents/plugins/agentic-senior-core/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-senior-core",
-  "version": "6.16.1",
+  "version": "6.16.2",
   "description": "Universal AI coding rules. Write code like a staff engineer.",
   "skills": "./skills/",
   "hooks": "./hooks/hooks.json",

package/.agents/plugins/agentic-senior-core/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-senior-core",
-  "version": "6.16.1",
+  "version": "6.16.2",
   "description": "Universal AI coding rules. Because your AI writes code like it gets paid by the line.",
   "contextFileName": "rules/agentic-senior-core.md",
   "rules": [

package/.agents/plugins/agentic-senior-core/skills/asc-ui/SKILL.md

@@ -76,8 +76,10 @@ Visual posture is governed by the surface type, not product branding. Every surf
 
 ## 4. Scope Classification: Refine vs. Redesign
 
-- **Refinement:** Preserves layout structure, component APIs, DOM hierarchy, and color tokens. Polishes padding rhythm, contrast, microcopy, and state completeness.
-- **Redesign:** Replaces the visual hierarchy, typographic pairing, and surface mode while strictly preserving data bindings, event handlers, and business logic.
+Never split the difference into cosmetic polish on a discarded look:
+- **Polish / Refinement:** Preserves layout structure, DOM hierarchy, and design tokens. Resolves contrast, missing state quad, microcopy, and lint issues.
+- **Restyle:** Preserves layout geometry. Replaces color tokens, typographic scales, corner radiuses, and elevation shadows.
+- **Full Redesign:** Replaces entire spatial geometry and posture. Mandatory decoupled protocol: extract data/contracts first, discard old DOM, author standalone preview (`asc preview <path>`), build fresh geometry, re-bind dynamic data.
 
 ---
 

package/.agents/plugins/agentic-senior-core/skills/asc-ui/references/craft/color-surfaces.md

@@ -25,6 +25,9 @@ Grounded in: Apple HIG, Google Material Design 3, and Refactoring UI Color Strat
   - The dedicated brand accent hue.
   - **Accent Exclusivity:** Accent color is reserved strictly for interactive affordances: Primary CTA button, active navigation indicator, unread dot, selected checkbox.
   - **Forbidden:** Never use the accent color as background wallpaper, card borders, or decorative section dividers.
+- **Full-Field Grounding (Anti-Sterile Surface):**
+  - To prevent the "sterile white void" trap, at least one major functional region (the Hero Stage, the Signature Canvas, or the Master Header) must own a deep, purposeful surface field (e.g. deep midnight grounding, rich brand tint, or dark canvas container).
+  - This establishes an optical center of gravity, preventing the page from looking like an unstyled wireframe.
 
 ---
 

package/.agents/plugins/agentic-senior-core/skills/asc-ui/references/craft/typography.md

@@ -13,6 +13,11 @@ Grounded in: Refactoring UI, Bringhurst's The Elements of Typographic Style, and
 - **Weight Contrast Before Size Inflation:**
   - Build strong typographic hierarchy by varying font weights (`font-bold` vs `font-normal`) and contrast tokens (`text-foreground` vs `text-muted-foreground`) before jumping to oversized font sizes.
   - A clean 24px `font-bold` title paired with a 14px `text-muted-foreground` subtitle establishes clearer hierarchy than inflating the title to 48px with identical gray values.
+- **The Generative Scale Contrast Floor ($Display \ge 3.5\times Body$):**
+  - On landing, marketing, and hero surfaces (`Persuade`), the primary headline must establish an optical scale step over body text:
+    - Target: $Display \ge 3.5\times Body$ (e.g. `text-5xl` to `text-7xl` [48px–72px] display vs `text-base` [16px] or `text-sm` [14px] body).
+    - Heading leading must be tight: `leading-[1.05]` to `leading-tight`.
+    - An under-scaled heading ($< 2.5\times$ body, such as 24px H1) collapses optical gravity and makes marketing pages look like internal memo forms.
 
 ---
 

package/.agents/plugins/agentic-senior-core/skills/asc-ui/references/modes/persuade.md

@@ -43,6 +43,33 @@ When building or redesigning a Persuade surface, never let the LLM default to th
   - If technical documentation, whitepaper, or architectural manifesto $\to$ **Posture 2 (The Monolith Ledger)**.
   - If performance benchmarks, protocol comparisons, or telemetry proof $\to$ **Posture 4 (Kinetic Proof Stream)**.
 
+### Structural Blueprints (Enforced DOM Geometries)
+
+#### Posture 1: Asymmetric Stage (65/35 Split)
+- **Container:** `grid grid-cols-1 lg:grid-cols-12 gap-12 items-center`
+- **Left Lead (7 cols):** `lg:col-span-7 space-y-6 text-left`
+  - Display headline: `text-5xl lg:text-7xl font-bold tracking-tight leading-[1.05]`
+  - Subtitle: `text-lg text-muted-foreground max-w-xl`
+  - Actions: `flex flex-wrap items-center gap-4 pt-2`
+- **Right Artifact (5 cols):** `lg:col-span-5`
+  - Authentic artifact, interactive widget, or live ROI card: `rounded-2xl border border-border/80 bg-card p-6 shadow-sm`
+  - Zero equal-weight card grids below.
+
+#### Posture 2: The Monolith Ledger
+- **Container:** `max-w-4xl mx-auto px-6 py-16 divide-y divide-border/60`
+- **Tabular Rows:** Each entity or program is a horizontal row: `py-8 grid grid-cols-1 md:grid-cols-12 gap-6 items-baseline`
+  - Category / Date: `md:col-span-3 text-xs font-semibold tracking-wider uppercase text-muted-foreground`
+  - Heading & Data: `md:col-span-5 text-xl font-bold text-foreground`
+  - Detail & Action: `md:col-span-4 text-sm text-muted-foreground`
+
+#### Posture 3: Product-Led Canvas
+- **Container:** `flex flex-col items-center text-center max-w-6xl mx-auto px-6 pt-16 pb-20`
+- **Compact Hero Frame:** `max-w-2xl space-y-4 mb-10`
+  - Headline: `text-4xl sm:text-6xl font-extrabold tracking-tight`
+  - 1-sentence value claim + 1 primary action.
+- **Hero Canvas (70% Viewport Lead):** `w-full rounded-2xl border border-border/80 bg-slate-950 p-2 shadow-2xl`
+  - Real interface fragment or live demo canvas dominating the first viewport.
+
 ---
 
 ## 3. Anti-Cardocalypse & Visual Pacing

package/.agents/plugins/agentic-senior-core/skills/asc-ui/references/redesign-audit.md

@@ -4,21 +4,44 @@ Modifying an existing interface requires clear intent. Audits must provide actio
 
 ---
 
-## 1. Refinement vs. Redesign Semantics
+## 1. Scope Classification: The 3 Redesign Depths
 
-Before touching code, explicitly classify the scope of work:
+Never split the difference into cosmetic polish on a discarded look. Before touching code, explicitly classify the depth of work:
 
-| Mode | Objective | What Stays Intact | What Changes |
+| Depth | Scope & Intent | What Stays Intact | What Changes |
 |---|---|---|---|
-| **Refinement** | Polish craft, fix accessibility, eliminate slop, align spacing. | Layout structure, component APIs, color tokens, DOM tree, established brand identity. | Padding rhythm, contrast ratios, missing hover/focus rings, microcopy concision, state quad completeness. |
-| **Redesign** | Overhaul visual hierarchy, modernize surface mode, eliminate fundamental architectural flaws. | Functional data bindings, event handlers, business rules, routing. | Visual posture, typography system, component composition, spatial elevation, color distribution. |
+| **`polish`** | Resolve bugs, contrast, microcopy, states. | Layout structure, DOM hierarchy, and design system tokens. | Padding rhythm, WCAG AA contrast, missing state quad (empty/error/loading), focus rings, microcopy brevity, lint fixes. |
+| **`restyle`** | Upgrade design system without breaking layout. | Layout grid, component hierarchy, and DOM structure. | Color palette (60-30-10), typographic scale, corner radiuses, elevation shadows, button and input styles. |
+| **`full`** | Total visual and structural overhaul. | Factual content, data bindings (`$variables`, loops), routes, form handlers. | **Spatial geometry, grid ratios, surface posture, and typography.** Treated as fresh build from subject truth. |
 
-> [!WARNING]
-> Never perform an unprompted redesign when asked to "fix", "clean up", or "refine" a component. Respect existing design tokens and architectural patterns unless the user explicitly mandates a redesign.
+---
+
+## 2. The Decoupled Redesign Protocol (For Full Redesigns)
+
+When executing a **Full Redesign** on an existing template or page (`.blade.php`, `.tsx`, `.vue`, `.html`), editing in-place is forbidden because the AI's attention mechanism will anchor to the old DOM structure. Execute this 4-step decoupled sequence:
+
+1. **Step 1: Extract Data Contracts & Factual Inventory**
+   - Parse the incumbent file and extract all dynamic variables, loops, route helpers, form submission endpoints, and real text/assets into a clean data list.
+   - Separate product truth (names, prices, verified claims) from discarded markup.
+2. **Step 2: Isolate / Discard Old Markup**
+   - Treat the old layout as an anti-reference. Do not perform incremental class swapping on it.
+3. **Step 3: Author Standalone HTML Prototype & Preview**
+   - Create an ephemeral standalone prototype in the brain directory: `<appDataDir>/brain/<id>/preview.html`.
+   - Select 1 of the 4 Structural Postures (`references/modes/persuade.md` or `operate.md`).
+   - Use Tailwind via CDN and realistic sample data.
+   - Run zero-dependency visual capture:
+     ```bash
+     asc preview <path_to_preview.html>
+     ```
+     Inspect the captured image at `%TEMP%/asc-preview-active.png` (or pass `--open` to view in OS browser). Verify typographic scale ($Display \ge 3.5\times Body$) and full-field grounding.
+4. **Step 4: Re-inject Data Contracts into Production**
+   - Transfer the proven clean geometry into the project file (`welcome.blade.php`, `Page.tsx`).
+   - Re-bind the dynamic data loops, Blade/React variables, and event handlers.
+   - Confirm project test suite and linters pass cleanly.
 
 ---
 
-## 2. Structured Audit Matrix
+## 3. Structured Audit Matrix
 
 When auditing an existing interface or PR, generate a structured findings table categorized by severity:
 
@@ -41,29 +64,29 @@ When auditing an existing interface or PR, generate a structured findings table
 
 ---
 
-## 3. Systematic Audit Checklist
+## 4. Systematic Audit Checklist
 
 Audit screens systematically against four engineering vectors:
 
-### 3.1 Ergonomics & Responsiveness
+### 4.1 Ergonomics & Responsiveness
 - [ ] Render at `375px` width (mobile viewport) and `1280px` (desktop viewport).
 - [ ] Verify zero horizontal scrollbars on mobile (`overflow-x: clip`).
 - [ ] Confirm all touch targets meet minimum $44 \times 44\text{px}$ bounding box.
 - [ ] Verify mobile layout uses `dvh` instead of `vh` to prevent browser chrome clipping.
 
-### 3.2 Accessibility & Contrast (WCAG 2.2 AA)
+### 4.2 Accessibility & Contrast (WCAG 2.2 AA)
 - [ ] Check normal text against backgrounds ($\ge 4.5:1$).
 - [ ] Check input borders, active toggles, and large headings ($\ge 3:1$).
 - [ ] Cycle through entire screen using `Tab` and `Shift+Tab` with mouse disconnected.
 - [ ] Press `Escape` while dialog/modal is open; verify closure and focus restoration.
 
-### 3.3 State Quad Coverage
+### 4.3 State Quad Coverage
 - [ ] Inspect loading state: does it use proportional skeletons matching final dimensions?
 - [ ] Inspect empty state: is it actionable with a 1-sentence explanation?
 - [ ] Inspect error state: does it diagnose the issue and provide an inline retry button?
 - [ ] Inspect mutation triggers: do buttons lock and display spinners during network latency?
 
-### 3.4 Microcopy & Token Hygiene
+### 4.4 Microcopy & Token Hygiene
 - [ ] Run 50% word reduction sweep across headings and explanatory paragraphs.
 - [ ] Confirm all buttons follow `Verb + Noun` grammar.
 - [ ] Verify zero banned buzzwords (*seamless*, *empower*, *robust*).

package/bin/agentic-senior-core.js

@@ -36,6 +36,7 @@ function printUsage() {
   console.log('  uninstall         Remove ASC adapter files and git hooks from this project');
   console.log('  clean             Remove v4 per-project artifacts');
   console.log('  status            Show detected IDEs and install hints');
+  console.log('  preview           Render zero-dependency multi-browser snapshot or preview');
   console.log('  --version         Show version');
   console.log('  --help            Show this help');
 }
@@ -90,6 +91,12 @@ async function main() {
     return;
   }
 
+  if (commandArgument === 'preview') {
+    const { runPreviewCommand } = await import('../lib/cli/commands/preview.mjs');
+    await runPreviewCommand(commandArguments);
+    return;
+  }
+
   console.error(`Unknown command: ${commandArgument}`);
   printUsage();
   exit(1);

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-senior-core",
-  "version": "6.16.1",
+  "version": "6.16.2",
   "description": "Universal AI coding rules. Write code like a staff engineer.",
   "author": "fatidaprilian",
   "license": "MIT",

package/lib/cli/commands/preview.mjs

@@ -0,0 +1,206 @@
+/**
+ * Zero-dependency Multi-Browser Preview & Headless Snapshot Engine.
+ * Detects installed browsers (Brave, Edge, Chrome, Firefox, Vivaldi, Arc)
+ * and captures a headless snapshot or opens in the OS default browser.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { execSync } from 'node:child_process';
+
+export function getBrowserCandidates() {
+  const platform = process.platform;
+  const candidates = [];
+
+  if (platform === 'win32') {
+    const localAppData = process.env.LOCALAPPDATA || '';
+    const programFiles = process.env['ProgramFiles'] || 'C:\\Program Files';
+    const programFilesX86 = process.env['ProgramFiles(x86)'] || 'C:\\Program Files (x86)';
+
+    candidates.push(
+      {
+        name: 'Brave Browser',
+        family: 'chromium',
+        paths: [
+          path.join(programFiles, 'BraveSoftware', 'Brave-Browser', 'Application', 'brave.exe'),
+          path.join(programFilesX86, 'BraveSoftware', 'Brave-Browser', 'Application', 'brave.exe'),
+          path.join(localAppData, 'BraveSoftware', 'Brave-Browser', 'Application', 'brave.exe'),
+        ]
+      },
+      {
+        name: 'Microsoft Edge',
+        family: 'chromium',
+        paths: [
+          path.join(programFilesX86, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
+          path.join(programFiles, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
+          path.join(localAppData, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
+        ]
+      },
+      {
+        name: 'Google Chrome',
+        family: 'chromium',
+        paths: [
+          path.join(programFiles, 'Google', 'Chrome', 'Application', 'chrome.exe'),
+          path.join(programFilesX86, 'Google', 'Chrome', 'Application', 'chrome.exe'),
+          path.join(localAppData, 'Google', 'Chrome', 'Application', 'chrome.exe'),
+        ]
+      },
+      {
+        name: 'Mozilla Firefox',
+        family: 'firefox',
+        paths: [
+          path.join(programFiles, 'Mozilla Firefox', 'firefox.exe'),
+          path.join(programFilesX86, 'Mozilla Firefox', 'firefox.exe'),
+        ]
+      },
+      {
+        name: 'Vivaldi',
+        family: 'chromium',
+        paths: [
+          path.join(localAppData, 'Vivaldi', 'Application', 'vivaldi.exe'),
+          path.join(programFiles, 'Vivaldi', 'Application', 'vivaldi.exe'),
+        ]
+      },
+      {
+        name: 'Arc',
+        family: 'chromium',
+        paths: [
+          path.join(localAppData, 'Arc', 'Arc.exe'),
+        ]
+      }
+    );
+  } else if (platform === 'darwin') {
+    candidates.push(
+      {
+        name: 'Google Chrome',
+        family: 'chromium',
+        paths: ['/Applications/Google Chrome.app/Contents/MacOS/Google Chrome']
+      },
+      {
+        name: 'Brave Browser',
+        family: 'chromium',
+        paths: ['/Applications/Brave Browser.app/Contents/MacOS/Brave Browser']
+      },
+      {
+        name: 'Microsoft Edge',
+        family: 'chromium',
+        paths: ['/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge']
+      },
+      {
+        name: 'Mozilla Firefox',
+        family: 'firefox',
+        paths: ['/Applications/Firefox.app/Contents/MacOS/firefox']
+      },
+      {
+        name: 'Arc',
+        family: 'chromium',
+        paths: ['/Applications/Arc.app/Contents/MacOS/Arc']
+      }
+    );
+  } else {
+    // Linux
+    candidates.push(
+      { name: 'google-chrome', family: 'chromium', commands: ['google-chrome', 'google-chrome-stable'] },
+      { name: 'chromium', family: 'chromium', commands: ['chromium', 'chromium-browser'] },
+      { name: 'brave', family: 'chromium', commands: ['brave-browser', 'brave'] },
+      { name: 'microsoft-edge', family: 'chromium', commands: ['microsoft-edge', 'microsoft-edge-stable', 'msedge'] },
+      { name: 'firefox', family: 'firefox', commands: ['firefox'] }
+    );
+  }
+
+  return candidates;
+}
+
+export function findBrowserExecutable() {
+  const candidates = getBrowserCandidates();
+
+  for (const candidate of candidates) {
+    if (candidate.paths) {
+      for (const p of candidate.paths) {
+        if (fs.existsSync(p)) {
+          return { name: candidate.name, family: candidate.family, path: p };
+        }
+      }
+    } else if (candidate.commands) {
+      for (const cmd of candidate.commands) {
+        try {
+          const resolved = execSync(`which ${cmd} 2>/dev/null`, { encoding: 'utf8' }).trim();
+          if (resolved) {
+            return { name: candidate.name, family: candidate.family, path: resolved };
+          }
+        } catch {
+          // ignore
+        }
+      }
+    }
+  }
+
+  return null;
+}
+
+export async function runPreviewCommand(args = []) {
+  const targetFile = args.find(a => !a.startsWith('-'));
+  const shouldOpen = args.includes('--open');
+  const width = 1280;
+  const height = 800;
+
+  if (!targetFile) {
+    console.error('Usage: asc preview <html-file> [--open]');
+    process.exit(1);
+  }
+
+  const resolvedHtmlPath = path.resolve(process.cwd(), targetFile);
+  if (!fs.existsSync(resolvedHtmlPath)) {
+    console.error(`File not found: ${resolvedHtmlPath}`);
+    process.exit(1);
+  }
+
+  // Single fixed reusable slot in OS temp directory
+  const tempDir = os.tmpdir();
+  const outputPng = path.join(tempDir, 'asc-preview-active.png');
+
+  // Open in default OS browser if requested
+  if (shouldOpen) {
+    const opener = process.platform === 'win32' ? 'start' : process.platform === 'darwin' ? 'open' : 'xdg-open';
+    try {
+      execSync(`${opener} "" "${resolvedHtmlPath}"`, { stdio: 'ignore' });
+      console.log(`[asc preview] Opened in default browser: ${resolvedHtmlPath}`);
+      return;
+    } catch (err) {
+      console.error(`Failed to open default browser: ${err.message}`);
+    }
+  }
+
+  // Headless snapshot mode
+  const browser = findBrowserExecutable();
+  if (!browser) {
+    console.warn('[asc preview] No supported headless browser detected (Brave, Edge, Chrome, Firefox). Falling back to OS opener.');
+    const opener = process.platform === 'win32' ? 'start' : process.platform === 'darwin' ? 'open' : 'xdg-open';
+    execSync(`${opener} "" "${resolvedHtmlPath}"`, { stdio: 'ignore' });
+    return;
+  }
+
+  try {
+    let command;
+    if (browser.family === 'chromium') {
+      command = `"${browser.path}" --headless --disable-gpu --screenshot="${outputPng}" --window-size=${width},${height} "${resolvedHtmlPath}"`;
+    } else if (browser.family === 'firefox') {
+      command = `"${browser.path}" -headless -screenshot "${outputPng}" -window-size ${width},${height} "${resolvedHtmlPath}"`;
+    }
+
+    execSync(command, { stdio: 'pipe' });
+
+    if (fs.existsSync(outputPng)) {
+      const stat = fs.statSync(outputPng);
+      console.log(`[asc preview] Captured via ${browser.name} (${width}x${height}, ${stat.size} bytes)`);
+      console.log(`Output: ${outputPng}`);
+    } else {
+      throw new Error('Screenshot file was not generated');
+    }
+  } catch (err) {
+    console.warn(`[asc preview] Headless snapshot failed: ${err.message}. Falling back to OS opener.`);
+    const opener = process.platform === 'win32' ? 'start' : process.platform === 'darwin' ? 'open' : 'xdg-open';
+    execSync(`${opener} "" "${resolvedHtmlPath}"`, { stdio: 'ignore' });
+  }
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "6.16.1",
+  "version": "6.16.2",
   "type": "module",
   "description": "Agentic Senior Core: Universal AI coding rules and workflows. Write code like a staff engineer, not a junior.",
   "bin": {

package/plugin.yaml

@@ -1,5 +1,5 @@
 name: agentic-senior-core
-version: 6.16.1
+version: 6.16.2
 description: Universal AI coding rules. Write code like a staff engineer.
 author: fatidaprilian
 provides_hooks: