@kontextmind/kxm 0.7.86 → 0.7.88

package/plugins/kxm/src/state.ts

@@ -184,6 +184,9 @@ export class NativeStateProvider implements StateProvider {
     if (change?.schema !== "kxm.state-change-proposal.v1") {
       throw new ProtocolError(400, "invalid state change proposal schema", "invalid_state_proposal");
     }
+    if (change.origin !== "peer" && change.origin !== "human") {
+      throw new ProtocolError(400, "state change proposal origin must be peer or human", "invalid_state_proposal");
+    }
     const project = requireNonEmpty(change.project, "proposal project");
     const key = requireNonEmpty(change.key, "proposal key");
     const evidenceRefs = boundedRefs(change.evidenceRefs, "proposal evidenceRefs");
@@ -193,7 +196,7 @@ export class NativeStateProvider implements StateProvider {
       project,
       summary: change.summary,
       provenance: {
-        sourceType: change.proposedBy.startsWith("agent_") ? "peer" : "human",
+        sourceType: change.origin,
         sourceRef: `proposed-by:${change.proposedBy}`,
       },
       authority: change.authority,

package/plugins/kxm/src/task-manager.ts

@@ -58,6 +58,14 @@ function tasksDirectory(repoRoot: string): string {
   return resolve(repoRoot, ".kxm", "tasks");
 }
 
+export function goalFilePath(repoRoot: string, goalId: string): string {
+  return join(goalsDirectory(repoRoot), `${goalId}.yaml`);
+}
+
+export function taskFilePath(repoRoot: string, taskId: string): string {
+  return join(tasksDirectory(repoRoot), `${taskId}.yaml`);
+}
+
 export function createGoal(
   repoRoot: string,
   input: {
@@ -66,9 +74,8 @@ export function createGoal(
     successMetrics?: string[] | undefined;
     targetDate?: string | undefined;
   },
+  options: { dryRun?: boolean | undefined } = {},
 ): GoalRecord {
-  const dir = goalsDirectory(repoRoot);
-  mkdirSync(dir, { recursive: true });
 
   const id = `goal_${randomUUID().replaceAll("-", "").slice(0, 12)}`;
   const now = new Date().toISOString();
@@ -84,8 +91,9 @@ export function createGoal(
     updatedAt: now,
   };
 
-  const filePath = join(dir, `${id}.yaml`);
-  writeFileSync(filePath, stringify(record).trim() + "\n", "utf8");
+  if (options.dryRun) return record;
+  mkdirSync(goalsDirectory(repoRoot), { recursive: true });
+  writeFileSync(goalFilePath(repoRoot, id), stringify(record).trim() + "\n", "utf8");
   return record;
 }
 
@@ -123,9 +131,8 @@ export function createTask(
       issueKey: string;
     } | undefined;
   },
+  options: { dryRun?: boolean | undefined } = {},
 ): TaskRecord {
-  const dir = tasksDirectory(repoRoot);
-  mkdirSync(dir, { recursive: true });
 
   const id = `task_${randomUUID().replaceAll("-", "").slice(0, 12)}`;
   const now = new Date().toISOString();
@@ -151,8 +158,9 @@ export function createTask(
     updatedAt: now,
   };
 
-  const filePath = join(dir, `${id}.yaml`);
-  writeFileSync(filePath, stringify(record).trim() + "\n", "utf8");
+  if (options.dryRun) return record;
+  mkdirSync(tasksDirectory(repoRoot), { recursive: true });
+  writeFileSync(taskFilePath(repoRoot, id), stringify(record).trim() + "\n", "utf8");
   return record;
 }
 
@@ -201,7 +209,7 @@ export function updateTaskStatus(
   repoRoot: string,
   taskId: string,
   status: TaskStatus,
-  options: { workflowRunId?: string } = {},
+  options: { workflowRunId?: string; dryRun?: boolean | undefined } = {},
 ): TaskRecord {
   const task = getTask(repoRoot, taskId);
   if (!task) {
@@ -212,8 +220,7 @@ export function updateTaskStatus(
   if (options.workflowRunId) task.workflowRunId = options.workflowRunId;
   task.updatedAt = new Date().toISOString();
 
-  const filePath = join(tasksDirectory(repoRoot), `${taskId}.yaml`);
-  writeFileSync(filePath, stringify(task).trim() + "\n", "utf8");
+  if (!options.dryRun) writeFileSync(taskFilePath(repoRoot, taskId), stringify(task).trim() + "\n", "utf8");
   return task;
 }
 
@@ -223,6 +230,7 @@ export function syncTaskWithTracker(
   options: {
     mockRemoteState?: string;
     commentReceipt?: string;
+    dryRun?: boolean | undefined;
   } = {},
 ): TaskRecord {
   const task = getTask(repoRoot, taskId);
@@ -238,7 +246,6 @@ export function syncTaskWithTracker(
   task.trackerSync.lastSyncedAt = now;
   task.updatedAt = now;
 
-  const filePath = join(tasksDirectory(repoRoot), `${taskId}.yaml`);
-  writeFileSync(filePath, stringify(task).trim() + "\n", "utf8");
+  if (!options.dryRun) writeFileSync(taskFilePath(repoRoot, taskId), stringify(task).trim() + "\n", "utf8");
   return task;
 }

package/plugins/kxm/src/workflow-manager.ts

@@ -326,11 +326,14 @@ export function addWorkflowDefinition(
     repoRoot?: string | undefined;
     userConfigDir?: string | undefined;
     overwrite?: boolean | undefined;
+    dryRun?: boolean | undefined;
   } = {},
 ): { id: string; filePath: string; scope: "global" | "local" } {
   const scope = options.scope ?? "local";
   const repoRoot = options.repoRoot ?? process.cwd();
-  const dir = ensureWorkflowsDirectory(scope, repoRoot, options.userConfigDir);
+  const dir = options.dryRun
+    ? workflowsDirectory(scope, repoRoot, options.userConfigDir)
+    : ensureWorkflowsDirectory(scope, repoRoot, options.userConfigDir);
   const filePath = join(dir, `${workflowId}.yaml`);
 
   if (existsSync(filePath) && !options.overwrite) {
@@ -338,7 +341,7 @@ export function addWorkflowDefinition(
   }
 
   const payload = typeof content === "string" ? content : stringify(content);
-  writeFileSync(filePath, payload, "utf8");
+  if (!options.dryRun) writeFileSync(filePath, payload, "utf8");
   return { id: workflowId, filePath, scope };
 }
 
@@ -348,6 +351,7 @@ export function removeWorkflowDefinition(
     scope?: "global" | "local" | undefined;
     repoRoot?: string | undefined;
     userConfigDir?: string | undefined;
+    dryRun?: boolean | undefined;
   } = {},
 ): { id: string; removed: boolean; filePath: string; scope: "global" | "local" } {
   const scope = options.scope ?? "local";
@@ -359,6 +363,7 @@ export function removeWorkflowDefinition(
     throw new Error(`workflow_not_found: workflow '${workflowId}' not found in ${scope} directory (${filePath})`);
   }
 
+  if (options.dryRun) return { id: workflowId, removed: false, filePath, scope };
   rmSync(filePath);
   return { id: workflowId, removed: true, filePath, scope };
 }
@@ -370,6 +375,7 @@ export function modifyWorkflowDefinition(
     scope?: "global" | "local" | undefined;
     repoRoot?: string | undefined;
     userConfigDir?: string | undefined;
+    dryRun?: boolean | undefined;
   } = {},
 ): { id: string; workflow: Record<string, unknown>; filePath: string; scope: "global" | "local" } {
   const target = getWorkflowDefinition(workflowId, { scope: options.scope, repoRoot: options.repoRoot, userConfigDir: options.userConfigDir });
@@ -384,9 +390,11 @@ export function modifyWorkflowDefinition(
 
   const scope = options.scope ?? target.scope;
   const repoRoot = options.repoRoot ?? process.cwd();
-  const dir = ensureWorkflowsDirectory(scope, repoRoot, options.userConfigDir);
+  const dir = options.dryRun
+    ? workflowsDirectory(scope, repoRoot, options.userConfigDir)
+    : ensureWorkflowsDirectory(scope, repoRoot, options.userConfigDir);
   const filePath = join(dir, `${workflowId}.yaml`);
 
-  writeFileSync(filePath, stringify(updated), "utf8");
+  if (!options.dryRun) writeFileSync(filePath, stringify(updated), "utf8");
   return { id: workflowId, workflow: updated, filePath, scope };
 }