How tailor-platform/sdk works
This monorepo provides the Tailor Platform SDK and adjacent developer tools: a platform CLI, project scaffolding, lint and migration tools, plugins, and protocol definitions. The main user workflow is invoking the CLI, which dispatches commands; deployment commands coordinate resource changes through the platform client. The challenge runner and verification modules form a separate workflow. Several subsystems are represented from the README and file tree rather than sampled implementation, so their internal links are omitted where evidence is unavailable.
Main entry points: main.ts CLI entry · verification.ts Verification · application.ts Deployment · pipeline_pb.js Pipeline schemas
Components 23
Platform SDK
- CLI entry
packages/sdk/src/cli/main.ts - Deployment
packages/sdk/src/cli/commands/deploy/application.ts - Platform client
packages/sdk/src/cli/shared/client.ts - CLI output
packages/sdk/src/cli/shared/logger.ts - Bundle cache
packages/sdk/src/cli/cache/manager.ts - SDK services
packages/sdk/src/cli/services
Developer Tools
- Project scaffolder
packages/create-sdk/src/init.ts - SDK lint rules
packages/eslint-plugin-sdk/src/index.ts - AST analysis
packages/eslint-plugin-sdk/src/lib/ast.ts - Migration tools
packages/sdk-codemod/src/runner.ts
SDK Plugins
- Data seeding
packages/sdk-plugin-seed/src/apply.ts - Setup automation
packages/sdk-plugin-setup/src/generate.ts - Managed templates
packages/sdk-plugin-setup/src/managed.ts - Frontend plugin
packages/sdk-plugin-frontend/src/index.ts - TailorDB ERD
packages/sdk-plugin-tailordb-erd/src/serve.ts
Protocol Definitions
- Service schemas
packages/tailor-proto/src/tailor/v1/service_pb.js - Pipeline schemas
packages/tailor-proto/src/tailor/v1/pipeline_pb.js - Pipeline resources
packages/tailor-proto/src/tailor/v1/pipeline_resource_pb.js
Challenge Runner
- Challenge runner
llm-challenge/src/runner.ts - Verification
llm-challenge/src/verification.ts - Verification specs
llm-challenge/src/verification-spec.ts - Workspace files
llm-challenge/src/workspace-files.ts
Other components
- SDK user
Connections 14
- SDK user → CLI entry: runs commands
README.md - CLI entry → Deployment: dispatches commands
packages/sdk/src/cli/main.ts - Deployment → Platform client: calls platform
packages/sdk/src/cli/commands/deploy/application.ts - SDK services → Platform client: uses client
- SDK lint rules → AST analysis: uses analysis
- Frontend plugin → CLI entry: depends on SDK
packages/sdk-plugin-frontend/src/index.ts - Data seeding → CLI entry: uses CLI services
packages/sdk-plugin-seed/src/apply.ts - Setup automation → Managed templates: uses templates
packages/sdk-plugin-setup/src/generate.ts - Service schemas → Pipeline schemas: imports schemas
packages/tailor-proto/src/tailor/v1/service_pb.js - Pipeline schemas → Pipeline resources: imports resources
packages/tailor-proto/src/tailor/v1/pipeline_pb.js - Challenge runner → Verification: runs checks
llm-challenge/src/verification.ts - Verification → Verification specs: loads specification
llm-challenge/src/verification.ts - Verification → Workspace files: uses files
llm-challenge/src/verification.ts - Verification specs → Workspace files: uses files
llm-challenge/src/verification-spec.ts