docs(python): TODO for IntelliSense and skill-review follow-ups

[Rushant-123]

What & why

Adds python/TODO.md on the Python rewrite so the docs/IntelliSense gap and the .cursor skill review are tracked in-tree instead of only in chat.

Reviewed python/ with:

• sdk-reliability
• functional-dsl
• languages-as-libraries
• meta-minimal-languages

(companions: caspian-core-discipline, caspian-sdk-surface)

The first section is the documentation/IntelliSense work: py.typed, typed handlers, named channels.add kwargs, field descriptions, package README. The rest is pass/fail against those skills — what already holds (pure step(), error ADT, ChaosTransport, adapter registry) and what does not (untyped public surface, Result not generic, no CI for python/, command algebra growth, no failover interpreter).

No runtime code changes.

Checklist

• uv run pytest green (docs-only)
• uv run ruff check . clean (docs-only)
• TypeScript changes: cd sdks/typescript && npm ci && npm test && npm run typecheck
• New adapter? → official platform API only, webhook signature verification, an offline fake, and tests (normalize + verify-accept + verify-reject)
• No real credentials anywhere — obviously-fake placeholders only

  

[coderabbitai]

Important

Review skipped

Draft detected.

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: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: adc3e839-79d3-4a47-998e-07eae6d699b5

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