@ryuenn3123/agentic-senior-core 4.4.0 → 5.1.0

package/bin/agentic-senior-core.js

@@ -1,33 +1,45 @@
 #!/usr/bin/env node
 /**
- * Agentic-Senior-Core CLI — Thin entry point.
+ * Agentic-Senior-Core CLI v5 -- Universal plugin system.
  *
- * All logic lives in lib/cli/ modules. This file only handles
- * argument dispatch and the top-level error boundary.
+ * Commands:
+ *   adapter   Generate instruction-tier adapter files for IDEs without plugin support
+ *   clean     Remove v4 per-project artifacts (.agent-context/, bridge files)
+ *   status    Show detected IDEs and install hints
+ *   mcp       Start MCP stdio server
  */
 import { exit } from 'node:process';
-
-import { CLI_VERSION } from '../lib/cli/constants.mjs';
-import { printUsage } from '../lib/cli/utils.mjs';
-import { runLaunchCommand } from '../lib/cli/commands/launch.mjs';
-import { runRollbackCommand } from '../lib/cli/commands/rollback.mjs';
-import { runMcpServerCommand } from '../lib/cli/commands/mcp.mjs';
-import { runOptimizeCommand, parseOptimizeArguments } from '../lib/cli/commands/optimize.mjs';
-import { runInitCommand, parseInitArguments } from '../lib/cli/commands/init.mjs';
-import { runUpgradeCommand, parseUpgradeArguments } from '../lib/cli/commands/upgrade.mjs';
-import { runContextCommand } from '../lib/cli/commands/context.mjs';
-
+import { readFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const currentFilePath = fileURLToPath(import.meta.url);
+const repositoryRoot = resolve(dirname(currentFilePath), '..');
+const packageJson = JSON.parse(readFileSync(resolve(repositoryRoot, 'package.json'), 'utf8'));
+const CLI_VERSION = packageJson.version;
+
+function printUsage() {
+  console.log(`Agentic-Senior-Core CLI v${CLI_VERSION}`);
+  console.log('Universal AI coding rules. Write code like a staff engineer.\n');
+  console.log('Plugin install (always-on, no per-project files):');
+  console.log('  Claude Code:  /plugin marketplace add fatidaprilian/Agentic-Senior-Core');
+  console.log('  Codex CLI:    codex plugins install agentic-senior-core\n');
+  console.log('Adapter install (one file per project):');
+  console.log('  asc adapter --cursor --windsurf --cline --copilot --kiro --all\n');
+  console.log('Commands:');
+  console.log('  adapter       Generate instruction-tier adapter files');
+  console.log('  clean         Remove v4 per-project artifacts');
+  console.log('  status        Show detected IDEs and install hints');
+  console.log('  mcp           Start MCP stdio server');
+  console.log('  --version     Show version');
+  console.log('  --help        Show this help');
+}
 
 async function main() {
   const commandArgument = process.argv[2];
   const commandArguments = process.argv.slice(3);
 
-  if (!commandArgument || commandArgument === 'launch') {
-    await runLaunchCommand();
-    return;
-  }
-
-  if (commandArgument === '--help' || commandArgument === '-h') {
+  if (!commandArgument || commandArgument === '--help' || commandArgument === '-h') {
     printUsage();
     return;
   }
@@ -37,41 +49,30 @@ async function main() {
     return;
   }
 
-  if (commandArgument === 'upgrade') {
-    const upgradeOptions = parseUpgradeArguments(commandArguments);
-    await runUpgradeCommand(upgradeOptions.targetDirectory, upgradeOptions);
-    return;
-  }
-
-  if (commandArgument === 'optimize') {
-    const optimizeOptions = parseOptimizeArguments(commandArguments);
-    await runOptimizeCommand(optimizeOptions.targetDirectory, optimizeOptions);
+  if (commandArgument === 'adapter') {
+    const { runAdapterCommand } = await import('../lib/cli/commands/adapter.mjs');
+    await runAdapterCommand(commandArguments);
     return;
   }
 
-  if (commandArgument === 'context') {
-    await runContextCommand(commandArguments);
+  if (commandArgument === 'clean') {
+    const { runCleanCommand } = await import('../lib/cli/commands/clean.mjs');
+    await runCleanCommand(commandArguments);
     return;
   }
 
-  if (commandArgument === 'init') {
-    const initOptions = parseInitArguments(commandArguments);
-    await runInitCommand(initOptions.targetDirectory, initOptions);
-    return;
-  }
-
-  if (commandArgument === 'rollback') {
-    await runRollbackCommand(commandArguments);
+  if (commandArgument === 'status') {
+    const { runStatusCommand } = await import('../lib/cli/commands/status.mjs');
+    await runStatusCommand();
     return;
   }
 
   if (commandArgument === 'mcp') {
+    const { runMcpServerCommand } = await import('../lib/cli/commands/mcp.mjs');
     await runMcpServerCommand();
     return;
   }
 
-
-
   console.error(`Unknown command: ${commandArgument}`);
   printUsage();
   exit(1);

package/commands/asc-audit.md

@@ -0,0 +1 @@
+Run the security and architecture audit from skills/asc-audit/SKILL.md. Examine trust boundaries, auth, data handling, architecture boundaries, dependency health, and error exposure. Report findings with severity, evidence, and remediation.

package/commands/asc-audit.toml

@@ -0,0 +1,2 @@
+description = "Security and architecture audit"
+prompt = "Load and follow the asc-audit skill. Audit trust boundaries, auth/authz, data handling, architecture boundaries, dependency health, and error exposure. For every finding report severity (critical/high/medium/low), vulnerability class, location, impact, evidence, remediation, and validation steps. Findings ordered by severity."

package/commands/asc-help.md

@@ -0,0 +1,9 @@
+Show available Agentic Senior Core commands and skills.
+
+Available commands:
+- /asc-refactor -- Structured refactoring workflow
+- /asc-review -- Production-risk code review
+- /asc-audit -- Security and architecture audit
+- /asc-help -- This help
+
+The universal coding rules from AGENTS.md are always active. Skills provide deeper, on-demand workflows.

package/commands/asc-help.toml

@@ -0,0 +1,2 @@
+description = "Show available Agentic Senior Core commands"
+prompt = "Show the Agentic Senior Core command reference: /asc-refactor (structured refactoring workflow), /asc-review (production-risk code review with severity-ordered findings), /asc-audit (security and architecture audit), /asc-help (this help). ASC loads universal engineering rules covering code quality, architecture, security, error handling, testing, API design, database, frontend, infrastructure, resilience, and async patterns."

package/commands/asc-refactor.md

@@ -0,0 +1 @@
+Run the refactoring workflow from skills/asc-refactor/SKILL.md on the current code changes or specified files. Preserve existing behavior while improving structure, naming, boundaries, and maintainability.

package/commands/asc-refactor.toml

@@ -0,0 +1,2 @@
+description = "Structured refactoring workflow with pre-checks and validation"
+prompt = "Load and follow the asc-refactor skill. Read the target code, identify the smallest scope, apply refactor rules: improve clarity, boundaries, naming, validation, error handling, tests. Prioritize maintainability over compressed one-liners. No premature abstractions. Run a final simplification pass. For every change explain what risk existed, what changed, and why the new shape is safer."

package/commands/asc-review.md

@@ -0,0 +1 @@
+Run the code review workflow from skills/asc-review/SKILL.md on the current diff or specified files. Prioritize findings by severity: correctness and security first, then contracts, tests, architecture, and performance.

package/commands/asc-review.toml

@@ -0,0 +1,2 @@
+description = "Production-risk code review with severity-ordered findings"
+prompt = "Load and follow the asc-review skill. Review changed files for production risks. Priority order: correctness/data-loss/security, public contract drift, missing tests, architecture boundary drift, performance/accessibility with concrete impact. For every finding include file/line reference, real risk, and smallest safe fix. Report findings ordered by severity."

package/gemini-extension.json

@@ -0,0 +1,10 @@
+{
+  "name": "agentic-senior-core",
+  "version": "5.1.0",
+  "description": "Universal AI coding rules. Write code like a staff engineer.",
+  "author": "fatidaprilian",
+  "license": "MIT",
+  "contextFileName": "AGENTS.md",
+  "commands": ["commands/"],
+  "skills": ["skills/"]
+}

package/hooks/copilot-hooks.json

@@ -0,0 +1,21 @@
+{
+  "version": 1,
+  "hooks": {
+    "sessionStart": [
+      {
+        "type": "command",
+        "bash": "node \"${PLUGIN_ROOT}/hooks/session-start.js\"",
+        "powershell": "node \"${PLUGIN_ROOT}\\hooks\\session-start.js\"",
+        "timeoutSec": 5
+      }
+    ],
+    "subagentStart": [
+      {
+        "type": "command",
+        "bash": "node \"${PLUGIN_ROOT}/hooks/subagent-start.js\"",
+        "powershell": "node \"${PLUGIN_ROOT}\\hooks\\subagent-start.js\"",
+        "timeoutSec": 5
+      }
+    ]
+  }
+}

package/hooks/hooks.json

@@ -0,0 +1,31 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.js\"; exit 0",
+            "commandWindows": "if (Get-Command node -ErrorAction SilentlyContinue) { node \"$env:CLAUDE_PLUGIN_ROOT\\hooks\\session-start.js\" }",
+            "timeout": 5,
+            "statusMessage": "Loading ASC rules..."
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/subagent-start.js\"; exit 0",
+            "commandWindows": "if (Get-Command node -ErrorAction SilentlyContinue) { node \"$env:CLAUDE_PLUGIN_ROOT\\hooks\\subagent-start.js\" }",
+            "timeout": 5,
+            "statusMessage": "Loading ASC rules..."
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/session-start.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+// Agentic Senior Core — SessionStart hook
+// Injects universal coding rules on every session start.
+// Supports Claude Code, Codex CLI, and GitHub Copilot CLI.
+
+const fs = require('fs');
+const path = require('path');
+
+const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT || path.resolve(__dirname, '..');
+const isCopilot = Boolean(process.env.COPILOT_PLUGIN_DATA);
+const isCodex = !isCopilot && Boolean(process.env.PLUGIN_DATA);
+
+let content;
+try {
+  content = fs.readFileSync(path.join(pluginRoot, 'AGENTS.md'), 'utf8');
+} catch (e) {
+  process.exit(0);
+}
+
+try {
+  if (isCopilot) {
+    process.stdout.write(JSON.stringify({ additionalContext: content }));
+  } else if (isCodex) {
+    process.stdout.write(JSON.stringify({
+      systemMessage: 'ASC:ACTIVE',
+      hookSpecificOutput: {
+        hookEventName: 'SessionStart',
+        additionalContext: content,
+      },
+    }));
+  } else {
+    process.stdout.write(content);
+  }
+} catch (e) {
+  // Silent fail — stdout closed/EPIPE at hook exit must not surface as a hook failure
+}

package/hooks/subagent-start.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+// Agentic Senior Core — SubagentStart hook
+// SessionStart context is parent-thread only and never reaches subagents.
+// This injects the same ruleset into each subagent.
+
+const fs = require('fs');
+const path = require('path');
+
+const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT || path.resolve(__dirname, '..');
+const isCopilot = Boolean(process.env.COPILOT_PLUGIN_DATA);
+const isCodex = !isCopilot && Boolean(process.env.PLUGIN_DATA);
+
+let content;
+try {
+  content = fs.readFileSync(path.join(pluginRoot, 'AGENTS.md'), 'utf8');
+} catch (e) {
+  process.exit(0);
+}
+
+try {
+  if (isCodex) {
+    process.stdout.write(JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: 'SubagentStart',
+        additionalContext: content,
+      },
+    }));
+  } else {
+    process.stdout.write(JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: 'SubagentStart',
+        additionalContext: content,
+      },
+    }));
+  }
+} catch (e) {
+  // Silent fail
+}

package/lib/cli/commands/adapter.mjs

@@ -0,0 +1,109 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const currentFilePath = fileURLToPath(import.meta.url);
+const currentDirectoryPath = path.dirname(currentFilePath);
+const REPOSITORY_ROOT = path.resolve(currentDirectoryPath, '..', '..', '..');
+
+const ADAPTER_TARGETS = {
+  cursor: {
+    label: 'Cursor',
+    targetPath: '.cursor/rules/agentic-senior-core.mdc',
+    sourcePath: '.cursor/rules/agentic-senior-core.mdc',
+  },
+  windsurf: {
+    label: 'Windsurf',
+    targetPath: '.windsurf/rules/agentic-senior-core.md',
+    sourcePath: '.windsurf/rules/agentic-senior-core.md',
+  },
+  cline: {
+    label: 'Cline',
+    targetPath: '.clinerules/agentic-senior-core.md',
+    sourcePath: '.clinerules/agentic-senior-core.md',
+  },
+  copilot: {
+    label: 'GitHub Copilot',
+    targetPath: '.github/copilot-instructions.md',
+    sourcePath: '.github/copilot-instructions.md',
+  },
+  kiro: {
+    label: 'Kiro',
+    targetPath: '.kiro/steering/agentic-senior-core.md',
+    sourcePath: '.kiro/steering/agentic-senior-core.md',
+  },
+};
+
+async function pathExists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function generateAdapter(targetDirectory, adapterKey) {
+  const adapter = ADAPTER_TARGETS[adapterKey];
+  if (!adapter) {
+    console.error(`Unknown adapter: ${adapterKey}. Available: ${Object.keys(ADAPTER_TARGETS).join(', ')}`);
+    return false;
+  }
+
+  const sourcePath = path.join(REPOSITORY_ROOT, adapter.sourcePath);
+  const targetPath = path.join(targetDirectory, adapter.targetPath);
+  const targetDir = path.dirname(targetPath);
+
+  if (!(await pathExists(sourcePath))) {
+    console.error(`Adapter source not found: ${sourcePath}`);
+    return false;
+  }
+
+  await fs.mkdir(targetDir, { recursive: true });
+  await fs.copyFile(sourcePath, targetPath);
+  console.log(`  ${adapter.label}: ${adapter.targetPath} ... OK`);
+  return true;
+}
+
+export async function runAdapterCommand(commandArguments) {
+  const targetDirectory = process.cwd();
+  const requestedAdapters = [];
+
+  for (const argument of commandArguments) {
+    if (argument === '--all') {
+      requestedAdapters.push(...Object.keys(ADAPTER_TARGETS));
+      break;
+    }
+
+    const adapterKey = argument.replace(/^--/, '');
+    if (ADAPTER_TARGETS[adapterKey]) {
+      requestedAdapters.push(adapterKey);
+    } else if (argument.startsWith('--')) {
+      console.error(`Unknown option: ${argument}`);
+      console.log(`Available adapters: ${Object.keys(ADAPTER_TARGETS).map(k => `--${k}`).join(', ')}, --all`);
+      process.exit(1);
+    }
+  }
+
+  if (requestedAdapters.length === 0) {
+    console.log('Agentic Senior Core -- Adapter Generator\n');
+    console.log('Usage: asc adapter [--cursor] [--windsurf] [--cline] [--copilot] [--kiro] [--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;
+  }
+
+  console.log('Agentic Senior Core -- Generating 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.`);
+}

package/lib/cli/commands/clean.mjs

@@ -0,0 +1,63 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+const V4_ARTIFACTS = [
+  '.agent-context',
+  'AGENTS.md',
+  'CLAUDE.md',
+  'GEMINI.md',
+  'STAGE-CHECKPOINT.md',
+  'mcp.json',
+  'validate_output.txt',
+  'release-gate-report.json',
+];
+
+async function pathExists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function runCleanCommand(commandArguments) {
+  const targetDirectory = process.cwd();
+  const dryRun = commandArguments.includes('--dry-run');
+
+  console.log('Agentic Senior Core -- Clean v4 artifacts\n');
+  console.log(`Target: ${targetDirectory}`);
+  if (dryRun) console.log('Mode: dry-run (no files will be deleted)\n');
+  else console.log('');
+
+  let found = 0;
+  let removed = 0;
+
+  for (const artifact of V4_ARTIFACTS) {
+    const fullPath = path.join(targetDirectory, artifact);
+    if (!(await pathExists(fullPath))) continue;
+
+    found++;
+    const stat = await fs.stat(fullPath);
+    const label = stat.isDirectory() ? `${artifact}/` : artifact;
+
+    if (dryRun) {
+      console.log(`  would remove: ${label}`);
+    } else {
+      await fs.rm(fullPath, { recursive: true, force: true });
+      console.log(`  removed: ${label}`);
+      removed++;
+    }
+  }
+
+  if (found === 0) {
+    console.log('No v4 artifacts found. This project is clean.');
+    return;
+  }
+
+  if (dryRun) {
+    console.log(`\n${found} artifact(s) found. Run without --dry-run to remove.`);
+  } else {
+    console.log(`\n${removed} artifact(s) removed.`);
+  }
+}

package/lib/cli/commands/status.mjs

@@ -0,0 +1,94 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+
+const HOME = os.homedir();
+
+const IDE_CHECKS = [
+  {
+    name: 'Claude Code',
+    type: 'plugin',
+    checkPaths: [
+      path.join(HOME, '.claude'),
+    ],
+    installHint: '/plugin marketplace add fatidaprilian/Agentic-Senior-Core',
+  },
+  {
+    name: 'Codex CLI',
+    type: 'plugin',
+    checkPaths: [
+      path.join(HOME, '.codex'),
+    ],
+    installHint: 'codex plugins install agentic-senior-core',
+  },
+  {
+    name: 'Gemini CLI',
+    type: 'plugin',
+    checkPaths: [
+      path.join(HOME, '.gemini'),
+    ],
+    installHint: 'Auto-detected via gemini-extension.json',
+  },
+  {
+    name: 'Cursor',
+    type: 'adapter',
+    checkPaths: [
+      path.join(HOME, '.cursor'),
+      path.join(HOME, 'AppData', 'Roaming', 'Cursor'),
+      path.join(HOME, '.config', 'Cursor'),
+    ],
+    installHint: 'asc adapter --cursor',
+  },
+  {
+    name: 'Windsurf',
+    type: 'adapter',
+    checkPaths: [
+      path.join(HOME, '.codeium'),
+      path.join(HOME, '.windsurf'),
+    ],
+    installHint: 'asc adapter --windsurf',
+  },
+  {
+    name: 'Cline',
+    type: 'adapter',
+    checkPaths: [
+      path.join(HOME, 'Documents', 'Cline'),
+      path.join(HOME, '.cline'),
+    ],
+    installHint: 'asc adapter --cline',
+  },
+];
+
+async function pathExists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function runStatusCommand() {
+  console.log('Agentic Senior Core -- IDE Status\n');
+
+  for (const ide of IDE_CHECKS) {
+    let detected = false;
+    for (const checkPath of ide.checkPaths) {
+      if (await pathExists(checkPath)) {
+        detected = true;
+        break;
+      }
+    }
+
+    const icon = detected ? '[x]' : '[ ]';
+    const support = ide.type === 'plugin' ? '(plugin)' : '(adapter)';
+    console.log(`  ${icon} ${ide.name.padEnd(15)} ${support.padEnd(10)} ${detected ? 'detected' : 'not found'}`);
+
+    if (detected) {
+      console.log(`      Install: ${ide.installHint}`);
+    }
+  }
+
+  console.log('\nPlugin hosts get always-on rules via SessionStart hook.');
+  console.log('Adapter hosts need one file per project via "asc adapter".');
+}