@moxellabs/drift 0.1.0

package/dist/bin.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import{spawnSync as p}from"node:child_process";import{existsSync as o}from"node:fs";import{dirname as i,join as a}from"node:path";import{createRequire as g}from"node:module";import{fileURLToPath as f}from"node:url";var u=g(import.meta.url),c=i(f(import.meta.url)),R=i(c);function l(){return process.report?.getReport?.()?.header?.glibcVersionRuntime?"glibc":"musl"}function d(){let{platform:r,arch:e}=process;if(r==="linux"&&e==="x64"&&l()==="glibc")return{packageName:"@moxellabs/drift-linux-x64-gnu",addonFilename:"moxel-drift.linux-x64-gnu.node",bridgeFilename:"moxel-drift-bridge",cliFilename:"moxel-drift-cli"};if(r==="linux"&&e==="arm64"&&l()==="glibc")return{packageName:"@moxellabs/drift-linux-arm64-gnu",addonFilename:"moxel-drift.linux-arm64-gnu.node",bridgeFilename:"moxel-drift-bridge",cliFilename:"moxel-drift-cli"};if(r==="darwin"&&e==="x64")return{packageName:"@moxellabs/drift-darwin-x64",addonFilename:"moxel-drift.darwin-x64.node",bridgeFilename:"moxel-drift-bridge",cliFilename:"moxel-drift-cli"};if(r==="darwin"&&e==="arm64")return{packageName:"@moxellabs/drift-darwin-arm64",addonFilename:"moxel-drift.darwin-arm64.node",bridgeFilename:"moxel-drift-bridge",cliFilename:"moxel-drift-cli"};if(r==="win32"&&e==="x64")return{packageName:"@moxellabs/drift-win32-x64-msvc",addonFilename:"moxel-drift.win32-x64-msvc.node",bridgeFilename:"moxel-drift-bridge.exe",cliFilename:"moxel-drift-cli.exe"};throw Error(`unsupported moxel-drift target ${r}-${e}. Supported targets: linux-x64-glibc, linux-arm64-glibc, darwin-x64, darwin-arm64, win32-x64.`)}function x(){let r=d();try{let e=u.resolve(`${r.packageName}/package.json`);return i(e)}catch{return null}}function m(){let r=x();if(r){let s=d(),t=a(r,"bin",s.cliFilename);if(o(t))return t}let e=process.platform==="win32"?"moxel-drift-cli.exe":"moxel-drift-cli",n=a(c,"bin",e);if(o(n))return n;throw Error(`missing packaged CLI binary for ${process.platform}-${process.arch}. Install the matching @moxellabs/drift carrier package or run \`bun run build\` locally.`)}function b(){let r=m(),e=p(r,process.argv.slice(2),{stdio:"inherit"});if(e.error)throw e.error;process.exit(e.status??1)}b();

package/dist/index.d.ts

@@ -0,0 +1,140 @@
+export type ModuleKind = "react_component" | "react_hook" | "navigation_module" | "composite";
+export type DriftStatus = "clean" | "drift_detected" | "partial" | "error";
+export type CompatibilityClass = "none" | "patch_safe" | "minor_additive" | "breaking" | "unknown";
+export type FindingKind = "missing_generated_docs" | "stale_generated_docs" | "broken_example" | "partial_extraction" | "extraction_error" | "missing_baseline_snapshot" | "new_public_module" | "removed_public_module" | "breaking_interface_change" | "minor_additive_interface_change" | "unknown_compatibility";
+export type ReportFormat = "json" | "terminal" | "sarif" | "github_markdown" | "github-markdown" | "compact";
+export type BridgeRuntimeKind = "node" | "bun" | "standalone";
+export interface Provenance {
+    file_path: string;
+    line_start?: number;
+    line_end?: number;
+}
+export interface Diagnostic {
+    level: "info" | "warn" | "error";
+    message: string;
+    provenance: Provenance[];
+}
+export type ExampleStatus = "not_checked" | "passed" | "failed";
+export interface ExampleContract {
+    example_id: string;
+    file_path: string;
+    status: ExampleStatus;
+    diagnostics: Diagnostic[];
+}
+export interface Finding {
+    finding_id: string;
+    kind: FindingKind;
+    severity: "info" | "low" | "medium" | "high" | "critical";
+    message: string;
+    provenance: Provenance[];
+    expected?: string;
+    actual?: string;
+    remediation?: string;
+}
+export interface ModuleArtifacts {
+    ledger_path: string;
+    docs_path: string;
+}
+export interface ModuleReport {
+    module_id: string;
+    module_kind: ModuleKind;
+    contract_hash?: string;
+    compatibility: CompatibilityClass;
+    status: DriftStatus;
+    examples: ExampleContract[];
+    findings: Finding[];
+    diagnostics: Diagnostic[];
+    artifacts: ModuleArtifacts;
+}
+export interface ScanSummary {
+    total_modules: number;
+    clean_modules: number;
+    drift_modules: number;
+    partial_modules: number;
+    error_modules: number;
+}
+export interface DriftReport {
+    schema_version: number;
+    scan_summary: ScanSummary;
+    execution: ExecutionSummary;
+    modules: ModuleReport[];
+}
+export interface ExecutionSummary {
+    schema_version: number;
+    modules_discovered: number;
+    modules_processed: number;
+    modules_reused: number;
+    cache_hits: number;
+    cache_misses: number;
+    ledger_writes: number;
+    docs_writes: number;
+}
+export interface BridgeRuntimeOptions {
+    kind?: BridgeRuntimeKind;
+    executable_path?: string;
+    bridge_entrypoint?: string;
+}
+export interface ScanOptions {
+    config_path?: string;
+    incremental?: IncrementalOptions;
+    bridge?: BridgeRuntimeOptions;
+}
+export interface CheckOptions {
+    config_path?: string;
+    incremental?: IncrementalOptions;
+    bridge?: BridgeRuntimeOptions;
+}
+export interface GenerateDocsOptions {
+    config_path?: string;
+    incremental?: IncrementalOptions;
+    bridge?: BridgeRuntimeOptions;
+}
+export interface DiffOptions {
+    baseline_path?: string;
+    config_path?: string;
+    incremental?: IncrementalOptions;
+    bridge?: BridgeRuntimeOptions;
+}
+export interface IncrementalOptions {
+    enabled?: boolean;
+    since?: string;
+    base?: string;
+}
+export interface RenderReportOptions {
+    format: ReportFormat;
+}
+export interface GenerationSummary {
+    report: DriftReport;
+    ledger_writes: number;
+    docs_writes: number;
+}
+export type BindingsErrorCode = "invalid_argument" | "invalid_config" | "runtime_resolution" | "extraction_failure" | "io" | "serialization" | "cache_corruption" | "git_failure";
+export declare class MoxelDriftError extends Error {
+    readonly code: BindingsErrorCode;
+    constructor(code: BindingsErrorCode, message: string);
+}
+/**
+ * Returns the native bindings implementation version.
+ */
+export declare function bindingsVersion(): string;
+/**
+ * Runs the source scan pipeline through the native Rust runtime and packaged TS
+ * bridge.
+ */
+export declare function scan(path: string, options?: ScanOptions): Promise<DriftReport>;
+/**
+ * Runs policy-aware verification through the native Rust runtime.
+ */
+export declare function check(path: string, options?: CheckOptions): Promise<DriftReport>;
+/**
+ * Generates canonical ledgers and docs through the native Rust runtime.
+ */
+export declare function generateDocs(path: string, options?: GenerateDocsOptions): Promise<GenerationSummary>;
+/**
+ * Computes compatibility drift against baseline ledgers.
+ */
+export declare function diff(path: string, options?: DiffOptions): Promise<DriftReport>;
+/**
+ * Renders a report into one of the supported deterministic output formats.
+ */
+export declare function renderReport(report: DriftReport, options: RenderReportOptions): Promise<string>;

package/dist/index.js

@@ -0,0 +1 @@
+import{createRequire as h}from"node:module";import{existsSync as l}from"node:fs";import{dirname as m,join as c}from"node:path";import{createRequire as F}from"node:module";import{fileURLToPath as k}from"node:url";var w=F(import.meta.url),d=m(k(import.meta.url)),_=m(d);function x(){return process.report?.getReport?.()?.header?.glibcVersionRuntime?"glibc":"musl"}function g(){let{platform:e,arch:r}=process;if(e==="linux"&&r==="x64"&&x()==="glibc")return{packageName:"@moxellabs/drift-linux-x64-gnu",addonFilename:"moxel-drift.linux-x64-gnu.node",bridgeFilename:"moxel-drift-bridge",cliFilename:"moxel-drift-cli"};if(e==="linux"&&r==="arm64"&&x()==="glibc")return{packageName:"@moxellabs/drift-linux-arm64-gnu",addonFilename:"moxel-drift.linux-arm64-gnu.node",bridgeFilename:"moxel-drift-bridge",cliFilename:"moxel-drift-cli"};if(e==="darwin"&&r==="x64")return{packageName:"@moxellabs/drift-darwin-x64",addonFilename:"moxel-drift.darwin-x64.node",bridgeFilename:"moxel-drift-bridge",cliFilename:"moxel-drift-cli"};if(e==="darwin"&&r==="arm64")return{packageName:"@moxellabs/drift-darwin-arm64",addonFilename:"moxel-drift.darwin-arm64.node",bridgeFilename:"moxel-drift-bridge",cliFilename:"moxel-drift-cli"};if(e==="win32"&&r==="x64")return{packageName:"@moxellabs/drift-win32-x64-msvc",addonFilename:"moxel-drift.win32-x64-msvc.node",bridgeFilename:"moxel-drift-bridge.exe",cliFilename:"moxel-drift-cli.exe"};throw Error(`unsupported moxel-drift target ${e}-${r}. Supported targets: linux-x64-glibc, linux-arm64-glibc, darwin-x64, darwin-arm64, win32-x64.`)}function f(){let e=g();try{let r=w.resolve(`${e.packageName}/package.json`);return m(r)}catch{return null}}function s(){let e=g(),r=f();if(r){let a=c(r,"native",e.addonFilename);if(l(a))return a}let i=c(d,"native",`moxel-drift.${process.platform}-${process.arch}.node`);if(l(i))return i;throw Error(`missing native addon for ${process.platform}-${process.arch}. Install the matching @moxellabs/drift carrier package or run \`bun run build\` locally.`)}function u(){let e=f();if(e){let i=g(),a=c(e,"bridge",i.bridgeFilename);if(l(a))return{kind:"standalone",executable_path:a}}let r=c(d,"bridge","index.js");if(l(r))return{kind:process.versions.bun?"bun":"node",executable_path:process.execPath,bridge_entrypoint:r};throw Error(`missing packaged bridge runtime for ${process.platform}-${process.arch}. Install the matching @moxellabs/drift carrier package or run \`bun run build\` locally.`)}class b extends Error{code;constructor(e,r){super(r);this.name="MoxelDriftError",this.code=e}}var p=h(import.meta.url),n=$();function $(){return p(s())}function o(e){let r=u();return{...e??{},bridge:{kind:r.kind,executable_path:r.executable_path,bridge_entrypoint:r.bridge_entrypoint,...e?.bridge??{}}}}function t(e){let r=JSON.parse(e);if(!r.ok||!("data"in r)){let i=r.error??{code:"serialization",message:"native runtime returned an invalid envelope"};throw new b(i.code,i.message)}return r.data}function T(){return n.bindingsVersion()}async function j(e,r){let i=await n.scanSerialized(e,JSON.stringify(o(r)));return t(i)}async function K(e,r){let i=await n.checkSerialized(e,JSON.stringify(o(r)));return t(i)}async function S(e,r){let i=await n.generateDocsSerialized(e,JSON.stringify(o(r)));return t(i)}async function V(e,r){let i=await n.diffSerialized(e,JSON.stringify(o(r)));return t(i)}async function A(e,r){let i=await n.renderReportSerialized(JSON.stringify(e),JSON.stringify(r));return t(i)}export{j as scan,A as renderReport,S as generateDocs,V as diff,K as check,T as bindingsVersion,b as MoxelDriftError};

package/dist/runtime-assets.js

@@ -0,0 +1 @@
+import{existsSync as t}from"node:fs";import{dirname as c,join as a}from"node:path";import{createRequire as g}from"node:module";import{fileURLToPath as u}from"node:url";var f=g(import.meta.url),o=c(u(import.meta.url)),F=c(o);function s(){return process.report?.getReport?.()?.header?.glibcVersionRuntime?"glibc":"musl"}function l(){let{platform:e,arch:r}=process;if(e==="linux"&&r==="x64"&&s()==="glibc")return{packageName:"@moxellabs/drift-linux-x64-gnu",addonFilename:"moxel-drift.linux-x64-gnu.node",bridgeFilename:"moxel-drift-bridge",cliFilename:"moxel-drift-cli"};if(e==="linux"&&r==="arm64"&&s()==="glibc")return{packageName:"@moxellabs/drift-linux-arm64-gnu",addonFilename:"moxel-drift.linux-arm64-gnu.node",bridgeFilename:"moxel-drift-bridge",cliFilename:"moxel-drift-cli"};if(e==="darwin"&&r==="x64")return{packageName:"@moxellabs/drift-darwin-x64",addonFilename:"moxel-drift.darwin-x64.node",bridgeFilename:"moxel-drift-bridge",cliFilename:"moxel-drift-cli"};if(e==="darwin"&&r==="arm64")return{packageName:"@moxellabs/drift-darwin-arm64",addonFilename:"moxel-drift.darwin-arm64.node",bridgeFilename:"moxel-drift-bridge",cliFilename:"moxel-drift-cli"};if(e==="win32"&&r==="x64")return{packageName:"@moxellabs/drift-win32-x64-msvc",addonFilename:"moxel-drift.win32-x64-msvc.node",bridgeFilename:"moxel-drift-bridge.exe",cliFilename:"moxel-drift-cli.exe"};throw Error(`unsupported moxel-drift target ${e}-${r}. Supported targets: linux-x64-glibc, linux-arm64-glibc, darwin-x64, darwin-arm64, win32-x64.`)}function d(){let e=l();try{let r=f.resolve(`${e.packageName}/package.json`);return c(r)}catch{return null}}function w(){let e=l(),r=d();if(r){let n=a(r,"native",e.addonFilename);if(t(n))return n}let i=a(o,"native",`moxel-drift.${process.platform}-${process.arch}.node`);if(t(i))return i;throw Error(`missing native addon for ${process.platform}-${process.arch}. Install the matching @moxellabs/drift carrier package or run \`bun run build\` locally.`)}function k(){let e=d();if(e){let i=l(),n=a(e,"bridge",i.bridgeFilename);if(t(n))return{kind:"standalone",executable_path:n}}let r=a(o,"bridge","index.js");if(t(r))return{kind:process.versions.bun?"bun":"node",executable_path:process.execPath,bridge_entrypoint:r};throw Error(`missing packaged bridge runtime for ${process.platform}-${process.arch}. Install the matching @moxellabs/drift carrier package or run \`bun run build\` locally.`)}function R(){let e=d();if(e){let n=l(),m=a(e,"bin",n.cliFilename);if(t(m))return m}let r=process.platform==="win32"?"moxel-drift-cli.exe":"moxel-drift-cli",i=a(o,"bin",r);if(t(i))return i;throw Error(`missing packaged CLI binary for ${process.platform}-${process.arch}. Install the matching @moxellabs/drift carrier package or run \`bun run build\` locally.`)}export{w as resolveNativeAddonPath,R as resolveCliBinaryPath,k as resolveBridgeRuntime};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@moxellabs/drift",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "moxel-drift": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "bun": ">=1.3.0"
+  },
+  "optionalDependencies": {
+    "@moxellabs/drift-linux-x64-gnu": "0.1.0",
+    "@moxellabs/drift-linux-arm64-gnu": "0.1.0",
+    "@moxellabs/drift-darwin-x64": "0.1.0",
+    "@moxellabs/drift-darwin-arm64": "0.1.0",
+    "@moxellabs/drift-win32-x64-msvc": "0.1.0"
+  }
+}