docs: add path-based LiveObjects API proposal

[ttypic]

New API for LO

Summary by CodeRabbit

Documentation

• Added comprehensive documentation for a planned path-based LiveObjects API for Java/Kotlin and Python. Includes API architecture overview, typed model system, usage examples for common operations, detailed migration guidance from the current approach, design decisions, and implementation roadmap.

[coderabbitai]

Walkthrough

A new comprehensive documentation file is added that specifies a planned path-based API architecture for LiveObjects in Java/Kotlin and Python. The specification details typed path objects, deferred resolution, subscriptions, and includes usage examples, design decisions, and migration guidance from the existing API.

Changes

Cohort / File(s)	Summary
Path-Based API Specification liveobjects/PATH_BASED_API_JAVA_PYTHON.md	New 987-line documentation defining complete path-based LiveObjects API architecture, including typed PathObject models, core behaviors, Java/Python examples, design decisions, migration steps, performance considerations, and open questions.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰 A blueprint hops into view so bright,
Paths and objects dancing in the light,
Java, Python, living side-by-side,
With deferred resolution as our guide,
The API of the future—oh what a sight! 🌟

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'docs: add path-based LiveObjects API proposal' clearly and directly describes the main change: adding documentation for a new path-based LiveObjects API proposal.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch draft-new-lo-api

Tip

Issue Planner is now in beta. Read the docs and try it out! Share your feedback on Discord.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@liveobjects/PATH_BASED_API_JAVA_PYTHON.md`:
- Around line 88-99: The fenced code block that begins with "Value (all types
that can be stored)" is missing a language tag (MD040); update the opening
triple-backtick to include a language identifier such as "text" or "console"
(e.g., ```text) so the block is language-tagged and markdownlint passes, leaving
the block content unchanged.