@happyvertical/smrt-projects 0.39.4 → 0.39.6

package/AGENTS.md

@@ -1,6 +1,41 @@
 # @happyvertical/smrt-projects
 
-Provider-agnostic project management — GitHub-style issues, PRs, projects, and repositories.
+Provider-agnostic project management plus the managed-application delivery
+control plane. Repository and board providers remain canonical; managed apps
+only receive scoped Project Integration credentials and provider-neutral
+request/delivery projections.
+
+## Managed application delivery (#1949)
+
+- `ProjectIntegration` stores capability grants and a sensitive credential
+  hash; the raw credential is returned once by
+  `ProjectIntegrationCollection.provision()`/`rotate()` and is never persisted.
+  Provisioning, rotation, and revocation are append-only audited.
+- The stable requester identity is supplied when authenticating
+  `ManagedProjectClient`; request reads are always restricted to that requester
+  and integration.
+- `DevelopmentRequest` preserves evidence, origin, discussion, visibility, and
+  lifecycle history. `ManagedProjectClient` owns managed intake and
+  `DevelopmentRequestService` adds internal triage and work projection.
+- `DevelopmentRequestWorkLink` connects zero-to-many provider-neutral work
+  items. Canonical status stays on the link and drives request lifecycle
+  projection without granting the managed app provider credentials.
+- `ProjectDeliveryEvent` is idempotent per integration key and sequenced for
+  replay. Preview decisions flow through the control-plane adapter, never
+  directly to repository providers.
+- `AssistanceRequest` preserves conversational intake before lossless routing
+  to Support, Development, or both. `smrt-support` supplies the concrete
+  `ProjectAssistanceSupportAdapter`.
+- `ManagedProjectClient` deliberately exposes no repository or board client;
+  delivery and assistance use separate capability-gated service facades.
+
+## Shared Professional Service evidence (#1955)
+
+`ServiceTimeEntry` is canonical here on the existing `service_time_entries`
+table. Planning, development, and support use the same immutable evidence and
+correction chain. `SubscriptionServiceCommercialResolver` prices client work
+through `smrt-subscriptions` (#1925); provider compensation remains a separate
+resolver and snapshot. See `SERVICE_TIME_MIGRATION.md`.
 
 ## Models
 

package/SERVICE_TIME_MIGRATION.md

@@ -0,0 +1,23 @@
+# Service Time Entry migration
+
+`ServiceTimeEntry` moved from `@happyvertical/smrt-support` to
+`@happyvertical/smrt-projects` in issue #1955.
+
+There is no data migration and no duplicate table. The support import is a
+compatibility subtype over the shared class; it restates the schema so an
+isolated support manifest remains self-contained, while both paths map to the
+existing `service_time_entries` table:
+
+```ts
+// Preferred shared import
+import { ServiceTimeEntry, ServiceEvidenceService } from '@happyvertical/smrt-projects';
+
+// Supported compatibility import
+import { ServiceTimeEntry } from '@happyvertical/smrt-support';
+```
+
+Support-specific `SupportCharge` and `SupportCompensation` records remain
+readable. New cross-domain approvals should use `ServiceEvidenceService` with
+`SubscriptionServiceCommercialResolver`; this records a #1925 Client Charge
+reference and a separate provider-compensation snapshot without rewriting the
+approved duration or evidence.

package/dist/collections/DevelopmentRequestHistories.d.ts

@@ -0,0 +1,7 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { DevelopmentRequestHistory } from '../models/DevelopmentRequestHistory';
+export declare class DevelopmentRequestHistoryCollection extends SmrtCollection<DevelopmentRequestHistory> {
+    static readonly _itemClass: typeof DevelopmentRequestHistory;
+    listForRequest(tenantId: string, requestId: string): Promise<DevelopmentRequestHistory[]>;
+}
+//# sourceMappingURL=DevelopmentRequestHistories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DevelopmentRequestHistories.d.ts","sourceRoot":"","sources":["../../src/collections/DevelopmentRequestHistories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAEhF,qBAAa,mCAAoC,SAAQ,cAAc,CAAC,yBAAyB,CAAC;IAChG,MAAM,CAAC,QAAQ,CAAC,UAAU,mCAA6B;IAEjD,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,yBAAyB,EAAE,CAAC;CAQxC"}

package/dist/collections/DevelopmentRequests.d.ts

@@ -0,0 +1,20 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { DevelopmentRequest } from '../models/DevelopmentRequest';
+import { DevelopmentRequestStatus, DevelopmentRequestTransitionInput, ManagedDevelopmentRequestCreateInput } from '../types';
+export declare class DevelopmentRequestCollection extends SmrtCollection<DevelopmentRequest> {
+    static readonly _itemClass: typeof DevelopmentRequest;
+    createManaged(input: {
+        tenantId: string;
+        projectId: string;
+        integrationId: string;
+    } & ManagedDevelopmentRequestCreateInput): Promise<DevelopmentRequest>;
+    listByIntegrationRequester(input: {
+        tenantId: string;
+        integrationId: string;
+        requesterId: string;
+    }): Promise<DevelopmentRequest[]>;
+    transitionStatus(tenantId: string, requestId: string, transition: DevelopmentRequestTransitionInput): Promise<DevelopmentRequest>;
+    listForProject(tenantId: string, projectId: string, status?: DevelopmentRequestStatus): Promise<DevelopmentRequest[]>;
+    private recordHistory;
+}
+//# sourceMappingURL=DevelopmentRequests.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DevelopmentRequests.d.ts","sourceRoot":"","sources":["../../src/collections/DevelopmentRequests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EACV,wBAAwB,EACxB,iCAAiC,EACjC,oCAAoC,EACrC,MAAM,UAAU,CAAC;AAGlB,qBAAa,4BAA6B,SAAQ,cAAc,CAAC,kBAAkB,CAAC;IAClF,MAAM,CAAC,QAAQ,CAAC,UAAU,4BAAsB;IAE1C,aAAa,CACjB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,oCAAoC,GACvC,OAAO,CAAC,kBAAkB,CAAC;IA2BxB,0BAA0B,CAAC,KAAK,EAAE;QACtC,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAa3B,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,iCAAiC,GAC5C,OAAO,CAAC,kBAAkB,CAAC;IAcxB,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAWlB,aAAa;CAqB5B"}

package/dist/collections/ProjectIntegrationAudits.d.ts

@@ -0,0 +1,7 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { ProjectIntegrationAudit } from '../models/ProjectIntegrationAudit';
+export declare class ProjectIntegrationAuditCollection extends SmrtCollection<ProjectIntegrationAudit> {
+    static readonly _itemClass: typeof ProjectIntegrationAudit;
+    listForIntegration(tenantId: string, integrationId: string): Promise<ProjectIntegrationAudit[]>;
+}
+//# sourceMappingURL=ProjectIntegrationAudits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectIntegrationAudits.d.ts","sourceRoot":"","sources":["../../src/collections/ProjectIntegrationAudits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAE5E,qBAAa,iCAAkC,SAAQ,cAAc,CAAC,uBAAuB,CAAC;IAC5F,MAAM,CAAC,QAAQ,CAAC,UAAU,iCAA2B;IAE/C,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAQtC"}

package/dist/collections/ProjectIntegrations.d.ts

@@ -0,0 +1,28 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { ProjectIntegration } from '../models/ProjectIntegration';
+import { ProjectIntegrationCapability } from '../types';
+export declare class ProjectIntegrationCollection extends SmrtCollection<ProjectIntegration> {
+    static readonly _itemClass: typeof ProjectIntegration;
+    provision(input: {
+        tenantId: string;
+        projectId: string;
+        name: string;
+        capabilities: ProjectIntegrationCapability[];
+    }): Promise<{
+        integration: ProjectIntegration;
+        credential: string;
+    }>;
+    rotate(tenantId: string, integrationId: string): Promise<{
+        integration: ProjectIntegration;
+        credential: string;
+    }>;
+    revoke(tenantId: string, integrationId: string): Promise<ProjectIntegration>;
+    authenticate(credential: string): Promise<ProjectIntegration | null>;
+    listForProject(tenantId: string, projectId: string): Promise<ProjectIntegration[]>;
+    findActive(tenantId: string, integrationId: string): Promise<ProjectIntegration | null>;
+    private requireExisting;
+    private requireActive;
+    private recordAudit;
+}
+export declare function hashProjectIntegrationCredential(credential: string): string;
+//# sourceMappingURL=ProjectIntegrations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectIntegrations.d.ts","sourceRoot":"","sources":["../../src/collections/ProjectIntegrations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AAG7D,qBAAa,4BAA6B,SAAQ,cAAc,CAAC,kBAAkB,CAAC;IAClF,MAAM,CAAC,QAAQ,CAAC,UAAU,4BAAsB;IAE1C,SAAS,CAAC,KAAK,EAAE;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,4BAA4B,EAAE,CAAC;KAC9C,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,kBAAkB,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAkB9D,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC;QAAE,WAAW,EAAE,kBAAkB,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAW7D,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,kBAAkB,CAAC;IAYxB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAapE,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAS1B,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;YAOvB,eAAe;YAaf,aAAa;YAWb,WAAW;CAc1B;AAED,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/index.d.ts

@@ -1,14 +1,26 @@
+export { DevelopmentRequestHistoryCollection } from './collections/DevelopmentRequestHistories';
+export { DevelopmentRequestCollection } from './collections/DevelopmentRequests';
 export { IssueCollection } from './collections/Issues';
+export { ProjectIntegrationAuditCollection } from './collections/ProjectIntegrationAudits';
+export { ProjectIntegrationCollection } from './collections/ProjectIntegrations';
 export { ProjectCollection } from './collections/Projects';
 export { PullRequestCollection } from './collections/PullRequests';
 export { RepositoryCollection } from './collections/Repositories';
+export { ManagedProjectClient } from './managed-client';
 export { Comment, type CommentOptions } from './models/Comment';
+export { DevelopmentRequest, type DevelopmentRequestOptions, } from './models/DevelopmentRequest';
+export { DevelopmentRequestHistory, type DevelopmentRequestHistoryOptions, } from './models/DevelopmentRequestHistory';
+export * from './models/delivery-control-plane.js';
 export { Issue, type IssueOptions } from './models/Issue';
 export { Label, type LabelOptions } from './models/Label';
 export { Project, type ProjectOptions } from './models/Project';
+export { ProjectIntegration, type ProjectIntegrationOptions, } from './models/ProjectIntegration';
+export { ProjectIntegrationAudit, type ProjectIntegrationAuditOptions, } from './models/ProjectIntegrationAudit';
 export { PullRequest, type PullRequestOptions } from './models/PullRequest';
 export { Repository, type RepositoryOptions } from './models/Repository';
+export * from './models/service-evidence.js';
 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 * from './services/index.js';
+export type { AssistanceClassification, Branch, CreateIssueInput, CreatePRInput, DeliveryEventType, DevelopmentRequestEvidence, DevelopmentRequestOrigin, DevelopmentRequestStatus, DevelopmentRequestTransitionInput, DevelopmentRequestType, DevelopmentRequestVisibility, DevelopmentTriageDecision, IncorporateFeedbackOptions, IncorporateFeedbackResult, IProject, IRepository, ItemFilters, ManagedAssistanceRequestInput, ManagedDevelopmentRequestCreateInput, MergeMethod, ProjectConfig, ProjectField, ProjectFieldOption, ProjectIntegrationAuditAction, ProjectIntegrationCapability, ProjectIntegrationStatus, ProjectItem, ProjectProviderType, ProjectStatus, RepositoryConfig, RepositoryProviderType, SDKComment, SDKIssue, SDKLabel, SDKProject, SDKPullRequest, SDKRepository, SearchFilters, ServiceEvidence, ServiceParticipantKind, ServiceTimeEntrySource, ServiceTimeEntryStatus, 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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAKH,OAAO,wBAAwB,CAAC;AAEhC,OAAO,EAAE,mCAAmC,EAAE,MAAM,2CAA2C,CAAC;AAChG,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAEjF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iCAAiC,EAAE,MAAM,wCAAwC,CAAC;AAC3F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,yBAAyB,EACzB,KAAK,gCAAgC,GACtC,MAAM,oCAAoC,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,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,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,uBAAuB,EACvB,KAAK,8BAA8B,GACpC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACzE,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,8BAA8B,EAAE,MAAM,WAAW,CAAC;AAC3D,cAAc,qBAAqB,CAAC;AAGpC,YAAY,EACV,wBAAwB,EAExB,MAAM,EACN,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,iCAAiC,EACjC,sBAAsB,EACtB,4BAA4B,EAC5B,yBAAyB,EAEzB,0BAA0B,EAC1B,yBAAyB,EAEzB,QAAQ,EACR,WAAW,EACX,WAAW,EACX,6BAA6B,EAC7B,oCAAoC,EACpC,WAAW,EACX,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,EACxB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,IAAI,GACL,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC"}