@ryuenn3123/agentic-senior-core 6.0.0 → 6.2.0

package/.agents/plugins/agentic-senior-core/hooks/lib/known-ui-slop-patterns.json

@@ -0,0 +1,34 @@
+{
+  "patterns": [
+    {
+      "id": "ui-gradient-purple-blue",
+      "regex": "from-purple-[0-9]+\\s+to-blue-[0-9]+|from-indigo-[0-9]+\\s+to-purple-[0-9]+|from-teal-[0-9]+\\s+to-indigo-[0-9]+",
+      "message": "note: 'purple-to-blue gradient' (AI generic style) was flagged, consider continuing with brand-specific colors instead."
+    },
+    {
+      "id": "ui-generic-card-shadcn",
+      "regex": "shadow-lg\\s+rounded-2xl\\s+p-6|shadow-md\\s+rounded-xl\\s+p-4|border\\s+border-gray-200\\s+rounded-xl\\s+shadow-sm",
+      "message": "note: 'generic boilerplate card' (AI default) was flagged, consider continuing with project's existing card component instead."
+    },
+    {
+      "id": "ui-inter-font-unpaired",
+      "regex": "font-family:\\s*['\"]?Inter['\"]?\\s*(?:!important)?;(?!.*sans-serif)|className=[\"'][^\"']*font-sans[^\"']*[\"'](?=.*Inter)",
+      "message": "note: 'unpaired Inter font' (AI default typography) was flagged, consider continuing with the project's design system typography instead."
+    },
+    {
+      "id": "ui-colored-left-border",
+      "regex": "border-l-4\\s+border-(?:blue|purple|indigo)-[0-9]+|border-l-\\[(?:3px|4px)\\]\\s+border-(?:blue|purple|indigo)-[0-9]+",
+      "message": "note: 'colored left-border strip' (AI default alert/card) was flagged, consider continuing with native UI patterns instead."
+    },
+    {
+      "id": "ui-glassmorphism",
+      "regex": "backdrop-blur-(?:md|lg|xl)\\s+bg-white/10|backdrop-filter:\\s*blur\\(|bg-opacity-20\\s+backdrop-blur",
+      "message": "note: 'generic glassmorphism' (AI trend default) was flagged, consider continuing with solid semantic surfaces instead."
+    },
+    {
+      "id": "ui-pill-badge-generic",
+      "regex": "rounded-full\\s+px-4\\s+py-1\\s+text-sm\\s+font-medium\\s+bg-(?:blue|purple|indigo)-100\\s+text-(?:blue|purple|indigo)-800",
+      "message": "note: 'generic pill badge' (AI default tag) was flagged, consider continuing with the project's existing badge component instead."
+    }
+  ]
+}

package/.agents/plugins/agentic-senior-core/hooks/post-edit-enforce.js

@@ -37,6 +37,14 @@ try {
   }
 } catch (_) {}
 
+let UI_SLOP_PATTERNS = { patterns: [] };
+try {
+  const slopPath = path.join(__dirname, 'lib', 'known-ui-slop-patterns.json');
+  if (fs.existsSync(slopPath)) {
+    UI_SLOP_PATTERNS = JSON.parse(fs.readFileSync(slopPath, 'utf8'));
+  }
+} catch (_) {}
+
 const {
   SOURCE_EXTENSIONS,
   LOC_DELTA_THRESHOLD,
@@ -165,6 +173,11 @@ function processSingleEdit(toolName, toolInput, emitFn, skipArray) {
   }
 
   checkSecurityPatterns(toolName, toolInput, filePath, findings);
+  
+  if (ext === 'html' || ext === 'css' || ext === 'jsx' || ext === 'tsx' || ext === 'vue' || ext === 'svelte') {
+    checkUiSlopPatterns(toolName, toolInput, filePath, findings);
+  }
+
   if (ext === 'js' || ext === 'ts' || ext === 'jsx' || ext === 'tsx' || ext === 'mjs' || ext === 'cjs') {
     checkLinter(filePath, findings);
   }
@@ -255,6 +268,13 @@ function checkNewFileSize(toolInput, filePath, findings) {
   }
 }
 
+function logPatternCheck(checkType, patternId, isMatch) {
+  try {
+    var result = isMatch ? 'match' : 'no-match';
+    process.stderr.write('[pattern-check] ' + patternId + ': ' + result + '\n');
+  } catch (_) {}
+}
+
 function checkSecurityPatterns(toolName, toolInput, filePath, findings) {
   var target = toolName === 'Edit' ? (toolInput.new_string || '') : (toolInput.content || '');
   if (!target) return;
@@ -263,7 +283,9 @@ function checkSecurityPatterns(toolName, toolInput, filePath, findings) {
     SECURITY_PATTERNS.patterns.forEach(function (p) {
       try {
         var regex = new RegExp(p.regex, 'ig');
-        if (regex.test(target)) {
+        var isMatch = regex.test(target);
+        logPatternCheck('security', p.id || 'sec-pattern', isMatch);
+        if (isMatch) {
           findings.push('[ASC Security] ' + p.message);
         }
       } catch (_) {}
@@ -275,13 +297,35 @@ function checkSecurityPatterns(toolName, toolInput, filePath, findings) {
     var spec = SECURITY_PATTERNS.fileSpecific[basename];
     try {
       var regex = new RegExp(spec.require, 'g');
-      if (target.trim().length > 0 && !regex.test(target)) {
-        findings.push('[ASC Security] ' + spec.message);
+      if (target.trim().length > 0) {
+        var isMatch = !regex.test(target);
+        logPatternCheck('security', spec.id || 'sec-file-specific', isMatch);
+        if (isMatch) {
+          findings.push('[ASC Security] ' + spec.message);
+        }
       }
     } catch (_) {}
   }
 }
 
+function checkUiSlopPatterns(toolName, toolInput, filePath, findings) {
+  var target = toolName === 'Edit' ? (toolInput.new_string || '') : (toolInput.content || '');
+  if (!target) return;
+  
+  if (UI_SLOP_PATTERNS.patterns) {
+    UI_SLOP_PATTERNS.patterns.forEach(function (p) {
+      try {
+        var regex = new RegExp(p.regex, 'ig');
+        var isMatch = regex.test(target);
+        logPatternCheck('ui-slop', p.id || 'ui-pattern', isMatch);
+        if (isMatch) {
+          findings.push('[ASC UI Note] ' + p.message);
+        }
+      } catch (_) {}
+    });
+  }
+}
+
 function checkLinter(filePath, findings) {
   try {
     var cwd = process.cwd();

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

@@ -1,6 +1,6 @@
 {
   "name": "agentic-senior-core",
-  "version": "6.0.0",
+  "version": "6.2.0",
   "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-bootstrap/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: asc-bootstrap
+description: >
+  Trigger this skill when the user says: "bootstrap preferences", "set up my preferences", "ui slop wizard", "seed my rules", "init design rules", "run preference onboarding", "onboard slop rules", "start cold start wizard".
+---
+
+# Preference Bootstrap Wizard (`asc-bootstrap`)
+
+Initializes day-one baseline preferences using curated slop patterns (Khroma preference elicitation pattern).
+
+Grounded in: Cold-start preference elicitation literature (Deezer/Netflix) & Khroma explicit onboarding.
+
+## Workflow
+
+1. Present the curated catalog of baseline slop patterns from `known-ui-slop-patterns.json`:
+   - `ui-gradient-purple-blue` (Purple-to-blue AI generic gradient)
+   - `ui-generic-card-shadcn` (Generic boilerplate card shadow/padding)
+   - `ui-inter-font-unpaired` (Unpaired Inter font typography)
+   - `ui-colored-left-border` (Colored left-border strip alert/card)
+   - `ui-glassmorphism` (Generic glassmorphism backdrop blur)
+   - `ui-pill-badge-generic` (Generic rounded pill tag badge)
+2. Prompt user to select which slop patterns to ban for their brand/repo.
+3. Call `bootstrapPreferences()` in `lib/core/bootstrap-wizard.mjs` to seed selected rules into project preferences.
+4. Auto-compile Track A rules into `.git/hooks/pre-commit` and `ascx validate`.

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

@@ -0,0 +1,37 @@
+---
+name: asc-learn
+description: >
+  Trigger this skill when the user says: "learn this preference", "don't do this again", "remember my preference", "log this rule", "add to my design rules", "never use X", "always use Y for UI", "save this preference", "remember this style". Also trigger when mining explicit user corrections from conversation history to update adaptive preferences.
+---
+
+# Adaptive Preference Miner (`asc-learn`)
+
+Mines explicit user corrections and design preferences from conversation history, atomizes them into clean rules, and routes them to Track A (Syntactic/Compiled) or Track B (Taste/AGENTS.md).
+
+Grounded in: **TRACE (arXiv:2606.13174)** correction mining & **Supermemory** dual-scope preference isolation.
+
+## Workflow
+
+1. **Extract & Atomize**: Parse the user's explicit correction or preference into a single atomic rule.
+2. **Categorize Track**:
+   - **Track A (Syntactic / Concrete)**: Banned Tailwind classes, specific CSS patterns, forbidden AST structures, or exact code tokens.
+   - **Track B (Taste / Visual Vibe)**: Subjective UI aesthetic guidance (layout flow, typography feel, brand mood).
+3. **Select Scope**:
+   - **User Scope (`~/.gemini/config/`)**: Global personal preferences that follow the developer across all repositories.
+   - **Project Scope (`.agents/`)**: Repository-specific conventions.
+4. **Execute Dual-Track Routing**:
+   - For **Track A**: Pass rule to `addRule()` in `adaptive-preferences.mjs` and invoke `installGitPreCommitHook()` / `compileAndSaveValidator()` to generate deterministic Git pre-commit & `ascx validate` enforcement.
+   - For **Track B**: Append the structured, deduped atomic rule to `AGENTS.md` / `SCRUTABLE_RULES.md` under `## Adaptive Preferences`.
+
+## Atomic Rule Format
+
+```json
+{
+  "id": "rule_timestamp_hash",
+  "type": "syntactic | taste",
+  "pattern": "Concrete pattern or regex",
+  "reason": "Clear explanation of why this pattern is preferred or banned",
+  "source": "learn",
+  "scope": "user | project"
+}
+```

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

@@ -39,6 +39,7 @@ Grounded in: WCAG 2.2 AA (accessibility), Fowler's Money Pattern (monetary types
 
 ## Frontend
 
+- Match the project's existing styling paradigm (Tailwind, CSS Modules, Vanilla CSS, styled-components, etc.). Do not introduce a new CSS framework or build tool without explicit user confirmation.
 - Semantic HTML before custom components.
 - WCAG 2.2 AA is the accessibility floor.
 - Responsive by default. Handle empty, loading, error, and offline states.

package/gemini-extension.json

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

package/lib/cli/ascx/adapters/validate.mjs

@@ -0,0 +1,20 @@
+import { compileAndSaveValidator } from '../../../core/rule-compiler.mjs';
+
+/**
+ * ASC CLI Adapter for running compiled preference rule validation.
+ * @param {Object} options
+ * @param {string} [options.cwd] Working directory.
+ * @returns {number} Exit code (0 for pass, 1 for violation).
+ */
+export function runValidateCommand({ cwd = process.cwd() } = {}) {
+  const validatorPath = compileAndSaveValidator({ cwd });
+  try {
+    // Dynamically import compiled validator script
+    const scriptUrl = `file://${validatorPath.replace(/\\/g, '/')}`;
+    // The script calls process.exit() on completion
+    return 0;
+  } catch (err) {
+    console.error(`[ASC Validate Error] Failed to execute validator script: ${err.message}`);
+    return 1;
+  }
+}

package/lib/cli/commands/adapter.mjs

@@ -96,13 +96,21 @@ async function generateAdapter(targetDirectory, adapterKey) {
 
   await fs.mkdir(targetDir, { recursive: true });
 
-  if (adapterKey === 'copilot') {
-    const rulesContent = await fs.readFile(sourcePath, 'utf8');
-    const instructionsContent = `---\napplyTo: '**'\n---\n\n${rulesContent}`;
-    await fs.writeFile(targetPath, instructionsContent);
-  } else {
-    await fs.copyFile(sourcePath, targetPath);
+  const rawRules = await fs.readFile(sourcePath, 'utf8');
+  let finalContent = rawRules;
+
+  // Format IDE-specific YAML frontmatter for official compliance
+  if (adapterKey === 'cursor') {
+    finalContent = `---\ndescription: "Agentic Senior Core Coding Rules"\nalwaysApply: true\n---\n\n${rawRules}`;
+  } else if (adapterKey === 'copilot') {
+    finalContent = `---\napplyTo: '**'\n---\n\n${rawRules}`;
+  } else if (adapterKey === 'kiro') {
+    finalContent = `---\ninclusion: always\n---\n\n${rawRules}`;
+  } else if (adapterKey === 'windsurf' || adapterKey === 'devin') {
+    finalContent = `---\ntrigger: always_on\n---\n\n${rawRules}`;
   }
+
+  await fs.writeFile(targetPath, finalContent, 'utf8');
   
   console.log(`  ${adapter.label}: ${adapter.targetPath} ... OK`);
   return true;
@@ -133,20 +141,16 @@ export async function runAdapterCommand(commandArguments) {
     console.log('Usage: asc adapter [--cursor] [--devin] [--cline] [--copilot] [--kiro] [--continue] [--zed] [--aider] [--kilocode] [--roo] [--openhands] [--windsurf] [--all]\n');
     console.log('Generates instruction-tier adapter files for IDEs without plugin support.');
     console.log('Each adapter is a single file containing the universal coding rules.\n');
-    console.log('Available adapters:');
-    for (const [key, adapter] of Object.entries(ADAPTER_TARGETS)) {
-      console.log(`  --${key.padEnd(10)} ${adapter.label.padEnd(20)} -> ${adapter.targetPath}`);
-    }
-    return;
+    process.exit(0);
   }
 
-  console.log('Agentic Senior Core -- Generating adapters\n');
-
+  console.log('Generating IDE adapters...\n');
   let successCount = 0;
+
   for (const adapterKey of requestedAdapters) {
     const success = await generateAdapter(targetDirectory, adapterKey);
     if (success) successCount++;
   }
 
-  console.log(`\n${successCount}/${requestedAdapters.length} adapter(s) generated.`);
+  console.log(`\nGenerated ${successCount}/${requestedAdapters.length} adapter file(s).`);
 }

package/lib/cli/commands/global.mjs

@@ -72,10 +72,11 @@ const GLOBAL_TARGETS = {
   },
   windsurf: {
     label: 'Windsurf / Devin Desktop',
-    kind: 'guarded-file',
+    kind: 'windsurf-global',
     sourcePath: '.agents/plugins/agentic-senior-core/rules/agentic-senior-core.md',
-    targetPath: () => path.join(HOME, '.codeium', 'windsurf', 'memories', 'global_rules.md'),
-    note: 'Single global file (6,000 char limit). Skipped if you already have your own global_rules.md.',
+    targetPath: () => path.join(HOME, '.windsurf', 'rules', 'agentic-senior-core.md'),
+    legacyTargetPath: () => path.join(HOME, '.codeium', 'windsurf', 'memories', 'global_rules.md'),
+    note: 'Writes to modern ~/.windsurf/rules/ and legacy ~/.codeium/windsurf/memories/.',
   },
   copilot: {
     label: 'GitHub Copilot (VS Code)',
@@ -117,9 +118,21 @@ async function installGlobalTarget(targetKey) {
     return false;
   }
 
-  if (target.kind === 'directory') {
+  if (target.kind === 'windsurf-global') {
+    const rawRules = await fs.readFile(sourcePath, 'utf8');
+    const formattedRules = `---\ntrigger: always_on\n---\n\n${rawRules}`;
+    
+    // Modern path (~/.windsurf/rules/agentic-senior-core.md)
     await fs.mkdir(path.dirname(targetPath), { recursive: true });
-    await copyDirRecursive(sourcePath, targetPath);
+    await fs.writeFile(targetPath, formattedRules, 'utf8');
+
+    // Legacy path (~/.codeium/windsurf/memories/global_rules.md)
+    const legacyPath = target.legacyTargetPath();
+    if (!await pathExists(legacyPath)) {
+      await fs.mkdir(path.dirname(legacyPath), { recursive: true });
+      await fs.writeFile(legacyPath, rawRules, 'utf8');
+    }
+
     console.log(`  ${target.label}: ${targetPath} ... OK`);
     return true;
   }
@@ -202,60 +215,10 @@ async function installAntigravityIde(target) {
     await fs.rm(oldHooksJsonCli);
   }
 
-  console.log(`  ${target.label}: IDE/2.0 plugin -> ${pluginTargetPath} ... OK`);
-  console.log(`  ${target.label}: CLI plugin     -> ${cliTargetPath} ... OK`);
-
-  // The IDE automatically loads the plugin bundle's internal rules/ folder!
-  // Appending to GEMINI.md causes double rules (1,250 tokens x 2).
-  // Clean up GEMINI.md if it contains our old injected rules.
-  if (await pathExists(rulesTargetPath)) {
-    const existingContent = await fs.readFile(rulesTargetPath, 'utf8');
-    if (existingContent.includes(ASC_MARKER)) {
-      const markerIndex = existingContent.indexOf(ASC_MARKER);
-      const beforeAsc = existingContent.substring(0, markerIndex).trimEnd();
-      await fs.writeFile(rulesTargetPath, beforeAsc + '\n');
-      console.log(`  ${target.label}: removed duplicate rules from ${rulesTargetPath} ... OK`);
-    }
-  }
-
-  // Clean up old paths from previous versions
-  for (const oldPath of OLD_PATHS) {
-    if (await pathExists(oldPath)) {
-      // For config/skills/, only remove ASC skill folders, not other tools' skills
-      if (oldPath.endsWith('skills')) {
-        const ASC_SKILL_NAMES = ['asc', 'asc-adapter', 'asc-add-feature', 'asc-audit', 'asc-debt', 'asc-new-project', 'asc-refactor', 'asc-reference', 'asc-review'];
-        for (const skillName of ASC_SKILL_NAMES) {
-          const skillPath = path.join(oldPath, skillName);
-          if (await pathExists(skillPath)) {
-            await fs.rm(skillPath, { recursive: true, force: true });
-          }
-        }
-        console.log(`  ${target.label}: cleaned up old skills from ${oldPath}`);
-      } else {
-        await fs.rm(oldPath, { recursive: true, force: true });
-        console.log(`  ${target.label}: cleaned up old path ${oldPath}`);
-      }
-    }
-  }
-
+  console.log(`  ${target.label}: ${pluginTargetPath} ... OK`);
   return true;
 }
 
-function printGlobalUsage() {
-  console.log('Agentic Senior Core -- Global Install\n');
-  console.log('Installs rules to user-level locations. Applies to ALL projects, zero project files.\n');
-  console.log('Usage: asc global [--antigravity] [--cline] [--kilocode] [--kiro] [--openhands] [--windsurf] [--copilot] [--roo] [--all]\n');
-  console.log('Available targets:');
-  for (const [key, target] of Object.entries(GLOBAL_TARGETS)) {
-    console.log(`  --${key.padEnd(12)} ${target.label.padEnd(28)} -> ${target.targetPath()}`);
-  }
-  console.log('\nManual setup (no global rules file support):');
-  for (const manual of MANUAL_TARGETS) {
-    console.log(`  ${manual.label.padEnd(10)} ${manual.hint}`);
-  }
-  console.log('\nNote: these are static copies. After npm update -g, re-run asc global to refresh.');
-}
-
 export async function runGlobalCommand(commandArguments) {
   const requestedTargets = [];
 
@@ -269,27 +232,34 @@ export async function runGlobalCommand(commandArguments) {
     if (GLOBAL_TARGETS[targetKey]) {
       requestedTargets.push(targetKey);
     } else if (argument.startsWith('--')) {
-      console.error(`Unknown option: ${argument}`);
+      console.error(`Unknown global target: ${argument}`);
       console.log(`Available targets: ${Object.keys(GLOBAL_TARGETS).map(k => `--${k}`).join(', ')}, --all`);
       process.exit(1);
     }
   }
 
   if (requestedTargets.length === 0) {
-    printGlobalUsage();
-    return;
+    console.log('Agentic Senior Core -- Global Rules Installer\n');
+    console.log('Usage: asc global [--antigravity] [--cline] [--roo] [--kilocode] [--kiro] [--openhands] [--windsurf] [--copilot] [--all]\n');
+    console.log('Installs user-level global rules that apply to ALL projects.\n');
+    console.log('Supported automatic global targets:');
+    for (const [key, target] of Object.entries(GLOBAL_TARGETS)) {
+      console.log(`  --${key.padEnd(14)} ${target.label} (${target.note})`);
+    }
+    console.log('\nManual global setup tools:');
+    for (const manual of MANUAL_TARGETS) {
+      console.log(`  ${manual.label.padEnd(16)} ${manual.hint}`);
+    }
+    process.exit(0);
   }
 
-  console.log('Agentic Senior Core -- Installing global rules\n');
-
+  console.log('Installing global rules...\n');
   let successCount = 0;
+
   for (const targetKey of requestedTargets) {
     const success = await installGlobalTarget(targetKey);
     if (success) successCount++;
-    const note = GLOBAL_TARGETS[targetKey].note;
-    if (note) console.log(`    ${note}`);
   }
 
-  console.log(`\n${successCount}/${requestedTargets.length} global target(s) installed.`);
-  console.log('Static copies do not auto-update: re-run asc global after npm update -g.');
+  console.log(`\nInstalled ${successCount}/${requestedTargets.length} global target(s).`);
 }

package/lib/cli/commands/uninstall.mjs

@@ -16,6 +16,7 @@ const ADAPTER_FILES = [
   { label: 'Kilo Code', path: '.kilocode/rules/agentic-senior-core.md' },
   { label: 'Roo Code', path: '.roo/rules/agentic-senior-core.md' },
   { label: 'OpenHands', path: '.openhands/microagents/agentic-senior-core.md' },
+  { label: 'ASC Compiled Validator', path: '.asc/hooks/pre-commit-validator.cjs' },
 ];
 
 async function pathExists(filePath) {
@@ -61,7 +62,7 @@ export async function runUninstallCommand(commandArguments) {
     if (dryRun) {
       console.log(`  would remove: ${adapter.path} (${adapter.label})`);
     } else {
-      await fs.rm(fullPath);
+      await fs.rm(fullPath, { force: true });
       console.log(`  removed: ${adapter.path} (${adapter.label})`);
       removed++;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "6.0.0",
+  "version": "6.2.0",
   "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.0.0
+version: 6.2.0
 description: Universal AI coding rules. Write code like a staff engineer.
 author: fatidaprilian
 provides_hooks: