conceptadev / conceptadev/rockets-starter

Formalize the Stargate + Rockets integration

Open
#4 0 comments 0 reactions 1 assignee Claimed by @tnramalho View on GitHub
Dominant language
TypeScript
Stars
0
Forks
0
PR merge metrics
No merged PRs in 30d

Description

## Why
Stargate (the workflow/flow execution engine, `@stargate/*` packages, sibling repo) is currently wired into Rockets ad-hoc:
- `apps/api/src/stargate-runtime.module.ts` resolves the `.stargate` workspace root and env by walking up the filesystem from `process.cwd()`, and wraps `StargateServerModule` from `@stargate/server/nest`.
- `apps/api/src/modules/stargate/stargate.module.ts` is a thin adapter exposing `StargateCatalogService` / `StargateExecutionService` behind a `STARGATE_RUNTIME` port.
- `apps/api/src/modules/workflows/workflows.resource.ts` imports `StargateModule.register({ workflows: [] })` directly inside a Rockets `defineModuleResource`.
- Config depends on `STARGATE_ENV_ROOT` / `STARGATE_WORKSPACE_ROOT` env vars and local `file:` deps on a sibling `stargate` checkout (see root `package.json` resolutions), which is fragile for anyone cloning `rockets-starter` standalone.

## Scope (to refine)
- Decide the supported integration shape: is Stargate meant to be a required sibling repo for every Rockets project, or should `rockets-starter` vendor/publish the pieces it needs?
- Document/harden the workspace-root resolution and env-loading logic (`resolveWorkspaceRoot`, `resolveStargateEnv`) so it doesn't silently fall back to `process.cwd()`.
- Define the long-term boundary between "Rockets SDK generic module patterns" and "Stargate-specific execution" so future modules don't have to hand-roll the same adapter every time.

## Out of scope
Any changes to the Stargate engine itself (lives in the sibling repo).

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.