@gajae-code/coding-agent 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -2,6 +2,43 @@
 
 ## [Unreleased]
 
+## [0.2.2] - 2026-05-31
+
+### Added
+
+- Added `gjc session` for listing, inspecting, removing, and attaching GJC-managed tmux sessions ([#105](https://github.com/Yeachan-Heo/gajae-code/pull/105)).
+- Added a managed tmux session surface so `gjc --tmux` and `gjc team` reuse a scoped GJC session instead of mutating the global tmux environment.
+- Added a detached contribution prep workflow surface ([#122](https://github.com/Yeachan-Heo/gajae-code/pull/122)).
+- Added stricter `models.yml` validation and docs for OpenAI-compatible proxy providers, bridge-command requirements, and team dry-run state behavior ([#121](https://github.com/Yeachan-Heo/gajae-code/pull/121)).
+- Added first-class Azure OpenAI and Amazon Bedrock providers ([#119](https://github.com/Yeachan-Heo/gajae-code/pull/119)).
+- Added workflow state receipt routing so skill state writes emit a structured `WorkflowStateReceipt` envelope and sync skill-active HUD chips under `.gjc/state/skill-active-state.json` ([#118](https://github.com/Yeachan-Heo/gajae-code/pull/118)).
+- Made `gjc state`, `gjc ralplan`, and `gjc deep-interview` work natively as documented in their SKILL.md files. `gjc state read|write|clear|contract` operates directly on `.gjc/state/` receipts (accepts `--input '<json>'` with `@file` shorthand, `--mode <skill>`, positional `<skill>`, `--session-id`, `--thread-id`, `--turn-id`, `--json`, `--replace`); writes emit a structured `WorkflowStateReceipt` envelope and sync skill-active HUD chips. `gjc ralplan` accepts the documented `--interactive`/`--deliberate`/`--architect`/`--critic` flags and the `--write --stage --stage_n --artifact` artifact persistence shape under `.gjc/plans/ralplan/<run-id>/`. `gjc deep-interview` accepts the documented `--quick`/`--standard`/`--deep` resolution flags ([#125](https://github.com/Yeachan-Heo/gajae-code/pull/125)).
+- Added a GJC dogfood skill template ([#114](https://github.com/Yeachan-Heo/gajae-code/pull/114)).
+
+### Changed
+
+- Changed `gjc --tmux` startup to create a fresh GJC-managed tmux session instead of attaching to an existing default session.
+- Hardened team message delivery and worker enforcement ([#112](https://github.com/Yeachan-Heo/gajae-code/pull/112)).
+- Hardened team worker startup and evidence invariants ([#123](https://github.com/Yeachan-Heo/gajae-code/pull/123)).
+- Clarified team state while integration is pending ([#109](https://github.com/Yeachan-Heo/gajae-code/pull/109)).
+- Removed goal mode budget semantics ([#106](https://github.com/Yeachan-Heo/gajae-code/pull/106)).
+- Removed the unused `gjc question` CLI; the `ask` tool covers blocking-question prompts.
+- Dropped the obsolete `loop` and `orchestrate` skills and pinned GJC skills in autocomplete ([#126](https://github.com/Yeachan-Heo/gajae-code/pull/126)).
+- Enforced CLI-managed workflow artifacts so planning skills persist via `gjc state` and `gjc ralplan --write` instead of editing `.gjc/` files directly.
+
+### Fixed
+
+- Fixed Anthropic extended-thinking replay recovery after aborted turns ([#115](https://github.com/Yeachan-Heo/gajae-code/pull/115)).
+- Fixed `gjc deep-interview` ambiguity threshold default so workflow gating matches the documented contract ([#116](https://github.com/Yeachan-Heo/gajae-code/pull/116)).
+- Fixed duplicate PR creation in the team integration path ([#117](https://github.com/Yeachan-Heo/gajae-code/pull/117)).
+- Fixed package asset resolution to prefer `GJC_PACKAGE_DIR` over the legacy `PI_PACKAGE_DIR`, preventing update-launch changelog displays from reading stale OMP package assets ([#111](https://github.com/Yeachan-Heo/gajae-code/pull/111)).
+## [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
@@ -82,7 +119,7 @@
 ### Fixed
 
 - Fixed `gjc ultragoal create-goals` native goal activation so live sessions receive a pending reconciliation request even when the session file already contains an active goal.
-- Made `gjc ultragoal` run natively without requiring `GJC_RUNTIME_BINARY`, while preserving active goal state across interrupted turns.
+- Made `gjc ultragoal` run natively, preserving active goal state across interrupted turns.
 - Fixed interactive Escape/interrupt recovery so abort cleanup is bounded and forces the session back to idle when a provider stream, tool, or post-turn task ignores cooperative cancellation.
 - Fixed root `gjc --worktree` / `gjc -w` startup so the launch command actually creates and enters the sibling `<repo>.gajae-code-worktrees/<branch-slug>` git worktree before starting the session, using collision-resistant branch slugs and avoiding worktree side effects for help/version launches.
 - Fixed root `gjc --worktree <branch>` / `gjc -w <branch>` parsing so named branch worktrees create their own `<branch-slug>` directory instead of reusing the dirty detached worktree for the current branch.

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/contribution-prep.d.ts

@@ -0,0 +1,18 @@
+import { Command } from "@gajae-code/utils/cli";
+export default class ContributionPrep extends Command {
+    static description: string;
+    static strict: boolean;
+    static flags: {
+        "no-spawn": import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "source-session-id": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "artifact-root": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,24 @@
+import { Command } from "@gajae-code/utils/cli";
+export default class Session extends Command {
+    static description: string;
+    static strict: boolean;
+    static args: {
+        action: import("@gajae-code/utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+        };
+        session: import("@gajae-code/utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+        };
+    };
+    static flags: {
+        json: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+            default: boolean;
+        };
+    };
+    static examples: string[];
+    run(): 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";
@@ -43,7 +43,7 @@ export declare const ModelsConfigFile: ConfigFile<{
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         apiKeyEnv?: string | undefined;
-        api?: "anthropic-messages" | "azure-openai-responses" | "google-generative-ai" | "google-vertex" | "openai-codex-responses" | "openai-completions" | "openai-responses" | undefined;
+        api?: "anthropic-messages" | "azure-openai-responses" | "bedrock-converse-stream" | "cursor-agent" | "google-gemini-cli" | "google-generative-ai" | "google-vertex" | "ollama-chat" | "openai-codex-responses" | "openai-completions" | "openai-responses" | undefined;
         headers?: Record<string, string> | undefined;
         compat?: {
             supportsStore?: boolean | undefined;
@@ -88,10 +88,16 @@ 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;
-            api?: "anthropic-messages" | "azure-openai-responses" | "google-generative-ai" | "google-vertex" | "openai-codex-responses" | "openai-completions" | "openai-responses" | undefined;
+            api?: "anthropic-messages" | "azure-openai-responses" | "bedrock-converse-stream" | "cursor-agent" | "google-gemini-cli" | "google-generative-ai" | "google-vertex" | "ollama-chat" | "openai-codex-responses" | "openai-completions" | "openai-responses" | undefined;
             baseUrl?: string | undefined;
             reasoning?: boolean | undefined;
             thinking?: {
@@ -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,7 +162,16 @@ export declare const ModelOverrideSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     contextPromotionTarget: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+    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.$strict>>;
+}, z.core.$strict>;
 export type ModelOverride = z.infer<typeof ModelOverrideSchema>;
 export declare const ProviderDiscoverySchema: z.ZodObject<{
     type: z.ZodEnum<{
@@ -187,8 +196,12 @@ export declare const ModelsConfigSchema: z.ZodObject<{
         api: z.ZodOptional<z.ZodEnum<{
             "anthropic-messages": "anthropic-messages";
             "azure-openai-responses": "azure-openai-responses";
+            "bedrock-converse-stream": "bedrock-converse-stream";
+            "cursor-agent": "cursor-agent";
+            "google-gemini-cli": "google-gemini-cli";
             "google-generative-ai": "google-generative-ai";
             "google-vertex": "google-vertex";
+            "ollama-chat": "ollama-chat";
             "openai-codex-responses": "openai-codex-responses";
             "openai-completions": "openai-completions";
             "openai-responses": "openai-responses";
@@ -262,14 +275,26 @@ 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.$strict>>;
         models: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodOptional<z.ZodString>;
             api: z.ZodOptional<z.ZodEnum<{
                 "anthropic-messages": "anthropic-messages";
                 "azure-openai-responses": "azure-openai-responses";
+                "bedrock-converse-stream": "bedrock-converse-stream";
+                "cursor-agent": "cursor-agent";
+                "google-gemini-cli": "google-gemini-cli";
                 "google-generative-ai": "google-generative-ai";
                 "google-vertex": "google-vertex";
+                "ollama-chat": "ollama-chat";
                 "openai-codex-responses": "openai-codex-responses";
                 "openai-completions": "openai-completions";
                 "openai-responses": "openai-responses";
@@ -382,7 +407,16 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 }>>;
             }, z.core.$strip>>;
             contextPromotionTarget: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
+            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.$strict>>;
+        }, z.core.$strict>>>;
         modelOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
             reasoning: z.ZodOptional<z.ZodBoolean>;
@@ -492,13 +526,26 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 }>>;
             }, z.core.$strip>>;
             contextPromotionTarget: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
+            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.$strict>>;
+        }, z.core.$strict>>>;
         disableStrictTools: z.ZodOptional<z.ZodBoolean>;
         transport: z.ZodOptional<z.ZodLiteral<"pi-native">>;
-    }, z.core.$strip>>>;
+    }, z.core.$strict>>>;
+    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>>;
     }, z.core.$strip>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type ModelsConfig = z.infer<typeof ModelsConfigSchema>;

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

@@ -1035,29 +1035,6 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "When steering messages interrupt tool execution";
         };
     };
-    readonly "loop.mode": {
-        readonly type: "enum";
-        readonly values: readonly ["prompt", "compact", "reset"];
-        readonly default: "prompt";
-        readonly ui: {
-            readonly tab: "interaction";
-            readonly label: "Loop Mode";
-            readonly description: "What happens between /loop iterations before re-submitting the prompt";
-            readonly options: readonly [{
-                readonly value: "prompt";
-                readonly label: "Prompt";
-                readonly description: "Re-submit the prompt as a follow-up message (current behavior)";
-            }, {
-                readonly value: "compact";
-                readonly label: "Compact";
-                readonly description: "Compact the session context, then re-submit the prompt";
-            }, {
-                readonly value: "reset";
-                readonly label: "Reset";
-                readonly description: "Start a new session, then re-submit the prompt";
-            }];
-        };
-    };
     readonly doubleEscapeAction: {
         readonly type: "enum";
         readonly values: readonly ["branch", "tree", "none"];
@@ -2552,7 +2529,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly ui: {
             readonly tab: "tasks";
             readonly label: "Goal Status In Footer";
-            readonly description: "Show token budget alongside the goal indicator in the status line";
+            readonly description: "Show goal usage alongside the goal indicator in the status line";
         };
     };
     readonly "goal.continuationModes": {

package/dist/types/gjc-runtime/deep-interview-runtime.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Native implementation of `gjc deep-interview`.
+ *
+ * The CLI itself does not run the Socratic interview; that lives inside the `/skill:deep-interview`
+ * skill executed by the agent. This handler validates the documented argument-hint surface
+ * (`[--quick|--standard|--deep] <idea>`), seeds `.gjc/state/deep-interview-state.json`, and
+ * updates the shared HUD rail via `syncSkillActiveState` so the active interview is visible to
+ * the TUI.
+ */
+export interface DeepInterviewCommandResult {
+    status: number;
+    stdout?: string;
+    stderr?: string;
+}
+export declare function runNativeDeepInterviewCommand(args: string[], cwd?: string): Promise<DeepInterviewCommandResult>;

package/dist/types/gjc-runtime/goal-mode-request.d.ts

@@ -1,4 +1,4 @@
-import type { Goal } from "../goals/state";
+import { type Goal } from "../goals/state";
 export declare const GJC_SESSION_FILE_ENV = "GJC_SESSION_FILE";
 export declare const GJC_SESSION_ID_ENV = "GJC_SESSION_ID";
 export declare const GJC_SESSION_CWD_ENV = "GJC_SESSION_CWD";

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

@@ -1,10 +1,8 @@
 import type { Args } from "../cli/args";
-export declare const GJC_DEFAULT_TMUX_SESSION = "gajae_code";
+import { buildGjcTmuxProfileCommands, GJC_DEFAULT_TMUX_SESSION, GJC_TMUX_COMMAND_ENV, GJC_TMUX_MOUSE_ENV, GJC_TMUX_PROFILE_ENV, GJC_TMUX_SESSION_PREFIX, type GjcTmuxProfileCommand } from "./tmux-common";
+export { buildGjcTmuxProfileCommands, GJC_DEFAULT_TMUX_SESSION, GJC_TMUX_COMMAND_ENV, GJC_TMUX_MOUSE_ENV, GJC_TMUX_PROFILE_ENV, GJC_TMUX_SESSION_PREFIX, };
 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;
@@ -20,6 +18,10 @@ export interface TmuxLaunchContext {
     tty?: TtyState;
     spawnSync?: TmuxSpawnSync;
     tmuxAvailable?: boolean;
+    worktreeBranch?: string | null;
+    currentBranch?: string | null;
+    existingBranchSessionName?: string | null;
+    project?: string | null;
 }
 export interface TmuxSpawnResult {
     exitCode: number | null;
@@ -40,11 +42,9 @@ export interface TmuxLaunchPlan {
     cwd: string;
     innerCommand: string;
     newSessionArgs: string[];
-    attachSessionArgs: string[];
-}
-export interface GjcTmuxProfileCommand {
-    description: string;
-    args: string[];
+    branch?: string | null;
+    attachSessionName?: string;
+    project?: string | null;
 }
 export interface GjcTmuxProfileResult {
     skipped: boolean;
@@ -60,9 +60,10 @@ export interface GjcTmuxProfileContext {
     cwd?: string;
     env?: NodeJS.ProcessEnv;
     spawnSync?: TmuxSpawnSync;
+    branch?: string | null;
+    branchSlug?: string | null;
+    project?: string | null;
 }
-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/ralplan-runtime.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Native implementation of `gjc ralplan`.
+ *
+ * Two invocation shapes are handled natively:
+ *
+ * 1. **Consensus handoff**: `gjc ralplan [--interactive] [--deliberate] [--architect <kind>]
+ *    [--critic <kind>] [--session-id <id>] "<task>"` validates the documented flag surface,
+ *    seeds `.gjc/state/ralplan-state.json`, and updates the shared HUD rail via
+ *    `syncSkillActiveState`. The CLI never *runs* the Planner / Architect / Critic loop itself —
+ *    that lives in the bundled `/skill:ralplan` skill — but it accepts every documented flag so
+ *    scripted users see a useful response and the active run is visible to the TUI.
+ *
+ * 2. **Artifact write**: `gjc ralplan --write --stage <type> --stage_n <N> --artifact
+ *    <path-or-string> [--run-id <id>] [--session-id <id>] [--json]` persists Planner / Architect
+ *    / Critic / revision / ADR / final markdown under `.gjc/plans/ralplan/<run-id>/`, maintains
+ *    an `index.jsonl` audit log, copies `final` stages to `pending-approval.md`, and advances
+ *    the HUD chip to reflect the latest persisted stage.
+ */
+export interface RalplanCommandResult {
+    status: number;
+    stdout?: string;
+    stderr?: string;
+}
+export declare function isRalplanArtifactWriteInvocation(args: readonly string[]): boolean;
+export declare function runNativeRalplanCommand(args: string[], cwd?: string): Promise<RalplanCommandResult>;

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

@@ -0,0 +1,13 @@
+/**
+ * Native implementation of the `gjc state read|write|clear` command surface.
+ *
+ * Simple file-receipt operations against `.gjc/state/[sessions/<id>/]<mode>-state.json` and
+ * `.gjc/state/[sessions/<id>/]skill-active-state.json`. This is the sanctioned CLI mediator for
+ * the mutation-guarded `.gjc/state` ACL — agents call it instead of editing those files directly.
+ */
+export interface StateCommandResult {
+    status: number;
+    stdout?: string;
+    stderr?: string;
+}
+export declare function runNativeStateCommand(args: string[], cwd?: string): Promise<StateCommandResult>;

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

@@ -1,5 +1,5 @@
 import type { WorkflowHudSummary } from "../skill-state/active-state";
-export type GjcTeamPhase = "starting" | "running" | "complete" | "failed" | "cancelled";
+export type GjcTeamPhase = "starting" | "running" | "awaiting_integration" | "complete" | "failed" | "cancelled";
 export type GjcTeamTaskStatus = "pending" | "blocked" | "in_progress" | "completed" | "failed";
 export type GjcWorkerStatusState = "idle" | "working" | "blocked" | "done" | "failed" | "draining" | "unknown";
 export declare const GJC_TEAM_DEFAULT_WORKERS = 3;
@@ -79,6 +79,7 @@ export interface GjcTeamConfig {
     tmux_session_name: string;
     tmux_target: string;
     workspace_mode: "direct" | "worktree";
+    dry_run: boolean;
     leader: GjcTeamLeader;
     leader_cwd: string;
     team_state_root: string;
@@ -101,6 +102,31 @@ export interface GjcTeamMonitorSnapshot {
     integration_by_worker: Record<string, GjcTeamWorkerIntegrationState>;
     updated_at: string;
 }
+export type GjcTeamNotificationDeliveryState = "pending" | "sent" | "queued" | "deferred" | "failed" | "delivered" | "acknowledged";
+export type GjcTeamPaneAttemptResult = "sent" | "queued" | "deferred" | "failed";
+export interface GjcTeamNotification {
+    id: string;
+    kind: "mailbox_message" | "worker_lifecycle" | "invalid_attempt";
+    team_name: string;
+    recipient: string;
+    source: {
+        type: "message" | "task" | "worker" | "event";
+        id: string;
+    };
+    idempotency_key?: string;
+    delivery_state: GjcTeamNotificationDeliveryState;
+    pane_attempt_result?: GjcTeamPaneAttemptResult;
+    pane_attempt_reason?: string;
+    pane_attempt_at?: string;
+    created_at: string;
+    updated_at: string;
+    replay_count: number;
+}
+export interface GjcTeamNotificationSummary {
+    total: number;
+    replay_eligible: number;
+    by_state: Record<GjcTeamNotificationDeliveryState, number>;
+}
 export interface GjcTeamSnapshot {
     team_name: string;
     display_name: string;
@@ -113,6 +139,7 @@ export interface GjcTeamSnapshot {
     task_counts: Record<GjcTeamTaskStatus, number>;
     workers: GjcTeamWorker[];
     integration_by_worker?: Record<string, GjcTeamWorkerIntegrationState>;
+    notification_summary: GjcTeamNotificationSummary;
     updated_at: string;
 }
 export interface GjcTeamStartOptions {
@@ -140,6 +167,7 @@ export interface GjcTeamMailboxMessage {
     created_at: string;
     delivered_at?: string;
     notified_at?: string;
+    idempotency_key?: string;
 }
 export declare function resolveGjcTeamWorkerCli(env?: NodeJS.ProcessEnv): GjcTeamWorkerCli;
 export declare function resolveGjcTeamWorkerCliPlan(workerCount: number, env?: NodeJS.ProcessEnv): GjcTeamWorkerCli[];
@@ -174,7 +202,7 @@ export interface GjcWorkerIntegrationAttemptRequestResult {
     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 const GJC_TEAM_API_OPERATIONS: readonly ["send-message", "broadcast", "mailbox-list", "mailbox-mark-delivered", "mailbox-mark-notified", "notification-list", "notification-read", "notification-replay", "notification-mark-pane-attempt", "worker-startup-ack", "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;
@@ -212,11 +240,15 @@ export declare function readGjcTeamTask(teamName: string, taskId: string, cwd?:
 export declare function createGjcTeamTask(teamName: string, subject: string, description: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamTask>;
 export declare function updateGjcTeamTask(teamName: string, taskId: string, updates: Partial<Pick<GjcTeamTask, "subject" | "description" | "blocked_by" | "depends_on">>, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamTask>;
 export declare function claimGjcTeamTask(teamName: string, workerId: string, cwd?: string, env?: NodeJS.ProcessEnv, taskId?: string): Promise<GjcTeamApiClaimResult>;
-export declare function transitionGjcTeamTaskStatus(teamName: string, taskId: string, status: GjcTeamTaskStatus, cwd?: string, env?: NodeJS.ProcessEnv, claimToken?: string): Promise<GjcTeamTask>;
+export declare function transitionGjcTeamTaskStatus(teamName: string, taskId: string, status: GjcTeamTaskStatus, cwd?: string, env?: NodeJS.ProcessEnv, claimToken?: string, workerId?: string, evidence?: string): Promise<GjcTeamTask>;
 export declare function transitionGjcTeamTask(teamName: string, taskId: string, status: GjcTeamTaskStatus | "complete", cwd?: string, env?: NodeJS.ProcessEnv, claimToken?: string): Promise<GjcTeamTask>;
 export declare function releaseGjcTeamTaskClaim(teamName: string, taskId: string, claimToken: string, workerId: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamTask>;
-export declare function sendGjcTeamMessage(teamName: string, fromWorker: string, toWorker: string, body: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamMailboxMessage>;
-export declare function broadcastGjcTeamMessage(teamName: string, fromWorker: string, body: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamMailboxMessage[]>;
+export declare function replayGjcTeamNotifications(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<{
+    notifications: GjcTeamNotification[];
+    summary: GjcTeamNotificationSummary;
+}>;
+export declare function sendGjcTeamMessage(teamName: string, fromWorker: string, toWorker: string, body: string, cwd?: string, env?: NodeJS.ProcessEnv, idempotencyKey?: string): Promise<GjcTeamMailboxMessage>;
+export declare function broadcastGjcTeamMessage(teamName: string, fromWorker: string, body: string, cwd?: string, env?: NodeJS.ProcessEnv, idempotencyKey?: string): Promise<GjcTeamMailboxMessage[]>;
 export declare function listGjcTeamMailbox(teamName: string, worker: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamMailboxMessage[]>;
 export declare function markGjcTeamMailboxMessage(teamName: string, worker: string, messageId: string, field: "delivered_at" | "notified_at", cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamMailboxMessage>;
 export declare function readGjcWorkerStatus(teamName: string, worker: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<WorkerStatusFile>;

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

@@ -0,0 +1,41 @@
+export declare const GJC_DEFAULT_TMUX_SESSION = "gajae_code";
+export declare const GJC_TMUX_SESSION_PREFIX = "gajae_code_";
+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";
+export declare const GJC_TMUX_PROFILE_OPTION = "@gjc-profile";
+export declare const GJC_TMUX_PROFILE_VALUE = "1";
+export declare const GJC_TMUX_BRANCH_OPTION = "@gjc-branch";
+export declare const GJC_TMUX_BRANCH_SLUG_OPTION = "@gjc-branch-slug";
+export declare const GJC_TMUX_PROJECT_OPTION = "@gjc-project";
+export interface GjcTmuxProfileCommand {
+    description: string;
+    args: string[];
+}
+export interface TmuxCommandResult {
+    exitCode: number | null;
+    stdout?: string;
+    stderr?: string;
+    signalCode?: string | null;
+}
+export type TmuxCommandRunner = (args: string[]) => TmuxCommandResult;
+export declare function envDisabled(value: string | undefined): boolean;
+export declare function resolveGjcTmuxCommand(env?: NodeJS.ProcessEnv): string;
+export declare function sanitizeTmuxToken(value: string): string;
+export declare function buildGjcTmuxSessionSlug(value: string): string;
+export declare function buildGjcTmuxSessionName(env?: NodeJS.ProcessEnv, context?: {
+    branch?: string | null;
+    now?: number;
+    id?: string;
+}): string;
+export declare function buildGjcTmuxRequiredProfileCommands(target: string, metadata?: {
+    branch?: string | null;
+    branchSlug?: string | null;
+    project?: string | null;
+}): GjcTmuxProfileCommand[];
+export declare function buildGjcTmuxProfileCommands(target: string, env?: NodeJS.ProcessEnv, metadata?: {
+    branch?: string | null;
+    branchSlug?: string | null;
+    project?: string | null;
+}): GjcTmuxProfileCommand[];
+export declare function normalizeTmuxCreatedAt(raw: string): string;