@gajae-code/coding-agent 0.2.0 → 0.2.2

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

@@ -0,0 +1,17 @@
+export interface GjcTmuxSessionStatus {
+    name: string;
+    attached: boolean;
+    windows: number;
+    panes: number;
+    bindings: string;
+    createdAt: string;
+    branch?: string;
+    branchSlug?: string;
+    project?: string;
+}
+export declare function listGjcTmuxSessions(env?: NodeJS.ProcessEnv): GjcTmuxSessionStatus[];
+export declare function findGjcTmuxSessionByBranch(branch: string, env?: NodeJS.ProcessEnv, project?: string | null): GjcTmuxSessionStatus | undefined;
+export declare function statusGjcTmuxSession(sessionName: string, env?: NodeJS.ProcessEnv): GjcTmuxSessionStatus;
+export declare function createGjcTmuxSession(env?: NodeJS.ProcessEnv): GjcTmuxSessionStatus;
+export declare function removeGjcTmuxSession(sessionName: string, env?: NodeJS.ProcessEnv): GjcTmuxSessionStatus;
+export declare function attachGjcTmuxSession(sessionName: string, env?: NodeJS.ProcessEnv): never;

package/dist/types/goals/runtime.d.ts

@@ -1,4 +1,4 @@
-import type { Goal, GoalBudgetSteering, GoalModeState, GoalRuntimeEvent, GoalTokenUsage } from "./state";
+import { type Goal, type GoalModeState, type GoalRuntimeEvent, type GoalTokenUsage } from "./state";
 export interface GoalRuntimeHost {
     getState(): GoalModeState | undefined;
     setState(state: GoalModeState | undefined): void;
@@ -24,16 +24,13 @@ export interface GoalWallClockSnapshot {
 export interface GoalRuntimeSnapshot {
     turnSnapshot?: GoalTurnSnapshot;
     wallClock: GoalWallClockSnapshot;
-    budgetReportedFor?: string;
 }
-export type GoalPromptKind = "active" | "continuation" | "budget-limit";
-export declare function remainingTokens(goal: Goal | null | undefined): number | null;
+export type GoalPromptKind = "active" | "continuation";
 export declare function escapeXmlText(input: string): string;
 export declare function renderTrustedObjective(objective: string): string;
 export declare function validateGoalObjective(objective: string, op: "create" | "replace"): string;
 export declare function goalTokenDelta(current: GoalTokenUsage, baseline: GoalTokenUsage): number;
 export declare function renderGoalPrompt(kind: GoalPromptKind, goal: Goal): string;
-export declare function completionBudgetReport(goal: Goal): string | null;
 export declare class GoalRuntime {
     #private;
     constructor(host: GoalRuntimeHost);
@@ -49,15 +46,12 @@ export declare class GoalRuntime {
         reason?: "interrupted" | "internal";
     }): Promise<void>;
     onThreadResumed(): Promise<GoalModeState | undefined>;
-    onBudgetMutated(newBudget: number | undefined): Promise<GoalModeState | undefined>;
-    flushUsage(steering: GoalBudgetSteering, currentUsage?: GoalTokenUsage): Promise<void>;
+    flushUsage(currentUsage?: GoalTokenUsage): Promise<void>;
     createGoal(input: {
         objective: string;
-        tokenBudget?: number;
     }): Promise<GoalModeState>;
     replaceGoal(input: {
         objective: string;
-        tokenBudget?: number;
     }): Promise<GoalModeState>;
     resumeGoal(): Promise<GoalModeState>;
     pauseGoal(): Promise<GoalModeState | undefined>;

package/dist/types/goals/state.d.ts

@@ -1,10 +1,9 @@
 import type { UsageStatistics } from "../session/session-manager";
-export type GoalStatus = "active" | "paused" | "budget-limited" | "complete" | "dropped";
+export type GoalStatus = "active" | "paused" | "complete" | "dropped";
 export interface Goal {
     id: string;
     objective: string;
     status: GoalStatus;
-    tokenBudget?: number;
     tokensUsed: number;
     timeUsedSeconds: number;
     createdAt: number;
@@ -19,8 +18,6 @@ export interface GoalModeState {
 export interface GoalToolDetails {
     op: "create" | "get" | "complete" | "resume" | "drop";
     goal?: Goal | null;
-    remainingTokens?: number | null;
-    completionBudgetReport?: string | null;
 }
 export type GoalRuntimeEvent = {
     type: "goal_updated";
@@ -31,5 +28,5 @@ export type GoalRuntimeEvent = {
     prompt: string;
 };
 export type GoalTokenUsage = Pick<UsageStatistics, "input" | "output" | "cacheRead" | "cacheWrite">;
-export type GoalBudgetSteering = "allowed" | "suppressed";
-export type GoalTerminalMetricEmission = "emit" | "suppress";
+export declare function normalizeGoal(candidate: unknown): Goal | null;
+export declare function normalizeGoalModeState(candidate: GoalModeState | undefined): GoalModeState | undefined;

package/dist/types/goals/tools/goal-tool.d.ts

@@ -14,31 +14,12 @@ declare const goalSchema: z.ZodObject<{
         resume: "resume";
     }>;
     objective: z.ZodOptional<z.ZodString>;
-    token_budget: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-declare const getGoalSchema: z.ZodObject<{}, z.core.$strip>;
-declare const createGoalSchema: z.ZodObject<{
-    objective: z.ZodString;
-    token_budget: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-declare const updateGoalSchema: z.ZodObject<{
-    status: z.ZodEnum<{
-        complete: "complete";
-        dropped: "dropped";
-    }>;
 }, z.core.$strip>;
 export type GoalToolInput = z.infer<typeof goalSchema>;
-export type GetGoalToolInput = z.infer<typeof getGoalSchema>;
-export type CreateGoalToolInput = z.infer<typeof createGoalSchema>;
-export type UpdateGoalToolInput = z.infer<typeof updateGoalSchema>;
 export interface GoalToolResponse {
     goal: Goal | null;
-    remainingTokens: number | null;
-    completionBudgetReport: string | null;
 }
-export declare function buildGoalToolResponse(goal: Goal | null | undefined, options?: {
-    includeCompletionReport?: boolean;
-}): GoalToolResponse;
+export declare function buildGoalToolResponse(goal: Goal | null | undefined): GoalToolResponse;
 export declare class GoalTool implements AgentTool<typeof goalSchema, GoalToolDetails> {
     #private;
     readonly name = "goal";
@@ -54,64 +35,15 @@ export declare class GoalTool implements AgentTool<typeof goalSchema, GoalToolDe
             resume: "resume";
         }>;
         objective: z.ZodOptional<z.ZodString>;
-        token_budget: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     readonly strict = true;
     readonly intent: "omit";
     constructor(session: ToolSession);
     execute(_toolCallId: string, params: GoalToolInput, _signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<GoalToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<GoalToolDetails>>;
 }
-export declare class GetGoalTool implements AgentTool<typeof getGoalSchema, GoalToolDetails> {
-    #private;
-    readonly name = "get_goal";
-    readonly label = "Get Goal";
-    readonly loadMode: "essential";
-    readonly description: string;
-    readonly parameters: z.ZodObject<{}, z.core.$strip>;
-    readonly strict = true;
-    readonly intent: "omit";
-    static createIf(session: ToolSession): GetGoalTool | null;
-    constructor(session: ToolSession);
-    execute(_toolCallId: string, _params: GetGoalToolInput, _signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<GoalToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<GoalToolDetails>>;
-}
-export declare class CreateGoalTool implements AgentTool<typeof createGoalSchema, GoalToolDetails> {
-    #private;
-    readonly name = "create_goal";
-    readonly label = "Create Goal";
-    readonly loadMode: "essential";
-    readonly description: string;
-    readonly parameters: z.ZodObject<{
-        objective: z.ZodString;
-        token_budget: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>;
-    readonly strict = true;
-    readonly intent: "omit";
-    static createIf(session: ToolSession): CreateGoalTool | null;
-    constructor(session: ToolSession);
-    execute(_toolCallId: string, params: CreateGoalToolInput, _signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<GoalToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<GoalToolDetails>>;
-}
-export declare class UpdateGoalTool implements AgentTool<typeof updateGoalSchema, GoalToolDetails> {
-    #private;
-    readonly name = "update_goal";
-    readonly label = "Update Goal";
-    readonly loadMode: "essential";
-    readonly description: string;
-    readonly parameters: z.ZodObject<{
-        status: z.ZodEnum<{
-            complete: "complete";
-            dropped: "dropped";
-        }>;
-    }, z.core.$strip>;
-    readonly strict = true;
-    readonly intent: "omit";
-    static createIf(session: ToolSession): UpdateGoalTool | null;
-    constructor(session: ToolSession);
-    execute(_toolCallId: string, params: UpdateGoalToolInput, _signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<GoalToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<GoalToolDetails>>;
-}
 interface GoalRenderArgs {
     op?: GoalToolInput["op"];
     objective?: string;
-    token_budget?: number;
 }
 export declare const goalToolRenderer: {
     renderCall(args: GoalRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component;

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/modes/components/status-line/types.d.ts

@@ -11,9 +11,6 @@ export interface SegmentContext {
         enabled: boolean;
         paused: boolean;
     } | null;
-    loopMode: {
-        enabled: boolean;
-    } | null;
     goalMode: {
         enabled: boolean;
         paused: boolean;

package/dist/types/modes/components/status-line.d.ts

@@ -44,9 +44,6 @@ export declare class StatusLineComponent implements Component {
         enabled: boolean;
         paused: boolean;
     } | undefined): void;
-    setLoopModeStatus(status: {
-        enabled: boolean;
-    } | undefined): void;
     setGoalModeStatus(status: {
         enabled: boolean;
         paused: boolean;

package/dist/types/modes/controllers/command-controller.d.ts

@@ -32,5 +32,6 @@ export declare class CommandController {
     handleSkillCommand(skillPath: string, args: string): Promise<void>;
     executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
     handleHandoffCommand(customInstructions?: string): Promise<void>;
+    handleContributionPrepCommand(customInstructions?: string): Promise<void>;
 }
 export declare function renderProviderSection(details: ProviderDetails, uiTheme: Pick<typeof theme, "fg">): string;

package/dist/types/modes/interactive-mode.d.ts

@@ -23,7 +23,6 @@ import type { HookInputComponent } from "./components/hook-input";
 import type { HookSelectorComponent } from "./components/hook-selector";
 import { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
-import { type LoopLimitRuntime } from "./loop-limit";
 import { OAuthManualInputManager } from "./oauth-manual-input";
 import type { Theme } from "./theme/theme";
 import type { CompactionQueuedMessage, InteractiveModeContext, SubmittedUserInput, TodoItem, TodoPhase } from "./types";
@@ -69,9 +68,6 @@ export declare class InteractiveMode implements InteractiveModeContext {
     goalModeEnabled: boolean;
     goalModePaused: boolean;
     planModePlanFilePath: string | undefined;
-    loopModeEnabled: boolean;
-    loopPrompt: string | undefined;
-    loopLimit: LoopLimitRuntime | undefined;
     todoPhases: TodoPhase[];
     hideThinkingBlock: boolean;
     pendingImages: ImageContent[];
@@ -111,14 +107,6 @@ export declare class InteractiveMode implements InteractiveModeContext {
     /** Reload slash commands and autocomplete for the provided working directory. */
     refreshSlashCommandState(cwd?: string): Promise<void>;
     getUserInput(): Promise<SubmittedUserInput>;
-    disableLoopMode(message?: string): void;
-    /**
-     * Pause the loop without exiting it: drops the captured prompt and any
-     * pending auto-resubmit. Loop mode stays enabled — the next prompt the
-     * user submits becomes the new loop prompt and resumes iteration.
-     */
-    pauseLoop(): void;
-    handleLoopCommand(args?: string): Promise<void>;
     recordLocalSubmission(text: string, imageCount?: number): () => void;
     withLocalSubmission<T>(text: string, fn: () => Promise<T>, options?: {
         imageCount?: number;
@@ -208,6 +196,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleSSHCommand(text: string): Promise<void>;
     handleCompactCommand(customInstructions?: string): Promise<CompactionOutcome>;
     handleHandoffCommand(customInstructions?: string): Promise<void>;
+    handleContributionPrepCommand(customInstructions?: string): Promise<void>;
     executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
     openInBrowser(urlOrPath: string): void;
     showSettingsSelector(): void;

package/dist/types/modes/theme/defaults/index.d.ts

@@ -2921,7 +2921,6 @@ export declare const defaultThemes: {
                 "icon.plan": string;
                 "icon.goal": string;
                 "icon.pause": string;
-                "icon.loop": string;
                 "icon.folder": string;
                 "icon.scratchFolder": string;
                 "icon.pi": string;
@@ -7439,7 +7438,6 @@ export declare const defaultThemes: {
                 "icon.plan": string;
                 "icon.goal": string;
                 "icon.pause": string;
-                "icon.loop": string;
                 "icon.folder": string;
                 "icon.scratchFolder": string;
                 "icon.pi": string;

package/dist/types/modes/theme/theme.d.ts

@@ -6,7 +6,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "checkbox.checked" | "checkbox.unchecked" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.editing" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.folder" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "checkbox.checked" | "checkbox.unchecked" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.editing" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers";
 export type SpinnerType = "status" | "activity";
 export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
 /** Check if a string is a valid ThemeColor value */
@@ -110,7 +110,6 @@ export declare class Theme {
         plan: string;
         goal: string;
         pause: string;
-        loop: string;
         folder: string;
         scratchFolder: string;
         file: string;

package/dist/types/modes/types.d.ts

@@ -22,7 +22,6 @@ import type { HookInputComponent } from "./components/hook-input";
 import type { HookSelectorComponent } from "./components/hook-selector";
 import type { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
-import type { LoopLimitRuntime } from "./loop-limit";
 import type { OAuthManualInputManager } from "./oauth-manual-input";
 import type { Theme } from "./theme/theme";
 export type CompactionQueuedMessage = {
@@ -76,9 +75,6 @@ export interface InteractiveModeContext {
     planModeEnabled: boolean;
     goalModeEnabled: boolean;
     goalModePaused: boolean;
-    loopModeEnabled: boolean;
-    loopPrompt?: string;
-    loopLimit?: LoopLimitRuntime;
     planModePlanFilePath?: string;
     hideThinkingBlock: boolean;
     pendingImages: ImageContent[];
@@ -203,6 +199,7 @@ export interface InteractiveModeContext {
     handleSSHCommand(text: string): Promise<void>;
     handleCompactCommand(customInstructions?: string): Promise<CompactionOutcome>;
     handleHandoffCommand(customInstructions?: string): Promise<void>;
+    handleContributionPrepCommand(customInstructions?: string): Promise<void>;
     handleMoveCommand(targetPath: string): Promise<void>;
     handleRenameCommand(title: string): Promise<void>;
     handleMemoryCommand(text: string): Promise<void>;
@@ -249,9 +246,6 @@ export interface InteractiveModeContext {
     registerExtensionShortcuts(): void;
     handlePlanModeCommand(initialPrompt?: string): Promise<void>;
     handleGoalModeCommand(rest?: string): Promise<void>;
-    handleLoopCommand(args?: string): Promise<void>;
-    disableLoopMode(): void;
-    pauseLoop(): void;
     handlePlanApproval(details: PlanApprovalDetails): Promise<void>;
     initHooksAndCustomTools(): Promise<void>;
     emitCustomToolSessionEvent(reason: "start" | "switch" | "branch" | "tree" | "shutdown", previousSessionFile?: string): Promise<void>;

package/dist/types/session/agent-session.d.ts

@@ -42,6 +42,7 @@ import { type DiscoverableTool, type DiscoverableToolSearchIndex } from "../tool
 import type { CheckpointState } from "../tools/checkpoint";
 import { type TodoItem, type TodoPhase } from "../tools/todo-write";
 import type { ClientBridge } from "./client-bridge";
+import { type ContributionPrepOptions, type ContributionPrepResult } from "./contribution-prep";
 import { type CustomMessage } from "./messages";
 import type { BranchSummaryEntry, NewSessionOptions, SessionContext, SessionManager } from "./session-manager";
 import { ToolChoiceQueue } from "./tool-choice-queue";
@@ -696,6 +697,7 @@ export declare class AgentSession {
      * @returns The handoff document text, or undefined if cancelled/failed
      */
     handoff(customInstructions?: string, options?: SessionHandoffOptions): Promise<HandoffResult | undefined>;
+    prepareContributionPrep(options?: ContributionPrepOptions): Promise<ContributionPrepResult>;
     /**
      * Toggle auto-compaction setting.
      */

package/dist/types/session/contribution-prep.d.ts

@@ -0,0 +1,47 @@
+import type { AgentMessage } from "@gajae-code/agent-core";
+export declare const CONTRIBUTION_PREP_SCHEMA_VERSION = 1;
+export interface ContributionPrepArtifact {
+    path: string;
+    description: string;
+}
+export interface ContributionPrepManifest {
+    schema_version: number;
+    source_session_id: string;
+    created_at: string;
+    cwd: string;
+    git_head: string | null;
+    changed_files: string[];
+    artifacts: ContributionPrepArtifact[];
+    redactions: string[];
+    recommended_output: string[];
+    worker_prompt_path: string;
+}
+export interface ContributionPrepResult {
+    manifestPath: string;
+    workerPromptPath: string;
+    artifactDir: string;
+    changedFiles: string[];
+    spawned: boolean;
+}
+export interface ContributionPrepOptions {
+    customInstructions?: string;
+    spawnWorker?: boolean;
+    artifactRoot?: string;
+    now?: Date;
+    spawn?: (args: string[], cwd: string, shell: boolean) => Promise<void>;
+}
+export interface ContributionPrepContext {
+    sessionId: string;
+    cwd: string;
+    sessionFile?: string;
+    messages: AgentMessage[];
+    customInstructions?: string;
+    now?: Date;
+}
+interface RedactionState {
+    labels: Set<string>;
+}
+export declare function redactContributionPrepText(text: string, cwd: string, state?: RedactionState): string;
+export declare function buildContributionPrepWorkerPrompt(manifestPath: string): string;
+export declare function prepareContributionPrep(context: ContributionPrepContext, options?: ContributionPrepOptions): Promise<ContributionPrepResult>;
+export {};

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

@@ -1,3 +1,4 @@
+import type { WorkflowStateReceipt } from "./workflow-state-contract";
 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"];
@@ -17,6 +18,7 @@ export interface WorkflowHudSummary {
     severity?: WorkflowHudSeverity;
     updated_at?: string;
 }
+export type { WorkflowStateReceipt } from "./workflow-state-contract";
 export interface SkillActiveEntry {
     skill: string;
     phase?: string;
@@ -28,6 +30,7 @@ export interface SkillActiveEntry {
     turn_id?: string;
     hud?: WorkflowHudSummary;
     stale?: boolean;
+    receipt?: WorkflowStateReceipt;
 }
 export interface SkillActiveState {
     version?: number;
@@ -59,6 +62,7 @@ export interface SyncSkillActiveStateOptions {
     nowIso?: string;
     source?: string;
     hud?: WorkflowHudSummary;
+    receipt?: WorkflowStateReceipt;
 }
 export declare function normalizeWorkflowHudSummary(raw: unknown): WorkflowHudSummary | undefined;
 export declare function isCanonicalGjcWorkflowSkill(skill: string): skill is CanonicalGjcWorkflowSkill;

package/dist/types/skill-state/deep-interview-mutation-guard.d.ts

@@ -1,5 +1,6 @@
 import type { AgentTool } from "@gajae-code/agent-core";
-export declare const DEEP_INTERVIEW_MUTATION_BLOCK_MESSAGE = "Deep-interview is active; either continue interviewing with `ask`, or write/finalize the pending spec under `.gjc/specs/` / update state under `.gjc/state/`. Do not edit product code until explicit execution approval.";
+export declare const DEEP_INTERVIEW_MUTATION_BLOCK_MESSAGE = "Deep-interview is active; continue interviewing with `ask`, write/finalize pending specs through the required GJC workflow CLI, or use an explicit force override. Direct `.gjc/` and product-code edits are blocked until explicit execution approval.";
+export declare const WORKFLOW_STATE_MUTATION_BLOCK_MESSAGE = "Workflow state JSON is runtime-owned. Use `gjc state <skill> read|write --input '<json>'` for deep-interview, ralplan, ultragoal, and team. Planning artifacts under `.gjc/specs/` and `.gjc/plans/` remain allowed.";
 type ToolWithEditMode = AgentTool & {
     mode?: unknown;
     customWireName?: unknown;
@@ -10,18 +11,22 @@ export interface DeepInterviewMutationGuardInput {
     threadId?: string;
     tool: ToolWithEditMode;
     args: unknown;
+    forceOverride?: boolean;
+    enforceWorkflowState?: boolean;
 }
 export interface DeepInterviewMutationDecision {
     blocked: boolean;
     message?: string;
     targets: string[];
     reason?: string;
+    command?: string;
 }
 export declare function assertDeepInterviewMutationRawPathsAllowed(input: {
     cwd: string;
     sessionId?: string;
     threadId?: string;
     rawPaths: string[];
+    forceOverride?: boolean;
 }): Promise<void>;
 export declare function getDeepInterviewMutationDecision(input: DeepInterviewMutationGuardInput): Promise<DeepInterviewMutationDecision>;
 export declare function assertDeepInterviewMutationAllowed(input: DeepInterviewMutationGuardInput): Promise<void>;

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

@@ -1,5 +1,10 @@
 import type { WorkflowHudSummary } from "./active-state";
-interface DeepInterviewHudState {
+interface WorkflowGateHudState {
+    approvalStatus?: string;
+    blockedReason?: string;
+    nextAction?: string;
+}
+interface DeepInterviewHudState extends WorkflowGateHudState {
     phase?: string;
     ambiguity?: number;
     threshold?: number;
@@ -9,7 +14,7 @@ interface DeepInterviewHudState {
     specStatus?: string;
     updatedAt?: string;
 }
-interface RalplanHudState {
+interface RalplanHudState extends WorkflowGateHudState {
     stage?: string;
     waiting?: string;
     iteration?: number;
@@ -23,7 +28,7 @@ interface UltragoalLikeGoal {
     title: string;
     status: string;
 }
-interface UltragoalHudState {
+interface UltragoalHudState extends WorkflowGateHudState {
     status: string;
     currentGoal?: UltragoalLikeGoal;
     counts: Record<string, number>;
@@ -39,7 +44,7 @@ interface TeamHudWorker {
     id: string;
     status?: string;
 }
-interface TeamHudState {
+interface TeamHudState extends WorkflowGateHudState {
     phase: string;
     task_total: number;
     task_counts: Record<string, number>;

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

@@ -0,0 +1,34 @@
+import { type CanonicalGjcWorkflowSkill } from "./active-state";
+export type { CanonicalGjcWorkflowSkill };
+export declare const WORKFLOW_STATE_RECEIPT_VERSION = 1;
+export declare const WORKFLOW_STATE_RECEIPT_FRESH_MS: number;
+export type WorkflowStateMutationOwner = "gjc-state-cli" | "gjc-runtime" | "gjc-hook";
+export type WorkflowStateReceiptStatus = "fresh" | "stale";
+export interface WorkflowStateReceipt {
+    version: 1;
+    skill: CanonicalGjcWorkflowSkill;
+    owner: WorkflowStateMutationOwner;
+    command: string;
+    state_path: string;
+    storage_path: string;
+    mutated_at: string;
+    fresh_until: string;
+    status: WorkflowStateReceiptStatus;
+    mutation_id: string;
+}
+export declare function workflowModeStateFileName(skill: CanonicalGjcWorkflowSkill): string;
+export declare function workflowStateStoragePath(cwd: string, skill: CanonicalGjcWorkflowSkill, sessionId?: string): string;
+export declare function workflowActiveStatePath(cwd: string, sessionId?: string): string;
+export declare function buildWorkflowStateReceipt(input: {
+    cwd: string;
+    skill: CanonicalGjcWorkflowSkill;
+    owner: WorkflowStateMutationOwner;
+    command: string;
+    sessionId?: string;
+    nowIso?: string;
+    mutationId?: string;
+}): WorkflowStateReceipt;
+export declare function workflowReceiptStatus(receipt: WorkflowStateReceipt | undefined, nowMs?: number): WorkflowStateReceiptStatus | undefined;
+export declare function canonicalWorkflowSkill(value: string): CanonicalGjcWorkflowSkill | null;
+export declare function sanctionedWorkflowStateCommand(skill: CanonicalGjcWorkflowSkill): string;
+export declare function describeWorkflowStateContract(skill: CanonicalGjcWorkflowSkill): string[];

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.2.0",
+	"version": "0.2.2",
 	"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.2.0",
-		"@gajae-code/agent-core": "0.2.0",
-		"@gajae-code/ai": "0.2.0",
-		"@gajae-code/natives": "0.2.0",
-		"@gajae-code/tui": "0.2.0",
-		"@gajae-code/utils": "0.2.0",
+		"@gajae-code/stats": "0.2.2",
+		"@gajae-code/agent-core": "0.2.2",
+		"@gajae-code/ai": "0.2.2",
+		"@gajae-code/natives": "0.2.2",
+		"@gajae-code/tui": "0.2.2",
+		"@gajae-code/utils": "0.2.2",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",