@stoneforge/quarry 0.1.0

package/dist/sync/types.d.ts

@@ -0,0 +1,275 @@
+/**
+ * Sync System Types
+ *
+ * Type definitions for the JSONL-based synchronization system.
+ * Enables bidirectional sync between SQLite and git-friendly JSONL format.
+ */
+import type { Element, ElementId, Timestamp, DependencyType } from '@stoneforge/core';
+/**
+ * Serialized element for JSONL export
+ * All element fields inline with ISO 8601 timestamps
+ */
+export interface SerializedElement {
+    /** Element ID */
+    id: string;
+    /** Element type discriminator */
+    type: string;
+    /** ISO 8601 creation timestamp */
+    createdAt: string;
+    /** ISO 8601 update timestamp */
+    updatedAt: string;
+    /** Creator entity ID */
+    createdBy: string;
+    /** Tags array */
+    tags: string[];
+    /** Metadata object */
+    metadata: Record<string, unknown>;
+    /** Content hash for conflict detection */
+    contentHash?: string;
+    /** Document category (for document elements) */
+    category?: string;
+    /** Document status (for document elements) */
+    status?: string;
+    /** Document content type (for document elements) */
+    contentType?: string;
+    /** Document content (for document elements) */
+    content?: string;
+    /** Document version (for document elements) */
+    version?: number;
+    /** Type-specific fields */
+    [key: string]: unknown;
+}
+/**
+ * Serialized dependency for JSONL export
+ */
+export interface SerializedDependency {
+    /** Blocked element ID */
+    blockedId: string;
+    /** Blocker element ID */
+    blockerId: string;
+    /** Dependency type */
+    type: string;
+    /** ISO 8601 creation timestamp */
+    createdAt: string;
+    /** Creator entity ID */
+    createdBy: string;
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Fields excluded from content hash computation
+ * These fields are identity/attribution rather than content
+ */
+export declare const HASH_EXCLUDED_FIELDS: readonly ["id", "createdAt", "updatedAt", "createdBy", "contentHash"];
+/**
+ * Content hash result
+ */
+export interface ContentHashResult {
+    /** SHA256 hash of content fields, hex encoded */
+    hash: string;
+    /** Fields included in hash computation */
+    fields: string[];
+}
+/**
+ * Merge resolution result
+ */
+export declare const MergeResolution: {
+    /** Local version kept */
+    readonly LOCAL_WINS: "local_wins";
+    /** Remote version applied */
+    readonly REMOTE_WINS: "remote_wins";
+    /** Content was identical */
+    readonly IDENTICAL: "identical";
+    /** Tags merged from both */
+    readonly TAGS_MERGED: "tags_merged";
+};
+export type MergeResolution = (typeof MergeResolution)[keyof typeof MergeResolution];
+/**
+ * Conflict record for import results
+ */
+export interface ConflictRecord {
+    /** Conflicting element ID */
+    elementId: ElementId;
+    /** Local content hash */
+    localHash: string;
+    /** Remote content hash */
+    remoteHash: string;
+    /** How conflict was resolved */
+    resolution: MergeResolution;
+    /** Local updatedAt */
+    localUpdatedAt: Timestamp;
+    /** Remote updatedAt */
+    remoteUpdatedAt: Timestamp;
+    /** When resolved */
+    resolvedAt: Timestamp;
+}
+/**
+ * Dependency conflict record
+ */
+export interface DependencyConflictRecord {
+    /** Blocked element ID */
+    blockedId: ElementId;
+    /** Blocker element ID */
+    blockerId: ElementId;
+    /** Dependency type */
+    type: DependencyType;
+    /** How conflict was resolved */
+    resolution: 'added' | 'removed' | 'kept';
+    /** When resolved */
+    resolvedAt: Timestamp;
+}
+/**
+ * Export result
+ */
+export interface ExportResult {
+    /** Number of elements exported */
+    elementsExported: number;
+    /** Number of dependencies exported */
+    dependenciesExported: number;
+    /** Whether this was an incremental export */
+    incremental: boolean;
+    /** Path to elements file */
+    elementsFile: string;
+    /** Path to dependencies file */
+    dependenciesFile: string;
+    /** Export timestamp */
+    exportedAt: Timestamp;
+}
+/**
+ * Import result with conflict tracking
+ */
+export interface ImportResult {
+    /** Number of elements imported */
+    elementsImported: number;
+    /** Number of elements skipped (identical) */
+    elementsSkipped: number;
+    /** Number of dependencies imported */
+    dependenciesImported: number;
+    /** Number of dependencies skipped */
+    dependenciesSkipped: number;
+    /** Element conflicts resolved */
+    conflicts: ConflictRecord[];
+    /** Dependency conflicts resolved */
+    dependencyConflicts: DependencyConflictRecord[];
+    /** Errors encountered (non-fatal) */
+    errors: ImportError[];
+    /** Import timestamp */
+    importedAt: Timestamp;
+}
+/**
+ * Import error record
+ */
+export interface ImportError {
+    /** Line number in file (1-indexed) */
+    line: number;
+    /** File type */
+    file: 'elements' | 'dependencies';
+    /** Error message */
+    message: string;
+    /** Raw line content (truncated) */
+    content?: string;
+}
+/**
+ * Dirty element record
+ */
+export interface DirtyElement {
+    /** Element ID that was modified */
+    elementId: ElementId;
+    /** When it was marked dirty */
+    markedAt: Timestamp;
+    /** Type of modification */
+    operation: 'create' | 'update' | 'delete';
+}
+/**
+ * Dirty dependency record
+ */
+export interface DirtyDependency {
+    /** Blocked element ID */
+    blockedId: ElementId;
+    /** Blocker element ID */
+    blockerId: ElementId;
+    /** Dependency type */
+    type: DependencyType;
+    /** When it was marked dirty */
+    markedAt: Timestamp;
+    /** Type of modification */
+    operation: 'create' | 'delete';
+}
+/**
+ * Current sync status
+ */
+export interface SyncStatus {
+    /** Number of dirty elements */
+    dirtyElementCount: number;
+    /** Number of dirty dependencies */
+    dirtyDependencyCount: number;
+    /** Last export timestamp */
+    lastExportAt?: Timestamp;
+    /** Last import timestamp */
+    lastImportAt?: Timestamp;
+    /** Whether there are pending changes */
+    hasPendingChanges: boolean;
+}
+/**
+ * Options for export operations
+ */
+export interface ExportOptions {
+    /** Output directory path */
+    outputDir: string;
+    /** Perform full export (ignore dirty tracking) */
+    full?: boolean;
+    /** Include ephemeral elements */
+    includeEphemeral?: boolean;
+    /** Elements file name override */
+    elementsFile?: string;
+    /** Dependencies file name override */
+    dependenciesFile?: string;
+}
+/**
+ * Options for import operations
+ */
+export interface ImportOptions {
+    /** Input directory path */
+    inputDir: string;
+    /** Dry run - show what would change */
+    dryRun?: boolean;
+    /** Force overwrite conflicts (remote always wins) */
+    force?: boolean;
+    /** Elements file name override */
+    elementsFile?: string;
+    /** Dependencies file name override */
+    dependenciesFile?: string;
+}
+/**
+ * Tombstone status for merge decisions
+ */
+export declare const TombstoneStatus: {
+    /** Not a tombstone (live element) */
+    readonly LIVE: "live";
+    /** Tombstone within TTL */
+    readonly FRESH: "fresh";
+    /** Tombstone past TTL */
+    readonly EXPIRED: "expired";
+};
+export type TombstoneStatus = (typeof TombstoneStatus)[keyof typeof TombstoneStatus];
+/**
+ * Element with tombstone status for merge
+ */
+export interface ElementWithTombstoneStatus {
+    /** The element data */
+    element: Element;
+    /** Tombstone status */
+    tombstoneStatus: TombstoneStatus;
+    /** Deleted timestamp if tombstone */
+    deletedAt?: Timestamp;
+}
+/**
+ * Element type priority for export ordering
+ * Lower number = exported first (entities first for references)
+ */
+export declare const ELEMENT_TYPE_PRIORITY: Record<string, number>;
+/**
+ * Get sort priority for an element type
+ */
+export declare function getTypePriority(type: string): number;
+//# sourceMappingURL=types.d.ts.map

package/dist/sync/types.d.ts.map

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

package/dist/sync/types.js

@@ -0,0 +1,76 @@
+/**
+ * Sync System Types
+ *
+ * Type definitions for the JSONL-based synchronization system.
+ * Enables bidirectional sync between SQLite and git-friendly JSONL format.
+ */
+// ============================================================================
+// Content Hashing
+// ============================================================================
+/**
+ * Fields excluded from content hash computation
+ * These fields are identity/attribution rather than content
+ */
+export const HASH_EXCLUDED_FIELDS = [
+    'id',
+    'createdAt',
+    'updatedAt',
+    'createdBy',
+    'contentHash',
+];
+// ============================================================================
+// Merge Strategy Types
+// ============================================================================
+/**
+ * Merge resolution result
+ */
+export const MergeResolution = {
+    /** Local version kept */
+    LOCAL_WINS: 'local_wins',
+    /** Remote version applied */
+    REMOTE_WINS: 'remote_wins',
+    /** Content was identical */
+    IDENTICAL: 'identical',
+    /** Tags merged from both */
+    TAGS_MERGED: 'tags_merged',
+};
+// ============================================================================
+// Tombstone Handling
+// ============================================================================
+/**
+ * Tombstone status for merge decisions
+ */
+export const TombstoneStatus = {
+    /** Not a tombstone (live element) */
+    LIVE: 'live',
+    /** Tombstone within TTL */
+    FRESH: 'fresh',
+    /** Tombstone past TTL */
+    EXPIRED: 'expired',
+};
+// ============================================================================
+// Sort Order for Export
+// ============================================================================
+/**
+ * Element type priority for export ordering
+ * Lower number = exported first (entities first for references)
+ */
+export const ELEMENT_TYPE_PRIORITY = {
+    entity: 0,
+    document: 1,
+    task: 2,
+    message: 3,
+    channel: 4,
+    plan: 5,
+    workflow: 6,
+    playbook: 7,
+    library: 8,
+    team: 9,
+};
+/**
+ * Get sort priority for an element type
+ */
+export function getTypePriority(type) {
+    return ELEMENT_TYPE_PRIORITY[type] ?? 100;
+}
+//# sourceMappingURL=types.js.map

package/dist/sync/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sync/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6DH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI;IACJ,WAAW;IACX,WAAW;IACX,WAAW;IACX,aAAa;CACL,CAAC;AAYX,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,yBAAyB;IACzB,UAAU,EAAE,YAAY;IACxB,6BAA6B;IAC7B,WAAW,EAAE,aAAa;IAC1B,4BAA4B;IAC5B,SAAS,EAAE,WAAW;IACtB,4BAA4B;IAC5B,WAAW,EAAE,aAAa;CAClB,CAAC;AA0LX,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,qCAAqC;IACrC,IAAI,EAAE,MAAM;IACZ,2BAA2B;IAC3B,KAAK,EAAE,OAAO;IACd,yBAAyB;IACzB,OAAO,EAAE,SAAS;CACV,CAAC;AAgBX,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;IACX,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;CACR,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;AAC5C,CAAC"}