@xopcai/xopc 0.0.110 → 0.0.112

package/dist/src/cli/commands/doctor/checks/cron-health.js

@@ -1,18 +1,7 @@
-import { init_paths, resolveCronDir, resolveCronJobsPath } from "../../../../config/paths.js";
 import { init_loader, loadConfig } from "../../../../config/loader.js";
-import { JobDataSchema } from "../../../../cron/validation.js";
-import { existsSync, readFileSync } from "node:fs";
 //#region src/cli/commands/doctor/checks/cron-health.ts
 init_loader();
-init_paths();
 async function checkCronHealth(ctx) {
-	if (!existsSync(ctx.configPath)) return {
-		id: "cron-health",
-		label: "Cron",
-		status: "skip",
-		message: "No config file; skipped.",
-		hints: []
-	};
 	let cfg;
 	try {
 		cfg = loadConfig(ctx.configPath);
@@ -32,82 +21,12 @@ async function checkCronHealth(ctx) {
 		message: "Cron is disabled in config; skipped.",
 		hints: []
 	};
-	const cronDir = resolveCronDir();
-	if (!existsSync(cronDir)) return {
-		id: "cron-health",
-		label: "Cron",
-		status: "warn",
-		message: "Cron directory does not exist.",
-		hints: [cronDir, "Run: xopc init (creates cron directory)"]
-	};
-	const jobsPath = resolveCronJobsPath();
-	if (!existsSync(jobsPath)) return {
-		id: "cron-health",
-		label: "Cron",
-		status: "warn",
-		message: "Cron jobs file is missing.",
-		hints: [jobsPath]
-	};
-	let raw;
-	try {
-		raw = JSON.parse(readFileSync(jobsPath, "utf-8"));
-	} catch {
-		return {
-			id: "cron-health",
-			label: "Cron",
-			status: "warn",
-			message: "Cron jobs file is not valid JSON.",
-			hints: [jobsPath]
-		};
-	}
-	if (!raw || typeof raw !== "object" || !("jobs" in raw) || !Array.isArray(raw.jobs)) return {
-		id: "cron-health",
-		label: "Cron",
-		status: "warn",
-		message: "Cron jobs file has invalid structure (expected { jobs: [] }).",
-		hints: [jobsPath]
-	};
-	const jobs = raw.jobs;
-	const hints = [];
-	let valid = 0;
-	let enabled = 0;
-	let scheduleMissing = 0;
-	for (const j of jobs) {
-		const r = JobDataSchema.safeParse(j);
-		if (r.success) {
-			valid++;
-			if (r.data.enabled) {
-				enabled++;
-				if (!r.data.schedule?.trim()) {
-					scheduleMissing++;
-					hints.push(`Job "${r.data.name || r.data.id}" is enabled but has no schedule.`);
-				}
-			}
-		} else {
-			hints.push("One or more job entries failed validation (check jobs.json).");
-			break;
-		}
-	}
-	if (valid !== jobs.length) return {
-		id: "cron-health",
-		label: "Cron",
-		status: "warn",
-		message: "Some cron jobs are invalid or could not be validated.",
-		hints: hints.length ? hints.slice(0, 5) : [jobsPath]
-	};
-	if (scheduleMissing > 0) return {
-		id: "cron-health",
-		label: "Cron",
-		status: "warn",
-		message: `${scheduleMissing} enabled job(s) are missing a schedule.`,
-		hints: hints.slice(0, 5)
-	};
 	return {
 		id: "cron-health",
 		label: "Cron",
 		status: "pass",
-		message: `Cron jobs file is valid (${enabled} enabled, ${jobs.length} total).`,
-		hints: [jobsPath]
+		message: "Cron is enabled. Scheduled jobs are stored in SQLite.",
+		hints: ["Run: xopc doctor --deep for SQLite integrity checks."]
 	};
 }
 //#endregion

package/dist/src/cli/commands/doctor/checks/cron-health.js.map

@@ -1 +1 @@
-{"version":3,"file":"cron-health.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/cron-health.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\n\nimport { loadConfig } from '../../../../config/loader.js';\nimport type { Config } from '../../../../config/schema.js';\nimport { resolveCronDir, resolveCronJobsPath } from '../../../../config/paths.js';\nimport { JobDataSchema } from '../../../../cron/validation.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\nexport async function checkCronHealth(ctx: DoctorContext): Promise<CheckResult> {\n  if (!existsSync(ctx.configPath)) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'skip',\n      message: 'No config file; skipped.',\n      hints: [],\n    };\n  }\n\n  let cfg: Config;\n  try {\n    cfg = loadConfig(ctx.configPath);\n  } catch {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'skip',\n      message: 'Config could not be loaded; skipped.',\n      hints: [],\n    };\n  }\n\n  if (cfg.cron?.enabled === false) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'skip',\n      message: 'Cron is disabled in config; skipped.',\n      hints: [],\n    };\n  }\n\n  const cronDir = resolveCronDir();\n  if (!existsSync(cronDir)) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Cron directory does not exist.',\n      hints: [cronDir, 'Run: xopc init (creates cron directory)'],\n    };\n  }\n\n  const jobsPath = resolveCronJobsPath();\n  if (!existsSync(jobsPath)) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Cron jobs file is missing.',\n      hints: [jobsPath],\n    };\n  }\n\n  let raw: unknown;\n  try {\n    raw = JSON.parse(readFileSync(jobsPath, 'utf-8'));\n  } catch {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Cron jobs file is not valid JSON.',\n      hints: [jobsPath],\n    };\n  }\n\n  if (!raw || typeof raw !== 'object' || !('jobs' in raw) || !Array.isArray((raw as { jobs: unknown }).jobs)) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Cron jobs file has invalid structure (expected { jobs: [] }).',\n      hints: [jobsPath],\n    };\n  }\n\n  const jobs = (raw as { jobs: unknown[] }).jobs;\n  const hints: string[] = [];\n  let valid = 0;\n  let enabled = 0;\n  let scheduleMissing = 0;\n\n  for (const j of jobs) {\n    const r = JobDataSchema.safeParse(j);\n    if (r.success) {\n      valid++;\n      if (r.data.enabled) {\n        enabled++;\n        const sched = r.data.schedule?.trim();\n        if (!sched) {\n          scheduleMissing++;\n          hints.push(`Job \"${r.data.name || r.data.id}\" is enabled but has no schedule.`);\n        }\n      }\n    } else {\n      hints.push('One or more job entries failed validation (check jobs.json).');\n      break;\n    }\n  }\n\n  if (valid !== jobs.length) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Some cron jobs are invalid or could not be validated.',\n      hints: hints.length ? hints.slice(0, 5) : [jobsPath],\n    };\n  }\n\n  if (scheduleMissing > 0) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: `${scheduleMissing} enabled job(s) are missing a schedule.`,\n      hints: hints.slice(0, 5),\n    };\n  }\n\n  return {\n    id: 'cron-health',\n    label: 'Cron',\n    status: 'pass',\n    message: `Cron jobs file is valid (${enabled} enabled, ${jobs.length} total).`,\n    hints: [jobsPath],\n  };\n}\n"],"mappings":";;;;;aAE0D;YAEwB;AAIlF,eAAsB,gBAAgB,KAA0C;AAC9E,KAAI,CAAC,WAAW,IAAI,WAAW,CAC7B,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;CAGH,IAAI;AACJ,KAAI;AACF,QAAM,WAAW,IAAI,WAAW;SAC1B;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,EAAE;GACV;;AAGH,KAAI,IAAI,MAAM,YAAY,MACxB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;CAGH,MAAM,UAAU,gBAAgB;AAChC,KAAI,CAAC,WAAW,QAAQ,CACtB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,SAAS,0CAA0C;EAC5D;CAGH,MAAM,WAAW,qBAAqB;AACtC,KAAI,CAAC,WAAW,SAAS,CACvB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,SAAS;EAClB;CAGH,IAAI;AACJ,KAAI;AACF,QAAM,KAAK,MAAM,aAAa,UAAU,QAAQ,CAAC;SAC3C;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,CAAC,SAAS;GAClB;;AAGH,KAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,EAAE,UAAU,QAAQ,CAAC,MAAM,QAAS,IAA0B,KAAK,CACxG,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,SAAS;EAClB;CAGH,MAAM,OAAQ,IAA4B;CAC1C,MAAM,QAAkB,EAAE;CAC1B,IAAI,QAAQ;CACZ,IAAI,UAAU;CACd,IAAI,kBAAkB;AAEtB,MAAK,MAAM,KAAK,MAAM;EACpB,MAAM,IAAI,cAAc,UAAU,EAAE;AACpC,MAAI,EAAE,SAAS;AACb;AACA,OAAI,EAAE,KAAK,SAAS;AAClB;AAEA,QAAI,CADU,EAAE,KAAK,UAAU,MAAM,EACzB;AACV;AACA,WAAM,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,GAAG,mCAAmC;;;SAG9E;AACL,SAAM,KAAK,+DAA+D;AAC1E;;;AAIJ,KAAI,UAAU,KAAK,OACjB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,MAAM,SAAS,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,SAAS;EACrD;AAGH,KAAI,kBAAkB,EACpB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,GAAG,gBAAgB;EAC5B,OAAO,MAAM,MAAM,GAAG,EAAE;EACzB;AAGH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,4BAA4B,QAAQ,YAAY,KAAK,OAAO;EACrE,OAAO,CAAC,SAAS;EAClB"}
+{"version":3,"file":"cron-health.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/cron-health.ts"],"sourcesContent":["import { loadConfig } from '../../../../config/loader.js';\nimport type { Config } from '../../../../config/schema.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\nexport async function checkCronHealth(ctx: DoctorContext): Promise<CheckResult> {\n  let cfg: Config;\n  try {\n    cfg = loadConfig(ctx.configPath);\n  } catch {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'skip',\n      message: 'Config could not be loaded; skipped.',\n      hints: [],\n    };\n  }\n\n  if (cfg.cron?.enabled === false) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'skip',\n      message: 'Cron is disabled in config; skipped.',\n      hints: [],\n    };\n  }\n\n  return {\n    id: 'cron-health',\n    label: 'Cron',\n    status: 'pass',\n    message: 'Cron is enabled. Scheduled jobs are stored in SQLite.',\n    hints: ['Run: xopc doctor --deep for SQLite integrity checks.'],\n  };\n}\n"],"mappings":";;aAA0D;AAI1D,eAAsB,gBAAgB,KAA0C;CAC9E,IAAI;AACJ,KAAI;AACF,QAAM,WAAW,IAAI,WAAW;SAC1B;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,EAAE;GACV;;AAGH,KAAI,IAAI,MAAM,YAAY,MACxB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;AAGH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,uDAAuD;EAChE"}

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 v5).`,
+		message: `SQLite schema v${status.dbVersion} (current release v9).`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/doctor/checks/provider-auth.js

@@ -1,6 +1,6 @@
+import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "../../../../providers/env-keys.js";
 import { getAgentDefaultModelRef, init_schema, parseModelRef } from "../../../../config/schema.js";
 import { init_loader, loadConfig } from "../../../../config/loader.js";
-import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "../../../../providers/env-keys.js";
 import { existsSync } from "node:fs";
 //#region src/cli/commands/doctor/checks/provider-auth.ts
 init_loader();

package/dist/src/cli/commands/doctor/checks/state-integrity.js

@@ -1,5 +1,5 @@
-import { join } from "node:path";
 import { accessSync, chmodSync, constants, existsSync, mkdirSync, statSync } from "node:fs";
+import { join } from "node:path";
 //#region src/cli/commands/doctor/checks/state-integrity.ts
 function isWritable(dir) {
 	try {

package/dist/src/cli/commands/doctor/checks/workspace-status.js

@@ -1,8 +1,8 @@
 import { init_agent_scope, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../../../../agent/agent-scope.js";
 import { WORKSPACE_FILES, init_paths } from "../../../../config/paths.js";
 import { init_loader, loadConfig } from "../../../../config/loader.js";
-import { join } from "node:path";
 import { existsSync } from "node:fs";
+import { join } from "node:path";
 //#region src/cli/commands/doctor/checks/workspace-status.ts
 init_agent_scope();
 init_loader();

package/dist/src/cli/commands/extension-create.js

@@ -1,7 +1,7 @@
 import { PACKAGE_VERSION, init_package_version } from "../../package-version.js";
 import { colors } from "../utils/colors.js";
-import { join, resolve } from "node:path";
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
 import { Command } from "commander";
 //#region src/cli/commands/extension-create.ts
 init_package_version();

package/dist/src/cli/commands/extension-dev.js

@@ -1,7 +1,7 @@
 import { PACKAGE_VERSION, init_package_version } from "../../package-version.js";
+import { init_paths, resolveConfigPath, resolveExtensionsDir } from "../../config/paths.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_paths, resolveConfigPath, resolveExtensionsDir } from "../../config/paths.js";
 import { init_normalize_manifest, normalizeExtensionManifest } from "../../extensions/normalize-manifest.js";
 import { init_loader, loadConfig } from "../../config/loader.js";
 import { checkEngineCompatibility } from "../../extensions/engine-check.js";
@@ -11,8 +11,8 @@ import { runGatewayLoop } from "../../gateway/run-loop.js";
 import "../../gateway/index.js";
 import { colors } from "../utils/colors.js";
 import { initWorkspace } from "../utils/init-workspace.js";
-import { join, resolve } from "node:path";
 import { existsSync, mkdirSync, readFileSync, symlinkSync, unlinkSync, watch } from "node:fs";
+import { join, resolve } from "node:path";
 import { Command } from "commander";
 //#region src/cli/commands/extension-dev.ts
 init_loader();

package/dist/src/cli/commands/extension-marketplace.js

@@ -7,9 +7,9 @@ import { fetchRegistry, findExtension, getExtensionMarketplaceStoreBaseUrl, list
 import { downloadExtensionStoreZipBuffer, resolveExtensionZipDownloadUrl, resolveExtensionsStoreBaseUrl } from "../../agent/skills/marketplace/adapters/store/store-api-client.js";
 import { colors } from "../utils/colors.js";
 import { validateExtensionPackageDirectory } from "./extension-pack.js";
-import { join, resolve } from "node:path";
-import { existsSync, readFileSync, rmSync, statSync } from "node:fs";
 import { createHash } from "node:crypto";
+import { existsSync, readFileSync, rmSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
 import { execSync } from "node:child_process";
 import { confirm } from "@inquirer/prompts";
 import { Command } from "commander";

package/dist/src/cli/commands/extension-pack.js

@@ -5,9 +5,9 @@ import { init_normalize_manifest, normalizeExtensionManifest } from "../../exten
 import { checkEngineCompatibility } from "../../extensions/engine-check.js";
 import { collectExtensionPackageDependencyIssues } from "../../extensions/package-contract.js";
 import { colors } from "../utils/colors.js";
-import { basename, join, relative, resolve } from "node:path";
-import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { basename, join, relative, resolve } from "node:path";
 import { execSync } from "node:child_process";
 import AdmZip from "adm-zip";
 import { Command } from "commander";

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

@@ -1,7 +1,7 @@
 import { PACKAGE_VERSION, init_package_version } from "../../package-version.js";
+import { init_paths, resolveExtensionsDir } from "../../config/paths.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_paths, resolveExtensionsDir } from "../../config/paths.js";
 import { init_loader, loadConfig, saveConfig } from "../../config/loader.js";
 import { checkEngineCompatibility } from "../../extensions/engine-check.js";
 import { ExtensionLoader } from "../../extensions/loader.js";
@@ -14,9 +14,9 @@ import { createExtensionCreateCommand } from "./extension-create.js";
 import { createExtensionDevCommand } from "./extension-dev.js";
 import { createExtensionPackCommand } from "./extension-pack.js";
 import { createExtensionInstallCommand, createExtensionPublishCommand, createExtensionSearchCommand, createExtensionUpdateCommand } from "./extension-marketplace.js";
-import { join } from "node:path";
-import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { createHash } from "node:crypto";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
 import { Command } from "commander";
 //#region src/cli/commands/extension.ts
 init_loader();

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

@@ -1,7 +1,7 @@
 import { getContextWithOpts } from "../../context.js";
-import path from "node:path";
 import { existsSync, statSync, watch } from "node:fs";
 import { readFile } from "node:fs/promises";
+import path from "node:path";
 import { Command } from "commander";
 //#region src/cli/commands/gateway/logs.ts
 function parseLineCount(value) {

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

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+import { type CLIContext } from '../registry.js';
+declare function createGoalCommand(ctx: CLIContext): Command;
+export { createGoalCommand };

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

@@ -0,0 +1,213 @@
+import { init_loader, loadConfig } from "../../config/loader.js";
+import { closeXopcDatabase, openXopcDatabase } from "../../storage/sqlite/connection.js";
+import "../../storage/sqlite/index.js";
+import { GoalService } from "../../goals/goal-service.js";
+import "../../goals/index.js";
+import { formatExamples, register } from "../registry.js";
+import { Command } from "commander";
+//#region src/cli/commands/goal.ts
+init_loader();
+function parseEvidenceKind(raw) {
+	if (raw === "file" || raw === "diff" || raw === "command" || raw === "test" || raw === "link" || raw === "message" || raw === "artifact") return raw;
+	return "message";
+}
+function summarize(goal) {
+	const done = goal.checklist.filter((it) => it.status === "completed" || it.status === "impossible").length;
+	const progress = goal.checklist.length ? ` · checklist ${done}/${goal.checklist.length}` : "";
+	const next = goal.nextAction ? `\n     Next: ${goal.nextAction}` : "";
+	const blocked = goal.blockedReason ? `\n     Blocked: ${goal.blockedReason}` : "";
+	return `  ${goal.id} [${goal.status}] ${goal.title}\n     Agent: ${goal.agentId} · turns ${goal.turnsUsed}/${goal.maxTurns}${progress}${next}${blocked}`;
+}
+async function withGoals(ctx, fn) {
+	openXopcDatabase();
+	try {
+		return await fn(new GoalService());
+	} finally {
+		closeXopcDatabase();
+	}
+}
+function printGoal(goal) {
+	console.log(summarize(goal));
+	if (goal.checklist.length) {
+		console.log("\nChecklist:");
+		goal.checklist.forEach((it, index) => {
+			const marker = it.status === "completed" ? "[x]" : it.status === "impossible" ? "[!]" : "[ ]";
+			const evidence = it.evidenceSummary ? ` (${it.evidenceSummary})` : "";
+			console.log(`  ${index + 1}. ${marker} ${it.text}${evidence}`);
+		});
+	}
+}
+function createGoalCommand(ctx) {
+	const cmd = new Command("goal").description("Manage durable goals").addHelpText("after", formatExamples([
+		"xopc goal list",
+		"xopc goal new \"Ship v0.2 release\"",
+		"xopc goal show <goal-id>",
+		"xopc goal pause <goal-id>",
+		"xopc goal resume <goal-id>",
+		"xopc goal archive <goal-id>",
+		"xopc goal checklist add <goal-id> \"Tests pass\"",
+		"xopc goal evidence add <goal-id> \"CI passed\" --kind test"
+	]));
+	cmd.addCommand(new Command("list").description("List goals").option("--status <status>", "Filter status (comma-separated)").option("--agent-id <id>", "Filter by agent id").option("--session-key <key>", "Filter by linked session").option("--limit <n>", "Maximum rows", "20").action(async (options) => {
+		await withGoals(ctx, async (goals) => {
+			const rows = goals.list({
+				status: options.status?.split(",").map((s) => s.trim()).filter(Boolean),
+				agentId: options.agentId,
+				sessionKey: options.sessionKey,
+				limit: Number(options.limit) || 20
+			});
+			if (!rows.length) {
+				console.log("No goals.");
+				return;
+			}
+			console.log("Goals:\n");
+			rows.forEach((goal) => console.log(`${summarize(goal)}\n`));
+		});
+	}));
+	cmd.addCommand(new Command("new").description("Create a goal").argument("<title>", "Goal title").option("--session-key <key>", "Link to a session key").option("--agent-id <id>", "Agent id").option("--max-turns <n>", "Turn budget").option("--priority <level>", "low, normal, or high", "normal").action(async (title, options) => {
+		const cfg = loadConfig(ctx.configPath);
+		await withGoals(ctx, async (goals) => {
+			const goal = goals.create({
+				title,
+				sessionKey: options.sessionKey,
+				agentId: options.agentId,
+				priority: options.priority === "low" || options.priority === "high" ? options.priority : "normal",
+				maxTurns: options.maxTurns ? Number(options.maxTurns) : void 0,
+				config: cfg,
+				source: "cli"
+			});
+			console.log(`Created goal ${goal.id}`);
+			console.log(`  ${goal.title}`);
+		});
+	}));
+	cmd.addCommand(new Command("show").description("Show a goal").argument("<goal-id>", "Goal id").action(async (goalId) => {
+		await withGoals(ctx, async (goals) => {
+			const goal = goals.get(goalId);
+			if (!goal) {
+				console.error(`Goal not found: ${goalId}`);
+				process.exit(1);
+			}
+			printGoal(goal);
+		});
+	}));
+	for (const [name, description] of [
+		["pause", "Pause a goal"],
+		["resume", "Resume a goal"],
+		["archive", "Archive a goal"]
+	]) cmd.addCommand(new Command(name).description(description).argument("<goal-id>", "Goal id").action(async (goalId) => {
+		await withGoals(ctx, async (goals) => {
+			const goal = name === "pause" ? goals.pause(goalId) : name === "resume" ? goals.resume(goalId) : goals.archive(goalId);
+			if (!goal) {
+				console.error(`Goal not found: ${goalId}`);
+				process.exit(1);
+			}
+			console.log(`${description}: ${goal.title}`);
+		});
+	}));
+	cmd.addCommand(new Command("runs").description("List goal runs").argument("<goal-id>", "Goal id").option("--limit <n>", "Maximum rows", "20").action(async (goalId, options) => {
+		await withGoals(ctx, async (goals) => {
+			const runs = goals.listRuns(goalId, Number(options.limit) || 20);
+			if (!runs.length) {
+				console.log("No runs.");
+				return;
+			}
+			runs.forEach((run) => {
+				const at = new Date(run.finishedAt ?? run.startedAt).toISOString();
+				console.log(`  ${run.id} [${run.verdict ?? run.status}] ${at}`);
+				if (run.reason) console.log(`     ${run.reason}`);
+			});
+		});
+	}));
+	const checklist = new Command("checklist").description("Manage goal checklist");
+	checklist.addCommand(new Command("add").argument("<goal-id>", "Goal id").argument("<text>", "Checklist item").action(async (goalId, text) => {
+		await withGoals(ctx, async (goals) => {
+			const goal = goals.updateChecklist(goalId, {
+				type: "add",
+				text
+			});
+			if (!goal) {
+				console.error(`Goal not found: ${goalId}`);
+				process.exit(1);
+			}
+			console.log(`Added checklist item to ${goal.title}`);
+		});
+	}));
+	checklist.addCommand(new Command("mark").argument("<goal-id>", "Goal id").argument("<number>", "1-based checklist item number").argument("<status>", "pending, completed, or impossible").action(async (goalId, number, status) => {
+		await withGoals(ctx, async (goals) => {
+			const goal = goals.get(goalId);
+			const item = goal?.checklist[Number(number) - 1];
+			if (!goal || !item) {
+				console.error(`Checklist item not found: ${number}`);
+				process.exit(1);
+			}
+			if (status !== "pending" && status !== "completed" && status !== "impossible") {
+				console.error("Status must be pending, completed, or impossible");
+				process.exit(1);
+			}
+			goals.updateChecklist(goalId, {
+				type: "mark",
+				itemId: item.id,
+				status
+			});
+			console.log(`Marked item #${number} ${status}`);
+		});
+	}));
+	cmd.addCommand(checklist);
+	const evidence = new Command("evidence").description("Manage goal evidence");
+	evidence.addCommand(new Command("list").argument("<goal-id>", "Goal id").option("--limit <n>", "Maximum rows", "20").action(async (goalId, options) => {
+		await withGoals(ctx, async (goals) => {
+			if (!goals.get(goalId)) {
+				console.error(`Goal not found: ${goalId}`);
+				process.exit(1);
+			}
+			const rows = goals.listEvidence(goalId, Number(options.limit) || 20);
+			if (!rows.length) {
+				console.log("No evidence.");
+				return;
+			}
+			rows.forEach((item) => {
+				const at = new Date(item.createdAt).toISOString();
+				console.log(`  ${item.id} [${item.kind}] ${item.title} · ${at}`);
+				if (item.uri) console.log(`     URI: ${item.uri}`);
+				if (item.summary) console.log(`     ${item.summary}`);
+			});
+		});
+	}));
+	evidence.addCommand(new Command("add").argument("<goal-id>", "Goal id").argument("<title>", "Evidence title").option("--kind <kind>", "file, diff, command, test, link, message, or artifact", "message").option("--summary <text>", "Evidence summary").option("--uri <uri>", "URI or local path").action(async (goalId, title, options) => {
+		await withGoals(ctx, async (goals) => {
+			if (!goals.get(goalId)) {
+				console.error(`Goal not found: ${goalId}`);
+				process.exit(1);
+			}
+			const evidence = goals.addEvidence({
+				goalId,
+				kind: parseEvidenceKind(options.kind),
+				title,
+				summary: typeof options.summary === "string" ? options.summary : void 0,
+				uri: typeof options.uri === "string" ? options.uri : void 0
+			});
+			console.log(`Added evidence ${evidence.id}`);
+			console.log(`  [${evidence.kind}] ${evidence.title}`);
+		});
+	}));
+	cmd.addCommand(evidence);
+	return cmd;
+}
+register({
+	id: "goal",
+	name: "goal",
+	description: "Manage durable goals",
+	factory: createGoalCommand,
+	metadata: {
+		category: "utility",
+		examples: [
+			"xopc goal list",
+			"xopc goal new \"Ship the release\"",
+			"xopc goal show <goal-id>"
+		]
+	}
+});
+//#endregion
+export { createGoalCommand };
+
+//# sourceMappingURL=goal.js.map

package/dist/src/cli/commands/goal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal.js","names":[],"sources":["../../../../src/cli/commands/goal.ts"],"sourcesContent":["import { Command } from 'commander';\n\nimport { loadConfig } from '../../config/loader.js';\nimport { closeXopcDatabase, openXopcDatabase } from '../../storage/sqlite/index.js';\nimport { GoalService, type GoalEvidence, type GoalWithDetails } from '../../goals/index.js';\nimport { register, formatExamples, type CLIContext } from '../registry.js';\n\ntype EvidenceKind = GoalEvidence['kind'];\n\nfunction parseEvidenceKind(raw: string | undefined): EvidenceKind {\n  if (\n    raw === 'file' ||\n    raw === 'diff' ||\n    raw === 'command' ||\n    raw === 'test' ||\n    raw === 'link' ||\n    raw === 'message' ||\n    raw === 'artifact'\n  ) {\n    return raw;\n  }\n  return 'message';\n}\n\nfunction summarize(goal: GoalWithDetails): string {\n  const done = goal.checklist.filter((it) => it.status === 'completed' || it.status === 'impossible').length;\n  const progress = goal.checklist.length ? ` · checklist ${done}/${goal.checklist.length}` : '';\n  const next = goal.nextAction ? `\\n     Next: ${goal.nextAction}` : '';\n  const blocked = goal.blockedReason ? `\\n     Blocked: ${goal.blockedReason}` : '';\n  return `  ${goal.id} [${goal.status}] ${goal.title}\\n     Agent: ${goal.agentId} · turns ${goal.turnsUsed}/${goal.maxTurns}${progress}${next}${blocked}`;\n}\n\nasync function withGoals<T>(ctx: CLIContext, fn: (goals: GoalService) => Promise<T> | T): Promise<T> {\n  openXopcDatabase();\n  try {\n    return await fn(new GoalService());\n  } finally {\n    closeXopcDatabase();\n  }\n}\n\nfunction printGoal(goal: GoalWithDetails): void {\n  console.log(summarize(goal));\n  if (goal.checklist.length) {\n    console.log('\\nChecklist:');\n    goal.checklist.forEach((it, index) => {\n      const marker = it.status === 'completed' ? '[x]' : it.status === 'impossible' ? '[!]' : '[ ]';\n      const evidence = it.evidenceSummary ? ` (${it.evidenceSummary})` : '';\n      console.log(`  ${index + 1}. ${marker} ${it.text}${evidence}`);\n    });\n  }\n}\n\nfunction createGoalCommand(ctx: CLIContext): Command {\n  const cmd = new Command('goal')\n    .description('Manage durable goals')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc goal list',\n        'xopc goal new \"Ship v0.2 release\"',\n        'xopc goal show <goal-id>',\n        'xopc goal pause <goal-id>',\n        'xopc goal resume <goal-id>',\n        'xopc goal archive <goal-id>',\n        'xopc goal checklist add <goal-id> \"Tests pass\"',\n        'xopc goal evidence add <goal-id> \"CI passed\" --kind test',\n      ]),\n    );\n\n  cmd.addCommand(\n    new Command('list')\n      .description('List goals')\n      .option('--status <status>', 'Filter status (comma-separated)')\n      .option('--agent-id <id>', 'Filter by agent id')\n      .option('--session-key <key>', 'Filter by linked session')\n      .option('--limit <n>', 'Maximum rows', '20')\n      .action(async (options) => {\n        await withGoals(ctx, async (goals) => {\n          const rows = goals.list({\n            status: options.status?.split(',').map((s: string) => s.trim()).filter(Boolean),\n            agentId: options.agentId,\n            sessionKey: options.sessionKey,\n            limit: Number(options.limit) || 20,\n          });\n          if (!rows.length) {\n            console.log('No goals.');\n            return;\n          }\n          console.log('Goals:\\n');\n          rows.forEach((goal) => console.log(`${summarize(goal)}\\n`));\n        });\n      }),\n  );\n\n  cmd.addCommand(\n    new Command('new')\n      .description('Create a goal')\n      .argument('<title>', 'Goal title')\n      .option('--session-key <key>', 'Link to a session key')\n      .option('--agent-id <id>', 'Agent id')\n      .option('--max-turns <n>', 'Turn budget')\n      .option('--priority <level>', 'low, normal, or high', 'normal')\n      .action(async (title, options) => {\n        const cfg = loadConfig(ctx.configPath);\n        await withGoals(ctx, async (goals) => {\n          const goal = goals.create({\n            title,\n            sessionKey: options.sessionKey,\n            agentId: options.agentId,\n            priority: options.priority === 'low' || options.priority === 'high' ? options.priority : 'normal',\n            maxTurns: options.maxTurns ? Number(options.maxTurns) : undefined,\n            config: cfg,\n            source: 'cli',\n          });\n          console.log(`Created goal ${goal.id}`);\n          console.log(`  ${goal.title}`);\n        });\n      }),\n  );\n\n  cmd.addCommand(\n    new Command('show')\n      .description('Show a goal')\n      .argument('<goal-id>', 'Goal id')\n      .action(async (goalId) => {\n        await withGoals(ctx, async (goals) => {\n          const goal = goals.get(goalId);\n          if (!goal) {\n            console.error(`Goal not found: ${goalId}`);\n            process.exit(1);\n          }\n          printGoal(goal);\n        });\n      }),\n  );\n\n  for (const [name, description] of [\n    ['pause', 'Pause a goal'],\n    ['resume', 'Resume a goal'],\n    ['archive', 'Archive a goal'],\n  ] as const) {\n    cmd.addCommand(\n      new Command(name)\n        .description(description)\n        .argument('<goal-id>', 'Goal id')\n        .action(async (goalId) => {\n          await withGoals(ctx, async (goals) => {\n            const goal =\n              name === 'pause' ? goals.pause(goalId) : name === 'resume' ? goals.resume(goalId) : goals.archive(goalId);\n            if (!goal) {\n              console.error(`Goal not found: ${goalId}`);\n              process.exit(1);\n            }\n            console.log(`${description}: ${goal.title}`);\n          });\n        }),\n    );\n  }\n\n  cmd.addCommand(\n    new Command('runs')\n      .description('List goal runs')\n      .argument('<goal-id>', 'Goal id')\n      .option('--limit <n>', 'Maximum rows', '20')\n      .action(async (goalId, options) => {\n        await withGoals(ctx, async (goals) => {\n          const runs = goals.listRuns(goalId, Number(options.limit) || 20);\n          if (!runs.length) {\n            console.log('No runs.');\n            return;\n          }\n          runs.forEach((run) => {\n            const at = new Date(run.finishedAt ?? run.startedAt).toISOString();\n            console.log(`  ${run.id} [${run.verdict ?? run.status}] ${at}`);\n            if (run.reason) console.log(`     ${run.reason}`);\n          });\n        });\n      }),\n  );\n\n  const checklist = new Command('checklist').description('Manage goal checklist');\n  checklist.addCommand(\n    new Command('add')\n      .argument('<goal-id>', 'Goal id')\n      .argument('<text>', 'Checklist item')\n      .action(async (goalId, text) => {\n        await withGoals(ctx, async (goals) => {\n          const goal = goals.updateChecklist(goalId, { type: 'add', text });\n          if (!goal) {\n            console.error(`Goal not found: ${goalId}`);\n            process.exit(1);\n          }\n          console.log(`Added checklist item to ${goal.title}`);\n        });\n      }),\n  );\n  checklist.addCommand(\n    new Command('mark')\n      .argument('<goal-id>', 'Goal id')\n      .argument('<number>', '1-based checklist item number')\n      .argument('<status>', 'pending, completed, or impossible')\n      .action(async (goalId, number, status) => {\n        await withGoals(ctx, async (goals) => {\n          const goal = goals.get(goalId);\n          const item = goal?.checklist[Number(number) - 1];\n          if (!goal || !item) {\n            console.error(`Checklist item not found: ${number}`);\n            process.exit(1);\n          }\n          if (status !== 'pending' && status !== 'completed' && status !== 'impossible') {\n            console.error('Status must be pending, completed, or impossible');\n            process.exit(1);\n          }\n          goals.updateChecklist(goalId, { type: 'mark', itemId: item.id, status });\n          console.log(`Marked item #${number} ${status}`);\n        });\n      }),\n  );\n  cmd.addCommand(checklist);\n\n  const evidence = new Command('evidence').description('Manage goal evidence');\n  evidence.addCommand(\n    new Command('list')\n      .argument('<goal-id>', 'Goal id')\n      .option('--limit <n>', 'Maximum rows', '20')\n      .action(async (goalId, options) => {\n        await withGoals(ctx, async (goals) => {\n          if (!goals.get(goalId)) {\n            console.error(`Goal not found: ${goalId}`);\n            process.exit(1);\n          }\n          const rows = goals.listEvidence(goalId, Number(options.limit) || 20);\n          if (!rows.length) {\n            console.log('No evidence.');\n            return;\n          }\n          rows.forEach((item) => {\n            const at = new Date(item.createdAt).toISOString();\n            console.log(`  ${item.id} [${item.kind}] ${item.title} · ${at}`);\n            if (item.uri) console.log(`     URI: ${item.uri}`);\n            if (item.summary) console.log(`     ${item.summary}`);\n          });\n        });\n      }),\n  );\n  evidence.addCommand(\n    new Command('add')\n      .argument('<goal-id>', 'Goal id')\n      .argument('<title>', 'Evidence title')\n      .option('--kind <kind>', 'file, diff, command, test, link, message, or artifact', 'message')\n      .option('--summary <text>', 'Evidence summary')\n      .option('--uri <uri>', 'URI or local path')\n      .action(async (goalId, title, options) => {\n        await withGoals(ctx, async (goals) => {\n          if (!goals.get(goalId)) {\n            console.error(`Goal not found: ${goalId}`);\n            process.exit(1);\n          }\n          const evidence = goals.addEvidence({\n            goalId,\n            kind: parseEvidenceKind(options.kind),\n            title,\n            summary: typeof options.summary === 'string' ? options.summary : undefined,\n            uri: typeof options.uri === 'string' ? options.uri : undefined,\n          });\n          console.log(`Added evidence ${evidence.id}`);\n          console.log(`  [${evidence.kind}] ${evidence.title}`);\n        });\n      }),\n  );\n  cmd.addCommand(evidence);\n\n  return cmd;\n}\n\nregister({\n  id: 'goal',\n  name: 'goal',\n  description: 'Manage durable goals',\n  factory: createGoalCommand,\n  metadata: {\n    category: 'utility',\n    examples: ['xopc goal list', 'xopc goal new \"Ship the release\"', 'xopc goal show <goal-id>'],\n  },\n});\n\nexport { createGoalCommand };\n"],"mappings":"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"}

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

@@ -8,8 +8,8 @@ import { formatExamples, register } from "../registry.js";
 import { getContextWithOpts } from "../context.js";
 import "../../agent/image/index.js";
 import { colors } from "../utils/colors.js";
-import { join, resolve } from "node:path";
 import { mkdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
 import { Command } from "commander";
 //#region src/cli/commands/image.ts
 init_loader();

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

@@ -1,12 +1,12 @@
 import { resolveStateDir } from "../../config/paths-state.js";
 import { resolveAgentWorkspaceDir } from "../../agent/agent-scope.js";
+import { WORKSPACE_FILES, init_paths, resolveAgentDir, resolveAgentHomeDir, resolveAgentProfileDir, resolveConfigPath } from "../../config/paths.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { WORKSPACE_FILES, init_paths, resolveAgentDir, resolveAgentHomeDir, resolveAgentProfileDir, resolveConfigPath } from "../../config/paths.js";
 import { init_loader, loadConfig, saveConfig } from "../../config/loader.js";
 import { formatExamples, register } from "../registry.js";
-import { join } from "path";
 import { existsSync } from "fs";
+import { join } from "path";
 import { mkdir, writeFile } from "fs/promises";
 import { Command } from "commander";
 //#region src/cli/commands/init.ts

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

@@ -1,5 +1,5 @@
-import { loadConfig, saveConfig } from "../../config/loader.js";
 import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
+import { loadConfig, saveConfig } from "../../config/loader.js";
 import { getAllModels, getAvailableModels, getConfiguredProviders, getProviderAuthState, getProviderDisplayName, init_providers, isProviderConfigured, providerSupportsApiKey, providerSupportsOAuth, resolveModel } from "../../providers/index.js";
 import { formatExamples, register } from "../registry.js";
 import { getContextWithOpts } from "../context.js";

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

@@ -15,6 +15,10 @@ init_schema();
 function isInteractive() {
 	return process.stdin.isTTY && process.stdout.isTTY;
 }
+function printGitHubStarHint() {
+	console.log("\n⭐ If xopc helps you keep long-term AI work moving, please star the repo:");
+	console.log("   https://github.com/xopcai/xopc");
+}
 async function setupNonInteractive(_configPath, existingConfig) {
 	console.log("\n🤖 AI Model Configuration (Non-Interactive Mode)\n");
 	console.log("Current config:", JSON.stringify(existingConfig.agents?.defaults?.models?.chat, null, 2));
@@ -25,10 +29,11 @@ async function setupNonInteractive(_configPath, existingConfig) {
 function createOnboardCommand(ctx) {
 	return new Command("onboard").description("Interactive setup wizard for xopc (gateway uses schema defaults)").addHelpText("after", formatExamples([
 		"xopc onboard              # Full interactive setup",
+		"xopc onboard --quick      # Configure model only, then launch locally",
 		"xopc onboard --model      # Configure LLM model only",
 		"xopc onboard --channels   # Configure messaging channels",
 		"xopc onboard --gateway    # Apply default gateway settings (quiet)"
-	])).option("--model", "Configure LLM provider and model").option("--channels", "Configure messaging channels").option("--gateway", "Configure gateway WebUI").option("--all", "Configure everything (default)").action(async (options) => {
+	])).option("--quick", "Configure model only, then launch locally").option("--model", "Configure LLM provider and model").option("--channels", "Configure messaging channels").option("--gateway", "Configure gateway WebUI").option("--all", "Configure everything (default)").action(async (options) => {
 		try {
 			await runOnboard(options, ctx);
 		} catch (error) {
@@ -50,10 +55,10 @@ async function runOnboard(options, ctx) {
 		configPath,
 		workspacePath
 	})).config;
-	const doModel = options.model || options.all || !options.channels && !options.gateway;
-	const doChannels = options.channels || options.all || !options.model && !options.gateway;
-	const doGateway = options.gateway || options.all || !options.model && !options.channels;
-	const runFullWizard = !options.model && !options.channels && !options.gateway;
+	const doModel = options.quick || options.model || options.all || !options.channels && !options.gateway;
+	const doChannels = !options.quick && (options.channels || options.all || !options.model && !options.gateway);
+	const doGateway = !options.quick && (options.gateway || options.all || !options.model && !options.channels);
+	const runFullWizard = !options.quick && !options.model && !options.channels && !options.gateway;
 	/** Any setup step besides the unified launch prompt ran in interactive flow. */
 	const didConfigurableSteps = doModel || doChannels || doGateway;
 	if (!isInteractive()) {
@@ -117,6 +122,7 @@ async function runOnboard(options, ctx) {
 	console.log("\n📁 Files:");
 	console.log("  Config:", configPath);
 	console.log("  Workspace:", workspacePath);
+	printGitHubStarHint();
 	if (isInteractive() && didConfigurableSteps) await promptLaunchAfterOnboard(config, ctx, { doChannels });
 	process.exit(0);
 }