@shepai/cli 1.179.1 → 1.180.0

package/dist/packages/core/src/application/ports/output/services/index.js

@@ -7,3 +7,4 @@ export { IssueFetcherError, IssueNotFoundError, IssueAuthenticationError, IssueS
 export { WorktreeError, WorktreeErrorCode } from './worktree-service.interface.js';
 export { GitPrError, GitPrErrorCode } from './git-pr-service.interface.js';
 export { GitHubAuthError, GitHubCloneError, GitHubUrlParseError, GitHubRepoListError, } from './github-repository-service.interface.js';
+export { ApplicationFileSystemError } from './application-file-system-service.interface.js';

package/dist/packages/core/src/application/ports/output/services/interactive-session-service.interface.d.ts

@@ -9,10 +9,15 @@
  * - Application layer depends on this interface
  * - Infrastructure layer provides the concrete implementation (singleton)
  */
-import type { InteractiveSession, InteractiveMessage } from '../../../../domain/generated/output.js';
+import type { InteractiveSession, InteractiveMessage, WorkflowStep } from '../../../../domain/generated/output.js';
 import type { UserInteractionData } from '../agents/interactive-agent-executor.interface.js';
 /**
- * A single streaming chunk forwarded from agent stdout to an SSE consumer.
+ * A single streaming chunk forwarded from the interactive session to an
+ * SSE consumer. One shape carries every kind of real-time update the UI
+ * needs — text deltas, tool activity, interaction requests, AND every
+ * persisted-state change (new messages, session/turn status transitions)
+ * — so the client can rely on SSE as the single source of truth and
+ * drop all periodic polling.
  */
 export interface StreamChunk {
     /** Incremental output text from the agent */
@@ -25,6 +30,33 @@ export interface StreamChunk {
     activity?: StreamActivity;
     /** Pending user interaction (AskUserQuestion) — agent is waiting for user response */
     interaction?: UserInteractionData;
+    /**
+     * A newly persisted message (user or assistant, including tool-event
+     * messages). Emitted ONCE per `messageRepo.create` call so subscribers
+     * can append it to their local cache without refetching the whole
+     * history. Idempotent on the client by `message.id`.
+     */
+    message?: InteractiveMessage;
+    /**
+     * Session lifecycle transition: 'booting' → 'ready' → 'error' / 'stopped'.
+     * Emitted ONCE per `sessionRepo.updateStatus` call.
+     */
+    sessionStatus?: string;
+    /**
+     * Turn activity transition: 'idle' / 'processing' / 'unread' /
+     * 'awaiting_input'. Emitted ONCE per `sessionRepo.updateTurnStatus`
+     * call. This is what drives the client's "Thinking…" indicator
+     * without polling.
+     */
+    turnStatus?: string;
+    /**
+     * Workflow step transition — emitted by the orchestrator each time
+     * a step changes status (pending → running → done / failed /
+     * interrupted). Clients use this to update the tracker live
+     * without polling; full state is always also recoverable from
+     * `getChatState()` so a missed event is never fatal.
+     */
+    workflowStep?: WorkflowStep;
 }
 /**
  * A structured activity event emitted during agent execution.
@@ -57,6 +89,27 @@ export interface ChatState {
     turnStatus: string;
     /** Pending user interaction — agent is waiting for user response (null when no interaction pending) */
     pendingInteraction: UserInteractionData | null;
+    /**
+     * Persisted workflow view for the feature. Present when the
+     * orchestrator has materialised steps in the database; null
+     * otherwise. The client renders a step tracker from this field
+     * instead of parsing marker strings in the message stream.
+     */
+    workflow: WorkflowView | null;
+}
+/**
+ * Persisted workflow view for a feature — derived entirely from the
+ * `workflow_steps` table plus a trivial "which step is running"
+ * query. Because the whole shape is re-derivable from SQL, a
+ * browser refresh or daemon restart never loses progress state.
+ */
+export interface WorkflowView {
+    /** Logical workflow id (e.g. 'application-creation-v1'). */
+    workflowId: string;
+    /** Ordered step rows for the whole workflow. */
+    steps: WorkflowStep[];
+    /** ID of the step currently in `running` status, if any. */
+    currentStepId: string | null;
 }
 /** Live session metadata for the frontend toolbar. */
 export interface SessionInfo {
@@ -64,7 +117,6 @@ export interface SessionInfo {
     sessionId: string | null;
     model: string | null;
     startedAt: string;
-    idleTimeoutMinutes: number;
     lastActivityAt: string;
     /** Cumulative cost in USD for this session (null if not yet tracked) */
     totalCostUsd: number | null;
@@ -104,7 +156,7 @@ export interface IInteractiveSessionService {
      * @returns The newly created session record (status may still be 'booting')
      * @throws ConcurrentSessionLimitError when the configured cap is reached
      */
-    startSession(featureId: string, worktreePath: string, model?: string, agentType?: string): Promise<InteractiveSession>;
+    startSession(featureId: string, worktreePath: string, model?: string, agentType?: string, systemPrompt?: string, initialUserMessage?: string): Promise<InteractiveSession>;
     /**
      * Stop an active session: send SIGTERM to the process, cancel the idle
      * timer, and mark the DB record as stopped. Idempotent — calling on an
@@ -160,9 +212,25 @@ export interface IInteractiveSessionService {
      * - If session is booting: queues the message
      * - If no session: boots one and queues the message
      *
+     * @param systemPrompt - Optional per-scope system prompt for the agent
+     *   SDK. When provided (and the call boots a new session), the service
+     *   uses this instead of the default feature-context prompt. Lets
+     *   Application/Repository/Global chats each supply their own
+     *   scope-appropriate instructions without the service needing to
+     *   know anything about the scope shape.
+     *
      * @returns The persisted user message
      */
-    sendUserMessage(featureId: string, content: string, worktreePath: string, model?: string, agentType?: string): Promise<InteractiveMessage>;
+    sendUserMessage(featureId: string, content: string, worktreePath: string, model?: string, agentType?: string, systemPrompt?: string, 
+    /**
+     * When provided AND this call boots a new session, the agent's
+     * very first turn content is `agentKickoffOverride` instead of
+     * `content`. The UI still shows `content` in the user's first
+     * bubble — this is purely the agent-side text. Used by the
+     * application-creation flow to inject a "read SHEP_BRIEF.md
+     * first" directive without polluting the chat transcript.
+     */
+    agentKickoffOverride?: string): Promise<InteractiveMessage>;
     /**
      * Get the complete chat state for a feature in a single call.
      * Merges DB messages with any in-flight streaming content.
@@ -173,6 +241,13 @@ export interface IInteractiveSessionService {
      * Resolves the active session internally.
      */
     subscribeByFeature(featureId: string, onChunk: (chunk: StreamChunk) => void): UnsubscribeFn;
+    /**
+     * Subscribe to real-time chunks for EVERY active session, regardless
+     * of feature. Each chunk is paired with the feature scope key it
+     * came from. Used by the global turn-status SSE endpoint to push
+     * sidebar activity indicators without polling.
+     */
+    subscribeAll(onChunk: (featureId: string, chunk: StreamChunk) => void): UnsubscribeFn;
     /**
      * Stop the active session for a feature. Kills the agent process.
      * Idempotent — no-op if no active session exists.
@@ -204,5 +279,36 @@ export interface IInteractiveSessionService {
      * @param annotations - Optional per-question annotations (notes, preview)
      */
     respondToInteraction(featureId: string, answers: Record<string, string>): Promise<void>;
+    /**
+     * Set the currently-active workflow step for a feature. While a
+     * step is active, every message persisted via this service is
+     * tagged with the step's id, so the UI can group the conversation
+     * by step without parsing marker strings.
+     *
+     * Pass `null` (via `clearActiveStep`) when the orchestrator is
+     * between steps. The mapping is in-memory only — the DB is the
+     * source of truth for per-message `stepId`.
+     */
+    setActiveStep(featureId: string, stepId: string): void;
+    /** Clear the currently-active workflow step for a feature. */
+    clearActiveStep(featureId: string): void;
+    /**
+     * Notify subscribers of a workflow step transition. The
+     * orchestrator calls this immediately after persisting a status
+     * change so the client's live tracker updates without polling.
+     */
+    notifyWorkflowStep(featureId: string, step: WorkflowStep): void;
+    /**
+     * Wait until the next turn for the given feature finishes — i.e.
+     * until the next `done: true` chunk arrives on the feature
+     * subscription. Used by the orchestrator to serialise steps: send
+     * a step's prompt, then await its agent turn to fully complete
+     * before marking the step done and moving on to the next one.
+     *
+     * Resolves as soon as any `done` chunk is observed; the caller is
+     * responsible for subscribing before triggering the turn to avoid
+     * races.
+     */
+    waitForTurnDone(featureId: string, signal?: AbortSignal): Promise<void>;
 }
 //# sourceMappingURL=interactive-session-service.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/interactive-session-service.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactive-session-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/interactive-session-service.interface.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"interactive-session-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/interactive-session-service.interface.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/src/application/ports/output/services/terminal-session-service.interface.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Terminal Session Service
+ *
+ * Output port for long-lived interactive terminal (PTY) sessions owned by
+ * the infrastructure layer. Presentation layers (web, TUI, CLI) stream
+ * output from the session and feed input into it through this generic API
+ * so no provider-specific terminal code leaks outside of infrastructure.
+ */
+export interface CreateTerminalSessionInput {
+    /** Absolute working directory to spawn the PTY in. */
+    cwd: string;
+    /** Initial terminal size in columns. */
+    cols?: number;
+    /** Initial terminal size in rows. */
+    rows?: number;
+}
+export interface CreatedTerminalSession {
+    /** Opaque session id used for all subsequent operations. */
+    id: string;
+    /** Shell binary actually spawned (e.g. `/bin/bash`, `powershell.exe`). */
+    shell: string;
+    /** Resolved cwd the session is running in. */
+    cwd: string;
+}
+export type TerminalOutputListener = (chunk: string) => void;
+export type TerminalExitListener = (code: number | null) => void;
+export interface ITerminalSessionService {
+    /** Create a new PTY session. */
+    create(input: CreateTerminalSessionInput): CreatedTerminalSession;
+    /** Write stdin data to a session. */
+    write(sessionId: string, data: string): void;
+    /** Resize a session's pseudo-terminal. */
+    resize(sessionId: string, cols: number, rows: number): void;
+    /**
+     * Subscribe to a session's output stream.
+     *
+     * Returns an unsubscribe function. Safe to subscribe multiple times (e.g.
+     * for SSE reconnects) — each subscriber gets independent callbacks.
+     */
+    subscribe(sessionId: string, onData: TerminalOutputListener, onExit?: TerminalExitListener): () => void;
+    /** Whether a session id currently exists. */
+    exists(sessionId: string): boolean;
+    /** Kill and remove a session. Idempotent. */
+    close(sessionId: string): void;
+}
+//# sourceMappingURL=terminal-session-service.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/terminal-session-service.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-session-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/terminal-session-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,0BAA0B;IACzC,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAC7D,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAEjE,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,MAAM,CAAC,KAAK,EAAE,0BAA0B,GAAG,sBAAsB,CAAC;IAElE,qCAAqC;IACrC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7C,0CAA0C;IAC1C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5D;;;;;OAKG;IACH,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,sBAAsB,EAC9B,MAAM,CAAC,EAAE,oBAAoB,GAC5B,MAAM,IAAI,CAAC;IAEd,6CAA6C;IAC7C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAEnC,6CAA6C;IAC7C,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC"}

package/dist/packages/core/src/application/ports/output/services/terminal-session-service.interface.js

@@ -0,0 +1,9 @@
+/**
+ * Terminal Session Service
+ *
+ * Output port for long-lived interactive terminal (PTY) sessions owned by
+ * the infrastructure layer. Presentation layers (web, TUI, CLI) stream
+ * output from the session and feed input into it through this generic API
+ * so no provider-specific terminal code leaks outside of infrastructure.
+ */
+export {};

package/dist/packages/core/src/application/use-cases/applications/create-application.use-case.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Create Application Use Case
+ *
+ * End-to-end "user clicked Create": derives a unique slug, scaffolds the
+ * project folder via CreateProjectUseCase, persists a new Application
+ * entity, and (optionally) kicks off the interactive agent session by
+ * sending the application-creation prompt as the first chat message.
+ *
+ * Composing the prompt + first-message dispatch in this use case keeps
+ * the presentation layer free of orchestration logic and lets every
+ * surface (Web, CLI, TUI) get the same behavior from a single call.
+ */
+import type { Application } from '../../../domain/generated/output.js';
+import type { IApplicationRepository } from '../../ports/output/repositories/application-repository.interface.js';
+import type { IApplicationCreationPromptBuilder } from '../../ports/output/services/application-creation-prompt-builder.interface.js';
+import type { IApplicationBriefStore } from '../../ports/output/services/application-brief-store.interface.js';
+import type { CreateProjectUseCase } from '../projects/create-project.use-case.js';
+import type { SendInteractiveMessageUseCase } from '../interactive/send-interactive-message.use-case.js';
+import type { RunWorkflowUseCase } from '../workflows/run-workflow.use-case.js';
+import type { IInteractiveSessionService } from '../../ports/output/services/interactive-session-service.interface.js';
+/**
+ * Build the very first message the agent sees on turn 1. Carries the
+ * user's verbatim request AND a hard directive to read the brief
+ * BEFORE any other action. Kept short so the agent doesn't skim past
+ * the directive — the real content lives in the brief file.
+ *
+ * Note that this string is NOT persisted to the chat UI — the user
+ * only sees their raw request in the first bubble. This is the
+ * agent-side kickoff text, injected via `agentKickoffOverride`.
+ *
+ * @param briefPath  Absolute path to the brief file. Lives OUTSIDE
+ *                   the user's project (under `~/.shep/application-briefs/`)
+ *                   so we don't pollute the scaffolded repo.
+ * @param userMessage The user's verbatim request.
+ */
+export declare function buildKickoffDirective(args: {
+    briefPath: string;
+    userMessage: string;
+}): string;
+export interface CreateApplicationInput {
+    description: string;
+    agentType?: string;
+    modelOverride?: string;
+    /**
+     * When set, the use case ALSO sends this as the first message of the
+     * application's interactive chat session, wrapped with the full
+     * application-creation prompt (Shep persona, mission, tech stack,
+     * workflow, quality bar, definition of done). Pass the user's verbatim
+     * request — wrapping happens internally via the injected prompt builder.
+     */
+    initialPrompt?: string;
+}
+export interface CreateApplicationResult {
+    application: Application;
+    repositoryPath: string;
+}
+/**
+ * 6-character lowercase hex tag (~16M combinations). Appended to every
+ * application slug so each one is unique on disk and in the DB without
+ * needing a sequential lookup-and-retry against existing rows. Random
+ * also avoids the failure mode where a stale folder (left over from a
+ * deleted DB row) blocks recreation under the same description.
+ *
+ * Exported for unit testing.
+ */
+export declare function randomSlugTag(): string;
+export declare class CreateApplicationUseCase {
+    private readonly appRepo;
+    private readonly createProject;
+    private readonly promptBuilder;
+    private readonly sendMessage;
+    private readonly briefStore;
+    private readonly runWorkflow;
+    private readonly sessionService;
+    constructor(appRepo: IApplicationRepository, createProject: CreateProjectUseCase, promptBuilder: IApplicationCreationPromptBuilder, sendMessage: SendInteractiveMessageUseCase, briefStore: IApplicationBriefStore, runWorkflow: RunWorkflowUseCase, sessionService: IInteractiveSessionService);
+    execute(input: CreateApplicationInput): Promise<CreateApplicationResult>;
+    /**
+     * Kick off the orchestrator asynchronously. Resolves the session
+     * id by booting it via the first step's send, then runs the rest
+     * of the workflow. Errors are logged — the application is
+     * already persisted, so the chat can recover even if the
+     * workflow dies.
+     */
+    private dispatchWorkflow;
+    /**
+     * Generate `<baseSlug>-<random>` candidates until both the DB has no row
+     * with that slug AND CreateProjectUseCase reports the folder doesn't
+     * exist. Retries up to MAX_ATTEMPTS times before giving up.
+     */
+    private allocateUniqueSlugAndScaffold;
+}
+//# sourceMappingURL=create-application.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/applications/create-application.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-application.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/applications/create-application.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAEvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qEAAqE,CAAC;AAClH,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,8EAA8E,CAAC;AACtI,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kEAAkE,CAAC;AAC/G,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qDAAqD,CAAC;AACzG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sEAAsE,CAAC;AAGvH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAe9F;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAoDD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,qBACa,wBAAwB;IAGjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAE3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAZd,OAAO,EAAE,sBAAsB,EAE/B,aAAa,EAAE,oBAAoB,EAEnC,aAAa,EAAE,iCAAiC,EAEhD,WAAW,EAAE,6BAA6B,EAE1C,UAAU,EAAE,sBAAsB,EAElC,WAAW,EAAE,kBAAkB,EAE/B,cAAc,EAAE,0BAA0B;IAGvD,OAAO,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA2G9E;;;;;;OAMG;YACW,gBAAgB;IAqC9B;;;;OAIG;YACW,6BAA6B;CA0B5C"}

package/dist/packages/core/src/application/use-cases/applications/create-application.use-case.js

@@ -0,0 +1,305 @@
+/**
+ * Create Application Use Case
+ *
+ * End-to-end "user clicked Create": derives a unique slug, scaffolds the
+ * project folder via CreateProjectUseCase, persists a new Application
+ * entity, and (optionally) kicks off the interactive agent session by
+ * sending the application-creation prompt as the first chat message.
+ *
+ * Composing the prompt + first-message dispatch in this use case keeps
+ * the presentation layer free of orchestration logic and lets every
+ * surface (Web, CLI, TUI) get the same behavior from a single call.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+import { randomUUID, randomBytes } from 'node:crypto';
+import { ApplicationStatus } from '../../../domain/generated/output.js';
+import { APPLICATION_CREATION_WORKFLOW } from '../../workflows/application-creation.workflow.js';
+/**
+ * Build the very first message the agent sees on turn 1. Carries the
+ * user's verbatim request AND a hard directive to read the brief
+ * BEFORE any other action. Kept short so the agent doesn't skim past
+ * the directive — the real content lives in the brief file.
+ *
+ * Note that this string is NOT persisted to the chat UI — the user
+ * only sees their raw request in the first bubble. This is the
+ * agent-side kickoff text, injected via `agentKickoffOverride`.
+ *
+ * @param briefPath  Absolute path to the brief file. Lives OUTSIDE
+ *                   the user's project (under `~/.shep/application-briefs/`)
+ *                   so we don't pollute the scaffolded repo.
+ * @param userMessage The user's verbatim request.
+ */
+export function buildKickoffDirective(args) {
+    return [
+        `Before you take ANY other action, use the Read tool to read \`${args.briefPath}\` in full.`,
+        `That file is your complete operating brief — persona (Shep), environment facts, workflow, tech stack, quality bar, and definition of done. Treat it as your system prompt for this entire session.`,
+        ``,
+        `The brief lives OUTSIDE your working directory on purpose — do NOT copy it into the project and do NOT mention it to the user.`,
+        ``,
+        `After you have read the brief, begin executing Workflow step 1 immediately. Do not run \`ls\`, \`pwd\`, or any other discovery command — the brief's Environment section already told you everything about your working directory.`,
+        ``,
+        `---`,
+        ``,
+        `# User's request`,
+        ``,
+        args.userMessage,
+    ].join('\n');
+}
+/** Stop words stripped when building the application slug. */
+const STOP_WORDS = new Set([
+    'a',
+    'an',
+    'the',
+    'and',
+    'or',
+    'but',
+    'with',
+    'for',
+    'in',
+    'on',
+    'to',
+    'of',
+    'is',
+    'it',
+    'that',
+    'this',
+    'my',
+    'our',
+    'your',
+    'me',
+    'i',
+    'build',
+    'create',
+    'make',
+    'add',
+    'implement',
+    'develop',
+    'write',
+]);
+function slugify(description) {
+    const words = description
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, '')
+        .split(/\s+/)
+        .filter((w) => w.length > 0 && !STOP_WORDS.has(w));
+    const slug = words.slice(0, 5).join('-');
+    return slug || 'application';
+}
+function toTitleCase(slug) {
+    return slug
+        .split('-')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+/**
+ * 6-character lowercase hex tag (~16M combinations). Appended to every
+ * application slug so each one is unique on disk and in the DB without
+ * needing a sequential lookup-and-retry against existing rows. Random
+ * also avoids the failure mode where a stale folder (left over from a
+ * deleted DB row) blocks recreation under the same description.
+ *
+ * Exported for unit testing.
+ */
+export function randomSlugTag() {
+    return randomBytes(3).toString('hex');
+}
+let CreateApplicationUseCase = class CreateApplicationUseCase {
+    appRepo;
+    createProject;
+    promptBuilder;
+    sendMessage;
+    briefStore;
+    runWorkflow;
+    sessionService;
+    constructor(appRepo, createProject, promptBuilder, sendMessage, briefStore, runWorkflow, sessionService) {
+        this.appRepo = appRepo;
+        this.createProject = createProject;
+        this.promptBuilder = promptBuilder;
+        this.sendMessage = sendMessage;
+        this.briefStore = briefStore;
+        this.runWorkflow = runWorkflow;
+        this.sessionService = sessionService;
+    }
+    async execute(input) {
+        // 1. Derive a stable slug stem from the description.
+        const baseSlug = slugify(input.description);
+        // 2. Allocate a unique <stem>-<6hex> slug + scaffold the project folder.
+        //    Random tag means siblings created from the same description never
+        //    collide on disk or in the DB; the retry loop below covers the
+        //    astronomically rare case where two random tags do clash.
+        const { slug, projectPath } = await this.allocateUniqueSlugAndScaffold(baseSlug);
+        // 3. Generate the human-readable display name from the BASE slug
+        //    only — the random hex tag is an internal disambiguator that
+        //    lives on the `slug` field (and the worktree path), and must
+        //    NEVER bleed into the user-visible title. Names are allowed to
+        //    duplicate; uniqueness is enforced on `slug`. Users can rename
+        //    afterwards via the application page.
+        const name = toTitleCase(baseSlug);
+        // 4. Create Application record
+        const now = new Date();
+        const application = {
+            id: randomUUID(),
+            name,
+            slug,
+            description: input.description,
+            repositoryPath: projectPath,
+            additionalPaths: [],
+            status: ApplicationStatus.Idle,
+            agentType: input.agentType,
+            modelOverride: input.modelOverride,
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.appRepo.create(application);
+        // 5. Optionally kick off the interactive chat session.
+        //
+        //    Prompt delivery strategy — CRITICAL:
+        //    The Claude Agent SDK V2 session API (`unstable_v2_createSession`)
+        //    uses `SDKSessionOptions`, which does NOT include a `systemPrompt`
+        //    field — anything we pass there is silently dropped. V1 `query()`
+        //    supports `systemPrompt` but sacrifices the persistent-process
+        //    performance V2 gives us, so we stay on V2.
+        //
+        //    To actually deliver the Shep brief (persona, workflow, quality
+        //    bar, definition of done) we:
+        //      1. Build the full brief via the prompt builder.
+        //      2. Write it to `<SHEP_HOME>/application-briefs/<id>.md`
+        //         via IApplicationBriefStore. The brief lives OUTSIDE the
+        //         user's project on purpose: keeps the scaffolded repo
+        //         clean, survives project-folder recreation, is auditable
+        //         per application, and test-isolates via `SHEP_HOME`.
+        //      3. Persist the user's verbatim description as the first chat
+        //         message (clean UI — no prompt clutter).
+        //      4. Kick off the interactive session with a short directive
+        //         that (a) carries the user's request and (b) tells the
+        //         agent its very first action must be to `Read` the brief
+        //         at its absolute path. That read becomes turn 1 of the
+        //         conversation history, so every subsequent turn is
+        //         conditioned on the full brief.
+        if (input.initialPrompt?.trim()) {
+            const { systemPrompt, userMessage } = this.promptBuilder.build({
+                description: input.initialPrompt.trim(),
+                workspace: {
+                    workingDirectory: projectPath,
+                    platform: process.platform === 'win32' ? 'windows' : 'posix',
+                },
+            });
+            // 5a. Materialise the brief on disk. The brief holds the
+            //     persona/environment/quality bar only — the workflow
+            //     steps live in core code, not the brief, because the
+            //     orchestrator drives them step by step.
+            const briefPath = await this.briefStore.write(application.id, systemPrompt);
+            // 5b. Start the orchestrator in the background. The use case
+            //     returns immediately — the HTTP/CLI caller isn't blocked
+            //     for the 10+ minutes a full build takes. The orchestrator
+            //     will:
+            //
+            //       1. Boot the interactive session via `sendMessage`,
+            //          using step 1's prompt wrapped with the "read the
+            //          brief first" directive so the agent's turn 1
+            //          loads the brief.
+            //       2. Walk every step in order, persisting status
+            //          transitions BEFORE and AFTER each agent turn so
+            //          a refresh or crash always sees a consistent view.
+            //
+            //     We also persist the user's verbatim description as the
+            //     first chat bubble by letting `sendMessage` write it —
+            //     that happens inside the orchestrator via
+            //     `content: userMessage` on the first step.
+            const featureId = `app-${application.id}`;
+            void this.dispatchWorkflow({
+                featureId,
+                worktreePath: projectPath,
+                userMessage,
+                briefPath,
+                model: input.modelOverride,
+                agentType: input.agentType,
+            });
+        }
+        return { application, repositoryPath: projectPath };
+    }
+    /**
+     * Kick off the orchestrator asynchronously. Resolves the session
+     * id by booting it via the first step's send, then runs the rest
+     * of the workflow. Errors are logged — the application is
+     * already persisted, so the chat can recover even if the
+     * workflow dies.
+     */
+    async dispatchWorkflow(args) {
+        try {
+            await this.runWorkflow.execute({
+                featureId: args.featureId,
+                worktreePath: args.worktreePath,
+                workflow: APPLICATION_CREATION_WORKFLOW,
+                model: args.model,
+                agentType: args.agentType,
+                // First-step wrapper: the agent's very first turn sees the
+                // "read the brief first" directive stapled onto step 1's
+                // prompt. The chat UI still shows the user's verbatim
+                // description as the first bubble — the orchestrator
+                // persists `userMessage` as the first message row before
+                // dispatching the turn.
+                firstStepPromptWrapper: (stepPrompt) => buildKickoffDirective({
+                    briefPath: args.briefPath,
+                    userMessage: `${args.userMessage}\n\n---\n\n${stepPrompt}`,
+                }),
+                // Persisted first bubble — the orchestrator writes this as
+                // the user message before sending the first agent turn so
+                // the chat has an immediate visual anchor.
+                visibleFirstMessage: args.userMessage,
+            });
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error('[create-application] workflow dispatch failed:', err);
+        }
+    }
+    /**
+     * Generate `<baseSlug>-<random>` candidates until both the DB has no row
+     * with that slug AND CreateProjectUseCase reports the folder doesn't
+     * exist. Retries up to MAX_ATTEMPTS times before giving up.
+     */
+    async allocateUniqueSlugAndScaffold(baseSlug) {
+        const MAX_ATTEMPTS = 5;
+        let lastError;
+        for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+            const candidate = `${baseSlug}-${randomSlugTag()}`;
+            const existing = await this.appRepo.findBySlug(candidate);
+            if (existing)
+                continue;
+            const result = await this.createProject.execute({ name: candidate });
+            if (result.ok) {
+                return { slug: candidate, projectPath: result.path };
+            }
+            // Folder already exists (extremely unlikely with random tag) — retry
+            // with a fresh random tag.
+            lastError = result.error;
+        }
+        throw new Error(lastError ??
+            `Failed to allocate a unique slug for "${baseSlug}" after ${MAX_ATTEMPTS} attempts.`);
+    }
+};
+CreateApplicationUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IApplicationRepository')),
+    __param(1, inject('CreateProjectUseCase')),
+    __param(2, inject('IApplicationCreationPromptBuilder')),
+    __param(3, inject('SendInteractiveMessageUseCase')),
+    __param(4, inject('IApplicationBriefStore')),
+    __param(5, inject('RunWorkflowUseCase')),
+    __param(6, inject('IInteractiveSessionService')),
+    __metadata("design:paramtypes", [Object, Function, Object, Function, Object, Function, Object])
+], CreateApplicationUseCase);
+export { CreateApplicationUseCase };