@ryuenn3123/agentic-senior-core 4.4.0 → 5.2.0

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".');
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "4.4.0",
+  "version": "5.2.0",
   "type": "module",
-  "description": "Change your AI Agent to code like a Staff Engineer, not a Junior.",
+  "description": "Universal AI coding rules. Write code like a staff engineer, not a junior.",
   "bin": {
     "asc": "bin/agentic-senior-core.js",
     "agentic-senior-core": "bin/agentic-senior-core.js",
@@ -10,27 +10,34 @@
   },
   "files": [
     "bin/",
-    "benchmarks/compact-natural-mode/",
-    "benchmarks/runtime-token-saver/",
-    "lib/",
-    "scripts/",
-    ".agent-context/policies/",
-    ".agent-context/prompts/",
-    ".agent-context/review-checklists/",
-    ".agent-context/rules/",
-    ".agent-context/state/README.md",
-    ".agent-context/state/architecture-map.md",
-    ".agent-context/state/dependency-map.md",
-    ".agent-context/state/benchmark-comparison-schema.json",
-    ".agent-context/state/benchmark-reproducibility.json",
-    ".agent-context/state/benchmark-thresholds.json",
-    ".agent-context/state/benchmark-writer-judge-config.json",
-    ".agent-context/state/memory-adapter-contract.json",
-    ".agent-context/state/memory-schema-v1.json",
+    "lib/cli/commands/adapter.mjs",
+    "lib/cli/commands/clean.mjs",
+    "lib/cli/commands/status.mjs",
+    "lib/cli/commands/mcp.mjs",
+    "lib/cli/ascx/",
+    ".claude-plugin/",
+    ".codex-plugin/",
+    ".devin-plugin/",
+    ".github/plugin/",
+    ".github/copilot-instructions.md",
+    ".agents/",
+    ".openclaw/",
+    ".opencode/",
+    ".cursor/rules/",
+    ".windsurf/rules/",
+    ".clinerules/",
+    ".kiro/steering/",
+    "gemini-extension.json",
+    "plugin.yaml",
+    "__init__.py",
+    "commands/",
+    "hooks/",
+    "skills/",
+    "scripts/mcp-server.mjs",
+    "scripts/mcp-server/",
+    "scripts/uninstall.js",
     "AGENTS.md",
     "CLAUDE.md",
-    "GEMINI.md",
-    "mcp.json",
     "README.md",
     "LICENSE",
     "CONTRIBUTING.md"
@@ -44,51 +51,27 @@
   "keywords": [
     "ai",
     "coding-standards",
-    "cursorrules",
+    "claude-code",
+    "codex",
+    "cursor",
     "windsurf",
     "copilot",
-    "antigravity",
+    "cline",
+    "kiro",
+    "gemini",
+    "devin",
+    "hermes",
+    "opencode",
+    "openclaw",
+    "plugin",
+    "universal",
     "clean-code",
     "engineering-standards",
+    "security",
+    "architecture",
     "agentic"
   ],
   "scripts": {
-    "init": "node ./bin/agentic-senior-core.js init",
-    "audit:frontend-usability": "node ./scripts/frontend-usability-audit.mjs",
-    "audit:documentation-boundary": "node ./scripts/documentation-boundary-audit.mjs",
-    "audit:context-triggered": "node ./scripts/context-triggered-audit.mjs",
-    "audit:rules-guardian": "node ./scripts/rules-guardian-audit.mjs",
-    "audit:explain-on-demand": "node ./scripts/explain-on-demand-audit.mjs",
-    "audit:single-source-lazy-loading": "node ./scripts/single-source-lazy-loading-audit.mjs",
-    "build:release-bundle": "node ./scripts/build-release-benchmark-bundle.mjs",
-    "sync:adapters": "node ./scripts/sync-thin-adapters.mjs",
-    "check:adapters": "node ./scripts/sync-thin-adapters.mjs --check",
-    "gate:release": "node ./scripts/release-gate.mjs && node ./scripts/forbidden-content-check.mjs",
-    "prepublishOnly": "npm run gate:release",
-    "sbom:generate": "node ./scripts/generate-sbom.mjs",
-    "benchmark:detection": "node ./scripts/detection-benchmark.mjs",
-    "benchmark:token": "node ./scripts/token-optimization-benchmark.mjs",
-    "benchmark:adaptive-context": "node ./scripts/adaptive-context-benchmark.mjs",
-    "benchmark:ascx": "node ./scripts/ascx-runtime-token-saver-benchmark.mjs",
-    "benchmark:compact-natural": "node ./scripts/compact-natural-mode-benchmark.mjs",
-    "benchmark:bundle": "node ./scripts/benchmark-evidence-bundle.mjs",
-    "benchmark:writer-judge": "node ./scripts/benchmark-writer-judge-matrix.mjs",
-    "benchmark:gate": "node ./scripts/benchmark-gate.mjs",
-    "benchmark:intelligence": "node ./scripts/benchmark-intelligence.mjs",
-    "benchmark:continuity": "node ./scripts/memory-continuity-benchmark.mjs",
-    "benchmark:cache-phase-2": "node ./benchmarks/token-usage/run-cache-simulation.mjs",
-    "benchmark:anti-halu": "node ./benchmarks/anti-halu/run-benchmark.mjs",
-    "report:quality-trend": "node ./scripts/quality-trend-report.mjs",
-    "report:docs-quality-drift": "node ./scripts/docs-quality-drift-report.mjs",
-    "report:governance-weekly": "node ./scripts/governance-weekly-report.mjs",
-    "clean:local": "node ./scripts/clean-local-artifacts.mjs",
-    "validate": "node ./scripts/validate.mjs",
-    "test": "node --test ./tests/cli-smoke.test.mjs ./tests/mcp-server.test.mjs ./tests/llm-judge.test.mjs ./tests/ui-rubric-calibration.test.mjs ./tests/operations.test.mjs ./tests/knowledge-injection.test.mjs ./tests/audit-caching-scope-hygiene.test.mjs ./tests/research-dossier-migration.test.mjs ./tests/adaptive-context.test.mjs ./tests/ascx-runtime-token-saver.test.mjs ./tests/compact-natural-mode.test.mjs ./benchmarks/token-usage/lib/token-counter.test.mjs ./benchmarks/token-usage/lib/provider-cache-matrix.test.mjs ./benchmarks/token-usage/lib/cache-layer-contract.test.mjs ./benchmarks/token-usage/lib/cache-economics.test.mjs"
-  },
-  "devDependencies": {
-    "@anthropic-ai/sdk": "^0.96.0",
-    "@google/genai": "^2.3.0",
-    "tiktoken": "^1.0.22",
-    "yaml": "^2.9.0"
+    "test": "node --test ./tests/adapter.test.mjs"
   }
 }

package/plugin.yaml

@@ -0,0 +1,16 @@
+name: agentic-senior-core
+version: 5.1.0
+description: Universal AI coding rules. Write code like a staff engineer.
+author: fatidaprilian
+provides_hooks:
+  - pre_llm_call
+provides_commands:
+  - asc-refactor
+  - asc-review
+  - asc-audit
+  - asc-help
+provides_skills:
+  - asc
+  - asc-refactor
+  - asc-review
+  - asc-audit

package/scripts/uninstall.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+/**
+ * Uninstall cleanup script.
+ * Run this BEFORE removing the plugin from the host, since the host
+ * removal deletes the plugin directory (including this script).
+ *
+ * Cleans up:
+ * - Optional config at ~/.config/agentic-senior-core/
+ * - StatusLine entries in ~/.claude/settings.json (if any were added)
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+
+const HOME = os.homedir();
+
+async function pathExists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function main() {
+  const configDir = path.join(HOME, '.config', 'agentic-senior-core');
+  if (await pathExists(configDir)) {
+    await fs.rm(configDir, { recursive: true, force: true });
+    console.log(`Removed config directory: ${configDir}`);
+  }
+
+  console.log('Cleanup complete. You can now remove the plugin from your IDE.');
+}
+
+main().catch((error) => {
+  console.error('Uninstall cleanup failed:', error.message);
+});

package/skills/asc/SKILL.md

@@ -0,0 +1,16 @@
+# Agentic Senior Core
+
+Universal AI coding rules. Write code like a staff engineer.
+
+## Available Commands
+
+- `/asc-refactor` -- Structured refactoring workflow with pre-checks and validation
+- `/asc-review` -- Production-risk code review with severity-ordered findings
+- `/asc-audit` -- Security and architecture audit
+- `/asc-help` -- Show this help
+
+## What It Does
+
+Loads universal engineering rules on every session: code quality, architecture, security, error handling, testing, API design, database, frontend, infrastructure, resilience, and async patterns.
+
+Rules apply to any project, stack, language, or framework. No per-project configuration needed.

package/skills/asc-audit/SKILL.md

@@ -0,0 +1,28 @@
+# Audit Skill
+
+Security and architecture audit. Deeper than review, focused on finding vulnerabilities and structural anti-patterns.
+
+## Audit Scope
+
+1. **Trust boundaries**: Every point where external input enters the system. Validate that inputs are sanitized, normalized, and rejected when invalid.
+2. **Authentication and authorization**: Verify auth checks exist on every endpoint. Check for resource-level authorization, not just identity.
+3. **Data handling**: Secrets in code or logs, PII exposure, unsafe deserialization, SQL injection, command injection.
+4. **Architecture boundaries**: Business logic in transport layer, shared databases between services, circular dependencies, internal model leakage through public APIs.
+5. **Dependency health**: Known vulnerabilities, unmaintained packages, excessive dependency surface.
+6. **Error exposure**: Stack traces, internal paths, or implementation details exposed to clients.
+
+## For Every Finding
+
+```
+Severity: critical | high | medium | low
+Class: vulnerability class (e.g., SQL Injection, Broken Access Control)
+Location: file:line
+Impact: who or what is affected
+Evidence: exact code, behavior, or command output
+Remediation: specific fix direction
+Validation: how to prove it is fixed
+```
+
+## Output
+
+Findings ordered by severity. If no findings, state that explicitly and describe audit coverage.

package/skills/asc-refactor/SKILL.md

@@ -0,0 +1,35 @@
+# Refactor Skill
+
+Structured refactoring workflow. Preserves existing behavior while improving structure.
+
+## Before Editing
+
+1. Read the target code and understand existing patterns.
+2. Identify the smallest relevant scope for the refactor.
+3. If the change touches UI, check accessibility and responsive behavior.
+4. If the change touches dependencies, verify current official docs.
+
+## Refactor Rules
+
+- Improve clarity, boundaries, naming, validation, error handling, and tests.
+- Prioritize maintainability over compressed one-liners.
+- Keep the main flow traceable. Use early returns where they reduce nesting.
+- Do not introduce abstractions before the repeated pattern is real.
+- Split large files when the split makes the flow easier to understand.
+- Remove code that does not carry behavior, safety, clarity, maintainability, or test value.
+- Prefer the shorter implementation only when it keeps the same guarantees.
+- Run a final simplification pass before completion.
+- Update tests and docs whenever behavior contracts, public APIs, data shape, or UI contracts change.
+
+## For Every Change, Explain
+
+- What risk or friction existed.
+- What changed.
+- Why the new shape is safer or easier to maintain.
+
+## Validation
+
+- Existing behavior is preserved unless the user approved a change.
+- Edge cases, empty states, error paths, and rollback paths are handled.
+- Public contracts remain stable or are versioned.
+- Tests pass.