rafcode 3.0.0 → 3.8.0

package/dist/types/config.d.ts

@@ -1,10 +1,10 @@
-/** CLI harness provider */
-export type HarnessProvider = 'claude' | 'codex';
+/** CLI harness name */
+export type HarnessName = 'claude' | 'codex';
 /** Short alias for a Claude model family */
 export type ClaudeModelAlias = 'sonnet' | 'haiku' | 'opus';
 /** Short alias for a Codex model family */
-export type CodexModelAlias = 'spark' | 'codex' | 'gpt54';
-/** Provider-agnostic model alias (union of all provider aliases) */
+export type CodexModelAlias = 'codex' | 'gpt54';
+/** Harness-agnostic model alias (union of all harness aliases) */
 export type ModelAlias = ClaudeModelAlias | CodexModelAlias;
 /**
  * Accepts short aliases (`sonnet`, `haiku`, `opus`) or full model IDs
@@ -14,7 +14,7 @@ export type ModelAlias = ClaudeModelAlias | CodexModelAlias;
 export type ClaudeModelName = ClaudeModelAlias | (string & {
     __brand?: 'FullModelId';
 });
-/** Provider-agnostic model name — accepts any alias, full ID, or harness-prefixed format */
+/** Harness-agnostic model name — accepts any alias, full ID, or harness-prefixed format */
 export type ModelName = string & {
     __brand?: 'ModelName';
 };
@@ -22,22 +22,36 @@ export type ModelName = string & {
 export type TaskEffortLevel = 'low' | 'medium' | 'high';
 export type ModelScenario = 'plan' | 'execute' | 'nameGeneration' | 'failureAnalysis' | 'prGeneration' | 'config';
 export type CommitFormatType = 'task' | 'plan' | 'amend';
+/**
+ * A harness-aware model configuration entry.
+ * Stores model, harness, and optional reasoning effort together.
+ */
+export interface ModelEntry {
+    /** Model name: short alias (opus, sonnet, gpt-5.4) or full ID */
+    model: string;
+    /** Which CLI harness to use for this entry */
+    harness: HarnessName;
+    /** Optional reasoning effort hint. Codex accepts: "none", "minimal", "low", "medium", "high", "xhigh" */
+    reasoningEffort?: string;
+    /** Enable fast mode for faster output (Claude only). Default: false/omitted. */
+    fast?: boolean;
+}
 export interface ModelsConfig {
-    plan: ClaudeModelName;
-    execute: ClaudeModelName;
-    nameGeneration: ClaudeModelName;
-    failureAnalysis: ClaudeModelName;
-    prGeneration: ClaudeModelName;
-    config: ClaudeModelName;
+    plan: ModelEntry;
+    execute: ModelEntry;
+    nameGeneration: ModelEntry;
+    failureAnalysis: ModelEntry;
+    prGeneration: ModelEntry;
+    config: ModelEntry;
 }
 /**
- * Maps task complexity labels to model names.
+ * Maps task complexity labels to harness-aware model entries.
  * Used to resolve per-task effort frontmatter to a model.
  */
 export interface EffortMappingConfig {
-    low: ClaudeModelName;
-    medium: ClaudeModelName;
-    high: ClaudeModelName;
+    low: ModelEntry;
+    medium: ModelEntry;
+    high: ModelEntry;
 }
 export interface CommitFormatConfig {
     task: string;
@@ -51,15 +65,9 @@ export interface DisplayConfig {
     showCacheTokens: boolean;
 }
 export interface RafConfig {
-    /** CLI harness provider. Default: 'claude' */
-    provider: HarnessProvider;
     models: ModelsConfig;
-    /** Maps task complexity labels (low/medium/high) to models. Used for per-task effort frontmatter. */
+    /** Maps task complexity labels (low/medium/high) to model entries. Used for per-task effort frontmatter. */
     effortMapping: EffortMappingConfig;
-    /** Codex model assignments per scenario */
-    codexModels: ModelsConfig;
-    /** Maps task complexity labels to Codex models */
-    codexEffortMapping: EffortMappingConfig;
     timeout: number;
     maxRetries: number;
     autoCommit: boolean;
@@ -77,7 +85,7 @@ export type DeepPartial<T> = {
 export type UserConfig = DeepPartial<RafConfig>;
 export declare const VALID_MODEL_ALIASES: readonly ClaudeModelAlias[];
 export declare const VALID_CODEX_MODEL_ALIASES: readonly CodexModelAlias[];
-export declare const VALID_HARNESS_PROVIDERS: readonly HarnessProvider[];
+export declare const VALID_HARNESSES: readonly HarnessName[];
 /**
  * Regex for full Claude model IDs (e.g., `claude-sonnet-4-5-20250929`, `claude-opus-4-5-20251101`).
  * Pattern: claude-{family}-{major}(-{minor})?(-{date})?
@@ -95,19 +103,12 @@ export declare const DEFAULT_RAF_CONFIG: {
 };
 export interface PlanCommandOptions {
     projectName?: string;
-    model?: ClaudeModelName;
-    sonnet?: boolean;
-    provider?: HarnessProvider;
 }
 export interface DoCommandOptions {
     timeout?: number;
     verbose?: boolean;
     debug?: boolean;
     force?: boolean;
-    model?: ClaudeModelName;
-    sonnet?: boolean;
-    worktree?: boolean;
-    provider?: HarnessProvider;
 }
 export interface StatusCommandOptions {
     json?: boolean;
@@ -119,7 +120,7 @@ export interface ModelTokenUsage {
     cacheReadInputTokens: number;
     cacheCreationInputTokens: number;
     /** Cost in USD for this model's usage (provided by Claude CLI). */
-    costUsd: number;
+    costUsd?: number | null;
 }
 /** Token usage data extracted from Claude CLI stream-json result event. */
 export interface UsageData {
@@ -131,6 +132,6 @@ export interface UsageData {
     /** Per-model breakdown (e.g., { "claude-opus-4-6": { ... } }). */
     modelUsage: Record<string, ModelTokenUsage>;
     /** Total cost in USD for this usage (provided by Claude CLI). */
-    totalCostUsd: number;
+    totalCostUsd: number | null;
 }
 //# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

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

package/dist/types/config.js

@@ -1,30 +1,16 @@
 export const DEFAULT_CONFIG = {
-    provider: 'claude',
     models: {
-        plan: 'opus',
-        execute: 'opus',
-        nameGeneration: 'sonnet',
-        failureAnalysis: 'haiku',
-        prGeneration: 'sonnet',
-        config: 'sonnet',
+        plan: { model: 'opus', harness: 'claude' },
+        execute: { model: 'opus', harness: 'claude' },
+        nameGeneration: { model: 'sonnet', harness: 'claude' },
+        failureAnalysis: { model: 'haiku', harness: 'claude' },
+        prGeneration: { model: 'sonnet', harness: 'claude' },
+        config: { model: 'sonnet', harness: 'claude' },
     },
     effortMapping: {
-        low: 'sonnet',
-        medium: 'opus',
-        high: 'opus',
-    },
-    codexModels: {
-        plan: 'gpt-5.3-codex',
-        execute: 'gpt-5.4',
-        nameGeneration: 'gpt-5.3-codex-spark',
-        failureAnalysis: 'gpt-5.3-codex-spark',
-        prGeneration: 'gpt-5.3-codex',
-        config: 'gpt-5.3-codex',
-    },
-    codexEffortMapping: {
-        low: 'gpt-5.3-codex-spark',
-        medium: 'gpt-5.3-codex',
-        high: 'gpt-5.4',
+        low: { model: 'sonnet', harness: 'claude' },
+        medium: { model: 'opus', harness: 'claude' },
+        high: { model: 'opus', harness: 'claude' },
     },
     timeout: 60,
     maxRetries: 3,
@@ -32,9 +18,9 @@ export const DEFAULT_CONFIG = {
     worktree: false,
     syncMainBranch: true,
     commitFormat: {
-        task: '{prefix}[{projectId}:{taskId}] {description}',
-        plan: '{prefix}[{projectId}] Plan: {projectName}',
-        amend: '{prefix}[{projectId}] Amend: {projectName}',
+        task: '{prefix}[{projectName}:{taskId}] {description}',
+        plan: '{prefix}[{projectName}] Plan: {description}',
+        amend: '{prefix}[{projectName}] Amend: {description}',
         prefix: 'RAF',
     },
     display: {
@@ -42,8 +28,8 @@ export const DEFAULT_CONFIG = {
     },
 };
 export const VALID_MODEL_ALIASES = ['sonnet', 'haiku', 'opus'];
-export const VALID_CODEX_MODEL_ALIASES = ['spark', 'codex', 'gpt54'];
-export const VALID_HARNESS_PROVIDERS = ['claude', 'codex'];
+export const VALID_CODEX_MODEL_ALIASES = ['codex', 'gpt54'];
+export const VALID_HARNESSES = ['claude', 'codex'];
 /**
  * Regex for full Claude model IDs (e.g., `claude-sonnet-4-5-20250929`, `claude-opus-4-5-20251101`).
  * Pattern: claude-{family}-{major}(-{minor})?(-{date})?

package/dist/types/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAgFA,MAAM,CAAC,MAAM,cAAc,GAAc;IACvC,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,MAAM;QACf,cAAc,EAAE,QAAQ;QACxB,eAAe,EAAE,OAAO;QACxB,YAAY,EAAE,QAAQ;QACtB,MAAM,EAAE,QAAQ;KACjB;IACD,aAAa,EAAE;QACb,GAAG,EAAE,QAAQ;QACb,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,MAAM;KACb;IACD,WAAW,EAAE;QACX,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,SAAS;QAClB,cAAc,EAAE,qBAAqB;QACrC,eAAe,EAAE,qBAAqB;QACtC,YAAY,EAAE,eAAe;QAC7B,MAAM,EAAE,eAAe;KACxB;IACD,kBAAkB,EAAE;QAClB,GAAG,EAAE,qBAAqB;QAC1B,MAAM,EAAE,eAAe;QACvB,IAAI,EAAE,SAAS;KAChB;IACD,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,KAAK;IACf,cAAc,EAAE,IAAI;IACpB,YAAY,EAAE;QACZ,IAAI,EAAE,8CAA8C;QACpD,IAAI,EAAE,2CAA2C;QACjD,KAAK,EAAE,4CAA4C;QACnD,MAAM,EAAE,KAAK;KACd;IACD,OAAO,EAAE;QACP,eAAe,EAAE,IAAI;KACtB;CACF,CAAC;AASF,MAAM,CAAC,MAAM,mBAAmB,GAAgC,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAE5F,MAAM,CAAC,MAAM,yBAAyB,GAA+B,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAEjG,MAAM,CAAC,MAAM,uBAAuB,GAA+B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAEvF;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAElE,kDAAkD;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEhD,qDAAqD;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAA+B,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAExF,qDAAqD;AACrD,6CAA6C;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,cAAc,EAAE,cAAc,CAAC,OAAO;IACtC,iBAAiB,EAAE,cAAc,CAAC,UAAU;IAC5C,UAAU,EAAE,cAAc,CAAC,UAAU;CACtC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAyFA,MAAM,CAAC,MAAM,cAAc,GAAc;IACvC,MAAM,EAAE;QACN,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE;QAC1C,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE;QAC7C,cAAc,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;QACtD,eAAe,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE;QACtD,YAAY,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;QACpD,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;KAC/C;IACD,aAAa,EAAE;QACb,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;QAC3C,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE;QAC5C,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE;KAC3C;IACD,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,KAAK;IACf,cAAc,EAAE,IAAI;IACpB,YAAY,EAAE;QACZ,IAAI,EAAE,gDAAgD;QACtD,IAAI,EAAE,6CAA6C;QACnD,KAAK,EAAE,8CAA8C;QACrD,MAAM,EAAE,KAAK;KACd;IACD,OAAO,EAAE;QACP,eAAe,EAAE,IAAI;KACtB;CACF,CAAC;AASF,MAAM,CAAC,MAAM,mBAAmB,GAAgC,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAE5F,MAAM,CAAC,MAAM,yBAAyB,GAA+B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,eAAe,GAA2B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAE3E;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAElE,kDAAkD;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEhD,qDAAqD;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAA+B,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAExF,qDAAqD;AACrD,6CAA6C;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,cAAc,EAAE,cAAc,CAAC,OAAO;IACtC,iBAAiB,EAAE,cAAc,CAAC,UAAU;IAC5C,UAAU,EAAE,cAAc,CAAC,UAAU;CACtC,CAAC"}

package/dist/utils/config.d.ts

@@ -1,4 +1,4 @@
-import { RafConfig, UserConfig, ClaudeModelName, TaskEffortLevel, ModelScenario, CommitFormatType, DisplayConfig, EffortMappingConfig, HarnessProvider } from '../types/config.js';
+import { RafConfig, UserConfig, TaskEffortLevel, ModelScenario, ModelEntry, CommitFormatType, DisplayConfig, EffortMappingConfig, HarnessName } from '../types/config.js';
 export declare function getConfigPath(): string;
 /**
  * Get the path to Claude CLI settings file.
@@ -12,22 +12,23 @@ export declare class ConfigValidationError extends Error {
  * Accepts:
  * - Claude short aliases: sonnet, haiku, opus
  * - Claude full IDs: claude-opus-4-6
- * - Codex short aliases: spark, codex, gpt54
- * - Raw Codex model IDs: gpt-5.4, gpt-5.3-codex-spark
+ * - Codex short aliases: codex, gpt54
+ * - Raw Codex model IDs: gpt-5.4, gpt-5.3-codex
  * - Harness-prefixed format: claude/opus, codex/gpt-5.4
  */
 export declare function isValidModelName(value: string): boolean;
 /**
- * Parse a model spec string into its provider and model components.
- * - `codex/gpt-5.4` -> { provider: 'codex', model: 'gpt-5.4' }
- * - `claude/opus` -> { provider: 'claude', model: 'opus' }
- * - `opus` -> { provider: 'claude', model: 'opus' } (defaults to claude)
- * - `gpt-5.4` -> { provider: 'codex', model: 'gpt-5.4' } (inferred from model format)
+ * Parse a model spec string into its harness and model components.
+ * - `codex/gpt-5.4` -> { harness: 'codex', model: 'gpt-5.4' }
+ * - `claude/opus` -> { harness: 'claude', model: 'opus' }
+ * - `opus` -> { harness: 'claude', model: 'opus' } (defaults to claude)
+ * - `gpt-5.4` -> { harness: 'codex', model: 'gpt-5.4' } (inferred from model format)
  */
 export declare function parseModelSpec(modelSpec: string): {
-    provider: HarnessProvider;
+    harness: HarnessName;
     model: string;
 };
+export declare function collectConfigValidationWarnings(config: UserConfig): string[];
 export declare function validateConfig(config: unknown): UserConfig;
 /**
  * Resolve the final config by loading from ~/.raf/raf.config.json and merging with defaults.
@@ -49,15 +50,18 @@ export declare function saveConfig(configPath: string, config: UserConfig): void
  */
 export declare function getResolvedConfig(): RafConfig;
 export declare function resetConfigCache(): void;
-export declare function getModel(scenario: ModelScenario, provider?: HarnessProvider): ClaudeModelName;
+/**
+ * Get the model entry for a scenario.
+ */
+export declare function getModel(scenario: ModelScenario): ModelEntry;
 /**
  * Get the full effort mapping config.
  */
-export declare function getEffortMapping(provider?: HarnessProvider): EffortMappingConfig;
+export declare function getEffortMapping(): EffortMappingConfig;
 /**
- * Resolve a task effort level to a model name using the effort mapping config.
+ * Resolve a task effort level to a model entry using the effort mapping config.
  */
-export declare function resolveEffortToModel(effort: TaskEffortLevel, provider?: HarnessProvider): ClaudeModelName;
+export declare function resolveEffortToModel(effort: TaskEffortLevel): ModelEntry;
 /**
  * Get the numeric tier of a model for comparison.
  * Extracts family from full model IDs (e.g., 'claude-opus-4-6' -> 3).
@@ -65,10 +69,11 @@ export declare function resolveEffortToModel(effort: TaskEffortLevel, provider?:
  */
 export declare function getModelTier(modelName: string): number;
 /**
- * Apply ceiling to a model based on the configured models.execute ceiling.
- * Returns the lower-tier model between the input and the ceiling.
+ * Apply ceiling to a model entry based on the configured models.execute ceiling.
+ * Returns the lower-tier entry between the input and the ceiling.
+ * When the input exceeds the ceiling, the ceiling entry is returned (including its harness).
  */
-export declare function applyModelCeiling(resolvedModel: string, ceiling?: string): string;
+export declare function applyModelCeiling(resolved: ModelEntry, ceiling?: ModelEntry): ModelEntry;
 export declare function getCommitFormat(type: CommitFormatType): string;
 export declare function getCommitPrefix(): string;
 export declare function getTimeout(): number;
@@ -82,6 +87,20 @@ export declare function getSyncMainBranch(): boolean;
  * Returns the original string if no known alias can be extracted.
  */
 export declare function getModelShortName(modelId: string): string;
+/**
+ * Get the centralized user-facing display label for a model.
+ * Keeps concise Claude labels, while normalizing compact aliases like gpt54 -> gpt-5.4.
+ */
+export declare function getModelDisplayName(modelId: string): string;
+interface ModelDisplayOptions {
+    includeHarness?: boolean;
+    fullId?: boolean;
+}
+/**
+ * Format a model label for user-facing logs.
+ * Defaults to the centralized display policy, or can opt into explicit full-ID display.
+ */
+export declare function formatModelDisplay(model: string, harness?: HarnessName, options?: ModelDisplayOptions): string;
 /**
  * Resolve a model name to its full model ID.
  * If already a full model ID, returns as-is.
@@ -115,4 +134,5 @@ export declare function getConfig(): {
     maxRetries: number;
     autoCommit: boolean;
 };
+export {};
 //# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

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