opentasks 0.0.1 → 0.0.2

package/dist/schema/__tests__/validation.test.js

@@ -0,0 +1,241 @@
+import { describe, it, expect } from 'vitest';
+import { isSpec, isIssue, isFeedback, isExternal, validateStoredNode, parseNode, tryParseNode, ValidationError, } from '../validation.js';
+// Test fixtures
+const baseFields = {
+    id: 's-a2b3',
+    uuid: '550e8400-e29b-41d4-a716-446655440000',
+    title: 'Test Node',
+    created_at: '2025-01-26T10:00:00Z',
+    updated_at: '2025-01-26T10:00:00Z',
+};
+const validSpec = {
+    ...baseFields,
+    type: 'spec',
+    content: '## Overview\n\nThis is a spec.',
+};
+const validIssue = {
+    ...baseFields,
+    id: 'i-x7k9',
+    type: 'issue',
+    status: 'open',
+};
+const validFeedback = {
+    ...baseFields,
+    id: 'f-m4n5',
+    type: 'feedback',
+    target_id: 's-a2b3',
+    feedback_type: 'suggestion',
+};
+const validExternal = {
+    ...baseFields,
+    id: 'e-p6q7',
+    type: 'external',
+    uri: 'jira://PROJ-123',
+    source: 'jira',
+    materialized: false,
+};
+describe('Type Guards', () => {
+    it('isSpec returns true for spec nodes', () => {
+        const node = parseNode(validSpec);
+        expect(isSpec(node)).toBe(true);
+        expect(isIssue(node)).toBe(false);
+        expect(isFeedback(node)).toBe(false);
+        expect(isExternal(node)).toBe(false);
+    });
+    it('isIssue returns true for issue nodes', () => {
+        const node = parseNode(validIssue);
+        expect(isIssue(node)).toBe(true);
+        expect(isSpec(node)).toBe(false);
+    });
+    it('isFeedback returns true for feedback nodes', () => {
+        const node = parseNode(validFeedback);
+        expect(isFeedback(node)).toBe(true);
+        expect(isSpec(node)).toBe(false);
+    });
+    it('isExternal returns true for external nodes', () => {
+        const node = parseNode(validExternal);
+        expect(isExternal(node)).toBe(true);
+        expect(isSpec(node)).toBe(false);
+    });
+});
+describe('validateStoredNode', () => {
+    it('validates a valid spec', () => {
+        const result = validateStoredNode(validSpec);
+        expect(result.valid).toBe(true);
+        expect(result.errors).toHaveLength(0);
+    });
+    it('validates a valid issue', () => {
+        const result = validateStoredNode(validIssue);
+        expect(result.valid).toBe(true);
+        expect(result.errors).toHaveLength(0);
+    });
+    it('validates a valid feedback', () => {
+        const result = validateStoredNode(validFeedback);
+        expect(result.valid).toBe(true);
+        expect(result.errors).toHaveLength(0);
+    });
+    it('validates a valid external node', () => {
+        const result = validateStoredNode(validExternal);
+        expect(result.valid).toBe(true);
+        expect(result.errors).toHaveLength(0);
+    });
+    it('rejects node missing required core fields', () => {
+        const invalid = {
+            id: 's-a2b3',
+            uuid: '',
+            type: 'spec',
+            title: '',
+            created_at: '',
+            updated_at: '2025-01-26T10:00:00Z',
+        };
+        const result = validateStoredNode(invalid);
+        expect(result.valid).toBe(false);
+        expect(result.errors.length).toBeGreaterThan(0);
+        expect(result.errors.some((e) => e.field === 'uuid')).toBe(true);
+        expect(result.errors.some((e) => e.field === 'title')).toBe(true);
+    });
+    it('rejects issue missing status', () => {
+        const invalid = {
+            ...baseFields,
+            type: 'issue',
+            // missing status
+        };
+        const result = validateStoredNode(invalid);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some((e) => e.field === 'status')).toBe(true);
+    });
+    it('rejects feedback missing target_id', () => {
+        const invalid = {
+            ...baseFields,
+            type: 'feedback',
+            feedback_type: 'comment',
+            // missing target_id
+        };
+        const result = validateStoredNode(invalid);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some((e) => e.field === 'target_id')).toBe(true);
+    });
+    it('rejects feedback missing feedback_type', () => {
+        const invalid = {
+            ...baseFields,
+            type: 'feedback',
+            target_id: 's-a2b3',
+            // missing feedback_type
+        };
+        const result = validateStoredNode(invalid);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some((e) => e.field === 'feedback_type')).toBe(true);
+    });
+    it('rejects external missing uri', () => {
+        const invalid = {
+            ...baseFields,
+            type: 'external',
+            source: 'jira',
+            materialized: false,
+            // missing uri
+        };
+        const result = validateStoredNode(invalid);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some((e) => e.field === 'uri')).toBe(true);
+    });
+    it('rejects external missing source', () => {
+        const invalid = {
+            ...baseFields,
+            type: 'external',
+            uri: 'jira://PROJ-123',
+            materialized: false,
+            // missing source
+        };
+        const result = validateStoredNode(invalid);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some((e) => e.field === 'source')).toBe(true);
+    });
+    it('rejects external missing materialized', () => {
+        const invalid = {
+            ...baseFields,
+            type: 'external',
+            uri: 'jira://PROJ-123',
+            source: 'jira',
+            // missing materialized
+        };
+        const result = validateStoredNode(invalid);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some((e) => e.field === 'materialized')).toBe(true);
+    });
+});
+describe('parseNode', () => {
+    it('parses a valid spec', () => {
+        const node = parseNode(validSpec);
+        expect(node.type).toBe('spec');
+        expect(isSpec(node)).toBe(true);
+    });
+    it('parses a valid issue', () => {
+        const node = parseNode(validIssue);
+        expect(node.type).toBe('issue');
+        expect(isIssue(node)).toBe(true);
+        if (isIssue(node)) {
+            expect(node.status).toBe('open');
+        }
+    });
+    it('throws ValidationError for invalid node', () => {
+        const invalid = {
+            ...baseFields,
+            type: 'issue',
+            // missing status
+        };
+        expect(() => parseNode(invalid)).toThrow(ValidationError);
+    });
+    it('preserves unknown fields', () => {
+        const withExtra = {
+            ...validSpec,
+            customField: 'custom value',
+            anotherField: 123,
+        };
+        const node = parseNode(withExtra);
+        expect(node.customField).toBe('custom value');
+        expect(node.anotherField).toBe(123);
+    });
+});
+describe('tryParseNode', () => {
+    it('returns node for valid input', () => {
+        const node = tryParseNode(validSpec);
+        expect(node).not.toBeNull();
+        expect(node?.type).toBe('spec');
+    });
+    it('returns null for invalid input', () => {
+        const invalid = {
+            ...baseFields,
+            type: 'issue',
+            // missing status
+        };
+        const node = tryParseNode(invalid);
+        expect(node).toBeNull();
+    });
+});
+describe('Node type narrowing', () => {
+    it('allows type-safe access after guard', () => {
+        const node = parseNode(validIssue);
+        if (isIssue(node)) {
+            // TypeScript should allow access to issue-specific fields
+            expect(node.status).toBe('open');
+            // assignee is optional on issues
+            expect(node.assignee).toBeUndefined();
+        }
+    });
+    it('allows type-safe access to feedback fields', () => {
+        const node = parseNode(validFeedback);
+        if (isFeedback(node)) {
+            expect(node.target_id).toBe('s-a2b3');
+            expect(node.feedback_type).toBe('suggestion');
+        }
+    });
+    it('allows type-safe access to external fields', () => {
+        const node = parseNode(validExternal);
+        if (isExternal(node)) {
+            expect(node.uri).toBe('jira://PROJ-123');
+            expect(node.source).toBe('jira');
+            expect(node.materialized).toBe(false);
+        }
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/schema/__tests__/validation.test.js.map

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

package/dist/schema/base.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Base types shared by all OpenTasks nodes
+ */
+/**
+ * Anchor for locating feedback within content
+ */
+export interface Anchor {
+    /** Line number (1-indexed) */
+    line?: number;
+    /** Text snippet for fuzzy matching if line moves */
+    text?: string;
+    /** Section heading */
+    section?: string;
+    /** Context for relocation */
+    context_before?: string;
+    context_after?: string;
+    /**
+     * Anchor validity status
+     * - valid: anchor location confirmed
+     * - relocated: moved but found
+     * - stale: could not relocate
+     */
+    anchor_status?: 'valid' | 'relocated' | 'stale';
+}
+/**
+ * Common fields shared by all node types
+ */
+export interface BaseNode {
+    /** Hash-based ID: prefix + base36 (e.g., "s-a2b3", "i-x7k9") */
+    id: string;
+    /** UUID v4 for distributed sync */
+    uuid: string;
+    /** Human-readable title */
+    title: string;
+    /** Markdown body content */
+    content?: string;
+    /** SHA256 hash of content for deduplication */
+    content_hash?: string;
+    created_at: string;
+    updated_at: string;
+    /** Priority: 0 (highest) to 4 (lowest) */
+    priority?: number;
+    /** Tags for categorization */
+    tags?: string[];
+    /** Parent node ID for hierarchy support */
+    parent_id?: string;
+    /** OpenTasks location URI */
+    location?: string;
+    /** Git branch that created this node */
+    branch?: string;
+    /** Branches merged into this node */
+    merged_from?: string[];
+    /** Origin system: "local" | provider name */
+    source?: string;
+    /** Agent/user ID that claimed this node */
+    claimed_by?: string;
+    /** When the node was claimed (ISO 8601) */
+    claimed_at?: string;
+    /** Soft lock expiry (ISO 8601) */
+    lock_until?: string;
+    /** Soft delete flag */
+    archived?: boolean;
+    /** When archived (ISO 8601) */
+    archived_at?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/schema/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/schema/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IAEvB,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAGb,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IAGnB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/schema/base.js

@@ -0,0 +1,5 @@
+/**
+ * Base types shared by all OpenTasks nodes
+ */
+export {};
+//# sourceMappingURL=base.js.map

package/dist/schema/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/schema/base.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/schema/edges.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Edge type definitions for OpenTasks
+ *
+ * Edge direction semantics: `from` → `to`
+ * - "blocks": from must complete before to can start
+ * - "implements": from (task) implements to (context)
+ */
+/**
+ * Core relationship types
+ */
+export type CoreEdgeType = 'blocks' | 'implements' | 'references' | 'related';
+/**
+ * Extended relationship types (optional, for richer semantics)
+ */
+export type ExtendedEdgeType = 'parent-of' | 'child-of' | 'duplicates' | 'supersedes' | 'depends-on' | 'discovered-from';
+/**
+ * Entire integration edge types (auto-created by EntireAutoLinker)
+ */
+export type EntireEdgeType = 'worked-on' | 'implemented-by' | 'contains';
+/**
+ * All edge types (extensible via string)
+ */
+export type EdgeType = CoreEdgeType | ExtendedEdgeType | EntireEdgeType | string;
+/**
+ * Edge - Represents a relationship between nodes
+ */
+export interface Edge {
+    /** Hash-based ID: "x-xxxx" */
+    id: string;
+    /** UUID v4 for distributed sync */
+    uuid: string;
+    /** Source node ID or external URI */
+    from_id: string;
+    /** Target node ID or external URI */
+    to_id: string;
+    /** Relationship type */
+    type: EdgeType;
+    /** When created (ISO 8601) */
+    created_at: string;
+    /** Agent/user who created this edge */
+    created_by?: string;
+    /** Origin system: "local" | integration name */
+    source?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** When edge was cached from provider (ISO 8601) */
+    cached_at?: string;
+}
+//# sourceMappingURL=edges.d.ts.map

package/dist/schema/edges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edges.d.ts","sourceRoot":"","sources":["../../src/schema/edges.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,YAAY,GACZ,YAAY,GACZ,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,iBAAiB,CAAC;AAEtB;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,gBAAgB,GAChB,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,gBAAgB,GAAG,cAAc,GAAG,MAAM,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IAEd,wBAAwB;IACxB,IAAI,EAAE,QAAQ,CAAC;IAEf,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/schema/edges.js

@@ -0,0 +1,9 @@
+/**
+ * Edge type definitions for OpenTasks
+ *
+ * Edge direction semantics: `from` → `to`
+ * - "blocks": from must complete before to can start
+ * - "implements": from (task) implements to (context)
+ */
+export {};
+//# sourceMappingURL=edges.js.map

package/dist/schema/edges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edges.js","sourceRoot":"","sources":["../../src/schema/edges.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/schema/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * OpenTasks Schema - Type definitions and validation
+ *
+ * @packageDocumentation
+ */
+export type { Anchor, BaseNode } from './base.js';
+export type { Context, Task, Feedback, ExternalNode, Node, NodeType } from './nodes.js';
+export type { Edge, EdgeType, CoreEdgeType, ExtendedEdgeType } from './edges.js';
+export type { StoredNode, StoredEdge, PersistedGraph, GraphMetadata, GraphChanges, } from './storage.js';
+export { ValidationError, type ValidationResult, isContext, isTask, isFeedback, isExternal, validateStoredNode, parseNode, tryParseNode, hasKnownType, } from './validation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGlD,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGxF,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGjF,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EACrB,SAAS,EACT,MAAM,EACN,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,YAAY,GACb,MAAM,iBAAiB,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,8 @@
+/**
+ * OpenTasks Schema - Type definitions and validation
+ *
+ * @packageDocumentation
+ */
+// Validation
+export { ValidationError, isContext, isTask, isFeedback, isExternal, validateStoredNode, parseNode, tryParseNode, hasKnownType, } from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,aAAa;AACb,OAAO,EACL,eAAe,EAEf,SAAS,EACT,MAAM,EACN,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,YAAY,GACb,MAAM,iBAAiB,CAAC"}

package/dist/schema/nodes.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Node type definitions for OpenTasks
+ */
+import type { Anchor, BaseNode } from './base.js';
+/**
+ * Context - Captures user intent, requirements, and context
+ */
+export interface Context extends BaseNode {
+    type: 'context';
+    /**
+     * Optional status for context nodes
+     * - draft: work in progress, not ready for implementation
+     * - active: current, ready for implementation
+     * - archived: superseded or no longer relevant
+     */
+    status?: 'draft' | 'active' | 'archived' | string;
+}
+/**
+ * Task - Actionable work item with status workflow
+ */
+export interface Task extends BaseNode {
+    type: 'task';
+    /**
+     * Workflow status (required for tasks)
+     * - open: not started
+     * - in_progress: actively being worked on
+     * - blocked: waiting on dependency
+     * - closed: completed or won't do
+     */
+    status: 'open' | 'in_progress' | 'blocked' | 'closed' | string;
+    /** Who is responsible for this task */
+    assignee?: string;
+    /** When the task was closed (ISO 8601) */
+    closed_at?: string;
+}
+/**
+ * Feedback - Anchored comment, suggestion, or request on a node
+ */
+export interface Feedback extends BaseNode {
+    type: 'feedback';
+    /**
+     * What this feedback is about (required)
+     * Can be a context, task, or another feedback (for threading)
+     */
+    target_id: string;
+    /** Optional anchor for line/text-specific feedback */
+    target_anchor?: Anchor;
+    /**
+     * Type of feedback (required)
+     * - comment: general observation
+     * - suggestion: proposed change
+     * - request: action needed
+     */
+    feedback_type: 'comment' | 'suggestion' | 'request' | string;
+    /** Groups related feedback */
+    thread_id?: string;
+    /** Parent feedback in thread */
+    reply_to_id?: string;
+    /** Feedback has been addressed */
+    resolved?: boolean;
+    /** When resolved (ISO 8601) */
+    resolved_at?: string;
+    /** Feedback was dismissed (not addressed) */
+    dismissed?: boolean;
+    /** When dismissed (ISO 8601) */
+    dismissed_at?: string;
+}
+/**
+ * ExternalNode - Reference to an entity in an external system
+ * Can be phantom (just a reference) or materialized (fetched data)
+ */
+export interface ExternalNode extends BaseNode {
+    type: 'external';
+    /** Canonical URI: "jira://PROJ-123", "beads://./bd-x7k9" */
+    uri: string;
+    /** Source system identifier: "jira" | "linear" | "github" | "beads" | etc. */
+    source: string;
+    /** Whether data has been fetched from external system */
+    materialized: boolean;
+    /** When data was last fetched (ISO 8601) */
+    cached_at?: string;
+    /** Whether cached data is known to be stale */
+    stale?: boolean;
+    /** Status from external system (their semantics, not ours) */
+    external_status?: string;
+    /** Raw data from external system */
+    external_data?: Record<string, unknown>;
+}
+/**
+ * Discriminated union of all node types
+ */
+export type Node = Context | Task | Feedback | ExternalNode;
+/**
+ * Node type literal union
+ */
+export type NodeType = 'context' | 'task' | 'feedback' | 'external';
+//# sourceMappingURL=nodes.d.ts.map

package/dist/schema/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../src/schema/nodes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,QAAQ;IACvC,IAAI,EAAE,SAAS,CAAC;IAEhB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,IAAK,SAAQ,QAAQ;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAE/D,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,QAAQ;IACxC,IAAI,EAAE,UAAU,CAAC;IAEjB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,aAAa,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;IAE7D,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,IAAI,EAAE,UAAU,CAAC;IAEjB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IAEZ,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IAEf,yDAAyD;IACzD,YAAY,EAAE,OAAO,CAAC;IAEtB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC"}

package/dist/schema/nodes.js

@@ -0,0 +1,5 @@
+/**
+ * Node type definitions for OpenTasks
+ */
+export {};
+//# sourceMappingURL=nodes.js.map

package/dist/schema/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/schema/nodes.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/schema/storage.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Storage format types for JSONL persistence
+ *
+ * These types are permissive (unknown fields preserved) for:
+ * - Forward compatibility with schema changes
+ * - Provider data from external systems
+ * - Migration safety
+ */
+import type { Edge } from './edges.js';
+/**
+ * Storage format for nodes (JSONL)
+ * Flexible schema — all fields except core are optional
+ * Unknown fields are preserved via index signature
+ */
+export interface StoredNode {
+    id: string;
+    uuid: string;
+    type: string;
+    title: string;
+    created_at: string;
+    updated_at: string;
+    content?: string;
+    content_hash?: string;
+    priority?: number;
+    tags?: string[];
+    parent_id?: string;
+    location?: string;
+    branch?: string;
+    merged_from?: string[];
+    source?: string;
+    claimed_by?: string;
+    claimed_at?: string;
+    lock_until?: string;
+    archived?: boolean;
+    archived_at?: string;
+    deleted_at?: string;
+    deleted_by?: string;
+    status?: string;
+    assignee?: string;
+    closed_at?: string;
+    target_id?: string;
+    target_anchor?: {
+        line?: number;
+        text?: string;
+        section?: string;
+        context_before?: string;
+        context_after?: string;
+        anchor_status?: string;
+    };
+    feedback_type?: string;
+    thread_id?: string;
+    reply_to_id?: string;
+    resolved?: boolean;
+    resolved_at?: string;
+    dismissed?: boolean;
+    dismissed_at?: string;
+    uri?: string;
+    materialized?: boolean;
+    cached_at?: string;
+    stale?: boolean;
+    external_status?: string;
+    external_data?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    /** Preserve unknown fields from external sources */
+    [key: string]: unknown;
+}
+/**
+ * Storage format for edges (same as Edge, but aliased for clarity)
+ */
+export type StoredEdge = Edge;
+/**
+ * Complete persisted graph structure
+ */
+export interface PersistedGraph {
+    nodes: StoredNode[];
+    edges: StoredEdge[];
+    metadata?: GraphMetadata;
+}
+/**
+ * Graph-level metadata
+ */
+export interface GraphMetadata {
+    /** Schema version */
+    schema_version?: {
+        major: number;
+        minor: number;
+        patch: number;
+    };
+    /** When graph was created */
+    created_at?: string;
+    /** When graph was last compacted */
+    last_compacted_at?: string;
+}
+/**
+ * Changes to the graph (for incremental sync)
+ */
+export interface GraphChanges {
+    /** Nodes that were added/modified */
+    dirtyNodes: string[];
+    /** Nodes that were deleted */
+    deletedNodes: string[];
+    /** Edges that were added/modified */
+    dirtyEdges: string[];
+    /** Edges that were deleted */
+    deletedEdges: string[];
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/schema/storage.d.ts.map

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