@loopstack/cli 0.1.0

package/fixtures/app/env.example

@@ -0,0 +1,16 @@
+# All values are optional — the defaults below match docker-compose.yml.
+
+# PORT=3000
+
+# DATABASE_HOST=localhost
+# DATABASE_PORT=5432
+# DATABASE_USERNAME=postgres
+# DATABASE_PASSWORD=admin
+# DATABASE_NAME=postgres
+
+# REDIS_HOST=localhost
+# REDIS_PORT=6379
+# REDIS_PASSWORD=
+
+# API keys for LLM feature modules (e.g. @loopstack/claude-module)
+# ANTHROPIC_API_KEY=

package/fixtures/app/nest-cli.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true,
+    "assets": ["**/*.yaml"],
+    "watchAssets": true
+  }
+}

package/fixtures/app/src/app.module.ts

@@ -0,0 +1,8 @@
+import { Module } from '@nestjs/common';
+import { LoopstackModule } from '@loopstack/loopstack-module';
+import { HelloModule } from './hello/hello.module';
+
+@Module({
+  imports: [LoopstackModule.forRoot(), HelloModule],
+})
+export class AppModule {}

package/fixtures/app/src/hello/hello.module.ts

@@ -0,0 +1,12 @@
+import { Module } from '@nestjs/common';
+import { StudioApp } from '@loopstack/common';
+import { HelloWorkflow } from './hello.workflow';
+
+@StudioApp({
+  title: 'My First App',
+  workflows: [HelloWorkflow],
+})
+@Module({
+  providers: [HelloWorkflow],
+})
+export class HelloModule {}

package/fixtures/app/src/hello/hello.workflow.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { BaseWorkflow, MessageDocument, Transition, Workflow } from '@loopstack/common';
+import type { RunContext } from '@loopstack/common';
+
+const InputSchema = z.object({
+  name: z.string().default('World'),
+});
+
+type InputArgs = z.infer<typeof InputSchema>;
+
+@Workflow({
+  title: 'Hello World',
+  description: 'Greets you by name — replace this with your first real workflow.',
+  schema: InputSchema,
+})
+export class HelloWorkflow extends BaseWorkflow<InputArgs> {
+  @Transition({ from: 'start', to: 'end' })
+  async greet(_state: unknown, ctx: RunContext<InputArgs>) {
+    const greeting = `Hello, ${ctx.args.name}! 👋`;
+
+    await this.documentStore.save(MessageDocument, {
+      role: 'assistant',
+      text: greeting,
+    });
+
+    this.assignResult({ greeting });
+  }
+}

package/fixtures/app/src/main.ts

@@ -0,0 +1,8 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  await app.listen(process.env.PORT ?? 3000);
+}
+void bootstrap();

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@loopstack/cli",
+  "displayName": "Loopstack CLI",
+  "description": "Run, trace, and watch Loopstack workflows from the terminal",
+  "version": "0.1.0",
+  "license": "MIT",
+  "author": {
+    "name": "Jakob Klippel",
+    "url": "https://www.linkedin.com/in/jakob-klippel/"
+  },
+  "type": "module",
+  "bin": {
+    "loopstack": "dist/main.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "compile": "tsc --noEmit",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "watch": "tsc -p tsconfig.build.json --watch"
+  },
+  "dependencies": {
+    "@loopstack/client": "^0.37.0",
+    "@loopstack/contracts": "^0.37.0",
+    "commander": "^15.0.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.6"
+  },
+  "files": [
+    "dist",
+    "fixtures"
+  ]
+}