aipanel-cli 0.1.0

package/dist/src/usecases/ConsultUseCase.js

@@ -0,0 +1,187 @@
+import { ResponseNormalizer } from "../compare/ResponseNormalizer.js";
+import { systemClock } from "../shared/clock.js";
+export class ConsultUseCase {
+    sessionManager;
+    runCoordinator;
+    providerRegistry;
+    contextCollector;
+    artifactRepository;
+    responseNormalizer;
+    clock;
+    constructor({ sessionManager, runCoordinator, providerRegistry, contextCollector, artifactRepository, responseNormalizer = new ResponseNormalizer(), clock = systemClock, }) {
+        this.sessionManager = sessionManager;
+        this.runCoordinator = runCoordinator;
+        this.providerRegistry = providerRegistry;
+        this.contextCollector = contextCollector;
+        this.artifactRepository = artifactRepository;
+        this.responseNormalizer = responseNormalizer;
+        this.clock = clock;
+    }
+    async execute(input) {
+        const session = await this.sessionManager.startOrResume({
+            title: input.title ?? input.question.slice(0, 80),
+            ...(input.sessionId ? { sessionId: input.sessionId } : {}),
+        });
+        await this.sessionManager.appendUserTurn(session, input.question);
+        const run = await this.runCoordinator.createRun({
+            sessionId: session.sessionId,
+            command: input.command,
+            mode: "direct",
+        });
+        const rawContext = await this.contextCollector.collect({
+            question: input.question,
+            cwd: input.cwd,
+            ...(input.files ? { files: input.files } : {}),
+            ...(input.diffs ? { diffs: input.diffs } : {}),
+            ...(input.logs ? { logs: input.logs } : {}),
+        });
+        const contextArtifact = await this.artifactRepository.writeJsonArtifact({
+            runId: run.runId,
+            sessionId: session.sessionId,
+            kind: "context-bundle",
+            content: rawContext,
+        });
+        this.runCoordinator.createContextBundle(run, this.#toContextBundleProps(run.runId, rawContext, contextArtifact));
+        run.transition("planned", this.clock.nowIso());
+        await this.runCoordinator.save(run);
+        const prompt = this.#buildPrompt(session.buildTranscript(), input.question, this.contextCollector.formatForPrompt(rawContext));
+        const task = this.runCoordinator.createTask(run, {
+            taskKind: "provider-review",
+            role: input.command === "followup" ? "followup" : "consult",
+            provider: input.providerName,
+            dependsOn: [],
+            status: "queued",
+            input: { prompt },
+        });
+        task.transition("running", this.clock.nowIso());
+        run.transition("running", this.clock.nowIso());
+        await this.runCoordinator.save(run);
+        const adapter = this.providerRegistry.get(input.providerName);
+        const adapterResult = await adapter.call({
+            provider: input.providerName,
+            prompt,
+            cwd: input.cwd,
+            timeoutMs: input.timeoutMs,
+        });
+        const rawJsonArtifact = await this.artifactRepository.writeJsonArtifact({
+            runId: run.runId,
+            sessionId: session.sessionId,
+            kind: "provider-response-json",
+            content: adapterResult.rawJson ?? { rawText: adapterResult.rawText },
+        });
+        const rawTextArtifact = await this.artifactRepository.writeTextArtifact({
+            runId: run.runId,
+            sessionId: session.sessionId,
+            kind: "provider-response-text",
+            content: adapterResult.rawText,
+            extension: ".txt",
+            mimeType: "text/plain",
+        });
+        this.runCoordinator.createProviderResponse(run, {
+            taskId: task.taskId,
+            provider: adapterResult.provider,
+            rawTextRef: rawTextArtifact.path,
+            rawJsonRef: rawJsonArtifact.path,
+            usage: adapterResult.usage ?? null,
+            latencyMs: adapterResult.usage?.latencyMs ?? null,
+            externalRefs: adapterResult.externalRefs ?? [],
+        });
+        const normalizedDraft = this.responseNormalizer.normalize({
+            taskId: task.taskId,
+            providerResponse: {
+                provider: adapterResult.provider,
+                rawText: adapterResult.rawText,
+                citations: adapterResult.citations ?? [],
+                isError: adapterResult.isError ?? false,
+            },
+        });
+        this.runCoordinator.createNormalizedResponse(run, {
+            taskId: task.taskId,
+            provider: adapterResult.provider,
+            summary: normalizedDraft.summary,
+            findings: normalizedDraft.findings,
+            suggestions: normalizedDraft.suggestions,
+            citations: normalizedDraft.citations,
+            confidence: normalizedDraft.confidence,
+        });
+        this.runCoordinator.createTaskResult(run, {
+            taskId: task.taskId,
+            summary: normalizedDraft.summary || adapterResult.rawText,
+            findings: normalizedDraft.findings,
+            citations: normalizedDraft.citations,
+            confidence: normalizedDraft.confidence,
+            sourceArtifactIds: [rawJsonArtifact.artifactId, rawTextArtifact.artifactId],
+        });
+        const isError = adapterResult.isError ?? false;
+        task.transition(isError ? "failed" : "completed", this.clock.nowIso());
+        run.finalSummary = normalizedDraft.summary || adapterResult.rawText;
+        run.validationStatus = isError ? "needs-review" : "validated";
+        run.transition(isError ? "partial" : "completed", this.clock.nowIso());
+        await this.runCoordinator.save(run);
+        const providerRef = this.#extractProviderRef(adapterResult.externalRefs ?? [], adapterResult.provider, input.cwd);
+        if (providerRef) {
+            await this.sessionManager.updateProviderRef(session, providerRef);
+        }
+        await this.sessionManager.appendAssistantTurn(session, adapterResult.rawText, [
+            rawJsonArtifact.artifactId,
+            rawTextArtifact.artifactId,
+        ]);
+        return {
+            kind: "consultation",
+            sessionId: session.sessionId,
+            runId: run.runId,
+            answer: adapterResult.rawText,
+            provider: input.providerName,
+            status: isError ? "partial" : "completed",
+            validationStatus: run.validationStatus ?? "validated",
+        };
+    }
+    #buildPrompt(transcript, question, contextText) {
+        const sections = [
+            "You are Claude Code running under aipanel.",
+            transcript ? `Conversation so far:\n${transcript}` : "",
+            contextText ? `Additional context:\n${contextText}` : "",
+            `Current question:\n${question}`,
+            "Reply with a direct, practical answer. If there are risks or assumptions, state them explicitly.",
+        ].filter(Boolean);
+        return sections.join("\n\n");
+    }
+    #toContextBundleProps(runId, rawContext, contextArtifact) {
+        return {
+            runId,
+            summary: rawContext.summary,
+            files: rawContext.files.map((file) => ({
+                path: file.path,
+                purpose: file.purpose,
+                checksum: file.checksum,
+            })),
+            diffs: rawContext.diffs.map((diff) => ({
+                path: diff.path,
+                summary: diff.summary,
+            })),
+            logs: rawContext.logs.map((log) => ({
+                path: log.path,
+                source: log.source,
+                capturedAt: log.capturedAt,
+            })),
+            metadata: {
+                ...rawContext.metadata,
+                artifactId: contextArtifact.artifactId,
+                artifactPath: contextArtifact.path,
+            },
+        };
+    }
+    #extractProviderRef(externalRefs, provider, cwd) {
+        const sessionRef = externalRefs.find((ref) => ref.scope === "session");
+        if (!sessionRef) {
+            return null;
+        }
+        return {
+            provider,
+            providerSessionId: sessionRef.id,
+            workingDirectory: cwd,
+            lastUsedAt: this.clock.nowIso(),
+        };
+    }
+}
+//# sourceMappingURL=ConsultUseCase.js.map

package/dist/src/usecases/ConsultUseCase.js.map

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

package/dist/src/usecases/DebugUseCase.d.ts

@@ -0,0 +1,48 @@
+import { ComparisonEngine } from "../compare/ComparisonEngine.js";
+import { ResponseNormalizer } from "../compare/ResponseNormalizer.js";
+import type { ContextCollector } from "../context/ContextCollector.js";
+import type { ArtifactRepository } from "../artifact/ArtifactRepository.js";
+import type { ProviderRegistry } from "../providers/ProviderRegistry.js";
+import type { RunCoordinator } from "../run/RunCoordinator.js";
+import type { SessionManager } from "../session/SessionManager.js";
+import { systemClock } from "../shared/clock.js";
+export interface DebugResult {
+    kind: "debug";
+    sessionId: string;
+    runId: string;
+    summary: string;
+    details: string[];
+    status: "completed" | "partial";
+}
+export declare class DebugUseCase {
+    #private;
+    readonly sessionManager: SessionManager;
+    readonly runCoordinator: RunCoordinator;
+    readonly providerRegistry: ProviderRegistry;
+    readonly contextCollector: ContextCollector;
+    readonly artifactRepository: ArtifactRepository;
+    readonly responseNormalizer: ResponseNormalizer;
+    readonly comparisonEngine: ComparisonEngine;
+    readonly clock: typeof systemClock;
+    constructor({ sessionManager, runCoordinator, providerRegistry, contextCollector, artifactRepository, responseNormalizer, comparisonEngine, clock, }: {
+        sessionManager: SessionManager;
+        runCoordinator: RunCoordinator;
+        providerRegistry: ProviderRegistry;
+        contextCollector: ContextCollector;
+        artifactRepository: ArtifactRepository;
+        responseNormalizer?: ResponseNormalizer;
+        comparisonEngine?: ComparisonEngine;
+        clock?: typeof systemClock;
+    });
+    execute({ question, sessionId, title, files, diffs, logs, providerName, timeoutMs, cwd, }: {
+        question: string;
+        sessionId?: string;
+        title?: string;
+        files?: string[];
+        diffs?: string[];
+        logs?: string[];
+        providerName: string;
+        timeoutMs: number;
+        cwd: string;
+    }): Promise<DebugResult>;
+}

package/dist/src/usecases/DebugUseCase.js

@@ -0,0 +1,191 @@
+import { ComparisonEngine } from "../compare/ComparisonEngine.js";
+import { ResponseNormalizer } from "../compare/ResponseNormalizer.js";
+import { systemClock } from "../shared/clock.js";
+const DEBUG_TASKS = [
+    { role: "planner", label: "root-cause", instruction: "Analyze the most likely root cause." },
+    { role: "reviewer", label: "evidence", instruction: "List the strongest evidence, logs, or code paths supporting the diagnosis." },
+    { role: "validator", label: "fix-plan", instruction: "Propose the safest next steps or fixes and call out regression risks." },
+];
+export class DebugUseCase {
+    sessionManager;
+    runCoordinator;
+    providerRegistry;
+    contextCollector;
+    artifactRepository;
+    responseNormalizer;
+    comparisonEngine;
+    clock;
+    constructor({ sessionManager, runCoordinator, providerRegistry, contextCollector, artifactRepository, responseNormalizer = new ResponseNormalizer(), comparisonEngine = new ComparisonEngine(), clock = systemClock, }) {
+        this.sessionManager = sessionManager;
+        this.runCoordinator = runCoordinator;
+        this.providerRegistry = providerRegistry;
+        this.contextCollector = contextCollector;
+        this.artifactRepository = artifactRepository;
+        this.responseNormalizer = responseNormalizer;
+        this.comparisonEngine = comparisonEngine;
+        this.clock = clock;
+    }
+    async execute({ question, sessionId, title, files = [], diffs = [], logs = [], providerName, timeoutMs, cwd, }) {
+        const session = await this.sessionManager.startOrResume({
+            title: title ?? `Debug: ${question.slice(0, 60)}`,
+            ...(sessionId ? { sessionId } : {}),
+        });
+        await this.sessionManager.appendUserTurn(session, question);
+        const run = await this.runCoordinator.createRun({
+            sessionId: session.sessionId,
+            command: "debug",
+            mode: "orchestrated",
+        });
+        const rawContext = await this.contextCollector.collect({
+            question,
+            cwd,
+            ...(files.length > 0 ? { files } : {}),
+            ...(diffs.length > 0 ? { diffs } : {}),
+            ...(logs.length > 0 ? { logs } : {}),
+        });
+        const contextArtifact = await this.artifactRepository.writeJsonArtifact({
+            runId: run.runId,
+            sessionId: session.sessionId,
+            kind: "context-bundle",
+            content: rawContext,
+        });
+        this.runCoordinator.createContextBundle(run, this.#toContextBundleProps(run.runId, rawContext, contextArtifact));
+        run.transition("planned", this.clock.nowIso());
+        await this.runCoordinator.save(run);
+        const adapter = this.providerRegistry.get(providerName);
+        const contextText = this.contextCollector.formatForPrompt(rawContext);
+        const normalizedResponses = [];
+        const details = [];
+        let hasError = false;
+        for (const taskSpec of DEBUG_TASKS) {
+            const prompt = [
+                "You are Claude Code running under aipanel debug orchestrated mode.",
+                `Task focus: ${taskSpec.instruction}`,
+                contextText ? `Context:\n${contextText}` : "",
+                `Debug question:\n${question}`,
+                "Reply concisely with findings, evidence, and actionable next steps when relevant.",
+            ]
+                .filter(Boolean)
+                .join("\n\n");
+            const task = this.runCoordinator.createTask(run, {
+                taskKind: "provider-review",
+                role: taskSpec.role,
+                provider: providerName,
+                dependsOn: [],
+                status: "queued",
+                input: { prompt, label: taskSpec.label },
+            });
+            task.transition("running", this.clock.nowIso());
+            run.transition("running", this.clock.nowIso());
+            await this.runCoordinator.save(run);
+            const providerCall = await adapter.call({
+                provider: providerName,
+                prompt,
+                cwd,
+                timeoutMs,
+            });
+            hasError ||= providerCall.isError ?? false;
+            const jsonArtifact = await this.artifactRepository.writeJsonArtifact({
+                runId: run.runId,
+                sessionId: session.sessionId,
+                kind: "debug-task-output-json",
+                content: providerCall.rawJson ?? { rawText: providerCall.rawText },
+            });
+            const textArtifact = await this.artifactRepository.writeTextArtifact({
+                runId: run.runId,
+                sessionId: session.sessionId,
+                kind: "debug-task-output-text",
+                content: providerCall.rawText,
+                extension: ".txt",
+                mimeType: "text/plain",
+            });
+            this.runCoordinator.createProviderResponse(run, {
+                taskId: task.taskId,
+                provider: providerName,
+                rawTextRef: textArtifact.path,
+                rawJsonRef: jsonArtifact.path,
+                usage: providerCall.usage ?? null,
+                latencyMs: providerCall.usage?.latencyMs ?? null,
+                externalRefs: providerCall.externalRefs ?? [],
+            });
+            const normalized = this.responseNormalizer.normalize({
+                taskId: task.taskId,
+                providerResponse: {
+                    provider: providerName,
+                    rawText: providerCall.rawText,
+                    citations: providerCall.citations ?? [],
+                    isError: providerCall.isError ?? false,
+                },
+            });
+            const normalizedEntity = this.runCoordinator.createNormalizedResponse(run, {
+                taskId: task.taskId,
+                provider: providerName,
+                summary: normalized.summary,
+                findings: normalized.findings,
+                suggestions: normalized.suggestions,
+                citations: normalized.citations,
+                confidence: normalized.confidence,
+            });
+            normalizedResponses.push(normalized);
+            this.runCoordinator.createTaskResult(run, {
+                taskId: task.taskId,
+                summary: normalized.summary || providerCall.rawText,
+                findings: normalized.findings,
+                citations: normalized.citations,
+                confidence: normalized.confidence,
+                sourceArtifactIds: [jsonArtifact.artifactId, textArtifact.artifactId],
+            });
+            task.transition(providerCall.isError ? "failed" : "completed", this.clock.nowIso());
+            await this.runCoordinator.save(run);
+            details.push(`[${taskSpec.label}] ${providerCall.rawText}`);
+        }
+        const reportDraft = this.comparisonEngine.compare(question, normalizedResponses);
+        this.runCoordinator.createComparisonReport(run, {
+            topic: question,
+            responseIds: reportDraft.responseIds,
+            agreements: reportDraft.agreements,
+            differences: reportDraft.differences,
+            recommendation: reportDraft.recommendation,
+        });
+        const recommendation = reportDraft.recommendation ?? "No recommendation available.";
+        run.finalSummary = recommendation;
+        run.validationStatus = hasError ? "needs-review" : "validated";
+        run.transition(hasError ? "partial" : "completed", this.clock.nowIso());
+        await this.runCoordinator.save(run);
+        await this.sessionManager.appendAssistantTurn(session, details.join("\n\n"));
+        return {
+            kind: "debug",
+            sessionId: session.sessionId,
+            runId: run.runId,
+            summary: recommendation,
+            details,
+            status: hasError ? "partial" : "completed",
+        };
+    }
+    #toContextBundleProps(runId, rawContext, contextArtifact) {
+        return {
+            runId,
+            summary: rawContext.summary,
+            files: rawContext.files.map((file) => ({
+                path: file.path,
+                purpose: file.purpose,
+                checksum: file.checksum,
+            })),
+            diffs: rawContext.diffs.map((diff) => ({
+                path: diff.path,
+                summary: diff.summary,
+            })),
+            logs: rawContext.logs.map((log) => ({
+                path: log.path,
+                source: log.source,
+                capturedAt: log.capturedAt,
+            })),
+            metadata: {
+                ...rawContext.metadata,
+                artifactId: contextArtifact.artifactId,
+                artifactPath: contextArtifact.path,
+            },
+        };
+    }
+}
+//# sourceMappingURL=DebugUseCase.js.map

package/dist/src/usecases/DebugUseCase.js.map

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

package/dist/src/usecases/FollowupUseCase.d.ts

@@ -0,0 +1,6 @@
+import { ConsultUseCase, type ConsultationResult } from "./ConsultUseCase.js";
+export declare class FollowupUseCase {
+    readonly consultUseCase: ConsultUseCase;
+    constructor(consultUseCase: ConsultUseCase);
+    execute(input: Omit<Parameters<ConsultUseCase["execute"]>[0], "command">): Promise<ConsultationResult>;
+}

package/dist/src/usecases/FollowupUseCase.js

@@ -0,0 +1,14 @@
+import { ConsultUseCase } from "./ConsultUseCase.js";
+export class FollowupUseCase {
+    consultUseCase;
+    constructor(consultUseCase) {
+        this.consultUseCase = consultUseCase;
+    }
+    async execute(input) {
+        return this.consultUseCase.execute({
+            ...input,
+            command: "followup",
+        });
+    }
+}
+//# sourceMappingURL=FollowupUseCase.js.map

package/dist/src/usecases/FollowupUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FollowupUseCase.js","sourceRoot":"","sources":["../../../src/usecases/FollowupUseCase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA2B,MAAM,qBAAqB,CAAC;AAE9E,MAAM,OAAO,eAAe;IACjB,cAAc,CAAiB;IAExC,YAAY,cAA8B;QACxC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAgE;QAC5E,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;YACjC,GAAG,KAAK;YACR,OAAO,EAAE,UAAU;SACpB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/src/usecases/ListProvidersUseCase.d.ts

@@ -0,0 +1,9 @@
+import type { ProviderRegistry } from "../providers/ProviderRegistry.js";
+export declare class ListProvidersUseCase {
+    readonly providerRegistry: ProviderRegistry;
+    constructor(providerRegistry: ProviderRegistry);
+    execute(): Promise<{
+        kind: "providers";
+        providers: string[];
+    }>;
+}

package/dist/src/usecases/ListProvidersUseCase.js

@@ -0,0 +1,13 @@
+export class ListProvidersUseCase {
+    providerRegistry;
+    constructor(providerRegistry) {
+        this.providerRegistry = providerRegistry;
+    }
+    async execute() {
+        return {
+            kind: "providers",
+            providers: this.providerRegistry.list(),
+        };
+    }
+}
+//# sourceMappingURL=ListProvidersUseCase.js.map

package/dist/src/usecases/ListProvidersUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListProvidersUseCase.js","sourceRoot":"","sources":["../../../src/usecases/ListProvidersUseCase.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,oBAAoB;IACtB,gBAAgB,CAAmB;IAE5C,YAAY,gBAAkC;QAC5C,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO;YACL,IAAI,EAAE,WAAoB;YAC1B,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE;SACxC,CAAC;IACJ,CAAC;CACF"}

package/dist/src/usecases/helpers.d.ts

@@ -0,0 +1,9 @@
+import type { ContextBundleData, SessionData } from "../shared/contracts.js";
+export declare function buildSessionTitle(question: string): string;
+export declare function buildConversationTranscript(session: SessionData): string;
+export declare function buildPromptWithTranscript(input: {
+    session: SessionData;
+    question: string;
+    contextBundle: ContextBundleData;
+    modeLabel: string;
+}): string;

package/dist/src/usecases/helpers.js

@@ -0,0 +1,31 @@
+function compact(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+export function buildSessionTitle(question) {
+    const normalized = compact(question);
+    return normalized.slice(0, 60) || "Untitled session";
+}
+export function buildConversationTranscript(session) {
+    return session.turns
+        .map((turn) => `${turn.role.toUpperCase()}: ${turn.content}`)
+        .join("\n\n");
+}
+export function buildPromptWithTranscript(input) {
+    const transcript = buildConversationTranscript(input.session);
+    const contextSections = [
+        input.contextBundle.summary,
+        ...(input.contextBundle.files ?? []).map((file) => `File: ${file.path}\n${file.content ?? ""}`),
+        ...(input.contextBundle.diffs ?? []).map((diff) => `Diff: ${diff.path}\n${diff.content ?? ""}`),
+        ...(input.contextBundle.logs ?? []).map((log) => `Log: ${log.path}\n${log.content ?? ""}`),
+    ].filter(Boolean);
+    return [
+        `Mode: ${input.modeLabel}`,
+        transcript ? `Conversation so far:\n${transcript}` : "",
+        `New user question:\n${input.question.trim()}`,
+        contextSections.length > 0 ? `Context:\n${contextSections.join("\n\n")}` : "",
+        "Answer in a concise but useful way. Prefer concrete next steps.",
+    ]
+        .filter(Boolean)
+        .join("\n\n");
+}
+//# sourceMappingURL=helpers.js.map

package/dist/src/usecases/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/usecases/helpers.ts"],"names":[],"mappings":"AAEA,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,kBAAkB,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAoB;IAC9D,OAAO,OAAO,CAAC,KAAK;SACjB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;SAC5D,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAKzC;IACC,MAAM,UAAU,GAAG,2BAA2B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9D,MAAM,eAAe,GAAG;QACtB,KAAK,CAAC,aAAa,CAAC,OAAO;QAC3B,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC/F,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC/F,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;KAC3F,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,OAAO;QACL,SAAS,KAAK,CAAC,SAAS,EAAE;QAC1B,UAAU,CAAC,CAAC,CAAC,yBAAyB,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE;QACvD,uBAAuB,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE;QAC9C,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAC7E,iEAAiE;KAClE;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}

package/dist/src/usecases/index.d.ts

@@ -0,0 +1,5 @@
+export { CompareUseCase } from "./CompareUseCase.js";
+export { ConsultUseCase } from "./ConsultUseCase.js";
+export { DebugUseCase } from "./DebugUseCase.js";
+export { FollowupUseCase } from "./FollowupUseCase.js";
+export { ListProvidersUseCase } from "./ListProvidersUseCase.js";

package/dist/src/usecases/index.js

@@ -0,0 +1,6 @@
+export { CompareUseCase } from "./CompareUseCase.js";
+export { ConsultUseCase } from "./ConsultUseCase.js";
+export { DebugUseCase } from "./DebugUseCase.js";
+export { FollowupUseCase } from "./FollowupUseCase.js";
+export { ListProvidersUseCase } from "./ListProvidersUseCase.js";
+//# sourceMappingURL=index.js.map

package/dist/src/usecases/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/usecases/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "aipanel-cli",
+  "version": "0.1.0",
+  "description": "CLI broker and orchestrator for consult, followup, and debug workflows with Claude Code.",
+  "private": false,
+  "license": "MIT",
+  "keywords": [
+    "cli",
+    "claude-code",
+    "broker",
+    "orchestrator",
+    "debugging"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sean-sunagaku/aipanel.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sean-sunagaku/aipanel/issues"
+  },
+  "homepage": "https://github.com/sean-sunagaku/aipanel#readme",
+  "type": "module",
+  "bin": {
+    "aipanel": "dist/bin/aipanel.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "node scripts/clean-dist.mjs",
+    "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "render:diagrams": "node scripts/architecture/render-diagram-bundle.mjs docs/rearchitecture/content_rearchitecture_2026-03-10/12_current-implementation-diagrams/source/current-implementation-diagrams.spec.json docs/rearchitecture/content_rearchitecture_2026-03-10/12_current-implementation-diagrams",
+    "pack:dry-run": "npm pack --dry-run",
+    "verify:package": "node scripts/verify-package-install.mjs",
+    "publish:check": "npm run typecheck && npm test && npm run pack:dry-run && npm run verify:package",
+    "publish:public": "npm run publish:check && npm publish --access public",
+    "prepack": "npm run build",
+    "test:unit": "tsx --test test/unit/**/*.test.ts",
+    "test:integration": "npm run build && tsx --test test/integration/**/*.test.ts",
+    "test:e2e": "npm run build && tsx --test test/e2e/**/*.test.ts",
+    "test": "npm run test:unit && npm run test:integration && npm run test:e2e"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0"
+  }
+}