@drewpayment/mink 0.10.0 → 0.11.0-beta.1

package/src/core/scanner.ts

@@ -87,13 +87,29 @@ export function getExcludes(config: ProjectConfig): string[] {
   return [...DEFAULT_EXCLUDES, ...(config.excludePatterns ?? [])];
 }
 
-export function scanProject(
+export interface ScanStats {
+  files: ScannedFile[];
+  totalScanned: number;
+  truncated: number;
+}
+
+export function scanProjectWithStats(
   projectRoot: string,
   excludes: string[],
   maxFiles: number = DEFAULT_MAX_FILES
-): ScannedFile[] {
+): ScanStats {
   const results: ScannedFile[] = [];
   walkDirectory(projectRoot, projectRoot, excludes, results);
   results.sort((a, b) => b.mtimeMs - a.mtimeMs);
-  return results.slice(0, maxFiles);
+  const totalScanned = results.length;
+  const files = results.slice(0, maxFiles);
+  return { files, totalScanned, truncated: totalScanned - files.length };
+}
+
+export function scanProject(
+  projectRoot: string,
+  excludes: string[],
+  maxFiles: number = DEFAULT_MAX_FILES
+): ScannedFile[] {
+  return scanProjectWithStats(projectRoot, excludes, maxFiles).files;
 }

package/src/core/sync.ts

@@ -15,7 +15,13 @@ const FETCH_TIMEOUT = 15_000;
 // Sync layout version. Bumped when the on-disk shape of `~/.mink/` changes in
 // a way that older devices cannot read. Migration runs on first session-start
 // after upgrade when readSyncVersion() < MINK_SYNC_VERSION.
-export const MINK_SYNC_VERSION = 2;
+//
+// v1 → v2: per-device shards under projects/<id>/state/<deviceId>/
+// v2 → v3: stable identity — adds aliases[] and pathsByDevice{} on project-meta;
+//          when projects.identity=git-remote, renames per-project directories
+//          from path-derived IDs to git-derived IDs and records prior ID as
+//          alias. Migration is a no-op when the flag is off.
+export const MINK_SYNC_VERSION = 3;
 
 export function readSyncVersion(): number {
   try {

package/src/types/config.ts

@@ -17,6 +17,7 @@ export interface GlobalConfig {
   "cli.auto-update"?: string;
   "cli.auto-update-schedule"?: string;
   "cli.auto-update-package-manager"?: string;
+  "projects.identity"?: string;
 }
 
 export type ConfigKey = keyof GlobalConfig & string;
@@ -170,6 +171,14 @@ export const CONFIG_KEYS: ConfigKeyMeta[] = [
     description: "Force a package manager (auto|npm|bun) for self-upgrade installs",
     scope: "local",
   },
+  {
+    key: "projects.identity",
+    default: "path-derived",
+    envVar: "MINK_PROJECTS_IDENTITY",
+    description:
+      "Project identity strategy: path-derived (legacy) or git-remote (stable across machines)",
+    scope: "shared",
+  },
 ];
 
 const VALID_KEYS = new Set<string>(CONFIG_KEYS.map((k) => k.key));

package/src/types/note.ts

@@ -62,6 +62,7 @@ export interface VaultIndexEntry {
 
 export interface VaultIndex {
   lastScanTimestamp: string;
+  lastFullScanTimestamp?: string;
   totalNotes: number;
   entries: Record<string, VaultIndexEntry>;
 }