Wiki

[nmaguiar]

This pull request introduces a major new feature: a persistent, shared Markdown wiki knowledge base for Mini-A, following the LLM Wiki pattern. Agents can now read from and write to a structured wiki (stored on the filesystem or S3), distilling knowledge into pages that persist across sessions and can be shared between agents. The update also adds extensive documentation, new console commands, parameter support, and auto-completion for wiki operations.

Key changes include:

1. Wiki Knowledge Base Feature

• Adds a comprehensive wiki system via the new MiniAWikiManager class, supporting both filesystem and S3 backends, with operations for listing, reading, searching, linting, and writing Markdown pages. The wiki is bootstrapped with starter pages and includes lint checks for content quality. ([docs/WHATS-NEW.mdR5-R57](https://github.com/OpenAF/mini-a/pull/147/files#diff-94bd24d22aff1843eebb34c25aa01a1b0454a62e6ef2d383f94adbe89a706cc5R5-R57))
• New agent action wiki allows agents to interact with the wiki for various operations (list, read, search, lint, write). ([docs/WHATS-NEW.mdR5-R57](https://github.com/OpenAF/mini-a/pull/147/files#diff-94bd24d22aff1843eebb34c25aa01a1b0454a62e6ef2d383f94adbe89a706cc5R5-R57))
• Wiki parameters are now fully supported in agent files and CLI, including options for backend selection, access control, S3 credentials, and more. ([[1]](https://github.com/OpenAF/mini-a/pull/147/files#diff-d9d80d03ec444109c5e8c8a1612038fae26c8392f74c8c4ccabbb8118a9a9436R558-R570), [[2]](https://github.com/OpenAF/mini-a/pull/147/files#diff-1bffb76c81b4bf9bbbbe2af9dbc7b4b96af2c388d15dc78907134b7590caf578L26-R26))

2. Console and CLI Enhancements

• Adds /wiki console commands (list, read, search, lint) with tab-completion for subcommands and page names. ([[1]](https://github.com/OpenAF/mini-a/pull/147/files#diff-d9d80d03ec444109c5e8c8a1612038fae26c8392f74c8c4ccabbb8118a9a9436R1212-R1259), [[2]](https://github.com/OpenAF/mini-a/pull/147/files#diff-d9d80d03ec444109c5e8c8a1612038fae26c8392f74c8c4ccabbb8118a9a9436L1768-R1833), [[3]](https://github.com/OpenAF/mini-a/pull/147/files#diff-d9d80d03ec444109c5e8c8a1612038fae26c8392f74c8c4ccabbb8118a9a9436R1966-R1999))
• New /stats wiki command shows per-operation statistics and errors for wiki usage in the current session. ([CHEATSHEET.mdR1375](https://github.com/OpenAF/mini-a/pull/147/files#diff-0532235a9b8a48e10079c1bfdb2fa41684c5f98a4643eee6728d742668b5b94aR1375))
• Wiki parameters are included in the session options and are seeded from CLI arguments for consistency. ([mini-a-con.jsR3064-R3070](https://github.com/OpenAF/mini-a/pull/147/files#diff-d9d80d03ec444109c5e8c8a1612038fae26c8392f74c8c4ccabbb8118a9a9436R3064-R3070))

3. Documentation and Cheat Sheet Updates

• Expanded CHEATSHEET.md with detailed sections on the wiki knowledge base, parameter descriptions, example usage, and a decision guide comparing usewiki and usememory. ([[1]](https://github.com/OpenAF/mini-a/pull/147/files#diff-0532235a9b8a48e10079c1bfdb2fa41684c5f98a4643eee6728d742668b5b94aR19-R20), [[2]](https://github.com/OpenAF/mini-a/pull/147/files#diff-0532235a9b8a48e10079c1bfdb2fa41684c5f98a4643eee6728d742668b5b94aR750-R870))
• Updated quick reference and parameter tables to include all new wiki-related options. ([AGENT-CHEATSHEET.mdL26-R26](https://github.com/OpenAF/mini-a/pull/147/files#diff-1bffb76c81b4bf9bbbbe2af9dbc7b4b96af2c388d15dc78907134b7590caf578L26-R26))
• Added a "What's New" entry summarizing the wiki feature, usage scenarios, and protected pages. ([docs/WHATS-NEW.mdR5-R57](https://github.com/OpenAF/mini-a/pull/147/files#diff-94bd24d22aff1843eebb34c25aa01a1b0454a62e6ef2d383f94adbe89a706cc5R5-R57))

4. UI/UX and Activity Feedback

• Improved activity cue rendering for agent actions, including wiki operations, and added elapsed time and "Esc to cancel" hints in the interactive console. ([[1]](https://github.com/OpenAF/mini-a/pull/147/files#diff-d9d80d03ec444109c5e8c8a1612038fae26c8392f74c8c4ccabbb8118a9a9436L3862-R3971), [[2]](https://github.com/OpenAF/mini-a/pull/147/files#diff-d9d80d03ec444109c5e8c8a1612038fae26c8392f74c8c4ccabbb8118a9a9436L3878-R3989))

5. Miscellaneous

• Ensured that session options are consistently initialized so that console-only commands (like /wiki) always use the correct configuration. ([mini-a-con.jsR3064-R3070](https://github.com/OpenAF/mini-a/pull/147/files#diff-d9d80d03ec444109c5e8c8a1612038fae26c8392f74c8c4ccabbb8118a9a9436R3064-R3070))

These changes significantly enhance Mini-A's capabilities for persistent, collaborative knowledge management and improve both agent and user workflows.

[Copilot]

Pull request overview

This PR adds a persistent, shared Markdown “wiki” knowledge base to Mini-A (filesystem or S3 backed), expands interactive console and MCP tooling to support wiki and new runtime flags, and introduces a standalone TUI for managing persisted working-memory stores.

Changes:

• Introduces wiki knowledge base support (agent action + console /wiki + MCP server) with linting/search/read/write semantics and extensive documentation.
• Adds a working-memory manager TUI (memoryman=true) plus new memory defaults (memoryusersession) and related CLI/env-default plumbing.
• Extends CLI/runtime parameters and help/docs (e.g., usetoolslc, goal compression flags) and adds/updates automated tests.

Reviewed changes

Copilot reviewed 22 out of 23 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
tests/wiki.yaml	Adds wiki test job pipeline wiring.
tests/wiki.js	Adds a comprehensive wiki test suite (frontmatter, links, backends, linting, read/write/search/delete).
tests/coreFunctionality.js	Adds tests for tool-calling fallback behaviors, memory defaults, env defaults, and capability flags.
tests/autoTestAll.allJobs.yaml	Includes wiki tests in the full test run.
mini-a.yaml	Adds new CLI parameters/help + seeds runtime args; includes usetoolslc and goal-compression options.
mini-a-web.yaml	Expands web-mode parameter help and validation, adds alias handling, and gates unknown-arg warnings.
mini-a-utils.js	Adds a wiki utility tool method + tool metadata; hardens _askChooseMultiple return type.
mini-a-modes.yaml	Updates a preset to use memoryusersession instead of memoryuser.
mini-a-modelman.js	Hardens interactive selection handling via normalized choice indices.
mini-a-memoryman.js	Adds a standalone interactive TUI for inspecting and maintaining global/session working memory stores.
mini-a-memory.js	Adds channel namespace parsing/listing/deletion helpers for persisted memory stores.
mini-a-mcptest.js	Hardens MCP tester interactive selection handling via normalized choice indices.
mini-a-con.js	Adds /wiki command + completions, wiki stats mode, memoryman launch mode, env-default handling, and session option seeding from CLI args.
mini-a-common.js	Adds shared helpers for normalizing choice indices and applying memory “user default” configs.
mcps/mcp-wiki.yaml	Adds an MCP wiki server wrapper exposing wiki operations over stdio or HTTP.
mcps/mcp-mini-a.yaml	Adds goal-compression parameters and ensures numeric coercions include the new thresholds.
docs/WHATS-NEW.md	Documents the wiki feature and adds memoryusersession to the parameter table.
USAGE.md	Documents the new memory manager mode and additional CLI flags.
README.md	Adds memory manager usage and updates parameter tables.
CHEATSHEET.md	Adds wiki and “choosing knowledge features” sections plus expanded parameter references.
AGENT-CHEATSHEET.md	Updates agent-file capability docs to include usetoolslc and wiki/memory-related args.

Comments suppressed due to low confidence (4)

mini-a-mcptest.js:802

• Same cancel-index issue in the "Show tool details" path: Cancel yields -1, and if (toolIdx < tools.length) will still pass, so showToolDetails(...) can receive undefined. Guard with toolIdx >= 0 before dereferencing toolNames[toolIdx].

                        tools = tools.tools
                        var toolNames = tools.map(t => t.name).sort().concat(["🔙 Cancel"])
                        var toolIdx = normalizeChoiceIndex(askChoose("Choose a tool to inspect: ", toolNames, sessionOptions.toolchoosesize), tools.length)

                        if (toolIdx < tools.length) {
                            showToolDetails(tools.filter(t => t.name == toolNames[toolIdx])[0])
                        }

mini-a-mcptest.js:861

• The "Set option" picker has the same Cancel handling bug: normalizeChoiceIndex(..., allOptionKeys.length) returns -1 for Cancel, but if (setOptionIdx < allOptionKeys.length) will still pass and then allOptionChoices[setOptionIdx] is undefined. Add a setOptionIdx >= 0 check before using the selection.

                    }).sort().concat(["🔙 Cancel"])

                    var setOptionIdx = normalizeChoiceIndex(askChoose("Choose an option to set: ", allOptionChoices), allOptionKeys.length)

                    if (setOptionIdx < allOptionKeys.length) {
                        var selectedKey = allOptionKeys.filter((k) => allOptionChoices[setOptionIdx].startsWith(k))[0]
                        var def = optionDefinitions[selectedKey]
                        var newValue = ask("Enter new value for " + selectedKey + " (" + def.type + "): ")

mini-a-mcptest.js:779

• Tool selection has the same cancel-index bug: toolNames includes "🔙 Cancel" but normalizeChoiceIndex(..., tools.length) returns -1 when Cancel is chosen, and if (toolIdx < tools.length) will still pass. This leads to looking up toolNames[-1] and calling showToolDetails / buildToolParams with an undefined tool. Require toolIdx >= 0 before proceeding.

                    } else {
                        tools = tools.tools
                        var toolNames = tools.map(t => t.name).sort().concat(["🔙 Cancel"])
                        var toolIdx = normalizeChoiceIndex(askChoose("Choose a tool to call: ", toolNames, sessionOptions.toolchoosesize), tools.length)

                        if (toolIdx < tools.length) {
                            var tool = tools.filter(t => t.name == toolNames[toolIdx])[0]
                            showToolDetails(tool)

                            var params = buildToolParams(tool)
                            if (isDef(params)) {
                                callMCPTool(_mcpClient, tool, params, sessionOptions)

mini-a-mcptest.js:838

• The "Toggle option" picker also treats Cancel as -1, but the code only checks optionIdx < optionKeys.length, so it will attempt to run .startsWith on optionChoices[-1] when Cancel is selected. Guard with optionIdx >= 0 (and similarly for the "Set option" picker below).

                    }).sort().concat(["🔙 Cancel"])

                    var optionIdx = normalizeChoiceIndex(askChoose("Choose an option to toggle: ", optionChoices), optionKeys.length)

                    if (optionIdx < optionKeys.length) {
                        toggleOption(optionKeys.filter((k) => optionChoices[optionIdx].startsWith(k))[0])
                        print()

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.