@asobacloud/nehanda 0.0.0-stage → 0.2.0

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@asobacloud/nehanda",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Agentic terminal REPL and single-process engine for governed AI deep research and software development. Connects to Nehanda v3, Ollama, LM Studio, or any OpenAI-compatible API.",
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "scripts/",
+    "templates/",
+    "schema.sql",
+    "README.md",
+    "LICENSE",
+    "LICENSE.md"
+  ],
+  "bin": {
+    "ona": "./bin/agent.mjs",
+    "ona-code": "./bin/agent.mjs",
+    "nehanda": "./bin/nehanda-ui.mjs"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.mjs",
+    "start": "node ./bin/agent.mjs",
+    "repl": "node ./bin/agent.mjs",
+    "verify": "node ./scripts/verify-sdlc-hook-order.mjs",
+    "acceptance": "bash ./scripts/sdlc-acceptance.sh",
+    "test:bugs": "bash tests/bugs/run-all.sh",
+    "test:property": "bash tests/property/run-settings-persistence-tests.sh",
+    "test:unit": "bash tests/unit/run-all.sh"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "better-sqlite3": "^11.8.1",
+    "chalk": "^5.6.2",
+    "esprima": "^4.0.1",
+    "ink": "^6.8.0",
+    "ink-text-input": "^6.0.0",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
+    "react": "^19.2.4"
+  },
+  "devDependencies": {
+    "fast-check": "^4.7.0"
+  }
+}

package/schema.sql

@@ -0,0 +1,181 @@
+-- CLEAN_ROOM_SPEC.md §4.3 (canonical DDL)
+
+PRAGMA journal_mode = WAL;
+
+CREATE TABLE IF NOT EXISTS schema_meta (
+  key   TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS conversations (
+    id              TEXT PRIMARY KEY,
+    project_dir     TEXT NOT NULL,
+    created_at      TEXT NOT NULL DEFAULT (datetime('now')),
+    last_active     TEXT NOT NULL DEFAULT (datetime('now')),
+    phase           TEXT NOT NULL DEFAULT 'idle'
+);
+
+CREATE TABLE IF NOT EXISTS sessions (
+    session_id      TEXT PRIMARY KEY,
+    conversation_id TEXT NOT NULL REFERENCES conversations(id),
+    started_at      TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS state (
+    conversation_id TEXT NOT NULL,
+    key             TEXT NOT NULL,
+    value           TEXT,
+    updated_at      TEXT NOT NULL DEFAULT (datetime('now')),
+    PRIMARY KEY (conversation_id, key)
+);
+
+CREATE TABLE IF NOT EXISTS plans (
+    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+    conversation_id TEXT NOT NULL,
+    file_path       TEXT,
+    content         TEXT NOT NULL,
+    hash            TEXT NOT NULL,
+    status          TEXT NOT NULL DEFAULT 'draft',
+    created_at      TEXT NOT NULL DEFAULT (datetime('now')),
+    approved_at     TEXT,
+    completed_at    TEXT
+);
+
+CREATE TABLE IF NOT EXISTS summaries (
+    conversation_id TEXT PRIMARY KEY REFERENCES conversations(id),
+    content         TEXT NOT NULL,
+    word_count      INTEGER NOT NULL,
+    created_at      TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS events (
+    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+    conversation_id TEXT NOT NULL,
+    session_id      TEXT,
+    timestamp       TEXT NOT NULL DEFAULT (datetime('now')),
+    event_type      TEXT NOT NULL,
+    detail          TEXT
+);
+
+CREATE TABLE IF NOT EXISTS task_ratings (
+    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+    conversation_id TEXT NOT NULL,
+    rating          INTEGER NOT NULL,
+    objective       TEXT,
+    timestamp       TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS memories (
+    id TEXT PRIMARY KEY,
+    type TEXT NOT NULL,
+    title TEXT NOT NULL,
+    content TEXT,
+    keywords TEXT,
+    anticipated_queries TEXT,
+    concept_tags TEXT,
+    project_scope TEXT,
+    correction_count INTEGER DEFAULT 1,
+    created_at INTEGER NOT NULL,
+    updated_at INTEGER NOT NULL,
+    last_accessed INTEGER,
+    access_count INTEGER DEFAULT 0,
+    attention_score REAL DEFAULT 0.5,
+    -- Jev-Mem canonical node extensions (schema_version >= 2)
+    conversation_id TEXT,
+    session_id TEXT,
+    provenance TEXT,
+    entities_json TEXT DEFAULT '[]',
+    t_episodic REAL DEFAULT 0,
+    t_semantic REAL DEFAULT 0,
+    t_procedural REAL DEFAULT 0,
+    t_preference REAL DEFAULT 0,
+    source_entry_id INTEGER,
+    observation_ts INTEGER
+);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(
+    title, content, keywords, anticipated_queries,
+    tokenize='porter unicode61'
+);
+
+-- Multi-relational memory plane: independent views over shared nodes
+CREATE TABLE IF NOT EXISTS memory_edges (
+    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+    src_id          TEXT NOT NULL REFERENCES memories(id),
+    dst_id          TEXT NOT NULL REFERENCES memories(id),
+    relation        TEXT NOT NULL CHECK (relation IN ('semantic', 'temporal', 'causal', 'entity')),
+    weight          REAL NOT NULL DEFAULT 0,
+    meta_json       TEXT,
+    created_at      INTEGER NOT NULL,
+    UNIQUE(src_id, dst_id, relation)
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_edges_src ON memory_edges(src_id, relation);
+CREATE INDEX IF NOT EXISTS idx_memory_edges_dst ON memory_edges(dst_id, relation);
+CREATE INDEX IF NOT EXISTS idx_memories_conversation ON memories(conversation_id, observation_ts);
+
+-- System-1 session control block (canonical state header for System-2)
+CREATE TABLE IF NOT EXISTS laya_jev_state (
+    session_id          TEXT PRIMARY KEY REFERENCES sessions(session_id),
+    task_status         TEXT NOT NULL DEFAULT 'investigating'
+                        CHECK (task_status IN (
+                          'investigating', 'modifying_code', 'awaiting_user',
+                          'verifying', 'blocked', 'idle'
+                        )),
+    file_target         TEXT,
+    escalation_risk     INTEGER NOT NULL DEFAULT 0 CHECK (escalation_risk IN (0, 1)),
+    confidence_score    REAL NOT NULL DEFAULT 0,
+    state_json          TEXT,
+    updated_at          TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS transcript_entries (
+    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id      TEXT NOT NULL REFERENCES sessions(session_id),
+    sequence        INTEGER NOT NULL,
+    parent_entry_id INTEGER REFERENCES transcript_entries(id),
+    entry_type      TEXT NOT NULL,
+    payload_json    TEXT NOT NULL,
+    tool_use_id     TEXT,
+    created_at      TEXT NOT NULL DEFAULT (datetime('now')),
+    UNIQUE(session_id, sequence)
+);
+
+CREATE INDEX IF NOT EXISTS idx_transcript_session ON transcript_entries(session_id, sequence);
+
+CREATE TABLE IF NOT EXISTS hook_invocations (
+    id             INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id     TEXT NOT NULL,
+    conversation_id TEXT NOT NULL,
+    hook_event     TEXT NOT NULL,
+    hook_ordinal   INTEGER NOT NULL,
+    matcher        TEXT NOT NULL,
+    command        TEXT NOT NULL,
+    tool_use_id    TEXT,
+    tool_name      TEXT,
+    input_json     TEXT NOT NULL,
+    exit_code      INTEGER,
+    stdout_text    TEXT,
+    stderr_text    TEXT,
+    started_at     TEXT NOT NULL,
+    completed_at   TEXT,
+    skipped_reason TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_hook_inv_session ON hook_invocations(session_id, hook_ordinal);
+
+CREATE TABLE IF NOT EXISTS tool_permission_log (
+    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id      TEXT NOT NULL,
+    tool_use_id     TEXT NOT NULL,
+    tool_name       TEXT NOT NULL,
+    decision        TEXT NOT NULL,
+    reason_json     TEXT,
+    created_at      TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS settings_snapshot (
+    scope      TEXT PRIMARY KEY,
+    json       TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+);

package/scripts/postinstall.mjs

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * postinstall.mjs — runs automatically after `npm install`.
+ *
+ * Provisions the Laya System-1 venv (~808 MB one-time download) so the CLI
+ * starts instantly on every subsequent run. Skips if already provisioned.
+ *
+ * Exits non-zero on failure so `npm install` surfaces the error clearly.
+ */
+
+import { spawnSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+const NEHANDA_HOME = process.env.NEHANDA_HOME
+  || path.join(process.env.HOME || '/tmp', '.nehanda')
+const MARKER = path.join(NEHANDA_HOME, '.laya-ready')
+const VENV_PYTHON = path.join(NEHANDA_HOME, 'venv', 'bin', 'python')
+const ENSURE_SCRIPT = path.resolve(__dirname, '..', 'lib', 'scripts', 'ensure-laya-env.sh')
+
+// Already provisioned — nothing to do.
+if (fs.existsSync(MARKER) && fs.existsSync(VENV_PYTHON) && !process.env.LAYA_FORCE_REPROVISION) {
+  process.stderr.write('[nehanda] Laya already provisioned, skipping.\n')
+  process.exit(0)
+}
+
+if (!fs.existsSync(ENSURE_SCRIPT)) {
+  process.stderr.write(
+    `[nehanda] ERROR: provisioning script not found at ${ENSURE_SCRIPT}\n` +
+    `  The package may be corrupted. Try: npm install @asobacloud/nehanda --force\n`
+  )
+  process.exit(1)
+}
+
+process.stderr.write(
+  '\n[nehanda] Provisioning Laya System-1 venv (~808 MB one-time download).\n' +
+  '[nehanda] This only happens once. The CLI will start instantly after this.\n\n'
+)
+
+const result = spawnSync('bash', [ENSURE_SCRIPT], {
+  stdio: 'inherit',
+  env: { ...process.env },
+})
+
+if (result.error) {
+  process.stderr.write(`[nehanda] Failed to run provisioning script: ${result.error.message}\n`)
+  process.exit(1)
+}
+
+if (result.status !== 0) {
+  process.stderr.write(
+    `\n[nehanda] Laya provisioning failed (exit code ${result.status}).\n` +
+    `  Check the output above for details.\n` +
+    `  You can retry manually: bash ${ENSURE_SCRIPT}\n`
+  )
+  process.exit(result.status ?? 1)
+}
+
+process.stderr.write('\n[nehanda] Laya provisioned successfully. Run: nehanda\n\n')