@shepai/cli 1.177.0 → 1.178.0

package/apis/json-schema/Language.yaml

@@ -3,6 +3,7 @@ $id: Language.yaml
 type: string
 enum:
   - en
+  - uk
   - ru
   - pt
   - es

package/dist/packages/core/src/application/ports/output/services/agent-auth-detector.interface.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Agent Auth Detector Service Interface
+ *
+ * Output port for detecting whether the user is authenticated with a given
+ * AI coding agent (Claude Code, Cursor, Gemini CLI, Copilot CLI, etc.).
+ *
+ * Implementations are platform-specific: they may inspect environment
+ * variables, credentials files, the macOS Keychain, or call agent-specific
+ * `auth status` subcommands. Keeping this behind an output port keeps the
+ * application layer free of node:fs / child_process / keychain imports and
+ * lets tests substitute a fake.
+ */
+import type { AgentType } from '../../../../domain/generated/output.js';
+export interface IAgentAuthDetectorService {
+    /**
+     * Returns true if the user appears to be authenticated with the given
+     * agent. Implementations should be best-effort and conservative: prefer
+     * fast heuristics (env vars, file existence) over slow subprocess calls,
+     * and tolerate detection failures by returning false rather than throwing.
+     */
+    isAuthenticated(agentType: AgentType, binaryName: string | null): Promise<boolean>;
+}
+//# sourceMappingURL=agent-auth-detector.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/agent-auth-detector.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-auth-detector.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/agent-auth-detector.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAExE,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpF"}

package/dist/packages/core/src/application/ports/output/services/agent-auth-detector.interface.js

@@ -0,0 +1,13 @@
+/**
+ * Agent Auth Detector Service Interface
+ *
+ * Output port for detecting whether the user is authenticated with a given
+ * AI coding agent (Claude Code, Cursor, Gemini CLI, Copilot CLI, etc.).
+ *
+ * Implementations are platform-specific: they may inspect environment
+ * variables, credentials files, the macOS Keychain, or call agent-specific
+ * `auth status` subcommands. Keeping this behind an output port keeps the
+ * application layer free of node:fs / child_process / keychain imports and
+ * lets tests substitute a fake.
+ */
+export {};

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

@@ -0,0 +1,18 @@
+/**
+ * File System Service Interface
+ *
+ * Output port for filesystem mutations performed by use cases.
+ * Keeps the application layer free of direct `node:fs` imports.
+ */
+export interface IFileSystemService {
+    /**
+     * Recursively remove a directory and all its contents.
+     *
+     * Idempotent: succeeds silently if the path does not exist.
+     *
+     * @param dirPath - Absolute path to the directory to remove
+     * @throws Error if removal fails for reasons other than non-existence
+     */
+    removeDirectory(dirPath: string): Promise<void>;
+}
+//# sourceMappingURL=file-system-service.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/file-system-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD"}

package/dist/packages/core/src/application/ports/output/services/file-system-service.interface.js

@@ -0,0 +1,7 @@
+/**
+ * File System Service Interface
+ *
+ * Output port for filesystem mutations performed by use cases.
+ * Keeps the application layer free of direct `node:fs` imports.
+ */
+export {};

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

@@ -21,6 +21,9 @@ export type { IGitHubRepositoryService, GitHubRepo, GitHubOrganization, ListUser
 export { GitHubAuthError, GitHubCloneError, GitHubUrlParseError, GitHubRepoListError, } from './github-repository-service.interface.js';
 export type { IInteractiveSessionService, StreamChunk, UnsubscribeFn, ChatState, } from './interactive-session-service.interface.js';
 export type { ISkillInjectorService, SkillInjectionResult } from './skill-injector.interface.js';
+export type { IFileSystemService } from './file-system-service.interface.js';
+export type { IProjectScaffoldService, ScaffoldProjectInput, ScaffoldProjectResult, } from './project-scaffold-service.interface.js';
+export type { IAgentAuthDetectorService } from './agent-auth-detector.interface.js';
 export type { IDesktopNotifier } from './i-desktop-notifier.js';
 export type { IBrowserOpener } from './i-browser-opener.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/application/ports/output/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACjG,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,YAAY,EACV,wBAAwB,EACxB,UAAU,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,YAAY,EACZ,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0CAA0C,CAAC;AAClD,YAAY,EACV,0BAA0B,EAC1B,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,4CAA4C,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACjG,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACjG,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,YAAY,EACV,wBAAwB,EACxB,UAAU,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,YAAY,EACZ,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0CAA0C,CAAC;AAClD,YAAY,EACV,0BAA0B,EAC1B,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,4CAA4C,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACjG,YAAY,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,yCAAyC,CAAC;AACjD,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

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

@@ -0,0 +1,33 @@
+/**
+ * Project Scaffold Service Interface
+ *
+ * Output port for creating brand-new project folders on the filesystem.
+ * The adapter owns "where projects live" (e.g. $SHEP_HOME/projects) and
+ * how they are bootstrapped (mkdir + git init + initial commit) so the
+ * application layer stays free of node:fs / child_process imports.
+ */
+export interface ScaffoldProjectInput {
+    /** Filesystem-safe slug derived from the user-supplied project name. */
+    slug: string;
+}
+export interface ScaffoldProjectResult {
+    /** Absolute path to the created folder, normalized to forward slashes. */
+    path: string;
+}
+export interface IProjectScaffoldService {
+    /**
+     * Check whether a project folder with the given slug already exists.
+     * Used by the use case to fail fast without overwriting user data.
+     */
+    projectExists(slug: string): Promise<boolean>;
+    /**
+     * Create the project folder under the configured projects root, initialise
+     * git, and commit an empty initial commit so the canvas can resolve a real
+     * HEAD immediately. Implementations should be cross-platform safe.
+     *
+     * @throws Error if the directory cannot be created. Git init failures
+     *         should be tolerated (the folder still exists) but logged.
+     */
+    scaffoldProject(input: ScaffoldProjectInput): Promise<ScaffoldProjectResult>;
+}
+//# sourceMappingURL=project-scaffold-service.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-scaffold-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/project-scaffold-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9C;;;;;;;OAOG;IACH,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC9E"}

package/dist/packages/core/src/application/ports/output/services/project-scaffold-service.interface.js

@@ -0,0 +1,9 @@
+/**
+ * Project Scaffold Service Interface
+ *
+ * Output port for creating brand-new project folders on the filesystem.
+ * The adapter owns "where projects live" (e.g. $SHEP_HOME/projects) and
+ * how they are bootstrapped (mkdir + git init + initial commit) so the
+ * application layer stays free of node:fs / child_process imports.
+ */
+export {};

package/dist/packages/core/src/application/use-cases/agents/check-agent-auth.use-case.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Check Agent Auth Use Case
+ *
+ * Reports the install + auth status of the currently selected AI coding
+ * agent. Used by the onboarding empty state to drive the "Ready / Not
+ * installed / Needs auth" checklist.
+ *
+ * Owns:
+ *  - Reading the active agent type from settings
+ *  - Mapping agent type → user-facing label, tool id, binary name
+ *  - Looking up tool installation status via ListToolsUseCase
+ *  - Delegating credential detection to IAgentAuthDetectorService
+ *
+ * Presentation-agnostic: callable from CLI, TUI, and Web identically.
+ * The shape returned mirrors what the web UI consumes today; CLI/TUI may
+ * project a subset.
+ */
+import type { IAgentAuthDetectorService } from '../../ports/output/services/agent-auth-detector.interface.js';
+import { ListToolsUseCase } from '../tools/list-tools.use-case.js';
+export interface CheckAgentAuthResult {
+    /** Raw agent type string (matches AgentType enum values, or 'unknown'). */
+    agentType: string;
+    /** Whether the CLI tool binary is installed. */
+    installed: boolean;
+    /** Whether credentials / auth appear valid. */
+    authenticated: boolean;
+    /** Human-readable label for the agent (e.g. "Claude Code"). */
+    label: string;
+    /** CLI binary name (e.g. "claude", "gemini"). */
+    binaryName: string | null;
+    /** Shell command to install the tool, resolved for the current platform. */
+    installCommand: string | null;
+    /** Hint to show the user when not authenticated (typically the binary name). */
+    authCommand: string | null;
+}
+export declare class CheckAgentAuthUseCase {
+    private readonly listToolsUseCase;
+    private readonly authDetector;
+    constructor(listToolsUseCase: ListToolsUseCase, authDetector: IAgentAuthDetectorService);
+    execute(): Promise<CheckAgentAuthResult>;
+}
+//# sourceMappingURL=check-agent-auth.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/agents/check-agent-auth.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-agent-auth.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/agents/check-agent-auth.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8DAA8D,CAAC;AAC9G,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,aAAa,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gFAAgF;IAChF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAuCD,qBACa,qBAAqB;IAEJ,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAE3D,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAFc,gBAAgB,EAAE,gBAAgB,EAE5D,YAAY,EAAE,yBAAyB;IAGpD,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAkE/C"}

package/dist/packages/core/src/application/use-cases/agents/check-agent-auth.use-case.js

@@ -0,0 +1,134 @@
+/**
+ * Check Agent Auth Use Case
+ *
+ * Reports the install + auth status of the currently selected AI coding
+ * agent. Used by the onboarding empty state to drive the "Ready / Not
+ * installed / Needs auth" checklist.
+ *
+ * Owns:
+ *  - Reading the active agent type from settings
+ *  - Mapping agent type → user-facing label, tool id, binary name
+ *  - Looking up tool installation status via ListToolsUseCase
+ *  - Delegating credential detection to IAgentAuthDetectorService
+ *
+ * Presentation-agnostic: callable from CLI, TUI, and Web identically.
+ * The shape returned mirrors what the web UI consumes today; CLI/TUI may
+ * project a subset.
+ */
+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 { AgentType } from '../../../domain/generated/output.js';
+import { getSettings } from '../../../infrastructure/services/settings.service.js';
+import { ListToolsUseCase } from '../tools/list-tools.use-case.js';
+/**
+ * Co-located metadata table — pure facts about each AgentType. Lives in
+ * the use case because it is the only consumer that needs all three pieces
+ * (label + tool id + binary) wired together.
+ */
+const AGENT_METADATA = {
+    [AgentType.ClaudeCode]: {
+        label: 'Claude Code',
+        toolId: 'claude-code',
+        binaryName: 'claude',
+    },
+    [AgentType.Cursor]: { label: 'Cursor Agent', toolId: 'cursor-cli', binaryName: 'cursor-agent' },
+    [AgentType.GeminiCli]: { label: 'Gemini CLI', toolId: 'gemini-cli', binaryName: 'gemini' },
+    [AgentType.CopilotCli]: { label: 'Copilot CLI', toolId: 'copilot-cli', binaryName: 'copilot' },
+    [AgentType.Aider]: { label: 'Aider', toolId: null, binaryName: null },
+    [AgentType.Continue]: { label: 'Continue', toolId: null, binaryName: null },
+    [AgentType.Dev]: { label: 'Demo', toolId: null, binaryName: null },
+};
+const UNKNOWN_RESULT = {
+    agentType: 'unknown',
+    installed: false,
+    authenticated: false,
+    label: 'Unknown',
+    binaryName: null,
+    installCommand: null,
+    authCommand: null,
+};
+let CheckAgentAuthUseCase = class CheckAgentAuthUseCase {
+    listToolsUseCase;
+    authDetector;
+    constructor(listToolsUseCase, authDetector) {
+        this.listToolsUseCase = listToolsUseCase;
+        this.authDetector = authDetector;
+    }
+    async execute() {
+        let agentType;
+        try {
+            agentType = getSettings().agent.type;
+        }
+        catch {
+            return UNKNOWN_RESULT;
+        }
+        const metadata = AGENT_METADATA[agentType];
+        if (!metadata) {
+            return { ...UNKNOWN_RESULT, agentType };
+        }
+        // Agents with no associated tool (dev/demo, aider, continue) — assume ready.
+        if (!metadata.toolId) {
+            return {
+                agentType,
+                installed: true,
+                authenticated: true,
+                label: metadata.label,
+                binaryName: metadata.binaryName,
+                installCommand: null,
+                authCommand: null,
+            };
+        }
+        // Resolve installation status from the tool catalogue.
+        let installed = false;
+        let installCommand = null;
+        try {
+            const tools = await this.listToolsUseCase.execute();
+            const tool = tools.find((t) => t.id === metadata.toolId);
+            installed = tool?.status.status === 'available';
+            installCommand = tool?.installCommand ?? null;
+        }
+        catch {
+            installed = false;
+        }
+        if (!installed) {
+            return {
+                agentType,
+                installed: false,
+                authenticated: false,
+                label: metadata.label,
+                binaryName: metadata.binaryName,
+                installCommand,
+                authCommand: metadata.binaryName ? `Install ${metadata.label} first` : null,
+            };
+        }
+        // Tool is installed — defer credential detection to the platform adapter.
+        const authenticated = await this.authDetector.isAuthenticated(agentType, metadata.binaryName);
+        return {
+            agentType,
+            installed: true,
+            authenticated,
+            label: metadata.label,
+            binaryName: metadata.binaryName,
+            installCommand,
+            authCommand: authenticated ? null : metadata.binaryName,
+        };
+    }
+};
+CheckAgentAuthUseCase = __decorate([
+    injectable(),
+    __param(0, inject(ListToolsUseCase)),
+    __param(1, inject('IAgentAuthDetectorService')),
+    __metadata("design:paramtypes", [ListToolsUseCase, Object])
+], CheckAgentAuthUseCase);
+export { CheckAgentAuthUseCase };

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

@@ -0,0 +1,43 @@
+/**
+ * Create Project Use Case
+ *
+ * Orchestrates "create a new empty project folder under the Shep projects
+ * root". Owns the project naming rules (validation, slugification, length
+ * cap) and the "must not already exist" guard. Delegates filesystem and git
+ * work to IProjectScaffoldService so the application layer remains free of
+ * node:fs / child_process imports.
+ *
+ * Presentation-agnostic: callable from CLI, TUI, and Web identically.
+ */
+import type { IProjectScaffoldService } from '../../ports/output/services/project-scaffold-service.interface.js';
+export interface CreateProjectInput {
+    /** User-supplied project name. Will be slugified for the directory name. */
+    name: string;
+}
+export interface CreateProjectSuccess {
+    ok: true;
+    /** Absolute path to the created folder, normalized to forward slashes. */
+    path: string;
+}
+export interface CreateProjectFailure {
+    ok: false;
+    error: string;
+}
+export type CreateProjectResult = CreateProjectSuccess | CreateProjectFailure;
+/**
+ * Slugify a user-supplied project name into a safe directory name.
+ *
+ * - Lowercases
+ * - Replaces whitespace + invalid chars with `-`
+ * - Strips leading/trailing dashes and dots
+ * - Caps length so we stay well under Windows' 260-char path limit
+ *
+ * Exported for unit testing — production callers should use the use case.
+ */
+export declare function slugifyProjectName(name: string): string;
+export declare class CreateProjectUseCase {
+    private readonly scaffoldService;
+    constructor(scaffoldService: IProjectScaffoldService);
+    execute(input: CreateProjectInput): Promise<CreateProjectResult>;
+}
+//# sourceMappingURL=create-project.use-case.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-project.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/projects/create-project.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mEAAmE,CAAC;AAEjH,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,IAAI,CAAC;IACT,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAE9E;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,EAAE,uBAAuB;IAGrD,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA+BvE"}

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

@@ -0,0 +1,84 @@
+/**
+ * Create Project Use Case
+ *
+ * Orchestrates "create a new empty project folder under the Shep projects
+ * root". Owns the project naming rules (validation, slugification, length
+ * cap) and the "must not already exist" guard. Delegates filesystem and git
+ * work to IProjectScaffoldService so the application layer remains free of
+ * node:fs / child_process imports.
+ *
+ * Presentation-agnostic: callable from CLI, TUI, and Web identically.
+ */
+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';
+/**
+ * Slugify a user-supplied project name into a safe directory name.
+ *
+ * - Lowercases
+ * - Replaces whitespace + invalid chars with `-`
+ * - Strips leading/trailing dashes and dots
+ * - Caps length so we stay well under Windows' 260-char path limit
+ *
+ * Exported for unit testing — production callers should use the use case.
+ */
+export function slugifyProjectName(name) {
+    const cleaned = name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^[-.]+|[-.]+$/g, '');
+    return cleaned.slice(0, 64);
+}
+let CreateProjectUseCase = class CreateProjectUseCase {
+    scaffoldService;
+    constructor(scaffoldService) {
+        this.scaffoldService = scaffoldService;
+    }
+    async execute(input) {
+        const trimmed = input.name.trim();
+        if (!trimmed) {
+            return { ok: false, error: 'Project name is required.' };
+        }
+        const slug = slugifyProjectName(trimmed);
+        if (!slug) {
+            return {
+                ok: false,
+                error: 'Project name must contain at least one letter or number.',
+            };
+        }
+        if (await this.scaffoldService.projectExists(slug)) {
+            return {
+                ok: false,
+                error: `A project named "${slug}" already exists. Pick a different name.`,
+            };
+        }
+        try {
+            const result = await this.scaffoldService.scaffoldProject({ slug });
+            return { ok: true, path: result.path };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: err instanceof Error ? err.message : 'Failed to create project folder.',
+            };
+        }
+    }
+};
+CreateProjectUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IProjectScaffoldService')),
+    __metadata("design:paramtypes", [Object])
+], CreateProjectUseCase);
+export { CreateProjectUseCase };

package/dist/packages/core/src/application/use-cases/repositories/delete-repository.use-case.d.ts

@@ -4,15 +4,26 @@
  * Deletes a Repository and all its child features.
  * Each feature is properly cleaned up (agent runs cancelled, worktrees removed)
  * via DeleteFeatureUseCase before the repository is soft-deleted.
+ *
+ * Optionally removes the repository directory from disk when
+ * {@link DeleteRepositoryOptions.deleteFromDisk} is true. The DB soft-delete
+ * always runs first so the repository disappears from queries even if the
+ * filesystem removal fails.
  */
 import type { IRepositoryRepository } from '../../ports/output/repositories/repository-repository.interface.js';
 import type { IFeatureRepository } from '../../ports/output/repositories/feature-repository.interface.js';
+import type { IFileSystemService } from '../../ports/output/services/file-system-service.interface.js';
 import { DeleteFeatureUseCase } from '../features/delete-feature.use-case.js';
+export interface DeleteRepositoryOptions {
+    /** When true, recursively remove the repository directory from disk. */
+    deleteFromDisk?: boolean;
+}
 export declare class DeleteRepositoryUseCase {
     private readonly repositoryRepo;
     private readonly featureRepo;
     private readonly deleteFeature;
-    constructor(repositoryRepo: IRepositoryRepository, featureRepo: IFeatureRepository, deleteFeature: DeleteFeatureUseCase);
-    execute(id: string): Promise<void>;
+    private readonly fileSystem;
+    constructor(repositoryRepo: IRepositoryRepository, featureRepo: IFeatureRepository, deleteFeature: DeleteFeatureUseCase, fileSystem: IFileSystemService);
+    execute(id: string, options?: DeleteRepositoryOptions): Promise<void>;
 }
 //# sourceMappingURL=delete-repository.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/repositories/delete-repository.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-repository.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/repositories/delete-repository.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oEAAoE,CAAC;AAChH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E,qBACa,uBAAuB;IAGhC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAJb,cAAc,EAAE,qBAAqB,EAErC,WAAW,EAAE,kBAAkB,EAE/B,aAAa,EAAE,oBAAoB;IAGhD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBzC"}
+{"version":3,"file":"delete-repository.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/repositories/delete-repository.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oEAAoE,CAAC;AAChH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8DAA8D,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBACa,uBAAuB;IAGhC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,UAAU;gBANV,cAAc,EAAE,qBAAqB,EAErC,WAAW,EAAE,kBAAkB,EAE/B,aAAa,EAAE,oBAAoB,EAEnC,UAAU,EAAE,kBAAkB;IAG3C,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;CAsB5E"}

package/dist/packages/core/src/application/use-cases/repositories/delete-repository.use-case.js

@@ -4,6 +4,11 @@
  * Deletes a Repository and all its child features.
  * Each feature is properly cleaned up (agent runs cancelled, worktrees removed)
  * via DeleteFeatureUseCase before the repository is soft-deleted.
+ *
+ * Optionally removes the repository directory from disk when
+ * {@link DeleteRepositoryOptions.deleteFromDisk} is true. The DB soft-delete
+ * always runs first so the repository disappears from queries even if the
+ * filesystem removal fails.
  */
 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;
@@ -23,12 +28,14 @@ let DeleteRepositoryUseCase = class DeleteRepositoryUseCase {
     repositoryRepo;
     featureRepo;
     deleteFeature;
-    constructor(repositoryRepo, featureRepo, deleteFeature) {
+    fileSystem;
+    constructor(repositoryRepo, featureRepo, deleteFeature, fileSystem) {
         this.repositoryRepo = repositoryRepo;
         this.featureRepo = featureRepo;
         this.deleteFeature = deleteFeature;
+        this.fileSystem = fileSystem;
     }
-    async execute(id) {
+    async execute(id, options) {
         const repository = await this.repositoryRepo.findById(id);
         if (!repository) {
             throw new Error(`Repository not found: "${id}"`);
@@ -43,6 +50,9 @@ let DeleteRepositoryUseCase = class DeleteRepositoryUseCase {
             await this.deleteFeature.execute(feature.id);
         }
         await this.repositoryRepo.softDelete(id);
+        if (options?.deleteFromDisk) {
+            await this.fileSystem.removeDirectory(repository.path);
+        }
     }
 };
 DeleteRepositoryUseCase = __decorate([
@@ -50,6 +60,7 @@ DeleteRepositoryUseCase = __decorate([
     __param(0, inject('IRepositoryRepository')),
     __param(1, inject('IFeatureRepository')),
     __param(2, inject(DeleteFeatureUseCase)),
-    __metadata("design:paramtypes", [Object, Object, DeleteFeatureUseCase])
+    __param(3, inject('IFileSystemService')),
+    __metadata("design:paramtypes", [Object, Object, DeleteFeatureUseCase, Object])
 ], DeleteRepositoryUseCase);
 export { DeleteRepositoryUseCase };

package/dist/packages/core/src/infrastructure/di/container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/di/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AA2JrC;;;;;;GAMG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,SAAS,CAAC,CA4crE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/di/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAmKrC;;;;;;GAMG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,SAAS,CAAC,CA6drE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/packages/core/src/infrastructure/di/container.js

@@ -21,6 +21,9 @@ import { execFile } from 'node:child_process';
 import { IS_WINDOWS } from '../platform.js';
 import { VersionService } from '../services/version.service.js';
 import { WorktreeService } from '../services/git/worktree.service.js';
+import { FileSystemService } from '../services/file-system.service.js';
+import { FsProjectScaffoldService } from '../services/project-scaffold/fs-project-scaffold.service.js';
+import { PlatformAgentAuthDetectorService } from '../services/agent-auth-detector/platform-agent-auth-detector.service.js';
 import { ToolInstallerServiceImpl } from '../services/tool-installer/tool-installer.service.js';
 import { GitPrService } from '../services/git/git-pr.service.js';
 import { GitForkService } from '../services/git/git-fork.service.js';
@@ -80,6 +83,8 @@ import { ListToolsUseCase } from '../../application/use-cases/tools/list-tools.u
 import { LaunchToolUseCase } from '../../application/use-cases/tools/launch-tool.use-case.js';
 import { LaunchIdeUseCase } from '../../application/use-cases/ide/launch-ide.use-case.js';
 import { AddRepositoryUseCase } from '../../application/use-cases/repositories/add-repository.use-case.js';
+import { CreateProjectUseCase } from '../../application/use-cases/projects/create-project.use-case.js';
+import { CheckAgentAuthUseCase } from '../../application/use-cases/agents/check-agent-auth.use-case.js';
 import { ListRepositoriesUseCase } from '../../application/use-cases/repositories/list-repositories.use-case.js';
 import { DeleteRepositoryUseCase } from '../../application/use-cases/repositories/delete-repository.use-case.js';
 import { ImportGitHubRepositoryUseCase } from '../../application/use-cases/repositories/import-github-repository.use-case.js';
@@ -191,6 +196,9 @@ export async function initializeContainer() {
         },
     });
     container.registerSingleton('IWorktreeService', WorktreeService);
+    container.registerSingleton('IFileSystemService', FileSystemService);
+    container.registerSingleton('IProjectScaffoldService', FsProjectScaffoldService);
+    container.registerSingleton('IAgentAuthDetectorService', PlatformAgentAuthDetectorService);
     container.registerSingleton('ISkillInjectorService', SkillInjectorService);
     container.registerSingleton('IToolInstallerService', ToolInstallerServiceImpl);
     container.registerSingleton('IGitPrService', GitPrService);
@@ -327,6 +335,8 @@ export async function initializeContainer() {
     container.registerSingleton(LaunchToolUseCase);
     container.registerSingleton(LaunchIdeUseCase);
     container.registerSingleton(AddRepositoryUseCase);
+    container.registerSingleton(CreateProjectUseCase);
+    container.registerSingleton(CheckAgentAuthUseCase);
     container.registerSingleton(ListRepositoriesUseCase);
     container.registerSingleton(DeleteRepositoryUseCase);
     container.registerSingleton(ImportGitHubRepositoryUseCase);
@@ -428,6 +438,12 @@ export async function initializeContainer() {
     container.register('AddRepositoryUseCase', {
         useFactory: (c) => c.resolve(AddRepositoryUseCase),
     });
+    container.register('CreateProjectUseCase', {
+        useFactory: (c) => c.resolve(CreateProjectUseCase),
+    });
+    container.register('CheckAgentAuthUseCase', {
+        useFactory: (c) => c.resolve(CheckAgentAuthUseCase),
+    });
     container.register('ListRepositoriesUseCase', {
         useFactory: (c) => c.resolve(ListRepositoriesUseCase),
     });

package/dist/packages/core/src/infrastructure/services/agent-auth-detector/platform-agent-auth-detector.service.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Platform Agent Auth Detector Service
+ *
+ * Concrete adapter for IAgentAuthDetectorService. Detects whether the user
+ * is authenticated with a given AI coding agent using a two-tier strategy:
+ *
+ *   Tier 1 (instant, ~5ms): env vars + credentials file existence + macOS
+ *   Keychain entry. No subprocess.
+ *
+ *   Tier 2 (subprocess, ~200ms): runs the agent's `auth status` subcommand
+ *   when one exists. Skipped for Claude Code (no non-interactive auth
+ *   subcommand — interactive `claude auth status` hangs and gets killed).
+ *
+ * Conservative by design: any detection failure returns false rather than
+ * throwing, so the UI can show "needs auth" instead of crashing.
+ *
+ * Cross-platform: macOS uses Keychain via `security`, Linux/Windows fall
+ * back to the file-based credential location.
+ */
+import { AgentType } from '../../../domain/generated/output.js';
+import type { IAgentAuthDetectorService } from '../../../application/ports/output/services/agent-auth-detector.interface.js';
+export declare class PlatformAgentAuthDetectorService implements IAgentAuthDetectorService {
+    isAuthenticated(agentType: AgentType, binaryName: string | null): Promise<boolean>;
+    /**
+     * Instant credential/env check (~5ms, no subprocess).
+     * Returns true if credentials likely exist for this agent type.
+     */
+    private tier1AuthCheck;
+    /**
+     * Subprocess verification (~200ms). Only called if tier 1 passes, to
+     * confirm tokens aren't expired.
+     */
+    private tier2AuthVerify;
+}
+//# sourceMappingURL=platform-agent-auth-detector.service.d.ts.map