@hasankemaldemirci/aro 1.0.0

package/dist/src/core.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: This file is monitored for AI-Readability.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+exports.handleError = handleError;
+exports.displayScore = displayScore;
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: This file is monitored for AI-Readability.
+ */
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const constants_1 = require("./constants");
+const utils_1 = require("./utils");
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: Orchestration layer for ARO analysis.
+ */
+async function run() {
+    const isSilent = process.argv.includes("--silent");
+    if (!isSilent) {
+        console.log(constants_1.Branding.border(""));
+        console.log(constants_1.Branding.cyan.bold("🛰️  ARO") + constants_1.Branding.gray(" | v2.1.0-TS"));
+        console.log(constants_1.Branding.white('"SEO for your code, optimized for AI Agents."'));
+        console.log(constants_1.Branding.border(""));
+    }
+    const projectPath = process.cwd();
+    const pkgPath = path_1.default.join(projectPath, "package.json");
+    if (!fs_1.default.existsSync(pkgPath)) {
+        handleError("package.json not found. Please run this in a Node.js project.");
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(fs_1.default.readFileSync(pkgPath, "utf8"));
+    }
+    catch (e) {
+        handleError(`Failed to parse package.json: ${e.message}`);
+    }
+    const framework = (0, utils_1.detectFramework)(pkg);
+    const techStack = (0, utils_1.detectTechStack)(pkg);
+    const entryPoints = (0, utils_1.findEntryPoints)(projectPath);
+    if (!isSilent) {
+        console.log(constants_1.Branding.white(`\n🎯 Framework: `) + constants_1.Branding.magenta.bold(framework));
+        console.log(constants_1.Branding.gray(`🛠️  Tech Stack: `) + constants_1.Branding.cyan(techStack.join(", ")));
+        console.log(constants_1.Branding.gray(`📂 Scope: `) + constants_1.Branding.white(projectPath));
+    }
+    const ignoreList = (0, utils_1.loadIgnoreList)(projectPath);
+    try {
+        const metrics = (0, utils_1.analyzeMetrics)(projectPath, ignoreList);
+        const score = (0, utils_1.calculateScore)(metrics);
+        const contextMap = {
+            projectName: pkg.name || "Unknown",
+            version: pkg.version || "0.0.1",
+            framework,
+            techStack,
+            entryPoints,
+            analyzedAt: new Date().toISOString(),
+            metrics,
+            score,
+            blindSpots: metrics.blindSpots,
+            structure: (0, utils_1.getRepoStructure)(projectPath, 0, ignoreList),
+        };
+        const contextFilePath = path_1.default.join(projectPath, ".agent_context_pro.json");
+        fs_1.default.writeFileSync(contextFilePath, JSON.stringify(contextMap, null, 2));
+        if (!isSilent) {
+            console.log(constants_1.Branding.success(`\n✅ Knowledge Map: `) +
+                constants_1.Branding.white.bold(".agent_context_pro.json"));
+            displayScore(score);
+            if (score < 100 && metrics.blindSpots.length > 0) {
+                console.log(constants_1.Branding.warning("\n🚩 Blind Spots & Recommendations:"));
+                metrics.blindSpots.forEach((spot) => {
+                    console.log(constants_1.Branding.gray(` • ${spot}`));
+                });
+            }
+        }
+        return contextMap;
+    }
+    catch (e) {
+        handleError(`Analysis failed: ${e.message}`);
+    }
+}
+function handleError(message) {
+    console.log(constants_1.Branding.error(`\n❌ Error: ${message}`));
+    process.exit(1);
+}
+function displayScore(score) {
+    const color = score > 80
+        ? constants_1.Branding.success
+        : score > 60
+            ? constants_1.Branding.warning
+            : constants_1.Branding.error;
+    console.log(constants_1.Branding.white(`📈 Quality Score: `) + color.bold(`${score}/100`));
+    if (score < 80) {
+        console.log(constants_1.Branding.warning(`\n⚠️  At Risk: High Hallucination Tax detected.`));
+    }
+}
+if (require.main === module) {
+    run().catch((err) => {
+        handleError(err.message);
+    });
+}

package/dist/src/enterprise.d.ts

@@ -0,0 +1,8 @@
+import { EnterpriseOptions, ARODebt } from "./types";
+import { AROMetrics } from "./utils";
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: This file is monitored for AI-Readability.
+ */
+export declare function calculateDebt(metrics: AROMetrics, options?: Partial<EnterpriseOptions>): ARODebt;
+export declare function run(): void;

package/dist/src/enterprise.js

@@ -0,0 +1,125 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateDebt = calculateDebt;
+exports.run = run;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const constants_1 = require("./constants");
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: This file is monitored for AI-Readability.
+ */
+function calculateDebt(metrics, options) {
+    const m = metrics;
+    const rate = options?.rate || 100;
+    const interactions = options?.interactions || 2400;
+    let docDebt = 0;
+    if (!m.hasReadme)
+        docDebt = 15000;
+    else if (m.readmeSize < 500)
+        docDebt = 6000;
+    const truncationDebt = m.largeFiles * 5000;
+    let structuralDebt = 0;
+    if (!m.hasSrc)
+        structuralDebt += 10000;
+    // Align with Score: Score gives max points for 2 config files.
+    const configRequirement = 2;
+    const missingConfigs = Math.max(0, configRequirement - m.hasConfig);
+    structuralDebt += missingConfigs * 5000;
+    const tokenWasteDebt = m.largeFiles * interactions * 0.05;
+    const totalDebt = docDebt + truncationDebt + structuralDebt + tokenWasteDebt;
+    const wastedHours = totalDebt / rate;
+    return {
+        docDebt,
+        truncationDebt,
+        structuralDebt,
+        tokenWasteDebt,
+        totalDebt,
+        wastedHours,
+    };
+}
+function run() {
+    const args = process.argv.slice(2);
+    const options = {
+        rate: 120,
+        interactions: 2400,
+    };
+    args.forEach((arg) => {
+        if (arg.startsWith("--rate="))
+            options.rate = parseInt(arg.split("=")[1]);
+        if (arg.startsWith("--interactions="))
+            options.interactions = parseInt(arg.split("=")[1]);
+        if (arg.startsWith("--threshold="))
+            options.threshold = parseInt(arg.split("=")[1]);
+        if (arg.startsWith("--output="))
+            options.output = arg.split("=")[1];
+    });
+    const projectPath = process.cwd();
+    const contextPath = path_1.default.join(projectPath, ".agent_context_pro.json");
+    if (!fs_1.default.existsSync(contextPath)) {
+        console.log(constants_1.Branding.error("❌ Knowledge Map not found. Run analysis first."));
+        process.exit(1);
+    }
+    const context = JSON.parse(fs_1.default.readFileSync(contextPath, "utf8"));
+    const debt = calculateDebt(context.metrics, options);
+    let reportContent = `
+# ARO AI-Financial Report
+Analyzed At: ${context.analyzedAt}
+Project: ${context.projectName}
+Score: ${context.score}/100
+
+## Business Metrics
+- AI-Onboarding Ready: ${context.score}%
+- Developer Hourly Rate (Avg): $${options.rate}
+- Annual Interactions: ${options.interactions}
+
+## Financial Breakdown (Annual)
+- Documentation Gap: $${Math.round(debt.docDebt).toLocaleString()}
+- Truncation Risk: $${Math.round(debt.truncationDebt).toLocaleString()}
+- Structural Debt: $${Math.round(debt.structuralDebt).toLocaleString()}
+- Token Waste: $${Math.round(debt.tokenWasteDebt).toLocaleString()}
+
+**TOTAL ANNUAL AI DEBT: $${Math.round(debt.totalDebt).toLocaleString()}**
+Monthly Productivity Loss: $${Math.round(debt.totalDebt / 12).toLocaleString()}
+Wasted Billable Hours: ${Math.round(debt.wastedHours)} hrs/year
+`;
+    if (options.output) {
+        // SECURITY: Path Traversal Prevention
+        // Ensure output is directed within the project directory or a safe subdirectory
+        // We basename the filename to prevent escaping with ../..
+        const safeFileName = path_1.default.basename(options.output);
+        const outputPath = path_1.default.join(projectPath, safeFileName);
+        fs_1.default.writeFileSync(outputPath, reportContent);
+        console.log(constants_1.Branding.success(`\n💾 Exported (Sanitized): `) +
+            constants_1.Branding.white.bold(safeFileName));
+    }
+    // Console Output
+    console.log(constants_1.Branding.border(""));
+    console.log(constants_1.Branding.magenta.bold("💰 ARO Financial Analyzer") +
+        constants_1.Branding.gray(" | Enterprise Report"));
+    console.log(constants_1.Branding.border(""));
+    console.log(constants_1.Branding.cyan("\n[BUSINESS METRICS]"));
+    console.log(constants_1.Branding.white(`Score: `) + constants_1.Branding.success.bold(`${context.score}%`));
+    console.log(constants_1.Branding.white(`Rate: `) + constants_1.Branding.gray(`$${options.rate}/hr`));
+    console.log(constants_1.Branding.error("\n[DANGER ZONE - ANNUAL DEBT]"));
+    console.log(constants_1.Branding.gray(`Total Debt: `) +
+        constants_1.Branding.error.bold(`$${Math.round(debt.totalDebt).toLocaleString()}`));
+    console.log(constants_1.Branding.gray(`Wasted Hours: `) +
+        constants_1.Branding.warning.bold(`${Math.round(debt.wastedHours)} hrs/yr`));
+    if (options.threshold !== undefined) {
+        console.log(constants_1.Branding.border(""));
+        if (context.score < options.threshold) {
+            console.log(constants_1.Branding.error(`⛔ CI/CD REJECTED: Score ${context.score} < Threshold ${options.threshold}`));
+            process.exit(1);
+        }
+        else {
+            console.log(constants_1.Branding.success(`✅ CI/CD PASSED: Score ${context.score} >= Threshold ${options.threshold}`));
+        }
+    }
+}
+if (require.main === module) {
+    run();
+}

package/dist/src/init.d.ts

@@ -0,0 +1 @@
+export declare function run(): void;

package/dist/src/init.js

@@ -0,0 +1,64 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const constants_1 = require("./constants");
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: CI/CD Initializer for ARO.
+ * Sets up GitHub Actions workflows to automate readability audits.
+ */
+const GITHUB_WORKFLOW_YAML = `name: ARO Audit
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  audit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+      - run: npm ci
+      - name: Run ARO Audit
+        run: npx @hasankemaldemirci/aro audit --threshold=80
+`;
+function run() {
+    const projectPath = process.cwd();
+    const workflowDir = path_1.default.join(projectPath, ".github", "workflows");
+    const workflowPath = path_1.default.join(workflowDir, "aro.yml");
+    console.log(constants_1.Branding.border(""));
+    console.log(constants_1.Branding.cyan.bold("🤖 ARO CI/CD Initializer"));
+    console.log(constants_1.Branding.border(""));
+    if (!fs_1.default.existsSync(workflowDir)) {
+        fs_1.default.mkdirSync(workflowDir, { recursive: true });
+    }
+    if (fs_1.default.existsSync(workflowPath)) {
+        console.log(constants_1.Branding.warning("⚠️  GitHub Action already exists at .github/workflows/aro.yml"));
+        return;
+    }
+    try {
+        fs_1.default.writeFileSync(workflowPath, GITHUB_WORKFLOW_YAML);
+        console.log(constants_1.Branding.success("\n✅ Created GitHub Action: ") +
+            constants_1.Branding.white(".github/workflows/aro.yml"));
+        console.log(constants_1.Branding.gray("\nYour project will now be automatically audited on every push."));
+    }
+    catch (e) {
+        console.log(constants_1.Branding.error(`\n❌ Failed to create workflow: ${e.message}`));
+    }
+    console.log(constants_1.Branding.border(""));
+}
+if (require.main === module) {
+    run();
+}

package/dist/src/mcp.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: This file is monitored for AI-Readability.
+ */
+export {};

package/dist/src/mcp.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: This file is monitored for AI-Readability.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: This file is monitored for AI-Readability.
+ */
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: MCP Server in TypeScript.
+ * Provides tools for AI models to self-audit and optimize context.
+ */
+const SRC_PATH = __dirname;
+const server = new index_js_1.Server({
+    name: "aro-ai-readability",
+    version: "2.0.0",
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+// --- Resources ---
+server.setRequestHandler(types_js_1.ListResourcesRequestSchema, async () => ({
+    resources: [
+        {
+            uri: "aro://current-metrics",
+            name: "ARO AI-Readability Metrics",
+            description: "The latest analysis results and AI debt report.",
+            mimeType: "application/json",
+        },
+    ],
+}));
+server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (request) => {
+    if (request.params.uri === "aro://current-metrics") {
+        const contextPath = path_1.default.join(process.cwd(), ".agent_context_pro.json");
+        if (!fs_1.default.existsSync(contextPath)) {
+            throw new Error("No analysis data found. Run analyze_readability first.");
+        }
+        return {
+            contents: [
+                {
+                    uri: request.params.uri,
+                    mimeType: "application/json",
+                    text: fs_1.default.readFileSync(contextPath, "utf8"),
+                },
+            ],
+        };
+    }
+    throw new Error("Resource not found");
+});
+// --- Tools ---
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "analyze_readability",
+            description: "Performs a deep audit of the codebase to calculate AI-Readiness score and Hallucination Tax.",
+            inputSchema: { type: "object", properties: {} },
+        },
+        {
+            name: "optimize_readability",
+            description: "Automatically applies AI-SEO markers and generates missing configurations to improve AI context retention.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    applyFixes: {
+                        type: "boolean",
+                        description: "Whether to apply automated fixes.",
+                        default: true,
+                    },
+                },
+            },
+        },
+    ],
+}));
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name } = request.params;
+    try {
+        if (name === "analyze_readability") {
+            (0, child_process_1.execSync)(`node ${path_1.default.join(SRC_PATH, "core.js")}`);
+            const contextPath = path_1.default.join(process.cwd(), ".agent_context_pro.json");
+            const data = JSON.parse(fs_1.default.readFileSync(contextPath, "utf8"));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Analysis complete.\nScore: ${data.score}/100\nFramework: ${data.framework}\nBlind Spots: ${data.blindSpots.join(", ")}`,
+                    },
+                ],
+            };
+        }
+        if (name === "optimize_readability") {
+            (0, child_process_1.execSync)(`node ${path_1.default.join(SRC_PATH, "refactor.js")}`);
+            (0, child_process_1.execSync)(`node ${path_1.default.join(SRC_PATH, "core.js")}`);
+            const contextPath = path_1.default.join(process.cwd(), ".agent_context_pro.json");
+            const data = JSON.parse(fs_1.default.readFileSync(contextPath, "utf8"));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Optimizations applied successfully.\nNew AI-Readiness Score: ${data.score}/100`,
+                    },
+                ],
+            };
+        }
+        throw new Error(`Tool not found: ${name}`);
+    }
+    catch (error) {
+        return {
+            isError: true,
+            content: [
+                { type: "text", text: `Error executing ARO tool: ${error.message}` },
+            ],
+        };
+    }
+});
+// --- Start Server ---
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("ARO MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error starting ARO MCP server:", error);
+    process.exit(1);
+});

package/dist/src/refactor.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: Performance Optimized Refactor Module.
+ * Using fast-glob for rapid complexity detection.
+ */
+export declare function run(): Promise<void>;

package/dist/src/refactor.js

@@ -0,0 +1,91 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const constants_1 = require("./constants");
+const utils_1 = require("./utils");
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: Performance Optimized Refactor Module.
+ * Using fast-glob for rapid complexity detection.
+ */
+async function run() {
+    const projectPath = process.cwd();
+    const contextPath = path_1.default.join(projectPath, ".agent_context_pro.json");
+    const ignoreList = (0, utils_1.loadIgnoreList)(projectPath);
+    if (!fs_1.default.existsSync(contextPath)) {
+        console.log(constants_1.Branding.error("❌ Error: No .agent_context_pro.json found. Run analysis first."));
+        process.exit(1);
+    }
+    const data = JSON.parse(fs_1.default.readFileSync(contextPath, "utf8"));
+    const metrics = data.metrics;
+    console.log(constants_1.Branding.magenta.bold("\n🛠️  ARO Auto-Refactor: Commencing Optimization..."));
+    // 1. Documentation Optimization
+    if (!metrics.hasReadme) {
+        console.log(constants_1.Branding.warning("📝 Generating missing README.md..."));
+        const baseReadme = `# ${data.projectName}\n\n## Overview\nThis project is a ${data.framework} application.\n\n## Architecture\n*(Auto-generated by ARO)*\nThis project uses a standard ${data.framework} structure.`;
+        fs_1.default.writeFileSync(path_1.default.join(projectPath, "README.md"), baseReadme);
+        console.log(constants_1.Branding.success("✅ README.md created."));
+    }
+    // 2. Configuration Recovery
+    const requiredConfigs = {
+        ".env.example": "# Environment variables template\nPORT=3000\nAPI_" + "KEY=your_key_here",
+        "tsconfig.json": '{\n  "compilerOptions": {\n    "target": "es5",\n    "module": "commonjs",\n    "strict": true\n  }\n}',
+        ".gitignore": "node_modules\n.DS_Store\n.env\n.agent_context_pro.json",
+    };
+    for (const [file, content] of Object.entries(requiredConfigs)) {
+        if (!fs_1.default.existsSync(path_1.default.join(projectPath, file))) {
+            console.log(constants_1.Branding.warning(`🛠️  Recovering missing config: ${file}...`));
+            fs_1.default.writeFileSync(path_1.default.join(projectPath, file), content);
+            console.log(constants_1.Branding.success(`✅ ${file} generated.`));
+        }
+    }
+    // 3. Complexity Optimization: AI-SEO Markers (Optimized Scan)
+    const filesToOptimize = fast_glob_1.default.sync(["**/*.{js,ts,tsx,jsx}"], {
+        cwd: projectPath,
+        ignore: ignoreList.map((i) => `**/${i}/**`),
+        absolute: true,
+        deep: 5,
+    });
+    for (const file of filesToOptimize) {
+        const content = fs_1.default.readFileSync(file, "utf8");
+        if (content.split("\n").length > 100) {
+            optimizeFile(file);
+        }
+    }
+    console.log(constants_1.Branding.success("\n✨ Refactoring Pass Complete. Run ARO again to see updated scores!"));
+}
+function optimizeFile(filePath) {
+    try {
+        let content = fs_1.default.readFileSync(filePath, "utf8");
+        if (content.includes("@aro-context-marker"))
+            return;
+        const lines = content.split("\n");
+        let extraNote = "";
+        if (lines.length > 300) {
+            extraNote =
+                "\n * CRITICAL: This file exceeds 300 lines. AI Agents may experience context truncation.\n * ACTION: Consider refactoring core logic into smaller sub-modules.";
+            console.log(constants_1.Branding.warning(`⚠️  Self-Healing: Detected high-complexity in ${path_1.default.basename(filePath)} (${lines.length} lines). Applying advisory markers.`));
+        }
+        else {
+            console.log(constants_1.Branding.gray(`📌 Adding AI-SEO markers to: ${path_1.default.basename(filePath)}`));
+        }
+        const marker = `/**\n * @aro-context-marker\n * AI READABILITY NOTE: This file is monitored for AI-Readability.${extraNote}\n */\n`;
+        if (lines[0].startsWith("#!")) {
+            lines.splice(1, 0, marker);
+            fs_1.default.writeFileSync(filePath, lines.join("\n"));
+        }
+        else {
+            fs_1.default.writeFileSync(filePath, marker + content);
+        }
+    }
+    catch (e) { }
+}
+if (require.main === module) {
+    run();
+}

package/dist/src/rules.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: Rules generator for AI Agents (Cursor/Windsurf).
+ * Creates a .cursorrules file based on the local project context.
+ */
+export declare function run(): void;

package/dist/src/rules.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const constants_1 = require("./constants");
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: Rules generator for AI Agents (Cursor/Windsurf).
+ * Creates a .cursorrules file based on the local project context.
+ */
+function run() {
+    const projectPath = process.cwd();
+    const contextPath = path_1.default.join(projectPath, ".agent_context_pro.json");
+    if (!fs_1.default.existsSync(contextPath)) {
+        console.log(constants_1.Branding.error("❌ Knowledge Map not found. Run 'aro audit' first."));
+        process.exit(1);
+    }
+    const data = JSON.parse(fs_1.default.readFileSync(contextPath, "utf8"));
+    const rulesContent = `
+# ARO: AI Agent Constitutional Rules 🛰️
+Version: ${data.version} | Framework: ${data.framework}
+
+## Core Directives for the AI Agent
+You are working in a codebase optimized by **ARO**. To maintain a 100/100 Readiness Score:
+
+1. **Modular Consistency:** NEVER create or expand files beyond 300 lines. If logic grows, refactor into smaller sub-modules immediately.
+2. **Context Retention:** Always refer to \`.agent_context_pro.json\` for the latest project structure and tech stack.
+3. **Deep Context Awareness:**
+   - Framework: ${data.framework}
+   - Tech Stack: ${data.techStack.join(", ")}
+   - Active Entry Points: ${data.entryPoints.join(", ")}
+
+4. **SEO Markers:** Always include \`@aro-context-marker\` in the headers of complex or core files to ensure context mapping persistence.
+5. **No Placeholders:** When generating code, provide complete, production-ready implementations.
+
+## Refactoring Protocol
+- Prioritize modularity over monolithic functions.
+- Ensure all new features are reflected in the documentation.
+- Maintain a clear directory hierarchy as defined in the structural audit.
+
+---
+*Optimized by ARO - "SEO for your code, optimized for AI Agents."*
+`.trim();
+    try {
+        const rulesFiles = [".cursorrules", ".windsurfrules", "AI-CONSTITUTION.md"];
+        rulesFiles.forEach((file) => {
+            fs_1.default.writeFileSync(path_1.default.join(projectPath, file), rulesContent);
+        });
+        console.log(constants_1.Branding.border(""));
+        console.log(constants_1.Branding.cyan.bold("👑 ARO Multi-Agent Constitution"));
+        console.log(constants_1.Branding.border(""));
+        console.log(constants_1.Branding.success("\n✅ Rules deployed to: ") +
+            constants_1.Branding.white(rulesFiles.join(", ")));
+        console.log(constants_1.Branding.gray("\nTargeting: Cursor, Windsurf, Devin, and any ARO-compatible AI Agent."));
+        console.log(constants_1.Branding.border(""));
+    }
+    catch (e) {
+        console.log(constants_1.Branding.error(`\n❌ Failed to deploy AI rules: ${e.message}`));
+    }
+}
+if (require.main === module) {
+    run();
+}

package/dist/src/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: Centralized type definitions.
+ */
+export interface AROMetrics {
+    hasReadme: boolean;
+    readmeSize: number;
+    hasSrc: boolean;
+    hasConfig: number;
+    largeFiles: number;
+    securityIssues: number;
+    blindSpots: string[];
+}
+export interface AROContext {
+    projectName: string;
+    version: string;
+    framework: string;
+    techStack: string[];
+    entryPoints: string[];
+    analyzedAt: string;
+    metrics: AROMetrics;
+    score: number;
+    blindSpots: string[];
+    structure: any;
+}
+export interface EnterpriseOptions {
+    rate: number;
+    interactions: number;
+    threshold?: number;
+    output?: string;
+}
+export interface ARODebt {
+    docDebt: number;
+    truncationDebt: number;
+    structuralDebt: number;
+    tokenWasteDebt: number;
+    totalDebt: number;
+    wastedHours: number;
+}

package/dist/src/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * @aro-context-marker
+ * AI READABILITY NOTE: Centralized type definitions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });