@cjhyy/code-shell 0.3.0 → 0.5.0-rc.1

package/dist/arena/providers/index.d.ts

@@ -1,32 +0,0 @@
-/**
- * Provider registry — evidence collectors for Arena.
- */
-import type { ArenaPlan, ArenaArtifact, ArenaSourceKind, ArenaQuickFact } from "../types.js";
-export { gitProvider } from "./git.js";
-export { repoProvider } from "./repo.js";
-export { docsProvider } from "./docs.js";
-export { noneProvider } from "./none.js";
-export interface CollectEvidenceOptions {
-    /** Heartbeat callback fired before/after each provider runs. */
-    onProgress?: (event: {
-        type: "evidence_started" | "evidence_collected";
-        source: ArenaSourceKind;
-        count?: number;
-        durationMs?: number;
-        timedOut?: boolean;
-    }) => void;
-    signal?: AbortSignal;
-}
-/**
- * Collect all evidence according to the plan's sources.
- * Returns unified ArenaArtifact[] and quickFacts.
- *
- * Providers run in parallel (independent of one another) with a
- * per-provider timeout, so a single slow source can't stall the
- * whole arena. Heartbeats are emitted around each provider so the
- * UI can show "collecting from repo..." instead of a blank pause.
- */
-export declare function collectEvidence(plan: ArenaPlan, topic: string, options?: CollectEvidenceOptions): Promise<{
-    artifacts: ArenaArtifact[];
-    quickFacts: ArenaQuickFact[];
-}>;

package/dist/arena/providers/none.d.ts

@@ -1,7 +0,0 @@
-/**
- * NoneProvider — returns no external evidence.
- * Used for pure topic discussions, brainstorming, or debates
- * where no external context is needed.
- */
-import type { ArenaContextProvider } from "../types.js";
-export declare const noneProvider: ArenaContextProvider;

package/dist/arena/providers/repo.d.ts

@@ -1,6 +0,0 @@
-/**
- * RepoProvider — collects evidence from the code repository:
- * directory trees, key files, grep results.
- */
-import type { ArenaContextProvider } from "../types.js";
-export declare const repoProvider: ArenaContextProvider;

package/dist/arena/render/session.d.ts

@@ -1,17 +0,0 @@
-/**
- * Session renderer — formats ArenaResultV2 into markdown suitable for
- * displaying as assistant_text and as context for follow-up LLM turns.
- *
- * Scene-aware output order:
- *   1. Subject Summary — factual framing / what changed / current scope
- *   2. Overall assessment
- *   3. Roadmap (planning-first when present)
- *   4. Consensus sections ordered by output emphasis
- *   5. Next Actions
- *   6. Per-participant findings (collapsed)
- */
-import type { ArenaResultV2 } from "../types.js";
-/**
- * Format an ArenaResultV2 into markdown text.
- */
-export declare function formatArenaResultForSession(result: ArenaResultV2): string;

package/dist/arena/render/terminal.d.ts

@@ -1,33 +0,0 @@
-/**
- * Terminal renderer — renders ArenaConsensus and ArenaResultV2.
- *
- * All render functions return strings instead of printing directly,
- * so callers can decide where to display (ctx.addStatus vs console.log).
- *
- * Output sections:
- * 1. Summary
- * 2. Roadmap (surfaced early for planning scenes)
- * 3. Consensus sections ordered by output emphasis
- * 4. Next Actions
- */
-import type { ArenaResultV2, ArenaProgressEvent } from "../types.js";
-/** Output sink — callers provide this to control where text goes. */
-export type OutputSink = (text: string) => void;
-/**
- * Format the full arena result as a styled string.
- */
-export declare function formatArenaResult(result: ArenaResultV2): string;
-/**
- * Print the full arena result directly to stdout.
- * Used by the CLI `code-shell arena` command (non-REPL).
- */
-export declare function printArenaResult(result: ArenaResultV2): void;
-/**
- * Create a progress renderer that sends output to a sink.
- * For REPL: pass ctx.addStatus. For CLI: pass console.log.
- */
-export declare function createProgressRenderer(sink: OutputSink): (event: ArenaProgressEvent) => void;
-/**
- * Legacy: direct console.log progress renderer for CLI mode.
- */
-export declare function renderProgress(event: ArenaProgressEvent): void;

package/dist/arena/strategies/discussion.d.ts

@@ -1,25 +0,0 @@
-/**
- * Discussion strategy — open-ended debate with structured findings.
- *
- * V2: focuses on trade-offs, competing viewpoints, and evidence-backed arguments.
- */
-import type { ArenaStrategyV2, ArenaBaseContext, ParticipantReport, FindingReview, ArenaConsensus, FindingKind, ClaimRecord, ClaimChallenge, ClaimAdjudication, ClaimStatusSummary, DebateTurn, DebateRound, RoundResearchDigest } from "../types.js";
-export declare class DiscussionStrategy implements ArenaStrategyV2 {
-    researchSystemPrompt(name: string): string;
-    researchUserPrompt(topic: string, baseContext: ArenaBaseContext): string;
-    parseResearchResponse(participant: string, text: string): ParticipantReport;
-    crossReviewSystemPrompt(reviewerName: string): string;
-    crossReviewUserPrompt(topic: string, myReport: ParticipantReport, otherReports: ParticipantReport[]): string;
-    parseCrossReviewResponse(reviewer: string, text: string): FindingReview[];
-    consensusSystemPrompt(): string;
-    consensusUserPrompt(topic: string, reports: ParticipantReport[], reviews: FindingReview[]): string;
-    parseConsensusResponse(text: string): ArenaConsensus;
-    preferredFindingKinds(): FindingKind[];
-    verificationReviewUserPrompt(topic: string, myReport: ParticipantReport, claimsToReview: ClaimRecord[], digest: RoundResearchDigest): string;
-    parseVerificationReviewResponse(reviewer: string, text: string): ClaimChallenge[];
-    debateTurnUserPrompt(topic: string, claim: ClaimRecord, priorTurns: DebateTurn[], digest: RoundResearchDigest): string;
-    parseDebateTurnResponse(participant: string, text: string): DebateTurn;
-    adjudicationUserPrompt(topic: string, claim: ClaimRecord, debateRounds: DebateRound[], digest: RoundResearchDigest): string;
-    parseAdjudicationResponse(text: string): ClaimAdjudication;
-    claimAwareConsensusUserPrompt(topic: string, reports: ParticipantReport[], reviews: FindingReview[], claimSummary: ClaimStatusSummary): string;
-}

package/dist/arena/strategies/index.d.ts

@@ -1,15 +0,0 @@
-/**
- * Arena strategies — mode-specific behavior for the arena orchestration loop.
- */
-export { ReviewStrategy } from "./review.js";
-export { DiscussionStrategy } from "./discussion.js";
-export { PlanningStrategy } from "./planning.js";
-export { withLens } from "./lens-wrapper.js";
-import type { ArenaMode, ArenaStrategy, ArenaPlan } from "../types.js";
-/** Get the default strategy for a given arena mode. */
-export declare function getStrategy(mode: ArenaMode): ArenaStrategy;
-/**
- * Get a strategy for a plan — mode strategy + lens wrapper.
- * This is the new evidence-driven entry point.
- */
-export declare function getStrategyForPlan(plan: ArenaPlan): ArenaStrategy;

package/dist/arena/strategies/language-wrapper.d.ts

@@ -1,17 +0,0 @@
-/**
- * Language-aware strategy wrapper.
- *
- * Detects the language of the user's query and injects a language instruction
- * into all strategy system prompts so the arena output matches the query language.
- */
-import type { ArenaStrategy } from "../types.js";
-/**
- * Detect whether the topic is primarily non-English.
- * Returns a language instruction string, or empty if English.
- */
-export declare function detectLanguageInstruction(topic: string): string;
-/**
- * Wrap a strategy to inject language instructions into all system prompts.
- * If the topic is English, returns the original strategy unchanged.
- */
-export declare function withLanguage(strategy: ArenaStrategy, topic: string): ArenaStrategy;

package/dist/arena/strategies/lens-wrapper.d.ts

@@ -1,16 +0,0 @@
-/**
- * Lens-aware strategy wrapper.
- *
- * Composes a mode strategy with lens-specific prompts:
- *   systemPrompt = modeStrategy.systemPrompt() + lensPrompt + toolGuidance
- *
- * This achieves the separation described in the architecture doc:
- * - Strategy (mode) → how to collaborate
- * - Lens → from what perspective
- */
-import type { ArenaStrategy, ArenaPlan } from "../types.js";
-/**
- * Wrap a strategy to inject lens-specific role and criteria prompts.
- * If no plan is provided, returns the original strategy unchanged.
- */
-export declare function withLens(strategy: ArenaStrategy, plan: ArenaPlan): ArenaStrategy;

package/dist/arena/strategies/planning.d.ts

@@ -1,30 +0,0 @@
-/**
- * Planning strategy — collaborative roadmap building with structured findings.
- *
- * V2: focuses on implementation phases, dependencies, risks, and open questions.
- */
-import type { ArenaStrategyPlanning, ArenaBaseContext, ParticipantReport, FindingReview, ArenaConsensus, FindingKind, ClaimRecord, ClaimChallenge, ClaimAdjudication, ClaimStatusSummary, DebateTurn, DebateRound, RoundResearchDigest, ArenaRoadmapPhase, ArenaRoadmapPhaseDetail } from "../types.js";
-export declare class PlanningStrategy implements ArenaStrategyPlanning {
-    researchSystemPrompt(name: string): string;
-    researchUserPrompt(topic: string, baseContext: ArenaBaseContext): string;
-    parseResearchResponse(participant: string, text: string): ParticipantReport;
-    crossReviewSystemPrompt(reviewerName: string): string;
-    crossReviewUserPrompt(topic: string, myReport: ParticipantReport, otherReports: ParticipantReport[]): string;
-    parseCrossReviewResponse(reviewer: string, text: string): FindingReview[];
-    consensusSystemPrompt(): string;
-    consensusUserPrompt(topic: string, reports: ParticipantReport[], reviews: FindingReview[]): string;
-    parseConsensusResponse(text: string): ArenaConsensus;
-    preferredFindingKinds(): FindingKind[];
-    verificationReviewUserPrompt(topic: string, myReport: ParticipantReport, claimsToReview: ClaimRecord[], digest: RoundResearchDigest): string;
-    parseVerificationReviewResponse(reviewer: string, text: string): ClaimChallenge[];
-    debateTurnUserPrompt(topic: string, claim: ClaimRecord, priorTurns: DebateTurn[], digest: RoundResearchDigest): string;
-    parseDebateTurnResponse(participant: string, text: string): DebateTurn;
-    adjudicationUserPrompt(topic: string, claim: ClaimRecord, debateRounds: DebateRound[], digest: RoundResearchDigest): string;
-    parseAdjudicationResponse(text: string): ClaimAdjudication;
-    mergeReviewUserPrompt(topic: string, myReport: ParticipantReport, claimsToReview: ClaimRecord[], digest: RoundResearchDigest): string;
-    parseMergeReviewResponse(reviewer: string, text: string): ClaimChallenge[];
-    detailExpansionSystemPrompt(): string;
-    detailExpansionUserPrompt(topic: string, phase: ArenaRoadmapPhase, digest: RoundResearchDigest): string;
-    parseDetailExpansionResponse(text: string): ArenaRoadmapPhaseDetail;
-    claimAwareConsensusUserPrompt(topic: string, reports: ParticipantReport[], reviews: FindingReview[], claimSummary: ClaimStatusSummary): string;
-}

package/dist/arena/strategies/review.d.ts

@@ -1,26 +0,0 @@
-/**
- * Review strategy — structured code review with findings.
- *
- * V2: produces ArenaFinding[] (strength/improvement/risk/question)
- * instead of free-text opinions.
- */
-import type { ArenaStrategyV2, ArenaBaseContext, ParticipantReport, FindingReview, ArenaConsensus, FindingKind, ClaimRecord, ClaimChallenge, ClaimAdjudication, ClaimStatusSummary, DebateTurn, DebateRound, RoundResearchDigest } from "../types.js";
-export declare class ReviewStrategy implements ArenaStrategyV2 {
-    researchSystemPrompt(name: string): string;
-    researchUserPrompt(topic: string, baseContext: ArenaBaseContext): string;
-    parseResearchResponse(participant: string, text: string): ParticipantReport;
-    crossReviewSystemPrompt(reviewerName: string): string;
-    crossReviewUserPrompt(topic: string, myReport: ParticipantReport, otherReports: ParticipantReport[]): string;
-    parseCrossReviewResponse(reviewer: string, text: string): FindingReview[];
-    consensusSystemPrompt(): string;
-    consensusUserPrompt(topic: string, reports: ParticipantReport[], reviews: FindingReview[]): string;
-    parseConsensusResponse(text: string): ArenaConsensus;
-    preferredFindingKinds(): FindingKind[];
-    verificationReviewUserPrompt(topic: string, myReport: ParticipantReport, claimsToReview: ClaimRecord[], digest: RoundResearchDigest): string;
-    parseVerificationReviewResponse(reviewer: string, text: string): ClaimChallenge[];
-    debateTurnUserPrompt(topic: string, claim: ClaimRecord, priorTurns: DebateTurn[], digest: RoundResearchDigest): string;
-    parseDebateTurnResponse(participant: string, text: string): DebateTurn;
-    adjudicationUserPrompt(topic: string, claim: ClaimRecord, debateRounds: DebateRound[], digest: RoundResearchDigest): string;
-    parseAdjudicationResponse(text: string): ClaimAdjudication;
-    claimAwareConsensusUserPrompt(topic: string, reports: ParticipantReport[], reviews: FindingReview[], claimSummary: ClaimStatusSummary): string;
-}

package/dist/arena/strategies/utils.d.ts

@@ -1,39 +0,0 @@
-/** Shared utilities for arena strategy implementations. */
-import type { ArenaBaseContext, FindingReview, ParticipantReport, ArenaConsensus, ArenaRoadmapPhaseDetail, ClaimRecord, ClaimChallenge, ClaimAdjudication, ClaimStatusSummary, DebateTurn, RoundResearchDigest } from "../types.js";
-/** Extract JSON from text that might have markdown fences or surrounding text */
-export declare function extractJSON(text: string): string;
-/** Extract a JSON array from text */
-export declare function extractJSONArray(text: string): string;
-/** Format base context into a readable text block for LLM prompts */
-export declare function formatBaseContext(ctx: ArenaBaseContext): string;
-/** Format participant reports for cross-review or consensus prompts */
-export declare function formatReports(reports: ParticipantReport[]): string;
-/** Format finding reviews for consensus prompts */
-export declare function formatFindingReviews(reviews: FindingReview[]): string;
-/**
- * Parse a ParticipantReport. The research prompt now asks for an
- * XML <report> element because thinking-mode models (DeepSeek V4)
- * produced malformed JSON often enough to derail the loop. We try
- * XML first, then JSON, then a free-text salvage.
- */
-export declare function parseReport(participant: string, text: string): ParticipantReport;
-/** Parse FindingReview[] from LLM JSON output */
-export declare function parseReviews(reviewer: string, text: string): FindingReview[];
-/** Parse ArenaConsensus from LLM JSON output */
-export declare function parseConsensus(text: string): ArenaConsensus;
-/** Format claims for verification-review prompts */
-export declare function formatClaimsForReview(claims: ClaimRecord[]): string;
-/** Format debate history for debate turn prompts */
-export declare function formatDebateHistory(turns: DebateTurn[]): string;
-/** Format claim status summary for consensus prompts */
-export declare function formatClaimSummaryForConsensus(summary: ClaimStatusSummary): string;
-/** Format a digest text block for inclusion in prompts */
-export declare function formatDigestForPrompt(digest: RoundResearchDigest): string;
-/** Parse ClaimChallenge[] from LLM JSON output */
-export declare function parseChallenges(reviewer: string, text: string): ClaimChallenge[];
-/** Parse a DebateTurn from LLM JSON output */
-export declare function parseDebateTurn(participant: string, text: string): DebateTurn;
-/** Parse a ClaimAdjudication from LLM JSON output */
-export declare function parseAdjudication(claimId: string, text: string): ClaimAdjudication;
-/** Parse an ArenaRoadmapPhaseDetail from LLM JSON output */
-export declare function parseDetailExpansion(text: string): ArenaRoadmapPhaseDetail;

package/dist/arena/tools/selector.d.ts

@@ -1,17 +0,0 @@
-/**
- * ArenaToolSelector — selects tool packs based on ArenaPlan sources.
- *
- * Maps evidence sources to subsets of the existing context tools.
- * This replaces the hard-coded "always give all tools" approach.
- */
-import type { ArenaPlan } from "../types.js";
-import type { ToolDefinition } from "../../types.js";
-/**
- * Select the appropriate tools for a given plan.
- * Merges tool packs from all active sources, deduplicating by name.
- */
-export declare function selectTools(plan: ArenaPlan): ToolDefinition[];
-/**
- * Check whether any tools are available for the plan.
- */
-export declare function hasTools(plan: ArenaPlan): boolean;

package/dist/arena/transitions.d.ts

@@ -1,48 +0,0 @@
-/**
- * Claim state machine — centralized transition rules.
- *
- * All claim status changes go through this module to enforce
- * consistent state transitions across phases.
- *
- * State machine:
- *   proposed → under_review
- *   under_review → verified | contested | rejected
- *   contested → under_review | unresolved | verified | rejected
- */
-import type { ClaimRecord, ClaimStatus, ClaimChallenge } from "./types.js";
-/**
- * Attempt to transition a claim to a new status.
- * Returns true if the transition was applied, false if invalid.
- */
-export declare function transitionClaim(claim: ClaimRecord, to: ClaimStatus): boolean;
-/**
- * Determine the next status for a claim based on its challenges.
- *
- * Rules:
- * - No challenges → stays as-is (unreviewed is NOT verified)
- * - Any "disagree" → contested
- * - Any "needs_evidence" → contested
- * - Pending checks exist → contested
- * - At least one explicit "agree" and all others "agree"/"refine" → verified
- */
-export declare function resolveClaimStatus(claim: ClaimRecord, challenges: ClaimChallenge[], hasPendingChecks: boolean): ClaimStatus;
-/**
- * Mark a claim as entering review.
- */
-export declare function markUnderReview(claim: ClaimRecord): boolean;
-/**
- * Apply review results to a claim and transition appropriately.
- */
-export declare function applyReviewResult(claim: ClaimRecord, challenges: ClaimChallenge[], hasPendingChecks: boolean): void;
-/**
- * Mark a contested claim as unresolved (budget/round exhausted).
- */
-export declare function markUnresolved(claim: ClaimRecord): boolean;
-/**
- * Check if a claim is in a terminal state (no further transitions possible).
- */
-export declare function isTerminal(claim: ClaimRecord): boolean;
-/**
- * Get valid next statuses for a claim.
- */
-export declare function validTransitions(claim: ClaimRecord): ClaimStatus[];