MARIA-LITE (v10.0.0)

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:

• Commands apply by default (side effects enabled).
  • Disable this behavior with MARIA_LITE_IMPLICIT_APPLY=0.
  • Selected commands support --plan-only when you explicitly want a non-destructive preview.
• maria-lite (no args) starts the local GUI automatically (same as /gui).
  • Disable this behavior with MARIA_LITE_AUTO_GUI=0.
• Dev commands that write files support grouped rollback checkpoints:
  • List: /rollback --list
  • Roll back latest: /rollback
  • Roll back multiple (newest → that run): /rollback --run <runId>
• Clone commands write under ~/.maria/desktop/artifacts/<role>-clone/ by default.

Development (src-lite)

For maria_code/src-lite development, use the shared repo install plus the src-lite build target:

pnpm install
pnpm -s -C src-lite build
pnpm exec tsc --noEmit

Notes:

• Do not use ad-hoc src-lite-only typecheck commands that diverge from the repo standard.
• The primary build signal for Lite work is pnpm -s -C src-lite build.

Artifacts & Desktop Layout

MARIA-LITE now treats the desktop workspace as the source of truth for persisted artifacts.

• Standard artifact root: ~/.maria/desktop/artifacts/
• Universe workspace root: ~/.maria/desktop/universe/
• Constitution store: ~/.maria/constitution.json
• Constitution audit log: ~/.maria/constitution.audit.jsonl

Examples:

• GTM local store: ~/.maria/desktop/artifacts/gtm/store.json
• Event bus log: ~/.maria/desktop/artifacts/event-bus/events.jsonl
• Command memory: ~/.maria/desktop/artifacts/memory/command-memory.jsonl
• Reports: ~/.maria/desktop/artifacts/reports/

Legacy ./artifacts/... paths are treated as read fallbacks where supported, but new writes should land under ~/.maria/desktop/artifacts/....

Version

This package is published as 10.0.0.

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 by default):

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

Update existing knowledge packs with minimal (diff-style) edits (writes YAML + rebuilds index.jsonl by default):

/kp-update --json

Synthesize new cross-domain memes/hypotheses by combining multiple NDC areas (writes YAML + rebuilds index.jsonl by default):

/kp-synthesis --ndc 3 --pick 2 --json

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").
• Subcommand event logs: inflate emits per-subcommand start / complete / fail events into the Lite event log, so reruns can be audited from Desktop event logs.
• Rerun-safe autosave: rerunning a failed universe no longer attempts to write files into directory targets such as contexts/; directory targets are preserved and skipped safely.

Autonomous Ops (Lite)

MARIA-LITE now includes the first event-driven autonomous loop for src-lite.

Core commands:

/self-improve run --code --auto-fix
/constitution review
/constitution drift
/goal-loop run --event-kind github.push --event-topic owner/repo --auto-fix
/events list --limit 20
/notification-router add-slack --name ops-slack --min-severity warn --target https://hooks.slack.com/services/...

Inbound / watcher commands:

/github-webhook setup --events "push,pull_request,issues"
/slack-webhook setup --events "app_mention,message"
/watch set --name repo-watch --paths "src-lite,maria-code-lp" --interval 30s --commands "/goal-loop run --event-kind fs.changed --auto-fix,/doctor"
/gmail watch sync --query "label:inbox newer_than:7d" --max 25

What this adds:

• self-improve: cross-session self-recognition + evolve dispatch + optional low-risk code auto-fix.
• constitution: machine-readable organizational constitution, active phase switching, and drift detection.
• goal-loop: event-driven orchestration that routes triggers into autonomous self-improvement runs.
• events + notification-router: event bus inspection, TTL escalation, and Discord/Slack/email/log routing.
• github-webhook / slack-webhook / watch / gmail watch: inbound trigger surface for GitHub, Slack, file changes, and Gmail inbox activity.

GTM (Lite, Local-First)

/gtm now supports both blueprint generation and an operational local-first revenue loop when HubSpot / Apollo / Clay / Salesforce / Gong are not connected yet.

Planning examples:

/gtm brief "AI coding platform for enterprise engineering teams"
/gtm icp --in @docs/product-brief.md --market "Japan + US B2B SaaS"
/gtm sequence "Vertical AI copilot for support teams" --channels "email,linkedin,partner"

Operational examples:

/gtm ingest --lead "{\"email\":\"[email protected]\",\"company\":\"Example\",\"signals\":[\"funding\",\"ai\"]}"
/gtm ingest --source gmail --query "label:inbox newer_than:14d" --max 25
/gtm leads
/gtm pipeline
/gtm toolkit
/gtm autopilot --dispatch email
/gtm proposal --lead <leadId> --amount-usd 5000
/gtm invoice --lead <leadId> --amount-usd 5000
/gtm stage --lead <leadId> --status replied

Stored outputs:

• Lead / pipeline state: ~/.maria/desktop/artifacts/gtm/store.json
• Toolkit templates: ~/.maria/desktop/artifacts/gtm/toolkit/
• Proposal drafts: ~/.maria/desktop/artifacts/gtm/proposals/
• Invoice drafts: ~/.maria/desktop/artifacts/gtm/invoices/

OS Lite Server & LP Integration

When src-lite runs as the server-side MARIA OS Lite runtime (for example behind maria-code-lp / Cloud Run), the same autonomous surfaces are available over HTTP.

• Daily intelligence routes support per-report JST trigger times and Discord-aware configuration when paired with LP settings.
• Inbound event routes include /api/hooks/github and /api/hooks/slack.
• Per-user Lite servers can be rolled forward from the shared image rollout path; active servers are eligible for automatic redeploy, while long-inactive servers can require explicit user update confirmation.
• The server-side event bus, reports, GTM state, and memory stores still resolve into the same desktop artifact root described above.

Release Notes

v10.0.0 (2026/03)

Features

• /billing: New command to open the billing portal to manage your plan.
• /billing: Supports --no-open to print the URL without launching a browser.
• /billing: Supports --json output for automation-friendly billing info.
• /chat: Uses the active persona as system context for more consistent replies.
• /chat: Adds best-effort persona memory injection when a persona is selected.
• /daily-news: Improved Discord delivery support when sending daily outputs.
• /daily-papers: Improved Discord delivery support when sending daily outputs.
• /daily-report: Improved Discord delivery support when sending daily outputs.
• /daily-insights: Improved Discord delivery support when sending daily outputs.
• /daily-news: Better support for posting long content plus embeds to Discord.
• /daily-papers: Better support for posting long content plus embeds to Discord.
• /daily-report: Better support for posting long content plus embeds to Discord.
• /daily-insights: Better support for posting long content plus embeds to Discord.

Bug fixes

• /daily-insights: Handles AI inference failures more safely to avoid aborting runs.
• /daily-news: Avoids failing the run when daily context inference errors.
• /daily-papers: Avoids failing the run when daily context inference errors.
• /daily-report: Avoids failing the run when daily context inference errors.
• /schedule: Improved stability for daily connections and delivery flows.
• /usage: More consistent quota and account messaging during CLI auth calls.
• /upgrade: More reliable manage-plan routing and browser open behavior.
• /help: Updated command discovery to include new /billing and daily changes.
• /review: Improved reliability when generating or delivering previews via Discord.

v9.0.0 (2026/03)

Features

• /analytics: New command to generate a cross-product analytics dashboard.
• /analytics: Exports interactive HTML plus JSON and a Markdown summary.
• /analytics: Includes command run stats (completed/failed/stopped) from history.
• /analytics: Summarizes event-bus activity with severity breakdown and recent errors.
• /analytics: Adds multi-repo git activity charts and totals for commits and churn.
• /analytics: Pulls GitHub issue/PR metrics when available via gh CLI.
• /analytics: Shows server usage, health, and billing snapshots when authenticated.
• /analytics: Optionally includes Google Calendar and Gmail summaries via OAuth.
• /vui: Adds STT support on Windows and Linux.
• /vui: Adds ElevenLabs voice support, including optional API key handling.
• /vui: Updates the VUI flow to v2 for improved avatar/voice session behavior.
• /vui: Improves desktop integration (taskbar, icons, uploads, file manager).
• Platform: Context menu behavior updated for the desktop client.

Bug fixes

• /analytics: Fixes data collection and aggregation issues in the dashboard output.
• /vui: Fixes model loading in the Tauri desktop build.
• /vui: Reduces unnecessary VRM/Live2D data to avoid heavier sessions.
• Platform: Improves CLI auth API calling reliability and error handling.

v8.0.2 (2026/03)

Features

• /vup: release notes now use deterministic, scope-based summaries from changed paths.
• /vup: scope bullets now describe what changed (e.g., command entrypoint vs helpers).
• /blog: auto-detect changed paths from git name-only sources to drive release summaries.
• /blog: inject a 'What Changed' section when deterministic update signals are available.
• /blog: add deterministic scope + digest summaries into blog sources for traceable drafts.

Bug fixes

• /blog: normalize path separators and de-duplicate paths for stable change detection.
• /blog: ignore non-path git summary lines when extracting changed files.

v8.0.1 (2026/03)

Features

• /auto-dev: Adds preview mode; use --plan-only to preview generation.
• /auto-dev: Updates guidance to write files by removing --plan-only.
• /blog: Now applies by default; removes the need for --apply in common flows.
• /blog: Updates /blog generate and /blog sync help to reflect default apply.
• /bulk-register: Now applies by default; use --plan-only to preview safely.
• /bulk-register: Adds preview support and clearer post-run next steps.
• /code: Now applies by default; use --plan-only for no-write previews.
• /code: Accepts absolute paths and ~ paths in --files and inline refs.
• /code: Can derive workspace root from provided target file paths.
• /code: Supports --workspace as relative or absolute path, even outside git repos.
• /code: Rejects edits outside the selected workspace with clearer guidance.
• /vup: Generates more command-centric release notes with fuller change coverage.

Bug fixes

• /code: More reliable path parsing, including bare filenames with extensions.
• /code: Better errors when workspace cannot be inferred from mixed target paths.
• /code: Improved guidance for missing workspaces and when to use --new-workspace.
• /blog: Fixes confusing dry-run messaging now that applies by default.
• /bulk-register: Avoids accidental non-action runs by aligning defaults with help text.

v8.0.0 (2026/03)

Features

• Added /self-improve, /constitution, /goal-loop, /events, and /notification-router to start the autonomous self-improvement loop in Lite.
• Added inbound GitHub and Slack webhook commands, a polling /watch daemon, and /gmail watch sync to turn external events into goal-loop triggers.
• Expanded /gtm from blueprint generation into a local-first revenue operating loop with ingest, leads, pipeline, toolkit, autopilot, proposal, invoice, and stage.
• Added OS Lite server-side support for JST-based daily intelligence scheduling, Discord setup/channel routing, and LP-driven per-user rollout flows.
• Expanded dev-decision inputs so day-level reports, repo context, strategy, and issue signals can be used to produce more concrete issue proposals.
• Standardized Lite artifact writes under ~/.maria/desktop/artifacts/ and moved GTM/event/memory/report outputs to the desktop SSOT path.
• Universe inflate now logs subcommand-level event records and handles reruns safely when prior runs left directory targets such as contexts/.
• New /apollo command to set up and run Apollo GTM integrations.
• /billing-pl adds clearer help, typed flags, and improved output formatting.
• /billing-pl supports more natural-language queries incl. revenue, cost, MRR, cumulative.
• /billing-pl adds role-based access checks for financial data visibility.
• /auto-dev now writes generated artifacts to a default desktop location.
• Expanded MARIA-LITE knowledge packs and reorganized indices into NDC shards.

Bug fixes

• Prevented rerun failures caused by directory auto-save targets during universe inflate.
• Hardened artifact path resolution and filename shortening for more reliable Windows/macOS desktop persistence.
• Improved month parsing and range handling for /billing-pl natural-language queries.
• More robust project lookup and per-project calculations in /billing-pl.
• Reduced ambiguous output by adding dedicated revenue and cost summary views.

v7.3.1 (2026/03)

Features

• Improved /gcal handling.
• /phone-tenant connect now supports multi-tenant mode via optional --tenant.
• Expanded knowledge packs for self-recognition, safety boundaries, and compliance.

Bug fixes

• Improved /phone-tenant connection setup messaging and validation.

v7.3.0 (2026/03)

Features

• Game category added with minesweeper, brick breaker, reversi, and craft to make it easier to understand the agentic OS system.
• Knowledge packs and indices expanded and reorganized for faster lookup.

Bug fixes

• Improved dependency handling in /estimate scheduling (cycle-safe).

v7.2.0 (2026/03)

Features

• Added /estimate to generate effort estimates with tasks, risks, and schedules.
• Improved /estimate with skill-based developer assignment and load balancing.
• More Adjustable window.
• /universe genesis improved to become more autonomous.
• A pixel like office GUI to present universe now available.

Bug fixes

• Improved spreadsheet export reliability by exposing shared XLSX builder.

v7.1.2 (2026/03)

Features

• Added /estimate to create effort estimates with tasks, risks, and assumptions.
• Added /estimate scheduling with critical path, resource leveling, and Gantt output.
• Added /estimate GitHub repo analysis to calibrate estimates from codebase context.
• Expanded knowledge packs and reorganized NDC indexing for faster topic lookup.

Bug fixes

• Improved /spreadsheet export reliability by reusing the shared XLSX builder.

v7.1.1 (2026/03)

Features

• Added new self-recognition safety and decision guidance knowledge packs.
• Expanded Japan-focused biometrics governance timelines and SOP knowledge packs.
• Reorganized the built-in knowledge index for faster lookup and smaller loads.
• Enhanced windows support on auto installation.

Bug fixes

• Improved desktop bundling reliability across platforms, including Linux support.
• General packaging and version resolution updates for more consistent releases.

v7.1.0 (2026/03)

Features

• Linux release now available on https://maria-code.ai .

Bug fixes

• Improved Tauri bundling reliability across platforms, including Linux support.

v7.0.1 (2026/03)

Features

• Add /vup push to commit, tag, and push after /vup.
• /vup help now documents the new push step in the version bump flow.

Bug fixes

• Improve /vup push errors when git is missing, repo root is wrong, or nothing changed.
• Update and reindex knowledge packs after renames for better Windows support.

v7.0.0 (2026/03)

Features

• /vup now also bumps desktop build metadata for app/exe releases.
• /vup output includes clearer post-apply steps to commit, tag, and push.

Bug fixes

• Updated bundled knowledge pack catalogs to reflect new and rebalanced entries.

v6.3.2 (2026/03)

Features

• Improved /gcal Admin resource management (buildings & rooms) output and handling.
• Enhanced /resource-manager with clearer tables and create flows for buildings/resources.

Bug fixes

• More consistent Google Admin API error reporting across /gcal and /resource-manager.
• Improved floor parsing for building creation (numeric counts or comma-separated).

v6.3.1 (2026/03)

Features

• Default outputs for /docs, /exam, /film, /competitors now save into MARIA Desktop.
• /dev-adviser now auto-repairs malformed evaluation JSON and fills missing sub-scores.
• /gcal now shows available room/resource names when suggesting meeting slots.
• /resource-manager added and expanded to full create/edit support with improved desktop UX.

Bug fixes

• /dev-adviser now clamps invalid scores and avoids crashes from missing fields.
• Desktop icons and context actions are more stable.

v6.3.0 (2026/03)

Features

• /dev-adviser v3 adds agentic repo scanning and developer assessment reports
• /billing-pl now accepts English natural-language queries (e.g., last month, revenue)
• Expanded self-recognition knowledge packs and reorganized indices into NDC shards

Bug fixes

• /gcal now fully supports all-day events
• /dev-adviser threshold tuning improves scoring stability
• /billing-pl output and help text improved for English-first usage
• /billing-pl no longer exits early on NL parse; it runs the analysis end-to-end

v6.2.4 (2026/03)

Features

• New /billing-pl command to view monthly and cumulative P&L, plus MRR analysis.
• Use natural-language queries in /billing-pl to ask profit, revenue, cost, or MRR.
• Daily suite updates: /daily-report, /daily-insights, /daily-news, /daily-papers.
• New /discord-setup and improved Discord integration for daily workflows.
• Updated /schedule and /weekly-report for more accurate, detailed summaries.
• Expanded knowledge packs for self-recognition safety and biometrics governance.

Bug fixes

• Fixed GitHub activity collection used by daily reports and insights.

v6.2.3 (2026/03)

Features

• Improved /competitors command to research rivals and generate an exec report (DOCX/PDF).
• /competitors supports web search + scraping with iterative rounds and gap tracking.
• Improved /task-distributor command suited for Project Managers (DOCX/PDF).
• Expanded knowledge packs for self-recognition biometrics, governance, and UX guardrails.
• Knowledge-pack indices reorganized into NDC shards for faster, more scalable lookup.

Bug fixes

• Improved structured logging for /competitors, /task-distributor, /blog, /paper, /exam, etc.
• Fixed a token-handling issue affecting MARIA-LITE runtime behavior.

v6.2.2 (2026/03)

Features

• /vup can now bump the bundled data package version separately
• Knowledge packs: NDC index reorganized into shards for faster lookup
• Knowledge packs: added self-recognition guidance and sector SOP content

Bug fixes

• /vup now reports the next data package version in JSON/text output

v6.2.1 (2026/03)

Features

• Improve resource lookup to work with the separate data package install layout.
• /vup can set and bump the data package version via --version-data.

Bug fixes

• Reduce npm install size by excluding sourcemaps and desktop sidecar artifacts by default.

v6.2.0 (2026/03)

Features

• Add /google-connect to set up, connect, status, and disconnect Google OAuth.
• Add /gcal to list, create, update, and delete Google Calendar events.
• Add /gcal scheduling tools like free/busy checks and slot finding.
• Add /gcal admin tools for buildings and room/resource management.
• /evolve can use rule-based priorities to focus on the biggest gaps.
• Add /weekly-report to generate automated weekly reports for tasks you've done.

Bug fixes

• /git and /gh now return captured output, not just an exit code.
• Improve input parsing robustness across multiple commands.

v6.1.0 (2026/02)

Features

• Enhanced /evolve to generate cleaner, safer persona labels.
• Added new self-recognition knowledge packs for governance and operations guidance.
• Reorganized knowledge-pack indexes into NDC shards for better lookup performance.

Bug fixes

• Prevent sharing sample personas; prompts you to modify first.
• Editing a sample persona now auto-forks it into your own copy to avoid overwrites.

v6.0.0 (2026/02)

Features

• Added /calculator for deterministic math, stats, derivatives, and integrals.
• Added /exam, /paper for academic research and testing.
• Added /persona and /twin commands for further persona based controls.
• Expanded /self-recognition and /evolve with new knowledge packs and updated desires.
• Reorganized knowledge indices into NDC shards for faster, cleaner lookup.
• Improved /docs export with better DOCX/PDF generation and rendering.
• Enhanced /persona integration across related flows like /universe.
• /persona and /universe marketplace.

Bug fixes

• Improved timeout handling to reduce stalled or failed long-running commands.
• Fixed /exam handling and stabilized academic command workflows (/exam, /paper).
• Improved artifact path resolution for clone workflows when given relative paths.

v5.4.0 (2026/02)

Features

• /universe now uses Universe-code (.uni) by default for genesis and inflate.
• New /universe debug to validate and auto-fix .uni programs.
• New /universe edit to view or edit the .uni source.
• Inflate runs compiled .uni first, with legacy flow fallback if no .uni.
• Expanded Universe samples discovery in both repo and installed package.
• Added new self-recognition knowledge packs and updated desires.

Bug fixes

• Improved /universe help text, outputs, and blocked-resume guidance.
• Refined knowledge-pack indexing by sharding NDC indices for faster lookup.

v5.3.0 (2026/02)

Features

• New pnpm scripts to run, build, and generate icons for the desktop app (.app format: to be released soon).
• Expanded MARIA-LITE knowledge packs on self-recognition, ethics, and clinical safety.

Bug fixes

• Improved /register-api flow by removing an unused rendered-HTML fetch dependency.
• Fixed desktop app behavior issues for more reliable startup and interactions.

v5.2.1 (2026/02)

Features

• Improved terminal and chat panel UI.
• Desktop refreshes UI design settings for menus, icons, and windows.

v5.2.0 (2026/02)

Features

• Desktop: built-in previews for XLSX, DOCX, and PPTX files.
• Desktop: taskbar chat toggle and chat panel interactions.
• Desktop: UI design settings with broader refresh of menus, icons, and windows.
• Knowledge packs: expanded self-recognition safety, boundaries, and escalation guidance.
• Knowledge packs: added cross-jurisdiction privacy, biometrics, and compliance references.
• Knowledge packs: NDC index sharding for faster browsing and lookup.

Bug fixes

• Desktop: auto-refresh desktop and file manager views when jobs complete.

v5.1.2 (2026/02)

Features

• Desktop client refactored into modules for easier maintenance.
• Improved desktop UI styling across menus, taskbar, forms, and viewers.

Bug fixes

• Fixed desktop state handling edge cases across windows and apps.

v5.1.1 (2026/02)

Features

• Internal improvements.

Bug fixes

• Stability improvements.

v5.1.0 (2026/02)

Features

• New /desktop command starts a local Desktop UI in your browser.
• /desktop supports host/port selection, JSON output, and optional auto-open.
• New /spreadsheet command generates spreadsheets with CSV/HTML/XLSX exports.
• Updated knowledge packs for self-recognition guidance and safer boundaries.

Bug fixes

• Improved /docs input handling so it can work from prompt text or sources.
• Clarified usage and flags across /docs, /slides, /proposal, /film, and /manga.
• Refined /skills --force help text for clearer expectations.

v5.0.0 (2026/02)

Features

• New /desktop command to launch a local Desktop UI in your browser.
• /desktop supports parallel command execution and drag-and-drop file attachments.
• /desktop adds flags for host/port, auto-open control, and JSON output.
• New /spreadsheet command to generate spreadsheets from files or prompts.
• /spreadsheet can export per-sheet CSV and optional PDF, with default-apply execution and optional --plan-only preview.
• Expanded knowledge packs for safer self-recognition and identity-related guidance.

Bug fixes

• Improved input validation and safer defaults for /desktop networking options.
• More reliable structured JSON parsing and retry handling for /spreadsheet outputs.

v4.3.0 (2026/02)

Features

• New /docs command to generate meeting docs and export to DOCX/PDF.
• New /film command to draft a film bible/storyboard and produce video outputs.
• New /proposal command to draft a proposal PPTX/PDF as well as a script/FAQ DOCX/PDF.
• Improved /slides generation flow and helpers for more reliable exports.
• Enhanced /music, /image, /manga, and /video command behaviors and outputs.
• Expanded built-in knowledge packs for safer self-recognition guidance.
• Faster knowledge pack lookup via reorganized, sharded NDC indices.

Bug fixes

• Reduced command conflicts by separating legacy best-practice guidance paths.
• Relaxed overly strict /music requirements to reduce failed runs.
• Stabilized multimedia command refactors to improve consistency across modes.

v4.2.0 (2026/02)

Features

• New /manga command to generate 4-panel or multi-page manga with saved artifacts.
• /manga supports --type, --pages, --mode, --color, --size, --format, --seed, --model, --out.
• New /music command (beta) with BPM, time signature, key, and default-apply workflow.
• New /slides command for creating slide-style outputs.
• Expanded knowledge packs for compliance, biometrics, and clinical safety guidance.

Bug fixes

• Fix cases where manga plans would suggest forbidden spread layouts.
• General stability improvements across /slides and /music behaviors.

v4.1.0 (2026/02)

Features

• /bulk-register can import from OpenAPI sources (API.Guru or OpenAPISearch).
• /bulk-register supports --source plus shorthand --api-guru/--openapisearch.
• /bulk-register adds --recompile to rebuild catalogs from the remote registry.
• /api-secret shows OAuth app setup hints and redirect URI guidance.
• /api-secret suggests /connect for OAuth flows instead of pasting access tokens.
• Expanded built-in knowledge packs for self-recognition governance and evaluation.

Bug fixes

• Improved OAuth2 secret hints to include authorize and token URL details.
• Bulk import better dedupes catalogs across sources and skips stale entries.

v4.0.0 (2026/02)

Features

• Add /api-secret to store, list, and audit required API secrets locally.
• Add /assert for deterministic flow checks (file exists/missing, JSON validity).
• Expand /register-api and /run-api as a beta path for calling registered APIs.
• Add /bulk-register to auto-register APIs from catalogs for faster setup.
• Improve /reorganize with NDC-sharded indexing for more scalable knowledge lookup.

Bug fixes

• Fix /blog generation stability and structured prompting behavior.
• Improve secret handling and validation across API registration flows.
• Resolve API registration edge cases that caused failed or incomplete setup.
• Tighten flow error handling in multi-step commands to reduce unexpected stops.

v3.1.2 (2026/01)

Bug fixes

• Stability improvements on /gui.

v3.1.1 (2026/01)

Features

• NDC-sharded indices for faster browse and search
• Added Japan governance and SME operations packs
• Self-recognition and evaluation guidance packs added
• NDC catalog enriched with more categories and coverage

Bug fixes

• GUI now resolves assets correctly when installed via npm
• NDC meta and catalog load reliably in packaged installs
• Universe NDC map resolves regardless of project layout
• Knowledge pack listing works outside repo structure

v3.1.0 (2026/01)

Features

• New /rollback to undo runs; list history, pick by run ID, or count
• Auto rollback checkpoints in /code, /auto-dev, and /evolve for safe apply
• Commands supporting apply now run by default; use --plan-only to preview, or set env to turn it off (see the NOTES above)
• /gui runs by default; set env to turn it off (see the NOTES above)
• Expanded Japan-focused knowledge packs: business, legal, history, SME ops
• NDC-sharded indices speed up knowledge search and /kp-sync
• Self-recognition evolve flows across /desire, /universe, and KP evolve

Bug fixes

• Stability improvements.

v3.0.0 (2026/01)

Features

• New /gui to launch local GUI; supports --host, --port, --no-open.
• /universe multiverse saves by default for GUI; add --no-save to disable.
• /evolve --code --issues now proposes a new slash-command and files it.
• Broader coverage via expanded knowledge packs and NDC index sharding.
• Help updated to include /gui.

Bug fixes

• /evolve --code --issues retries without labels if repo lacks them.
• /evolve planner JSON is validated; clearer errors on invalid plans.
• /universe multiverse JSON includes saved path and still saves with --json.

v2.4.1 (2026/01)

Features

• /vup: Smarter release notes using changed paths and affected commands
• /vup: Clearer, user-facing summaries for MARIA-LITE changes

Bug fixes

• /vup: Robust JSON parsing prevents malformed output
• /vup: Deduplicated signals reduce duplicate bullets

v2.4.0 (2026/01)

Features

• Reorganized indices into NDC shards for faster, more relevant retrieval
• Added /kp-update (delta updates) and /kp-synthesis (cross-domain synthesis) for knowledge packs
• Added family-tree tracking for synthesis runs (for strict inbreeding avoidance across runs)
• Added --issues mode for /evolve --code to file GitHub issues without generating code (automation-friendly)

Bug fixes

• Stability improvements.

v2.3.2 (2026/01)

Features

• Reorganized indices into NDC shards for faster retrieval.
• Self-recognition (universe) improved for a more stable persona.
• Self-recognition (KP) refined for more consistent tone.
• Self-recognition (desire) tuned for clearer goal alignment.

Bug fixes

• Stability improvements (especially for multilingual output support on CLI).

v2.3.1 (2026/01)

Features

• Add Windows support for skills installation, etc.
• /plugins list --with-skills --cc now available to list up skills inside each plugin.
• Add limited multilingual support on /help command
• Reorganize indices into NDC shards for faster queries
• Improve self-recognition for better accuracy

Bug fixes

• Stability improvements.

v2.3.0 (2026/01)

Features

• Added compatibility with Claude Code skills (/packages, /skills, and /gen-skills commands)
• Reorganized indices into NDC shards for faster queries
• Enhanced self-recognition (kp, universe)

Bug fixes

• Stability improvements.

v2.2.0 (2026/01)

Features

• Self-recognition evolved across KP, Universe, and Desire
• NDC-sharded indices added for faster retrieval
• Schedule now uses NDC with self-recognition
• Enabled grep-based search for quick filtering
• Desire reading now defaults to read all
• Enterprise cloud support added

Bug fixes

• Fixed evolve flow for better stability
• Reduced excessive retrievals to cut overhead
• Improved error handling to prevent crashes

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: ~/.maria/desktop/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 ~/.maria/desktop/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 ~/.maria/desktop/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.