neo.mjs Files

This release significantly enhances the Agent OS Knowledge Base by expanding its scope to include the entire AI infrastructure, the automated test suite, and a retroactive history of the project. These changes ensure that AI agents have a complete, 360-degree view of the framework—from source code and tests to historical decision-making.

✨ Highlights

📚 Expanded Knowledge Base: Tests & AI Infrastructure

We have bridged the gap between the framework's source code and its supporting ecosystem. The Knowledge Base now indexes: - AI Infrastructure (ai/): The Agent OS SDK, MCP servers, and services are now fully indexed. Agents can now query the Neo.ai namespace to understand their own architecture. - Automated Tests (test/playwright/): Agents can now query for test specifications via semantic search using the new type: 'test' filter. This allows finding relevant tests by meaning rather than just keywords, helping agents understand how to write and maintain Playwright tests for the framework. - Retroactive History: We have backfilled the repository with tickets and release notes starting from January 1st, 2025 (v8.0.1+). Previously limited to v10+, this expanded history gives agents a deeper context on the framework's evolution and design decisions.

📖 Docs App: AI Namespace Integration

The Docs App has been updated to include the Neo.ai namespace. - Visualizing the AI SDK: Developers can now browse the class hierarchy of the AI infrastructure (e.g., Neo.ai.mcp.server.knowledge-base.Server). - Smart Filtering: We implemented intelligent filtering (via the new doesNotStartWith operator and @ignoreDocs tag) to ensure only relevant classes are displayed, keeping the navigation tree clean.

🧹 Standardization & Code Quality

We have enforced stricter coding guidelines to improve documentation quality and consistency: - JSDoc Standardization: The @ summary tag is now mandatory as the first tag for all classes, ensuring concise high-level descriptions. - MCP Tool Signatures: All MCP server tools now use standardized method signatures with default object arguments, improving robustness and error handling.

📦 Full Changelog

AI Knowledge Base & Infrastructure

• Index ai/ directory in Knowledge Base via JSDoc (Issue [#7896])
• Index test/playwright/ in Knowledge Base as raw source (Issue [#7897])
• Enhance query_documents tool with limit parameter and updated JSDoc (Issue [#7883])
• MCP servers: inconsistencies inside className configs (Issue [#7895])

Docs App & JSDoc

• Clean up Docs App structure by filtering invalid AI modules and pruning empty folders (Issue [#7899])
• Support @ignoreDocs JSDoc tag to exclude files from Docs app structure (Issue [#7900])
• Update Coding Guidelines to mandate @ summary as first tag (Issue [#7894])
• Update Coding Guidelines for Class Top-Level JSDoc Comments and @ summary Tag (Issue [#7890])
• Update Coding Guidelines for JSDoc and Refactor GitHub Workflow MCP (Issue [#7889])
• Add Class-Level JSDoc Comments to GitHub Workflow MCP Server (Issue [#7891])
• Review and Update JSDoc Comments in Memory Core MCP Server (Issue [#7892])
• Review and Update JSDoc Comments in Knowledge Base MCP Server (Issue [#7893])

Core Framework Enhancements

• Add 'doesNotStartWith' operator to Neo.collection.Filter (Issue [#7898])
• Standardize MCP Tool Method Signatures with Default Objects (Issue [#7888])

Workflow Enhancements

• Enforce "Propose-First" workflow and Labeling in create_issue tool description (Issue [#7884])
• [AI] Streamline create_issue workflow instruction (Issue [#7886])

All changes in 1 commit: https://github.com/neomjs/neo/commit/0cbc9f9a4c62f6fee885adf670bbee07cc289c62