chore(release): prepare the v1.1 configuration contract

[Waishnav]

With the structured configuration contract in place, the public docs and release metadata need to describe the same domain. This layer makes JSONC, coding harnesses, and presentation profiles the v1.1 documentation surface, reduces .env.example to bootstrap and override concerns, removes stale tool-mode wording, and centralizes the package version used by MCP and provider clients.

Stacked on #235 and prepares package metadata for 1.1.0.

_{Stack created with GitHub Stacks CLI • Give Feedback 💬}

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: f30019c6-a5f3-47c4-956e-b7ea06d9db81

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

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.}

[greptile-apps]

Greptile Summary

The PR documents the versioned JSONC configuration contract for DevSpace 1.1 and synchronizes runtime protocol metadata with the package version.

• Reworks configuration, setup, workflow, and troubleshooting documentation around config.jsonc, harness selection, presentation profiles, and compatibility overrides.
• Updates package metadata from 1.0.7 to 1.1.0.
• Introduces a shared DEVSPACE_VERSION constant for MCP server and local-agent initialization metadata.

Confidence Score: 5/5

The PR appears safe to merge with no actionable correctness or security issues identified.

The documented JSONC contract aligns with the implemented configuration behavior, and the shared version lookup resolves correctly in the supported source, build, and npm package layouts.

Important Files Changed

Filename	Overview
docs/configuration.md	Replaces the legacy environment-oriented reference with the versioned JSONC configuration, precedence, compatibility, and feature contracts.
src/version.ts	Centralizes package-version loading in a module whose relative lookup matches the source and compiled package layouts.
src/server.ts	Reports the package release version as MCP server metadata instead of the stale hardcoded value.
src/local-agent-codex.ts	Reports the shared package version in Codex initialization metadata.
src/local-agent-acp.ts	Reuses the shared version constant while preserving the existing package-derived ACP metadata behavior.
package.json	Advances the package release metadata to version 1.1.0.

_{Reviews (1): Last reviewed commit: "chore(release): prepare v1.1.0 metadata" | Re-trigger Greptile}

[Waishnav]

Closing this stacked PR because the v1.1 configuration/runtime refactor is being collapsed into one review PR. The commits are preserved in the combined branch.

[Waishnav]

Superseded by the combined v1.1 refactor PR #238.