opentasks 0.0.1 → 0.0.2

package/dist/core/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/core/hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAgB;IACjD,4CAA4C;IAC5C,MAAM,WAAW,GAA4B;QAC3C,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;QACnD,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;IAEF,uCAAuC;IACvC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,WAAW,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IACvC,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,WAAW,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACvC,WAAW,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QAC/C,WAAW,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IACjD,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,WAAW,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QAC3B,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACnC,CAAC;IAED,iDAAiD;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAChC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAChE,CAAC;IAEF,mCAAmC;IACnC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,UAAU,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,CAAa,EAAE,CAAa;IACvD,OAAO,kBAAkB,CAAC,CAAC,CAAC,KAAK,kBAAkB,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/core/id.d.ts

@@ -0,0 +1,79 @@
+/**
+ * ID generation for OpenTasks
+ *
+ * Uses hash-based IDs with type prefixes for collision resistance
+ * in multi-agent/multi-threaded environments.
+ */
+/**
+ * Node type for ID generation
+ */
+export type IdNodeType = 'context' | 'task' | 'feedback' | 'external' | 'edge';
+/**
+ * Convert a hex string to base36
+ */
+export declare function hexToBase36(hex: string): string;
+/**
+ * Get the type prefix for a node type
+ */
+export declare function typePrefix(type: IdNodeType | string): string;
+/**
+ * Calculate adaptive ID length based on entity count
+ *
+ * Uses birthday paradox to target <1% collision probability.
+ *
+ * For base36 (36 characters):
+ * - 4 chars: 36^4 = 1,679,616 possibilities → safe up to ~980 entities
+ * - 5 chars: 36^5 = 60,466,176 possibilities → safe up to ~5,900 entities
+ * - 6 chars: 36^6 = 2,176,782,336 possibilities → safe up to ~35,000 entities
+ * - 7 chars: 36^7 = 78,364,164,096 possibilities → safe up to ~212,000 entities
+ * - 8 chars: 36^8 = 2,821,109,907,456 possibilities → safe up to ~1.3M entities
+ */
+export declare function adaptiveLength(count: number): number;
+/**
+ * Result of ID generation
+ */
+export interface GeneratedId {
+    /** Short hash-based ID (e.g., "s-a2b3") */
+    id: string;
+    /** Full UUID v4 */
+    uuid: string;
+}
+/**
+ * Generate a new ID for a node
+ *
+ * @param type - The node type (determines prefix)
+ * @param existingCount - Number of existing entities (for adaptive length)
+ * @returns Object with short id and full uuid
+ *
+ * @example
+ * ```ts
+ * const { id, uuid } = generateId('task')
+ * // id: "t-x7k9"
+ * // uuid: "550e8400-e29b-41d4-a716-446655440000"
+ * ```
+ */
+export declare function generateId(type: IdNodeType | string, existingCount?: number): GeneratedId;
+/**
+ * Generate an ID from a specific UUID (for deterministic testing)
+ *
+ * @param type - The node type
+ * @param uuid - The UUID to use
+ * @param existingCount - Number of existing entities
+ * @returns Object with short id and the provided uuid
+ */
+export declare function generateIdFromUuid(type: IdNodeType | string, uuid: string, existingCount?: number): GeneratedId;
+/**
+ * Parse an ID to extract its type prefix
+ *
+ * @param id - The ID to parse (e.g., "s-a2b3")
+ * @returns The type prefix or null if invalid format
+ */
+export declare function parseIdPrefix(id: string): string | null;
+/**
+ * Infer node type from ID prefix
+ *
+ * @param id - The ID to check
+ * @returns The inferred node type or null if unknown
+ */
+export declare function inferTypeFromId(id: string): IdNodeType | null;
+//# sourceMappingURL=id.d.ts.map

package/dist/core/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/core/id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAkB/E;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAe/C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,aAAa,GAAE,MAAU,GAAG,WAAW,CAkB5F;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,IAAI,EAAE,MAAM,EACZ,aAAa,GAAE,MAAU,GACxB,WAAW,CAQb;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAa7D"}

package/dist/core/id.js

@@ -0,0 +1,141 @@
+/**
+ * ID generation for OpenTasks
+ *
+ * Uses hash-based IDs with type prefixes for collision resistance
+ * in multi-agent/multi-threaded environments.
+ */
+import { createHash, randomUUID } from 'node:crypto';
+/**
+ * ID prefixes by type
+ */
+const TYPE_PREFIXES = {
+    context: 'c',
+    task: 't',
+    feedback: 'f',
+    external: 'e',
+    edge: 'x',
+};
+/**
+ * Base36 character set (0-9, a-z)
+ */
+const BASE36_CHARS = '0123456789abcdefghijklmnopqrstuvwxyz';
+/**
+ * Convert a hex string to base36
+ */
+export function hexToBase36(hex) {
+    // Convert hex to BigInt, then to base36
+    const num = BigInt('0x' + hex);
+    let result = '';
+    let remaining = num;
+    if (remaining === 0n)
+        return '0';
+    while (remaining > 0n) {
+        const digit = Number(remaining % 36n);
+        result = BASE36_CHARS[digit] + result;
+        remaining = remaining / 36n;
+    }
+    return result;
+}
+/**
+ * Get the type prefix for a node type
+ */
+export function typePrefix(type) {
+    return TYPE_PREFIXES[type] || 'n';
+}
+/**
+ * Calculate adaptive ID length based on entity count
+ *
+ * Uses birthday paradox to target <1% collision probability.
+ *
+ * For base36 (36 characters):
+ * - 4 chars: 36^4 = 1,679,616 possibilities → safe up to ~980 entities
+ * - 5 chars: 36^5 = 60,466,176 possibilities → safe up to ~5,900 entities
+ * - 6 chars: 36^6 = 2,176,782,336 possibilities → safe up to ~35,000 entities
+ * - 7 chars: 36^7 = 78,364,164,096 possibilities → safe up to ~212,000 entities
+ * - 8 chars: 36^8 = 2,821,109,907,456 possibilities → safe up to ~1.3M entities
+ */
+export function adaptiveLength(count) {
+    if (count < 980)
+        return 4;
+    if (count < 5900)
+        return 5;
+    if (count < 35000)
+        return 6;
+    if (count < 212000)
+        return 7;
+    return 8;
+}
+/**
+ * Generate a new ID for a node
+ *
+ * @param type - The node type (determines prefix)
+ * @param existingCount - Number of existing entities (for adaptive length)
+ * @returns Object with short id and full uuid
+ *
+ * @example
+ * ```ts
+ * const { id, uuid } = generateId('task')
+ * // id: "t-x7k9"
+ * // uuid: "550e8400-e29b-41d4-a716-446655440000"
+ * ```
+ */
+export function generateId(type, existingCount = 0) {
+    // 1. Generate UUID v4
+    const uuid = randomUUID();
+    // 2. SHA256 hash the UUID
+    const hash = createHash('sha256').update(uuid).digest('hex');
+    // 3. Convert to base36
+    const base36 = hexToBase36(hash);
+    // 4. Get adaptive length
+    const length = adaptiveLength(existingCount);
+    // 5. Prepend type prefix
+    const prefix = typePrefix(type);
+    const id = `${prefix}-${base36.slice(0, length)}`;
+    return { id, uuid };
+}
+/**
+ * Generate an ID from a specific UUID (for deterministic testing)
+ *
+ * @param type - The node type
+ * @param uuid - The UUID to use
+ * @param existingCount - Number of existing entities
+ * @returns Object with short id and the provided uuid
+ */
+export function generateIdFromUuid(type, uuid, existingCount = 0) {
+    const hash = createHash('sha256').update(uuid).digest('hex');
+    const base36 = hexToBase36(hash);
+    const length = adaptiveLength(existingCount);
+    const prefix = typePrefix(type);
+    const id = `${prefix}-${base36.slice(0, length)}`;
+    return { id, uuid };
+}
+/**
+ * Parse an ID to extract its type prefix
+ *
+ * @param id - The ID to parse (e.g., "s-a2b3")
+ * @returns The type prefix or null if invalid format
+ */
+export function parseIdPrefix(id) {
+    const match = id.match(/^([a-z])-/);
+    return match ? match[1] : null;
+}
+/**
+ * Infer node type from ID prefix
+ *
+ * @param id - The ID to check
+ * @returns The inferred node type or null if unknown
+ */
+export function inferTypeFromId(id) {
+    const prefix = parseIdPrefix(id);
+    if (!prefix)
+        return null;
+    const prefixToType = {
+        c: 'context',
+        t: 'task',
+        f: 'feedback',
+        e: 'external',
+        x: 'edge',
+    };
+    return prefixToType[prefix] || null;
+}
+//# sourceMappingURL=id.js.map

package/dist/core/id.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Core utilities for OpenTasks
+ *
+ * @packageDocumentation
+ */
+export { generateId, generateIdFromUuid, typePrefix, adaptiveLength, hexToBase36, parseIdPrefix, inferTypeFromId, type IdNodeType, type GeneratedId, } from './id.js';
+export { sha256, computeContentHash, contentEqual } from './hash.js';
+export { generateLocationHash, generateLocationHashFallback, generateLocationIdentity, getGitRemoteUrl, getGitRoot, isValidLocationHash, type LocationIdentity, } from './location.js';
+export { parseOpentasksUri, resolveLocationTarget, resolveOpentasksUri, isOpentasksUri, buildOpentasksUri, buildLocalUri, type ParsedOpentasksUri, type ResolvedLocationTarget, type ResolvedLocation, } from './uri.js';
+export { createConnection, checkConnectionHealth, addConnection, removeConnection, findConnection, checkAllConnectionHealth, type Connection, type ConnectionRole, type ConnectionHealth, type ConnectionStatus, } from './connections.js';
+export { matchPattern, findRedirectRule, resolveRedirect, resolveOperationRedirect, type RedirectOperation, type RedirectRule, type RedirectResult, } from './redirects.js';
+export { evaluateConditions, findConditionalRedirectRule, type RedirectCondition, type ConditionalRedirectRule, type RedirectContext, } from './conditional-redirects.js';
+export { worktreeSetup, worktreeTeardown, registerWorktree, unregisterWorktree, findWorktree, listWorktrees, readWorktreeRegistry, writeWorktreeRegistry, getGitCommonDir, getCurrentBranch, getRegistryPath, type WorktreeEntry, type WorktreeRegistry, type WorktreeSetupOptions, type WorktreeTeardownOptions, } from './worktree.js';
+export { mergeJsonl, parseJsonlToMap, writeJsonlFromMap, fieldLevelMerge, deepEqual, installMergeDriver, } from './merge-driver.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,eAAe,EACf,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGrE,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,EACxB,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,GACrB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,24 @@
+/**
+ * Core utilities for OpenTasks
+ *
+ * @packageDocumentation
+ */
+// ID generation
+export { generateId, generateIdFromUuid, typePrefix, adaptiveLength, hexToBase36, parseIdPrefix, inferTypeFromId, } from './id.js';
+// Content hashing
+export { sha256, computeContentHash, contentEqual } from './hash.js';
+// Location identity (Phase 2)
+export { generateLocationHash, generateLocationHashFallback, generateLocationIdentity, getGitRemoteUrl, getGitRoot, isValidLocationHash, } from './location.js';
+// URI scheme (Phase 2)
+export { parseOpentasksUri, resolveLocationTarget, resolveOpentasksUri, isOpentasksUri, buildOpentasksUri, buildLocalUri, } from './uri.js';
+// Connections (Phase 2)
+export { createConnection, checkConnectionHealth, addConnection, removeConnection, findConnection, checkAllConnectionHealth, } from './connections.js';
+// Redirects (Phase 2)
+export { matchPattern, findRedirectRule, resolveRedirect, resolveOperationRedirect, } from './redirects.js';
+// Conditional Redirects (Phase 3)
+export { evaluateConditions, findConditionalRedirectRule, } from './conditional-redirects.js';
+// Worktree Management (Phase 3)
+export { worktreeSetup, worktreeTeardown, registerWorktree, unregisterWorktree, findWorktree, listWorktrees, readWorktreeRegistry, writeWorktreeRegistry, getGitCommonDir, getCurrentBranch, getRegistryPath, } from './worktree.js';
+// Merge Driver (Phase 3)
+export { mergeJsonl, parseJsonlToMap, writeJsonlFromMap, fieldLevelMerge, deepEqual, installMergeDriver, } from './merge-driver.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gBAAgB;AAChB,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,eAAe,GAGhB,MAAM,SAAS,CAAC;AAEjB,kBAAkB;AAClB,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAErE,8BAA8B;AAC9B,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,EACxB,eAAe,EACf,UAAU,EACV,mBAAmB,GAEpB,MAAM,eAAe,CAAC;AAEvB,uBAAuB;AACvB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,aAAa,GAId,MAAM,UAAU,CAAC;AAElB,wBAAwB;AACxB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,wBAAwB,GAKzB,MAAM,kBAAkB,CAAC;AAE1B,sBAAsB;AACtB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,wBAAwB,GAIzB,MAAM,gBAAgB,CAAC;AAExB,kCAAkC;AAClC,OAAO,EACL,kBAAkB,EAClB,2BAA2B,GAI5B,MAAM,4BAA4B,CAAC;AAEpC,gCAAgC;AAChC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAKhB,MAAM,eAAe,CAAC;AAEvB,yBAAyB;AACzB,OAAO,EACL,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/core/location.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Location Identity for OpenTasks (Phase 2)
+ *
+ * Generates deterministic location hashes from git remote URL + path.
+ * Used for cross-location references in opentasks:// URIs.
+ */
+/**
+ * Location identity stored in config.json
+ */
+export interface LocationIdentity {
+    /** 8-char base36 hash (deterministic from git remote + path) */
+    hash: string;
+    /** UUID v4 (uniqueness guarantee) */
+    uuid: string;
+    /** Human-readable name */
+    name: string;
+}
+/**
+ * Get the git remote URL for a repository
+ *
+ * @param repoRoot - Path to the repository root
+ * @returns The remote URL or null if no remote is configured
+ */
+export declare function getGitRemoteUrl(repoRoot: string): string | null;
+/**
+ * Get the git repository root directory
+ *
+ * @param cwd - Working directory to start from
+ * @returns The repository root or null if not in a git repo
+ */
+export declare function getGitRoot(cwd: string): string | null;
+/**
+ * Generate a deterministic location hash from git remote URL and relative path
+ *
+ * The hash is stable across machines for the same repo + path combination.
+ *
+ * @param remoteUrl - Git remote URL (e.g., "git@github.com:user/repo.git")
+ * @param relativePath - Path relative to repo root (e.g., "." or "packages/app")
+ * @returns 8-character base36 hash
+ */
+export declare function generateLocationHash(remoteUrl: string, relativePath: string): string;
+/**
+ * Generate a fallback location hash from an absolute path
+ *
+ * Used when the repository has no remote configured.
+ * NOT stable across machines.
+ *
+ * @param absolutePath - Absolute path to the .opentasks directory
+ * @returns 8-character base36 hash
+ */
+export declare function generateLocationHashFallback(absolutePath: string): string;
+/**
+ * Generate a complete location identity
+ *
+ * Attempts deterministic hash from git remote URL first,
+ * falls back to absolute path hash if no remote is available.
+ *
+ * @param opentasksDir - Path to the .opentasks directory
+ * @param name - Optional human-readable name (defaults to directory name)
+ * @returns Location identity object
+ */
+export declare function generateLocationIdentity(opentasksDir: string, name?: string): LocationIdentity;
+/**
+ * Validate a location hash format
+ *
+ * @param hash - The hash to validate
+ * @returns true if the hash is a valid 8-char base36 string
+ */
+export declare function isValidLocationHash(hash: string): boolean;
+//# sourceMappingURL=location.d.ts.map

package/dist/core/location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../src/core/location.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW/D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAKpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA0B9F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/core/location.js

@@ -0,0 +1,121 @@
+/**
+ * Location Identity for OpenTasks (Phase 2)
+ *
+ * Generates deterministic location hashes from git remote URL + path.
+ * Used for cross-location references in opentasks:// URIs.
+ */
+import { createHash, randomUUID } from 'node:crypto';
+import { execSync } from 'node:child_process';
+import * as path from 'node:path';
+import { hexToBase36 } from './id.js';
+/**
+ * Get the git remote URL for a repository
+ *
+ * @param repoRoot - Path to the repository root
+ * @returns The remote URL or null if no remote is configured
+ */
+export function getGitRemoteUrl(repoRoot) {
+    try {
+        const url = execSync('git remote get-url origin', {
+            cwd: repoRoot,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return url || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get the git repository root directory
+ *
+ * @param cwd - Working directory to start from
+ * @returns The repository root or null if not in a git repo
+ */
+export function getGitRoot(cwd) {
+    try {
+        const root = execSync('git rev-parse --show-toplevel', {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return root || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Generate a deterministic location hash from git remote URL and relative path
+ *
+ * The hash is stable across machines for the same repo + path combination.
+ *
+ * @param remoteUrl - Git remote URL (e.g., "git@github.com:user/repo.git")
+ * @param relativePath - Path relative to repo root (e.g., "." or "packages/app")
+ * @returns 8-character base36 hash
+ */
+export function generateLocationHash(remoteUrl, relativePath) {
+    const normalized = relativePath === '.' ? '' : relativePath;
+    const input = `${remoteUrl}:${normalized}`;
+    const hash = createHash('sha256').update(input).digest('hex');
+    return hexToBase36(hash).slice(0, 8);
+}
+/**
+ * Generate a fallback location hash from an absolute path
+ *
+ * Used when the repository has no remote configured.
+ * NOT stable across machines.
+ *
+ * @param absolutePath - Absolute path to the .opentasks directory
+ * @returns 8-character base36 hash
+ */
+export function generateLocationHashFallback(absolutePath) {
+    const hash = createHash('sha256').update(absolutePath).digest('hex');
+    return hexToBase36(hash).slice(0, 8);
+}
+/**
+ * Generate a complete location identity
+ *
+ * Attempts deterministic hash from git remote URL first,
+ * falls back to absolute path hash if no remote is available.
+ *
+ * @param opentasksDir - Path to the .opentasks directory
+ * @param name - Optional human-readable name (defaults to directory name)
+ * @returns Location identity object
+ */
+export function generateLocationIdentity(opentasksDir, name) {
+    const parentDir = path.dirname(opentasksDir);
+    const resolvedDir = path.resolve(parentDir);
+    const gitRoot = getGitRoot(resolvedDir);
+    let hash;
+    if (gitRoot) {
+        const remoteUrl = getGitRemoteUrl(gitRoot);
+        if (remoteUrl) {
+            const relativePath = path.relative(gitRoot, resolvedDir);
+            hash = generateLocationHash(remoteUrl, relativePath || '.');
+        }
+        else {
+            hash = generateLocationHashFallback(path.resolve(opentasksDir));
+        }
+    }
+    else {
+        hash = generateLocationHashFallback(path.resolve(opentasksDir));
+    }
+    const locationName = name || path.basename(resolvedDir);
+    return {
+        hash,
+        uuid: randomUUID(),
+        name: locationName,
+    };
+}
+/**
+ * Validate a location hash format
+ *
+ * @param hash - The hash to validate
+ * @returns true if the hash is a valid 8-char base36 string
+ */
+export function isValidLocationHash(hash) {
+    return /^[a-z0-9]{8}$/.test(hash);
+}
+//# sourceMappingURL=location.js.map

package/dist/core/location.js.map

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

package/dist/core/merge-driver.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Custom JSONL Merge Driver for OpenTasks (Phase 3)
+ *
+ * Three-way merge for graph.jsonl files with field-level resolution.
+ * Registered as a git merge driver via .gitattributes.
+ */
+/**
+ * A parsed JSONL line as a record
+ */
+type JsonLine = Record<string, unknown>;
+/**
+ * Parse a JSONL file into a Map keyed by ID
+ *
+ * For entries with the same ID, keeps the one with the latest updated_at.
+ */
+export declare function parseJsonlToMap(filePath: string): Map<string, JsonLine>;
+/**
+ * Write a map of entries back to a JSONL file
+ */
+export declare function writeJsonlFromMap(filePath: string, entries: Map<string, JsonLine>): void;
+/**
+ * Deep equality check for JSON values
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+/**
+ * Field-level three-way merge
+ *
+ * For each field:
+ * - Both sides agree → use that value
+ * - Only one side changed → use the changed value
+ * - Both changed differently → last-writer-wins by updated_at
+ */
+export declare function fieldLevelMerge(base: JsonLine, ours: JsonLine, theirs: JsonLine): JsonLine;
+/**
+ * Three-way merge of JSONL files
+ *
+ * @param basePath - Base version (common ancestor)
+ * @param oursPath - Our version (current branch)
+ * @param theirsPath - Their version (merging branch)
+ * @returns 0 on success, 1 on conflict (should not happen with this algorithm)
+ */
+export declare function mergeJsonl(basePath: string, oursPath: string, theirsPath: string): number;
+/**
+ * Install the merge driver in git config and .gitattributes
+ *
+ * @param worktreePath - Path to the worktree root
+ */
+export declare function installMergeDriver(worktreePath: string): void;
+export {};
+//# sourceMappingURL=merge-driver.d.ts.map

package/dist/core/merge-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-driver.d.ts","sourceRoot":"","sources":["../../src/core/merge-driver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CA6BvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI,CAoBxF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAsBzD;AAWD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAmD1F;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA0DzF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CA6B7D"}