@compr/opscontext-mcp 2.0.0

package/dist/agents.d.ts

@@ -0,0 +1,137 @@
+import type { ProjectDirectory } from "./config.js";
+/**
+ * Multi-Agent Architecture — Phase 1: Foundation + Compliance Agent
+ *
+ * Implements the plan-and-approve workflow described in
+ * FASTPROD/docs/MULTI_AGENT_ARCHITECTURE_PLAN.md
+ *
+ * Risk levels:
+ * 🟢 Read-only (auto-approve) — ls, cat, SELECT, status checks
+ * 🟡 Non-destructive write — git commit, config edit (needs review)
+ * 🔴 Destructive — DELETE, DROP, rm, deploy, reload (needs confirm)
+ */
+export interface ProjectInfo {
+    name: string;
+    path: string;
+    type: string;
+    framework: string;
+    runtime: string;
+    hasGit: boolean;
+    gitRemotes: string[];
+    hasDocker: boolean;
+    hasPm2: boolean;
+    deps: Record<string, string>;
+}
+export interface PlanStep {
+    action: string;
+    description: string;
+    command?: string;
+    risk: "green" | "yellow" | "red";
+    reversible: boolean;
+    estimatedTime: string;
+}
+export interface AuditFinding {
+    check: string;
+    status: "pass" | "warn" | "fail";
+    message: string;
+    project?: string;
+    severity: "info" | "low" | "medium" | "high" | "critical";
+    remediation?: string;
+    command?: string;
+}
+export interface AuditPlan {
+    agent: string;
+    timestamp: string;
+    trigger: string;
+    scope: string;
+    findings: AuditFinding[];
+    steps: PlanStep[];
+    summary: {
+        pass: number;
+        warn: number;
+        fail: number;
+        critical: number;
+    };
+}
+/**
+ * Analyze a project directory and determine its type, framework, runtime.
+ */
+export declare function analyzeProject(dir: ProjectDirectory): ProjectInfo;
+/**
+ * List all projects with tech analysis.
+ */
+export declare function listProjects(projectDirs: ProjectDirectory[]): ProjectInfo[];
+interface PortUsage {
+    port: number;
+    project: string;
+    source: string;
+    details: string;
+}
+/**
+ * Scan all projects for port declarations and detect conflicts.
+ */
+export declare function checkPorts(projectDirs: ProjectDirectory[]): {
+    ports: PortUsage[];
+    conflicts: Array<{
+        port: number;
+        usages: PortUsage[];
+    }>;
+};
+/**
+ * Run the full compliance audit across all projects.
+ * Returns a structured plan document.
+ */
+export declare function runComplianceAudit(projectDirs: ProjectDirectory[]): AuditPlan;
+/**
+ * Format an audit plan as a readable Markdown document.
+ */
+export declare function formatPlan(plan: AuditPlan): string;
+/**
+ * Format project list as a readable summary.
+ */
+export declare function formatProjectList(projects: ProjectInfo[]): string;
+/**
+ * Format port map as a readable table.
+ */
+export declare function formatPortMap(ports: PortUsage[], conflicts: Array<{
+    port: number;
+    usages: PortUsage[];
+}>): string;
+export interface ScoreCheck {
+    name: string;
+    category: string;
+    points: number;
+    maxPoints: number;
+    status: "pass" | "partial" | "fail";
+    detail: string;
+}
+export interface ProjectScore {
+    project: string;
+    path: string;
+    score: number;
+    maxScore: number;
+    percentage: number;
+    grade: string;
+    checks: ScoreCheck[];
+}
+/**
+ * Score a project's AI-readiness (0-100%).
+ * Checks how well-prepared a project is for AI coding agents.
+ */
+export declare function scoreProject(dir: ProjectDirectory): ProjectScore;
+/**
+ * Format a project score report as Markdown.
+ */
+export declare function formatScoreReport(scores: ProjectScore[]): string;
+/**
+ * Generate a per-project SCORE.md file content.
+ * Written to each project root so the score is committed alongside code.
+ */
+export declare function generateProjectScoreMD(score: ProjectScore): string;
+/**
+ * Generate an HTML visual report for project scores.
+ * Produces a self-contained HTML page with embedded CSS — no external dependencies.
+ */
+export declare function generateScoreHTML(scores: ProjectScore[]): string;
+export {};
+//# sourceMappingURL=agents.d.ts.map