@namzu/cli 16.0.0 → 16.1.0

package/dist/integrations/state/report.d.ts

@@ -0,0 +1,125 @@
+export type StateCategory = 'authored' | 'configuration' | 'runtime' | 'control' | 'transient' | 'unknown';
+export interface StateMeasure {
+    readonly files: number;
+    readonly logicalBytes: number;
+}
+export interface StateIssue {
+    readonly code: 'corrupt_metadata' | 'entry_changed' | 'inspection_skipped' | 'owner_mismatch' | 'permission_denied' | 'symlink_not_followed' | 'unsupported_entry' | 'unreadable';
+    readonly path: string;
+    readonly detail: string;
+}
+export interface StatePrivacyBoundary {
+    readonly path: string;
+    readonly status: 'secure' | 'insecure' | 'unknown';
+    readonly detail: string;
+}
+export interface StateInventory {
+    readonly sessions: StateMeasure & {
+        readonly directories: number;
+        readonly invalidOrMissingRecords: number;
+    };
+    readonly originOnlySessionCandidates: StateMeasure & {
+        readonly complete: boolean;
+        readonly limitation: string;
+    };
+    readonly runs: StateMeasure & {
+        readonly directories: number;
+        readonly invalidOrMissingRecords: number;
+    };
+    readonly checkpointFiles: StateMeasure;
+    readonly emergencyDumpFiles: StateMeasure;
+    readonly attachments: StateMeasure & {
+        readonly pairs: number;
+        readonly orphanedDataFiles: number;
+        readonly orphanedTypeFiles: number;
+    };
+}
+export type ProjectBinding = {
+    readonly status: 'uninitialized';
+    readonly detail: string;
+} | {
+    readonly status: 'missing-pointer';
+    readonly detail: string;
+} | {
+    readonly status: 'invalid-pointer';
+    readonly detail: string;
+} | {
+    readonly status: 'missing-project';
+    readonly projectId: string;
+    readonly detail: string;
+} | {
+    readonly status: 'corrupt-project';
+    readonly projectId: string;
+    readonly detail: string;
+} | {
+    readonly status: 'legacy-unbound';
+    readonly projectId: string;
+    readonly detail: string;
+} | {
+    readonly status: 'root-mismatch';
+    readonly projectId: string;
+    readonly recordedRoot: string;
+    readonly detail: string;
+} | {
+    readonly status: 'bound';
+    readonly projectId: string;
+    readonly detail: string;
+} | {
+    readonly status: 'unknown';
+    readonly detail: string;
+};
+export interface StateRootReport {
+    readonly path: string;
+    readonly roles: readonly ('project' | 'user')[];
+    readonly exists: boolean;
+    readonly complete: boolean;
+    readonly files: number;
+    readonly directories: number;
+    readonly logicalBytes: number;
+    readonly categories: Readonly<Record<StateCategory, StateMeasure>>;
+    readonly inventory: StateInventory;
+    readonly privacy: readonly StatePrivacyBoundary[];
+    readonly issues: readonly StateIssue[];
+    readonly omittedIssues: number;
+}
+export interface NamzuStateReport {
+    readonly version: 1;
+    readonly readOnly: true;
+    readonly snapshot: {
+        readonly consistency: 'best-effort-unlocked';
+        readonly detail: string;
+    };
+    readonly complete: boolean;
+    readonly scopeRoots: {
+        readonly project: string;
+        readonly user: string;
+        readonly overlap: boolean;
+    };
+    readonly physicalTotals: StateMeasure & {
+        readonly roots: number;
+    };
+    readonly roots: readonly StateRootReport[];
+    readonly projectConfig: {
+        readonly path: string;
+        readonly status: 'present' | 'absent' | 'unreadable' | 'unsupported';
+        readonly logicalBytes: number;
+    };
+    readonly projectBinding: ProjectBinding;
+}
+export interface InspectNamzuStateOptions {
+    readonly cwd?: string;
+    readonly home?: string;
+    readonly platform?: NodeJS.Platform;
+    readonly uid?: number;
+    /** Internal test seam; the production command uses the bounded default. */
+    readonly entryLimit?: number;
+}
+/**
+ * Inspect Namzu's filesystem estate without constructing a store or changing it.
+ *
+ * Store constructors are intentionally absent here. Several of them create or
+ * heal paths while opening, which would make a report about an untouched tree
+ * change the tree it claims to describe.
+ */
+export declare function inspectNamzuState(options?: InspectNamzuStateOptions): Promise<NamzuStateReport>;
+//# sourceMappingURL=report.d.ts.map

package/dist/integrations/state/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/integrations/state/report.ts"],"names":[],"mappings":"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"}