refactor: reorganize SDK structure into sdks/ directory (docs/implement-github-flow-strategy)

[jumsay]

🔄 Overview

This PR implements Option B of the SDK reorganization on the docs/implement-github-flow-strategy branch: moving both typescript-sdk/ and implementations/python/ into a new unified sdks/ directory.

📦 Changes

Structure Changes

Before:                          After:
typescript-sdk/          →       sdks/typescript/
implementations/python/  →       sdks/python/

Files Modified

• ✅ 191 files moved (Python SDK)
• ✅ 25 files moved (TypeScript SDK)
• ✅ Documentation updated (11 files)
• ✅ Docker configs updated (3 files)
• ✅ New sdks/README.md with migration guide

🎯 Benefits

1. Better organization: All SDK implementations grouped together
2. Consistency: Both SDKs at the same hierarchy level
3. Scalability: Easy to add new language SDKs (Go, Rust, etc.)
4. Clarity: Clear separation between SDKs and other project components

⚠️ Breaking Change

IMPORTANT: This is a BREAKING CHANGE for users with local clones or CI/CD references.

Migration Path

For developers:

git pull origin docs/implement-github-flow-strategy
# Update any local scripts referencing old paths

For CI/CD pipelines:

• Update working-directory from implementations/python → sdks/python
• Update volume mounts in Docker: ./implementations/python → ./sdks/python

For documentation:

• All references to implementations/python/ → sdks/python/
• All references to typescript-sdk/ → sdks/typescript/

✅ Verification

• All files moved successfully
• Documentation updated with new paths
• Docker configs updated
• Migration guide added in sdks/README.md
• Update script included: update-paths.ps1
• No functionality changes (pure refactor)

📚 Related

This change was implemented on 3 branches with typescript-sdk:

• develop (PR refactor: reorganize SDK structure into sdks/ directory (develop) #8)
• docs/implement-github-flow-strategy (this PR)
• sync/update-readme-with-github-flow (PR refactor: reorganize SDK structure into sdks/ directory (sync/update-readme) #10)

---

Review checklist:

• Structure makes sense
• All path references updated
• Documentation is clear
• No broken imports/references

[Copilot]

Pull request overview

This PR implements a structural reorganization of the SDK directories, moving both typescript-sdk/ and implementations/python/ into a unified sdks/ directory structure. This is a pure refactoring change with no functional modifications, focused on improving project organization and scalability.

Changes:

• Reorganized directory structure: typescript-sdk/ → sdks/typescript/, implementations/python/ → sdks/python/
• Updated 25 documentation references to reflect new paths
• Updated package.json repository directory reference
• Added migration automation script (update-paths.ps1)

Reviewed changes

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

Show a summary per file

File	Description
update-paths.ps1	PowerShell script to automate path reference updates across documentation and config files
sdks/typescript/turbo.json	Turbo monorepo configuration for the TypeScript SDK build system
sdks/typescript/packages/core/tsconfig.json	TypeScript compiler configuration for the core package
sdks/typescript/packages/core/src/runtime.ts	ARAL Runtime (L1) implementation with lifecycle management and health monitoring
sdks/typescript/packages/core/src/runtime.test.ts	Comprehensive test suite for Runtime functionality
sdks/typescript/packages/core/src/memory.ts	ARAL Memory (L2) implementation with TTL support and GDPR compliance
sdks/typescript/packages/core/src/memory.test.ts	Test suite for Memory layer including GDPR compliance tests
sdks/typescript/packages/core/src/index.ts	Main export file for the core package
sdks/typescript/packages/core/package.json	Package metadata with updated repository directory path
sdks/typescript/package.json	Root package.json for TypeScript monorepo workspace
sdks/typescript/package-lock.json	NPM lock file for dependency resolution
sdks/python/tests/test_secure_reasoning.py	New test suite for Secure Reasoning Engine (L4)
sdks/python/tests/test_runtime.py	New test suite for Python Runtime implementation
sdks/python/examples/README.md	Updated example documentation with corrected path references
sdks/python/docs/quickstart.rst	Updated quickstart guide with new installation paths
sdks/python/docs/migration.rst	Updated migration guide with corrected GitHub links
sdks/python/docs/examples.rst	Updated examples documentation with new paths
sdks/python/docs/api/reasoning.rst	New API documentation file for reasoning layer

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.