@msn-control/liftoff 0.10.4 → 0.11.1

package/dist/generators/genai/configuration.js

@@ -0,0 +1,43 @@
+import { DEFAULT_FUNCTION_WORKER_QUEUE_NAME } from '../common/values.js';
+import { genAiPattern } from '../common/values.js';
+export function renderBackendEnv(plan, environment) {
+    const pattern = genAiPattern(plan);
+    const transport = environment === 'dev' ? 'redis-streams' : 'azure-service-bus';
+    return `APP_ENV=${environment}
+APP_NAME=${plan.safeProjectName}
+GENAI_PATTERN=${pattern.id}
+CLOUD_PROVIDER=${plan.provider.id}
+AZURE_REGION=${plan.region.slug}
+DATABASE_URL=postgresql+asyncpg://postgres:postgres@postgres:5432/${plan.safeProjectName.replace(/-/g, '_')}
+REDIS_URL=redis://redis:6379/0
+REDIS_STREAM_NAME=liftoff-events
+MESSAGING_TRANSPORT=${transport}
+SERVICE_BUS_QUEUE_NAME=${DEFAULT_FUNCTION_WORKER_QUEUE_NAME}
+SERVICE_BUS_AUTH_MODE=managed-identity
+SERVICE_BUS_CONNECTION_STRING=
+SERVICE_BUS_FULLY_QUALIFIED_NAMESPACE=
+AZURE_CLIENT_ID=
+BLOB_ENDPOINT=
+CORS_ALLOWED_ORIGINS=http://localhost:5173
+PYDANTIC_AI_MODEL=
+OPENAI_API_KEY=
+OPENAI_BASE_URL=https://api.openai.com/v1
+LANGFUSE_HOST=${environment === 'dev' ? 'http://langfuse:3000' : ''}
+LANGFUSE_PUBLIC_KEY=
+LANGFUSE_SECRET_KEY=
+`;
+}
+export function renderFunctionsEnv(plan, environment) {
+    const pattern = genAiPattern(plan);
+    return `APP_ENV=${environment}
+APP_NAME=${plan.safeProjectName}
+GENAI_PATTERN=${pattern.id}
+FUNCTIONS_WORKER_RUNTIME=python
+SERVICEBUS_QUEUE_NAME=${DEFAULT_FUNCTION_WORKER_QUEUE_NAME}
+ServiceBusConnection__fullyQualifiedNamespace=<service-bus-namespace>.servicebus.windows.net
+ServiceBusConnection__clientId=<managed-identity-client-id>
+AzureWebJobsStorage=<storage-connection-string>
+SHARED_ORCHESTRATION_ROOT=../../backend
+`;
+}
+//# sourceMappingURL=configuration.js.map

package/dist/generators/genai/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../../src/generators/genai/configuration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,MAAM,UAAU,gBAAgB,CAAC,IAAsB,EAAE,WAAmB;IAC1E,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAChF,OAAO,WAAW,WAAW;WACpB,IAAI,CAAC,eAAe;gBACf,OAAO,CAAC,EAAE;iBACT,IAAI,CAAC,QAAQ,CAAC,EAAE;eAClB,IAAI,CAAC,MAAM,CAAC,IAAI;oEACqC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;;;sBAGrF,SAAS;yBACN,kCAAkC;;;;;;;;;;gBAU3C,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE;;;CAGlE,CAAC;AACF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAsB,EAAE,WAAmB;IAC5E,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,WAAW,WAAW;WACpB,IAAI,CAAC,eAAe;gBACf,OAAO,CAAC,EAAE;;wBAEF,kCAAkC;;;;;CAKzD,CAAC;AACF,CAAC"}

package/dist/generators/genai/database.d.ts

@@ -0,0 +1,7 @@
+import type { AddArtifact } from '../../template-types.js';
+import type { GenAiProjectPlan } from '../../domain/project/contracts.js';
+export declare function addDatabaseArtifacts(add: AddArtifact, plan: GenAiProjectPlan): void;
+export declare function renderAlembicIni(): string;
+export declare function renderAlembicEnv(): string;
+export declare function renderInitialMigration(plan: GenAiProjectPlan): string;
+export declare function renderDatabaseSchema(plan: GenAiProjectPlan): string;

package/dist/generators/genai/database.js

@@ -0,0 +1,71 @@
+import { genAiPattern } from '../common/values.js';
+export function addDatabaseArtifacts(add, plan) {
+    add('database-alembic-ini', 'database', ['database', 'alembic.ini'], renderAlembicIni());
+    add('database-alembic-env', 'database', ['database', 'migrations', 'env.py'], renderAlembicEnv());
+    add('database-initial-migration', 'database', ['database', 'migrations', 'versions', '0001_initial.py'], renderInitialMigration(plan));
+    add('database-schema', 'database', ['database', 'models', 'schema.sql'], renderDatabaseSchema(plan));
+}
+export function renderAlembicIni() {
+    return `[alembic]
+script_location = %(here)s/migrations
+sqlalchemy.url = driver://user:pass@localhost/dbname
+`;
+}
+export function renderAlembicEnv() {
+    return `from alembic import context
+from sqlalchemy import create_engine
+
+from backend.config.settings import get_settings
+
+
+def run_migrations_online():
+    database_url = get_settings().database_url
+    if not database_url:
+        raise RuntimeError("DATABASE_URL is required to run migrations")
+    database_url = database_url.replace("postgresql+asyncpg://", "postgresql+psycopg://", 1)
+    database_url = database_url.replace("postgresql://", "postgresql+psycopg://", 1)
+    connectable = create_engine(database_url)
+    with connectable.connect() as connection:
+        context.configure(connection=connection, target_metadata=None)
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+run_migrations_online()
+`;
+}
+export function renderInitialMigration(plan) {
+    const vectorExtension = genAiPattern(plan).id === 'rag' ? '    op.execute("CREATE EXTENSION IF NOT EXISTS vector")\n' : '';
+    return `from alembic import op
+import sqlalchemy as sa
+
+revision = "0001_initial"
+down_revision = None
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+${vectorExtension}    op.create_table(
+        "events",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        sa.Column("event_type", sa.String(length=120), nullable=False),
+        sa.Column("payload", sa.JSON(), nullable=False),
+        sa.Column("created_at", sa.DateTime(), server_default=sa.func.now(), nullable=False),
+    )
+
+
+def downgrade():
+    op.drop_table("events")
+`;
+}
+export function renderDatabaseSchema(plan) {
+    return `CREATE TABLE IF NOT EXISTS events (
+  id SERIAL PRIMARY KEY,
+  event_type VARCHAR(120) NOT NULL,
+  payload JSONB NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+${genAiPattern(plan).id === 'rag' ? '\nCREATE EXTENSION IF NOT EXISTS vector;\n' : ''}`;
+}
+//# sourceMappingURL=database.js.map

package/dist/generators/genai/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../src/generators/genai/database.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,MAAM,UAAU,oBAAoB,CAAC,GAAgB,EAAE,IAAsB;IAC3E,GAAG,CAAC,sBAAsB,EAAE,UAAU,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACzF,GAAG,CAAC,sBAAsB,EAAE,UAAU,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAClG,GAAG,CAAC,4BAA4B,EAAE,UAAU,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,CAAC,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;IACvI,GAAG,CAAC,iBAAiB,EAAE,UAAU,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;AACvG,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;CAGR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;CAoBR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAsB;IAC3D,MAAM,eAAe,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,2DAA2D,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3H,OAAO;;;;;;;;;;EAUP,eAAe;;;;;;;;;;;CAWhB,CAAC;AACF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAsB;IACzD,OAAO;;;;;;EAMP,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,4CAA4C,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACxF,CAAC"}

package/dist/generators/genai/functions.d.ts

@@ -0,0 +1,15 @@
+import type { GeneratorContext as ResolvedGeneratorContext } from '../context.js';
+type GeneratorContext = Pick<ResolvedGeneratorContext, 'functionsRequirements'>;
+import type { AddArtifact } from '../../template-types.js';
+import type { GenAiProjectPlan } from '../../domain/project/contracts.js';
+export declare function addFunctionArtifacts(add: AddArtifact, plan: GenAiProjectPlan, context: GeneratorContext): void;
+export declare function renderFunctionsReadme(): string;
+export declare function renderFunctionWorkerReadme(plan: GenAiProjectPlan): string;
+export declare function renderFunctionHostJson(): string;
+export declare function renderFunctionLocalSettings(plan: GenAiProjectPlan): string;
+export declare function renderFunctionRequirements(context: GeneratorContext): string;
+export declare function renderFunctionApp(plan: GenAiProjectPlan): string;
+export declare function renderFunctionTest(): string;
+export declare function renderFunctionFuncIgnore(): string;
+export declare function renderFunctionGitIgnore(): string;
+export {};

package/dist/generators/genai/functions.js

@@ -0,0 +1,156 @@
+import { DEFAULT_FUNCTION_WORKER_QUEUE_NAME } from '../common/values.js';
+import { functionWorkerName } from '../common/values.js';
+import { genAiPattern } from '../common/values.js';
+import { hasFunctionWorker } from '../common/values.js';
+import { pyModule } from '../common/values.js';
+export function addFunctionArtifacts(add, plan, context) {
+    if (!hasFunctionWorker(plan)) {
+        return;
+    }
+    const workerName = functionWorkerName(plan);
+    const workerBase = ['functions', workerName];
+    add('functions-readme', 'functions', ['functions', 'README.md'], renderFunctionsReadme());
+    add('function-worker-readme', 'functions', [...workerBase, 'README.md'], renderFunctionWorkerReadme(plan));
+    add('function-worker-host', 'functions', [...workerBase, 'host.json'], renderFunctionHostJson());
+    add('function-worker-local-settings', 'functions', [...workerBase, 'local.settings.example.json'], renderFunctionLocalSettings(plan));
+    add('function-worker-requirements', 'functions', [...workerBase, 'requirements.txt'], renderFunctionRequirements(context));
+    add('function-worker-app', 'functions', [...workerBase, 'function_app.py'], renderFunctionApp(plan));
+    add('function-worker-test', 'functions-test', [...workerBase, 'tests', 'test_function_app.py'], renderFunctionTest());
+    add('function-worker-funcignore', 'functions', [...workerBase, '.funcignore'], renderFunctionFuncIgnore());
+    add('function-worker-gitignore', 'functions', [...workerBase, '.gitignore'], renderFunctionGitIgnore());
+}
+export function renderFunctionsReadme() {
+    return `# Azure Functions Workers
+
+Azure Functions trigger adapters live under \`functions/<worker-name>\`.
+
+Keep reusable GenAI orchestration, model configuration, prompt handling, and domain logic under \`backend/orchestration\`. Use \`backend/workers\` for backend-adjacent or containerized workers; use this folder for Azure Functions runtime files such as \`host.json\`, trigger bindings, local settings, and Function app tests.
+`;
+}
+export function renderFunctionWorkerReadme(plan) {
+    const workerName = functionWorkerName(plan);
+    const pattern = genAiPattern(plan);
+    return `# ${workerName}
+
+Azure Functions worker scaffold for ${pattern.label}.
+
+This Function app uses the Python v2 decorator programming model and a Service Bus queue trigger. The trigger adapter should stay thin: decode the message, validate the envelope, and call shared code from \`backend/orchestration\` after that shared code is packaged with the Function app.
+
+The generated trigger currently decodes and logs message keys, then returns. It does not index documents,
+invoke orchestration, or execute workflow stages. A successfully published message is not proof of
+completed processing; implement and test a real consumer before using this scaffold for production work.
+
+Deployed triggers use \`ServiceBusConnection__fullyQualifiedNamespace\` and \`ServiceBusConnection__clientId\` to select the same user-assigned identity that OpenTofu grants the Service Bus Data Receiver role. \`SERVICEBUS_QUEUE_NAME\` is populated from \`function_worker_queue_name\`. Function host storage uses the complete \`AzureWebJobsStorage\` connection setting.
+
+## Local Development
+
+\`\`\`bash
+uv sync --frozen --project ../../backend --extra test --extra functions
+cp local.settings.example.json local.settings.json
+uv run --project ../../backend --directory . python -m pytest -q
+func start
+\`\`\`
+`;
+}
+export function renderFunctionHostJson() {
+    return JSON.stringify({
+        version: '2.0',
+        extensionBundle: {
+            id: 'Microsoft.Azure.Functions.ExtensionBundle',
+            version: '[4.*, 5.0.0)'
+        }
+    }, null, 2);
+}
+export function renderFunctionLocalSettings(plan) {
+    const pattern = genAiPattern(plan);
+    return JSON.stringify({
+        IsEncrypted: false,
+        Values: {
+            AzureWebJobsStorage: 'UseDevelopmentStorage=true',
+            FUNCTIONS_WORKER_RUNTIME: 'python',
+            SERVICEBUS_QUEUE_NAME: DEFAULT_FUNCTION_WORKER_QUEUE_NAME,
+            ServiceBusConnection__fullyQualifiedNamespace: '<service-bus-namespace>.servicebus.windows.net',
+            GENAI_PATTERN: pattern.id,
+            SHARED_ORCHESTRATION_ROOT: '../../backend'
+        }
+    }, null, 2);
+}
+export function renderFunctionRequirements(context) {
+    return context.functionsRequirements;
+}
+export function renderFunctionApp(plan) {
+    const pattern = genAiPattern(plan);
+    const moduleName = pyModule(pattern.id);
+    return `import json
+import logging
+
+import azure.functions as func
+
+
+app = func.FunctionApp()
+
+
+def decode_message_payload(body: str) -> dict:
+    try:
+        value = json.loads(body)
+    except json.JSONDecodeError:
+        return {"raw": body}
+    if isinstance(value, dict):
+        return value
+    return {"value": value}
+
+
+@app.service_bus_queue_trigger(
+    arg_name="message",
+    queue_name="%SERVICEBUS_QUEUE_NAME%",
+    connection="ServiceBusConnection",
+)
+def process_${moduleName}_work(message: func.ServiceBusMessage) -> None:
+    payload = decode_message_payload(message.get_body().decode("utf-8"))
+    logging.info("Received ${pattern.id} worker message with keys: %s", sorted(payload.keys()))
+    # Keep this adapter thin; call backend.orchestration code from packaged shared modules.
+`;
+}
+export function renderFunctionTest() {
+    return `from function_app import decode_message_payload
+
+
+def test_decode_message_payload_for_json_object():
+    assert decode_message_payload('{"source_uri":"az://documents/example.pdf"}') == {
+        "source_uri": "az://documents/example.pdf"
+    }
+
+
+def test_decode_message_payload_for_plain_text():
+    assert decode_message_payload("plain text") == {"raw": "plain text"}
+`;
+}
+export function renderFunctionFuncIgnore() {
+    return `.venv/
+node_modules/
+dist/
+build/
+.git/
+.liftoff/
+.terraform/
+__pycache__/
+.pytest_cache/
+.env
+.env.*
+*.env
+*.pem
+*.key
+*.pfx
+*.tfstate*
+local.settings.json
+tests/
+`;
+}
+export function renderFunctionGitIgnore() {
+    return `.venv/
+__pycache__/
+.pytest_cache/
+local.settings.json
+`;
+}
+//# sourceMappingURL=functions.js.map

package/dist/generators/genai/functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../../src/generators/genai/functions.ts"],"names":[],"mappings":"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"}

package/dist/generators/genai/index.d.ts

@@ -0,0 +1,8 @@
+import type { GeneratorContext as ResolvedGeneratorContext } from '../context.js';
+type GeneratorContext = Pick<ResolvedGeneratorContext, 'functionsRequirements'> & {
+    python: Pick<ResolvedGeneratorContext['python'], 'genai'>;
+};
+import type { AddArtifact } from '../../template-types.js';
+import type { GenAiProjectPlan } from '../../domain/project/contracts.js';
+export declare function addGenAiExtensionArtifacts(add: AddArtifact, plan: GenAiProjectPlan, context: GeneratorContext): void;
+export {};

package/dist/generators/genai/index.js

@@ -0,0 +1,11 @@
+import { addBackendArtifacts } from './backend.js';
+import { addDatabaseArtifacts } from './database.js';
+import { addPatternArtifacts } from './patterns.js';
+import { addFunctionArtifacts } from './functions.js';
+export function addGenAiExtensionArtifacts(add, plan, context) {
+    addBackendArtifacts(add, plan, context);
+    addDatabaseArtifacts(add, plan);
+    addPatternArtifacts(add, plan);
+    addFunctionArtifacts(add, plan, context);
+}
+//# sourceMappingURL=index.js.map

package/dist/generators/genai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/genai/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,UAAU,0BAA0B,CAAC,GAAgB,EAAE,IAAsB,EAAE,OAAyB;IAC5G,mBAAmB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAChC,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC/B,oBAAoB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/dist/generators/genai/patterns.d.ts

@@ -0,0 +1,9 @@
+import type { AddArtifact } from '../../template-types.js';
+import type { GenAiProjectPlan } from '../../domain/project/contracts.js';
+export declare function addPatternArtifacts(add: AddArtifact, plan: GenAiProjectPlan): void;
+export declare function renderPatternAgent(plan: GenAiProjectPlan): string;
+export declare function renderPatternAgentTest(plan: GenAiProjectPlan): string;
+export declare function renderPromptTemplate(plan: GenAiProjectPlan): string;
+export declare function renderPromptReadme(): string;
+export declare function renderVectorStore(): string;
+export declare function renderPatternWorker(plan: GenAiProjectPlan): string;

package/dist/generators/genai/patterns.js

@@ -0,0 +1,309 @@
+import { genAiPattern } from '../common/values.js';
+import { pyModule } from '../common/values.js';
+export function addPatternArtifacts(add, plan) {
+    const pattern = genAiPattern(plan);
+    const routeModule = pyModule(pattern.id);
+    add('pattern-agent', 'pattern', ['backend', 'orchestration', 'agents', `${routeModule}_agent.py`], renderPatternAgent(plan));
+    add('pattern-agent-test', 'backend-test', ['backend', 'tests', `test_${routeModule}_orchestration.py`], renderPatternAgentTest(plan));
+    add('pattern-prompt', 'pattern', ['backend', 'orchestration', 'prompts', `${pattern.id}.md`], renderPromptTemplate(plan));
+    add('pattern-agent-package', 'pattern', ['backend', 'orchestration', 'agents', '__init__.py'], '');
+    add('pattern-prompt-readme', 'pattern', ['backend', 'orchestration', 'prompts', 'README.md'], renderPromptReadme());
+    if (pattern.id === 'rag') {
+        add('rag-vector-store', 'pattern', ['backend', 'orchestration', 'retrieval', 'vector_store.py'], renderVectorStore());
+        add('rag-retrieval-package', 'pattern', ['backend', 'orchestration', 'retrieval', '__init__.py'], '');
+    }
+    if (pattern.worker) {
+        add('pattern-worker', 'pattern', ['backend', 'workers', `${routeModule}_worker.py`], renderPatternWorker(plan));
+        add('backend-workers-package', 'pattern', ['backend', 'workers', '__init__.py'], '');
+    }
+    if (pattern.id === 'fine-tuned') {
+        add('fine-tuned-eval-dataset', 'pattern', ['backend', 'evaluation', 'datasets', 'sample.jsonl'], '{"input":"Example request","expected":"Expected response placeholder"}');
+    }
+}
+export function renderPatternAgent(plan) {
+    const pattern = genAiPattern(plan);
+    const moduleName = pyModule(pattern.id);
+    if (pattern.id === 'rag') {
+        return `from backend.observability.tracing import Tracer, build_tracer
+from backend.orchestration.model_config import AgentRunner, build_agent_runner
+from backend.orchestration.tools.messaging import MessagePublisher, build_message_publisher
+
+
+async def _run_agent(
+    operation: str,
+    prompt: str,
+    runner: AgentRunner | None,
+    tracer: Tracer | None,
+) -> str:
+    selected_runner = runner or build_agent_runner()
+    selected_tracer = tracer or build_tracer()
+    async with selected_tracer.trace(operation, {"prompt": prompt}) as trace:
+        output = await selected_runner.run(prompt)
+        trace.set_output({"text": output})
+        return output
+
+
+async def answer_question(
+    question: str,
+    *,
+    runner: AgentRunner | None = None,
+    tracer: Tracer | None = None,
+) -> dict:
+    answer = await _run_agent(
+        "rag.query",
+        f"Answer this question without claiming retrieval or citations.\\nQuestion: {question}",
+        runner,
+        tracer,
+    )
+    return {
+        "answer": answer,
+        "question": question,
+        "citations": [],
+    }
+
+
+async def enqueue_ingestion(
+    source_uri: str,
+    *,
+    publisher: MessagePublisher | None = None,
+) -> dict:
+    selected_publisher = publisher or build_message_publisher()
+    await selected_publisher.publish("rag.ingest", {"source_uri": source_uri})
+    return {"status": "queued", "source_uri": source_uri}
+`;
+    }
+    if (pattern.id === 'streaming') {
+        return `import json
+
+from backend.observability.tracing import Tracer, build_tracer
+from backend.orchestration.model_config import AgentRunner, build_agent_runner
+
+
+async def stream_response(
+    prompt: str,
+    *,
+    runner: AgentRunner | None = None,
+    tracer: Tracer | None = None,
+):
+    selected_runner = runner or build_agent_runner()
+    selected_tracer = tracer or build_tracer()
+    async with selected_tracer.trace("streaming.run", {"prompt": prompt}) as trace:
+        output = await selected_runner.run(
+            f"Respond concisely and safely to this request:\\n{prompt}"
+        )
+        trace.set_output({"text": output})
+    yield f"data: {json.dumps({'text': output})}\\n\\n"
+`;
+    }
+    const instruction = pattern.id === 'generic'
+        ? 'Respond safely and usefully to this general-purpose AI request:'
+        : `Respond to this ${pattern.id} starter input; no specialized orchestration is implemented:`;
+    return `from backend.observability.tracing import Tracer, build_tracer
+from backend.orchestration.model_config import AgentRunner, build_agent_runner
+
+
+async def run_${moduleName}(
+    input_text: str,
+    *,
+    runner: AgentRunner | None = None,
+    tracer: Tracer | None = None,
+) -> dict:
+    selected_runner = runner or build_agent_runner()
+    selected_tracer = tracer or build_tracer()
+    prompt = (
+        "${instruction}\\n"
+        f"{input_text}"
+    )
+    async with selected_tracer.trace("${pattern.id}.run", {"input": input_text}) as trace:
+        output = await selected_runner.run(prompt)
+        trace.set_output({"result": output})
+    return {
+        "result": output,
+        "input": input_text,
+    }
+`;
+}
+export function renderPatternAgentTest(plan) {
+    const pattern = genAiPattern(plan);
+    const moduleName = pyModule(pattern.id);
+    const agentModule = `backend.orchestration.agents.${moduleName}_agent`;
+    if (pattern.id === 'rag') {
+        return `import asyncio
+
+import pytest
+
+from ${agentModule} import answer_question, enqueue_ingestion
+from backend.observability.tracing import DisabledTracer
+from backend.orchestration.model_config import ModelConfigurationError
+
+
+class FakeRunner:
+    async def run(self, prompt):
+        assert "Question: What is Liftoff?" in prompt
+        return "Liftoff is the generated orchestration starter."
+
+
+class FakePublisher:
+    def __init__(self):
+        self.messages = []
+
+    async def publish(self, topic, payload):
+        self.messages.append((topic, payload))
+
+
+def test_rag_query_uses_injected_runner_without_network():
+    result = asyncio.run(
+        answer_question(
+            "What is Liftoff?",
+            runner=FakeRunner(),
+            tracer=DisabledTracer(),
+        )
+    )
+    assert result == {
+        "answer": "Liftoff is the generated orchestration starter.",
+        "question": "What is Liftoff?",
+        "citations": [],
+    }
+
+
+def test_rag_ingestion_uses_injected_publisher():
+    publisher = FakePublisher()
+    result = asyncio.run(
+        enqueue_ingestion("az://documents/one.pdf", publisher=publisher)
+    )
+    assert result == {
+        "status": "queued",
+        "source_uri": "az://documents/one.pdf",
+    }
+    assert publisher.messages == [
+        ("rag.ingest", {"source_uri": "az://documents/one.pdf"})
+    ]
+
+
+def test_missing_model_configuration_is_explicit(monkeypatch):
+    monkeypatch.delenv("PYDANTIC_AI_MODEL", raising=False)
+    with pytest.raises(ModelConfigurationError, match="PYDANTIC_AI_MODEL is required"):
+        asyncio.run(answer_question("unconfigured"))
+`;
+    }
+    if (pattern.id === 'streaming') {
+        return `import asyncio
+
+import pytest
+
+from ${agentModule} import stream_response
+from backend.observability.tracing import DisabledTracer
+from backend.orchestration.model_config import ModelConfigurationError
+
+
+class FakeRunner:
+    async def run(self, prompt):
+        assert "stream this" in prompt
+        return "offline streamed answer"
+
+
+def test_streaming_uses_injected_runner_without_network():
+    async def collect():
+        return [
+            chunk
+            async for chunk in stream_response(
+                "stream this",
+                runner=FakeRunner(),
+                tracer=DisabledTracer(),
+            )
+        ]
+
+    chunks = asyncio.run(collect())
+    assert chunks == ['data: {"text": "offline streamed answer"}\\n\\n']
+
+
+def test_missing_model_configuration_is_explicit(monkeypatch):
+    monkeypatch.delenv("PYDANTIC_AI_MODEL", raising=False)
+
+    async def collect():
+        return [chunk async for chunk in stream_response("unconfigured")]
+
+    with pytest.raises(ModelConfigurationError, match="PYDANTIC_AI_MODEL is required"):
+        asyncio.run(collect())
+`;
+    }
+    return `import asyncio
+
+import pytest
+
+from ${agentModule} import run_${moduleName}
+from backend.observability.tracing import DisabledTracer
+from backend.orchestration.model_config import ModelConfigurationError
+
+
+class FakeRunner:
+    async def run(self, prompt):
+        assert "offline input" in prompt
+        return "offline ${pattern.id} result"
+
+
+def test_${moduleName}_uses_injected_runner_without_network():
+    result = asyncio.run(
+        run_${moduleName}(
+            "offline input",
+            runner=FakeRunner(),
+            tracer=DisabledTracer(),
+        )
+    )
+    assert result == {
+        "result": "offline ${pattern.id} result",
+        "input": "offline input",
+    }
+
+
+def test_missing_model_configuration_is_explicit(monkeypatch):
+    monkeypatch.delenv("PYDANTIC_AI_MODEL", raising=False)
+    with pytest.raises(ModelConfigurationError, match="PYDANTIC_AI_MODEL is required"):
+        asyncio.run(run_${moduleName}("unconfigured"))
+`;
+}
+export function renderPromptTemplate(plan) {
+    const pattern = genAiPattern(plan);
+    if (pattern.id === 'generic') {
+        return `# Generic GenAI System Prompt
+
+Respond safely and usefully to the general-purpose request.
+
+Do not assume retrieval, conversation memory, tools, streaming, fine-tuning, multi-agent coordination, or workflow behavior unless the project explicitly adds it.
+`;
+    }
+    return `# ${pattern.label} Prompt
+
+You are implementing a ${pattern.label} generated by Mission Control Liftoff.
+
+Use PydanticAI orchestration and return outputs that match the API contract.
+`;
+}
+export function renderPromptReadme() {
+    return `# Prompt Templates
+
+These project-owned prompt files are editable design seeds. The generated runner does not load them.
+Implement and test prompt loading in a separate reviewed project change before relying on their contents.
+`;
+}
+export function renderVectorStore() {
+    return `from typing import Protocol
+
+
+class VectorStore(Protocol):
+    async def search(self, query: str, limit: int = 5) -> list[dict]:
+        ...
+
+
+class PgVectorStore:
+    async def search(self, query: str, limit: int = 5) -> list[dict]:
+        raise NotImplementedError("pgvector retrieval is not implemented by this starter.")
+`;
+}
+export function renderPatternWorker(plan) {
+    const pattern = genAiPattern(plan);
+    return `async def run_worker() -> None:
+    raise NotImplementedError("${pattern.id} job processing is a deferred project integration.")
+`;
+}
+//# sourceMappingURL=patterns.js.map

package/dist/generators/genai/patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.js","sourceRoot":"","sources":["../../../src/generators/genai/patterns.ts"],"names":[],"mappings":"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"}