@gajae-code/coding-agent 0.1.3 → 0.2.1

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-05-30
+
+### Fixed
+
+- Added a `gjc skills` inspection command so installed binaries can list and read embedded workflow skills from any project without relying on source-tree `.gjc` files.
+- Fixed first-run API provider onboarding so `models.yml` parent directories are created before writing, and malformed `/provicer` startup invocations now report the intended `/provider add` spelling instead of falling through to model bootstrap.
+
+## [0.2.0] - 2026-05-28
+
+### Added
+
+- Added scoped GJC tmux profile handling for `gjc --tmux` and `gjc team` sessions without mutating global tmux configuration.
+- Added GJC team integration hardening for worker turn-end integration requests, auto-rebase/auto-merge conflict surfacing, protected checkpoint classification, and leader/worker-visible integration summaries.
+- Added Node 20 release baseline validation to the release/check surface.
+
+### Changed
+
+- Clarified the public workflow contract so `deep-interview` and `ralplan` are invoked through `/skill:<name>`, while `gjc ultragoal` and `gjc team` remain native runtime commands.
+- Updated the README hero image and Discord community invite.
+
+### Fixed
+
+- Restored Ultragoal completion receipt export/generation validation and completion gates.
+- Fixed workflow bridge guidance and tests so private compatibility bridge commands are not advertised as public skill-loading paths.
+
 ## [0.1.3] - 2026-05-28
 
 ### Changed

package/dist/types/cli/skills-cli.d.ts

@@ -0,0 +1,9 @@
+export type SkillsAction = "list" | "read";
+export interface SkillsCommandArgs {
+    action: SkillsAction;
+    name?: string;
+    flags?: {
+        json?: boolean;
+    };
+}
+export declare function runSkillsCommand(cmd: SkillsCommandArgs): Promise<void>;

package/dist/types/commands/gjc-runtime-bridge.d.ts

@@ -1,6 +1,30 @@
+import { type WorkflowHudSummary } from "../skill-state/active-state";
+export declare const WORKFLOW_HUD_PROTOCOL = "workflow-hud-summary-v1";
 export interface GjcRuntimeBridgeResult {
     status: number;
     error?: string;
 }
+export interface WorkflowHudBridgePayload {
+    version: 1;
+    skill: string;
+    phase?: string;
+    active?: boolean;
+    session_id?: string;
+    thread_id?: string;
+    turn_id?: string;
+    hud: WorkflowHudSummary;
+}
+export interface GjcRuntimeHudBridgeResult extends GjcRuntimeBridgeResult {
+    hudPayload?: WorkflowHudBridgePayload;
+}
+export interface GjcRuntimeHudBridgeOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    sidecarSkill: string;
+    onHudPayload?: (payload: WorkflowHudBridgePayload) => Promise<void> | void;
+    pollIntervalMs?: number;
+}
+export declare function normalizeWorkflowHudBridgePayload(raw: unknown, expectedSkill: string): WorkflowHudBridgePayload | null;
 export declare function runGjcRuntimeBridge(endpoint: string, args: string[], env?: NodeJS.ProcessEnv): GjcRuntimeBridgeResult;
+export declare function runGjcRuntimeBridgeWithHudSidecar(endpoint: string, args: string[], options: GjcRuntimeHudBridgeOptions): Promise<GjcRuntimeHudBridgeResult>;
 export declare function runBridgedRuntimeEndpoint(endpoint: string, args: string[]): Promise<void>;

package/dist/types/commands/skills.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Inspect bundled workflow skills.
+ */
+import { Command } from "@gajae-code/utils/cli";
+import { type SkillsAction } from "../cli/skills-cli";
+export default class Skills extends Command {
+    static description: string;
+    static args: {
+        action: import("@gajae-code/utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            options: SkillsAction[];
+        };
+        name: import("@gajae-code/utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+        };
+    };
+    static flags: {
+        json: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/types/config/model-registry.d.ts

@@ -1,4 +1,4 @@
-import { type Api, type AssistantMessageEventStream, type Context, type Model, type ModelRefreshStrategy, type SimpleStreamOptions, type ThinkingConfig } from "@gajae-code/ai";
+import { type Api, type AssistantMessageEventStream, type Context, type Model, type ModelRefreshStrategy, type ModelRequestTransform, type SimpleStreamOptions, type ThinkingConfig } from "@gajae-code/ai";
 import type { OAuthCredentials, OAuthLoginCallbacks } from "@gajae-code/ai/utils/oauth/types";
 import { type ThemeColor } from "../modes/theme/theme";
 import type { AuthStorage } from "../session/auth-storage";
@@ -88,6 +88,12 @@ export declare const ModelsConfigFile: ConfigFile<{
         discovery?: {
             type: "llama.cpp" | "lm-studio" | "ollama" | "openai-models-list";
         } | undefined;
+        requestTransform?: {
+            profile?: "openai-proxy" | undefined;
+            stripHeaders?: string[] | undefined;
+            setHeaders?: Record<string, string | null> | undefined;
+            extraBody?: Record<string, unknown> | undefined;
+        } | undefined;
         models?: {
             id: string;
             name?: string | undefined;
@@ -151,6 +157,13 @@ export declare const ModelsConfigFile: ConfigFile<{
                 toolStrictMode?: "all_strict" | "none" | undefined;
             } | undefined;
             contextPromotionTarget?: string | undefined;
+            wireModelId?: string | undefined;
+            requestTransform?: {
+                profile?: "openai-proxy" | undefined;
+                stripHeaders?: string[] | undefined;
+                setHeaders?: Record<string, string | null> | undefined;
+                extraBody?: Record<string, unknown> | undefined;
+            } | undefined;
         }[] | undefined;
         modelOverrides?: Record<string, {
             name?: string | undefined;
@@ -212,10 +225,21 @@ export declare const ModelsConfigFile: ConfigFile<{
                 toolStrictMode?: "all_strict" | "none" | undefined;
             } | undefined;
             contextPromotionTarget?: string | undefined;
+            wireModelId?: string | undefined;
+            requestTransform?: {
+                profile?: "openai-proxy" | undefined;
+                stripHeaders?: string[] | undefined;
+                setHeaders?: Record<string, string | null> | undefined;
+                extraBody?: Record<string, unknown> | undefined;
+            } | undefined;
         }> | undefined;
         disableStrictTools?: boolean | undefined;
         transport?: "pi-native" | undefined;
     }> | undefined;
+    modelBindings?: {
+        modelRoles?: Record<string, string> | undefined;
+        agentModelOverrides?: Record<string, string> | undefined;
+    } | undefined;
     equivalence?: {
         overrides?: Record<string, string> | undefined;
         exclude?: string[] | undefined;
@@ -229,6 +253,7 @@ interface ProviderOverride {
     authHeader?: boolean;
     compat?: Model<Api>["compat"];
     transport?: Model<Api>["transport"];
+    requestTransform?: ModelRequestTransform;
 }
 /**
  * Merge a freshly discovered model with the matching bundled/configured entry
@@ -246,7 +271,7 @@ interface ProviderOverride {
  * See `xiaomi-tp-discovery-merge.test.ts` and the `refresh()` baseUrl-override
  * regression in `model-registry.test.ts`.
  */
-export declare function mergeDiscoveredModel<TApi extends Api>(model: Model<TApi>, existing: Model<Api> | undefined, providerOverride?: Pick<ProviderOverride, "baseUrl" | "headers" | "transport">): Model<TApi>;
+export declare function mergeDiscoveredModel<TApi extends Api>(model: Model<TApi>, existing: Model<Api> | undefined, providerOverride?: Pick<ProviderOverride, "baseUrl" | "headers" | "transport" | "requestTransform">): Model<TApi>;
 export type ProviderDiscoveryStatus = "idle" | "ok" | "empty" | "cached" | "unavailable" | "unauthenticated";
 export interface ProviderDiscoveryState {
     provider: string;
@@ -281,6 +306,7 @@ export declare class ModelRegistry {
      * Get any error from loading models.json (undefined if no error).
      */
     getError(): ConfigError | undefined;
+    applyConfiguredModelBindings(targetSettings: Settings): void;
     /**
      * Get all models (built-in + custom).
      * If models.json had errors, returns only built-in models.
@@ -364,6 +390,7 @@ export interface ProviderConfigInput {
     streamSimple?: (model: Model<Api>, context: Context, options?: SimpleStreamOptions) => AssistantMessageEventStream;
     headers?: Record<string, string>;
     compat?: Model<Api>["compat"];
+    requestTransform?: ModelRequestTransform;
     authHeader?: boolean;
     /** Streaming transport override — see {@link Model.transport}. */
     transport?: Model<Api>["transport"];
@@ -392,6 +419,8 @@ export interface ProviderConfigInput {
         maxTokens: number;
         headers?: Record<string, string>;
         compat?: Model<Api>["compat"];
+        requestTransform?: ModelRequestTransform;
+        wireModelId?: string;
         contextPromotionTarget?: string;
         premiumMultiplier?: number;
     }>;

package/dist/types/config/models-config-schema.d.ts

@@ -162,6 +162,15 @@ export declare const ModelOverrideSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     contextPromotionTarget: z.ZodOptional<z.ZodString>;
+    wireModelId: z.ZodOptional<z.ZodString>;
+    requestTransform: z.ZodOptional<z.ZodObject<{
+        profile: z.ZodOptional<z.ZodEnum<{
+            "openai-proxy": "openai-proxy";
+        }>>;
+        stripHeaders: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
+        extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ModelOverride = z.infer<typeof ModelOverrideSchema>;
 export declare const ProviderDiscoverySchema: z.ZodObject<{
@@ -262,6 +271,14 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 "openai-models-list": "openai-models-list";
             }>;
         }, z.core.$strip>>;
+        requestTransform: z.ZodOptional<z.ZodObject<{
+            profile: z.ZodOptional<z.ZodEnum<{
+                "openai-proxy": "openai-proxy";
+            }>>;
+            stripHeaders: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
+            extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
         models: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodOptional<z.ZodString>;
@@ -382,6 +399,15 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 }>>;
             }, z.core.$strip>>;
             contextPromotionTarget: z.ZodOptional<z.ZodString>;
+            wireModelId: z.ZodOptional<z.ZodString>;
+            requestTransform: z.ZodOptional<z.ZodObject<{
+                profile: z.ZodOptional<z.ZodEnum<{
+                    "openai-proxy": "openai-proxy";
+                }>>;
+                stripHeaders: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
+                extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>>;
         modelOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
@@ -492,10 +518,23 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 }>>;
             }, z.core.$strip>>;
             contextPromotionTarget: z.ZodOptional<z.ZodString>;
+            wireModelId: z.ZodOptional<z.ZodString>;
+            requestTransform: z.ZodOptional<z.ZodObject<{
+                profile: z.ZodOptional<z.ZodEnum<{
+                    "openai-proxy": "openai-proxy";
+                }>>;
+                stripHeaders: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
+                extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>>;
         disableStrictTools: z.ZodOptional<z.ZodBoolean>;
         transport: z.ZodOptional<z.ZodLiteral<"pi-native">>;
     }, z.core.$strip>>>;
+    modelBindings: z.ZodOptional<z.ZodObject<{
+        modelRoles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        agentModelOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
     equivalence: z.ZodOptional<z.ZodObject<{
         overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/types/gjc-runtime/launch-tmux.d.ts

@@ -3,6 +3,8 @@ export declare const GJC_DEFAULT_TMUX_SESSION = "gajae_code";
 export declare const GJC_TMUX_LAUNCHED_ENV = "GJC_TMUX_LAUNCHED";
 export declare const GJC_LAUNCH_POLICY_ENV = "GJC_LAUNCH_POLICY";
 export declare const GJC_TMUX_COMMAND_ENV = "GJC_TMUX_COMMAND";
+export declare const GJC_TMUX_PROFILE_ENV = "GJC_TMUX_PROFILE";
+export declare const GJC_TMUX_MOUSE_ENV = "GJC_MOUSE";
 interface TtyState {
     stdin: boolean;
     stdout: boolean;
@@ -40,6 +42,27 @@ export interface TmuxLaunchPlan {
     newSessionArgs: string[];
     attachSessionArgs: string[];
 }
+export interface GjcTmuxProfileCommand {
+    description: string;
+    args: string[];
+}
+export interface GjcTmuxProfileResult {
+    skipped: boolean;
+    commands: GjcTmuxProfileCommand[];
+    failures: Array<{
+        command: GjcTmuxProfileCommand;
+        stderr?: string;
+    }>;
+}
+export interface GjcTmuxProfileContext {
+    tmuxCommand: string;
+    target: string;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    spawnSync?: TmuxSpawnSync;
+}
+export declare function buildGjcTmuxProfileCommands(target: string, env?: NodeJS.ProcessEnv): GjcTmuxProfileCommand[];
+export declare function applyGjcTmuxProfile(context: GjcTmuxProfileContext): GjcTmuxProfileResult;
 export declare function buildDefaultTmuxLaunchPlan(context: TmuxLaunchContext): TmuxLaunchPlan | undefined;
 export declare function launchDefaultTmuxIfNeeded(context: TmuxLaunchContext): boolean;
 export {};

package/dist/types/gjc-runtime/team-runtime.d.ts

@@ -1,3 +1,4 @@
+import type { WorkflowHudSummary } from "../skill-state/active-state";
 export type GjcTeamPhase = "starting" | "running" | "complete" | "failed" | "cancelled";
 export type GjcTeamTaskStatus = "pending" | "blocked" | "in_progress" | "completed" | "failed";
 export type GjcWorkerStatusState = "idle" | "working" | "blocked" | "done" | "failed" | "draining" | "unknown";
@@ -143,7 +144,7 @@ export interface GjcTeamMailboxMessage {
 export declare function resolveGjcTeamWorkerCli(env?: NodeJS.ProcessEnv): GjcTeamWorkerCli;
 export declare function resolveGjcTeamWorkerCliPlan(workerCount: number, env?: NodeJS.ProcessEnv): GjcTeamWorkerCli[];
 export declare function translateGjcWorkerLaunchArgsForCli(workerCli: GjcTeamWorkerCli, args: string[]): string[];
-interface GjcTeamEvent {
+export interface GjcTeamEvent {
     event_id: string;
     ts: string;
     type: string;
@@ -164,12 +165,45 @@ interface WorkerHeartbeatFile {
     turn_count: number;
     alive: boolean;
 }
+export interface GjcWorkerIntegrationAttemptRequestResult {
+    requested: boolean;
+    reason: "requested" | "not_worker" | "missing_worktree" | "no_changes" | "deduped" | "git_error";
+    worker?: string;
+    team_name?: string;
+    fingerprint?: string;
+    head?: string | null;
+    status?: GjcWorkerCheckpointClassification["kind"];
+}
 export declare const GJC_TEAM_API_OPERATIONS: readonly ["send-message", "broadcast", "mailbox-list", "mailbox-mark-delivered", "mailbox-mark-notified", "create-task", "read-task", "list-tasks", "update-task", "claim-task", "transition-task-status", "transition-task", "release-task-claim", "read-config", "read-manifest", "read-worker-status", "read-worker-heartbeat", "update-worker-heartbeat", "write-worker-inbox", "write-worker-identity", "append-event", "read-events", "await-event", "write-shutdown-request", "read-shutdown-ack", "read-monitor-snapshot", "write-monitor-snapshot", "read-task-approval", "write-task-approval"];
 export declare function resolveGjcTeamStateRoot(cwd?: string, env?: NodeJS.ProcessEnv): string;
 export declare function resolveGjcTmuxCommand(env?: NodeJS.ProcessEnv): string;
 export declare function resolveGjcWorkerCommand(cwd?: string, env?: NodeJS.ProcessEnv): string;
+export type GjcWorkerCheckpointClassification = {
+    kind: "clean";
+    files: string[];
+} | {
+    kind: "eligible";
+    files: string[];
+} | {
+    kind: "protected_only";
+    files: string[];
+} | {
+    kind: "conflicted";
+    files: string[];
+} | {
+    kind: "git_error";
+    files: string[];
+    detail: string;
+};
+export declare function classifyGjcTeamCheckpointFiles(files: string[]): {
+    eligible: string[];
+    protected: string[];
+};
+export declare function classifyWorkerCheckpointStatus(cwd: string): GjcWorkerCheckpointClassification;
 export declare function startGjcTeam(options: GjcTeamStartOptions): Promise<GjcTeamSnapshot>;
 export declare function readGjcTeamSnapshot(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamSnapshot>;
+export declare function requestGjcWorkerIntegrationAttempt(cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcWorkerIntegrationAttemptRequestResult>;
+export declare function buildTeamHudSummary(snapshot: GjcTeamSnapshot, latestEvent?: GjcTeamEvent, latestMessage?: GjcTeamMailboxMessage): Promise<WorkflowHudSummary>;
 export declare function monitorGjcTeam(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamSnapshot>;
 export declare function listGjcTeams(cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamSnapshot[]>;
 export declare function shutdownGjcTeam(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamSnapshot>;

package/dist/types/gjc-runtime/ultragoal-runtime.d.ts

@@ -1,3 +1,4 @@
+import type { WorkflowHudSummary } from "../skill-state/active-state";
 export type UltragoalGjcGoalMode = "aggregate" | "per-story";
 export type UltragoalGoalStatus = "pending" | "active" | "complete" | "failed" | "blocked" | "review_blocked" | "superseded";
 export interface UltragoalGoal {
@@ -34,6 +35,7 @@ export interface UltragoalCompletionVerification {
     gjcGoalMode: UltragoalGjcGoalMode;
     gjcObjective: string;
     qualityGateHash: string;
+    gjcGoalSnapshotHash: string;
     planGeneration: string;
     basis: {
         planHashBeforeCheckpoint: string;
@@ -77,8 +79,21 @@ interface JsonObject {
 export declare function hashStructuredValue(value: unknown): string;
 export declare function getUltragoalPaths(cwd: string): UltragoalPaths;
 export declare function readUltragoalLedger(cwd: string): Promise<UltragoalLedgerEvent[]>;
+export declare function computeUltragoalPlanGeneration(input: {
+    plan: UltragoalPlan;
+    ledger: readonly UltragoalLedgerEvent[];
+    goal: UltragoalGoal;
+    receiptKind: UltragoalReceiptKind;
+    beforeStatus: UltragoalGoalStatus;
+    excludeEventId?: string;
+    targetGoalUpdatedAt?: string;
+}): {
+    planGeneration: string;
+    basis: UltragoalCompletionVerification["basis"];
+};
 export declare function readUltragoalPlan(cwd: string): Promise<UltragoalPlan | null>;
 export declare function getUltragoalStatus(cwd: string): Promise<UltragoalStatusSummary>;
+export declare function buildUltragoalHudSummary(summary: UltragoalStatusSummary, latestLedger?: UltragoalLedgerEvent): WorkflowHudSummary;
 export declare function createUltragoalPlan(input: {
     cwd: string;
     brief: string;
@@ -92,16 +107,6 @@ export declare function startNextUltragoalGoal(input: {
     goal?: UltragoalGoal;
     allComplete: boolean;
 }>;
-export declare function computeUltragoalPlanGeneration(input: {
-    plan: UltragoalPlan;
-    ledger: readonly UltragoalLedgerEvent[];
-    goal: UltragoalGoal;
-    receiptKind: UltragoalReceiptKind;
-    beforeStatus: UltragoalGoalStatus;
-    excludeEventId?: string;
-}): UltragoalCompletionVerification["basis"] & {
-    planGeneration: string;
-};
 export declare function checkpointUltragoalGoal(input: {
     cwd: string;
     goalId: string;

package/dist/types/hooks/skill-state.d.ts

@@ -1,4 +1,5 @@
 import type { SkillDiscoverySettings } from "../config/skill-settings-defaults";
+import type { SkillActiveEntry as CanonicalSkillActiveEntry, WorkflowHudSummary } from "../skill-state/active-state";
 import { type GjcWorkflowSkill } from "./skill-keywords";
 export declare const GJC_STATE_DIR = ".gjc/state";
 export declare const SKILL_ACTIVE_STATE_FILE = "skill-active-state.json";
@@ -13,7 +14,7 @@ export interface SkillKeywordMatch {
     skill: GjcWorkflowSkill;
     priority: number;
 }
-export interface SkillActiveEntry {
+export interface SkillActiveEntry extends Omit<CanonicalSkillActiveEntry, "skill"> {
     skill: GjcWorkflowSkill;
     phase?: string;
     active?: boolean;
@@ -22,6 +23,8 @@ export interface SkillActiveEntry {
     session_id?: string;
     thread_id?: string;
     turn_id?: string;
+    hud?: WorkflowHudSummary;
+    stale?: boolean;
 }
 export interface SkillActiveState {
     version: number;

package/dist/types/modes/components/model-selector.d.ts

@@ -5,6 +5,26 @@ import type { GjcModelAssignmentTargetId, ModelRegistry } from "../../config/mod
 import { type ScopedModelSelection } from "../../config/model-resolver";
 import type { Settings } from "../../config/settings";
 type ScopedModelItem = ScopedModelSelection;
+export interface ModelAssignmentPreset {
+    id: "openai-codex";
+    label: string;
+    description: string;
+    assignments: Partial<Record<GjcModelAssignmentTargetId, ThinkingLevel>>;
+}
+export type ModelSelectorSelection = {
+    kind: "assignment";
+    model: Model;
+    role: GjcModelAssignmentTargetId | null;
+    thinkingLevel?: ThinkingLevel;
+    selector?: string;
+} | {
+    kind: "preset";
+    model: Model;
+    selector: string;
+    preset: ModelAssignmentPreset;
+    assignments: Record<GjcModelAssignmentTargetId, ThinkingLevel>;
+};
+type RoleSelectCallback = (selection: ModelSelectorSelection) => void;
 /**
  * Component that renders a canonical model selector with provider tabs.
  * - Tab/Arrow Left/Right: Switch between provider tabs
@@ -14,7 +34,7 @@ type ScopedModelItem = ScopedModelSelection;
  */
 export declare class ModelSelectorComponent extends Container {
     #private;
-    constructor(tui: TUI, _currentModel: Model | undefined, settings: Settings, modelRegistry: ModelRegistry, scopedModels: ReadonlyArray<ScopedModelItem>, onSelect: (model: Model, role: GjcModelAssignmentTargetId | null, thinkingLevel?: ThinkingLevel, selector?: string) => void, onCancel: () => void, options?: {
+    constructor(tui: TUI, _currentModel: Model | undefined, settings: Settings, modelRegistry: ModelRegistry, scopedModels: ReadonlyArray<ScopedModelItem>, onSelect: RoleSelectCallback, onCancel: () => void, options?: {
         temporaryOnly?: boolean;
         initialSearchInput?: string;
     });

package/dist/types/skill-state/active-state.d.ts

@@ -2,6 +2,21 @@ export declare const SKILL_ACTIVE_STATE_FILE = "skill-active-state.json";
 export declare const SKILL_ACTIVE_STALE_MS: number;
 export declare const CANONICAL_GJC_WORKFLOW_SKILLS: readonly ["deep-interview", "ralplan", "ultragoal", "team"];
 export type CanonicalGjcWorkflowSkill = (typeof CANONICAL_GJC_WORKFLOW_SKILLS)[number];
+export type WorkflowHudSeverity = "info" | "warning" | "blocked" | "error" | "success";
+export interface WorkflowHudChip {
+    label: string;
+    value?: string;
+    priority?: number;
+    severity?: WorkflowHudSeverity;
+}
+export interface WorkflowHudSummary {
+    version: 1;
+    summary?: string;
+    chips?: WorkflowHudChip[];
+    details?: WorkflowHudChip[];
+    severity?: WorkflowHudSeverity;
+    updated_at?: string;
+}
 export interface SkillActiveEntry {
     skill: string;
     phase?: string;
@@ -11,6 +26,8 @@ export interface SkillActiveEntry {
     session_id?: string;
     thread_id?: string;
     turn_id?: string;
+    hud?: WorkflowHudSummary;
+    stale?: boolean;
 }
 export interface SkillActiveState {
     version?: number;
@@ -41,7 +58,9 @@ export interface SyncSkillActiveStateOptions {
     turnId?: string;
     nowIso?: string;
     source?: string;
+    hud?: WorkflowHudSummary;
 }
+export declare function normalizeWorkflowHudSummary(raw: unknown): WorkflowHudSummary | undefined;
 export declare function isCanonicalGjcWorkflowSkill(skill: string): skill is CanonicalGjcWorkflowSkill;
 export declare function listActiveSkills(raw: unknown): SkillActiveEntry[];
 export declare function normalizeSkillActiveState(raw: unknown): SkillActiveState | null;

package/dist/types/skill-state/workflow-hud.d.ts

@@ -0,0 +1,62 @@
+import type { WorkflowHudSummary } from "./active-state";
+interface DeepInterviewHudState {
+    phase?: string;
+    ambiguity?: number;
+    threshold?: number;
+    roundCount?: number;
+    targetComponent?: string;
+    weakestDimension?: string;
+    specStatus?: string;
+    updatedAt?: string;
+}
+interface RalplanHudState {
+    stage?: string;
+    waiting?: string;
+    iteration?: number;
+    verdict?: string;
+    latestSummary?: string;
+    pendingApproval?: boolean;
+    updatedAt?: string;
+}
+interface UltragoalLikeGoal {
+    id: string;
+    title: string;
+    status: string;
+}
+interface UltragoalHudState {
+    status: string;
+    currentGoal?: UltragoalLikeGoal;
+    counts: Record<string, number>;
+    goals: UltragoalLikeGoal[];
+    latestLedgerEvent?: {
+        event?: string;
+        goalId?: string;
+        timestamp?: string;
+    };
+    updatedAt?: string;
+}
+interface TeamHudWorker {
+    id: string;
+    status?: string;
+}
+interface TeamHudState {
+    phase: string;
+    task_total: number;
+    task_counts: Record<string, number>;
+    workers: TeamHudWorker[];
+    updated_at?: string;
+    latestEvent?: {
+        type?: string;
+        worker?: string;
+        message?: string;
+    };
+    latestMessage?: {
+        from_worker?: string;
+        body?: string;
+    };
+}
+export declare function buildDeepInterviewHudSummary(state: DeepInterviewHudState): WorkflowHudSummary;
+export declare function buildRalplanHudSummary(state: RalplanHudState): WorkflowHudSummary;
+export declare function buildUltragoalHudSummary(state: UltragoalHudState): WorkflowHudSummary;
+export declare function buildTeamHudSummary(state: TeamHudState): WorkflowHudSummary;
+export {};

package/dist/types/slash-commands/builtin-registry.d.ts

@@ -2,6 +2,7 @@ import type { BuiltinSlashCommand, ParsedSlashCommand, SlashCommandResult, Slash
 export type { BuiltinSlashCommand, SubcommandDef } from "./types";
 /** TUI-specific runtime accepted by `executeBuiltinSlashCommand`. */
 export type BuiltinSlashCommandRuntime = TuiSlashCommandRuntime;
+export declare function formatUnknownBuiltinSlashCommandDiagnostic(commandName: string): string | undefined;
 /** Builtin command metadata used for slash-command autocomplete and help text. */
 export declare const BUILTIN_SLASH_COMMAND_DEFS: ReadonlyArray<BuiltinSlashCommand>;
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/coding-agent",
-	"version": "0.1.3",
+	"version": "0.2.1",
 	"description": "Gajae Code CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://gaebal-gajae.dev",
 	"author": "Yeachan-Heo",
@@ -48,12 +48,12 @@
 		"@agentclientprotocol/sdk": "0.21.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@gajae-code/stats": "0.1.3",
-		"@gajae-code/agent-core": "0.1.3",
-		"@gajae-code/ai": "0.1.3",
-		"@gajae-code/natives": "0.1.3",
-		"@gajae-code/tui": "0.1.3",
-		"@gajae-code/utils": "0.1.3",
+		"@gajae-code/stats": "0.2.1",
+		"@gajae-code/agent-core": "0.2.1",
+		"@gajae-code/ai": "0.2.1",
+		"@gajae-code/natives": "0.2.1",
+		"@gajae-code/tui": "0.2.1",
+		"@gajae-code/utils": "0.2.1",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/src/cli/args.ts

@@ -55,6 +55,15 @@ export interface Args {
 	unknownFlags: Map<string, boolean | string>;
 }
 
+function isStartupSlashCommandArg(arg: string | undefined): boolean {
+	return (
+		arg === "/provider" ||
+		arg?.startsWith("/provider:") === true ||
+		arg === "/provicer" ||
+		arg?.startsWith("/provicer:") === true
+	);
+}
+
 export function parseArgs(args: string[]): Args {
 	const result: Args = {
 		messages: [],
@@ -65,6 +74,11 @@ export function parseArgs(args: string[]): Args {
 	for (let i = 0; i < args.length; i++) {
 		let arg = args[i];
 
+		if (isStartupSlashCommandArg(arg)) {
+			result.messages.push(args.slice(i).join(" "));
+			break;
+		}
+
 		// Support --flag=value syntax (e.g. --tools=ask,read)
 		if (arg.startsWith("--") && arg.includes("=")) {
 			const eqIdx = arg.indexOf("=");