@gajae-code/coding-agent 0.2.1 → 0.2.2

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/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/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/coding-agent",
-	"version": "0.2.1",
+	"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.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",
+		"@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",

package/src/cli/args.ts

@@ -245,9 +245,10 @@ export function getExtraHelpText(): string {
   GJC_SLOW_MODEL              - Override slow/reasoning model (see --slow)
   GJC_PLAN_MODEL              - Override planning model (see --plan)
   GJC_NO_PTY                  - Disable PTY-based interactive bash execution
-  --tmux                       - Launch interactive startup inside tmux
+  --tmux                       - Launch interactive startup inside a new tmux session
+  gjc session                  - List, inspect, create, remove, or attach tagged GJC-managed tmux sessions
   GJC_LAUNCH_POLICY           - Launch policy for --tmux startup: tmux or direct
-  GJC_TMUX_SESSION            - tmux session name for default interactive startup (default: gajae_code)
+  GJC_TMUX_SESSION            - Explicit tmux session name override for --tmux startup
 
   For complete environment variable reference, see:
   ${chalk.dim("docs/environment-variables.md")}

package/src/cli.ts

@@ -31,13 +31,18 @@ process.title = APP_NAME;
 
 const commands: CommandEntry[] = [
 	{ name: "codex-native-hook", load: () => import("./commands/codex-native-hook").then(m => m.default) },
-	{ name: "question", load: () => import("./commands/question").then(m => m.default) },
 	{ name: "state", load: () => import("./commands/state").then(m => m.default) },
 	{ name: "setup", load: () => import("./commands/setup").then(m => m.default) },
 	{ name: "skills", load: () => import("./commands/skills").then(m => m.default) },
+	{ name: "session", load: () => import("./commands/session").then(m => m.default) },
 	{ name: "team", load: () => import("./commands/team").then(m => m.default) },
 	{ name: "ultragoal", load: () => import("./commands/ultragoal").then(m => m.default) },
 	{ name: "ralplan", load: () => import("./commands/ralplan").then(m => m.default) },
+	{
+		name: "contribute-pr",
+		aliases: ["contribution-prep"],
+		load: () => import("./commands/contribution-prep").then(m => m.default),
+	},
 	{ name: "deep-interview", load: () => import("./commands/deep-interview").then(m => m.default) },
 	{ name: "launch", load: () => import("./commands/launch").then(m => m.default) },
 ];

package/src/commands/contribution-prep.ts

@@ -0,0 +1,41 @@
+import { Command, Flags } from "@gajae-code/utils/cli";
+import { prepareContributionPrep } from "../session/contribution-prep";
+
+function writeText(lines: string[]): void {
+	process.stdout.write(`${lines.join("\n")}\n`);
+}
+
+export default class ContributionPrep extends Command {
+	static description = "Dump redacted context and prepare a fresh contribute-pr worker prompt";
+	static strict = false;
+
+	static flags = {
+		"no-spawn": Flags.boolean({ description: "Only write artifacts; do not spawn a fresh GJC worker" }),
+		"source-session-id": Flags.string({ description: "Source session id to record in the manifest" }),
+		"artifact-root": Flags.string({ description: "Directory where contribute-pr artifacts are written" }),
+	};
+
+	static examples = ["gjc contribute-pr", "gjc contribute-pr --no-spawn"];
+
+	async run(): Promise<void> {
+		const { flags } = await this.parse(ContributionPrep);
+		const cwd = process.cwd();
+		const result = await prepareContributionPrep(
+			{
+				sessionId: flags["source-session-id"] ?? "cli",
+				cwd,
+				messages: [],
+			},
+			{
+				spawnWorker: !flags["no-spawn"],
+				artifactRoot: flags["artifact-root"],
+			},
+		);
+		writeText([
+			"Contribution prep artifacts written.",
+			`Manifest: ${result.manifestPath}`,
+			`Worker prompt: ${result.workerPromptPath}`,
+			`Spawned worker: ${result.spawned ? "yes" : "no"}`,
+		]);
+	}
+}

package/src/commands/deep-interview.ts

@@ -1,31 +1,15 @@
 import { Command } from "@gajae-code/utils/cli";
-import { syncSkillActiveState } from "../skill-state/active-state";
-import { runGjcRuntimeBridgeWithHudSidecar } from "./gjc-runtime-bridge";
+import { runNativeDeepInterviewCommand } from "../gjc-runtime/deep-interview-runtime";
 
 export default class DeepInterview extends Command {
-	static description = "Run private GJC deep-interview workflow commands";
+	static description = "Run native GJC deep-interview workflow";
 	static strict = false;
-	static examples = ["$ gjc deep-interview --help"];
+	static examples = ['$ gjc deep-interview --standard "<idea>"'];
 
 	async run(): Promise<void> {
-		const cwd = process.cwd();
-		const result = await runGjcRuntimeBridgeWithHudSidecar("deep-interview", this.argv, {
-			cwd,
-			sidecarSkill: "deep-interview",
-			onHudPayload: payload =>
-				syncSkillActiveState({
-					cwd,
-					skill: "deep-interview",
-					active: payload.active ?? true,
-					phase: payload.phase,
-					sessionId: payload.session_id,
-					threadId: payload.thread_id,
-					turnId: payload.turn_id,
-					hud: payload.hud,
-					source: "gjc-runtime-bridge",
-				}),
-		});
-		if (result.error) process.stderr.write(`${result.error}\n`);
+		const result = await runNativeDeepInterviewCommand(this.argv, process.cwd());
+		if (result.stdout) process.stdout.write(result.stdout);
+		if (result.stderr) process.stderr.write(result.stderr);
 		process.exitCode = result.status;
 	}
 }

package/src/commands/launch.ts

@@ -155,7 +155,16 @@ export default class Index extends Command {
 			setProjectDir(launch.cwd);
 		}
 		const launchParsed = parseArgs(launch.args);
-		if (launchDefaultTmuxIfNeeded({ parsed: launchParsed, rawArgs: launch.args, cwd: launch.cwd })) return;
+		if (
+			launchDefaultTmuxIfNeeded({
+				parsed: launchParsed,
+				rawArgs: launch.args,
+				cwd: launch.cwd,
+				worktreeBranch: launch.worktree.enabled && !launch.worktree.detached ? launch.worktree.branchName : null,
+				project: launch.worktree.enabled ? launch.worktree.repoRoot : launch.cwd,
+			})
+		)
+			return;
 		await runRootCommand(launchParsed, launch.args);
 	}
 }