opentasks 0.0.1 → 0.0.2

package/dist/core/__tests__/worktree.test.js.map

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

package/dist/core/conditional-redirects.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Conditional Redirect Rules for OpenTasks (Phase 3)
+ *
+ * Extends Phase 2 redirect rules with role and branch conditions.
+ */
+import type { RedirectRule, RedirectOperation } from './redirects.js';
+/**
+ * Conditions for when a redirect rule applies
+ */
+export interface RedirectCondition {
+    /** Role condition (exact match) */
+    role?: string;
+    /** Branch condition (glob pattern) */
+    branch?: string;
+}
+/**
+ * Extended redirect rule with conditions
+ */
+export interface ConditionalRedirectRule extends RedirectRule {
+    /** Conditions that must be met for this rule to apply */
+    when?: RedirectCondition;
+}
+/**
+ * Runtime context for evaluating redirect conditions
+ */
+export interface RedirectContext {
+    /** Current location role */
+    role: string;
+    /** Current git branch (cached) */
+    branch?: string;
+}
+/**
+ * Check if conditions are met
+ */
+export declare function evaluateConditions(conditions: RedirectCondition | undefined, context: RedirectContext): boolean;
+/**
+ * Find the first matching conditional redirect rule
+ *
+ * Extends findRedirectRule with condition evaluation.
+ */
+export declare function findConditionalRedirectRule(operation: RedirectOperation, nodeId: string, rules: ConditionalRedirectRule[], context: RedirectContext): ConditionalRedirectRule | null;
+//# sourceMappingURL=conditional-redirects.d.ts.map

package/dist/core/conditional-redirects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditional-redirects.d.ts","sourceRoot":"","sources":["../../src/core/conditional-redirects.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGtE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,yDAAyD;IACzD,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAqBD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,iBAAiB,GAAG,SAAS,EACzC,OAAO,EAAE,eAAe,GACvB,OAAO,CAaT;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,uBAAuB,EAAE,EAChC,OAAO,EAAE,eAAe,GACvB,uBAAuB,GAAG,IAAI,CAYhC"}

package/dist/core/conditional-redirects.js

@@ -0,0 +1,59 @@
+/**
+ * Conditional Redirect Rules for OpenTasks (Phase 3)
+ *
+ * Extends Phase 2 redirect rules with role and branch conditions.
+ */
+import { matchPattern } from './redirects.js';
+/**
+ * Simple glob match for branch patterns
+ *
+ * Supports: "feature-*", "main", "*"
+ */
+function branchMatch(pattern, branch) {
+    if (pattern === '*')
+        return true;
+    if (pattern.endsWith('*')) {
+        return branch.startsWith(pattern.slice(0, -1));
+    }
+    if (pattern.startsWith('*')) {
+        return branch.endsWith(pattern.slice(1));
+    }
+    return pattern === branch;
+}
+/**
+ * Check if conditions are met
+ */
+export function evaluateConditions(conditions, context) {
+    if (!conditions)
+        return true;
+    if (conditions.role && conditions.role !== context.role) {
+        return false;
+    }
+    if (conditions.branch) {
+        if (!context.branch)
+            return false;
+        if (!branchMatch(conditions.branch, context.branch))
+            return false;
+    }
+    return true;
+}
+/**
+ * Find the first matching conditional redirect rule
+ *
+ * Extends findRedirectRule with condition evaluation.
+ */
+export function findConditionalRedirectRule(operation, nodeId, rules, context) {
+    // Sort by priority (ascending — lower = higher priority)
+    const sorted = [...rules].sort((a, b) => a.priority - b.priority);
+    for (const rule of sorted) {
+        if (!rule.operations.includes(operation))
+            continue;
+        if (!matchPattern(rule.pattern, nodeId))
+            continue;
+        if (!evaluateConditions(rule.when, context))
+            continue;
+        return rule;
+    }
+    return null;
+}
+//# sourceMappingURL=conditional-redirects.js.map

package/dist/core/conditional-redirects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditional-redirects.js","sourceRoot":"","sources":["../../src/core/conditional-redirects.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA8B9C;;;;GAIG;AACH,SAAS,WAAW,CAAC,OAAe,EAAE,MAAc;IAClD,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAEjC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,OAAO,KAAK,MAAM,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAyC,EACzC,OAAwB;IAExB,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE7B,IAAI,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;IACpE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,SAA4B,EAC5B,MAAc,EACd,KAAgC,EAChC,OAAwB;IAExB,yDAAyD;IACzD,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAElE,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,SAAS;QACnD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;YAAE,SAAS;QAClD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;YAAE,SAAS;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/connections.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Connection Management for OpenTasks (Phase 2)
+ *
+ * Manages explicit connections between OpenTasks locations.
+ * No filesystem discovery — all connections are declared in config.json.
+ */
+/**
+ * Connection role
+ */
+export type ConnectionRole = 'peer' | 'parent' | 'child';
+/**
+ * Connection to another OpenTasks location
+ */
+export interface Connection {
+    /** Location hash of the target */
+    hash: string;
+    /** Path to the target .opentasks directory (relative or absolute) */
+    path: string;
+    /** Relationship role */
+    role: ConnectionRole;
+    /** Human-readable name */
+    name: string;
+}
+/**
+ * Health status of a connection
+ */
+export type ConnectionHealth = 'reachable' | 'unreachable' | 'hash-mismatch';
+/**
+ * Connection with health information
+ */
+export interface ConnectionStatus {
+    connection: Connection;
+    health: ConnectionHealth;
+    error?: string;
+}
+/**
+ * Create a connection to another OpenTasks location
+ *
+ * Reads the target's config.json to get its hash and name.
+ *
+ * @param targetPath - Path to the target .opentasks directory
+ * @param role - Relationship role (default: 'peer')
+ * @param basePath - Base path for computing relative paths
+ * @returns New connection, or throws on error
+ */
+export declare function createConnection(targetPath: string, role?: ConnectionRole, basePath?: string): Connection;
+/**
+ * Check the health of a connection
+ *
+ * @param connection - The connection to check
+ * @param basePath - Base path for resolving relative paths
+ * @returns Connection status with health information
+ */
+export declare function checkConnectionHealth(connection: Connection, basePath?: string): ConnectionStatus;
+/**
+ * Add a connection to a list, replacing any existing connection with the same hash
+ *
+ * @param connections - Existing connections
+ * @param newConnection - Connection to add
+ * @returns Updated connections list
+ */
+export declare function addConnection(connections: Connection[], newConnection: Connection): Connection[];
+/**
+ * Remove a connection by hash
+ *
+ * @param connections - Existing connections
+ * @param hash - Hash of the connection to remove
+ * @returns Updated connections list
+ */
+export declare function removeConnection(connections: Connection[], hash: string): Connection[];
+/**
+ * Find a connection by hash
+ *
+ * @param connections - Connections to search
+ * @param hash - Location hash to find
+ * @returns The connection or undefined
+ */
+export declare function findConnection(connections: Connection[], hash: string): Connection | undefined;
+/**
+ * Get health status for all connections
+ *
+ * @param connections - Connections to check
+ * @param basePath - Base path for resolving relative paths
+ * @returns Array of connection statuses
+ */
+export declare function checkAllConnectionHealth(connections: Connection[], basePath?: string): ConnectionStatus[];
+//# sourceMappingURL=connections.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../src/core/connections.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,aAAa,GAAG,eAAe,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiCD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,cAAuB,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,CAuBZ;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA8CjG;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,aAAa,EAAE,UAAU,GAAG,UAAU,EAAE,CAIhG;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAEtF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE9F;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,UAAU,EAAE,EACzB,QAAQ,CAAC,EAAE,MAAM,GAChB,gBAAgB,EAAE,CAEpB"}

package/dist/core/connections.js

@@ -0,0 +1,160 @@
+/**
+ * Connection Management for OpenTasks (Phase 2)
+ *
+ * Manages explicit connections between OpenTasks locations.
+ * No filesystem discovery — all connections are declared in config.json.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Read the config.json of a target location
+ *
+ * @param opentasksPath - Path to the target .opentasks directory
+ * @returns The parsed config or null if not readable
+ */
+function readTargetConfig(opentasksPath) {
+    try {
+        const configPath = path.join(opentasksPath, 'config.json');
+        const content = fs.readFileSync(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extract location identity from a config object
+ */
+function extractLocation(config) {
+    const loc = config.location;
+    if (!loc || typeof loc.hash !== 'string' || typeof loc.uuid !== 'string') {
+        return null;
+    }
+    return {
+        hash: loc.hash,
+        uuid: loc.uuid,
+        name: loc.name || '',
+    };
+}
+/**
+ * Create a connection to another OpenTasks location
+ *
+ * Reads the target's config.json to get its hash and name.
+ *
+ * @param targetPath - Path to the target .opentasks directory
+ * @param role - Relationship role (default: 'peer')
+ * @param basePath - Base path for computing relative paths
+ * @returns New connection, or throws on error
+ */
+export function createConnection(targetPath, role = 'peer', basePath) {
+    const resolvedTarget = path.resolve(targetPath);
+    // Read target config
+    const config = readTargetConfig(resolvedTarget);
+    if (!config) {
+        throw new Error(`Cannot read config at: ${resolvedTarget}/config.json`);
+    }
+    const location = extractLocation(config);
+    if (!location) {
+        throw new Error(`No valid location identity in: ${resolvedTarget}/config.json`);
+    }
+    // Compute relative path if base is provided
+    const connectionPath = basePath ? path.relative(basePath, resolvedTarget) : resolvedTarget;
+    return {
+        hash: location.hash,
+        path: connectionPath,
+        role,
+        name: location.name,
+    };
+}
+/**
+ * Check the health of a connection
+ *
+ * @param connection - The connection to check
+ * @param basePath - Base path for resolving relative paths
+ * @returns Connection status with health information
+ */
+export function checkConnectionHealth(connection, basePath) {
+    const resolvedPath = basePath
+        ? path.resolve(basePath, connection.path)
+        : path.resolve(connection.path);
+    // 1. Does the path exist?
+    if (!fs.existsSync(resolvedPath)) {
+        return {
+            connection,
+            health: 'unreachable',
+            error: `Path does not exist: ${resolvedPath}`,
+        };
+    }
+    // 2. Is there a valid config.json?
+    const config = readTargetConfig(resolvedPath);
+    if (!config) {
+        return {
+            connection,
+            health: 'unreachable',
+            error: `Cannot read config.json at: ${resolvedPath}`,
+        };
+    }
+    // 3. Does the hash match?
+    const location = extractLocation(config);
+    if (!location) {
+        return {
+            connection,
+            health: 'unreachable',
+            error: `No valid location identity in config.json`,
+        };
+    }
+    if (location.hash !== connection.hash) {
+        return {
+            connection,
+            health: 'hash-mismatch',
+            error: `Expected hash ${connection.hash}, found ${location.hash}`,
+        };
+    }
+    return {
+        connection,
+        health: 'reachable',
+    };
+}
+/**
+ * Add a connection to a list, replacing any existing connection with the same hash
+ *
+ * @param connections - Existing connections
+ * @param newConnection - Connection to add
+ * @returns Updated connections list
+ */
+export function addConnection(connections, newConnection) {
+    // Remove existing with same hash
+    const filtered = connections.filter((c) => c.hash !== newConnection.hash);
+    return [...filtered, newConnection];
+}
+/**
+ * Remove a connection by hash
+ *
+ * @param connections - Existing connections
+ * @param hash - Hash of the connection to remove
+ * @returns Updated connections list
+ */
+export function removeConnection(connections, hash) {
+    return connections.filter((c) => c.hash !== hash);
+}
+/**
+ * Find a connection by hash
+ *
+ * @param connections - Connections to search
+ * @param hash - Location hash to find
+ * @returns The connection or undefined
+ */
+export function findConnection(connections, hash) {
+    return connections.find((c) => c.hash === hash);
+}
+/**
+ * Get health status for all connections
+ *
+ * @param connections - Connections to check
+ * @param basePath - Base path for resolving relative paths
+ * @returns Array of connection statuses
+ */
+export function checkAllConnectionHealth(connections, basePath) {
+    return connections.map((c) => checkConnectionHealth(c, basePath));
+}
+//# sourceMappingURL=connections.js.map

package/dist/core/connections.js.map

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

package/dist/core/discover.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Location Discovery for OpenTasks (Phase 3)
+ *
+ * Finds nearby OpenTasks locations by walking the filesystem
+ * in configurable directions from the current working directory.
+ */
+/**
+ * Discovered OpenTasks location
+ */
+export interface DiscoveredLocation {
+    /** Absolute path to the .opentasks directory */
+    opentasksPath: string;
+    /** Location hash (from config.json) */
+    hash: string;
+    /** Human-readable name */
+    name: string;
+    /** Relative direction from search origin */
+    direction: 'up' | 'down' | 'self';
+    /** Filesystem depth from search origin */
+    depth: number;
+}
+/**
+ * Discovery options
+ */
+export interface DiscoverOptions {
+    /** Search direction: 'up' (parents), 'down' (children), 'both' */
+    direction?: 'up' | 'down' | 'both';
+    /** Maximum depth to traverse (default: 5) */
+    maxDepth?: number;
+}
+/**
+ * Discover OpenTasks locations near the given directory
+ *
+ * @param startDir - Directory to start searching from
+ * @param options - Discovery options
+ * @returns Array of discovered locations
+ */
+export declare function discoverLocations(startDir: string, options?: DiscoverOptions): DiscoveredLocation[];
+//# sourceMappingURL=discover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/core/discover.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAsGD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,eAAoB,GAC5B,kBAAkB,EAAE,CA+BtB"}

package/dist/core/discover.js

@@ -0,0 +1,136 @@
+/**
+ * Location Discovery for OpenTasks (Phase 3)
+ *
+ * Finds nearby OpenTasks locations by walking the filesystem
+ * in configurable directions from the current working directory.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Read location identity from a .opentasks/config.json file
+ */
+function readLocationConfig(opentasksDir) {
+    const configPath = path.join(opentasksDir, 'config.json');
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        if (config.location?.hash) {
+            return {
+                hash: config.location.hash,
+                name: config.location.name || '',
+            };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Walk upward from a directory looking for .opentasks locations
+ */
+function discoverUp(startDir, maxDepth) {
+    const results = [];
+    let currentDir = path.dirname(startDir); // Start from parent
+    let depth = 1;
+    while (depth <= maxDepth) {
+        // Check if this directory has a .opentasks
+        const opentasksDir = path.join(currentDir, '.opentasks');
+        if (fs.existsSync(opentasksDir)) {
+            const config = readLocationConfig(opentasksDir);
+            if (config) {
+                results.push({
+                    opentasksPath: opentasksDir,
+                    hash: config.hash,
+                    name: config.name,
+                    direction: 'up',
+                    depth,
+                });
+            }
+        }
+        // Move to parent
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir)
+            break; // Reached filesystem root
+        currentDir = parentDir;
+        depth++;
+    }
+    return results;
+}
+/**
+ * Walk downward from a directory looking for .opentasks locations
+ */
+function discoverDown(startDir, maxDepth) {
+    const results = [];
+    function walk(dir, depth) {
+        if (depth > maxDepth)
+            return;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            // Skip hidden directories (except .opentasks itself) and node_modules
+            if (entry.name.startsWith('.') || entry.name === 'node_modules')
+                continue;
+            const childDir = path.join(dir, entry.name);
+            const opentasksDir = path.join(childDir, '.opentasks');
+            if (fs.existsSync(opentasksDir)) {
+                const config = readLocationConfig(opentasksDir);
+                if (config) {
+                    results.push({
+                        opentasksPath: opentasksDir,
+                        hash: config.hash,
+                        name: config.name,
+                        direction: 'down',
+                        depth,
+                    });
+                }
+            }
+            // Continue walking into subdirectories
+            walk(childDir, depth + 1);
+        }
+    }
+    walk(startDir, 1);
+    return results;
+}
+/**
+ * Discover OpenTasks locations near the given directory
+ *
+ * @param startDir - Directory to start searching from
+ * @param options - Discovery options
+ * @returns Array of discovered locations
+ */
+export function discoverLocations(startDir, options = {}) {
+    const direction = options.direction ?? 'both';
+    const maxDepth = options.maxDepth ?? 5;
+    const resolvedStart = path.resolve(startDir);
+    const results = [];
+    // Check self first
+    const selfOpentasks = path.join(resolvedStart, '.opentasks');
+    if (fs.existsSync(selfOpentasks)) {
+        const config = readLocationConfig(selfOpentasks);
+        if (config) {
+            results.push({
+                opentasksPath: selfOpentasks,
+                hash: config.hash,
+                name: config.name,
+                direction: 'self',
+                depth: 0,
+            });
+        }
+    }
+    if (direction === 'up' || direction === 'both') {
+        results.push(...discoverUp(resolvedStart, maxDepth));
+    }
+    if (direction === 'down' || direction === 'both') {
+        results.push(...discoverDown(resolvedStart, maxDepth));
+    }
+    return results;
+}
+//# sourceMappingURL=discover.js.map

package/dist/core/discover.js.map

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

package/dist/core/hash.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Content hashing for OpenTasks
+ *
+ * Used for deduplication during merge and change detection.
+ */
+import type { StoredNode } from '../schema/storage.js';
+/**
+ * Compute SHA256 hash of a string
+ */
+export declare function sha256(input: string): string;
+/**
+ * Compute content hash for a node
+ *
+ * Only includes substantive fields (content that affects semantics).
+ * Excludes: id, uuid, timestamps, coordination fields, metadata.
+ *
+ * @param node - The node to hash
+ * @returns SHA256 hash as hex string
+ */
+export declare function computeContentHash(node: StoredNode): string;
+/**
+ * Check if two nodes have the same content (ignoring non-substantive fields)
+ */
+export declare function contentEqual(a: StoredNode, b: StoredNode): boolean;
+//# sourceMappingURL=hash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/core/hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAyC3D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAElE"}

package/dist/core/hash.js

@@ -0,0 +1,62 @@
+/**
+ * Content hashing for OpenTasks
+ *
+ * Used for deduplication during merge and change detection.
+ */
+import { createHash } from 'node:crypto';
+/**
+ * Compute SHA256 hash of a string
+ */
+export function sha256(input) {
+    return createHash('sha256').update(input).digest('hex');
+}
+/**
+ * Compute content hash for a node
+ *
+ * Only includes substantive fields (content that affects semantics).
+ * Excludes: id, uuid, timestamps, coordination fields, metadata.
+ *
+ * @param node - The node to hash
+ * @returns SHA256 hash as hex string
+ */
+export function computeContentHash(node) {
+    // Build object with only substantive fields
+    const substantive = {
+        type: node.type,
+        title: node.title,
+        content: node.content,
+        status: node.status,
+        priority: node.priority,
+        tags: node.tags ? [...node.tags].sort() : undefined,
+        parent_id: node.parent_id,
+    };
+    // Add type-specific substantive fields
+    if (node.type === 'task') {
+        substantive.assignee = node.assignee;
+    }
+    if (node.type === 'feedback') {
+        substantive.target_id = node.target_id;
+        substantive.feedback_type = node.feedback_type;
+        substantive.target_anchor = node.target_anchor;
+    }
+    if (node.type === 'external') {
+        substantive.uri = node.uri;
+        substantive.source = node.source;
+    }
+    // Remove undefined values for consistent hashing
+    const cleaned = Object.fromEntries(Object.entries(substantive).filter(([_, v]) => v !== undefined));
+    // Sort keys for deterministic JSON
+    const sortedKeys = Object.keys(cleaned).sort();
+    const orderedObj = {};
+    for (const key of sortedKeys) {
+        orderedObj[key] = cleaned[key];
+    }
+    return sha256(JSON.stringify(orderedObj));
+}
+/**
+ * Check if two nodes have the same content (ignoring non-substantive fields)
+ */
+export function contentEqual(a, b) {
+    return computeContentHash(a) === computeContentHash(b);
+}
+//# sourceMappingURL=hash.js.map