@iowarp/clio-coder 0.4.7 → 0.4.9

package/dist/{chunk-KKEYGFX4.js → chunk-7QQRPB2E.js}

@@ -4,28 +4,28 @@ import {
   parseFrontmatter,
   resolvePackagePathReference,
   resolvePackageReferences
-} from "./chunk-YKRJTYNP.js";
-import {
-  value_exports
-} from "./chunk-SER7RRAE.js";
-import {
-  typebox_exports
-} from "./chunk-GH5ZR6JP.js";
+} from "./chunk-6UJ7RDI7.js";
 import {
   PATH_BOUNDARY_MAX_ENTRIES,
   normalizePathBoundary,
   normalizePathBoundaryEntry,
   pathBoundaryCovers
 } from "./chunk-R2P2U3ZS.js";
-import {
-  resolvePackageRoot
-} from "./chunk-E3LEPLQ2.js";
 import {
   require_dist
 } from "./chunk-B5GGDIHT.js";
+import {
+  value_exports
+} from "./chunk-SER7RRAE.js";
+import {
+  typebox_exports
+} from "./chunk-GH5ZR6JP.js";
 import {
   clioConfigDir
 } from "./chunk-CTTI7G3T.js";
+import {
+  resolvePackageRoot
+} from "./chunk-E3LEPLQ2.js";
 import {
   __toESM,
   init_esm_shims
@@ -912,4 +912,4 @@ export {
   listFleetContracts,
   renderFleetPrompt
 };
-//# sourceMappingURL=chunk-KKEYGFX4.js.map
+//# sourceMappingURL=chunk-7QQRPB2E.js.map

package/dist/{chunk-N37QC5FV.js → chunk-A6DULIMH.js}

@@ -20,17 +20,20 @@ import {
   enableClioCompileCache,
   workerCompileCacheEnvironment
 } from "./chunk-CKK25WN3.js";
-import {
-  readClioVersion,
-  resolvePackageRoot
-} from "./chunk-E3LEPLQ2.js";
 import {
   AI_AGENT_NAME,
   withClioAgentEnvironment
 } from "./chunk-ZTNFYMIO.js";
+import {
+  atomicWrite
+} from "./chunk-3RDHGNU7.js";
 import {
   clioStateDir
 } from "./chunk-CTTI7G3T.js";
+import {
+  readClioVersion,
+  resolvePackageRoot
+} from "./chunk-E3LEPLQ2.js";
 import {
   init_esm_shims
 } from "./chunk-ECBHH7LU.js";
@@ -60,7 +63,7 @@ function evaluateRouteFacts(facts, resources, requirement, options) {
     if (requirement.mode === "shadow") return { ok: true, unknowns: unknowns2 };
     return {
       ok: false,
-      reason: `no probe fact for target '${requirement.targetId}' on node '${requirement.nodeId}'; run 'clio-coder doctor'`,
+      reason: `no probe fact for target '${requirement.targetId}' on node '${requirement.nodeId}'; run 'clio-coder doctor --fix'`,
       unknowns: unknowns2
     };
   }
@@ -765,24 +768,32 @@ function readFleetPreflightRecords() {
     return [];
   }
 }
+function recordFleetPreflight(records) {
+  const merged = /* @__PURE__ */ new Map();
+  for (const record of [...readFleetPreflightRecords(), ...records]) {
+    merged.set(`${record.nodeId}\0${record.projectRoot}`, record);
+  }
+  const file = { version: 2, records: [...merged.values()] };
+  atomicWrite(storePath(), JSON.stringify(file, null, 2));
+}
 function fleetPreflightVerdict(node, projectRoot, records = readFleetPreflightRecords()) {
   const record = records.find((entry) => entry.nodeId === node.id && entry.projectRoot === projectRoot);
   if (!record) {
     return {
       ok: false,
-      reason: `node '${node.id}' has not passed the fleet preflight for ${projectRoot}; run 'clio-coder doctor'`
+      reason: `node '${node.id}' has not passed the fleet preflight for ${projectRoot}; run 'clio-coder doctor --fix'`
     };
   }
   if (record.host !== node.host) {
     return {
       ok: false,
-      reason: `node '${node.id}' preflight was recorded for host '${record.host}' but the node now points at '${node.host}'; run 'clio-coder doctor'`
+      reason: `node '${node.id}' preflight was recorded for host '${record.host}' but the node now points at '${node.host}'; run 'clio-coder doctor --fix'`
     };
   }
   if (record.localVersion !== readClioVersion()) {
     return {
       ok: false,
-      reason: `node '${node.id}' preflight predates a local clio-coder upgrade (${record.localVersion} -> ${readClioVersion()}); run 'clio-coder doctor'`
+      reason: `node '${node.id}' preflight predates a local clio-coder upgrade (${record.localVersion} -> ${readClioVersion()}); run 'clio-coder doctor --fix'`
     };
   }
   if (!record.ok) {
@@ -967,8 +978,9 @@ export {
   localNodeIdentity,
   createSshWorkerTransport,
   readFleetPreflightRecords,
+  recordFleetPreflight,
   fleetPreflightVerdict,
   routeFactVerdict,
   runFleetNodePreflight
 };
-//# sourceMappingURL=chunk-N37QC5FV.js.map
+//# sourceMappingURL=chunk-A6DULIMH.js.map

package/dist/{fleet-decisions-S3PTZV2D.js → chunk-AB3QXXBC.js}

@@ -2,19 +2,7 @@ import { createRequire as __clioCreateRequire } from "node:module"; const requir
 import {
   gateDecisionsDirectory,
   verifyGateDecisionArtifact
-} from "./chunk-EUEXGXXR.js";
-import "./chunk-FQOOGXBH.js";
-import "./chunk-UHW5V7HC.js";
-import "./chunk-KMF54VH3.js";
-import "./chunk-34XHRVKG.js";
-import "./chunk-HOX4YZ2K.js";
-import "./chunk-2O2LVQQK.js";
-import "./chunk-KQ6IDQIB.js";
-import "./chunk-NTTS3O53.js";
-import "./chunk-M4KFUXS7.js";
-import "./chunk-WLHX3MM5.js";
-import "./chunk-E3LEPLQ2.js";
-import "./chunk-ZZFWWYLX.js";
+} from "./chunk-NMBEW4PP.js";
 import {
   clioStateDir
 } from "./chunk-CTTI7G3T.js";
@@ -22,9 +10,6 @@ import {
   init_esm_shims
 } from "./chunk-ECBHH7LU.js";
 
-// src/cli/fleet-decisions.ts
-init_esm_shims();
-
 // src/domains/dispatch/gate-topology.ts
 init_esm_shims();
 import { existsSync, readdirSync, readFileSync } from "node:fs";
@@ -130,30 +115,9 @@ function gateTopology(stateDir = clioStateDir()) {
   };
 }
 
-// src/cli/fleet-decisions.ts
-function fleetDecisionsSnapshot(now = Date.now) {
-  const topology = gateTopology();
-  return {
-    version: 1,
-    generatedAt: new Date(now()).toISOString(),
-    available: topology.present,
-    decisions: topology.decisions,
-    truncated: topology.truncated,
-    unverifiable: topology.unverifiable
-  };
-}
-function runFleetDecisions(args) {
-  if (args.length !== 1 || args[0] !== "--json") {
-    process.stderr.write("clio-coder fleet decisions: usage: clio-coder fleet decisions --json\n");
-    return 2;
-  }
-  process.stdout.write(`${JSON.stringify(fleetDecisionsSnapshot(), null, 2)}
-`);
-  return 0;
-}
 export {
-  GATE_TOPOLOGY_MAX_DECISIONS as FLEET_DECISIONS_MAX,
-  GATE_TOPOLOGY_MAX_SUBJECTS as FLEET_DECISIONS_MAX_SUBJECTS,
-  runFleetDecisions
+  GATE_TOPOLOGY_MAX_DECISIONS,
+  GATE_TOPOLOGY_MAX_SUBJECTS,
+  gateTopology
 };
-//# sourceMappingURL=fleet-decisions-S3PTZV2D.js.map
+//# sourceMappingURL=chunk-AB3QXXBC.js.map

package/dist/chunk-ACCECAH4.js

@@ -0,0 +1,49 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  ToolNames
+} from "./chunk-V4XJWDHR.js";
+import {
+  StringEnum
+} from "./chunk-UIU7MGZ3.js";
+import {
+  typebox_exports
+} from "./chunk-GH5ZR6JP.js";
+import {
+  init_esm_shims
+} from "./chunk-ECBHH7LU.js";
+
+// src/tools/gateway/clio-context-surface.ts
+init_esm_shims();
+var clioDocsToolSurface = {
+  name: ToolNames.ClioDocs,
+  description: "Search Clio's bundled documentation for a question or terms and return cited sections as JSON; omit query to list the corpus (files and counts). Read-only; charges the per-turn observation pool.",
+  parameters: typebox_exports.Object({
+    query: typebox_exports.Optional(typebox_exports.String({ description: "Question or terms; omit to list the corpus." })),
+    limit: typebox_exports.Optional(typebox_exports.Number({ description: "Max sections (default 5, max 12)." }))
+  }),
+  baseActionClass: "read",
+  executionMode: "parallel"
+};
+var clioLibraryToolSurface = {
+  name: ToolNames.ClioLibrary,
+  description: "Read the recipe catalog: installed skills, agents, prompts, and fleets with their owner and invocation, plus installable packages. Body-free rows, bounded pages; activates and installs nothing. Unavailable inside a worker.",
+  parameters: typebox_exports.Object({
+    query: typebox_exports.Optional(typebox_exports.String({ description: "Name, owner, or description terms." })),
+    kind: typebox_exports.Optional(
+      StringEnum(["skill", "agent", "prompt", "fleet", "plugin"], {
+        description: "One recipe kind, or plugin for installable package rows."
+      })
+    ),
+    ref: typebox_exports.Optional(typebox_exports.String({ description: "Exact kind:name or resource key for one record." })),
+    limit: typebox_exports.Optional(typebox_exports.Number({ description: "Max rows (default 20, max 50)." })),
+    offset: typebox_exports.Optional(typebox_exports.Number({ description: "Zero-based offset; follow nextOffset (default 0)." }))
+  }),
+  baseActionClass: "read",
+  executionMode: "parallel"
+};
+
+export {
+  clioDocsToolSurface,
+  clioLibraryToolSurface
+};
+//# sourceMappingURL=chunk-ACCECAH4.js.map

package/dist/{chunk-CP3HIR5H.js → chunk-AM6CEP2K.js}

@@ -2,14 +2,14 @@ import { createRequire as __clioCreateRequire } from "node:module"; const requir
 import {
   loadPromptTemplates,
   validateLibraryPackage
-} from "./chunk-WB7POC6M.js";
+} from "./chunk-Y3M2T5RO.js";
 import {
   fetchPluginSource,
   loadSkills,
   parseAgentRecipeSchema,
   parsePluginGithubSource,
   pluginLocalPath
-} from "./chunk-MZNWZUJM.js";
+} from "./chunk-7FBCRWVT.js";
 import {
   normalizedSkillHash
 } from "./chunk-DNCE23JJ.js";
@@ -22,46 +22,39 @@ import {
   pluginBaseDir,
   readPluginInstallRecord,
   readPluginManifest
-} from "./chunk-YKRJTYNP.js";
+} from "./chunk-6UJ7RDI7.js";
 import {
   isSemanticVersion
 } from "./chunk-XW2UZICE.js";
 import {
   readSettings,
   updateSettings
-} from "./chunk-4QKAITQT.js";
+} from "./chunk-FPS4R2RN.js";
 import {
   INTEROP_AGENT_KINDS,
   interopAgentKind
 } from "./chunk-5EQO5NWP.js";
+import {
+  require_dist
+} from "./chunk-B5GGDIHT.js";
 import {
   runCommandVector
-} from "./chunk-GJ24ODAX.js";
+} from "./chunk-XTQ7MEJG.js";
 import {
   withStateFileLockSync
 } from "./chunk-DVJL77SO.js";
-import {
-  require_dist
-} from "./chunk-B5GGDIHT.js";
-import {
-  safeResourceWrite
-} from "./chunk-ZZFWWYLX.js";
 import {
   clioConfigDir,
   clioStateDir
 } from "./chunk-CTTI7G3T.js";
+import {
+  safeResourceWrite
+} from "./chunk-ZZFWWYLX.js";
 import {
   __toESM,
   init_esm_shims
 } from "./chunk-ECBHH7LU.js";
 
-// src/domains/interop/detect.ts
-init_esm_shims();
-import { createHash } from "node:crypto";
-import { accessSync, constants, existsSync as existsSync2, mkdirSync, mkdtempSync, rmSync, statSync } from "node:fs";
-import { homedir, tmpdir } from "node:os";
-import path3 from "node:path";
-
 // src/domains/interop/inventory.ts
 init_esm_shims();
 var import_yaml = __toESM(require_dist(), 1);
@@ -365,6 +358,13 @@ function discoverInteropInventory(kind, home, cwd, env = {}) {
   return result;
 }
 
+// src/domains/interop/detect.ts
+init_esm_shims();
+import { createHash } from "node:crypto";
+import { accessSync, constants, existsSync as existsSync2, mkdirSync, mkdtempSync, rmSync, statSync } from "node:fs";
+import { homedir, tmpdir } from "node:os";
+import path3 from "node:path";
+
 // src/domains/interop/state.ts
 init_esm_shims();
 import { existsSync, readFileSync as readFileSync2 } from "node:fs";
@@ -2104,6 +2104,7 @@ export {
   renderProposalEntry,
   acceptInteropAgents,
   declineInteropAgents,
+  discoverInteropInventory,
   resolveOnPath,
   detectInteropAgents,
   planInteropAdoption,
@@ -2116,4 +2117,4 @@ export {
   renderLibraryImportPlan,
   InteropDomainModule
 };
-//# sourceMappingURL=chunk-CP3HIR5H.js.map
+//# sourceMappingURL=chunk-AM6CEP2K.js.map

package/dist/chunk-AUHVBIDW.js

@@ -0,0 +1,19 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  init_esm_shims
+} from "./chunk-ECBHH7LU.js";
+
+// apps/clio-coder-web/server/network-policy.ts
+init_esm_shims();
+function restrictNetwork() {
+  const download = globalThis.fetch;
+  globalThis.fetch = async () => {
+    throw new Error("Web server network requests must use the pinned toolchain downloader.");
+  };
+  return download;
+}
+
+export {
+  restrictNetwork
+};
+//# sourceMappingURL=chunk-AUHVBIDW.js.map

package/dist/{chunk-BQQ5MXUC.js → chunk-AY4XE6GN.js}

@@ -1,13 +1,16 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
-  PROJECT_VERIFIER_CATALOG_RELATIVE_PATH
-} from "./chunk-BO4XV5VX.js";
+  effectiveToolCall
+} from "./chunk-2JBZYUPY.js";
 import {
   detectValidationCommand,
   extractCommandDeleteTargets,
   extractCommandWriteTargets,
   toolMutationPaths
-} from "./chunk-2O2LVQQK.js";
+} from "./chunk-SQBT46OF.js";
+import {
+  PROJECT_VERIFIER_CATALOG_RELATIVE_PATH
+} from "./chunk-H72DCH3E.js";
 import {
   asDirectoryPathBoundary,
   pathBoundaryEntryCovers,
@@ -19,7 +22,7 @@ import {
 } from "./chunk-M4KFUXS7.js";
 import {
   ToolNames
-} from "./chunk-WLHX3MM5.js";
+} from "./chunk-V4XJWDHR.js";
 import {
   init_esm_shims
 } from "./chunk-ECBHH7LU.js";
@@ -170,9 +173,12 @@ function mutatingToolCall(entry) {
   if (record?.kind !== "message" || record.role !== "tool_call") return null;
   const payload = asRecord(record.payload);
   if (payload === null) return null;
-  const toolName = stringFromFirst(payload, ["name", "toolName", "tool"]);
-  if (toolName === null) return null;
-  const args = asRecord(payload.args ?? payload.arguments ?? payload.input) ?? void 0;
+  const recordedTool = stringFromFirst(payload, ["name", "toolName", "tool"]);
+  if (recordedTool === null) return null;
+  const { toolName, args } = effectiveToolCall(
+    recordedTool,
+    asRecord(payload.args ?? payload.arguments ?? payload.input) ?? void 0
+  );
   const paths = mutationPathsForTool(toolName, args);
   if (paths.length === 0) return null;
   const toolCallId = stringFromFirst(payload, ["toolCallId", "tool_call_id", "id"]) ?? turnIdOf(entry);
@@ -647,13 +653,13 @@ export {
   createLoopState,
   hashToolCall,
   observe,
-  isSubset,
-  READONLY_SCOPE,
-  WORKSPACE_SCOPE,
-  CONFIRMED_SCOPE,
   DEFAULT_RECENT_ENTRY_LIMIT,
   assessFinishContract,
   recentEntries,
-  typedValidationSummary
+  typedValidationSummary,
+  isSubset,
+  READONLY_SCOPE,
+  WORKSPACE_SCOPE,
+  CONFIRMED_SCOPE
 };
-//# sourceMappingURL=chunk-BQQ5MXUC.js.map
+//# sourceMappingURL=chunk-AY4XE6GN.js.map

package/dist/{chunk-ISNCCX42.js → chunk-BBA2TAWV.js}

@@ -2,28 +2,28 @@ import { createRequire as __clioCreateRequire } from "node:module"; const requir
 import {
   canonicalJson,
   sha256
-} from "./chunk-IQCNVLO6.js";
+} from "./chunk-IALZJE37.js";
 import {
   addResponseModelIdObservationCount,
   emptyResponseModelIdObservationCounts,
   responseModelIdObservationFromRecord
-} from "./chunk-D2T66PDV.js";
+} from "./chunk-3SUDBGEI.js";
 import {
   uncachedPrefillTokens
 } from "./chunk-QH3ZTUOA.js";
 import {
   ceilChars,
   extractReasoningTokens
-} from "./chunk-77CZRFTE.js";
-import {
-  isEngineContextOverflow
-} from "./chunk-5CMARGPF.js";
+} from "./chunk-SJMNU4ZS.js";
 import {
   settingsPath
-} from "./chunk-4QKAITQT.js";
+} from "./chunk-FPS4R2RN.js";
 import {
   ToolNames
-} from "./chunk-WLHX3MM5.js";
+} from "./chunk-V4XJWDHR.js";
+import {
+  isEngineContextOverflow
+} from "./chunk-UIU7MGZ3.js";
 import {
   init_esm_shims
 } from "./chunk-ECBHH7LU.js";
@@ -405,6 +405,7 @@ function sumRunUsage(messages) {
     summary.output += output;
     summary.cacheRead += cacheRead;
     summary.cacheWrite += cacheWrite;
+    if (typeof usage.cacheWrite1h === "number") summary.cacheWrite1h = (summary.cacheWrite1h ?? 0) + usage.cacheWrite1h;
     const reasoning = extractReasoningTokens(usage);
     if (reasoning !== null) {
       summary.reasoning += reasoning;
@@ -663,4 +664,4 @@ export {
   projectHeadlessJsonEvent,
   projectDispatchJsonEvent
 };
-//# sourceMappingURL=chunk-ISNCCX42.js.map
+//# sourceMappingURL=chunk-BBA2TAWV.js.map

package/dist/chunk-BFPHMSK7.js

@@ -0,0 +1,169 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  init_esm_shims
+} from "./chunk-ECBHH7LU.js";
+
+// apps/clio-coder-web/server/launcher/install.ts
+init_esm_shims();
+import { createHash } from "node:crypto";
+import { constants } from "node:fs";
+import { access, lstat, mkdir, readFile, realpath, stat, unlink, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { isAbsolute as isAbsolute2, join } from "node:path";
+import { parseArgs } from "node:util";
+
+// apps/clio-coder-web/server/launcher/desktop-entry.ts
+init_esm_shims();
+import { isAbsolute } from "node:path";
+var launcherId = "io.iowarp.ClioCoder";
+var launcherUnsupported = "Desktop installation is currently supported on Linux only. Start the web server with --open, or open its printed URL, on this platform.";
+function desktopArgument(value) {
+  if ([...value].some((char) => char.charCodeAt(0) < 32 || char.charCodeAt(0) === 127))
+    throw new Error("Desktop entry paths cannot contain control characters.");
+  return `"${value.replace(/\\/g, "\\\\\\\\").replace(/["`$]/g, "\\\\$&").replace(/%/g, "%%")}"`;
+}
+function desktopEntry(paths) {
+  if (!Object.values(paths).every(isAbsolute)) throw new Error("Launcher paths must be absolute.");
+  if (paths.background !== void 0 && !isAbsolute(paths.background))
+    throw new Error("Background directory must be absolute.");
+  if (paths.icon) desktopArgument(paths.icon);
+  const argv = [
+    paths.node,
+    ...paths.loader ? ["--import", paths.loader] : [],
+    paths.entry,
+    ...paths.background ? ["background", "open", "--directory", paths.background] : ["--open", "--idle-exit", "60000"]
+  ];
+  return [
+    "[Desktop Entry]",
+    "Type=Application",
+    "Name=Clio Coder",
+    "Comment=Build and explore with Clio Coder",
+    `Exec=${argv.map(desktopArgument).join(" ")}`,
+    `Icon=${paths.icon ? paths.icon.replace(/\\/g, "\\\\") : "applications-development"}`,
+    "Terminal=false",
+    "Categories=Development;",
+    "Keywords=Clio;AI;Coding;",
+    "StartupNotify=false",
+    ""
+  ].join("\n");
+}
+
+// apps/clio-coder-web/server/launcher/install.ts
+var hash = (value) => createHash("sha256").update(value).digest("hex");
+var names = { entry: `${launcherId}.desktop`, manifest: `${launcherId}.desktop.owner.json` };
+var missing = (error) => error.code === "ENOENT";
+async function contents(path) {
+  try {
+    const info = await lstat(path);
+    if (!info.isFile() || info.nlink !== 1 || info.size > 16384 || process.getuid && info.uid !== process.getuid())
+      throw new Error("Launcher file is not a small regular file owned by this user.");
+    return await readFile(path, "utf8");
+  } catch (error) {
+    if (missing(error)) return null;
+    throw error;
+  }
+}
+async function launcherFiles(prefix, platform = process.platform) {
+  if (platform !== "linux") throw new Error(launcherUnsupported);
+  if (!isAbsolute2(prefix)) throw new Error("--prefix must be an absolute XDG data directory.");
+  const directory = join(prefix, "applications");
+  try {
+    if (!(await lstat(directory)).isDirectory())
+      throw new Error("Launcher applications path must be a directory, not a symlink.");
+  } catch (error) {
+    if (!missing(error)) throw error;
+  }
+  return { directory, entry: join(directory, names.entry), manifest: join(directory, names.manifest) };
+}
+async function launcherStatus(prefix, platform = process.platform) {
+  const files = await launcherFiles(prefix, platform);
+  const entry = await contents(files.entry), manifest = await contents(files.manifest);
+  if (entry === null && manifest === null) return { status: "absent", ...files };
+  let owned = false, available = false;
+  try {
+    const value = JSON.parse(manifest ?? "null");
+    owned = entry !== null && value?.version === 1 && value?.owner === launcherId && value?.sha256 === hash(entry) && desktopEntry(value.launch) === entry;
+    if (owned) {
+      await access(value.launch.node, constants.X_OK);
+      for (const path of [
+        value.launch.node,
+        value.launch.entry,
+        ...value.launch.loader ? [value.launch.loader] : [],
+        ...value.launch.icon ? [value.launch.icon] : []
+      ]) {
+        await access(path, constants.R_OK);
+        if (!(await stat(path)).isFile()) throw new Error("Launcher target is not a file.");
+      }
+      available = true;
+    }
+  } catch {
+  }
+  return {
+    status: owned ? available ? "installed" : "unavailable" : "conflict",
+    ...files
+  };
+}
+async function installLauncher(prefix, paths) {
+  const launch = {
+    node: await realpath(paths.node),
+    ...paths.loader ? { loader: await realpath(paths.loader) } : {},
+    ...paths.icon ? { icon: await realpath(paths.icon) } : {},
+    entry: await realpath(paths.entry),
+    ...paths.background ? { background: await realpath(paths.background) } : {}
+  };
+  const entry = desktopEntry(launch);
+  const state = await launcherStatus(prefix);
+  if (state.status === "installed" && await contents(state.entry) === entry) return state;
+  if (state.status !== "absent")
+    throw new Error(
+      "Launcher files already exist or differ. Inspect status and uninstall the owned entry before installing again."
+    );
+  await mkdir(state.directory, { recursive: true });
+  await launcherFiles(prefix);
+  await writeFile(state.entry, entry, { flag: "wx", mode: 420 });
+  try {
+    await writeFile(
+      state.manifest,
+      `${JSON.stringify({ version: 1, owner: launcherId, sha256: hash(entry), launch })}
+`,
+      {
+        flag: "wx",
+        mode: 384
+      }
+    );
+  } catch (error) {
+    if (await contents(state.entry) === entry) await unlink(state.entry);
+    throw error;
+  }
+  return launcherStatus(prefix);
+}
+async function uninstallLauncher(prefix) {
+  const state = await launcherStatus(prefix);
+  if (state.status === "conflict") throw new Error("Launcher ownership could not be verified; no files were removed.");
+  if (state.status === "installed" || state.status === "unavailable") {
+    await unlink(state.entry);
+    await unlink(state.manifest);
+  }
+  return launcherStatus(prefix);
+}
+async function launcher(args, paths) {
+  const { values, positionals } = parseArgs({ args, allowPositionals: true, options: { prefix: { type: "string" } } });
+  const command = positionals[0];
+  if (positionals.length !== 1 || !["install", "status", "uninstall"].includes(command ?? ""))
+    throw new Error("Usage: launcher install|status|uninstall [--prefix <absolute XDG data directory>]");
+  const prefix = values.prefix ?? (process.env.XDG_DATA_HOME && isAbsolute2(process.env.XDG_DATA_HOME) ? process.env.XDG_DATA_HOME : join(homedir(), ".local/share"));
+  const result = command === "install" ? await installLauncher(prefix, paths) : command === "uninstall" ? await uninstallLauncher(prefix) : await launcherStatus(prefix);
+  console.log(JSON.stringify(result, null, 2));
+  if (result.status === "conflict" || result.status === "unavailable") process.exitCode = 1;
+}
+
+export {
+  desktopEntry,
+  contents,
+  launcherFiles,
+  launcherStatus,
+  installLauncher,
+  uninstallLauncher,
+  launcher
+};
+//# sourceMappingURL=chunk-BFPHMSK7.js.map

package/dist/{chunk-LVFANMOH.js → chunk-BHJMMCXS.js}

@@ -1,4 +1,7 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  require_dist
+} from "./chunk-B5GGDIHT.js";
 import {
   createSlicer
 } from "./chunk-KPRLAMP4.js";
@@ -7,9 +10,6 @@ import {
   enumerateWorkspaceFiles,
   enumerateWorkspaceFilesAsync
 } from "./chunk-PPEZJWUG.js";
-import {
-  require_dist
-} from "./chunk-B5GGDIHT.js";
 import {
   safeResourceWrite
 } from "./chunk-ZZFWWYLX.js";
@@ -463,4 +463,4 @@ export {
   scopePlanForUpdate,
   pendingPages
 };
-//# sourceMappingURL=chunk-LVFANMOH.js.map
+//# sourceMappingURL=chunk-BHJMMCXS.js.map