@gajae-code/coding-agent 0.11.8 → 0.11.10

package/src/gjc-runtime/workflow-manifest.ts

@@ -1,7 +1,6 @@
 /**
  * TypeScript is the authoritative source of truth for GJC workflow manifests.
- * Any JSON manifest projection is derived from this module and must never be
- * hand-edited.
+ * Keep the checked-in JSON projection synchronized manually with this module.
  */
 
 import { CANONICAL_GJC_WORKFLOW_SKILLS, type CanonicalGjcWorkflowSkill } from "../skill-state/canonical-skills";
@@ -23,7 +22,9 @@ export interface WorkflowVerb {
 	name: string;
 	planned?: boolean;
 	/** Invocation surface that exposes this verb in the real CLI parser. */
-	surface?: "state-action" | "command-positional" | "command-flag";
+	surface?: "state-action" | "command-positional" | "command-flag" | "draft-action";
+	/** Legacy surface retained for callers that have not migrated to normal typed commands. */
+	compatibilityOnly?: boolean;
 }
 
 export interface TypedArgSpec {
@@ -32,6 +33,7 @@ export interface TypedArgSpec {
 	enumValues?: string[];
 	required?: boolean;
 	appliesToVerbs?: string[];
+	compatibilityOnly?: boolean;
 	planned?: boolean;
 }
 
@@ -93,6 +95,9 @@ function stateVerbs(): WorkflowVerb[] {
 function positionalVerbs(names: readonly string[]): WorkflowVerb[] {
 	return names.map(name => verb(name, "command-positional"));
 }
+function draftVerbs(names: readonly string[]): WorkflowVerb[] {
+	return names.map(name => verb(name, "draft-action"));
+}
 
 function flagVerbs(names: readonly string[]): WorkflowVerb[] {
 	return names.map(name => verb(name, "command-flag"));
@@ -160,19 +165,200 @@ export const WORKFLOW_MANIFEST: Record<CanonicalGjcWorkflowSkill, SkillManifest>
 			{ from: "handoff", to: "complete", verb: "clear" },
 			{ from: "interviewing", to: "complete", verb: "clear" },
 		],
-		verbs: [...stateVerbs(), ...flagVerbs(["kickoff", "write-spec"]), ...plannedVerbs(PLANNED_ADMIN_VERBS)],
+		verbs: [
+			...stateVerbs(),
+			...flagVerbs(["kickoff", "write-spec"]),
+			...draftVerbs(["draft create", "draft edit", "draft show", "draft check", "draft rebase", "draft discard"]),
+			...positionalVerbs([
+				"initialize-context",
+				"confirm-topology",
+				"record-answer",
+				"apply-round-result",
+				"inspect",
+				"sanity-check",
+			]),
+			...plannedVerbs(PLANNED_ADMIN_VERBS),
+		],
 		typedArgs: [
 			{ name: "quick", type: "boolean", appliesToVerbs: ["kickoff"] },
 			{ name: "standard", type: "boolean", appliesToVerbs: ["kickoff"] },
 			{ name: "deep", type: "boolean", appliesToVerbs: ["kickoff"] },
 			{ name: "threshold", type: "number", appliesToVerbs: ["kickoff"] },
 			{ name: "threshold-source", type: "string", appliesToVerbs: ["kickoff"] },
+			{ name: "trace", type: "boolean", appliesToVerbs: ["kickoff"] },
+			{ name: "json", type: "boolean", appliesToVerbs: ["kickoff", "write-spec"] },
 			{ name: "stage", type: "enum", enumValues: ["final"], appliesToVerbs: ["write-spec"] },
 			{ name: "slug", type: "string", appliesToVerbs: ["write-spec"] },
 			{ name: "spec", type: "string", required: true, appliesToVerbs: ["write-spec"] },
 			{ name: "handoff", type: "enum", enumValues: ["ralplan"], appliesToVerbs: ["write-spec"] },
 			{ name: "deliberate", type: "boolean", appliesToVerbs: ["write-spec"] },
-			{ name: "json", type: "boolean", appliesToVerbs: ["write-spec"] },
+			{
+				name: "session-id",
+				type: "string",
+				required: true,
+				appliesToVerbs: ["draft create"],
+			},
+			{
+				name: "for",
+				type: "enum",
+				enumValues: ["initialize-context", "confirm-topology", "record-answer", "apply-round-result"],
+				required: true,
+				appliesToVerbs: ["draft create"],
+			},
+			{ name: "round-key", type: "string", appliesToVerbs: ["draft create"] },
+			{ name: "round", type: "number", appliesToVerbs: ["draft create"] },
+			{ name: "question-id", type: "string", appliesToVerbs: ["draft create"] },
+			{ name: "round-id", type: "string", appliesToVerbs: ["draft create"] },
+			{ name: "component-id", type: "string", appliesToVerbs: ["draft create"] },
+			{ name: "dimension", type: "string", appliesToVerbs: ["draft create"] },
+			{
+				name: "draft-id",
+				type: "string",
+				required: true,
+				appliesToVerbs: [
+					"draft edit",
+					"draft show",
+					"draft check",
+					"draft rebase",
+					"draft discard",
+					"initialize-context",
+					"confirm-topology",
+					"record-answer",
+					"apply-round-result",
+				],
+			},
+			{
+				name: "expected-draft-revision",
+				type: "number",
+				required: true,
+				appliesToVerbs: [
+					"draft edit",
+					"draft rebase",
+					"draft discard",
+					"initialize-context",
+					"confirm-topology",
+					"record-answer",
+					"apply-round-result",
+				],
+			},
+			{
+				name: "op",
+				type: "enum",
+				enumValues: ["set", "append", "remove"],
+				required: true,
+				appliesToVerbs: ["draft edit"],
+			},
+			{ name: "path", type: "string", required: true, appliesToVerbs: ["draft edit"] },
+			{ name: "value", type: "string", appliesToVerbs: ["draft edit"] },
+			{ name: "value-file", type: "string", appliesToVerbs: ["draft edit"] },
+			{ name: "null", type: "boolean", appliesToVerbs: ["draft edit"] },
+			{ name: "to-state-revision", type: "number", required: true, appliesToVerbs: ["draft rebase"] },
+			{
+				name: "json",
+				type: "boolean",
+				required: true,
+				appliesToVerbs: [
+					"draft create",
+					"draft edit",
+					"draft show",
+					"draft check",
+					"draft rebase",
+					"draft discard",
+					"initialize-context",
+					"confirm-topology",
+					"record-answer",
+					"apply-round-result",
+					"inspect",
+					"sanity-check",
+				],
+			},
+			{
+				name: "session-id",
+				type: "string",
+				required: true,
+				appliesToVerbs: ["inspect", "sanity-check"],
+			},
+			{
+				name: "session-id",
+				type: "string",
+				required: true,
+				compatibilityOnly: true,
+				appliesToVerbs: ["initialize-context", "confirm-topology", "record-answer", "apply-round-result"],
+			},
+			{
+				name: "schema-version",
+				type: "number",
+				required: true,
+				compatibilityOnly: true,
+				appliesToVerbs: ["initialize-context", "confirm-topology", "record-answer", "apply-round-result"],
+			},
+			{
+				name: "expected-revision",
+				type: "number",
+				required: true,
+				compatibilityOnly: true,
+				appliesToVerbs: ["initialize-context", "confirm-topology", "record-answer", "apply-round-result"],
+			},
+			{
+				name: "input-json",
+				type: "object",
+				required: true,
+				compatibilityOnly: true,
+				appliesToVerbs: ["initialize-context", "confirm-topology"],
+			},
+			{
+				name: "round",
+				type: "number",
+				required: true,
+				compatibilityOnly: true,
+				appliesToVerbs: ["record-answer", "apply-round-result"],
+			},
+			{
+				name: "question-id",
+				type: "string",
+				required: true,
+				compatibilityOnly: true,
+				appliesToVerbs: ["record-answer", "apply-round-result"],
+			},
+			{
+				name: "round-id",
+				type: "string",
+				compatibilityOnly: true,
+				appliesToVerbs: ["record-answer", "apply-round-result"],
+			},
+			{ name: "component-id", type: "string", compatibilityOnly: true, appliesToVerbs: ["record-answer"] },
+			{ name: "dimension", type: "string", compatibilityOnly: true, appliesToVerbs: ["record-answer"] },
+			{
+				name: "answer-json",
+				type: "object",
+				required: true,
+				compatibilityOnly: true,
+				appliesToVerbs: ["record-answer"],
+			},
+			{
+				name: "question-json",
+				type: "string",
+				required: true,
+				compatibilityOnly: true,
+				appliesToVerbs: ["record-answer"],
+			},
+			{
+				name: "result-json",
+				type: "object",
+				required: true,
+				compatibilityOnly: true,
+				appliesToVerbs: ["apply-round-result"],
+			},
+			{
+				name: "selector",
+				type: "enum",
+				enumValues: ["summary", "recent-scored", "pending", "round", "topology", "facts", "triggers", "floor"],
+				required: true,
+				appliesToVerbs: ["inspect"],
+			},
+			{ name: "round-key", type: "string", appliesToVerbs: ["inspect"] },
+			{ name: "cursor", type: "string", appliesToVerbs: ["inspect"] },
+			{ name: "limit", type: "number", appliesToVerbs: ["inspect"] },
 			{ name: "args", type: "string", planned: true },
 			{ name: "metadata-json", type: "string", planned: true },
 		],

package/src/hooks/skill-state.ts

@@ -3,6 +3,7 @@ import * as path from "node:path";
 import { logger } from "@gajae-code/utils";
 import type { SkillDiscoverySettings } from "../config/skill-settings-defaults";
 import { detectDeepInterviewPlaintextAskLeak } from "../deep-interview/plaintext-gate-guard";
+import { scoreToUnits } from "../gjc-runtime/deep-interview-ambiguity";
 import { activeSnapshotPath, modeStatePath as sessionModeStatePath } from "../gjc-runtime/session-layout";
 import { resolveGjcSessionForRead } from "../gjc-runtime/session-resolution";
 import { ModeStateSchema, SkillActiveStateSchema } from "../gjc-runtime/state-schema";
@@ -410,8 +411,29 @@ async function seedSkillActivationState(
 		...(input.turnId ? { turn_id: input.turnId } : {}),
 	};
 	if (skill === "deep-interview") {
-		modeState.threshold = DEFAULT_DEEP_INTERVIEW_AMBIGUITY_THRESHOLD;
+		const threshold = DEFAULT_DEEP_INTERVIEW_AMBIGUITY_THRESHOLD;
+		const thresholdUnits = scoreToUnits(threshold);
+		modeState.schema_version = 1;
+		modeState.resolution = "standard";
+		modeState.threshold = threshold;
+		modeState.threshold_units = thresholdUnits;
 		modeState.threshold_source = "default";
+		modeState.state = {
+			setup: { status: "unresolved" },
+			type: "greenfield",
+			intent_contract_required: true,
+			rounds: [],
+			established_facts: [],
+			topology: { status: "pending", components: [], deferred_components: [] },
+			ontology_snapshots: [],
+			auto_researched_rounds: [],
+			auto_answered_rounds: [],
+			architect_failures: 0,
+			current_ambiguity: 1.0,
+			threshold,
+			threshold_units: thresholdUnits,
+			threshold_source: "default",
+		};
 	}
 
 	await readExistingStateForMutation(initializedStatePath);