Core library for Cairn task management
npm install @valpet/cairn-coreCore library for Cairn task management system.
``bash`
npm install @valpet/cairn-core
This package provides the foundational data structures and business logic for Cairn, a task management system designed for AI agents and developers. It handles:
- JSONL-based storage with file locking
- Dependency graph management
- Task compaction and optimization
- TypeScript interfaces and types
`typescript
import { createContainer, TYPES, IStorageService, IGraphService } from '@valpet/cairn-core';
const container = createContainer('/path/to/.cairn', '/path/to/repo');
const storage = container.get
const graph = container.get
// Create and save a task
const task = {
id: 'task-1',
title: 'Implement user authentication',
status: 'open',
type: 'feature',
priority: 'high',
created_at: new Date().toISOString(),
updated_at: new Date().toISOString()
};
await storage.saveTask(task);
// Get ready work
const readyTasks = graph.getReadyWork(await storage.loadTasks());
``
See the full documentation for complete API reference.
MIT License - see LICENSE file for details.
This software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.