@kernel.chat/kbot 3.38.0 → 3.40.0

package/dist/autonomous-contributor.d.ts

@@ -0,0 +1,88 @@
+export type FindingSeverity = 'info' | 'warn' | 'critical';
+export type FindingCategory = 'todo-removal' | 'typo' | 'missing-type' | 'dead-code' | 'complexity' | 'duplicate-pattern' | 'missing-docs' | 'dependency-issue' | 'style-inconsistency' | 'other';
+export interface ContributorFinding {
+    category: FindingCategory;
+    severity: FindingSeverity;
+    title: string;
+    description: string;
+    file: string;
+    line?: number;
+    /** The original code snippet */
+    original?: string;
+    /** Whether this is a simple, auto-fixable issue */
+    isSimpleFix: boolean;
+}
+export interface ProposedFix {
+    finding: ContributorFinding;
+    description: string;
+    /** The diff-like description of the change */
+    changeSummary: string;
+    /** Estimated review time in minutes */
+    estimatedReviewMinutes: number;
+}
+export interface ContributionReport {
+    repo: string;
+    clonedAt: string;
+    analyzedAt: string;
+    /** Detected primary language */
+    language: string;
+    /** Detected framework (if any) */
+    framework: string;
+    /** Total files scanned */
+    filesScanned: number;
+    findings: ContributorFinding[];
+    proposed_fixes: ProposedFix[];
+    estimated_impact: {
+        totalFindings: number;
+        simpleFixes: number;
+        complexFindings: number;
+        categories: Record<string, number>;
+    };
+    /** Bootstrap-style project health summary */
+    projectHealth: {
+        hasReadme: boolean;
+        hasLicense: boolean;
+        hasTests: boolean;
+        hasCI: boolean;
+        hasContributing: boolean;
+        hasTypeConfig: boolean;
+    };
+}
+export interface ContributorOptions {
+    /** Maximum files to scan (default: 500) */
+    maxFiles?: number;
+    /** Minimum severity to include (default: 'info') */
+    minSeverity?: FindingSeverity;
+    /** Skip cloning if a local path is provided */
+    localPath?: string;
+    /** Keep the cloned repo after analysis (default: false) */
+    keepClone?: boolean;
+}
+export interface GoodFirstIssue {
+    number: number;
+    title: string;
+    url: string;
+    labels: string[];
+    created_at: string;
+    author: string;
+    comments: number;
+    body_preview: string;
+}
+/**
+ * Point at any GitHub repo, clone it, analyze it, and generate a contribution
+ * report with findings and proposed fixes.
+ *
+ * v1 is analysis-only — no automatic PR creation. The report gives you
+ * everything needed to make targeted contributions.
+ */
+export declare function runAutonomousContributor(repoUrl: string, options?: ContributorOptions): Promise<ContributionReport>;
+/**
+ * Fetch open issues labeled "good first issue" or "help wanted" from a GitHub repo.
+ * Uses the public GitHub API (no auth required for public repos).
+ */
+export declare function listGoodFirstIssues(repoUrl: string): Promise<GoodFirstIssue[]>;
+/**
+ * Format a ContributionReport as a readable markdown string.
+ */
+export declare function formatContributionReport(report: ContributionReport): string;
+//# sourceMappingURL=autonomous-contributor.d.ts.map

package/dist/autonomous-contributor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autonomous-contributor.d.ts","sourceRoot":"","sources":["../src/autonomous-contributor.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAA;AAC1D,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,MAAM,GACN,cAAc,GACd,WAAW,GACX,YAAY,GACZ,mBAAmB,GACnB,cAAc,GACd,kBAAkB,GAClB,qBAAqB,GACrB,OAAO,CAAA;AAEX,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,eAAe,CAAA;IACzB,QAAQ,EAAE,eAAe,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,kBAAkB,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAA;IACrB,uCAAuC;IACvC,sBAAsB,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,kBAAkB,EAAE,CAAA;IAC9B,cAAc,EAAE,WAAW,EAAE,CAAA;IAC7B,gBAAgB,EAAE;QAChB,aAAa,EAAE,MAAM,CAAA;QACrB,WAAW,EAAE,MAAM,CAAA;QACnB,eAAe,EAAE,MAAM,CAAA;QACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACnC,CAAA;IACD,6CAA6C;IAC7C,aAAa,EAAE;QACb,SAAS,EAAE,OAAO,CAAA;QAClB,UAAU,EAAE,OAAO,CAAA;QACnB,QAAQ,EAAE,OAAO,CAAA;QACjB,KAAK,EAAE,OAAO,CAAA;QACd,eAAe,EAAE,OAAO,CAAA;QACxB,aAAa,EAAE,OAAO,CAAA;KACvB,CAAA;CACF;AAED,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;CACrB;AAyuBD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAgH7B;AAID;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA2DpF;AAID;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CA2D3E"}