MARIA-LITE (v2.1.4)

MARIA-LITE is a lightweight, standalone CLI build of MARIA OS focused on a smaller runtime surface while preserving API compatibility with @bonginkan/maria.

Install

Global install:

npm i -g @bonginkan/maria-lite

Update

npm update -g @bonginkan/maria-lite

Usage

Start an interactive session:

maria-lite

Run a single command:

maria-lite /help

Notes:

• Without --apply, commands run in plan-only mode where supported (no side effects).
• Clone commands write under artifacts/<role>-clone/ when --apply.

Version

This package is published as 2.1.4.

Extensions (Enterprise)

Enterprise builds may ship custom commands as extension packs.

• Installer: @bonginkan/maria-ext (enterprise pack bundle)
• Run-time gating: extension commands are enabled only when the current account is authorized server-side (Firestore).
• Discovery: maria-lite discovers installed packs dynamically at runtime (no manual pack/email flags).

Install (example):

npm install -g @bonginkan/maria-ext

Research (Lite)

Best-effort web research (with a clear no-web fallback when unavailable):

/research "TypeScript tsup ESM CJS output settings"

Knowledge Packs (Lite)

Generate new knowledge packs by iteratively researching a topic (writes YAML + rebuilds index.jsonl with --apply):

/kp-generate "Best practice for clean coding and well-organized OOP architecture using TypeScript" --apply

Universe (Lite)

Universe is an experimental multi-agent runtime inside MARIA-LITE.

Commands

Create a universe (spec + agents + channels) and persist it:

/universe genesis "Hiring process redesign" --name hiring_demo --sample

Show the deterministic org chart (tree + agent roles/names):

/universe org-chart --name hiring_demo --sample

Run the universe (iterative; can block for questions):

/universe inflate --name hiring_demo --sample
/universe inflate --name hiring_demo --sample --answer "Use a 2-week sprint cadence"

Append creator-provided knowledge to common context:

/universe revelation --name hiring_demo --sample --push "Always produce a final PDF deliverable."

Behavior notes

• Checkpoints: genesis writes checkpoints so it can resume after failures.
• A2A envelopes: agents communicate via an envelope-like protocol with policy enforcement (no sibling direct; manager hop routing).
• RAG-like retrieval: agents can request common-context searches; results are injected back into a follow-up step.
• Spinner labels: the spinner shows the active agent name/role (not a generic "MARIA is thinking").

Release Notes

v2.1.4 (2026/01)

Features

• Added a max filename clamp for knowledge pack YAML outputs to avoid Windows Filename too long errors.
• Added a stable short hash suffix to clamped filenames to reduce collisions (configurable via MARIA_LITE_MAX_PACK_FILENAME_CHARS).

Bug fixes

• Fixed knowledge pack YAML writes in /kp-generate (and universe /universe inflate tool-call saves) so they no longer produce pathologically long filenames on Windows.
• Renamed already-generated long YAML filenames and updated src-lite/knowledge-packs/index.meta.json paths accordingly (repo-side migration).

v2.1.3 (2026/01)

Features

• Added /kp-generate --dev to control where generated packs are written (dev: src-lite/knowledge-packs/, default: artifacts/knowledge-packs/).
• Added cross-process file locking + atomic writes for knowledge pack/origin index rebuilds (reduces corruption when running multiple evolves in parallel).
• Added universe-level locking + safer writes to reduce concurrent universe run corruption (genesis/inflate + contexts).

Bug fixes

• /evolve now supports --direction "..." and forwards it to /self-recognition so the gap topics align.

v2.1.2 (2026/01)

Features

• Enforced "retrieve-first" behavior for LLM-backed commands: run retrieval (origin + knowledge packs) before answering and inject results via retrievedKnowledge metadata when available.

Bug fixes

• Fixed /universe multiverse sample discovery in installed/npm environments by resolving the CLI entrypoint path (handles symlinks) and using robust universe sample root resolution.

v2.1.1 (2026/01)

Features

• Added /import-origin Wikisource mode (--w) to split a large MediaWiki XML export into per-<page> files during import (streaming split; avoids giant single-file ingestion).
• Added best-effort .xml text extraction so imported XML sources become readable/searchable in the origin index.
• Switched knowledge retrieval to stream-scan index.jsonl (origin + knowledge packs) instead of reading the entire index into memory.

Bug fixes

• Fixed REPL stop messaging: upstream AbortError (e.g., request timeout) is no longer mislabeled as stopped; it now reports an explicit timeout/abort hint.

v2.1.0 (2026/01)

Features

• Added /kp-generate --local --path to generate knowledge packs from local files/folders (recursive), writing by default under artifacts/knowledge-packs/ and making them available to retrieval.
• Extended /universe revelation to accept folders (recursive) and extract text from common business document formats (PDF/Office/iWork/Google shortcut files) before appending to universe common context.
• Added name-less /universe inflate "<topic>" mode that auto-selects the best existing universe using multiverse information, and supports --answer continuation via the last auto-selected universe.
• Added /self-recognition --direction and expanded domain examples to reduce over-focus on code/LLMs; /self-recognition now also considers local knowledge packs under artifacts/knowledge-packs/ when available.
• Split self-recognition/evolve automation into separate KP and Universe GitHub Actions workflows, with optional external triggers and auto-merge.

Bug fixes

• Improved deduplication for /evolve --universe to avoid generating duplicate universes for the same topic when an existing match is present.
• Improved universe genesis naming stability and uniqueness (higher Japanese name ratio; avoids manager/lister sharing the same human name).
• Reduced log “line bloat” in long-running tasks by clamping spinner text to terminal width (prevents wrap-induced repetition).
• Fixed maria-lite packaging behavior so /universe multiverse can discover sample universes when running from an installed npm package.

v2.0.3 (2026/01)

Features

• /blog generate now supports an ISO datetime for --since (in addition to YYYYMMDD).
• If --since is omitted, the default evidence window start is resolved from Firestore as the latest timestamp for yesterday's blog (best-effort), with a deterministic fallback.

Bug fixes

• Stabilized /blog evidence window defaults for CI environments by using Firestore as the source of truth when available.

v2.0.2 (2026/01)

Features

• Extension commands now refresh cleanly after account switching (logout → login) without requiring a CLI restart.

Bug fixes

• Fixed inconsistent enterprise extension availability after switching accounts (help/dispatch could become stale).

v2.0.1 (2026/01)

Features

• Blog syncing now prefers the newest draft when multiple drafts exist for the same date+slot (deterministic winner selection).

Bug fixes

• Fixed occasional ordering issues where older blog drafts could be selected/synced when multiple candidates shared the same date+slot.

v2.0.0 (2026/01)

Features

• Added /self-recognition to identify missing areas across knowledge packs, universe samples, and code (report-first; JSON output supported).
• Added /evolve to iteratively act on /self-recognition results (supports knowledge pack generation and universe sample generation; continues topic-by-topic even if one fails).
• Added /universe multiverse to list all generated universes (sample + artifacts) in a human-friendly summary.
• Enabled /kp-generate as a tool-call inside /universe inflate so universes can generate and attach new packs into their common context.

Bug fixes

• Improved robustness of universe genesis against incomplete or malformed model output (best-effort recovery and safer defaults).
• Ensured universe specs validate that every node has required manager/lister coverage (not just the root).

v1.2.2 (2026/01)

Features

• Enterprise extensions are now server-authorized (Firestore) and discovered dynamically at runtime.

Bug fixes

• Prevented one-shot CLI output from printing the startup "Ready" banner for help/unknown-command cases.

v1.2.1 (2026/01)

Features

• Added enterprise extension reliability improvements (lazy load after install/login; no restart required).

Bug fixes

• Fixed extension pack loading by removing runtime dependency on @bonginkan/maria-lite/ext from packs (API is injected by the loader).
• Fixed /aa to run with no args (prints aa.txt) via runOnEmpty.

v1.2.0 (2026/01)

Features

• Added enterprise extension packs: @bonginkan/maria-ext can install custom commands into MARIA-LITE.
• Added extension API surface: @bonginkan/maria-lite/ext exports base classes/types for extension commands (worker/checker/field).
• Added deterministic extension gating by logged-in email (supports exact match and *@domain).

v1.1.1 (2026/01)

Features

• Persisted REPL command history across sessions (arrow-up works after /quit).
• Improved /kp-generate defaults (max-rounds/top-k/max-packs default to 10) and stabilized pack IDs/categories from the topic.

Bug fixes

• Prevented control commands like /quit from being persisted into REPL history.

v1.1.0 (2026/01)

Features

• Restored best-effort web search for /research (with deterministic no-web fallback).
• Added /kp-generate to iteratively research a topic and generate LITE-compatible knowledge packs (YAML) and rebuild the index.

Bug fixes

• Improved spinner labels for research/planning/universe tasks (avoids generic "thinking" during long operations).

v1.0.0 (2026/01)

Features

• Added /universe (genesis/inflate/org-chart/revelation) with multi-agent orchestration.
• Added A2A envelope-style messaging with deterministic policy enforcement and routing.
• Added incremental materialization during genesis (agents/spec saved progressively) and resumable checkpoints.
• Added RAG-like deterministic common-context search loop for agents.

v0.0.3 (2026/01)

Features

• Added /git and /gh passthrough commands (run the system git / gh from inside MARIA-LITE).
• Best-effort auto-install guidance/attempts when git / gh are not available.

Bug fixes

• Prevented terminal escape/control sequences from leaking into REPL output during /gh execution.

v0.0.1 (2026/01)

Features

• Enabled /stop and /restart for interactive sessions.
• Added an auto version updater (src-lite/scripts/version-update.mjs) to bump or set the package version across key files.

Bug fixes

• Fixed REPL stability so a stop request no longer leaves the session in an unusable state.