@happyvertical/smrt-projects 0.30.0

package/AGENTS.md

@@ -0,0 +1,31 @@
+# @happyvertical/smrt-projects
+
+Provider-agnostic project management — GitHub-style issues, PRs, projects, and repositories.
+
+## Models
+
+| Model | Key Fields | Notes |
+|-------|-----------|-------|
+| **Repository** | `owner`, `name`, `providerType`, `tokenConfigKey` | `sync()`, `getIssues()`, `getPullRequests()` |
+| **Issue** | `repositoryId` (FK), `number`, `title`, `body`, `state`, `labels[]` | `incorporateFeedback()`, `rollback()`, `suggestLabels()` |
+| **PullRequest** | extends Issue + `headRef`, `baseRef`, `merged`, `draft` | STI on Issue table. `summarize()`, `merge()` |
+| **Project** | `projectId`, `title`, `statuses[]`, `statusFieldId` | GitHub Projects V2. `addItem()`, `moveItem()`, `analyzeHealth()` |
+| **Comment** | `issueId` (FK), `body`, `authorLogin` | AI analysis support |
+| **Label** | `repositoryId` (FK), `name`, `color` | |
+
+## Key Patterns
+
+- **Token config reference**: stores env var name (`tokenConfigKey: 'GITHUB_TOKEN'`), not the token itself. Resolved at runtime from `process.env` or `getModuleConfig()`
+- **Living spec** (`incorporateFeedback()`): AI synthesizes issue comments into updated body. Supports preview mode and `rollback()`
+- **Provider-agnostic**: GitHub primary, GitLab/Bitbucket/Azure planned. Uses `@happyvertical/repos` and `@happyvertical/projects` SDK packages
+- **PullRequest is STI on Issue**: shares table, discriminated by `_meta_type`
+
+## Collection Methods
+
+All collections provide: `discover({ repository, filters })`, `findByRepository(repoId)`, `findOpen(repoId?)`, `batchSync(repository)`.
+
+## Gotchas
+
+- **SDK dependency**: requires `@happyvertical/repos` and `@happyvertical/projects` from SDK
+- **tokenConfigKey not tokenValue**: never store actual tokens in the database
+- **synthesisCount tracks incorporateFeedback calls**: incremented on each apply

package/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright <2025> <Happy Vertical Corporation>
+
+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/README.md

@@ -0,0 +1,97 @@
+# @happyvertical/smrt-projects
+
+Provider-agnostic project management models for the SMRT framework. Manages repositories, issues, pull requests, and project boards with sync support for external providers (GitHub, GitLab, etc.).
+
+## Installation
+
+```bash
+pnpm add @happyvertical/smrt-projects
+```
+
+## Usage
+
+```typescript
+import {
+  Repository, RepositoryCollection,
+  Issue, IssueCollection,
+  PullRequest, PullRequestCollection,
+  Project, ProjectCollection
+} from '@happyvertical/smrt-projects';
+
+// Track a repository (token resolved from env var at runtime)
+const repos = new RepositoryCollection(db);
+const repo = await repos.create({
+  owner: 'org',
+  name: 'my-app',
+  providerType: 'github',
+  tokenConfigKey: 'GITHUB_TOKEN',
+});
+await repo.save();
+
+// Sync repository metadata from GitHub
+await repo.sync();
+
+// Discover and sync issues
+const issues = await repo.getIssues({ state: 'open' });
+
+// Living Spec: AI-synthesize comments into updated issue body
+const result = await issue.incorporateFeedback({ apply: true });
+
+// Rollback to original body
+await issue.rollback();
+```
+
+## API
+
+### Models
+
+| Export | Description |
+|--------|------------|
+| `Repository` | Git repository with provider integration. Methods: `sync()`, `getIssues()`, `getPullRequests()`, `createIssue()`, `createPullRequest()`, `summarizeActivity()` |
+| `Issue` | Issue/ticket (STI base). Methods: `sync()`, `incorporateFeedback()`, `rollback()`, `suggestLabels()`, `close()`, `addLabels()`, `addComment()` |
+| `PullRequest` | Pull request (STI subclass of Issue). Methods: `sync()`, `summarize()`, `merge()`, `markReady()`, `convertToDraft()`, `requestReviewers()`, `findLinkedIssue()` |
+| `Project` | Project board (GitHub Projects V2). Methods: `sync()`, `addItem()`, `moveItem()`, `listItems()`, `updateItemStatus()`, `analyzeHealth()` |
+| `Comment` | Comment on an issue or PR. AI methods: `isQuestion()`, `isApproval()`, `requestsChanges()`, `extractActionItems()`, `summarize()` |
+| `Label` | Label/tag for issues. Methods: `isTypeLabel()`, `isPriorityLabel()`, `getCategory()`, `createInRepository()` |
+
+### Collections
+
+| Export | Key Methods |
+|--------|------------|
+| `RepositoryCollection` | Standard CRUD |
+| `IssueCollection` | `discover()`, `findByRepository()`, `findOpen()`, `findByLabel()`, `findByAssignee()`, `findNeedingReview()`, `findWithUnincorporatedFeedback()`, `batchSync()` |
+| `PullRequestCollection` | `discover()`, `findByRepository()`, `findOpen()`, `batchSync()` |
+| `ProjectCollection` | Standard CRUD, `findByTitle()` |
+
+### STI Hierarchy
+
+`PullRequest` extends `Issue` via single-table inheritance. Both share the same table, discriminated by `_meta_type`. PullRequest adds `headRef`, `baseRef`, `merged`, `draft`, `additions`, `deletions`, `changedFiles`.
+
+### Constants
+
+`PROJECTS_MODULE_META`, `PROJECTS_UI_SLOTS`
+
+### Key Types
+
+`RepositoryProviderType` (`github | gitlab | bitbucket | azure`), `ProjectProviderType` (`github | jira | linear | zenhub`), `ProjectStatus`, `SyncStatus`, `SyncOptions`, `SearchFilters`, `CreateIssueInput`, `CreatePRInput`, `MergeMethod`, `IncorporateFeedbackOptions`, `IncorporateFeedbackResult`, `ProjectItem`, `ItemFilters`
+
+### Options Types
+
+`RepositoryOptions`, `IssueOptions`, `PullRequestOptions`, `ProjectOptions`, `CommentOptions`, `LabelOptions`
+
+## Key Patterns
+
+- **Token config reference**: stores env var name (`tokenConfigKey: 'GITHUB_TOKEN'`), not the token itself. Resolved at runtime from `process.env` or `getModuleConfig()`
+- **Living Spec** (`incorporateFeedback()`): AI synthesizes issue comments into updated body. Supports preview mode and `rollback()`
+- **Sync throttle**: sync operations skip if called within 5 minutes (override with `{ force: true }`)
+- **Provider-agnostic**: GitHub primary, GitLab/Bitbucket/Azure types defined. Uses `@happyvertical/repos` and `@happyvertical/projects` SDK packages
+
+## Dependencies
+
+- `@happyvertical/smrt-core` -- ORM and code generation
+- `@happyvertical/smrt-config` -- configuration loading
+- `@happyvertical/smrt-tenancy` -- multi-tenant scoping
+- `@happyvertical/smrt-types` -- shared type definitions
+- `@happyvertical/repos` -- repository provider SDK
+- `@happyvertical/projects` -- project board provider SDK
+- Peer: `@happyvertical/smrt-svelte`

package/dist/__smrt-register__.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__smrt-register__.d.ts.map

package/dist/__smrt-register__.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__smrt-register__.d.ts","sourceRoot":"","sources":["../src/__smrt-register__.ts"],"names":[],"mappings":""}

package/dist/collections/Issues.d.ts

@@ -0,0 +1,107 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Issue } from '../models/Issue';
+import { Repository } from '../models/Repository';
+import { SearchFilters } from '../types';
+export declare class IssueCollection extends SmrtCollection<Issue> {
+    static readonly _itemClass: typeof Issue;
+    /**
+     * Discover issues from a repository and sync to database
+     *
+     * This method:
+     * 1. Fetches issues from the provider via SDK
+     * 2. Creates/updates SMRT Issue records in the database
+     * 3. Returns the synced Issue objects
+     *
+     * @param options - Discovery options
+     * @returns Array of Issue objects
+     */
+    discover(options: {
+        repository: Repository;
+        filters?: SearchFilters;
+    }): Promise<Issue[]>;
+    /**
+     * Find issues by repository
+     *
+     * @param repositoryId - Repository ID
+     * @returns Array of issues
+     */
+    findByRepository(repositoryId: string): Promise<Issue[]>;
+    /**
+     * Find open issues
+     *
+     * @param repositoryId - Optional repository filter
+     * @returns Array of open issues
+     */
+    findOpen(repositoryId?: string): Promise<Issue[]>;
+    /**
+     * Find issues by label
+     *
+     * @param label - Label name
+     * @param repositoryId - Optional repository filter
+     * @returns Array of issues with the label
+     */
+    findByLabel(label: string, repositoryId?: string): Promise<Issue[]>;
+    /**
+     * Find issues by assignee
+     *
+     * @param assignee - Assignee login
+     * @param repositoryId - Optional repository filter
+     * @returns Array of issues assigned to the user
+     */
+    findByAssignee(assignee: string, repositoryId?: string): Promise<Issue[]>;
+    /**
+     * Find issues needing review (AI-powered)
+     *
+     * @param repositoryId - Optional repository filter
+     * @returns Array of issues that need review
+     */
+    findNeedingReview(repositoryId?: string): Promise<Issue[]>;
+    /**
+     * Find issue by number in a repository
+     *
+     * @param repositoryId - Repository ID
+     * @param number - Issue number
+     * @returns Issue or null
+     */
+    findByNumber(repositoryId: string, number: number): Promise<Issue | null>;
+    /**
+     * Get issues with unincorporated feedback
+     *
+     * Issues that have comments but haven't had feedback incorporated
+     *
+     * @param repositoryId - Optional repository filter
+     * @returns Array of issues
+     */
+    findWithUnincorporatedFeedback(repositoryId?: string): Promise<Issue[]>;
+    /**
+     * Batch sync issues from repository
+     *
+     * @param repository - Repository to sync from
+     * @param options - Sync options
+     * @returns Array of synced issues
+     */
+    batchSync(repository: Repository, options?: {
+        force?: boolean;
+    }): Promise<Issue[]>;
+    /**
+     * Find issues by tenant ID
+     *
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of issues for the tenant
+     */
+    findByTenant(tenantId: string): Promise<Issue[]>;
+    /**
+     * Find global issues (no tenant)
+     *
+     * @returns Array of global issues
+     */
+    findGlobal(): Promise<Issue[]>;
+    /**
+     * Find issues for a tenant including global issues
+     *
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of tenant and global issues
+     */
+    findWithGlobals(tenantId: string): Promise<Issue[]>;
+}
+//# sourceMappingURL=Issues.d.ts.map

package/dist/collections/Issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Issues.d.ts","sourceRoot":"","sources":["../../src/collections/Issues.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,qBAAa,eAAgB,SAAQ,cAAc,CAAC,KAAK,CAAC;IACxD,MAAM,CAAC,QAAQ,CAAC,UAAU,eAAS;IAEnC;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,OAAO,EAAE;QACtB,UAAU,EAAE,UAAU,CAAC;QACvB,OAAO,CAAC,EAAE,aAAa,CAAC;KACzB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA2DpB;;;;;OAKG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAM9D;;;;;OAKG;IACG,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAQvD;;;;;;OAMG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IASzE;;;;;;OAMG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,KAAK,EAAE,CAAC;IASnB;;;;;OAKG;IACG,iBAAiB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAahE;;;;;;OAMG;IACG,YAAY,CAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAQxB;;;;;;;OAOG;IACG,8BAA8B,CAClC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,KAAK,EAAE,CAAC;IAQnB;;;;;;OAMG;IACG,SAAS,CACb,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAChC,OAAO,CAAC,KAAK,EAAE,CAAC;IAYnB;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAItD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAIpC;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAM1D"}

package/dist/collections/Projects.d.ts

@@ -0,0 +1,90 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Project } from '../models/Project';
+import { ProjectProviderType } from '../types';
+export declare class ProjectCollection extends SmrtCollection<Project> {
+    static readonly _itemClass: typeof Project;
+    /**
+     * Find project by title
+     *
+     * @param title - Project title
+     * @returns Project or null
+     */
+    findByTitle(title: string): Promise<Project | null>;
+    /**
+     * Find projects by owner
+     *
+     * @param owner - Project owner (organization or user)
+     * @returns Array of projects
+     */
+    findByOwner(owner: string): Promise<Project[]>;
+    /**
+     * Find projects by provider type
+     *
+     * @param providerType - Provider type
+     * @returns Array of projects
+     */
+    findByProvider(providerType: ProjectProviderType): Promise<Project[]>;
+    /**
+     * Get or create a project by ID
+     *
+     * @param projectId - Provider-specific project ID
+     * @param options - Additional options for creation
+     * @returns Project (existing or newly created)
+     */
+    getOrCreate(projectId: string, options?: {
+        title?: string;
+        owner?: string;
+        providerType?: ProjectProviderType;
+        tokenConfigKey?: string;
+        statusFieldId?: string;
+        statusOptions?: Record<string, string>;
+    }): Promise<Project>;
+    /**
+     * Sync all projects
+     *
+     * @param options - Sync options
+     * @returns Array of synced projects
+     */
+    syncAll(options?: {
+        force?: boolean;
+    }): Promise<Project[]>;
+    /**
+     * Find projects with items in a specific status
+     *
+     * @param status - Status name
+     * @returns Array of projects
+     */
+    findWithItemsInStatus(status: string): Promise<Project[]>;
+    /**
+     * Get project statistics
+     *
+     * @param projectId - Project ID
+     * @returns Statistics object
+     */
+    getStatistics(projectId: string): Promise<{
+        totalItems: number;
+        itemsByStatus: Record<string, number>;
+        itemsByType: Record<string, number>;
+    }>;
+    /**
+     * Find projects by tenant ID
+     *
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of projects for the tenant
+     */
+    findByTenant(tenantId: string): Promise<Project[]>;
+    /**
+     * Find global projects (no tenant)
+     *
+     * @returns Array of global projects
+     */
+    findGlobal(): Promise<Project[]>;
+    /**
+     * Find projects for a tenant including global projects
+     *
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of tenant and global projects
+     */
+    findWithGlobals(tenantId: string): Promise<Project[]>;
+}
+//# sourceMappingURL=Projects.d.ts.map

package/dist/collections/Projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Projects.d.ts","sourceRoot":"","sources":["../../src/collections/Projects.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAIpD,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,OAAO,CAAC;IAC5D,MAAM,CAAC,QAAQ,CAAC,UAAU,iBAAW;IAErC;;;;;OAKG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAQzD;;;;;OAKG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAMpD;;;;;OAKG;IACG,cAAc,CAAC,YAAY,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAM3E;;;;;;OAMG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,mBAAmB,CAAC;QACnC,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACnC,GACL,OAAO,CAAC,OAAO,CAAC;IAwBnB;;;;;OAKG;IACG,OAAO,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAYpE;;;;;OAKG;IACG,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAqB/D;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAC9C,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC,CAAC;IAoCF;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIxD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAItC;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAM5D"}

package/dist/collections/PullRequests.d.ts

@@ -0,0 +1,107 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { PullRequest } from '../models/PullRequest';
+import { Repository } from '../models/Repository';
+import { SearchFilters } from '../types';
+export declare class PullRequestCollection extends SmrtCollection<PullRequest> {
+    static readonly _itemClass: typeof PullRequest;
+    /**
+     * Discover pull requests from a repository and sync to database
+     *
+     * @param options - Discovery options
+     * @returns Array of PullRequest objects
+     */
+    discover(options: {
+        repository: Repository;
+        filters?: SearchFilters;
+    }): Promise<PullRequest[]>;
+    /**
+     * Find PRs by repository
+     *
+     * @param repositoryId - Repository ID
+     * @returns Array of PRs
+     */
+    findByRepository(repositoryId: string): Promise<PullRequest[]>;
+    /**
+     * Find open PRs
+     *
+     * @param repositoryId - Optional repository filter
+     * @returns Array of open PRs
+     */
+    findOpen(repositoryId?: string): Promise<PullRequest[]>;
+    /**
+     * Find draft PRs
+     *
+     * @param repositoryId - Optional repository filter
+     * @returns Array of draft PRs
+     */
+    findDrafts(repositoryId?: string): Promise<PullRequest[]>;
+    /**
+     * Find PRs ready to merge
+     *
+     * @param repositoryId - Optional repository filter
+     * @returns Array of mergeable PRs
+     */
+    findReadyToMerge(repositoryId?: string): Promise<PullRequest[]>;
+    /**
+     * Find PRs by branch
+     *
+     * @param branch - Branch name (head or base)
+     * @param repositoryId - Optional repository filter
+     * @returns Array of PRs
+     */
+    findByBranch(branch: string, repositoryId?: string): Promise<PullRequest[]>;
+    /**
+     * Find PR by number in a repository
+     *
+     * @param repositoryId - Repository ID
+     * @param number - PR number
+     * @returns PullRequest or null
+     */
+    findByNumber(repositoryId: string, number: number): Promise<PullRequest | null>;
+    /**
+     * Find PRs ready to merge (AI-powered)
+     *
+     * @param repositoryId - Optional repository filter
+     * @returns Array of PRs that are ready
+     */
+    findAIReadyToMerge(repositoryId?: string): Promise<PullRequest[]>;
+    /**
+     * Get PRs by change size
+     *
+     * @param size - Size classification
+     * @param repositoryId - Optional repository filter
+     * @returns Array of PRs
+     */
+    findBySize(size: 'xs' | 's' | 'm' | 'l' | 'xl', repositoryId?: string): Promise<PullRequest[]>;
+    /**
+     * Batch sync PRs from repository
+     *
+     * @param repository - Repository to sync from
+     * @param options - Sync options
+     * @returns Array of synced PRs
+     */
+    batchSync(repository: Repository, options?: {
+        force?: boolean;
+    }): Promise<PullRequest[]>;
+    /**
+     * Find pull requests by tenant ID
+     *
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of pull requests for the tenant
+     */
+    findByTenant(tenantId: string): Promise<PullRequest[]>;
+    /**
+     * Find global pull requests (no tenant)
+     *
+     * @returns Array of global pull requests
+     */
+    findGlobal(): Promise<PullRequest[]>;
+    /**
+     * Find pull requests for a tenant including global pull requests
+     *
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of tenant and global pull requests
+     */
+    findWithGlobals(tenantId: string): Promise<PullRequest[]>;
+}
+//# sourceMappingURL=PullRequests.d.ts.map

package/dist/collections/PullRequests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PullRequests.d.ts","sourceRoot":"","sources":["../../src/collections/PullRequests.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,UAAU,CAAC;AAI9D,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,WAAW,CAAC;IACpE,MAAM,CAAC,QAAQ,CAAC,UAAU,qBAAe;IAEzC;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE;QACtB,UAAU,EAAE,UAAU,CAAC;QACvB,OAAO,CAAC,EAAE,aAAa,CAAC;KACzB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAuF1B;;;;;OAKG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAMpE;;;;;OAKG;IACG,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAQ7D;;;;;OAKG;IACG,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAK/D;;;;;OAKG;IACG,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKrE;;;;;;OAMG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC;IAQzB;;;;;;OAMG;IACG,YAAY,CAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAQ9B;;;;;OAKG;IACG,kBAAkB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAavE;;;;;;OAMG;IACG,UAAU,CACd,IAAI,EAAE,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,EACnC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC;IAKzB;;;;;;OAMG;IACG,SAAS,CACb,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAChC,OAAO,CAAC,WAAW,EAAE,CAAC;IAYzB;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI5D;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI1C;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAMhE"}

package/dist/collections/Repositories.d.ts

@@ -0,0 +1,77 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Repository } from '../models/Repository';
+import { RepositoryProviderType } from '../types';
+export declare class RepositoryCollection extends SmrtCollection<Repository> {
+    static readonly _itemClass: typeof Repository;
+    /**
+     * Find a repository by owner and name
+     *
+     * @param owner - Repository owner
+     * @param name - Repository name
+     * @returns Repository or null
+     */
+    findByFullName(owner: string, name: string): Promise<Repository | null>;
+    /**
+     * Find repositories by owner
+     *
+     * @param owner - Repository owner
+     * @returns Array of repositories
+     */
+    findByOwner(owner: string): Promise<Repository[]>;
+    /**
+     * Find repositories by provider type
+     *
+     * @param providerType - Provider type
+     * @returns Array of repositories
+     */
+    findByProvider(providerType: RepositoryProviderType): Promise<Repository[]>;
+    /**
+     * Get or create a repository by owner/name
+     *
+     * @param owner - Repository owner
+     * @param name - Repository name
+     * @param options - Additional options for creation
+     * @returns Repository (existing or newly created)
+     */
+    getOrCreate(owner: string, name: string, options?: {
+        providerType?: RepositoryProviderType;
+        tokenConfigKey?: string;
+        baseUrl?: string;
+    }): Promise<Repository>;
+    /**
+     * Sync all repositories
+     *
+     * @param options - Sync options
+     * @returns Array of synced repositories
+     */
+    syncAll(options?: {
+        force?: boolean;
+    }): Promise<Repository[]>;
+    /**
+     * Find repositories with open issues
+     *
+     * @returns Array of repositories with at least one open issue
+     */
+    findWithOpenIssues(): Promise<Repository[]>;
+    /**
+     * Find repositories by tenant ID
+     *
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of repositories for the tenant
+     */
+    findByTenant(tenantId: string): Promise<Repository[]>;
+    /**
+     * Find global repositories (no tenant)
+     *
+     * @returns Array of global repositories
+     */
+    findGlobal(): Promise<Repository[]>;
+    /**
+     * Find repositories for a tenant including global repositories
+     *
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of tenant and global repositories
+     */
+    findWithGlobals(tenantId: string): Promise<Repository[]>;
+}
+//# sourceMappingURL=Repositories.d.ts.map

package/dist/collections/Repositories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Repositories.d.ts","sourceRoot":"","sources":["../../src/collections/Repositories.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAIvD,qBAAa,oBAAqB,SAAQ,cAAc,CAAC,UAAU,CAAC;IAClE,MAAM,CAAC,QAAQ,CAAC,UAAU,oBAAc;IAExC;;;;;;OAMG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQ7B;;;;;OAKG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAMvD;;;;;OAKG;IACG,cAAc,CAClB,YAAY,EAAE,sBAAsB,GACnC,OAAO,CAAC,UAAU,EAAE,CAAC;IAMxB;;;;;;;OAOG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QACP,YAAY,CAAC,EAAE,sBAAsB,CAAC;QACtC,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;KACb,GACL,OAAO,CAAC,UAAU,CAAC;IAkBtB;;;;;OAKG;IACG,OAAO,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAYvE;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAsBjD;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI3D;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAIzC;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAM/D"}

package/dist/constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Constants for smrt-projects package
+ */
+/**
+ * Default sync throttle duration in milliseconds (5 minutes)
+ * Prevents excessive API calls by skipping sync if synced recently
+ */
+export declare const SYNC_THROTTLE_MS: number;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAgB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { IssueCollection } from './collections/Issues';
+export { ProjectCollection } from './collections/Projects';
+export { PullRequestCollection } from './collections/PullRequests';
+export { RepositoryCollection } from './collections/Repositories';
+export { Comment, type CommentOptions } from './models/Comment';
+export { Issue, type IssueOptions } from './models/Issue';
+export { Label, type LabelOptions } from './models/Label';
+export { Project, type ProjectOptions } from './models/Project';
+export { PullRequest, type PullRequestOptions } from './models/PullRequest';
+export { Repository, type RepositoryOptions } from './models/Repository';
+export { issueIncorporateFeedbackPrompt } from './prompts';
+export type { Branch, CreateIssueInput, CreatePRInput, IncorporateFeedbackOptions, IncorporateFeedbackResult, IProject, IRepository, ItemFilters, MergeMethod, ProjectConfig, ProjectField, ProjectFieldOption, ProjectItem, ProjectProviderType, ProjectStatus, RepositoryConfig, RepositoryProviderType, SDKComment, SDKIssue, SDKLabel, SDKProject, SDKPullRequest, SDKRepository, SearchFilters, SyncOptions, SyncStatus, UpdateIssueInput, User, } from './types';
+export { PROJECTS_MODULE_META, PROJECTS_UI_SLOTS } from './ui';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAKH,OAAO,wBAAwB,CAAC;AAGhC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGlE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,8BAA8B,EAAE,MAAM,WAAW,CAAC;AAG3D,YAAY,EAEV,MAAM,EACN,gBAAgB,EAChB,aAAa,EAEb,0BAA0B,EAC1B,yBAAyB,EAEzB,QAAQ,EACR,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,IAAI,GACL,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC"}