@ryuenn3123/agentic-senior-core 6.1.0 → 6.2.1

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

@@ -1,6 +1,6 @@
 {
   "name": "agentic-senior-core",
-  "version": "6.1.0",
+  "version": "6.2.1",
   "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/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-senior-core",
-  "version": "6.1.0",
+  "version": "6.2.1",
   "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/ascx/fixture-evaluator.mjs

@@ -3,6 +3,7 @@ import path from 'node:path';
 
 import { runAscx } from './runtime.mjs';
 import { estimateOutputTokens } from './token-estimate.mjs';
+import { getDefaultTeeDirectory } from './tee-writer.mjs';
 
 function combineOutput(stdout, stderr) {
   return [stdout, stderr].filter(Boolean).join('\n');
@@ -115,7 +116,7 @@ async function evaluateFixture(fixtureEntry, options) {
 export async function evaluateAscxFixtures(fixtures, options = {}) {
   const cwd = options.cwd || process.cwd();
   const teeDirectoryPath = path.resolve(
-    options.teeDirectoryPath || path.join(cwd, '.agent-context', 'state', 'token-saver', 'tee')
+    options.teeDirectoryPath || getDefaultTeeDirectory(cwd)
   );
   const results = [];
 

package/lib/cli/ascx/tee-writer.mjs

@@ -1,5 +1,7 @@
 import fs from 'node:fs/promises';
+import { existsSync } from 'node:fs';
 import path from 'node:path';
+import os from 'node:os';
 
 export const MAX_TEE_FILES = 20;
 
@@ -12,7 +14,11 @@ function sanitizeFileNamePart(rawValue) {
 }
 
 export function getDefaultTeeDirectory(cwd = process.cwd()) {
-  return path.resolve(cwd, '.agent-context', 'state', 'token-saver', 'tee');
+  const localLegacyDir = path.resolve(cwd, '.agent-context', 'state', 'token-saver', 'tee');
+  if (existsSync(localLegacyDir)) {
+    return localLegacyDir;
+  }
+  return path.join(os.homedir(), '.asc', 'state', 'token-saver', 'tee');
 }
 
 async function sweepOldTeeFiles(directoryPath, maxFiles = MAX_TEE_FILES) {
@@ -60,4 +66,3 @@ export async function writeRawTeeFile({
 
   return teeFilePath;
 }
-

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.1.0",
+  "version": "6.2.1",
   "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.1.0
+version: 6.2.1
 description: Universal AI coding rules. Write code like a staff engineer.
 author: fatidaprilian
 provides_hooks: