intentional-cognition-os 1.0.0

package/dist/migrations/001-initial-schema.sql

@@ -0,0 +1,136 @@
+-- Migration: 001-initial-schema
+-- Description: Create all initial tables, indexes, and pragmas
+-- Date: 2026-04-06
+
+-- === UP ===
+
+CREATE TABLE sources (
+    id          TEXT    PRIMARY KEY,
+    path        TEXT    NOT NULL,
+    mount_id    TEXT    REFERENCES mounts(id),
+    type        TEXT    NOT NULL CHECK (type IN ('pdf', 'markdown', 'html', 'text')),
+    title       TEXT,
+    author      TEXT,
+    ingested_at TEXT    NOT NULL,
+    word_count  INTEGER,
+    hash        TEXT    NOT NULL,
+    metadata    TEXT,
+    UNIQUE (path, hash)
+);
+
+CREATE TABLE mounts (
+    id              TEXT    PRIMARY KEY,
+    name            TEXT    NOT NULL UNIQUE,
+    path            TEXT    NOT NULL,
+    created_at      TEXT    NOT NULL,
+    last_indexed_at TEXT
+);
+
+CREATE TABLE compilations (
+    id          TEXT    PRIMARY KEY,
+    source_id   TEXT    REFERENCES sources(id),
+    type        TEXT    NOT NULL CHECK (type IN (
+                            'summary', 'concept', 'topic',
+                            'entity', 'contradiction', 'open-question'
+                        )),
+    output_path TEXT    NOT NULL,
+    compiled_at TEXT    NOT NULL,
+    stale       INTEGER NOT NULL DEFAULT 0 CHECK (stale IN (0, 1)),
+    model       TEXT    NOT NULL,
+    tokens_used INTEGER,
+    UNIQUE (source_id, type, output_path)
+);
+
+CREATE TABLE tasks (
+    id              TEXT    PRIMARY KEY,
+    brief           TEXT    NOT NULL,
+    status          TEXT    NOT NULL DEFAULT 'created' CHECK (status IN (
+                                'created', 'collecting', 'synthesizing',
+                                'critiquing', 'rendering', 'completed', 'archived'
+                            )),
+    created_at      TEXT    NOT NULL,
+    updated_at      TEXT    NOT NULL,
+    completed_at    TEXT,
+    archived_at     TEXT,
+    workspace_path  TEXT    NOT NULL
+);
+
+CREATE TABLE promotions (
+    id              TEXT    PRIMARY KEY,
+    source_path     TEXT    NOT NULL,
+    target_path     TEXT    NOT NULL,
+    target_type     TEXT    NOT NULL CHECK (target_type IN (
+                                'topic', 'concept', 'entity', 'reference'
+                            )),
+    promoted_at     TEXT    NOT NULL,
+    promoted_by     TEXT    NOT NULL CHECK (promoted_by IN ('user', 'system'))
+);
+
+CREATE TABLE recall_results (
+    id          TEXT    PRIMARY KEY,
+    concept     TEXT    NOT NULL,
+    topic       TEXT,
+    correct     INTEGER NOT NULL CHECK (correct IN (0, 1)),
+    tested_at   TEXT    NOT NULL,
+    confidence  REAL    CHECK (confidence >= 0.0 AND confidence <= 1.0),
+    source_card TEXT
+);
+
+CREATE TABLE traces (
+    id              TEXT    PRIMARY KEY,
+    event_type      TEXT    NOT NULL,
+    correlation_id  TEXT,
+    timestamp       TEXT    NOT NULL,
+    file_path       TEXT    NOT NULL,
+    line_offset     INTEGER NOT NULL,
+    summary         TEXT
+);
+
+CREATE TABLE compilation_sources (
+    compilation_id  TEXT    NOT NULL REFERENCES compilations(id) ON DELETE CASCADE,
+    source_id       TEXT    NOT NULL REFERENCES sources(id),
+    PRIMARY KEY (compilation_id, source_id)
+);
+
+-- Indexes
+CREATE INDEX idx_sources_hash ON sources(hash);
+CREATE INDEX idx_sources_type ON sources(type);
+CREATE INDEX idx_sources_mount_id ON sources(mount_id);
+CREATE INDEX idx_compilations_source_id ON compilations(source_id);
+CREATE INDEX idx_compilations_type ON compilations(type);
+CREATE INDEX idx_compilations_stale ON compilations(stale) WHERE stale = 1;
+CREATE INDEX idx_compilations_output_path ON compilations(output_path);
+CREATE INDEX idx_tasks_status ON tasks(status);
+CREATE INDEX idx_tasks_created_at ON tasks(created_at);
+CREATE INDEX idx_recall_results_concept ON recall_results(concept);
+CREATE INDEX idx_recall_results_tested_at ON recall_results(tested_at);
+CREATE INDEX idx_traces_event_type ON traces(event_type);
+CREATE INDEX idx_traces_correlation_id ON traces(correlation_id) WHERE correlation_id IS NOT NULL;
+CREATE INDEX idx_traces_timestamp ON traces(timestamp);
+CREATE INDEX idx_compilation_sources_source_id ON compilation_sources(source_id);
+
+-- === DOWN ===
+
+DROP INDEX IF EXISTS idx_compilation_sources_source_id;
+DROP INDEX IF EXISTS idx_traces_timestamp;
+DROP INDEX IF EXISTS idx_traces_correlation_id;
+DROP INDEX IF EXISTS idx_traces_event_type;
+DROP INDEX IF EXISTS idx_recall_results_tested_at;
+DROP INDEX IF EXISTS idx_recall_results_concept;
+DROP INDEX IF EXISTS idx_tasks_created_at;
+DROP INDEX IF EXISTS idx_tasks_status;
+DROP INDEX IF EXISTS idx_compilations_output_path;
+DROP INDEX IF EXISTS idx_compilations_stale;
+DROP INDEX IF EXISTS idx_compilations_type;
+DROP INDEX IF EXISTS idx_compilations_source_id;
+DROP INDEX IF EXISTS idx_sources_mount_id;
+DROP INDEX IF EXISTS idx_sources_type;
+DROP INDEX IF EXISTS idx_sources_hash;
+DROP TABLE IF EXISTS compilation_sources;
+DROP TABLE IF EXISTS traces;
+DROP TABLE IF EXISTS recall_results;
+DROP TABLE IF EXISTS promotions;
+DROP TABLE IF EXISTS tasks;
+DROP TABLE IF EXISTS compilations;
+DROP TABLE IF EXISTS mounts;
+DROP TABLE IF EXISTS sources;

package/dist/migrations/002-add-source-hash.sql

@@ -0,0 +1,9 @@
+-- Migration: 002-add-source-hash
+-- Description: Add source_hash column to promotions table
+-- Date: 2026-04-06
+
+-- === UP ===
+ALTER TABLE promotions ADD COLUMN source_hash TEXT;
+
+-- === DOWN ===
+-- SQLite doesn't support DROP COLUMN, so this is a no-op comment

package/dist/migrations/003-add-failure-statuses.sql

@@ -0,0 +1,46 @@
+-- Migration: 003-add-failure-statuses
+-- Description: Expand tasks.status CHECK constraint to include four
+--              recoverable failure states used by the research orchestrator
+--              (E9-B06): failed_collecting, failed_synthesizing,
+--              failed_critiquing, failed_rendering.
+--
+--              SQLite does not support ALTER COLUMN on CHECK constraints, so
+--              this migration rewrites the tasks table: create a new table
+--              with the expanded constraint, copy rows, drop the old one,
+--              rename. Indexes are rebuilt after the rename. No data loss.
+-- Date: 2026-04-15
+
+-- === UP ===
+CREATE TABLE tasks_new (
+    id              TEXT    PRIMARY KEY,
+    brief           TEXT    NOT NULL,
+    status          TEXT    NOT NULL DEFAULT 'created' CHECK (status IN (
+                                'created', 'collecting', 'synthesizing',
+                                'critiquing', 'rendering', 'completed', 'archived',
+                                'failed_collecting', 'failed_synthesizing',
+                                'failed_critiquing', 'failed_rendering'
+                            )),
+    created_at      TEXT    NOT NULL,
+    updated_at      TEXT    NOT NULL,
+    completed_at    TEXT,
+    archived_at     TEXT,
+    workspace_path  TEXT    NOT NULL
+);
+
+INSERT INTO tasks_new (id, brief, status, created_at, updated_at, completed_at, archived_at, workspace_path)
+    SELECT id, brief, status, created_at, updated_at, completed_at, archived_at, workspace_path
+    FROM tasks;
+
+DROP INDEX IF EXISTS idx_tasks_status;
+DROP INDEX IF EXISTS idx_tasks_created_at;
+DROP TABLE tasks;
+ALTER TABLE tasks_new RENAME TO tasks;
+
+CREATE INDEX idx_tasks_status ON tasks(status);
+CREATE INDEX idx_tasks_created_at ON tasks(created_at);
+
+-- === DOWN ===
+-- Narrowing the CHECK back would require migrating any failure-state rows
+-- to a legal value first. Intentionally no-op: rolling back this migration
+-- on a populated database would silently discard state. Restore from a
+-- pre-migration backup instead.

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "intentional-cognition-os",
+  "version": "1.0.0",
+  "description": "Local-first knowledge operating system. Compile knowledge for the machine; distill understanding for the human.",
+  "type": "module",
+  "bin": {
+    "ico": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "knowledge-management",
+    "ai",
+    "claude",
+    "anthropic",
+    "rag",
+    "research",
+    "cli",
+    "local-first",
+    "knowledge-graph"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "prepublishOnly": "pnpm -w build && pnpm -w lint && pnpm -w typecheck && pnpm -w test",
+    "verify-pack": "bash ../../scripts/verify-npm-pack.sh"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.82.0",
+    "better-sqlite3": "^11.9.0",
+    "commander": "^13.0.0",
+    "gray-matter": "^4.0.3",
+    "js-yaml": "^4.1.1",
+    "pdf-parse": "^2.4.5",
+    "turndown": "^7.2.4"
+  },
+  "devDependencies": {
+    "@ico/compiler": "workspace:*",
+    "@ico/kernel": "workspace:*",
+    "@ico/types": "workspace:*",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.0",
+    "vitest": "^4.1.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jeremylongshore/intentional-cognition-os.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/jeremylongshore/intentional-cognition-os/issues"
+  },
+  "homepage": "https://github.com/jeremylongshore/intentional-cognition-os#readme",
+  "license": "MIT",
+  "author": "Jeremy Longshore <jeremy@intentsolutions.io> (https://intentsolutions.io)"
+}