Skip to content

Document new manifest package types for microkernel architecture#330

Merged
hotlong merged 2 commits intomainfrom
copilot/update-related-documentation-again
Jan 27, 2026
Merged

Document new manifest package types for microkernel architecture#330
hotlong merged 2 commits intomainfrom
copilot/update-related-documentation-again

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Jan 27, 2026

PR #328 extended the manifest schema with three package types (objectql, gateway, adapter) to support microkernel architecture. Documentation was incomplete.

Changes

Reference Documentation

  • Manifest schema references: Updated type enum to 'app' | 'plugin' | 'driver' | 'module' | 'objectql' | 'gateway' | 'adapter'
  • PROTOCOL_REFERENCE.md: Added package type definitions and microkernel features

Architecture Documentation

  • ARCHITECTURE.md: New section "Package Types & Microkernel Architecture"
    • Package hierarchy: adapter → gateway → kernel → objectql → driver → database
    • Lifecycle ordering: adapter prep → objectql init → driver connect → gateway register → app/plugin load
    • Cardinality constraints: adapters are singleton, gateways multiplex

Developer Guides

  • writing-plugins.mdx: Added package type selection guidance with use cases

Package Type Definitions

Type Role Cardinality Examples
adapter HTTP server container Singleton Express, Hono, Fastify
gateway API protocol translator Multiple GraphQL, REST, RPC
objectql Core data engine Singleton Query AST, business logic
driver Database/service adapter Multiple Postgres, MongoDB, S3

Key distinction: adapter = runtime host (Express vs Hono), gateway = protocol (GraphQL vs REST). Multiple gateways can coexist on one adapter.

Original prompt

拉取请求: #328

更新相关文档


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

@vercel
Copy link
Copy Markdown

vercel bot commented Jan 27, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
spec Ready Ready Preview, Comment Jan 27, 2026 3:46pm

Request Review

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>
Copilot AI changed the title [WIP] Update related documentation Document new manifest package types for microkernel architecture Jan 27, 2026
Copilot AI requested a review from hotlong January 27, 2026 15:50
@hotlong hotlong marked this pull request as ready for review January 27, 2026 15:51
Copilot AI review requested due to automatic review settings January 27, 2026 15:51
@hotlong hotlong merged commit 645d404 into main Jan 27, 2026
5 checks passed
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR completes the documentation for PR #328, which extended the manifest schema with three new package types (objectql, gateway, adapter) to support ObjectStack's microkernel architecture. The documentation clearly explains the role, cardinality, and lifecycle ordering of all seven package types.

Changes:

  • Updated manifest schema reference documentation to include all 7 package types
  • Added comprehensive microkernel architecture documentation with package hierarchy, lifecycle ordering, and adapter/gateway distinction
  • Provided developer guidance for selecting appropriate package types

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file
File Description
content/docs/references/kernel/manifest/Manifest.mdx Updated type enum to include objectql, gateway, and adapter
content/docs/developers/writing-plugins.mdx Added package type selection guidance with use cases for all 7 types
README.md Updated manifest description to mention 7 package types
PROTOCOL_REFERENCE.md Added microkernel features section with detailed package type definitions
ARCHITECTURE.md Added comprehensive "Package Types & Microkernel Architecture" section with hierarchy diagram, lifecycle ordering, and adapter/gateway distinction

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants