@intrect/openswarm 0.2.0

package/dist/knowledge/types.d.ts

@@ -0,0 +1,288 @@
+import { z } from 'zod';
+export declare const NodeTypeSchema: z.ZodEnum<{
+    project: "project";
+    directory: "directory";
+    module: "module";
+    test_file: "test_file";
+}>;
+export type NodeType = z.infer<typeof NodeTypeSchema>;
+export declare const EdgeTypeSchema: z.ZodEnum<{
+    tests: "tests";
+    contains: "contains";
+    imports: "imports";
+    depends_on: "depends_on";
+}>;
+export type EdgeType = z.infer<typeof EdgeTypeSchema>;
+export declare const LanguageSchema: z.ZodEnum<{
+    other: "other";
+    typescript: "typescript";
+    python: "python";
+}>;
+export type Language = z.infer<typeof LanguageSchema>;
+export declare const ModuleStateSchema: z.ZodEnum<{
+    stable: "stable";
+    experimental: "experimental";
+    deprecated: "deprecated";
+    legacy: "legacy";
+    planned: "planned";
+}>;
+export type ModuleState = z.infer<typeof ModuleStateSchema>;
+export declare const DevelopmentStageSchema: z.ZodEnum<{
+    planning: "planning";
+    in_progress: "in_progress";
+    testing: "testing";
+    reviewing: "reviewing";
+    deployed: "deployed";
+    blocked: "blocked";
+}>;
+export type DevelopmentStage = z.infer<typeof DevelopmentStageSchema>;
+export declare const IssueReferenceSchema: z.ZodObject<{
+    issueId: z.ZodString;
+    issueIdentifier: z.ZodString;
+    title: z.ZodString;
+    state: z.ZodString;
+    priority: z.ZodOptional<z.ZodNumber>;
+    assigneeId: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+}, z.core.$strip>;
+export type IssueReference = z.infer<typeof IssueReferenceSchema>;
+export declare const ModuleMetadataSchema: z.ZodObject<{
+    state: z.ZodOptional<z.ZodEnum<{
+        stable: "stable";
+        experimental: "experimental";
+        deprecated: "deprecated";
+        legacy: "legacy";
+        planned: "planned";
+    }>>;
+    developmentStage: z.ZodOptional<z.ZodEnum<{
+        planning: "planning";
+        in_progress: "in_progress";
+        testing: "testing";
+        reviewing: "reviewing";
+        deployed: "deployed";
+        blocked: "blocked";
+    }>>;
+    relatedIssues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        issueId: z.ZodString;
+        issueIdentifier: z.ZodString;
+        title: z.ZodString;
+        state: z.ZodString;
+        priority: z.ZodOptional<z.ZodNumber>;
+        assigneeId: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+    }, z.core.$strip>>>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dependents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    maintainer: z.ZodOptional<z.ZodString>;
+    lastReviewedAt: z.ZodOptional<z.ZodNumber>;
+    techDebt: z.ZodOptional<z.ZodNumber>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ModuleMetadata = z.infer<typeof ModuleMetadataSchema>;
+export declare const ModuleMetricsSchema: z.ZodObject<{
+    loc: z.ZodNumber;
+    exportCount: z.ZodNumber;
+    importCount: z.ZodNumber;
+    language: z.ZodEnum<{
+        other: "other";
+        typescript: "typescript";
+        python: "python";
+    }>;
+}, z.core.$strip>;
+export type ModuleMetrics = z.infer<typeof ModuleMetricsSchema>;
+export declare const GitInfoSchema: z.ZodObject<{
+    lastCommitDate: z.ZodNumber;
+    commitCount30d: z.ZodNumber;
+    churnScore: z.ZodNumber;
+}, z.core.$strip>;
+export type GitInfo = z.infer<typeof GitInfoSchema>;
+export declare const GraphNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        project: "project";
+        directory: "directory";
+        module: "module";
+        test_file: "test_file";
+    }>;
+    name: z.ZodString;
+    path: z.ZodString;
+    metrics: z.ZodOptional<z.ZodObject<{
+        loc: z.ZodNumber;
+        exportCount: z.ZodNumber;
+        importCount: z.ZodNumber;
+        language: z.ZodEnum<{
+            other: "other";
+            typescript: "typescript";
+            python: "python";
+        }>;
+    }, z.core.$strip>>;
+    gitInfo: z.ZodOptional<z.ZodObject<{
+        lastCommitDate: z.ZodNumber;
+        commitCount30d: z.ZodNumber;
+        churnScore: z.ZodNumber;
+    }, z.core.$strip>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        state: z.ZodOptional<z.ZodEnum<{
+            stable: "stable";
+            experimental: "experimental";
+            deprecated: "deprecated";
+            legacy: "legacy";
+            planned: "planned";
+        }>>;
+        developmentStage: z.ZodOptional<z.ZodEnum<{
+            planning: "planning";
+            in_progress: "in_progress";
+            testing: "testing";
+            reviewing: "reviewing";
+            deployed: "deployed";
+            blocked: "blocked";
+        }>>;
+        relatedIssues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            issueId: z.ZodString;
+            issueIdentifier: z.ZodString;
+            title: z.ZodString;
+            state: z.ZodString;
+            priority: z.ZodOptional<z.ZodNumber>;
+            assigneeId: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodNumber;
+            updatedAt: z.ZodNumber;
+        }, z.core.$strip>>>;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        dependents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        maintainer: z.ZodOptional<z.ZodString>;
+        lastReviewedAt: z.ZodOptional<z.ZodNumber>;
+        techDebt: z.ZodOptional<z.ZodNumber>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type GraphNode = z.infer<typeof GraphNodeSchema>;
+export declare const GraphEdgeSchema: z.ZodObject<{
+    source: z.ZodString;
+    target: z.ZodString;
+    type: z.ZodEnum<{
+        tests: "tests";
+        contains: "contains";
+        imports: "imports";
+        depends_on: "depends_on";
+    }>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type GraphEdge = z.infer<typeof GraphEdgeSchema>;
+export declare const ProjectSummarySchema: z.ZodObject<{
+    totalModules: z.ZodNumber;
+    totalTestFiles: z.ZodNumber;
+    hotModules: z.ZodArray<z.ZodString>;
+    untestedModules: z.ZodArray<z.ZodString>;
+    avgChurnScore: z.ZodNumber;
+    stableModules: z.ZodOptional<z.ZodNumber>;
+    experimentalModules: z.ZodOptional<z.ZodNumber>;
+    deprecatedModules: z.ZodOptional<z.ZodNumber>;
+    activeIssues: z.ZodOptional<z.ZodNumber>;
+    blockedModules: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    highTechDebtModules: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ProjectSummary = z.infer<typeof ProjectSummarySchema>;
+export declare const ImpactAnalysisSchema: z.ZodObject<{
+    directModules: z.ZodArray<z.ZodString>;
+    dependentModules: z.ZodArray<z.ZodString>;
+    testFiles: z.ZodArray<z.ZodString>;
+    estimatedScope: z.ZodEnum<{
+        small: "small";
+        medium: "medium";
+        large: "large";
+    }>;
+}, z.core.$strip>;
+export type ImpactAnalysis = z.infer<typeof ImpactAnalysisSchema>;
+export declare const SerializedGraphSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    projectSlug: z.ZodString;
+    projectPath: z.ZodString;
+    scannedAt: z.ZodNumber;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            project: "project";
+            directory: "directory";
+            module: "module";
+            test_file: "test_file";
+        }>;
+        name: z.ZodString;
+        path: z.ZodString;
+        metrics: z.ZodOptional<z.ZodObject<{
+            loc: z.ZodNumber;
+            exportCount: z.ZodNumber;
+            importCount: z.ZodNumber;
+            language: z.ZodEnum<{
+                other: "other";
+                typescript: "typescript";
+                python: "python";
+            }>;
+        }, z.core.$strip>>;
+        gitInfo: z.ZodOptional<z.ZodObject<{
+            lastCommitDate: z.ZodNumber;
+            commitCount30d: z.ZodNumber;
+            churnScore: z.ZodNumber;
+        }, z.core.$strip>>;
+        metadata: z.ZodOptional<z.ZodObject<{
+            state: z.ZodOptional<z.ZodEnum<{
+                stable: "stable";
+                experimental: "experimental";
+                deprecated: "deprecated";
+                legacy: "legacy";
+                planned: "planned";
+            }>>;
+            developmentStage: z.ZodOptional<z.ZodEnum<{
+                planning: "planning";
+                in_progress: "in_progress";
+                testing: "testing";
+                reviewing: "reviewing";
+                deployed: "deployed";
+                blocked: "blocked";
+            }>>;
+            relatedIssues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                issueId: z.ZodString;
+                issueIdentifier: z.ZodString;
+                title: z.ZodString;
+                state: z.ZodString;
+                priority: z.ZodOptional<z.ZodNumber>;
+                assigneeId: z.ZodOptional<z.ZodString>;
+                createdAt: z.ZodNumber;
+                updatedAt: z.ZodNumber;
+            }, z.core.$strip>>>;
+            dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            dependents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            maintainer: z.ZodOptional<z.ZodString>;
+            lastReviewedAt: z.ZodOptional<z.ZodNumber>;
+            techDebt: z.ZodOptional<z.ZodNumber>;
+            notes: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    edges: z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        target: z.ZodString;
+        type: z.ZodEnum<{
+            tests: "tests";
+            contains: "contains";
+            imports: "imports";
+            depends_on: "depends_on";
+        }>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    summary: z.ZodOptional<z.ZodObject<{
+        totalModules: z.ZodNumber;
+        totalTestFiles: z.ZodNumber;
+        hotModules: z.ZodArray<z.ZodString>;
+        untestedModules: z.ZodArray<z.ZodString>;
+        avgChurnScore: z.ZodNumber;
+        stableModules: z.ZodOptional<z.ZodNumber>;
+        experimentalModules: z.ZodOptional<z.ZodNumber>;
+        deprecatedModules: z.ZodOptional<z.ZodNumber>;
+        activeIssues: z.ZodOptional<z.ZodNumber>;
+        blockedModules: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        highTechDebtModules: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SerializedGraph = z.infer<typeof SerializedGraphSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/knowledge/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/knowledge/types.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,cAAc;;;;;EAA0D,CAAC;AACtF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,cAAc;;;;;EAAyD,CAAC;AACrF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,cAAc;;;;EAA4C,CAAC;AACxE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAItD,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,sBAAsB;;;;;;;EAOjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,oBAAoB;;;;;;;;;iBAS/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,mBAAmB;;;;;;;;;iBAK9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,eAAO,MAAM,aAAa;;;;iBAIxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAIpD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,eAAe;;;;;;;;;;iBAK1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAc/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,oBAAoB;;;;;;;;;iBAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/knowledge/types.js

@@ -0,0 +1,111 @@
+// ============================================
+// OpenSwarm - Knowledge Graph Types
+// Code structure awareness graph type definitions
+// ============================================
+import { z } from 'zod';
+// Node Types
+export const NodeTypeSchema = z.enum(['project', 'directory', 'module', 'test_file']);
+export const EdgeTypeSchema = z.enum(['contains', 'imports', 'tests', 'depends_on']);
+export const LanguageSchema = z.enum(['typescript', 'python', 'other']);
+// Module State & Development Stage
+export const ModuleStateSchema = z.enum([
+    'stable', // Production-ready, well-tested
+    'experimental', // Under active development, API may change
+    'deprecated', // Scheduled for removal
+    'legacy', // Old code, needs refactoring
+    'planned', // Not yet implemented
+]);
+export const DevelopmentStageSchema = z.enum([
+    'planning', // Design phase
+    'in_progress', // Active development
+    'testing', // QA/testing phase
+    'reviewing', // Code review
+    'deployed', // In production
+    'blocked', // Blocked by dependencies or issues
+]);
+// Issue Tracking
+export const IssueReferenceSchema = z.object({
+    issueId: z.string(), // Linear issue ID
+    issueIdentifier: z.string(), // Human-readable identifier (e.g., "INT-123")
+    title: z.string(),
+    state: z.string(), // Linear state (Todo, In Progress, Done, etc.)
+    priority: z.number().optional(), // 0-4 (0=none, 1=urgent, 4=low)
+    assigneeId: z.string().optional(),
+    createdAt: z.number(),
+    updatedAt: z.number(),
+});
+// Module Metadata (Extended)
+export const ModuleMetadataSchema = z.object({
+    state: ModuleStateSchema.optional(),
+    developmentStage: DevelopmentStageSchema.optional(),
+    relatedIssues: z.array(IssueReferenceSchema).optional(), // Issues affecting this module
+    dependencies: z.array(z.string()).optional(), // Module IDs this depends on
+    dependents: z.array(z.string()).optional(), // Module IDs that depend on this
+    maintainer: z.string().optional(), // Primary owner/maintainer
+    lastReviewedAt: z.number().optional(), // Last code review timestamp
+    techDebt: z.number().optional(), // 0-10 scale (subjective)
+    notes: z.string().optional(), // Free-form notes
+});
+// Module Metrics
+export const ModuleMetricsSchema = z.object({
+    loc: z.number(),
+    exportCount: z.number(),
+    importCount: z.number(),
+    language: LanguageSchema,
+});
+// Git Info
+export const GitInfoSchema = z.object({
+    lastCommitDate: z.number(),
+    commitCount30d: z.number(),
+    churnScore: z.number(), // 0-1, normalized change frequency
+});
+// Graph Node
+export const GraphNodeSchema = z.object({
+    id: z.string(), // Unique ID based on relative path (e.g., "src/core/service.ts")
+    type: NodeTypeSchema,
+    name: z.string(), // Filename or directory name
+    path: z.string(), // Relative path from project root
+    metrics: ModuleMetricsSchema.optional(),
+    gitInfo: GitInfoSchema.optional(),
+    metadata: ModuleMetadataSchema.optional(), // Extended metadata (state, stage, issues)
+});
+// Graph Edge
+export const GraphEdgeSchema = z.object({
+    source: z.string(), // Source node ID
+    target: z.string(), // Target node ID
+    type: EdgeTypeSchema,
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+// Project Summary
+export const ProjectSummarySchema = z.object({
+    totalModules: z.number(),
+    totalTestFiles: z.number(),
+    hotModules: z.array(z.string()), // Top 5 most changed modules in last 30 days
+    untestedModules: z.array(z.string()), // Modules without tests
+    avgChurnScore: z.number(),
+    // Extended summary (state & issues)
+    stableModules: z.number().optional(), // Count of stable modules
+    experimentalModules: z.number().optional(), // Count of experimental modules
+    deprecatedModules: z.number().optional(), // Count of deprecated modules
+    activeIssues: z.number().optional(), // Count of open issues
+    blockedModules: z.array(z.string()).optional(), // Modules in blocked state
+    highTechDebtModules: z.array(z.string()).optional(), // Modules with tech debt >= 7
+});
+// Impact Analysis
+export const ImpactAnalysisSchema = z.object({
+    directModules: z.array(z.string()), // Modules referenced in issue text
+    dependentModules: z.array(z.string()), // Modules that import direct modules
+    testFiles: z.array(z.string()), // Tests that should be run
+    estimatedScope: z.enum(['small', 'medium', 'large']),
+});
+// Serialized Graph (JSON persistence)
+export const SerializedGraphSchema = z.object({
+    version: z.literal(1),
+    projectSlug: z.string(),
+    projectPath: z.string(),
+    scannedAt: z.number(),
+    nodes: z.array(GraphNodeSchema),
+    edges: z.array(GraphEdgeSchema),
+    summary: ProjectSummarySchema.optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/knowledge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/knowledge/types.ts"],"names":[],"mappings":"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"}

package/dist/linear/index.d.ts

@@ -0,0 +1,3 @@
+export * from './linear.js';
+export { updateProjectAfterTask, postStatusUpdate, setLinearClient } from './projectUpdater.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/linear/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/linear/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/linear/index.js

@@ -0,0 +1,3 @@
+export * from './linear.js';
+export { updateProjectAfterTask, postStatusUpdate, setLinearClient } from './projectUpdater.js';
+//# sourceMappingURL=index.js.map

package/dist/linear/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/linear/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/linear/linear.d.ts

@@ -0,0 +1,160 @@
+import { LinearClient } from '@linear/sdk';
+import type { LinearIssueInfo } from '../core/types.js';
+/**
+ * Clear all caches (call when issues are mutated)
+ */
+export declare function clearLinearCache(): void;
+/**
+ * Remaining issue creation quota for today
+ */
+export declare function getRemainingDailyIssues(): number;
+/**
+ * Number of issues created today
+ */
+export declare function getDailyIssueCount(): number;
+/**
+ * Initialize the Linear client
+ * Rate limiting is applied at the function level in this file
+ */
+export declare function initLinear(apiKey: string, team: string): void;
+/**
+ * Return the Linear client instance
+ */
+export declare function getClient(): LinearClient;
+/**
+ * Get in-progress issues for an agent (with caching)
+ */
+export declare function getInProgressIssues(agentLabel: string): Promise<LinearIssueInfo[]>;
+/**
+ * Get the next issue from the backlog (with caching)
+ */
+export declare function getNextBacklogIssue(agentLabel: string): Promise<LinearIssueInfo | null>;
+/**
+ * Options for getMyIssues
+ */
+export interface GetMyIssuesOptions {
+    agentLabel?: string;
+    /**
+     * Slim mode: skip N+1 queries for comments/labels/project.
+     * Returns only core fields (id, identifier, title, description, priority, state, project).
+     * Use for heartbeat/decision engine where full details aren't needed.
+     */
+    slim?: boolean;
+    /** Timeout in ms (default: 30000) */
+    timeoutMs?: number;
+}
+/**
+ * Get assigned active issues (with caching)
+ * (Todo, In Progress, Review states - excludes Backlog)
+ */
+export declare function getMyIssues(agentLabelOrOptions?: string | GetMyIssuesOptions): Promise<LinearIssueInfo[]>;
+/**
+ * Get a specific issue by ID or identifier
+ */
+export declare function getIssue(issueIdOrIdentifier: string): Promise<LinearIssueInfo | null>;
+/**
+ * Update issue state
+ */
+export declare function updateIssueState(issueId: string, stateName: 'In Progress' | 'In Review' | 'Done' | 'Backlog' | 'Todo', retries?: number): Promise<void>;
+/**
+ * Add a comment to an issue
+ */
+export declare function addComment(issueId: string, body: string): Promise<void>;
+/** Log a HALT event (low confidence) as a comment on a Linear issue */
+export declare function logHalt(issueId: string, sessionId: string, confidence: number, iteration: number, reason: string): Promise<void>;
+/** Log work start comment for an agent */
+export declare function logWorkStart(issueId: string, sessionName: string): Promise<void>;
+/**
+ * Log progress comment for an agent
+ */
+export declare function logProgress(issueId: string, sessionName: string, progress: string): Promise<void>;
+/**
+ * Log work completion comment for an agent
+ */
+export declare function logWorkComplete(issueId: string, sessionName: string, summary?: string): Promise<void>;
+/**
+ * Log blocked comment for an agent
+ */
+export declare function logBlocked(issueId: string, sessionName: string, reason: string): Promise<void>;
+/**
+ * Log pair session start comment
+ */
+export declare function logPairStart(issueId: string, sessionId: string, projectPath: string): Promise<void>;
+/**
+ * Log pair session review start comment
+ */
+export declare function logPairReview(issueId: string, sessionId: string, attempt: number): Promise<void>;
+/**
+ * Log pair session revision request comment
+ */
+export declare function logPairRevision(issueId: string, sessionId: string, feedback: string, issues: string[]): Promise<void>;
+/**
+ * Log pair session completion comment
+ */
+export declare function logPairComplete(issueId: string, sessionId: string, stats: {
+    attempts: number;
+    duration: number;
+    filesChanged: string[];
+    workerSummary?: string;
+    workerCommands?: string[];
+    reviewerFeedback?: string;
+    reviewerDecision?: string;
+    testResults?: {
+        passed: number;
+        failed: number;
+        coverage?: number;
+        failedTests?: string[];
+    };
+    remainingWork?: string;
+}): Promise<void>;
+/**
+ * Log pair session failure/rejection comment
+ */
+export declare function logPairFailed(issueId: string, sessionId: string, reason: 'rejected' | 'max_attempts' | 'error', details: string): Promise<void>;
+/**
+ * Create a new issue (with daily limit enforcement)
+ */
+export declare function createIssue(title: string, description: string, labels?: string[], options?: {
+    bypassLimit?: boolean;
+}): Promise<LinearIssueInfo | {
+    error: string;
+}>;
+/**
+ * Create a sub-issue (for Planner decomposition)
+ * - Creates as a child of the parent issue via parentId
+ * - Exempt from daily limit (auto-decomposition is required work)
+ */
+export declare function createSubIssue(parentId: string, title: string, description: string, options?: {
+    priority?: number;
+    labels?: string[];
+    projectId?: string;
+    estimatedMinutes?: number;
+}): Promise<LinearIssueInfo | {
+    error: string;
+}>;
+/**
+ * Mark a parent issue as 'decomposed'
+ */
+export declare function markAsDecomposed(issueId: string, subIssueCount: number, totalMinutes: number): Promise<void>;
+/**
+ * Agent proposes work by creating a backlog issue
+ * - Enforces daily limit of 10
+ * - Automatically adds 'agent-proposal' label
+ * - Created with low priority (4)
+ */
+export declare function proposeWork(sessionName: string, title: string, rationale: string, suggestedApproach?: string): Promise<LinearIssueInfo | {
+    error: string;
+}>;
+/**
+ * Get stuck/failed issues and PRs (issues stuck in In Progress for >7 days, or with retry/failed labels)
+ */
+export declare function getStuckIssues(): Promise<{
+    stuckIssues: Array<LinearIssueInfo & {
+        stuckDays: number;
+        reason: string;
+    }>;
+    failedIssues: Array<LinearIssueInfo & {
+        reason: string;
+    }>;
+}>;
+//# sourceMappingURL=linear.d.ts.map

package/dist/linear/linear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.d.ts","sourceRoot":"","sources":["../../src/linear/linear.ts"],"names":[],"mappings":"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"}