@gajae-code/coding-agent 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -2,6 +2,64 @@
 
 ## [Unreleased]
 
+## [0.2.3] - 2026-06-01
+
+### Added
+
+- Added `/provider add --preset minimax|minimax-cn|glm` and matching `gjc setup provider --preset ...` shortcuts for OpenAI-compatible MiniMax and GLM/zAI custom-provider onboarding.
+- Added a built-in `skill` tool so the agent can chain into another loaded skill on its next turn. Mirrors `/skill:<name>` typing and subagent `autoloadSkills` by dispatching the chained skill's SKILL.md as a user-attribution custom message; controlled by the new `skill.enabled` setting (default true).
+- Added explicit fork-context task subagents with sanitized bounded parent-history seeds, global `task.forkContext.enabled`, per-agent `forkContext: allowed`, per-task `inheritContext: true`, audit-visible seed metadata, and fresh provider transport state by default.
+- Defaulted the bundled `executor` and `architect` agents to `forkContext: allowed` so callers can opt them into a sanitized parent-context seed via `task({ inheritContext: true })`; per-task selection remains explicit (default false).
+- Added a `/context` slash command that surfaces the active session's token usage breakdown via `buildSessionContext` without forking prompt assembly, so users can see active context before sessions overflow ([#150](https://github.com/Yeachan-Heo/gajae-code/pull/150)).
+- Added multi-line focused-option rendering to the `ask` tool's `HookSelectorComponent` via an opt-in `wrapFocused` flag so long option labels stay readable in plan-mode and other shared consumers ([#148](https://github.com/Yeachan-Heo/gajae-code/pull/148)).
+- Added a sanctioned native deep-interview spec persistence bridge so deep-interview can save final specs under `.gjc/specs/` before deliberate ralplan chaining without caller-side `.gjc` writes ([#134](https://github.com/Yeachan-Heo/gajae-code/pull/134)).
+- Added the skill chaining lifecycle's `handoff` state verb with same-turn dispatch and atomic HUD-truth synchronization across callee mode-state, caller mode-state, session active-state, and root active-state ([#132](https://github.com/Yeachan-Heo/gajae-code/pull/132)).
+
+### Changed
+
+- Clarified the README to position team as optional and ultragoal as implementation-through-evidence, so docs readers see workflow handoffs without spelunking into skill sources ([#145](https://github.com/Yeachan-Heo/gajae-code/pull/145)).
+- Migrated CI to the gajae self-hosted Linux runner with fork-PR guards, idempotent `fd` symlink setup, and Node 24 pinning for self-hosted jobs ([#124](https://github.com/Yeachan-Heo/gajae-code/pull/124)).
+
+### Fixed
+
+- Enforced the deep-interview phase boundary so active interviews block mutation tools until a handoff/spec is produced.
+- Made settings theme browsing confirm-only so arrowing through themes no longer changes the rendered theme before the displayed/persisted theme name changes.
+- Made startup CHANGELOG display deterministic by embedding `packages/coding-agent/CHANGELOG.md` into the binary so post-update launches show the shipped history regardless of cwd or `GJC_PACKAGE_DIR`/`PI_PACKAGE_DIR` overrides.
+- Registered `gjc update` as a public root subcommand so it invokes the bundled updater instead of routing into the interactive launcher.
+- Fixed local memory backend persistence so manual enqueue/rebuild starts maintenance immediately and prompt injection reads the active session's memory root.
+- Aligned release-bump CI tests with the highest bundled upstream Claude family and stopped cancelling TTSR retries when an aborted partial was not persisted, so dev PRs no longer regress on v0.2.2-style release assumptions ([#142](https://github.com/Yeachan-Heo/gajae-code/pull/142)).
+- Added a runtime guard in the built-in `skill` tool that rejects re-entry into the currently active skill via a typed active-skill bridge from agent sessions into tool sessions, preventing recursive skill handoffs that prompt-only guidance could not stop ([#129](https://github.com/Yeachan-Heo/gajae-code/pull/129)).
+
+## [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
@@ -89,7 +147,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/setup-cli.d.ts

@@ -5,6 +5,7 @@ export interface SetupCommandArgs {
         json?: boolean;
         check?: boolean;
         force?: boolean;
+        preset?: string;
         compat?: string;
         provider?: string;
         baseUrl?: string;

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/deep-interview.d.ts

@@ -2,6 +2,47 @@ import { Command } from "@gajae-code/utils/cli";
 export default class DeepInterview extends Command {
     static description: string;
     static strict: boolean;
+    static flags: {
+        quick: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        standard: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        deep: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        threshold: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "threshold-source": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "session-id": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        write: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        stage: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        slug: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        spec: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        handoff: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        deliberate: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        json: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            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/setup.d.ts

@@ -24,6 +24,9 @@ export default class Setup extends Command {
         json: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
             description: string;
         };
+        preset: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
         compat: import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
             description: string;
         };

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

@@ -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;
@@ -97,7 +97,7 @@ export declare const ModelsConfigFile: ConfigFile<{
         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?: {

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

@@ -170,8 +170,8 @@ export declare const ModelOverrideSchema: z.ZodObject<{
         stripHeaders: z.ZodOptional<z.ZodArray<z.ZodString>>;
         setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
         extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
 export type ModelOverride = z.infer<typeof ModelOverrideSchema>;
 export declare const ProviderDiscoverySchema: z.ZodObject<{
     type: z.ZodEnum<{
@@ -196,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";
@@ -278,15 +282,19 @@ export declare const ModelsConfigSchema: z.ZodObject<{
             stripHeaders: z.ZodOptional<z.ZodArray<z.ZodString>>;
             setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
             extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>>;
+        }, z.core.$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";
@@ -407,8 +415,8 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 stripHeaders: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
                 extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>>;
+            }, 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>;
@@ -526,11 +534,11 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 stripHeaders: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
                 extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>>;
+            }, 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>>;
@@ -539,5 +547,5 @@ export declare const ModelsConfigSchema: 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"];
@@ -2318,6 +2295,15 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Enable the checkpoint and rewind tools for context checkpointing";
         };
     };
+    readonly "skill.enabled": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Skill";
+            readonly description: "Enable the skill tool so the agent can chain into another available skill on its next turn";
+        };
+    };
     readonly "fetch.enabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -2552,7 +2538,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": {
@@ -2728,6 +2714,33 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Allow subagents spawned via the task tool to use the lsp tool. Off by default to keep subagents cheap; enable when LSP-aware delegation is worth the extra tokens.";
         };
     };
+    readonly "task.forkContext.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "tasks";
+            readonly label: "Fork Context for Subagents";
+            readonly description: "Allow explicitly opted-in subagents to start from a sanitized snapshot of parent context when both the agent and task item also opt in.";
+        };
+    };
+    readonly "task.forkContext.maxMessages": {
+        readonly type: "number";
+        readonly default: 50;
+        readonly ui: {
+            readonly tab: "tasks";
+            readonly label: "Fork Context Max Messages";
+            readonly description: "Maximum parent messages copied into an explicitly opted-in subagent fork-context seed.";
+        };
+    };
+    readonly "task.forkContext.maxTokens": {
+        readonly type: "number";
+        readonly default: 0;
+        readonly ui: {
+            readonly tab: "tasks";
+            readonly label: "Fork Context Max Tokens";
+            readonly description: "Approximate token cap for fork-context seeds. 0 uses 25% of the target model context window.";
+        };
+    };
     readonly "task.maxRecursionDepth": {
         readonly type: "number";
         readonly default: 2;

package/dist/types/discovery/helpers.d.ts

@@ -3,6 +3,7 @@ import type { ExtensionModule } from "../capability/extension-module";
 import { type Rule } from "../capability/rule";
 import type { Skill } from "../capability/skill";
 import type { LoadContext, LoadResult, SourceMeta } from "../capability/types";
+import type { ForkContextPolicy } from "../task/types";
 /**
  * Standard paths for each config source.
  */
@@ -104,6 +105,7 @@ export interface ParsedAgentFields {
     autoloadSkills?: string[];
     blocking?: boolean;
     hide?: boolean;
+    forkContext?: ForkContextPolicy;
 }
 /**
  * Parse agent fields from frontmatter.

package/dist/types/extensibility/extensions/types.d.ts

@@ -50,6 +50,12 @@ export interface ExtensionUIDialogOptions {
     onExternalEditor?: () => void;
     /** Optional footer hint text rendered by interactive selector */
     helpText?: string;
+    /**
+     * For interactive TUI select dialogs, render the focused option across
+     * multiple rows instead of truncating it. This is a select-only rendering
+     * hint; non-TUI bridges (RPC, ACP) drop it and do not serialize it.
+     */
+    wrapFocused?: boolean;
 }
 /** Raw terminal input listener for extensions. */
 export type TerminalInputHandler = (data: string) => {

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

@@ -0,0 +1,33 @@
+/**
+ * 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 interface ResolvedDeepInterviewSpecWriteArgs {
+    stage: "final";
+    slug: string;
+    spec: string;
+    sessionId?: string;
+    json: boolean;
+    deliberate: boolean;
+    handoff?: "ralplan";
+}
+export interface PersistedDeepInterviewSpec {
+    slug: string;
+    path: string;
+    stage: "final";
+    sha256: string;
+    createdAt: string;
+    statePath: string;
+}
+export declare function persistDeepInterviewSpec(cwd: string, resolved: ResolvedDeepInterviewSpecWriteArgs): Promise<PersistedDeepInterviewSpec>;
+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>;