@danxbot/plugin-sdk 0.2.38 → 0.2.41

package/dist/card-kit.d.ts

@@ -44,10 +44,17 @@ declare module "@danxbot/card-kit@1" {
       values: StatusReasonValues;
   }
   type PacingLimit = "five_hour" | "weekly" | "spend";
+  type ProvenanceSourceKind = "card" | "comment" | "session_thread" | "problem" | "url";
+  type ProvenancePartyKind = "person" | "agent";
+  type ResourceType = "plan" | "problem" | "issue" | "plan_record" | "plan_section" | "design" | "decision";
+  interface ResourceRef {
+      type: ResourceType;
+      id: string;
+  }
 
   type IssueStatus$1 = "Review" | "ToDo" | "In Progress" | "Backlog" | "Done" | "Cancelled";
   type EffortLevelName = "min" | "very_low" | "low" | "medium" | "high" | "very_high" | "max";
-  type IssueProblemType = "question" | "action" | "design" | "decision_review";
+  type IssueProblemType = "design" | "question" | "action" | "decision_review";
   type DecisionOutcome = "answered" | "rejected";
   type IssueDependencyKind = "depends_on" | "conflict_on";
   type IssueDispatchKind = "work" | "triage" | "recovery" | "flesh-out" | "chat" | "main-sync-repair" | "worktree-maintenance" | "manual" | "landing" | `gate-${string}`;
@@ -113,10 +120,9 @@ declare module "@danxbot/card-kit@1" {
       triage_enabled: boolean;
       content_hash: string;
   }
-  type CommentResourceType = "issue" | "plan" | "problem" | "design" | "decision";
   interface CommentResourceTag {
       tag: string;
-      resource_type: CommentResourceType | null;
+      resource_type: ResourceType | null;
       resource_id: string | null;
   }
   interface AuthorV2 {
@@ -212,23 +218,34 @@ declare module "@danxbot/card-kit@1" {
       deleted_at: string | null;
   }
   type QualityGateStatus = "pending" | "pass" | "fail" | "skipped";
-  type AnswerProvenanceSource = "comment" | "session_thread";
-  interface DecisionProvenanceV2 {
-      source: AnswerProvenanceSource;
-      source_ref: string;
-      quote: string;
-      recorded_by: string;
-      comment_issue_id: string | null;
+  interface ProvenanceRecordV2 {
+      id: number;
+      quote: string | null;
+      reasoning: string | null;
+      source: ProvenanceSourceV2 | null;
+      recorded_by: AuthorV2;
+      recorded_at: string;
+  }
+  interface ProvenanceSourceV2 {
+      kind: ProvenanceSourceKind;
+      ref: string;
+      card_id: string | null;
+      author: AuthorV2 | null;
+      at: string | null;
   }
 
-  type QualityGatePhase = "plan" | "code";
-
   interface ViaKey {
       id: number;
       name: string;
   }
   type MirrorProviderId = "trello" | "slack" | "asana";
   type SourceOrigin = "danxbot" | MirrorProviderId | "";
+  type WorkMarkResourceType = "plan" | "problem" | "issue" | "plan_record" | "plan_section" | "design" | "decision";
+  interface WorkMarkResource extends ResourceRef {
+      type: WorkMarkResourceType;
+  }
+
+  type QualityGatePhase = "plan" | "code";
   type ControlValue = boolean | string;
 
   type ControlSource = "card" | "plan" | "board" | "team" | "system";
@@ -260,12 +277,13 @@ declare module "@danxbot/card-kit@1" {
       } | null;
       landed_sha: string | null;
       failure_reason: string | null;
+      waiting_board_id: string | null;
       approve_solution_id: number;
       withdraw_solution_id: number;
   }
   type DecisionRecordKind = "design" | "business_rule" | "architecture" | "other";
   type DecisionRecordAction = "created" | "changed" | "deleted" | "restored";
-  type DecisionMadeBy = "human" | "agent";
+  type DecisionMadeBy = "agent" | "human";
   type DecisionApprovalAction = "approve" | "unapprove";
 
   interface DecisionApprovalState {
@@ -274,11 +292,9 @@ declare module "@danxbot/card-kit@1" {
       by_name: string | null;
       at: string | null;
   }
-  interface DecisionProvenanceView {
-      text: string;
-      problem_id: number | null;
-      comment_id: number | null;
-      card_id: string | null;
+  interface DecisionRecordPage {
+      offset: number;
+      target_found: boolean | null;
   }
 
   type ListType = "archived" | "review" | "ready" | "in_progress" | "completed" | "cancelled";
@@ -392,6 +408,7 @@ declare module "@danxbot/card-kit@1" {
   interface V2CopyDecisionVersion {
       version_no: number;
       action: DecisionRecordAction;
+      title: string;
       text: string;
       kind: DecisionRecordKind;
       impact: number;
@@ -400,12 +417,7 @@ declare module "@danxbot/card-kit@1" {
       made_by_email: string | null;
       made_by_name: string | null;
       made_by_team_agent: string | null;
-      provenance: {
-          text: string;
-          problem_index: number | null;
-          comment_index: number | null;
-          card_id: string | null;
-      };
+      provenance: V2CopyProvenanceRecord[];
       author: string;
       team_agent: string | null;
       created_at: string;
@@ -499,14 +511,29 @@ declare module "@danxbot/card-kit@1" {
       decided_by: string;
       decided_at: string;
       retracted_at: string | null;
-      provenance: V2CopyDecisionProvenance | null;
+      provenance: V2CopyProvenanceRecord | null;
   }
-  interface V2CopyDecisionProvenance {
-      source: AnswerProvenanceSource;
-      source_ref: string;
-      quote: string;
-      recorded_by: string;
+  interface V2CopyProvenanceParty {
+      kind: ProvenancePartyKind;
+      email: string | null;
+      team_agent: string | null;
+      name: string;
+  }
+  interface V2CopyProvenanceSource {
+      kind: ProvenanceSourceKind;
+      ref: string;
       comment_index: number | null;
+      problem_index: number | null;
+      card_linked: boolean;
+      author: V2CopyProvenanceParty | null;
+      at: string | null;
+  }
+  interface V2CopyProvenanceRecord {
+      quote: string | null;
+      reasoning: string | null;
+      source: V2CopyProvenanceSource | null;
+      recorded_by: V2CopyProvenanceParty;
+      recorded_at: string;
   }
   interface V2CopyProblem {
       statement: string;
@@ -576,7 +603,7 @@ declare module "@danxbot/card-kit@1" {
       name: string;
       avatar_url: string | null;
   }
-  type AssignedAgentKind = "session" | "person" | "worker" | "label";
+  type AssignedAgentKind = "person" | "session" | "worker" | "label";
 
   interface UsageTokenCounts {
       input: number;
@@ -941,6 +968,8 @@ declare module "@danxbot/card-kit@1" {
     start_commit?: undefined | null | { at: string; sha: string | null; error: "no_repo" | "not_github_repo" | "no_token" | "github_refused" | "github_unreachable" | "unreadable_tip" | "unexpected" | null; error_detail: string | null; };
     problem_total?: undefined | number;
     decision_record_total?: undefined | number;
+    decision_record_page?: undefined | DecisionRecordPage;
+    decision_record_approved_total?: undefined | number;
     lane_header?: undefined | false | true;
     design_count?: undefined | number;
     open_action_count?: undefined | number;
@@ -950,7 +979,7 @@ declare module "@danxbot/card-kit@1" {
     dispatch?: undefined | null | { started_at: string | null; };
     dispatch_kind?: undefined | null | "work" | "triage" | "recovery" | "flesh-out" | "chat" | "main-sync-repair" | "worktree-maintenance" | "manual" | "landing" | `gate-${string}`;
     assignment_mode?: undefined | "manual" | "automated";
-    assigned_agent_kind?: undefined | null | "session" | "person" | "worker" | "label";
+    assigned_agent_kind?: undefined | null | "person" | "session" | "worker" | "label";
     assigned_agent_pause?: undefined | null | HolderAgentPause;
     assigned_agent_repo_copy?: undefined | null | RepoProfileCopy;
     latest_work_dispatch?: undefined | null | LatestWorkDispatchViewV2;
@@ -1015,21 +1044,23 @@ declare module "@danxbot/card-kit@1" {
     record_created_at: string;
     updated_at: string;
     action: "created" | "changed" | "deleted" | "restored";
+    title: string;
     text: string;
     kind: "design" | "business_rule" | "architecture" | "other";
     impact: number;
     confidence: number;
-    made_by: "human" | "agent";
+    made_by: "agent" | "human";
     made_by_user_id: null | number;
     made_by_name: null | string;
     made_by_author: AuthorV2;
     made_by_is_writer: boolean;
-    provenance: DecisionProvenanceView;
+    provenance: Array<ProvenanceRecordV2>;
     author: string;
     by: AuthorV2;
     via_key: null | ViaKey;
     created_at: string;
     comment_count: number;
+    unread_comment_count: number;
     versions?: undefined | (Array<{
     id: number;
     record_id: number;
@@ -1037,16 +1068,17 @@ declare module "@danxbot/card-kit@1" {
     version_no: number;
     approval: DecisionApprovalState;
     action: "created" | "changed" | "deleted" | "restored";
+    title: string;
     text: string;
     kind: "design" | "business_rule" | "architecture" | "other";
     impact: number;
     confidence: number;
-    made_by: "human" | "agent";
+    made_by: "agent" | "human";
     made_by_user_id: null | number;
     made_by_name: null | string;
     made_by_author: AuthorV2;
     made_by_is_writer: boolean;
-    provenance: DecisionProvenanceView;
+    provenance: Array<ProvenanceRecordV2>;
     author: string;
     by: AuthorV2;
     via_key: null | ViaKey;
@@ -1070,16 +1102,17 @@ declare module "@danxbot/card-kit@1" {
     version_no: number;
     approval: DecisionApprovalState;
     action: "created" | "changed" | "deleted" | "restored";
+    title: string;
     text: string;
     kind: "design" | "business_rule" | "architecture" | "other";
     impact: number;
     confidence: number;
-    made_by: "human" | "agent";
+    made_by: "agent" | "human";
     made_by_user_id: null | number;
     made_by_name: null | string;
     made_by_author: AuthorV2;
     made_by_is_writer: boolean;
-    provenance: DecisionProvenanceView;
+    provenance: Array<ProvenanceRecordV2>;
     author: string;
     by: AuthorV2;
     via_key: null | ViaKey;
@@ -1095,6 +1128,15 @@ declare module "@danxbot/card-kit@1" {
     by_name: string;
     at: string;
   }>);
+    work_marks?: undefined | Array<{
+    id: number;
+    via_key_id: number;
+    resource: WorkMarkResource;
+    note: string;
+    by: AuthorV2;
+    started_at: string;
+    expires_at: string;
+  }>;
     designs?: undefined | (Array<{
     id: number;
     design_no: number;
@@ -1249,7 +1291,7 @@ declare module "@danxbot/card-kit@1" {
     phase: "plan" | "code";
   };
   type ProblemViewV2 = {
-    type: "question" | "action" | "design" | "decision_review";
+    type: "design" | "question" | "action" | "decision_review";
     open: boolean;
     ordinal: number;
     id: number;
@@ -1258,6 +1300,7 @@ declare module "@danxbot/card-kit@1" {
     content_hash: string;
     summary: null | string;
     comment_count: number;
+    unread_comment_count: number;
     decisions: Array<{
     id: number;
     problem_id: number;
@@ -1271,7 +1314,7 @@ declare module "@danxbot/card-kit@1" {
     decided_at: string;
     retracted_at: null | string;
     relayed_by_session: null | string;
-    provenance: null | DecisionProvenanceV2;
+    provenance: null | ProvenanceRecordV2;
     content_hash: string;
   }>;
     feedback_consent: boolean;
@@ -1296,16 +1339,17 @@ declare module "@danxbot/card-kit@1" {
     version_no: number;
     approval: DecisionApprovalState;
     action: "created" | "changed" | "deleted" | "restored";
+    title: string;
     text: string;
     kind: "design" | "business_rule" | "architecture" | "other";
     impact: number;
     confidence: number;
-    made_by: "human" | "agent";
+    made_by: "agent" | "human";
     made_by_user_id: null | number;
     made_by_name: null | string;
     made_by_author: AuthorV2;
     made_by_is_writer: boolean;
-    provenance: DecisionProvenanceView;
+    provenance: Array<ProvenanceRecordV2>;
     author: string;
     by: AuthorV2;
     via_key: null | ViaKey;
@@ -1400,7 +1444,7 @@ declare module "@danxbot/card-kit@1" {
       decided_at: string;
       retracted_at: string | null;
       relayed_by_session: string | null;
-      provenance: DecisionProvenanceV2 | null;
+      provenance: ProvenanceRecordV2 | null;
       content_hash: string;
   }
   interface CardRefViewV2 {

package/dist/cli.js

@@ -5891,7 +5891,7 @@ var CARD_KIT_LIBRARY = "@danxbot/card-kit";
 var PLUGIN_RUNTIME_LIBRARIES = [
   { name: "react", major: 19 },
   { name: "react-dom", major: 19 },
-  { name: "@danxbot/ui", major: 28 },
+  { name: "@danxbot/ui", major: 30 },
   { name: CARD_KIT_LIBRARY, major: CARD_KIT_MAJOR }
 ];
 var PLUGIN_RUNTIME_SPECIFIERS = [

package/dist/publish.js

@@ -5886,7 +5886,7 @@ var CARD_KIT_LIBRARY = "@danxbot/card-kit";
 var PLUGIN_RUNTIME_LIBRARIES = [
   { name: "react", major: 19 },
   { name: "react-dom", major: 19 },
-  { name: "@danxbot/ui", major: 28 },
+  { name: "@danxbot/ui", major: 30 },
   { name: CARD_KIT_LIBRARY, major: CARD_KIT_MAJOR }
 ];
 var PLUGIN_RUNTIME_SPECIFIERS = [

package/dist/vite.js

@@ -4,7 +4,7 @@ var CARD_KIT_LIBRARY = "@danxbot/card-kit";
 var PLUGIN_RUNTIME_LIBRARIES = [
   { name: "react", major: 19 },
   { name: "react-dom", major: 19 },
-  { name: "@danxbot/ui", major: 28 },
+  { name: "@danxbot/ui", major: 30 },
   { name: CARD_KIT_LIBRARY, major: CARD_KIT_MAJOR }
 ];
 var PLUGIN_RUNTIME_SPECIFIERS = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/plugin-sdk",
-  "version": "0.2.38",
+  "version": "0.2.41",
   "description": "SDK for building 50 Arms card-type plugins (DX-5170): the card kit's type declarations, a Vite preset that builds a plugin against the app's shared runtime and writes its manifest, and the danx-plugin CLI.",
   "license": "MIT",
   "type": "module",
@@ -33,7 +33,7 @@
     "node": ">=20"
   },
   "peerDependencies": {
-    "@danxbot/ui": "^28.0.0",
+    "@danxbot/ui": "^30.0.0",
     "@types/react": "^19.0.0",
     "react": "^19.0.0",
     "react-router": "^7.0.0",
@@ -46,7 +46,7 @@
     "test": "vitest run"
   },
   "devDependencies": {
-    "@danxbot/ui": "28.14.0",
+    "@danxbot/ui": "30.1.0",
     "@types/node": "^22.0.0",
     "@types/react": "^19.2.2",
     "esbuild": "^0.25.0",