artifact-graph 0.9.4 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -629,6 +629,32 @@ declare function renderVersionLockAuditMarkdown(result: VersionLockAuditResult,
629
629
  declare function renderVersionLockRefreshMarkdown(result: VersionLockRefreshResult): string;
630
630
  declare function renderTraceVersionMarkdown(result: TraceVersionResult): string;
631
631
 
632
+ type NativeBindingFailedStage = 'load' | 'open' | 'write' | 'read' | 'close';
633
+ type NativeBindingCause = 'MISSING' | 'ABI_MISMATCH' | 'BUILD_DISABLED' | 'LOAD_ERROR';
634
+ interface NativeBindingDiagnostic {
635
+ selectedCli: string;
636
+ runtime: string;
637
+ abi: string;
638
+ installSource: string;
639
+ /** binding probe 实际加载 better-sqlite3 的安装锚点;与 selectedCli 绑定同一安装来源。 */
640
+ probedFrom: string;
641
+ failedStage: NativeBindingFailedStage;
642
+ cause: NativeBindingCause;
643
+ suggestion: string;
644
+ }
645
+ /**
646
+ * F-09-P03:probe 成功时的诊断上下文。成功与失败都必须保留并渲染实际探测来源
647
+ * (probedFrom)与安装来源(installSource),否则成功报告会隐藏选中安装,
648
+ * 双安装/PATH/legacy 场景无法核对分类依据来自哪同一个安装。
649
+ */
650
+ interface NativeBindingSuccessDiagnostic {
651
+ selectedCli: string;
652
+ runtime: string;
653
+ installSource: string;
654
+ probedFrom: string;
655
+ }
656
+ type BindingLoader = () => unknown;
657
+
632
658
  type ArtifactGraphCliSource = 'node_modules' | 'path' | 'legacy' | 'plugin-bundled';
633
659
  interface ArtifactGraphCliCandidate {
634
660
  source: ArtifactGraphCliSource;
@@ -644,6 +670,7 @@ interface ArtifactGraphCliResolution {
644
670
  interface ResolveArtifactGraphCliOptions {
645
671
  projectCliPath?: string;
646
672
  fallbackPath?: string;
673
+ bindingLoader?: BindingLoader;
647
674
  }
648
675
  interface ArtifactChainDoctorReport {
649
676
  schemaVersion: '1.0';
@@ -662,6 +689,11 @@ interface ArtifactChainDoctorReport {
662
689
  path: string;
663
690
  exists: boolean;
664
691
  };
692
+ nativeBinding: ({
693
+ ok: true;
694
+ } & NativeBindingSuccessDiagnostic) | ({
695
+ ok: false;
696
+ } & NativeBindingDiagnostic);
665
697
  supportedCommands: string[];
666
698
  warnings: string[];
667
699
  }
package/dist/index.d.ts CHANGED
@@ -629,6 +629,32 @@ declare function renderVersionLockAuditMarkdown(result: VersionLockAuditResult,
629
629
  declare function renderVersionLockRefreshMarkdown(result: VersionLockRefreshResult): string;
630
630
  declare function renderTraceVersionMarkdown(result: TraceVersionResult): string;
631
631
 
632
+ type NativeBindingFailedStage = 'load' | 'open' | 'write' | 'read' | 'close';
633
+ type NativeBindingCause = 'MISSING' | 'ABI_MISMATCH' | 'BUILD_DISABLED' | 'LOAD_ERROR';
634
+ interface NativeBindingDiagnostic {
635
+ selectedCli: string;
636
+ runtime: string;
637
+ abi: string;
638
+ installSource: string;
639
+ /** binding probe 实际加载 better-sqlite3 的安装锚点;与 selectedCli 绑定同一安装来源。 */
640
+ probedFrom: string;
641
+ failedStage: NativeBindingFailedStage;
642
+ cause: NativeBindingCause;
643
+ suggestion: string;
644
+ }
645
+ /**
646
+ * F-09-P03:probe 成功时的诊断上下文。成功与失败都必须保留并渲染实际探测来源
647
+ * (probedFrom)与安装来源(installSource),否则成功报告会隐藏选中安装,
648
+ * 双安装/PATH/legacy 场景无法核对分类依据来自哪同一个安装。
649
+ */
650
+ interface NativeBindingSuccessDiagnostic {
651
+ selectedCli: string;
652
+ runtime: string;
653
+ installSource: string;
654
+ probedFrom: string;
655
+ }
656
+ type BindingLoader = () => unknown;
657
+
632
658
  type ArtifactGraphCliSource = 'node_modules' | 'path' | 'legacy' | 'plugin-bundled';
633
659
  interface ArtifactGraphCliCandidate {
634
660
  source: ArtifactGraphCliSource;
@@ -644,6 +670,7 @@ interface ArtifactGraphCliResolution {
644
670
  interface ResolveArtifactGraphCliOptions {
645
671
  projectCliPath?: string;
646
672
  fallbackPath?: string;
673
+ bindingLoader?: BindingLoader;
647
674
  }
648
675
  interface ArtifactChainDoctorReport {
649
676
  schemaVersion: '1.0';
@@ -662,6 +689,11 @@ interface ArtifactChainDoctorReport {
662
689
  path: string;
663
690
  exists: boolean;
664
691
  };
692
+ nativeBinding: ({
693
+ ok: true;
694
+ } & NativeBindingSuccessDiagnostic) | ({
695
+ ok: false;
696
+ } & NativeBindingDiagnostic);
665
697
  supportedCommands: string[];
666
698
  warnings: string[];
667
699
  }