@gajae-code/coding-agent 0.3.2 → 0.4.0

package/CHANGELOG.md

@@ -2,12 +2,43 @@
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-06-06
+
+### Added
+
+- Added an agent-driven RPC workflow lifecycle control plane and a `workflow_gate` contract: `negotiate_unattended`, `workflow_gate`, and `workflow_gate_response` frames are validated by an answer-schema validator, persisted through a durable gate broker, and wired into live session dispatch (#314).
+- Added a binding-only `gjc-plugins` sub-skill plugin framework that loads, validates, and activates declarative plugin packs without granting implicit arbitrary execution surface (#347).
+- Added generated JSON Schemas for the config and models files (`schemas/config.schema.json`, `schemas/models.schema.json`) with a `check:schemas` drift gate (#377).
+- Added `cacheRetention` support in the models config (#381).
+- Added an Opus max reasoning preset (#372).
+
+### Changed
+
+- Improved slash command and `skill:*` suggestion ranking so `/team` surfaces the matching skill before weaker fallback candidates.
+
+### Removed
+
+- Removed the optional `@gajae-code/swarm-extension` package and its `gjc-swarm` CLI. The YAML/DAG swarm orchestration extension was a standalone optional feature not imported by any other package; it is no longer built or published.
+
+### Fixed
+
+- Routed unattended deep-interview ask-tool questions through `workflow_gate { kind: "question" }` events, including Round 0 topology and challenge-mode metadata, free-text option/schema shape, headless RPC answers, and synchronous response race handling (#316).
+- Preserved harness owner-vanish evidence after prompt acceptance: no-owner `recover` now either restores a detached owner when a prior endpoint exists or returns a public-safe concrete owner-exit reason plus a vanish receipt, and no-owner `observe`/`events` expose the preserved owner-exit summary.
+- Fixed LSP and MCP server lifecycle cleanup so clients/servers and their child processes are torn down on abort/exit instead of leaking (#389).
+- Preserved session retention across resident session rewrites.
+- Fixed harness session lookup testability without changing runtime owner-routing behavior.
+- Prevented release catalog file specs from recursing during catalog resolution (#351).
+- Reconciled the ultragoal skill mode-state and HUD with the plan/ledger so status reflects real goal progress (#342/#346).
+
 ## [0.3.2] - 2026-06-05
 
 ### Added
 
 - Added model profiles with a `--mpreset <profile>` CLI flag and a `/model` selector "Profiles" section that activate a named profile's default model plus per-agent-role model overrides in one step, validating required-provider credentials before applying and surfacing a custom provider onboarding wizard for missing API-compatible providers.
 - Integrated `ai-slop-cleaner` as an internal Ultragoal sub-skill fragment that runs as the mandatory completion-gate cleanup sweep over a story's changed files, reporting blocking and advisory findings without editing code or mutating `.gjc/` state.
+### Changed
+
+- Edit tool diff generation (`generateDiffString`) now uses the native `diffLines` from `@gajae-code/natives` (a byte-identical Rust port of jsdiff) instead of the pure-JS implementation, removing the multi-second Myers blowup on large-file edits (~16x faster on ~1MB files) with identical diff output.
 
 ### Fixed
 
@@ -15,6 +46,7 @@
 - Forwarded the parent session id when task subagents validate configured role-agent model overrides, preventing session-scoped OAuth providers from being misread as unauthenticated and falling back to the parent chat model.
 - Removed unintended public memory-tool guidance and registration: Hindsight retain/recall/reflect helpers are now compatibility-only, local memory prompt injection no longer advertises `memory://` reads, and regression tests guard the public tool surface.
 - Fixed `read` hashline anchors drifting on truncated reads so the `line+hash` anchors consumed by `edit`/`apply_patch` stay correct when a file is read past the truncation boundary.
+- Reconciled the ultragoal skill mode-state (`current_phase`/`active`) and HUD chip with the `.gjc/ultragoal` plan/ledger on every `gjc ultragoal` command (`create-goals`/`complete-goals`/`checkpoint`/`steer`/`record-review-blockers`/`status`), so `gjc state ultragoal read`, the skill-tool chain guard, and the HUD no longer sit at a stale `active:true`/`goal-planning` after a run completes (#342). A new `reconcileWorkflowSkillState` performs a session-scoped (`GJC_SESSION_ID`) derived write that bypasses only transition-edge validation while preserving schema/unknown-phase validation, version/checksum stamping, and audit provenance (`owner: gjc-runtime`, `verb: reconcile`); reconciliation is best-effort and surfaces failures via stderr and a `reconcile_failed` ledger event without changing command status/stdout. Removed the duplicate sessionless active-state sync from the `gjc ultragoal` command wrapper.
 
 ## [0.3.1] - 2026-06-05
 ### Added

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

@@ -1,4 +1,4 @@
-import { type Api, type AssistantMessageEventStream, type Context, type Model, type ModelRefreshStrategy, type ModelRequestTransform, type SimpleStreamOptions, type ThinkingConfig } from "@gajae-code/ai";
+import { type Api, type AssistantMessageEventStream, type CacheRetention, 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";
@@ -57,6 +57,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                 medium?: string | undefined;
                 high?: string | undefined;
                 xhigh?: string | undefined;
+                max?: string | undefined;
             } | undefined;
             maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
             supportsUsageInStreaming?: boolean | undefined;
@@ -102,11 +103,11 @@ export declare const ModelsConfigFile: ConfigFile<{
             baseUrl?: string | undefined;
             reasoning?: boolean | undefined;
             thinking?: {
-                minLevel: "high" | "low" | "medium" | "minimal" | "xhigh";
-                maxLevel: "high" | "low" | "medium" | "minimal" | "xhigh";
+                minLevel: "high" | "low" | "max" | "medium" | "minimal" | "xhigh";
+                maxLevel: "high" | "low" | "max" | "medium" | "minimal" | "xhigh";
                 mode: "anthropic-adaptive" | "anthropic-budget-effort" | "budget" | "effort" | "google-level";
-                defaultLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
-                levels?: ("high" | "low" | "medium" | "minimal" | "xhigh")[] | undefined;
+                defaultLevel?: "high" | "low" | "max" | "medium" | "minimal" | "xhigh" | undefined;
+                levels?: ("high" | "low" | "max" | "medium" | "minimal" | "xhigh")[] | undefined;
             } | undefined;
             input?: ("image" | "text")[] | undefined;
             cost?: {
@@ -130,6 +131,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                     medium?: string | undefined;
                     high?: string | undefined;
                     xhigh?: string | undefined;
+                    max?: string | undefined;
                 } | undefined;
                 maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
                 supportsUsageInStreaming?: boolean | undefined;
@@ -165,16 +167,17 @@ export declare const ModelsConfigFile: ConfigFile<{
                 setHeaders?: Record<string, string | null> | undefined;
                 extraBody?: Record<string, unknown> | undefined;
             } | undefined;
+            cacheRetention?: "long" | "none" | "short" | undefined;
         }[] | undefined;
         modelOverrides?: Record<string, {
             name?: string | undefined;
             reasoning?: boolean | undefined;
             thinking?: {
-                minLevel: "high" | "low" | "medium" | "minimal" | "xhigh";
-                maxLevel: "high" | "low" | "medium" | "minimal" | "xhigh";
+                minLevel: "high" | "low" | "max" | "medium" | "minimal" | "xhigh";
+                maxLevel: "high" | "low" | "max" | "medium" | "minimal" | "xhigh";
                 mode: "anthropic-adaptive" | "anthropic-budget-effort" | "budget" | "effort" | "google-level";
-                defaultLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
-                levels?: ("high" | "low" | "medium" | "minimal" | "xhigh")[] | undefined;
+                defaultLevel?: "high" | "low" | "max" | "medium" | "minimal" | "xhigh" | undefined;
+                levels?: ("high" | "low" | "max" | "medium" | "minimal" | "xhigh")[] | undefined;
             } | undefined;
             input?: ("image" | "text")[] | undefined;
             cost?: {
@@ -198,6 +201,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                     medium?: string | undefined;
                     high?: string | undefined;
                     xhigh?: string | undefined;
+                    max?: string | undefined;
                 } | undefined;
                 maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
                 supportsUsageInStreaming?: boolean | undefined;
@@ -233,9 +237,11 @@ export declare const ModelsConfigFile: ConfigFile<{
                 setHeaders?: Record<string, string | null> | undefined;
                 extraBody?: Record<string, unknown> | undefined;
             } | undefined;
+            cacheRetention?: "long" | "none" | "short" | undefined;
         }> | undefined;
         disableStrictTools?: boolean | undefined;
         transport?: "pi-native" | undefined;
+        cacheRetention?: "long" | "none" | "short" | undefined;
     }> | undefined;
     modelBindings?: {
         modelRoles?: Record<string, string> | undefined;
@@ -259,6 +265,7 @@ interface ProviderOverride {
     compat?: Model<Api>["compat"];
     transport?: Model<Api>["transport"];
     requestTransform?: ModelRequestTransform;
+    cacheRetention?: CacheRetention;
 }
 /**
  * Merge a freshly discovered model with the matching bundled/configured entry
@@ -276,7 +283,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" | "requestTransform">): Model<TApi>;
+export declare function mergeDiscoveredModel<TApi extends Api>(model: Model<TApi>, existing: Model<Api> | undefined, providerOverride?: Pick<ProviderOverride, "baseUrl" | "headers" | "transport" | "requestTransform" | "cacheRetention">): Model<TApi>;
 export type ProviderDiscoveryStatus = "idle" | "ok" | "empty" | "cached" | "unavailable" | "unauthenticated";
 export interface ProviderDiscoveryState {
     provider: string;

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

@@ -10,6 +10,7 @@ export declare const OpenAICompatSchema: z.ZodObject<{
         medium: z.ZodOptional<z.ZodString>;
         high: z.ZodOptional<z.ZodString>;
         xhigh: z.ZodOptional<z.ZodString>;
+        max: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     maxTokensField: z.ZodOptional<z.ZodEnum<{
         max_completion_tokens: "max_completion_tokens";
@@ -95,6 +96,7 @@ export declare const ModelOverrideSchema: z.ZodObject<{
         minLevel: z.ZodEnum<{
             high: "high";
             low: "low";
+            max: "max";
             medium: "medium";
             minimal: "minimal";
             xhigh: "xhigh";
@@ -102,6 +104,7 @@ export declare const ModelOverrideSchema: z.ZodObject<{
         maxLevel: z.ZodEnum<{
             high: "high";
             low: "low";
+            max: "max";
             medium: "medium";
             minimal: "minimal";
             xhigh: "xhigh";
@@ -116,6 +119,7 @@ export declare const ModelOverrideSchema: z.ZodObject<{
         defaultLevel: z.ZodOptional<z.ZodEnum<{
             high: "high";
             low: "low";
+            max: "max";
             medium: "medium";
             minimal: "minimal";
             xhigh: "xhigh";
@@ -123,6 +127,7 @@ export declare const ModelOverrideSchema: z.ZodObject<{
         levels: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             high: "high";
             low: "low";
+            max: "max";
             medium: "medium";
             minimal: "minimal";
             xhigh: "xhigh";
@@ -153,6 +158,7 @@ export declare const ModelOverrideSchema: z.ZodObject<{
             medium: z.ZodOptional<z.ZodString>;
             high: z.ZodOptional<z.ZodString>;
             xhigh: z.ZodOptional<z.ZodString>;
+            max: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         maxTokensField: z.ZodOptional<z.ZodEnum<{
             max_completion_tokens: "max_completion_tokens";
@@ -206,6 +212,11 @@ export declare const ModelOverrideSchema: z.ZodObject<{
         setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
         extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>>;
+    cacheRetention: z.ZodOptional<z.ZodEnum<{
+        long: "long";
+        none: "none";
+        short: "short";
+    }>>;
 }, z.core.$strict>;
 export type ModelOverride = z.infer<typeof ModelOverrideSchema>;
 export declare const ProviderDiscoverySchema: z.ZodObject<{
@@ -253,6 +264,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 medium: z.ZodOptional<z.ZodString>;
                 high: z.ZodOptional<z.ZodString>;
                 xhigh: z.ZodOptional<z.ZodString>;
+                max: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             maxTokensField: z.ZodOptional<z.ZodEnum<{
                 max_completion_tokens: "max_completion_tokens";
@@ -340,6 +352,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 minLevel: z.ZodEnum<{
                     high: "high";
                     low: "low";
+                    max: "max";
                     medium: "medium";
                     minimal: "minimal";
                     xhigh: "xhigh";
@@ -347,6 +360,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 maxLevel: z.ZodEnum<{
                     high: "high";
                     low: "low";
+                    max: "max";
                     medium: "medium";
                     minimal: "minimal";
                     xhigh: "xhigh";
@@ -361,6 +375,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 defaultLevel: z.ZodOptional<z.ZodEnum<{
                     high: "high";
                     low: "low";
+                    max: "max";
                     medium: "medium";
                     minimal: "minimal";
                     xhigh: "xhigh";
@@ -368,6 +383,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 levels: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                     high: "high";
                     low: "low";
+                    max: "max";
                     medium: "medium";
                     minimal: "minimal";
                     xhigh: "xhigh";
@@ -398,6 +414,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                     medium: z.ZodOptional<z.ZodString>;
                     high: z.ZodOptional<z.ZodString>;
                     xhigh: z.ZodOptional<z.ZodString>;
+                    max: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;
                 maxTokensField: z.ZodOptional<z.ZodEnum<{
                     max_completion_tokens: "max_completion_tokens";
@@ -451,6 +468,11 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
                 extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             }, z.core.$strict>>;
+            cacheRetention: z.ZodOptional<z.ZodEnum<{
+                long: "long";
+                none: "none";
+                short: "short";
+            }>>;
         }, z.core.$strict>>>;
         modelOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
@@ -459,6 +481,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 minLevel: z.ZodEnum<{
                     high: "high";
                     low: "low";
+                    max: "max";
                     medium: "medium";
                     minimal: "minimal";
                     xhigh: "xhigh";
@@ -466,6 +489,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 maxLevel: z.ZodEnum<{
                     high: "high";
                     low: "low";
+                    max: "max";
                     medium: "medium";
                     minimal: "minimal";
                     xhigh: "xhigh";
@@ -480,6 +504,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 defaultLevel: z.ZodOptional<z.ZodEnum<{
                     high: "high";
                     low: "low";
+                    max: "max";
                     medium: "medium";
                     minimal: "minimal";
                     xhigh: "xhigh";
@@ -487,6 +512,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 levels: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                     high: "high";
                     low: "low";
+                    max: "max";
                     medium: "medium";
                     minimal: "minimal";
                     xhigh: "xhigh";
@@ -517,6 +543,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                     medium: z.ZodOptional<z.ZodString>;
                     high: z.ZodOptional<z.ZodString>;
                     xhigh: z.ZodOptional<z.ZodString>;
+                    max: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;
                 maxTokensField: z.ZodOptional<z.ZodEnum<{
                     max_completion_tokens: "max_completion_tokens";
@@ -570,9 +597,19 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
                 extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             }, z.core.$strict>>;
+            cacheRetention: z.ZodOptional<z.ZodEnum<{
+                long: "long";
+                none: "none";
+                short: "short";
+            }>>;
         }, z.core.$strict>>>;
         disableStrictTools: z.ZodOptional<z.ZodBoolean>;
         transport: z.ZodOptional<z.ZodLiteral<"pi-native">>;
+        cacheRetention: z.ZodOptional<z.ZodEnum<{
+            long: "long";
+            none: "none";
+            short: "short";
+        }>>;
     }, z.core.$strict>>>;
     modelBindings: z.ZodOptional<z.ZodObject<{
         modelRoles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;

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

@@ -3216,6 +3216,10 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: 32768;
     };
+    readonly "thinkingBudgets.max": {
+        readonly type: "number";
+        readonly default: 65536;
+    };
 };
 type Schema = typeof SETTINGS_SCHEMA;
 /** All valid setting paths */
@@ -3345,6 +3349,7 @@ export interface ThinkingBudgetsSettings {
     medium: number;
     high: number;
     xhigh: number;
+    max: number;
 }
 export interface SttSettings {
     enabled: boolean;

package/dist/types/edit/diff.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Diff generation and replace-mode utilities for the edit tool.
+ *
+ * Provides diff string generation and the replace-mode edit logic
+ * used when not in patch mode.
+ */
 export interface DiffResult {
     diff: string;
     firstChangedLine: number | undefined;
@@ -21,6 +27,15 @@ export declare class ParseError extends Error {
 export declare class ApplyPatchError extends Error {
     constructor(message: string);
 }
+type DiffLinePart = {
+    added?: boolean;
+    removed?: boolean;
+    value: string;
+};
+type DiffLinesFn = (oldStr: string, newStr: string) => DiffLinePart[];
+export declare function __setDiffLinesForTest(diffLines: DiffLinesFn | null): void;
+export declare function __clearDiffLinesForTest(): void;
+export declare function __getNativeDiffLinesForTest(): DiffLinesFn | undefined;
 /**
  * Generate a unified diff string with line numbers and context.
  * Returns both the diff string and the first changed line number (in the new file).
@@ -57,3 +72,4 @@ export declare function replaceText(content: string, oldText: string, newText: s
  * Used for preview rendering in the TUI before the tool executes.
  */
 export declare function computeEditDiff(path: string, oldText: string, newText: string, cwd: string, fuzzy?: boolean, all?: boolean, threshold?: number): Promise<DiffResult | DiffError>;
+export {};

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

@@ -66,6 +66,12 @@ export declare const DEFAULT_FUZZY_THRESHOLD = 0.95;
 export declare function levenshteinDistance(a: string, b: string): number;
 /** Compute similarity score between two strings (0 to 1) */
 export declare function similarity(a: string, b: string): number;
+interface BestFuzzyMatchResult {
+    best?: FuzzyMatch;
+    aboveThresholdCount: number;
+    secondBestScore: number;
+}
+export declare function findBestFuzzyMatch(content: string, target: string, threshold: number): BestFuzzyMatchResult;
 /**
  * Find a match for target text within content.
  * Used primarily for replace-mode edits.
@@ -140,3 +146,4 @@ export interface ExecuteReplaceSingleOptions {
     beginDeferredDiagnosticsForPath: (path: string) => WritethroughDeferredHandle;
 }
 export declare function executeReplaceSingle(options: ExecuteReplaceSingleOptions): Promise<AgentToolResult<EditToolDetails, typeof replaceEditEntrySchema>>;
+export {};

package/dist/types/extensibility/gjc-plugins/activation.d.ts

@@ -0,0 +1,14 @@
+import { type LoadedSubskillActivation } from "./types";
+export interface SubskillActivationResult {
+    cleanedArgs: string;
+    activation?: LoadedSubskillActivation;
+    activeSubskillsToPersist: LoadedSubskillActivation[];
+}
+export declare function resolveSubskillActivationForSkillInvocation(input: {
+    cwd: string;
+    sessionId?: string;
+    threadId?: string;
+    turnId?: string;
+    skillName: string;
+    args: string;
+}): Promise<SubskillActivationResult>;

package/dist/types/extensibility/gjc-plugins/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./activation";
+export * from "./injection";
+export * from "./loader";
+export * from "./paths";
+export * from "./schema";
+export * from "./state";
+export * from "./tools";
+export * from "./types";
+export * from "./validation";

package/dist/types/extensibility/gjc-plugins/injection.d.ts

@@ -0,0 +1,31 @@
+import { type LoadedSubskillActivation } from "./types";
+export declare function readSubskillBody(filePath: string): Promise<string>;
+export declare function wrapSubskillBlock(activation: {
+    plugin: string;
+    subskillName: string;
+    parent: string;
+    phase: string;
+    activationArg: string;
+    filePath: string;
+}, body: string): string;
+export declare function resolveCurrentPhaseForParent(input: {
+    cwd: string;
+    sessionId?: string;
+    parent: string;
+    explicitPhase?: string;
+}): Promise<string>;
+export declare function buildSubskillInjection(input: {
+    cwd: string;
+    sessionId?: string;
+    skillName: string;
+    activation?: LoadedSubskillActivation;
+    currentPhase?: string;
+}): Promise<{
+    block: string;
+    details?: LoadedSubskillActivation;
+} | null>;
+export declare function buildAgentSubskillInjection(input: {
+    cwd: string;
+    sessionId?: string;
+    agentName: string;
+}): Promise<string>;

package/dist/types/extensibility/gjc-plugins/loader.d.ts

@@ -0,0 +1,3 @@
+import { type LoadedGjcPlugin } from "./types";
+export declare function loadGjcPlugin(root: string): Promise<LoadedGjcPlugin>;
+export declare function loadGjcPlugins(roots: readonly string[]): Promise<LoadedGjcPlugin[]>;

package/dist/types/extensibility/gjc-plugins/paths.d.ts

@@ -0,0 +1,8 @@
+export declare function gjcPluginUserRoot(): string;
+export declare function gjcPluginProjectRoot(cwd: string): string;
+export declare function rootContainsGjcManifest(dir: string): Promise<boolean>;
+export declare function discoverGjcPluginRoots({ cwd }: {
+    cwd: string;
+    home?: string;
+}): Promise<string[]>;
+export declare function resolveWithinRoot(root: string, rel: string): string;

package/dist/types/extensibility/gjc-plugins/schema.d.ts

@@ -0,0 +1,3 @@
+import { type GjcPluginManifest, type SubskillFrontmatter } from "./types";
+export declare function parseManifest(raw: unknown, manifestPath: string): GjcPluginManifest;
+export declare function parseSubskillFrontmatter(fm: Record<string, unknown>, filePath: string): SubskillFrontmatter;

package/dist/types/extensibility/gjc-plugins/state.d.ts

@@ -0,0 +1,9 @@
+import type { ActiveSubskillEntry } from "../../skill-state/active-state";
+import type { LoadedSubskillActivation } from "./types";
+export declare function toActiveSubskillEntry(activation: LoadedSubskillActivation): ActiveSubskillEntry;
+export declare function readActiveSubskillsForParent(input: {
+    cwd: string;
+    sessionId?: string;
+    parent: string;
+    phase: string;
+}): Promise<ActiveSubskillEntry[]>;

package/dist/types/extensibility/gjc-plugins/tools.d.ts

@@ -0,0 +1,8 @@
+import type { CustomTool } from "../custom-tools/types";
+export declare function loadActiveSubskillTools(input: {
+    cwd: string;
+    sessionId?: string;
+    parent: string;
+    phase: string;
+    reservedToolNames?: string[];
+}): Promise<CustomTool[]>;

package/dist/types/extensibility/gjc-plugins/types.d.ts

@@ -0,0 +1,64 @@
+import type { CanonicalGjcWorkflowSkill } from "../../skill-state/active-state";
+export declare const GJC_PLUGIN_MANIFEST_FILENAME = "gajae-plugin.json";
+export declare const GJC_PLUGIN_KIND = "gajae-code-plugin";
+export declare const GJC_SUBSKILL_PARENT_SKILLS: readonly ["deep-interview", "ralplan", "ultragoal", "team"];
+export type GjcSubskillParentSkill = CanonicalGjcWorkflowSkill;
+export declare const GJC_SUBSKILL_PARENT_AGENTS: readonly ["executor", "architect", "planner", "critic"];
+export type GjcSubskillParentAgent = (typeof GJC_SUBSKILL_PARENT_AGENTS)[number];
+export type GjcSubskillParent = GjcSubskillParentSkill | GjcSubskillParentAgent;
+export declare const GJC_AGENT_SUBSKILL_PHASES: Record<GjcSubskillParentAgent, string[]>;
+export interface GjcPluginManifest {
+    name: string;
+    version: string;
+    kind: "gajae-code-plugin";
+    subskills: string[];
+    tools: string[];
+}
+export interface SubskillFrontmatter {
+    name: string;
+    binds_to: string;
+    phase: string;
+    activation_arg: string;
+    description: string;
+}
+export interface LoadedSubskillBinding {
+    plugin: string;
+    subskillName: string;
+    parent: string;
+    bindsTo: string;
+    phase: string;
+    activationArg: string;
+    description: string;
+    filePath: string;
+    body: string;
+    toolPaths: string[];
+}
+export interface LoadedSubskillActivation {
+    activationArg: string;
+    plugin: string;
+    subskillName: string;
+    parent: string;
+    bindsTo: string;
+    phase: string;
+    filePath: string;
+    toolPaths: string[];
+}
+export interface PhaseScopedToolBinding {
+    plugin: string;
+    parent: string;
+    phase: string;
+    toolPath: string;
+}
+export interface LoadedGjcPlugin {
+    name: string;
+    version: string;
+    root: string;
+    manifestPath: string;
+    bindings: LoadedSubskillBinding[];
+    toolBindings: PhaseScopedToolBinding[];
+}
+export type GjcPluginLoadErrorCode = "forbidden_surface" | "invalid_manifest" | "invalid_frontmatter" | "invalid_parent" | "invalid_phase" | "duplicate_arg" | "duplicate_parent_phase" | "missing_file" | "invalid_kind";
+export declare class GjcPluginLoadError extends Error {
+    readonly code: GjcPluginLoadErrorCode;
+    constructor(code: GjcPluginLoadErrorCode, message: string, options?: ErrorOptions);
+}

package/dist/types/extensibility/gjc-plugins/validation.d.ts

@@ -0,0 +1,4 @@
+import { type LoadedSubskillBinding, type SubskillFrontmatter } from "./types";
+export declare function validateBinding(fm: SubskillFrontmatter): void;
+export declare function buildParentArgMap(bindings: readonly LoadedSubskillBinding[]): Map<string, Map<string, LoadedSubskillBinding>>;
+export declare function buildParentPhaseSet(bindings: readonly LoadedSubskillBinding[]): Set<string>;

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

@@ -1,6 +1,7 @@
 import type { SourceMeta } from "../capability/types";
 import type { SkillsSettings } from "../config/settings";
 import type { SkillPromptDetails } from "../session/messages";
+import type { LoadedSubskillActivation } from "./gjc-plugins";
 export interface Skill {
     name: string;
     description: string;
@@ -55,6 +56,13 @@ export interface BuiltSkillPromptMessage {
     message: string;
     details: SkillPromptDetails;
 }
+export interface BuildSkillPromptMessageContext {
+    subskillActivation?: LoadedSubskillActivation;
+    subskillActivationSet?: LoadedSubskillActivation[];
+    currentPhase?: string;
+    cwd?: string;
+    sessionId?: string;
+}
 export declare function getSkillSlashCommandName(skill: Pick<Skill, "name">): string;
 export declare function isNamespacedSkillSlashCommandName(commandName: string): boolean;
 export declare function getSkillSlashCommandNames(skill: Pick<Skill, "name">): string[];
@@ -71,4 +79,4 @@ export interface ParsedSkillInvocation {
 }
 export declare function parseSkillInvocations(text: string, skillsByCommandName: ReadonlyMap<string, Skill>): ParsedSkillInvocation[];
 export declare function resolveSkillSlashCommands(skills: readonly Skill[], _reservedDirectCommandNames: ReadonlySet<string>): ResolvedSkillSlashCommand[];
-export declare function buildSkillPromptMessage(skill: Pick<Skill, "name" | "filePath" | "content">, args: string): Promise<BuiltSkillPromptMessage>;
+export declare function buildSkillPromptMessage(skill: Pick<Skill, "name" | "filePath" | "content">, args: string, context?: BuildSkillPromptMessageContext): Promise<BuiltSkillPromptMessage>;

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

@@ -11,5 +11,27 @@ export interface StateCommandResult {
     stdout?: string;
     stderr?: string;
 }
+/**
+ * Reconcile a workflow skill's mode-state + active-state/HUD from a caller-derived
+ * payload. Unlike `gjc state write`, this is a derived repair: callers reconcile from
+ * an authoritative source (e.g. the ultragoal plan/ledger), where intermediate
+ * aggregate phases like ultragoal `active -> pending` are legitimate, so it bypasses
+ * ONLY verb transition-edge validation while preserving schema validation,
+ * unknown-phase rejection, version/checksum stamping, and audit/out-of-band tamper
+ * detection. Receipts carry `owner: "gjc-runtime"` and `verb: "reconcile"` so the
+ * provenance is distinguishable from a user-initiated write.
+ */
+export declare function reconcileWorkflowSkillState(options: {
+    cwd: string;
+    mode: CanonicalGjcWorkflowSkill;
+    sessionId: string | undefined;
+    threadId?: string;
+    turnId?: string;
+    active: boolean;
+    phase: string;
+    payload: Record<string, unknown>;
+}): Promise<{
+    stateFile: string;
+}>;
 export declare function readWorkflowStateJson(cwd: string, skill: CanonicalGjcWorkflowSkill, sessionId?: string): Promise<Record<string, unknown>>;
 export declare function runNativeStateCommand(args: string[], cwd?: string): Promise<StateCommandResult>;

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

@@ -1,4 +1,4 @@
-import { type WorkflowHudSummary } from "../skill-state/active-state";
+import type { WorkflowHudSummary } from "../skill-state/active-state";
 export type UltragoalGjcGoalMode = "aggregate" | "per-story";
 export type UltragoalGoalStatus = "pending" | "active" | "complete" | "failed" | "blocked" | "review_blocked" | "superseded";
 export interface UltragoalGoal {
@@ -94,7 +94,6 @@ export declare function computeUltragoalPlanGeneration(input: {
 export declare function readUltragoalPlan(cwd: string): Promise<UltragoalPlan | null>;
 export declare function getUltragoalStatus(cwd: string): Promise<UltragoalStatusSummary>;
 export declare function buildUltragoalHudSummary(summary: UltragoalStatusSummary, latestLedger?: UltragoalLedgerEvent): WorkflowHudSummary;
-export declare function syncUltragoalWorkflowState(cwd: string): Promise<void>;
 export declare function createUltragoalPlan(input: {
     cwd: string;
     brief: string;