@open330/oac-discovery 2026.2.17

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Open330
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,115 @@
+import { TaskSource, Task, TaskComplexity } from '@open330/oac-core';
+import { ResolvedRepo } from '@open330/oac-repo';
+
+/**
+ * Shared options passed to each scanner invocation.
+ */
+interface ScanOptions {
+    /**
+     * Glob-like patterns to skip while scanning.
+     */
+    exclude?: string[];
+    /**
+     * Maximum runtime for a single scanner process.
+     */
+    timeoutMs?: number;
+    /**
+     * Optional hard cap on discovered tasks.
+     */
+    maxTasks?: number;
+    /**
+     * Include hidden files/directories when scanner tooling supports it.
+     */
+    includeHidden?: boolean;
+    /**
+     * Optional external abort signal.
+     */
+    signal?: AbortSignal;
+    /**
+     * Optional resolved repository metadata for scanners that need it.
+     */
+    repo?: ResolvedRepo;
+}
+/**
+ * A scanner discovers actionable tasks from a local repository path.
+ */
+interface Scanner {
+    id: TaskSource | string;
+    name: string;
+    scan(repoPath: string, options?: ScanOptions): Promise<Task[]>;
+}
+/**
+ * Priority factor values; total score should add up to 0-100.
+ */
+interface PriorityWeights {
+    impactScore: number;
+    feasibilityScore: number;
+    freshnessScore: number;
+    issueSignals: number;
+    tokenEfficiency: number;
+}
+/**
+ * Lightweight scanner-derived hints used before ranking.
+ */
+interface ScannerTaskContext {
+    source: TaskSource;
+    complexity: TaskComplexity;
+}
+
+/**
+ * Scanner that converts TODO-like markers into actionable tasks.
+ */
+declare class TodoScanner implements Scanner {
+    readonly id = "todo";
+    readonly name = "TODO Scanner";
+    scan(repoPath: string, options?: ScanOptions): Promise<Task[]>;
+    private findTodoMatches;
+}
+
+/**
+ * Scanner that runs repo-native lint tooling and maps findings to tasks.
+ */
+declare class LintScanner implements Scanner {
+    readonly id = "lint";
+    readonly name = "Lint Scanner";
+    scan(repoPath: string, options?: ScanOptions): Promise<Task[]>;
+}
+
+/**
+ * Scanner that identifies source files lacking corresponding test files.
+ */
+declare class TestGapScanner implements Scanner {
+    readonly id: TaskSource | string;
+    readonly name = "Test Gap Scanner";
+    scan(repoPath: string, options?: ScanOptions): Promise<Task[]>;
+}
+
+/**
+ * Scanner that maps open GitHub issues into contribution tasks.
+ */
+declare class GitHubIssuesScanner implements Scanner {
+    private readonly token?;
+    readonly id: TaskSource | string;
+    readonly name = "GitHub Issues Scanner";
+    constructor(token?: string | undefined);
+    scan(repoPath: string, options?: ScanOptions): Promise<Task[]>;
+}
+
+/**
+ * Runs multiple scanners in parallel and returns a deduplicated task list.
+ */
+declare class CompositeScanner implements Scanner {
+    readonly id = "composite";
+    readonly name = "Composite Scanner";
+    private readonly scanners;
+    constructor(scanners?: Scanner[]);
+    scan(repoPath: string, options?: ScanOptions): Promise<Task[]>;
+}
+declare function createDefaultCompositeScanner(): CompositeScanner;
+
+/**
+ * Rank tasks by computed priority (0-100) and return descending order.
+ */
+declare function rankTasks(tasks: Task[]): Task[];
+
+export { CompositeScanner, GitHubIssuesScanner, LintScanner, type PriorityWeights, type ScanOptions, type Scanner, type ScannerTaskContext, TestGapScanner, TodoScanner, createDefaultCompositeScanner, rankTasks };