Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 17, 2026

Revised the manifesto to formalize ObjectStack's foundational commitments as 4 unshakable principles, strengthening the declarative tone and adding the new Stability Pledge.

Changes

Title & Framing

  • Renamed from "The Manifesto" → "The ObjectStack Manifesto"
  • Reframed introduction to emphasize "unshakable core principles" that maintain ecosystem health

Principle I: Protocol Neutrality

  • Codified "Spec before Engine" mandate
  • Explicitly rejected "implement first, standardize later" approach
  • Prohibited language/database/runtime-specific logic in ObjectQL

Principle II: Mechanism over Policy

  • Formalized ObjectQL (mechanism) vs ObjectOS (implementation) separation
  • Added prohibition against polluting Protocol layer with implementation logic
  • Provided concrete examples of forbidden vs. compliant patterns:
// ❌ FORBIDDEN: Implementation leaking into protocol
{
  "object": "users",
  "authentication": { "provider": "jwt", "secret": "..." }
}

// ✅ CORRECT: Protocol defines mechanism only
{
  "object": "users",
  "permissions": { "allowRead": "{{ currentUser.id === record.id }}" }
}

Principle III: Data Sovereignty

  • Mandated Local-First architecture (core features requiring cloud are forbidden)
  • Required data portability via standard formats (.oos / .json)
  • Specified what is prohibited vs. required for offline availability

Principle IV: Stability Pledge (NEW)

  • Committed to 2-major-version migration windows for breaking changes
  • Defined version policy (patch/minor/major) and deprecation timeline
  • Established compatibility testing requirements

Supporting Content

  • Practice checklist covering all 4 principles
  • Design decision examples (compliant vs. non-compliant)
  • Enforcement mechanisms

Screenshots

English:
manifesto-en

Chinese:
manifesto-cn


Both English and Chinese versions updated in parallel with matching content structure.

Original prompt

This section details on the original issue you should resolve

<issue_title>编写和优化The ObjectStack Manifesto (ObjectStack 宣言)</issue_title>
<issue_description>ObjectStack 的存在是为了让数据应用开发回归本质。为了保持生态的健康与开放,我们承诺遵循以下不可动摇的核心原则:
第一条:协议中立原则 (Protocol Neutrality)
• ObjectQL 是中立的:它不应该包含任何特定于语言(如 Node.js)、特定于数据库(如 MySQL)或特定于运行时(如 Electron)的逻辑。
• 标准优先:任何功能必须先在 Spec (规范) 层定义,然后才在 Engine (引擎) 层实现。我们拒绝“先实现后标准化”的黑盒操作。
第二条:机制与实现分离 (Mechanism over Policy)
• ObjectQL 只提供机制:它定义 allowRead 接口,但绝不强制规定用户数据必须存在哪里。
• ObjectOS 提供实现:用户系统、文件存储、多租户逻辑属于 OS 层,严禁下沉污染 Protocol 层。
第三条:数据主权原则 (Data Sovereignty)
• Local-First:所有架构设计必须优先考虑“离线可用性”。任何依赖云端连接才能运行的核心功能,都是被禁止的。
• 可移植性:用户的数据(Schema + Data)必须能以标准文件格式(.oos / .json)导出,不锁定在任何特定厂商的云平台上。
第四条:向下兼容承诺 (Stability Pledge)
• 作为底层基础设施,我们承诺 ObjectQL 核心语法的稳定性。对于破坏性变更(Breaking Changes),我们将提供至少 2 个大版本的迁移窗口。</issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@vercel
Copy link

vercel bot commented Jan 17, 2026

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

Project Deployment Review Updated (UTC)
docs Ready Ready Preview, Comment Jan 17, 2026 4:17am

Request Review

Copilot AI changed the title [WIP] Optimize and document the ObjectStack Manifesto Update ObjectStack Manifesto with 4 unshakable core principles Jan 17, 2026
Copilot AI requested a review from hotlong January 17, 2026 01:25
@github-actions
Copy link

🚀 Preview Deployment

This pull request will be automatically deployed to Vercel.

Preview Links

  • 📝 Documentation: Will be available once Vercel deployment completes
  • 🌍 Languages: English (/en/docs) and Chinese (/cn/docs)

Build Status

Check the CI workflow for build status and any errors.


Automated preview information for PR #30

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Jan 17, 2026
@github-actions
Copy link

🚀 Preview Deployment

This pull request will be automatically deployed to Vercel.

Preview Links

  • 📝 Documentation: Will be available once Vercel deployment completes
  • 🌍 Languages: English (/en/docs) and Chinese (/cn/docs)

Build Status

Check the CI workflow for build status and any errors.


Automated preview information for PR #30

@huangyiirene huangyiirene marked this pull request as ready for review January 17, 2026 04:38
@huangyiirene huangyiirene merged commit 168c6e0 into main Jan 17, 2026
5 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

编写和优化The ObjectStack Manifesto (ObjectStack 宣言)

3 participants