@xopcai/xopc 0.0.179 → 0.0.187

package/dist/src/cli/command-catalog.js

@@ -36,49 +36,6 @@ const cliCommandCatalog = [
 		commandPath: ["onboard"],
 		policy: { loadExtensions: "never" }
 	},
-	{
-		commandPath: ["goal"],
-		policy: { loadExtensions: "never" }
-	},
-	{
-		commandPath: ["goal", "list"],
-		exact: true,
-		policy: { loadExtensions: "never" }
-	},
-	{
-		commandPath: ["goal", "new"],
-		exact: true,
-		policy: { loadExtensions: "never" }
-	},
-	{
-		commandPath: ["goal", "show"],
-		exact: true,
-		policy: { loadExtensions: "never" }
-	},
-	{
-		commandPath: ["goal", "pause"],
-		exact: true,
-		policy: { loadExtensions: "never" }
-	},
-	{
-		commandPath: ["goal", "resume"],
-		exact: true,
-		policy: { loadExtensions: "never" }
-	},
-	{
-		commandPath: ["goal", "archive"],
-		exact: true,
-		policy: { loadExtensions: "never" }
-	},
-	{
-		commandPath: ["goal", "runs"],
-		exact: true,
-		policy: { loadExtensions: "never" }
-	},
-	{
-		commandPath: ["goal", "checklist"],
-		policy: { loadExtensions: "never" }
-	},
 	{
 		commandPath: ["config"],
 		policy: { loadExtensions: "never" }

package/dist/src/cli/command-loaders.js

@@ -13,7 +13,6 @@ const REGISTRY_COMMAND_MODULES = {
 	gateway: () => import("./commands/gateway.js"),
 	session: () => import("./commands/session.js"),
 	project: () => import("./commands/project.js"),
-	goal: () => import("./commands/goal.js"),
 	config: () => import("./commands/config.js"),
 	doctor: () => import("./commands/doctor/index.js"),
 	image: () => import("./commands/image.js"),

package/dist/src/cli/command-manifest.js

@@ -87,10 +87,6 @@ const ROOT_HELP_COMMANDS = [
 		name: "logs",
 		description: "Manage and query logs"
 	},
-	{
-		name: "goal",
-		description: "Manage durable goals"
-	},
 	{
 		name: "config [options]",
 		description: "View and edit configuration"

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -52,7 +52,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v87).`,
+		message: `SQLite schema v${status.dbVersion} (current release v107).`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/gateway/lifecycle-core.js

@@ -166,7 +166,7 @@ async function runServiceRestart(params) {
 			});
 			if (!options.json) process.stdout.write("\n");
 			if (!snapshot.healthy) {
-				fail(`Restart health check failed: ${snapshot.waitOutcome ?? "timeout"}`, ["xopc gateway logs"]);
+				fail(`Restart health check failed: ${snapshot.waitTask ?? "timeout"}`, ["xopc gateway logs"]);
 				return;
 			}
 			emitResult(options, {

package/dist/src/cli/commands/gateway/restart-health.d.ts

@@ -12,7 +12,7 @@ import type { PortUsage } from '../../../infra/ports.js';
 export declare const DEFAULT_RESTART_HEALTH_TIMEOUT_MS = 60000;
 export declare const DEFAULT_RESTART_HEALTH_DELAY_MS = 500;
 export declare const DEFAULT_RESTART_HEALTH_ATTEMPTS: number;
-export type GatewayRestartWaitOutcome = 'healthy' | 'version-mismatch' | 'stale-pids' | 'stopped-free' | 'timeout';
+export type GatewayRestartWaitTask = 'healthy' | 'version-mismatch' | 'stale-pids' | 'stopped-free' | 'timeout';
 export interface GatewayRestartSnapshot {
     runtime?: GatewayServiceRuntime;
     portUsage?: PortUsage;
@@ -24,7 +24,7 @@ export interface GatewayRestartSnapshot {
         expected: string;
         actual: string | null;
     };
-    waitOutcome?: GatewayRestartWaitOutcome;
+    waitTask?: GatewayRestartWaitTask;
     elapsedMs?: number;
 }
 interface RestartHealthService {

package/dist/src/cli/commands/gateway/restart-health.js

@@ -83,7 +83,7 @@ async function waitForRestartHealth(params) {
 					expected: expectedVersion,
 					actual: gatewayVersion
 				},
-				waitOutcome: "version-mismatch",
+				waitTask: "version-mismatch",
 				elapsedMs: elapsed
 			};
 			onProgress?.(snapshot);
@@ -96,7 +96,7 @@ async function waitForRestartHealth(params) {
 			staleGatewayPids,
 			gatewayVersion,
 			expectedVersion,
-			waitOutcome: "healthy",
+			waitTask: "healthy",
 			elapsedMs: elapsed
 		};
 		onProgress?.(snapshot);
@@ -111,7 +111,7 @@ async function waitForRestartHealth(params) {
 		runtime: await service.readRuntime(),
 		healthy: false,
 		staleGatewayPids: [],
-		waitOutcome: "timeout",
+		waitTask: "timeout",
 		elapsedMs: Date.now() - startedAt
 	};
 	log.warn({

package/dist/src/cli/commands/gateway/service.js

@@ -97,12 +97,12 @@ function createServiceStartCommand() {
 		const result = await startGatewayService({ service: await resolveGatewayService() });
 		if (options.json) {
 			console.log(JSON.stringify({
-				ok: result.outcome === "started",
-				outcome: result.outcome
+				ok: result.task === "started",
+				task: result.task
 			}));
 			return;
 		}
-		switch (result.outcome) {
+		switch (result.task) {
 			case "started":
 				console.log("✅ Gateway service started");
 				break;
@@ -116,7 +116,7 @@ function createServiceStartCommand() {
 				console.log("💡 Run: xopc gateway service install --force");
 				process.exit(1);
 				break;
-			default: console.log(`ℹ️  Service start outcome: ${result.outcome}`);
+			default: console.log(`ℹ️  Service start task: ${result.task}`);
 		}
 	});
 }

package/dist/src/cli/commands/onboard/gateway.js

@@ -67,7 +67,7 @@ async function installAndStartGatewayService(config, _ctx) {
 	}
 	const { startGatewayService } = await import("../../../daemon/service.js");
 	const result = await startGatewayService({ service });
-	return result.outcome === "started" || result.outcome === "scheduled";
+	return result.task === "started" || result.task === "scheduled";
 }
 async function startGatewayNow(config, ctx) {
 	const bind = config?.gateway?.bind ?? "loopback";

package/dist/src/cli/commands/project.js

@@ -2,11 +2,11 @@ import { closeXopcDatabase, isXopcDatabaseOpen, openXopcDatabase } from "../../s
 import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
 import "../../storage/sqlite/index.js";
 import { init_loader, loadConfig } from "../../config/loader.js";
-import { GoalService } from "../../goals/goal-service.js";
-import "../../goals/index.js";
+import { TaskRepository } from "../../tasks/task-repository.js";
 import { ProjectService } from "../../projects/project-service.js";
 import { isValidProjectAgentId, normalizeProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
+import "../../tasks/index.js";
 import { formatExamples, register } from "../registry.js";
 import { Command } from "commander";
 //#region src/cli/commands/project.ts
@@ -29,8 +29,8 @@ function resolveProject(projects, ref) {
 function formatProject(project) {
 	const counts = [
 		project.sessionCount != null ? `sessions ${project.sessionCount}` : void 0,
-		project.goalCount != null ? `goals ${project.goalCount}` : void 0,
-		project.activeGoalCount != null ? `active goals ${project.activeGoalCount}` : void 0
+		project.taskCount != null ? `tasks ${project.taskCount}` : void 0,
+		project.activeTaskCount != null ? `active tasks ${project.activeTaskCount}` : void 0
 	].filter(Boolean).join(" | ");
 	return [
 		`${project.id} [${project.status}] ${project.name}`,
@@ -47,8 +47,7 @@ function createProjectCommand(ctx) {
 		"xopc project list",
 		"xopc project new xopc --workspace ~/develop/github/xopc",
 		"xopc project show xopc",
-		"xopc project attach-session <session-key> xopc",
-		"xopc project attach-goal <goal-id> xopc"
+		"xopc project attach-session <session-key> xopc"
 	]));
 	cmd.addCommand(new Command("list").description("List projects").option("--status <status>", "active, paused, or archived").option("--search <query>", "Search by name, slug, or description").option("--limit <n>", "Maximum rows", "20").option("--json", "Output JSON").action(async (options) => {
 		await withProjects(ctx, (projects) => {
@@ -69,7 +68,7 @@ function createProjectCommand(ctx) {
 			for (const project of result.items) console.log(`${formatProject(project)}\n`);
 		});
 	}));
-	cmd.addCommand(new Command("new").description("Create a project").argument("<name>", "Project name").option("--description <text>", "Project description").option("--default-agent <id>", "Default agent id for new project sessions and goals").option("--workspace <path>", "Project workspace root").option("--brief <text>", "Project brief").option("--instructions <text>", "Project instructions").option("--json", "Output JSON").action(async (name, options) => {
+	cmd.addCommand(new Command("new").description("Create a project").argument("<name>", "Project name").option("--description <text>", "Project description").option("--default-agent <id>", "Default agent id for new project sessions and tasks").option("--workspace <path>", "Project workspace root").option("--brief <text>", "Project brief").option("--instructions <text>", "Project instructions").option("--json", "Output JSON").action(async (name, options) => {
 		const cfg = loadConfig(ctx.configPath);
 		const defaultAgentId = normalizeProjectAgentId(options.defaultAgent);
 		if (!isValidProjectAgentId(cfg, defaultAgentId)) {
@@ -110,7 +109,7 @@ function createProjectCommand(ctx) {
 			if (detailed.instructions) console.log(`\nInstructions:\n${detailed.instructions}`);
 		});
 	}));
-	cmd.addCommand(new Command("update").description("Update a project").argument("<project>", "Project id or slug").option("--name <name>", "New name").option("--description <text>", "Project description").option("--default-agent <id>", "Default agent id for new project sessions and goals").option("--clear-default-agent", "Clear project default agent").option("--status <status>", "active, paused, or archived").option("--workspace <path>", "Project workspace root").option("--brief <text>", "Project brief").option("--instructions <text>", "Project instructions").action(async (projectRef, options) => {
+	cmd.addCommand(new Command("update").description("Update a project").argument("<project>", "Project id or slug").option("--name <name>", "New name").option("--description <text>", "Project description").option("--default-agent <id>", "Default agent id for new project sessions and tasks").option("--clear-default-agent", "Clear project default agent").option("--status <status>", "active, paused, or archived").option("--workspace <path>", "Project workspace root").option("--brief <text>", "Project brief").option("--instructions <text>", "Project instructions").action(async (projectRef, options) => {
 		const cfg = loadConfig(ctx.configPath);
 		const defaultAgentId = options.clearDefaultAgent ? null : normalizeProjectAgentId(options.defaultAgent);
 		if (defaultAgentId && !isValidProjectAgentId(cfg, defaultAgentId)) {
@@ -163,23 +162,6 @@ function createProjectCommand(ctx) {
 			console.log("Detached session from project.");
 		});
 	}));
-	cmd.addCommand(new Command("attach-goal").description("Attach a goal to a project").argument("<goal-id>", "Goal id").argument("<project>", "Project id or slug").action(async (goalId, projectRef) => {
-		await withProjects(ctx, (projects) => {
-			const project = resolveProject(projects, projectRef);
-			if (!project) {
-				console.error(`Project not found: ${projectRef}`);
-				process.exit(1);
-			}
-			projects.attachGoal(goalId, project.id);
-			console.log(`Attached goal to ${project.name}`);
-		});
-	}));
-	cmd.addCommand(new Command("detach-goal").description("Detach a goal from its project").argument("<goal-id>", "Goal id").action(async (goalId) => {
-		await withProjects(ctx, (projects) => {
-			projects.detachGoal(goalId);
-			console.log("Detached goal from project.");
-		});
-	}));
 	cmd.addCommand(new Command("sessions").description("List sessions in a project").argument("<project>", "Project id or slug").option("--limit <n>", "Maximum rows", "20").action(async (projectRef, options) => {
 		await withProjects(ctx, (projects) => {
 			const project = resolveProject(projects, projectRef);
@@ -199,22 +181,19 @@ function createProjectCommand(ctx) {
 			}
 		});
 	}));
-	cmd.addCommand(new Command("goals").description("List goals in a project").argument("<project>", "Project id or slug").option("--limit <n>", "Maximum rows", "20").action(async (projectRef, options) => {
+	cmd.addCommand(new Command("tasks").description("List tasks in a project").argument("<project>", "Project id or slug").option("--limit <n>", "Maximum rows", "20").action(async (projectRef, options) => {
 		await withProjects(ctx, (projects) => {
 			const project = resolveProject(projects, projectRef);
 			if (!project) {
 				console.error(`Project not found: ${projectRef}`);
 				process.exit(1);
 			}
-			const goals = new GoalService().list({
-				projectId: project.id,
-				limit: Number(options.limit) || 20
-			});
-			if (!goals.length) {
-				console.log("No goals.");
+			const tasks = new TaskRepository().listByProject(project.id, Number(options.limit) || 20);
+			if (!tasks.length) {
+				console.log("No tasks.");
 				return;
 			}
-			for (const goal of goals) console.log(`${goal.id} [${goal.status}] ${goal.title}`);
+			for (const task of tasks) console.log(`${task.id} [${task.phase}] ${task.title}`);
 		});
 	}));
 	return cmd;

package/dist/src/cli/commands/providers.d.ts

@@ -3,7 +3,7 @@
  *
  * This command sits on top of the existing auth-profile store (`xopc auth …`),
  * but presents a setup-style surface — `list / set-key / unset-key / schema` —
- * with the same `SetupOutcome` JSON contract used by other M1 setup commands.
+ * with the same `SetupTask` JSON contract used by other M1 setup commands.
  * Agents (M2 skills) and the WebUI (M3) can consume both shapes uniformly.
  *
  * Capability-provider (image / voice) settings live under `cfg.providers.<id>`
@@ -11,7 +11,7 @@
  */
 import { type AuthProfileCredential, listAllProfiles } from '../../auth/profiles/index.js';
 import { type ProviderMeta } from '../../providers/index.js';
-import { type SetupOutcome } from './setup-shared/index.js';
+import { type SetupTask } from './setup-shared/index.js';
 type KeyStatus = 'configured' | 'env-only' | 'oauth' | 'not-configured';
 interface ProviderListEntry {
     id: string;
@@ -43,11 +43,11 @@ declare function runSetKey(args: {
     profileId: string;
     key: string;
     options: MutationOptions;
-}): Promise<SetupOutcome>;
+}): Promise<SetupTask>;
 declare function runUnsetKey(args: {
     provider: string;
     profileId: string;
     options: MutationOptions;
-}): Promise<SetupOutcome>;
+}): Promise<SetupTask>;
 export { listProviders, planSetKey, maskKey, runSetKey, runUnsetKey };
 export { listAllProfiles };

package/dist/src/cli/commands/providers.js

@@ -4,7 +4,7 @@ import { formatExamples, register } from "../registry.js";
 import { getProfile, listAllProfiles, listProfilesForProvider, removeAuthProfile, upsertAuthProfile } from "../../auth/profiles/profiles.js";
 import { colors } from "../utils/colors.js";
 import { SETUP_EXIT } from "./setup-shared/types.js";
-import { emitOutcome } from "./setup-shared/output.js";
+import { emitTask } from "./setup-shared/output.js";
 import { isPromptCancelled, promptSecret } from "./setup-shared/prompts.js";
 import "./setup-shared/index.js";
 import { Command } from "commander";
@@ -14,7 +14,7 @@ import { Command } from "commander";
 *
 * This command sits on top of the existing auth-profile store (`xopc auth …`),
 * but presents a setup-style surface — `list / set-key / unset-key / schema` —
-* with the same `SetupOutcome` JSON contract used by other M1 setup commands.
+* with the same `SetupTask` JSON contract used by other M1 setup commands.
 * Agents (M2 skills) and the WebUI (M3) can consume both shapes uniformly.
 *
 * Capability-provider (image / voice) settings live under `cfg.providers.<id>`
@@ -99,10 +99,10 @@ function printListJson(entries) {
 		providers: entries
 	}) + "\n");
 }
-function finalizeProviderOutcome(outcome, options) {
-	emitOutcome(outcome, options.json);
-	process.exitCode = outcome.ok ? SETUP_EXIT.OK : SETUP_EXIT.ERROR;
-	return outcome;
+function finalizeProviderTask(task, options) {
+	emitTask(task, options.json);
+	process.exitCode = task.ok ? SETUP_EXIT.OK : SETUP_EXIT.ERROR;
+	return task;
 }
 function planSetKey(args) {
 	const existing = getProfile(args.profileId);
@@ -118,7 +118,7 @@ function planSetKey(args) {
 }
 async function runSetKey(args) {
 	const meta = PROVIDER_META[args.provider];
-	if (meta && meta.supportsApiKey === false) return finalizeProviderOutcome({
+	if (meta && meta.supportsApiKey === false) return finalizeProviderTask({
 		ok: false,
 		action: "add",
 		domain: "providers",
@@ -130,7 +130,7 @@ async function runSetKey(args) {
 	const { existing, willChange } = planSetKey(args);
 	const changedPaths = willChange ? [`profiles.${args.profileId}.key`] : [];
 	const action = existing ? "set" : "add";
-	if (!willChange) return finalizeProviderOutcome({
+	if (!willChange) return finalizeProviderTask({
 		ok: true,
 		action: "noop",
 		domain: "providers",
@@ -153,7 +153,7 @@ async function runSetKey(args) {
 			}
 		});
 	} catch (error) {
-		return finalizeProviderOutcome({
+		return finalizeProviderTask({
 			ok: false,
 			action,
 			domain: "providers",
@@ -163,7 +163,7 @@ async function runSetKey(args) {
 			errors: [{ message: error.message }]
 		}, args.options);
 	}
-	return finalizeProviderOutcome({
+	return finalizeProviderTask({
 		ok: true,
 		action,
 		domain: "providers",
@@ -177,7 +177,7 @@ async function runSetKey(args) {
 	}, args.options);
 }
 async function runUnsetKey(args) {
-	if (!getProfile(args.profileId)) return finalizeProviderOutcome({
+	if (!getProfile(args.profileId)) return finalizeProviderTask({
 		ok: true,
 		action: "noop",
 		domain: "providers",
@@ -188,7 +188,7 @@ async function runUnsetKey(args) {
 	}, args.options);
 	const changedPaths = [`profiles.${args.profileId}`];
 	if (!args.options.dryRun) removeAuthProfile(args.profileId);
-	return finalizeProviderOutcome({
+	return finalizeProviderTask({
 		ok: true,
 		action: "remove",
 		domain: "providers",
@@ -232,7 +232,7 @@ function emitSchema(opts) {
 					description: "Optional profile id when managing multiple keys per provider."
 				}
 			},
-			outcome: {
+			task: {
 				ok: "boolean",
 				action: "add | set | remove | noop",
 				domain: "providers",
@@ -263,14 +263,14 @@ function createProvidersCommand(_ctx) {
 		if (opts.json) printListJson(entries);
 		else printListText(entries);
 	});
-	cmd.command("set-key <provider>").description("Set or update the API key for a provider (writes an auth profile)").option("--key <value>", `API key value. ${KEY_OPTION_HINT}`).option("--profile <id>", "Profile id (default: <provider>:default)").option("--dry-run", "Show the change without writing", false).option("--json", "Emit a single JSON outcome line", false).action(async (provider, opts) => {
+	cmd.command("set-key <provider>").description("Set or update the API key for a provider (writes an auth profile)").option("--key <value>", `API key value. ${KEY_OPTION_HINT}`).option("--profile <id>", "Profile id (default: <provider>:default)").option("--dry-run", "Show the change without writing", false).option("--json", "Emit a single JSON task line", false).action(async (provider, opts) => {
 		const profileId = opts.profile?.trim() || defaultProfileId(provider);
 		let key = opts.key?.trim();
 		if (!key) try {
 			key = await promptSecret(`API key for ${provider}:`);
 		} catch (error) {
 			if (isPromptCancelled(error)) {
-				emitOutcome({
+				emitTask({
 					ok: false,
 					action: "set",
 					domain: "providers",
@@ -294,7 +294,7 @@ function createProvidersCommand(_ctx) {
 			}
 		});
 	});
-	cmd.command("unset-key <provider>").description("Remove a provider auth profile").option("--profile <id>", "Profile id (default: <provider>:default)").option("--dry-run", "Show the change without writing", false).option("--json", "Emit a single JSON outcome line", false).action(async (provider, opts) => {
+	cmd.command("unset-key <provider>").description("Remove a provider auth profile").option("--profile <id>", "Profile id (default: <provider>:default)").option("--dry-run", "Show the change without writing", false).option("--json", "Emit a single JSON task line", false).action(async (provider, opts) => {
 		await runUnsetKey({
 			provider,
 			profileId: opts.profile?.trim() || defaultProfileId(provider),

package/dist/src/cli/commands/search.js

@@ -3,7 +3,7 @@ import { init_loader, loadConfig } from "../../config/loader.js";
 import { formatExamples, register } from "../registry.js";
 import { colors } from "../utils/colors.js";
 import { SETUP_EXIT } from "./setup-shared/types.js";
-import { emitOutcome } from "./setup-shared/output.js";
+import { emitTask } from "./setup-shared/output.js";
 import { isPromptCancelled, promptSecret } from "./setup-shared/prompts.js";
 import { SetupValidationError, runSetup } from "./setup-shared/runner.js";
 import "./setup-shared/index.js";
@@ -115,12 +115,12 @@ function createSearchCommand(_ctx) {
 		console.log("");
 		console.log(colors.gray(`Supported: ${SEARCH_TYPES.join(", ")}`));
 	});
-	cmd.command("add <type>").description("Add or replace a search provider entry (idempotent by type)").option("--key <value>", "API key (brave / tavily / bing). Prompts securely if omitted.").option("--url <value>", "SearXNG instance URL (required for type=searxng)").option("--dry-run", "Show the change without writing", false).option("--json", "Emit a single JSON outcome line", false).action(async (type, opts, command) => {
+	cmd.command("add <type>").description("Add or replace a search provider entry (idempotent by type)").option("--key <value>", "API key (brave / tavily / bing). Prompts securely if omitted.").option("--url <value>", "SearXNG instance URL (required for type=searxng)").option("--dry-run", "Show the change without writing", false).option("--json", "Emit a single JSON task line", false).action(async (type, opts, command) => {
 		const dryRun = Boolean(opts.dryRun);
 		const json = Boolean(opts.json);
 		const t = type.trim().toLowerCase();
 		if (!isSearchType(t)) {
-			emitOutcome({
+			emitTask({
 				ok: false,
 				action: "add",
 				domain: "search",
@@ -135,7 +135,7 @@ function createSearchCommand(_ctx) {
 		const entry = { type: t };
 		if (t === "searxng") {
 			if (!opts.url) {
-				emitOutcome({
+				emitTask({
 					ok: false,
 					action: "add",
 					domain: "search",
@@ -157,7 +157,7 @@ function createSearchCommand(_ctx) {
 				key = await promptSecret(`API key for ${t}:`);
 			} catch (error) {
 				if (isPromptCancelled(error)) {
-					emitOutcome({
+					emitTask({
 						ok: false,
 						action: "add",
 						domain: "search",
@@ -190,10 +190,10 @@ function createSearchCommand(_ctx) {
 			}
 		});
 	});
-	cmd.command("remove <type>").description("Remove a search provider entry").option("--dry-run", "Show the change without writing", false).option("--json", "Emit a single JSON outcome line", false).action(async (type, opts, command) => {
+	cmd.command("remove <type>").description("Remove a search provider entry").option("--dry-run", "Show the change without writing", false).option("--json", "Emit a single JSON task line", false).action(async (type, opts, command) => {
 		const t = type.trim().toLowerCase();
 		if (!isSearchType(t)) {
-			emitOutcome({
+			emitTask({
 				ok: false,
 				action: "remove",
 				domain: "search",

package/dist/src/cli/commands/setup-shared/index.d.ts

@@ -1,4 +1,4 @@
-export { SETUP_EXIT, type SetupAction, type SetupError, type SetupOutcome, type SetupRunOptions, } from './types.js';
+export { SETUP_EXIT, type SetupAction, type SetupError, type SetupTask, type SetupRunOptions, } from './types.js';
 export { runSetup, runSetupHeadless, SetupValidationError, type SetupMutator, type RunSetupArgs, } from './runner.js';
-export { emitOutcome, printJsonOutcome, printTextOutcome } from './output.js';
+export { emitTask, printJsonTask, printTextTask } from './output.js';
 export { promptSecret, isInteractive, isPromptCancelled } from './prompts.js';

package/dist/src/cli/commands/setup-shared/index.js

@@ -1,5 +1,5 @@
 import { SETUP_EXIT } from "./types.js";
-import { emitOutcome, printJsonOutcome, printTextOutcome } from "./output.js";
+import { emitTask, printJsonTask, printTextTask } from "./output.js";
 import { isInteractive, isPromptCancelled, promptSecret } from "./prompts.js";
 import { SetupValidationError, runSetup, runSetupHeadless } from "./runner.js";
-export { SETUP_EXIT, SetupValidationError, emitOutcome, isInteractive, isPromptCancelled, printJsonOutcome, printTextOutcome, promptSecret, runSetup, runSetupHeadless };
+export { SETUP_EXIT, SetupValidationError, emitTask, isInteractive, isPromptCancelled, printJsonTask, printTextTask, promptSecret, runSetup, runSetupHeadless };

package/dist/src/cli/commands/setup-shared/output.d.ts

@@ -1,9 +1,9 @@
-import type { SetupOutcome } from './types.js';
+import type { SetupTask } from './types.js';
 /**
  * Single-line JSON for `--json` mode. Agents (M2) parse stdout, so we keep
  * this stable: `{ ok, action, domain, target?, changedPaths, dryRun, errors?,
  * value?, notes? }`.
  */
-export declare function printJsonOutcome(outcome: SetupOutcome): void;
-export declare function printTextOutcome(outcome: SetupOutcome): void;
-export declare function emitOutcome(outcome: SetupOutcome, json: boolean): void;
+export declare function printJsonTask(task: SetupTask): void;
+export declare function printTextTask(task: SetupTask): void;
+export declare function emitTask(task: SetupTask, json: boolean): void;

package/dist/src/cli/commands/setup-shared/output.js

@@ -5,18 +5,18 @@ import { colors } from "../../utils/colors.js";
 * this stable: `{ ok, action, domain, target?, changedPaths, dryRun, errors?,
 * value?, notes? }`.
 */
-function printJsonOutcome(outcome) {
+function printJsonTask(task) {
 	const payload = {
-		ok: outcome.ok,
-		action: outcome.action,
-		domain: outcome.domain,
-		changedPaths: outcome.changedPaths,
-		dryRun: outcome.dryRun
+		ok: task.ok,
+		action: task.action,
+		domain: task.domain,
+		changedPaths: task.changedPaths,
+		dryRun: task.dryRun
 	};
-	if (outcome.target !== void 0) payload.target = outcome.target;
-	if (outcome.errors?.length) payload.errors = outcome.errors;
-	if (outcome.value !== void 0) payload.value = outcome.value;
-	if (outcome.notes?.length) payload.notes = outcome.notes;
+	if (task.target !== void 0) payload.target = task.target;
+	if (task.errors?.length) payload.errors = task.errors;
+	if (task.value !== void 0) payload.value = task.value;
+	if (task.notes?.length) payload.notes = task.notes;
 	process.stdout.write(JSON.stringify(payload) + "\n");
 }
 const ACTION_VERB = {
@@ -25,28 +25,28 @@ const ACTION_VERB = {
 	remove: "Removed",
 	noop: "No change"
 };
-function printTextOutcome(outcome) {
-	if (!outcome.ok) {
-		console.error(colors.red("✗") + " " + colors.bold(`${outcome.domain} ${outcome.action}`) + " failed");
-		for (const err of outcome.errors ?? []) {
+function printTextTask(task) {
+	if (!task.ok) {
+		console.error(colors.red("✗") + " " + colors.bold(`${task.domain} ${task.action}`) + " failed");
+		for (const err of task.errors ?? []) {
 			const where = err.path ? colors.gray(`[${err.path}] `) : "";
 			console.error(`  ${where}${err.message}`);
 		}
 		return;
 	}
-	const target = outcome.target ? ` ${colors.bold(outcome.target)}` : "";
-	const verb = ACTION_VERB[outcome.action];
-	const dryRun = outcome.dryRun ? colors.yellow(" [dry-run]") : "";
-	console.log(colors.green("✓") + ` ${verb} ${outcome.domain}${target}${dryRun}`);
-	if (outcome.changedPaths.length > 0) {
+	const target = task.target ? ` ${colors.bold(task.target)}` : "";
+	const verb = ACTION_VERB[task.action];
+	const dryRun = task.dryRun ? colors.yellow(" [dry-run]") : "";
+	console.log(colors.green("✓") + ` ${verb} ${task.domain}${target}${dryRun}`);
+	if (task.changedPaths.length > 0) {
 		console.log(colors.gray("  Changed paths:"));
-		for (const path of outcome.changedPaths) console.log(`    ${colors.cyan(path)}`);
-	} else if (outcome.action === "noop") console.log(colors.gray("  Nothing to change."));
-	for (const note of outcome.notes ?? []) console.log(`  ${colors.gray("→")} ${note}`);
+		for (const path of task.changedPaths) console.log(`    ${colors.cyan(path)}`);
+	} else if (task.action === "noop") console.log(colors.gray("  Nothing to change."));
+	for (const note of task.notes ?? []) console.log(`  ${colors.gray("→")} ${note}`);
 }
-function emitOutcome(outcome, json) {
-	if (json) printJsonOutcome(outcome);
-	else printTextOutcome(outcome);
+function emitTask(task, json) {
+	if (json) printJsonTask(task);
+	else printTextTask(task);
 }
 //#endregion
-export { emitOutcome, printJsonOutcome, printTextOutcome };
+export { emitTask, printJsonTask, printTextTask };

package/dist/src/cli/commands/setup-shared/runner.d.ts

@@ -1,5 +1,5 @@
 import { type Config } from '../../../config/schema.js';
-import { type SetupAction, type SetupError, type SetupOutcome, type SetupRunOptions } from './types.js';
+import { type SetupAction, type SetupError, type SetupTask, type SetupRunOptions } from './types.js';
 /** Thrown by a {@link SetupMutator.mutate} to fail the run with a clean message. */
 export declare class SetupValidationError extends Error {
     readonly errors: SetupError[];
@@ -14,9 +14,9 @@ export interface SetupMutator {
     action: SetupAction;
     /** Mutates `config` in place (or returns a replacement) and returns it. */
     mutate(config: Config): Config | Promise<Config>;
-    /** Optional masked value to surface in the outcome (for agents / UI). */
+    /** Optional masked value to surface in the task (for agents / UI). */
     resultValue?(config: Config): unknown;
-    /** Optional human-readable notes appended to the outcome. */
+    /** Optional human-readable notes appended to the task. */
     notes?(config: Config): string[];
 }
 export interface RunSetupArgs {
@@ -26,24 +26,24 @@ export interface RunSetupArgs {
 }
 /**
  * Headless setup pipeline — load → clone → mutate → validate(zod) → diff →
- * (write | dry-run) → outcome. Returns the {@link SetupOutcome} without any
+ * (write | dry-run) → task. Returns the {@link SetupTask} without any
  * I/O side effects (no stdout, no `process.exitCode`).
  *
  * Used by CLI setup commands via {@link runSetup}. Keep this side-effect-free
  * so it stays safe to call from tests and other programmatic callers.
  *
- * Custom errors thrown by the mutator surface as `errors[]` on the outcome:
+ * Custom errors thrown by the mutator surface as `errors[]` on the task:
  *   - `SetupValidationError` — explicit `{path?, message}[]` entries
  *   - `ExitPromptError` (from `@inquirer/prompts`) — surfaced as "Cancelled by user"
  *   - any other `Error` — the message is used verbatim
  */
-export declare function runSetupHeadless(args: RunSetupArgs): Promise<SetupOutcome>;
+export declare function runSetupHeadless(args: RunSetupArgs): Promise<SetupTask>;
 /**
- * CLI wrapper around {@link runSetupHeadless}: emits the outcome to stdout
+ * CLI wrapper around {@link runSetupHeadless}: emits the task to stdout
  * (text or single-line JSON) and sets `process.exitCode` to the standard
  * setup exit codes (0 ok / 1 error / 2 cancelled).
  *
  * Use this from CLI command actions; use {@link runSetupHeadless} from any
  * non-CLI caller (HTTP routes, library code, tests).
  */
-export declare function runSetup(args: RunSetupArgs): Promise<SetupOutcome>;
+export declare function runSetup(args: RunSetupArgs): Promise<SetupTask>;