@drisp/cli 0.5.26 → 0.6.0

package/dist/chunk-73V7GXV6.js

@@ -1,2229 +0,0 @@
-// src/infra/plugins/workflowResolver.ts
-import fs3 from "fs";
-import path2 from "path";
-
-// src/infra/plugins/marketplaceShared.ts
-import { execFileSync as execFileSync2 } from "child_process";
-import fs2 from "fs";
-import os from "os";
-import path from "path";
-
-// src/infra/plugins/marketplaceRefresh.ts
-import { execFileSync } from "child_process";
-import fs from "fs";
-var MarketplaceRefreshError = class extends Error {
-  kind;
-  marketplace;
-  constructor(outcome) {
-    super(outcome.message);
-    this.name = "MarketplaceRefreshError";
-    this.kind = outcome.kind;
-    this.marketplace = outcome.marketplace;
-  }
-};
-var NETWORK_OR_AUTH_SIGNATURES = [
-  "could not resolve host",
-  "could not resolve proxy",
-  "couldn\u2019t resolve host",
-  "name or service not known",
-  "temporary failure in name resolution",
-  "failed to connect",
-  "connection timed out",
-  "connection refused",
-  "connection reset",
-  "network is unreachable",
-  "network unavailable",
-  "unable to access",
-  "ssl certificate problem",
-  "gnutls_handshake",
-  "authentication failed",
-  "could not read username",
-  "could not read password",
-  "permission denied (publickey)",
-  "terminal prompts disabled",
-  "invalid username or password",
-  "403 forbidden",
-  "access denied",
-  "repository not found",
-  "remote: not found"
-];
-function classifyGitFailure(message) {
-  const haystack = message.toLowerCase();
-  for (const signature of NETWORK_OR_AUTH_SIGNATURES) {
-    if (haystack.includes(signature)) {
-      return "network-or-auth";
-    }
-  }
-  return "unrecoverable-cache";
-}
-function repoUrlFor(owner, repo) {
-  return `https://github.com/${owner}/${repo}.git`;
-}
-var GIT_STDIO = ["ignore", "ignore", "pipe"];
-function gitFailureText(error) {
-  const err = error;
-  const stderr = err.stderr == null ? "" : err.stderr.toString().trim();
-  const message = err.message ?? "";
-  return stderr ? `${message} ${stderr}`.trim() : message;
-}
-function cloneInto(repoUrl, repoDir) {
-  fs.mkdirSync(repoDir, { recursive: true });
-  try {
-    execFileSync("git", ["clone", "--depth", "1", repoUrl, repoDir], {
-      stdio: GIT_STDIO
-    });
-  } catch (error) {
-    fs.rmSync(repoDir, { recursive: true, force: true });
-    throw error;
-  }
-}
-function failureOutcome(kind, marketplace, cause, backupDir) {
-  const message = kind === "network-or-auth" ? `Could not refresh the "${marketplace}" marketplace: the remote could not be reached (connectivity or authentication problem). ${cause}` : `Could not refresh the "${marketplace}" marketplace: the cached copy is corrupt and could not be rebuilt.${backupDir ? ` Previous cache preserved at ${backupDir}.` : ""} ${cause}`;
-  return {
-    ok: false,
-    kind,
-    marketplace,
-    message,
-    cause,
-    ...backupDir ? { backupDir } : {}
-  };
-}
-function refreshMarketplaceRepo(owner, repo) {
-  const marketplace = `${owner}/${repo}`;
-  const repoDir = marketplaceRepoCacheDir(owner, repo);
-  const repoUrl = repoUrlFor(owner, repo);
-  if (!fs.existsSync(repoDir)) {
-    try {
-      cloneInto(repoUrl, repoDir);
-      return { ok: true, repoDir };
-    } catch (cloneError) {
-      const cause = gitFailureText(cloneError);
-      return failureOutcome(classifyGitFailure(cause), marketplace, cause);
-    }
-  }
-  try {
-    execFileSync("git", ["pull", "--ff-only"], {
-      cwd: repoDir,
-      stdio: GIT_STDIO
-    });
-    return { ok: true, repoDir };
-  } catch {
-    const backupDir = `${repoDir}.backup-${Date.now()}`;
-    try {
-      fs.renameSync(repoDir, backupDir);
-      cloneInto(repoUrl, repoDir);
-      return { ok: true, repoDir, selfHealed: true, backupDir };
-    } catch (recoveryError) {
-      const cause = gitFailureText(recoveryError);
-      return failureOutcome(
-        classifyGitFailure(cause),
-        marketplace,
-        cause,
-        backupDir
-      );
-    }
-  }
-}
-function ensureFailureOutcome(kind, marketplace, cause) {
-  const message = kind === "network-or-auth" ? `Could not reach the "${marketplace}" marketplace: the remote could not be reached (connectivity or authentication problem). ${cause}` : `Could not clone the "${marketplace}" marketplace: the local cache could not be created. ${cause}`;
-  return { ok: false, kind, marketplace, message, cause };
-}
-function ensureRepo(owner, repo) {
-  const repoDir = marketplaceRepoCacheDir(owner, repo);
-  if (!fs.existsSync(repoDir)) {
-    const marketplace = `${owner}/${repo}`;
-    try {
-      cloneInto(repoUrlFor(owner, repo), repoDir);
-    } catch (error) {
-      const cause = gitFailureText(error);
-      throw new MarketplaceRefreshError(
-        ensureFailureOutcome(classifyGitFailure(cause), marketplace, cause)
-      );
-    }
-  }
-  return repoDir;
-}
-
-// src/infra/plugins/marketplaceShared.ts
-var MARKETPLACE_REF_RE = /^[a-zA-Z0-9_-]+@[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+$/;
-var MARKETPLACE_SLUG_RE = /^[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+$/;
-function marketplacesCacheDir() {
-  return path.join(os.homedir(), ".config", "athena", "marketplaces");
-}
-function marketplaceRepoCacheDir(owner, repo) {
-  return path.join(marketplacesCacheDir(), owner, repo);
-}
-function resolvePluginManifestPath(repoDir) {
-  const preferredManifestPath = path.join(
-    repoDir,
-    ".agents",
-    "plugins",
-    "marketplace.json"
-  );
-  const legacyManifestPath = resolveLegacyPluginManifestPath(repoDir);
-  return fs2.existsSync(preferredManifestPath) ? preferredManifestPath : legacyManifestPath;
-}
-function resolveLegacyPluginManifestPath(repoDir) {
-  return path.join(repoDir, ".claude-plugin", "marketplace.json");
-}
-function readManifest(manifestPath) {
-  if (!fs2.existsSync(manifestPath)) {
-    throw new Error(`Marketplace manifest not found: ${manifestPath}`);
-  }
-  return JSON.parse(
-    fs2.readFileSync(manifestPath, "utf-8")
-  );
-}
-function entryRelativeSourcePath(entry, pluginName) {
-  let sourcePath;
-  if (typeof entry.source === "string") {
-    sourcePath = entry.source;
-  } else {
-    const sourceRecord = entry.source;
-    if (sourceRecord.source !== "local" || typeof sourceRecord.path !== "string") {
-      throw new Error(
-        `Plugin "${pluginName}" uses a remote source type which is not supported by athena-cli. Only local relative path sources are supported.`
-      );
-    }
-    sourcePath = sourceRecord.path;
-  }
-  if (!sourcePath.startsWith("./")) {
-    throw new Error(
-      `Plugin "${pluginName}" source must start with "./": ${sourcePath}`
-    );
-  }
-  const relativeSourcePath = sourcePath.slice(2);
-  if (relativeSourcePath.length === 0) {
-    throw new Error(`Plugin "${pluginName}" source must not be empty`);
-  }
-  if (relativeSourcePath.includes("\\")) {
-    throw new Error(
-      `Plugin "${pluginName}" source must stay within the marketplace root: ${sourcePath}`
-    );
-  }
-  const segments = relativeSourcePath.split("/");
-  if (segments.some(
-    (segment) => segment === "" || segment === "." || segment === ".."
-  )) {
-    throw new Error(
-      `Plugin "${pluginName}" source must stay within the marketplace root: ${sourcePath}`
-    );
-  }
-  return relativeSourcePath;
-}
-function resolvePluginDirFromManifest(pluginName, repoDir, manifestPath) {
-  const manifest = readManifest(manifestPath);
-  if (!Array.isArray(manifest.plugins)) {
-    throw new Error(
-      `Invalid marketplace manifest at ${manifestPath}: "plugins" must be an array`
-    );
-  }
-  const entry = manifest.plugins.find((p) => p.name === pluginName);
-  if (!entry) {
-    const available = manifest.plugins.map((p) => p.name).join(", ");
-    throw new Error(
-      `Plugin "${pluginName}" not found in marketplace manifest ${manifestPath}. Available plugins: ${available}`
-    );
-  }
-  const pluginDir = path.join(
-    repoDir,
-    entryRelativeSourcePath(entry, pluginName)
-  );
-  if (!fs2.existsSync(pluginDir)) {
-    throw new Error(`Plugin source directory not found: ${pluginDir}`);
-  }
-  return pluginDir;
-}
-function isMarketplaceRef(entry) {
-  return MARKETPLACE_REF_RE.test(entry);
-}
-function isMarketplaceSlug(entry) {
-  return MARKETPLACE_SLUG_RE.test(entry);
-}
-function parseRef(ref) {
-  const atIdx = ref.indexOf("@");
-  const pluginName = ref.slice(0, atIdx);
-  const slug = ref.slice(atIdx + 1);
-  const slashIdx = slug.indexOf("/");
-  return {
-    pluginName,
-    owner: slug.slice(0, slashIdx),
-    repo: slug.slice(slashIdx + 1)
-  };
-}
-function buildMarketplacePluginResolution(ref, repoDir, manifestPath) {
-  const { pluginName } = parseRef(ref);
-  const pluginDir = resolvePluginDirFromManifest(
-    pluginName,
-    repoDir,
-    manifestPath
-  );
-  const version = resolvePluginVersionFromDir(pluginDir);
-  const artifactLayout = version ? resolvePackagedArtifactLayout(pluginDir, version) : void 0;
-  return {
-    ref,
-    pluginName,
-    marketplacePath: artifactLayout?.codexMarketplacePath ?? manifestPath,
-    pluginDir: artifactLayout?.claudeArtifactDir ?? pluginDir,
-    codexPluginDir: artifactLayout?.codexPluginDir ?? pluginDir
-  };
-}
-function isPathWithinRoot(rootDir, targetPath) {
-  const relative = path.relative(rootDir, targetPath);
-  return relative === "" || !relative.startsWith("..") && !path.isAbsolute(relative);
-}
-function resolvePluginVersionFromDir(pluginDir) {
-  const manifestPaths = [
-    path.join(pluginDir, ".codex-plugin", "plugin.json"),
-    path.join(pluginDir, ".claude-plugin", "plugin.json")
-  ];
-  for (const manifestPath of manifestPaths) {
-    if (!fs2.existsSync(manifestPath)) continue;
-    try {
-      const manifest = JSON.parse(fs2.readFileSync(manifestPath, "utf-8"));
-      if (typeof manifest.version === "string" && manifest.version.length > 0) {
-        return manifest.version;
-      }
-    } catch {
-    }
-  }
-  return void 0;
-}
-function resolvePackagedArtifactLayout(pluginRoot, version) {
-  const releasePath = path.join(pluginRoot, "dist", version, "release.json");
-  if (!fs2.existsSync(releasePath)) {
-    return void 0;
-  }
-  try {
-    const release = JSON.parse(
-      fs2.readFileSync(releasePath, "utf-8")
-    );
-    if (release.version !== version) {
-      return void 0;
-    }
-    const claudePath = release.artifacts?.claude?.path;
-    const codexMarketplacePath = release.artifacts?.codex?.marketplacePath;
-    const codexPluginPath = release.artifacts?.codex?.pluginPath;
-    if (typeof claudePath !== "string" || typeof codexMarketplacePath !== "string" || typeof codexPluginPath !== "string") {
-      return void 0;
-    }
-    const releaseDir = path.dirname(releasePath);
-    const claudeArtifactDir = path.resolve(releaseDir, claudePath);
-    const resolvedCodexMarketplacePath = path.resolve(
-      releaseDir,
-      codexMarketplacePath
-    );
-    const codexPluginDir = path.resolve(releaseDir, codexPluginPath);
-    if (!isPathWithinRoot(releaseDir, claudeArtifactDir) || !isPathWithinRoot(releaseDir, resolvedCodexMarketplacePath) || !isPathWithinRoot(releaseDir, codexPluginDir)) {
-      return void 0;
-    }
-    if (!fs2.existsSync(claudeArtifactDir) || !fs2.existsSync(resolvedCodexMarketplacePath) || !fs2.existsSync(codexPluginDir)) {
-      return void 0;
-    }
-    return {
-      claudeArtifactDir,
-      codexMarketplacePath: resolvedCodexMarketplacePath,
-      codexPluginDir
-    };
-  } catch {
-    return void 0;
-  }
-}
-function requireGitForMarketplace(kind) {
-  try {
-    execFileSync2("git", ["--version"], { stdio: "ignore" });
-  } catch {
-    throw new Error(
-      `git is not installed. Install git to use marketplace ${kind}.`
-    );
-  }
-}
-
-// src/infra/plugins/workflowSourceErrors.ts
-var WorkflowAmbiguityError = class extends Error {
-  workflowName;
-  candidates;
-  constructor(workflowName, candidates) {
-    const list = candidates.map((c) => `  - ${c.sourceLabel}: use ${c.disambiguator}`).join("\n");
-    super(
-      `Workflow "${workflowName}" is provided by multiple configured marketplaces:
-${list}
-Run \`athena-flow workflow install <disambiguator>\` to pick one.`
-    );
-    this.name = "WorkflowAmbiguityError";
-    this.workflowName = workflowName;
-    this.candidates = candidates;
-  }
-};
-var WorkflowNotFoundError = class extends Error {
-  workflowName;
-  searchedSources;
-  constructor(workflowName, searchedSources) {
-    const sourceList = searchedSources.length ? searchedSources.join(", ") : "(no marketplaces configured)";
-    super(
-      `Workflow "${workflowName}" not found in any configured marketplace (searched: ${sourceList}). If this workflow was recently added, run \`athena-flow marketplace refresh\` and try again.`
-    );
-    this.name = "WorkflowNotFoundError";
-    this.workflowName = workflowName;
-    this.searchedSources = searchedSources;
-  }
-};
-var WorkflowVersionNotFoundError = class extends Error {
-  workflowName;
-  requestedVersion;
-  availableVersion;
-  sourceLabel;
-  constructor(workflowName, requestedVersion, availableVersion, sourceLabel) {
-    const availableText = availableVersion ? `found version ${availableVersion}` : "marketplace entry does not declare a version";
-    super(
-      `Workflow "${workflowName}" version ${requestedVersion} not found in ${sourceLabel} (${availableText}).`
-    );
-    this.name = "WorkflowVersionNotFoundError";
-    this.workflowName = workflowName;
-    this.requestedVersion = requestedVersion;
-    this.availableVersion = availableVersion;
-    this.sourceLabel = sourceLabel;
-  }
-};
-
-// src/infra/plugins/workflowResolver.ts
-function resolveWorkflowManifestPath(repoDir) {
-  const preferred = path2.join(repoDir, ".athena-workflow", "marketplace.json");
-  const legacy = path2.join(repoDir, ".claude-plugin", "marketplace.json");
-  return fs3.existsSync(preferred) ? preferred : legacy;
-}
-function preferCanonicalWorkflowPath(repoDir, workflowPath) {
-  const relativePath = path2.relative(repoDir, workflowPath);
-  const segments = relativePath.split(path2.sep);
-  if (segments[0] !== ".workflows") return workflowPath;
-  const canonical = path2.join(repoDir, "workflows", ...segments.slice(1));
-  return fs3.existsSync(canonical) ? canonical : workflowPath;
-}
-function resolveWorkflowEntryPath(entry, manifest, repoDir) {
-  if (typeof entry.source !== "string") {
-    throw new Error(
-      `Workflow "${entry.name}" uses a remote source type which is not supported.`
-    );
-  }
-  let sourcePath = entry.source;
-  const { workflowRoot } = manifest.metadata ?? {};
-  if (workflowRoot && !path2.isAbsolute(sourcePath) && !sourcePath.startsWith("./") && !sourcePath.startsWith("../")) {
-    sourcePath = path2.join(workflowRoot, sourcePath);
-  }
-  const workflowPath = path2.resolve(repoDir, sourcePath);
-  if (!workflowPath.startsWith(repoDir + path2.sep) && workflowPath !== repoDir) {
-    throw new Error(
-      `Workflow "${entry.name}" source resolves outside the marketplace repo: ${workflowPath}`
-    );
-  }
-  const resolved = preferCanonicalWorkflowPath(repoDir, workflowPath);
-  if (!fs3.existsSync(resolved)) {
-    throw new Error(`Workflow source not found: ${resolved}`);
-  }
-  return resolved;
-}
-function resolveWorkflowPathFromManifest(workflowName, repoDir, manifestPath) {
-  const manifest = readManifest(manifestPath);
-  const workflows = manifest.workflows ?? [];
-  const entry = workflows.find((w) => w.name === workflowName);
-  if (!entry) {
-    const available = workflows.map((w) => w.name).join(", ") || "(none)";
-    throw new Error(
-      `Workflow "${workflowName}" not found in marketplace manifest ${manifestPath}. Available workflows: ${available}`
-    );
-  }
-  return resolveWorkflowEntryPath(entry, manifest, repoDir);
-}
-function listWorkflowEntriesFromManifest(repoDir, manifestPath, source) {
-  const manifest = readManifest(manifestPath);
-  const workflows = manifest.workflows ?? [];
-  return workflows.filter(
-    (entry) => typeof entry.source === "string"
-  ).map((entry) => ({
-    name: entry.name,
-    description: entry.description,
-    version: entry.version,
-    workflowPath: resolveWorkflowEntryPath(entry, manifest, repoDir),
-    ref: source.kind === "remote" ? `${entry.name}@${source.owner}/${source.repo}` : void 0,
-    source
-  }));
-}
-function findMarketplaceRepoDir(startPath) {
-  let currentDir = path2.resolve(startPath);
-  for (; ; ) {
-    if (fs3.existsSync(resolveWorkflowManifestPath(currentDir)) || fs3.existsSync(resolvePluginManifestPath(currentDir))) {
-      return currentDir;
-    }
-    const parentDir = path2.dirname(currentDir);
-    if (parentDir === currentDir) return void 0;
-    currentDir = parentDir;
-  }
-}
-function resolveWorkflowMarketplaceSource(source) {
-  const trimmed = source.trim();
-  const resolvedPath = path2.resolve(trimmed);
-  if (!fs3.existsSync(resolvedPath) && isMarketplaceSlug(trimmed)) {
-    const slashIdx = trimmed.indexOf("/");
-    return {
-      kind: "remote",
-      slug: trimmed,
-      owner: trimmed.slice(0, slashIdx),
-      repo: trimmed.slice(slashIdx + 1)
-    };
-  }
-  const repoDir = findMarketplaceRepoDir(trimmed);
-  if (!repoDir) {
-    throw new Error(
-      `Local marketplace not found from source: ${trimmed}. Expected a marketplace repo root or a path inside one.`
-    );
-  }
-  return { kind: "local", path: resolvedPath, repoDir };
-}
-function listMarketplaceWorkflows(owner, repo) {
-  requireGitForMarketplace("workflows");
-  const repoDir = ensureRepo(owner, repo);
-  return listWorkflowEntriesFromManifest(
-    repoDir,
-    resolveWorkflowManifestPath(repoDir),
-    { kind: "remote", slug: `${owner}/${repo}`, owner, repo }
-  );
-}
-function listMarketplaceWorkflowsFromRepo(repoDir) {
-  return listWorkflowEntriesFromManifest(
-    repoDir,
-    resolveWorkflowManifestPath(repoDir),
-    { kind: "local", repoDir }
-  );
-}
-function resolveMarketplaceWorkflow(ref) {
-  requireGitForMarketplace("workflows");
-  const { pluginName: workflowName, owner, repo } = parseRef(ref);
-  const repoDir = ensureRepo(owner, repo);
-  return resolveWorkflowPathFromManifest(
-    workflowName,
-    repoDir,
-    resolveWorkflowManifestPath(repoDir)
-  );
-}
-function gatherMarketplaceWorkflowSources(source) {
-  const trimmed = source.trim();
-  const resolvedPath = path2.resolve(trimmed);
-  if (fs3.existsSync(resolvedPath) && fs3.statSync(resolvedPath).isFile()) {
-    return [{ kind: "filesystem", workflowPath: fs3.realpathSync(resolvedPath) }];
-  }
-  if (!fs3.existsSync(resolvedPath) && isMarketplaceSlug(trimmed)) {
-    const slashIdx = trimmed.indexOf("/");
-    const owner = trimmed.slice(0, slashIdx);
-    const repo = trimmed.slice(slashIdx + 1);
-    requireGitForMarketplace("workflows");
-    const repoDir2 = ensureRepo(owner, repo);
-    const manifestPath2 = resolveWorkflowManifestPath(repoDir2);
-    return listWorkflowEntriesFromManifest(repoDir2, manifestPath2, {
-      kind: "remote",
-      slug: trimmed,
-      owner,
-      repo
-    }).map((entry) => ({
-      kind: "marketplace-remote",
-      slug: trimmed,
-      owner,
-      repo,
-      workflowName: entry.name,
-      version: entry.version,
-      ref: entry.ref,
-      manifestPath: manifestPath2,
-      workflowPath: entry.workflowPath
-    }));
-  }
-  const repoDir = findMarketplaceRepoDir(trimmed);
-  if (!repoDir) {
-    throw new Error(
-      `Marketplace source not found: ${trimmed}. Expected a marketplace repo root, a path inside one, or an owner/repo slug.`
-    );
-  }
-  const canonicalRepoDir = fs3.realpathSync(repoDir);
-  const manifestPath = resolveWorkflowManifestPath(canonicalRepoDir);
-  return listWorkflowEntriesFromManifest(canonicalRepoDir, manifestPath, {
-    kind: "local",
-    repoDir: canonicalRepoDir
-  }).map((entry) => ({
-    kind: "marketplace-local",
-    repoDir: canonicalRepoDir,
-    workflowName: entry.name,
-    version: entry.version,
-    manifestPath,
-    workflowPath: entry.workflowPath
-  }));
-}
-function parseBareWorkflowName(source) {
-  const atIdx = source.indexOf("@");
-  if (atIdx <= 0 || atIdx === source.length - 1) {
-    return { bareName: source, pinnedVersion: void 0 };
-  }
-  const suffix = source.slice(atIdx + 1);
-  if (suffix.includes("/")) {
-    return { bareName: source, pinnedVersion: void 0 };
-  }
-  return { bareName: source.slice(0, atIdx), pinnedVersion: suffix };
-}
-function resolvedSourceLabel(s) {
-  if (s.kind === "marketplace-remote") return `marketplace ${s.slug}`;
-  if (s.kind === "marketplace-local") return `local marketplace ${s.repoDir}`;
-  return `file ${s.workflowPath}`;
-}
-function resolvedSourceDisambiguator(s) {
-  if (s.kind === "marketplace-remote") return s.ref;
-  return s.workflowPath;
-}
-function resolveWorkflowInstall(sourceOrName, configuredSources) {
-  if (isMarketplaceRef(sourceOrName)) {
-    const { pluginName: workflowName, owner, repo } = parseRef(sourceOrName);
-    requireGitForMarketplace("workflows");
-    const repoDir = ensureRepo(owner, repo);
-    const manifestPath = resolveWorkflowManifestPath(repoDir);
-    const workflowPath = resolveWorkflowPathFromManifest(
-      workflowName,
-      repoDir,
-      manifestPath
-    );
-    const entry = listWorkflowEntriesFromManifest(repoDir, manifestPath, {
-      kind: "remote",
-      slug: `${owner}/${repo}`,
-      owner,
-      repo
-    }).find((e) => e.name === workflowName);
-    return {
-      kind: "marketplace-remote",
-      slug: `${owner}/${repo}`,
-      owner,
-      repo,
-      workflowName,
-      version: entry?.version,
-      ref: sourceOrName,
-      manifestPath,
-      workflowPath
-    };
-  }
-  const resolvedPath = path2.resolve(sourceOrName);
-  if (fs3.existsSync(resolvedPath) && fs3.statSync(resolvedPath).isFile()) {
-    return { kind: "filesystem", workflowPath: fs3.realpathSync(resolvedPath) };
-  }
-  const { bareName, pinnedVersion } = parseBareWorkflowName(sourceOrName);
-  if (bareName.includes("/") || bareName.includes("\\")) {
-    throw new Error(`Workflow source not found: ${sourceOrName}`);
-  }
-  const allListings = [];
-  let versionMismatch;
-  for (const configured of configuredSources) {
-    let sources;
-    try {
-      sources = gatherMarketplaceWorkflowSources(configured);
-    } catch {
-      continue;
-    }
-    for (const src of sources) {
-      if ((src.kind === "marketplace-remote" || src.kind === "marketplace-local") && src.workflowName === bareName) {
-        if (pinnedVersion !== void 0 && src.version !== pinnedVersion) {
-          versionMismatch ??= new WorkflowVersionNotFoundError(
-            bareName,
-            pinnedVersion,
-            src.version,
-            resolvedSourceLabel(src)
-          );
-          continue;
-        }
-        allListings.push(src);
-      }
-    }
-  }
-  if (allListings.length === 0) {
-    if (versionMismatch) throw versionMismatch;
-    throw new WorkflowNotFoundError(bareName, configuredSources);
-  }
-  if (allListings.length > 1) {
-    const candidates = allListings.map((s) => ({
-      sourceLabel: resolvedSourceLabel(s),
-      disambiguator: resolvedSourceDisambiguator(s)
-    }));
-    throw new WorkflowAmbiguityError(bareName, candidates);
-  }
-  return allListings[0];
-}
-
-// src/infra/plugins/versionedPluginResolution.ts
-import { execFileSync as execFileSync3 } from "child_process";
-import fs4 from "fs";
-import os2 from "os";
-import path3 from "path";
-var PLUGIN_NPM_SCOPE = "@athenaflow";
-function pluginNpmPackageName(pluginName) {
-  return `${PLUGIN_NPM_SCOPE}/plugin-${pluginName}`;
-}
-function versionedPluginCacheDir() {
-  return path3.join(os2.homedir(), ".config", "athena", "plugin-packages");
-}
-function resolveVersionedPluginDir(owner, repo, pluginName, version) {
-  const cacheDir = path3.join(
-    versionedPluginCacheDir(),
-    owner,
-    repo,
-    pluginName,
-    version
-  );
-  return fs4.existsSync(cacheDir) ? cacheDir : void 0;
-}
-function fetchPluginPackage(owner, repo, pluginName, version) {
-  const npmPkg = pluginNpmPackageName(pluginName);
-  const destDir = path3.join(
-    versionedPluginCacheDir(),
-    owner,
-    repo,
-    pluginName,
-    version
-  );
-  if (fs4.existsSync(destDir)) {
-    return destDir;
-  }
-  const cacheBase = versionedPluginCacheDir();
-  fs4.mkdirSync(cacheBase, { recursive: true });
-  const tmpDir = fs4.mkdtempSync(path3.join(cacheBase, ".tmp-"));
-  try {
-    const tarball = execFileSync3(
-      "npm",
-      ["pack", `${npmPkg}@${version}`, "--pack-destination", tmpDir],
-      { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }
-    ).trim();
-    const tarballPath = path3.join(tmpDir, tarball);
-    if (!fs4.existsSync(tarballPath)) {
-      throw new Error(`npm pack did not produce expected tarball: ${tarball}`);
-    }
-    const extractDir = path3.join(tmpDir, "extracted");
-    fs4.mkdirSync(extractDir, { recursive: true });
-    execFileSync3("tar", ["xzf", tarballPath, "-C", extractDir], {
-      stdio: "ignore"
-    });
-    const packageDir = path3.join(extractDir, "package");
-    if (!fs4.existsSync(packageDir)) {
-      throw new Error(
-        "Extracted tarball does not contain a package/ directory"
-      );
-    }
-    fs4.mkdirSync(path3.dirname(destDir), { recursive: true });
-    try {
-      fs4.renameSync(packageDir, destDir);
-    } catch (error) {
-      const code = typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" ? error.code : void 0;
-      if ((code === "EEXIST" || code === "ENOTEMPTY") && fs4.existsSync(destDir)) {
-        return destDir;
-      }
-      throw error;
-    }
-    return destDir;
-  } finally {
-    fs4.rmSync(tmpDir, { recursive: true, force: true });
-  }
-}
-function resolvePackagedArtifactsOrThrow(pluginName, version, pluginRoot, stage) {
-  const artifactLayout = resolvePackagedArtifactLayout(pluginRoot, version);
-  if (!artifactLayout) {
-    throw new Error(
-      `${stage} for plugin "${pluginName}" version ${version} is missing packaged runtime artifacts`
-    );
-  }
-  return artifactLayout;
-}
-function readSourceFallbackEntry(repoDir, pluginName) {
-  const manifestPath = resolvePluginManifestPath(repoDir);
-  const manifest = readManifest(manifestPath);
-  const entry = manifest.plugins.find((plugin) => plugin.name === pluginName);
-  if (!entry) {
-    return void 0;
-  }
-  const pluginRoot = path3.join(
-    repoDir,
-    entryRelativeSourcePath(entry, pluginName)
-  );
-  const version = entry.version ?? resolvePluginVersionFromDir(pluginRoot);
-  return { pluginRoot, version };
-}
-function resolveMarketplaceSourceFallback(ref, pluginName, version, repoDir) {
-  const entry = readSourceFallbackEntry(repoDir, pluginName);
-  if (!entry || entry.version !== version) {
-    return void 0;
-  }
-  resolvePackagedArtifactsOrThrow(
-    pluginName,
-    version,
-    entry.pluginRoot,
-    "marketplace source fallback"
-  );
-  return buildMarketplacePluginResolution(
-    ref,
-    repoDir,
-    resolvePluginManifestPath(repoDir)
-  );
-}
-function describeSourceFallbackRejection(owner, repo, pluginName, version, repoDir) {
-  if (!fs4.existsSync(repoDir)) {
-    return `source fallback was unavailable because marketplace repo ${owner}/${repo} is not cached locally`;
-  }
-  let entry;
-  try {
-    entry = readSourceFallbackEntry(repoDir, pluginName);
-  } catch (error) {
-    return `source fallback could not determine the marketplace source version: ${error.message}`;
-  }
-  if (!entry?.version) {
-    return `source fallback was considered, but marketplace repo ${owner}/${repo} does not expose a version for plugin "${pluginName}"`;
-  }
-  return `source fallback was considered, but marketplace repo ${owner}/${repo} exposes version ${entry.version} instead of requested ${version}`;
-}
-function resolveVersionedMarketplacePluginTarget(ref, version, sourceRepoDir, options) {
-  const { pluginName, owner, repo } = parseRef(ref);
-  const forceRefresh = options?.forceRefresh === true;
-  const cachedDir = resolveVersionedPluginDir(owner, repo, pluginName, version);
-  if (cachedDir && !forceRefresh) {
-    const artifactLayout = resolvePackagedArtifactsOrThrow(
-      pluginName,
-      version,
-      cachedDir,
-      "cache"
-    );
-    return {
-      ref,
-      pluginName,
-      marketplacePath: artifactLayout.codexMarketplacePath,
-      pluginDir: artifactLayout.claudeArtifactDir,
-      codexPluginDir: artifactLayout.codexPluginDir
-    };
-  }
-  let npmError;
-  try {
-    const fetchedDir = fetchPluginPackage(owner, repo, pluginName, version);
-    const artifactLayout = resolvePackagedArtifactsOrThrow(
-      pluginName,
-      version,
-      fetchedDir,
-      "npm package"
-    );
-    return {
-      ref,
-      pluginName,
-      marketplacePath: artifactLayout.codexMarketplacePath,
-      pluginDir: artifactLayout.claudeArtifactDir,
-      codexPluginDir: artifactLayout.codexPluginDir
-    };
-  } catch (error) {
-    npmError = error;
-  }
-  const repoDir = sourceRepoDir ?? ensureRepo(owner, repo);
-  const fallbackTarget = fs4.existsSync(repoDir) ? resolveMarketplaceSourceFallback(ref, pluginName, version, repoDir) : void 0;
-  if (fallbackTarget) {
-    return fallbackTarget;
-  }
-  const npmStageMessage = `npm package resolution failed for ${pluginNpmPackageName(pluginName)}@${version}: ${npmError.message}`;
-  const fallbackMessage = describeSourceFallbackRejection(
-    owner,
-    repo,
-    pluginName,
-    version,
-    repoDir
-  );
-  throw new Error(
-    `Plugin "${pluginName}" version ${version} could not be resolved. ${npmStageMessage}. ${fallbackMessage}.`
-  );
-}
-function refreshVersionedMarketplacePluginTarget(ref, version, sourceRepoDir) {
-  return resolveVersionedMarketplacePluginTarget(ref, version, sourceRepoDir, {
-    forceRefresh: true
-  });
-}
-
-// src/infra/plugins/marketplace.ts
-function pullMarketplaceRepo(owner, repo) {
-  const outcome = refreshMarketplaceRepo(owner, repo);
-  if (!outcome.ok) {
-    throw new MarketplaceRefreshError(outcome);
-  }
-}
-function resolveMarketplacePlugin(ref) {
-  requireGitForMarketplace("plugins");
-  const { pluginName, owner, repo } = parseRef(ref);
-  const repoDir = ensureRepo(owner, repo);
-  return resolvePluginDirFromManifest(
-    pluginName,
-    repoDir,
-    resolvePluginManifestPath(repoDir)
-  );
-}
-function resolveMarketplacePluginTarget(ref) {
-  requireGitForMarketplace("plugins");
-  const { owner, repo } = parseRef(ref);
-  const repoDir = ensureRepo(owner, repo);
-  const directTarget = buildMarketplacePluginResolution(
-    ref,
-    repoDir,
-    resolvePluginManifestPath(repoDir)
-  );
-  const pluginVersion = resolvePluginVersionFromDir(directTarget.pluginDir);
-  if (!pluginVersion) {
-    return directTarget;
-  }
-  return resolveVersionedMarketplacePluginTarget(ref, pluginVersion, repoDir);
-}
-function resolveMarketplacePluginTargetFromRepo(ref, repoDir) {
-  return buildMarketplacePluginResolution(
-    ref,
-    repoDir,
-    resolvePluginManifestPath(repoDir)
-  );
-}
-
-// src/infra/plugins/config.ts
-import fs5 from "fs";
-import os3 from "os";
-import path4 from "path";
-var EMPTY_CONFIG = { plugins: [], additionalDirectories: [] };
-function projectConfigPath(projectDir) {
-  return path4.join(projectDir, ".athena", "config.json");
-}
-function readConfig(projectDir) {
-  return readConfigFile(projectConfigPath(projectDir), projectDir);
-}
-function resolveActiveWorkflow(input) {
-  const { globalConfig, projectConfig, override } = input;
-  if (override !== void 0) {
-    return {
-      name: override,
-      source: "override",
-      selectionsLayer: projectConfig.activeWorkflow !== void 0 ? projectConfig : globalConfig
-    };
-  }
-  if (projectConfig.activeWorkflow !== void 0) {
-    return {
-      name: projectConfig.activeWorkflow,
-      source: "project",
-      selectionsLayer: projectConfig
-    };
-  }
-  if (globalConfig.activeWorkflow !== void 0) {
-    return {
-      name: globalConfig.activeWorkflow,
-      source: "global",
-      selectionsLayer: globalConfig
-    };
-  }
-  return {
-    name: "default",
-    source: "default",
-    selectionsLayer: globalConfig
-  };
-}
-function readGlobalConfig() {
-  const homeDir = os3.homedir();
-  const configPath = path4.join(homeDir, ".config", "athena", "config.json");
-  return readConfigFile(configPath, homeDir);
-}
-function readConfigFile(configPath, baseDir) {
-  if (!fs5.existsSync(configPath)) {
-    return EMPTY_CONFIG;
-  }
-  const raw = JSON.parse(fs5.readFileSync(configPath, "utf-8"));
-  if ("workflowMarketplaceSource" in raw) {
-    throw new Error(
-      `Invalid config: "${configPath}" uses deprecated "workflowMarketplaceSource"; use "workflowMarketplaceSources"`
-    );
-  }
-  if (raw.workflowMarketplaceSources !== void 0 && (!Array.isArray(raw.workflowMarketplaceSources) || !raw.workflowMarketplaceSources.every(
-    (source) => typeof source === "string"
-  ))) {
-    throw new Error(
-      `Invalid config: "${configPath}" field "workflowMarketplaceSources" must be an array of strings`
-    );
-  }
-  if (raw.harness !== void 0 && raw.harness !== "claude-code" && raw.harness !== "openai-codex" && raw.harness !== "opencode") {
-    throw new Error(
-      `Invalid config: "${configPath}" field "harness" must be one of claude-code, openai-codex, opencode`
-    );
-  }
-  if (raw.channels !== void 0 && (!Array.isArray(raw.channels) || !raw.channels.every((c) => typeof c === "string"))) {
-    throw new Error(
-      `Invalid config: "${configPath}" field "channels" must be an array of strings`
-    );
-  }
-  const plugins = (raw.plugins ?? []).map((p) => {
-    if (isMarketplaceRef(p)) return p;
-    return path4.isAbsolute(p) ? p : path4.resolve(baseDir, p);
-  });
-  const additionalDirectories = (raw.additionalDirectories ?? []).map(
-    (dir) => path4.isAbsolute(dir) ? dir : path4.resolve(baseDir, dir)
-  );
-  return {
-    plugins,
-    additionalDirectories,
-    model: raw.model,
-    theme: raw.theme,
-    activeWorkflow: raw.activeWorkflow,
-    workflowMarketplaceSources: raw.workflowMarketplaceSources,
-    workflowSelections: raw.workflowSelections,
-    setupComplete: raw.setupComplete,
-    harness: raw.harness,
-    telemetry: raw.telemetry,
-    telemetryDiagnostics: raw.telemetryDiagnostics,
-    deviceId: raw.deviceId,
-    channels: raw.channels,
-    // Personal capabilities are stored opaque. In particular skill `path`
-    // is NOT relative-resolved against baseDir (R1) — Issue 3 resolves it
-    // to an absolute path at install time.
-    mcpServers: raw.mcpServers,
-    skills: raw.skills
-  };
-}
-function readExistingConfig(configPath) {
-  try {
-    return JSON.parse(fs5.readFileSync(configPath, "utf-8"));
-  } catch {
-    return {};
-  }
-}
-function writeConfigFile(configDir, configPath, updates, deleteKeys) {
-  const existing = readExistingConfig(configPath);
-  const merged = { ...existing, ...updates };
-  if (updates.workflowSelections) {
-    const existingSelections = existing["workflowSelections"] ?? {};
-    merged["workflowSelections"] = {
-      ...existingSelections,
-      ...updates.workflowSelections
-    };
-  }
-  if (deleteKeys) {
-    for (const key of deleteKeys) {
-      delete merged[key];
-    }
-  }
-  fs5.mkdirSync(configDir, { recursive: true });
-  fs5.writeFileSync(configPath, JSON.stringify(merged, null, 2) + "\n", "utf-8");
-}
-var GLOBAL_CONFIG_LEGACY_KEYS = [
-  "workflow",
-  "mcpServerOptions",
-  "workflowMarketplaceSource"
-];
-function writeGlobalConfig(updates) {
-  const homeDir = os3.homedir();
-  const configDir = path4.join(homeDir, ".config", "athena");
-  const configPath = path4.join(configDir, "config.json");
-  writeConfigFile(configDir, configPath, updates, GLOBAL_CONFIG_LEGACY_KEYS);
-}
-function writeProjectConfig(projectDir, updates) {
-  const configDir = path4.join(projectDir, ".athena");
-  const configPath = path4.join(configDir, "config.json");
-  writeConfigFile(configDir, configPath, updates);
-}
-function hasActiveWorkflow(configPath) {
-  try {
-    const raw = JSON.parse(fs5.readFileSync(configPath, "utf-8"));
-    return typeof raw.activeWorkflow === "string" && raw.activeWorkflow !== "";
-  } catch {
-    return false;
-  }
-}
-function hasProjectWorkflow(projectDir) {
-  return hasActiveWorkflow(projectConfigPath(projectDir));
-}
-
-// src/core/workflows/types.ts
-function pluginSpecRef(spec) {
-  return typeof spec === "string" ? spec : spec.ref;
-}
-function pluginSpecVersion(spec) {
-  return typeof spec === "string" ? void 0 : spec.version;
-}
-
-// src/core/workflows/installer.ts
-function installWorkflowPlugins(workflow) {
-  return resolveWorkflowPlugins(workflow).resolvedPlugins.map(
-    (plugin) => plugin.claudeArtifactDir
-  );
-}
-function marketplaceNameFromRef(ref) {
-  return ref.slice(ref.indexOf("@") + 1);
-}
-function toResolvedWorkflowPlugin(target, ref, version) {
-  return {
-    ref: target.ref,
-    pluginName: target.pluginName,
-    marketplaceName: marketplaceNameFromRef(ref),
-    ...version !== void 0 && { version },
-    pluginDir: target.pluginDir,
-    claudeArtifactDir: target.pluginDir,
-    codexPluginDir: target.codexPluginDir,
-    codexMarketplacePath: target.marketplacePath
-  };
-}
-function resolveWorkflowPlugins(workflow) {
-  const resolvedPlugins = workflow.plugins.map((spec) => {
-    const ref = pluginSpecRef(spec);
-    const version = pluginSpecVersion(spec);
-    try {
-      const source = "__source" in workflow ? workflow.__source : void 0;
-      const repoDir = source?.kind === "marketplace-local" ? source.repoDir : void 0;
-      if (version) {
-        const target2 = resolveVersionedMarketplacePluginTarget(
-          ref,
-          version,
-          repoDir
-        );
-        return toResolvedWorkflowPlugin(target2, ref, version);
-      }
-      if (repoDir) {
-        const target2 = resolveMarketplacePluginTargetFromRepo(ref, repoDir);
-        return toResolvedWorkflowPlugin(target2, ref);
-      }
-      const target = resolveMarketplacePluginTarget(ref);
-      return toResolvedWorkflowPlugin(target, ref);
-    } catch (error) {
-      throw new Error(
-        `Workflow "${workflow.name}": failed to install plugin "${ref}": ${error.message}`
-      );
-    }
-  });
-  return {
-    resolvedPlugins,
-    localPlugins: resolvedPlugins.map((p) => ({
-      ref: p.ref,
-      pluginDir: p.claudeArtifactDir
-    })),
-    codexPlugins: resolvedPlugins.map((p) => ({
-      ref: p.ref,
-      pluginName: p.pluginName,
-      marketplacePath: p.codexMarketplacePath,
-      ...p.version !== void 0 && { version: p.version }
-    }))
-  };
-}
-function refreshPinnedWorkflowPlugins(workflow) {
-  const source = "__source" in workflow ? workflow.__source : void 0;
-  for (const spec of workflow.plugins) {
-    const ref = pluginSpecRef(spec);
-    const version = pluginSpecVersion(spec);
-    if (!version) {
-      continue;
-    }
-    try {
-      refreshVersionedMarketplacePluginTarget(
-        ref,
-        version,
-        source?.kind === "marketplace-local" ? source.repoDir : void 0
-      );
-    } catch (error) {
-      throw new Error(
-        `Workflow "${workflow.name}": failed to refresh pinned plugin "${ref}" at version ${version}: ${error.message}`
-      );
-    }
-  }
-}
-
-// src/core/workflows/registry.ts
-import fs9 from "fs";
-import os5 from "os";
-import path7 from "path";
-
-// src/core/workflows/builtins/index.ts
-import fs7 from "fs";
-import os4 from "os";
-import path5 from "path";
-
-// src/core/workflows/trackerReader.ts
-import fs6 from "fs";
-
-// src/core/workflows/templateVars.ts
-function substituteVariables(text, ctx) {
-  let result = text;
-  if (ctx.input !== void 0) {
-    result = result.replaceAll("{input}", ctx.input);
-  }
-  if (ctx.sessionId !== void 0) {
-    result = result.replaceAll("{sessionId}", ctx.sessionId);
-    result = result.replaceAll("<session_id>", ctx.sessionId);
-  }
-  if (ctx.trackerPath !== void 0) {
-    result = result.replaceAll("{trackerPath}", ctx.trackerPath);
-  }
-  return result;
-}
-
-// src/core/workflows/trackerReader.ts
-var DEFAULT_COMPLETION_MARKER = "<!-- WORKFLOW_COMPLETE -->";
-var DEFAULT_BLOCKED_MARKER = "<!-- WORKFLOW_BLOCKED";
-var DEFAULT_TRACKER_PATH = ".athena/{sessionId}/tracker.md";
-var TRACKER_SKELETON_MARKER = "<!-- TRACKER_SKELETON -->";
-var DEFAULT_CONTINUE_PROMPT = "Continue the task. Read the tracker at {trackerPath} for current progress. If the work is complete or blocked, the terminal marker must be the final non-empty line of the tracker; do not write any prose after it.";
-function readTracker(trackerPath) {
-  try {
-    return fs6.readFileSync(trackerPath, "utf-8");
-  } catch {
-    return "";
-  }
-}
-function getNonEmptyLines(content) {
-  return content.trimEnd().split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
-}
-function isBlockedLine(line, blockedMarker) {
-  return line === `${blockedMarker} -->` || line.startsWith(`${blockedMarker}:`);
-}
-function isTerminalMarkerLine(line, completionMarker, blockedMarker) {
-  return line === completionMarker || isBlockedLine(line, blockedMarker);
-}
-function getMisplacedTerminalMarker(lines, completionMarker, blockedMarker) {
-  if (lines.length < 2) return void 0;
-  const terminalLine = lines.at(-1);
-  if (terminalLine && isTerminalMarkerLine(terminalLine, completionMarker, blockedMarker)) {
-    return void 0;
-  }
-  return lines.slice(0, -1).find((line) => isTerminalMarkerLine(line, completionMarker, blockedMarker));
-}
-function extractBlockedReason(line, blockedMarker) {
-  if (!line.startsWith(blockedMarker)) return void 0;
-  const afterMarker = line.slice(blockedMarker.length);
-  const match = afterMarker.match(/^:\s*(.+?)(?:\s*-->|$)/);
-  return match?.[1]?.trim();
-}
-function parseTrackerState(content, markers = {}) {
-  const completionMarker = markers.completionMarker ?? DEFAULT_COMPLETION_MARKER;
-  const blockedMarker = markers.blockedMarker ?? DEFAULT_BLOCKED_MARKER;
-  const lines = getNonEmptyLines(content);
-  const terminalLine = lines.at(-1);
-  const completed = terminalLine === completionMarker;
-  const blocked = terminalLine !== void 0 && isBlockedLine(terminalLine, blockedMarker);
-  const blockedReason = blocked && terminalLine ? extractBlockedReason(terminalLine, blockedMarker) : void 0;
-  return {
-    completed,
-    blocked,
-    blockedReason,
-    misplacedTerminalMarker: getMisplacedTerminalMarker(
-      lines,
-      completionMarker,
-      blockedMarker
-    ),
-    skeletonNotReplaced: content.includes(TRACKER_SKELETON_MARKER)
-  };
-}
-function buildContinuePrompt(loop) {
-  const template = loop.continuePrompt ?? DEFAULT_CONTINUE_PROMPT;
-  return substituteVariables(template, {
-    trackerPath: loop.trackerPath ?? DEFAULT_TRACKER_PATH
-  });
-}
-
-// src/core/workflows/builtins/index.ts
-var DEFAULT_BLOCKED_CLOSED_MARKER = `${DEFAULT_BLOCKED_MARKER} -->`;
-var DEFAULT_BLOCKED_REASON_MARKER = `${DEFAULT_BLOCKED_MARKER}: reason -->`;
-var SYSTEM_PROMPT = `You are working on a long-horizon task managed by Athena. A tracker file is used to persist progress across sessions.
-
-## Tracker File
-
-At the start of each session, read the tracker file if it exists. It contains the task plan, completed steps, and current status from prior sessions.
-
-If no tracker file exists, create one by:
-1. Analyzing the user's request to understand the full scope
-2. Breaking the task into concrete, actionable steps
-3. Writing the plan to the tracker file
-
-### Tracker Format
-
-Use this markdown format for the tracker:
-
-\`\`\`
-# Task: <one-line summary>
-
-## Plan
-- [x] Step 1 description
-- [x] Step 2 description
-- [ ] Step 3 description (current)
-- [ ] Step 4 description
-
-## Current Status
-<brief description of where things stand and what to do next>
-
-## Notes
-<any important context, decisions, or blockers discovered along the way>
-\`\`\`
-
-### Updating the Tracker
-
-After completing meaningful work, update the tracker:
-- Check off completed steps
-- Update the current status section
-- Add any important notes or decisions
-
-### Completion
-
-When all steps are complete:
-1. Update the tracker with all steps checked off
-2. Put any final summary or outcome notes above the terminal marker
-3. Add \`${DEFAULT_COMPLETION_MARKER}\` as the final non-empty line of the tracker file
-4. Do not write any tracker content after the terminal marker
-
-### Blocked
-
-If you are blocked and cannot make further progress:
-1. Document what is blocking you in the Notes section
-2. Explain what needs to happen to unblock the task whenever possible above the terminal marker
-3. Add \`${DEFAULT_BLOCKED_CLOSED_MARKER}\` or \`${DEFAULT_BLOCKED_REASON_MARKER}\` as the final non-empty line of the tracker file
-4. Do not write any tracker content after the terminal marker
-`;
-function ensureSystemPromptFile() {
-  const dir = path5.join(
-    os4.homedir(),
-    ".config",
-    "athena",
-    "builtins",
-    "default"
-  );
-  const filePath = path5.join(dir, "system_prompt.md");
-  if (!fs7.existsSync(filePath) || fs7.readFileSync(filePath, "utf-8") !== SYSTEM_PROMPT) {
-    fs7.mkdirSync(dir, { recursive: true });
-    fs7.writeFileSync(filePath, SYSTEM_PROMPT, "utf-8");
-  }
-  return filePath;
-}
-function resolveBuiltinWorkflow(name) {
-  if (name !== "default") {
-    return void 0;
-  }
-  return {
-    name: "default",
-    description: "General-purpose workflow for long-horizon tasks \u2014 breaks work into steps, tracks progress across sessions, and loops until complete",
-    promptTemplate: "{input}",
-    loop: {
-      enabled: true,
-      completionMarker: DEFAULT_COMPLETION_MARKER,
-      blockedMarker: DEFAULT_BLOCKED_MARKER,
-      maxIterations: 20
-    },
-    plugins: [],
-    workflowFile: ensureSystemPromptFile()
-  };
-}
-function listBuiltinWorkflows() {
-  return ["default"];
-}
-
-// src/core/workflows/sourceMetadata.ts
-import fs8 from "fs";
-import path6 from "path";
-function legacyLocalToNew(legacyPath, legacyRepoDir) {
-  const repoDir = legacyRepoDir ?? findMarketplaceRepoDir(legacyPath);
-  if (!repoDir) {
-    return { kind: "filesystem", path: legacyPath };
-  }
-  try {
-    const canonicalRepoDir = fs8.realpathSync(repoDir);
-    const listings = listMarketplaceWorkflowsFromRepo(canonicalRepoDir);
-    const absolutePath = fs8.realpathSync(legacyPath);
-    const match = listings.find(
-      (l) => fs8.realpathSync(l.workflowPath) === absolutePath
-    );
-    if (match) {
-      return {
-        kind: "marketplace-local",
-        repoDir: canonicalRepoDir,
-        workflowName: match.name,
-        ...match.version ? { version: match.version } : {}
-      };
-    }
-  } catch {
-  }
-  return { kind: "filesystem", path: legacyPath };
-}
-function readWorkflowSourceMetadata(workflowDir) {
-  const sourceFile = path6.join(workflowDir, "source.json");
-  if (!fs8.existsSync(sourceFile)) return void 0;
-  let raw;
-  try {
-    raw = JSON.parse(fs8.readFileSync(sourceFile, "utf-8"));
-  } catch {
-    throw new Error(`Invalid source.json: ${sourceFile} is not valid JSON`);
-  }
-  if (!raw || typeof raw !== "object") {
-    throw new Error(
-      `Invalid source.json: ${sourceFile} must contain an object`
-    );
-  }
-  const r = raw;
-  if (r["v"] === 2) {
-    if (r["kind"] === "marketplace-remote" && typeof r["ref"] === "string") {
-      return {
-        kind: "marketplace-remote",
-        ref: r["ref"],
-        ...typeof r["version"] === "string" ? { version: r["version"] } : {}
-      };
-    }
-    if (r["kind"] === "marketplace-local" && typeof r["repoDir"] === "string" && typeof r["workflowName"] === "string") {
-      return {
-        kind: "marketplace-local",
-        repoDir: r["repoDir"],
-        workflowName: r["workflowName"],
-        ...typeof r["version"] === "string" ? { version: r["version"] } : {}
-      };
-    }
-    if (r["kind"] === "filesystem" && typeof r["path"] === "string") {
-      return { kind: "filesystem", path: r["path"] };
-    }
-  }
-  if (r["kind"] === "marketplace" && typeof r["ref"] === "string") {
-    return { kind: "marketplace-remote", ref: r["ref"] };
-  }
-  if (r["kind"] === "local" && typeof r["path"] === "string") {
-    return legacyLocalToNew(
-      r["path"],
-      typeof r["repoDir"] === "string" ? r["repoDir"] : void 0
-    );
-  }
-  throw new Error(`Invalid source.json: ${sourceFile} kind is not supported`);
-}
-function writeWorkflowSourceMetadata(workflowDir, metadata) {
-  fs8.mkdirSync(workflowDir, { recursive: true });
-  fs8.writeFileSync(
-    path6.join(workflowDir, "source.json"),
-    JSON.stringify({ v: 2, ...metadata }),
-    "utf-8"
-  );
-}
-
-// src/core/workflows/registry.ts
-function registryDir() {
-  return path7.join(os5.homedir(), ".config", "athena", "workflows");
-}
-function ensurePathWithinRoot(rootDir, targetPath, label) {
-  const relative = path7.relative(rootDir, targetPath);
-  if (relative === "" || !relative.startsWith("..") && !path7.isAbsolute(relative)) {
-    return;
-  }
-  throw new Error(`${label} resolves outside the workflow root: ${targetPath}`);
-}
-function resolveWorkflow(name) {
-  const workflowDir = path7.join(registryDir(), name);
-  const workflowPath = path7.join(workflowDir, "workflow.json");
-  if (!fs9.existsSync(workflowPath)) {
-    const builtin = resolveBuiltinWorkflow(name);
-    if (builtin) {
-      return builtin;
-    }
-    throw new Error(
-      `Workflow "${name}" not found. Install with: athena workflow install <source> --name ${name}`
-    );
-  }
-  const source = readWorkflowSourceMetadata(workflowDir);
-  const raw = JSON.parse(fs9.readFileSync(workflowPath, "utf-8"));
-  if (!Array.isArray(raw["plugins"])) {
-    throw new Error(
-      `Invalid workflow.json: "plugins" must be an array (got ${typeof raw["plugins"]})`
-    );
-  }
-  for (const entry of raw["plugins"]) {
-    if (typeof entry === "string") {
-      if (isMarketplaceRef(entry.trim())) {
-        continue;
-      }
-      throw new Error(
-        `Invalid workflow.json: each plugin must be a valid marketplace ref string or {ref, version} object`
-      );
-    }
-    if (typeof entry === "object" && entry !== null) {
-      const r = entry["ref"];
-      const v = entry["version"];
-      if (typeof r === "string" && isMarketplaceRef(r.trim()) && r.trim().length > 0 && typeof v === "string" && v.trim().length > 0) {
-        continue;
-      }
-    }
-    throw new Error(
-      `Invalid workflow.json: each plugin must be a valid marketplace ref string or {ref, version} object`
-    );
-  }
-  if (typeof raw["promptTemplate"] !== "string") {
-    throw new Error(`Invalid workflow.json: "promptTemplate" must be a string`);
-  }
-  if (raw["examplePrompts"] !== void 0 && (!Array.isArray(raw["examplePrompts"]) || !raw["examplePrompts"].every((e) => typeof e === "string"))) {
-    throw new Error(
-      `Invalid workflow.json: "examplePrompts" must be an array of strings`
-    );
-  }
-  if (typeof raw["workflowFile"] !== "string" || raw["workflowFile"].length === 0) {
-    throw new Error(
-      'Invalid workflow.json: "workflowFile" is required and must point to the workflow instructions file'
-    );
-  }
-  const workflowFile = raw["workflowFile"];
-  if (typeof workflowFile === "string" && !path7.isAbsolute(workflowFile)) {
-    const workflowFilePath = path7.resolve(workflowDir, workflowFile);
-    if (!fs9.existsSync(workflowFilePath)) {
-      throw new Error(
-        `Invalid workflow.json: workflowFile "${workflowFile}" not found at ${workflowFilePath}`
-      );
-    }
-    raw["workflowFile"] = workflowFilePath;
-  } else if (typeof workflowFile === "string" && !fs9.existsSync(workflowFile)) {
-    throw new Error(
-      `Invalid workflow.json: workflowFile "${workflowFile}" not found`
-    );
-  }
-  return {
-    ...raw,
-    ...source ? { __source: source } : {}
-  };
-}
-function readWorkflowSource(sourcePath) {
-  const content = fs9.readFileSync(sourcePath, "utf-8");
-  return { content, workflow: JSON.parse(content) };
-}
-function copyWorkflowFiles(sourcePath, destDir) {
-  const { content, workflow } = readWorkflowSource(sourcePath);
-  const absoluteSourcePath = path7.resolve(sourcePath);
-  const sourceDir = path7.dirname(absoluteSourcePath);
-  const absoluteDestDir = path7.resolve(destDir);
-  fs9.mkdirSync(absoluteDestDir, { recursive: true });
-  fs9.writeFileSync(
-    path7.join(absoluteDestDir, "workflow.json"),
-    content,
-    "utf-8"
-  );
-  const copyRelativeAsset = (assetPath) => {
-    if (!assetPath || path7.isAbsolute(assetPath)) return;
-    const sourceAssetPath = path7.resolve(sourceDir, assetPath);
-    ensurePathWithinRoot(sourceDir, sourceAssetPath, "Workflow asset");
-    if (!fs9.existsSync(sourceAssetPath)) return;
-    const destAssetPath = path7.resolve(absoluteDestDir, assetPath);
-    ensurePathWithinRoot(absoluteDestDir, destAssetPath, "Workflow asset");
-    fs9.mkdirSync(path7.dirname(destAssetPath), { recursive: true });
-    fs9.copyFileSync(sourceAssetPath, destAssetPath);
-  };
-  const rawWorkflow = workflow;
-  const promptAsset = rawWorkflow["workflowFile"];
-  if (typeof promptAsset !== "string" || promptAsset.length === 0) {
-    throw new Error(
-      'Invalid workflow.json: "workflowFile" is required and must point to the workflow instructions file'
-    );
-  }
-  copyRelativeAsset(promptAsset);
-}
-function toStoredMetadata(source) {
-  if (source.kind === "marketplace-remote") {
-    return {
-      kind: "marketplace-remote",
-      ref: source.ref,
-      ...source.version ? { version: source.version } : {}
-    };
-  }
-  if (source.kind === "marketplace-local") {
-    return {
-      kind: "marketplace-local",
-      repoDir: source.repoDir,
-      workflowName: source.workflowName,
-      ...source.version ? { version: source.version } : {}
-    };
-  }
-  return { kind: "filesystem", path: source.workflowPath };
-}
-function installWorkflowFromSource(source, name) {
-  const { workflow } = readWorkflowSource(source.workflowPath);
-  const workflowName = name ?? workflow.name;
-  if (!workflowName) {
-    throw new Error(
-      'Workflow has no "name" field. Provide --name to specify one.'
-    );
-  }
-  const destDir = path7.join(registryDir(), workflowName);
-  copyWorkflowFiles(source.workflowPath, destDir);
-  const metadata = toStoredMetadata(source);
-  writeWorkflowSourceMetadata(destDir, metadata);
-  return workflowName;
-}
-function reResolveFromMetadata(metadata, refresh = refreshMarketplaceRepo, onSelfHeal) {
-  if (metadata.kind === "marketplace-remote") {
-    const slug = metadata.ref.slice(metadata.ref.indexOf("@") + 1);
-    const slashIdx = slug.indexOf("/");
-    const owner = slug.slice(0, slashIdx);
-    const repo = slug.slice(slashIdx + 1);
-    const refreshed = refresh(owner, repo);
-    if (!refreshed.ok) {
-      throw new MarketplaceRefreshError(refreshed);
-    }
-    if (refreshed.selfHealed) {
-      onSelfHeal?.({
-        marketplace: `${owner}/${repo}`,
-        backupDir: refreshed.backupDir
-      });
-    }
-    return resolveWorkflowInstall(metadata.ref, []);
-  }
-  if (metadata.kind === "marketplace-local") {
-    const manifestPath = resolveWorkflowManifestPath(metadata.repoDir);
-    const listings = listMarketplaceWorkflowsFromRepo(metadata.repoDir);
-    const entry = listings.find((l) => l.name === metadata.workflowName);
-    if (!entry) {
-      throw new Error(
-        `Workflow "${metadata.workflowName}" is no longer in the local marketplace at ${metadata.repoDir}.`
-      );
-    }
-    return {
-      kind: "marketplace-local",
-      repoDir: metadata.repoDir,
-      workflowName: metadata.workflowName,
-      ...entry.version ? { version: entry.version } : {},
-      manifestPath,
-      workflowPath: entry.workflowPath
-    };
-  }
-  return { kind: "filesystem", workflowPath: metadata.path };
-}
-function updateWorkflow(name, refresh = refreshMarketplaceRepo, onSelfHeal) {
-  const workflowDir = path7.join(registryDir(), name);
-  const metadata = readWorkflowSourceMetadata(workflowDir);
-  if (!metadata) {
-    throw new Error(
-      `Workflow "${name}" has no recorded source. Reinstall it with: athena-flow workflow install <source>`
-    );
-  }
-  const source = reResolveFromMetadata(metadata, refresh, onSelfHeal);
-  const installedName = installWorkflowFromSource(source, name);
-  refreshPinnedWorkflowPlugins(resolveWorkflow(installedName));
-  return installedName;
-}
-function updateWorkflows(names) {
-  const refreshCache = /* @__PURE__ */ new Map();
-  const refresh = (owner, repo) => {
-    const key = `${owner}/${repo}`;
-    const cached = refreshCache.get(key);
-    if (cached) return cached;
-    const outcome = refreshMarketplaceRepo(owner, repo);
-    refreshCache.set(key, outcome);
-    return outcome;
-  };
-  const upgraded = [];
-  const marketplaceFailures = [];
-  const reportedMarketplaces = /* @__PURE__ */ new Set();
-  const workflowFailures = [];
-  const selfHealed = [];
-  const selfHealedMarketplaces = /* @__PURE__ */ new Set();
-  const onSelfHeal = (info) => {
-    if (!selfHealedMarketplaces.has(info.marketplace)) {
-      selfHealedMarketplaces.add(info.marketplace);
-      selfHealed.push(info);
-    }
-  };
-  for (const name of names) {
-    try {
-      upgraded.push(updateWorkflow(name, refresh, onSelfHeal));
-    } catch (error) {
-      if (error instanceof MarketplaceRefreshError) {
-        if (!reportedMarketplaces.has(error.marketplace)) {
-          reportedMarketplaces.add(error.marketplace);
-          marketplaceFailures.push({ marketplace: error.marketplace, error });
-        }
-      } else {
-        workflowFailures.push({
-          name,
-          error: error instanceof Error ? error : new Error(String(error))
-        });
-      }
-    }
-  }
-  return { upgraded, marketplaceFailures, workflowFailures, selfHealed };
-}
-function listWorkflows() {
-  const dir = registryDir();
-  const installed = fs9.existsSync(dir) ? fs9.readdirSync(dir, { withFileTypes: true }).filter(
-    (entry) => entry.isDirectory() && fs9.existsSync(path7.join(dir, entry.name, "workflow.json"))
-  ).map((entry) => entry.name) : [];
-  const builtins = listBuiltinWorkflows().filter(
-    (name) => !installed.includes(name)
-  );
-  return [...builtins, ...installed];
-}
-function removeWorkflow(name) {
-  const dir = path7.join(registryDir(), name);
-  if (!fs9.existsSync(dir)) {
-    throw new Error(`Workflow "${name}" not found.`);
-  }
-  fs9.rmSync(dir, { recursive: true, force: true });
-}
-
-// src/core/workflows/applyWorkflow.ts
-function applyPromptTemplate(template, input, ctx) {
-  return substituteVariables(template, { input, ...ctx });
-}
-
-// src/core/workflows/plan.ts
-function compileWorkflowPlan(input) {
-  if (!input.workflow) {
-    return void 0;
-  }
-  const resolved = !input.resolvedPlugins && (!input.localPlugins || !input.codexPlugins) ? resolveWorkflowPlugins(input.workflow) : void 0;
-  const resolvedPlugins = input.resolvedPlugins ?? resolved?.resolvedPlugins ?? [];
-  const localPlugins = input.localPlugins ?? resolved?.localPlugins ?? [];
-  const codexPlugins = input.codexPlugins ?? resolved?.codexPlugins ?? [];
-  return {
-    workflow: input.workflow,
-    resolvedPlugins: resolvedPlugins.filter(
-      (plugin, index, array) => array.findIndex((candidate) => candidate.ref === plugin.ref) === index
-    ),
-    localPlugins: localPlugins.filter(
-      (plugin, index, array) => array.findIndex((candidate) => candidate.ref === plugin.ref) === index
-    ),
-    agentRoots: resolvedPlugins.map((plugin) => `${plugin.claudeArtifactDir}/agents`).filter((root, index, array) => array.indexOf(root) === index),
-    codexPlugins: codexPlugins.filter(
-      (target, index, array) => array.findIndex((candidate) => candidate.ref === target.ref) === index
-    ),
-    pluginMcpConfig: input.pluginMcpConfig
-  };
-}
-
-// src/core/workflows/sessionPlan.ts
-import fs10 from "fs";
-import path8 from "path";
-
-// src/core/workflows/stateMachine.md
-var stateMachine_default = "# Stateless Turn Protocol\n\nYou run in a stateless loop. Each Turn is a fresh process with no memory of prior Turns. **The tracker file is your only continuity** \u2014 read it, work, write it. Assume interruption: the runner may kill a long Turn, your context may collapse under tool output, you may hit token limits mid-task. Anything not in the tracker is gone.\n\n## First action, every Turn\n\n1. Read the tracker at the configured path (default: `.athena/<session_id>/tracker.md`). The runner provides the session ID \u2014 do not invent one.\n2. If the tracker contains `<!-- TRACKER_SKELETON -->` \u2192 this is Turn 1, run [**Orient**](#orient-turn-1).\n3. Otherwise \u2192 this is a continuation, run [**Execute**](#execute-turn-2) from where the tracker says, not from the start of the flow.\n\nReading first prevents two failure modes that waste whole Turns: redoing work already done, or contradicting decisions a prior Turn made.\n\n## Tracker contract\n\nThe tracker must always answer four questions:\n\n1. What are we trying to accomplish?\n2. What has been done?\n3. What's left?\n4. What should the next Turn do first?\n\nA future Turn has no other context. If something isn't here, it doesn't exist. Section headings may vary by workflow, but these four answers must be explicit and easy to find.\n\n### Terminal markers\n\nDefault markers (workflows may override \u2014 use the markers configured for the active workflow):\n\n- `<!-- WORKFLOW_COMPLETE -->` \u2014 all work done and verified\n- `<!-- WORKFLOW_BLOCKED -->` or `<!-- WORKFLOW_BLOCKED: reason -->` \u2014 cannot proceed without external intervention\n\nRules:\n\n- Only the last non-empty line of the tracker is authoritative. Marker-like text in notes, examples, or quoted instructions earlier in the file is ignored.\n- When you write a terminal marker, it must be the final non-empty line of the tracker. Put every summary, status note, and next-step sentence before the marker. Never append prose after it.\n- The runner trusts markers unconditionally. A premature marker ends the loop with no automatic recovery \u2014 write one only when its criteria are fully met.\n- Include a concrete reason after `WORKFLOW_BLOCKED:` whenever possible; the bare form is still valid.\n\n## Phases\n\n### Orient (Turn 1)\n\n1. **Replace the skeleton immediately**, before any domain work. Even a three-line tracker (goal + \"orienting\") protects you if the Turn dies during setup.\n2. Identify and load the applicable workflow skills before doing domain work. If a workflow, plugin, or local skill table names a relevant skill, read it fully and follow it. Do not assume you already know the workflow's conventions, tool sequence, quality gates, or implementation details.\n3. Use a dedicated git worktree for repository-changing work. If you are not already inside a task-specific worktree, create or enter one before editing files, record its branch/path in the tracker, and continue there. Skip this only when the workflow explicitly forbids it or the task is read-only.\n4. Run the workflow's orientation steps exactly as written. These vary by domain \u2014 a test-writing workflow explores the product in a browser; a migration workflow audits the schema. The workflow defines what orientation means. Do not skip, reorder, reinterpret, or replace workflow steps with a generic approach unless the workflow explicitly allows it or the tracker records a concrete blocker that makes the written step impossible.\n5. Refine the tracker into a granular plan. Each task a concrete, verifiable unit of work, including verification steps (running checks, reviewing output) \u2014 not just implementation. Vague tasks (\"write tests\") cannot be meaningfully resumed by a future Turn that has no idea what they mean here.\n6. Record concrete observations \u2014 what you actually saw, not what you assumed. Wrong assumptions burn entire future Turns on rework.\n7. **Single-Turn requests still go through this phase.** If the entire request is satisfied in one Turn, write a minimal tracker (what was asked, what was done, the outcome) and append `<!-- WORKFLOW_COMPLETE -->`. Leaving the skeleton in place causes the runner to classify the Turn as a failure.\n\n### Execute (Turn 2+)\n\n- Work from where the tracker says, in the workflow's prescribed sequence. Not every Turn covers every step.\n- Be strict with workflow steps. Before starting each unit, identify the next required workflow step from the workflow document and tracker, follow it as written, and record completion or blockers against that step. Do not substitute your own process, collapse separate gates into one, or advance past an unchecked step.\n- Be strict with skills. Before each new activity, check the workflow, plugin metadata, local skill table, and tracker for relevant skills. Load the appropriate skill first, read it completely, and follow its instructions. If no skill applies, record that explicitly in the tracker before proceeding. Skills carry the implementation detail (scaffolding steps, locator rules, anti-patterns, code templates) that this protocol intentionally doesn't repeat.\n- Keep repository work inside the recorded git worktree. If a continuation Turn starts outside the recorded worktree, enter it before editing. If no worktree is recorded and edits are still required, create or enter one before proceeding.\n- Delegate heavy exploration or generation to subagents via the Task tool. Pass file paths, conventions, and concrete output expectations; tell them which skill to load. Respect the workflow's **delegation constraints** \u2014 some operations must run in the main agent because their output is proof, or because the main agent needs to interpret results in context.\n- Run quality gates in order. Do not skip \u2014 they exist because skipping cascades into rework. On a failing verdict, address the issues and re-run before proceeding. Respect the workflow's **retry limits**: repeated failure usually signals a deeper issue another retry won't fix.\n\n### End\n\n1. Tracker reflects all progress, discoveries, and blockers.\n2. Tracker says clearly what the next Turn should do first.\n3. If all work is verified: append the completion marker as the final non-empty line.\n4. If an unrecoverable blocker prevents progress: append the blocked marker as the final non-empty line, with a reason if you have one.\n\n## When to write the tracker\n\nWrite on **concrete triggers**, not on a vague sense of \"meaningful progress.\" The right cadence sits between every-tool-call (noisy log, wastes tokens) and end-of-Turn (everything lost if you die mid-task).\n\n- **Discrete unit done** \u2014 file written, fix applied, test run, gate passed. Reflect the new reality before starting the next unit.\n- **Insight learned** \u2014 API quirk, config field that turned out to matter, dead end ruled out, decision between two approaches. Insights are tracker-worthy even when no code changed; rediscovering them costs the next Turn a full re-exploration. The tracker is a knowledge ledger, not just a task log.\n- **About to do something risky or long-running** \u2014 subagent dispatch, long build, flaky external call, large refactor. Write _first_, then act. If the operation kills your Turn, only what's on disk survives.\n- **Plan changed** \u2014 task resequenced, new task surfaced, planned task no longer needed. Stale plans poison continuation Turns.\n- **You haven't written in a while** \u2014 if you can't remember the last update, you've gone too long. A short defensive update (\"doing X, last completed Y, next is Z\") beats nothing.\n\nEach update covers: what changed (work or knowledge), what's now next, and any caveat the next Turn needs. Don't transcribe tool calls \u2014 the tracker is a contract with your future self, not a replay log.\n\nThe cost of one extra tracker update is a few tokens. The cost of dying without one is a whole wasted Turn. Bias toward writing.\n\n## Task UI projection\n\nThe tracker is the durable source of truth. Your harness's task tools are a Turn-scoped UI projection of the same plan, shown to the user in their CLI widget. They do not survive process exit.\n\n{{TASK_TOOL_INSTRUCTIONS}}\n\n- **Turn 1, after orientation:** project the tracker's task plan into the task tools.\n- **Turn 2+, after reading the tracker:** recreate the projection from the tracker; do not assume task IDs from prior Turns still exist.\n- **During work:** update both \u2014 the task tools for immediate UI feedback, the tracker for persistence \u2014 in the same working phase.\n\n## Turn bounding\n\nEach fresh Turn starts with a clean context window and a compact tracker \u2014 effectively self-compaction. As you work, context fills with tool outputs and intermediate state. The longer you run, the more attention is spread across tokens that are no longer relevant, degrading precision on the work that matters now.\n\nWork a bounded chunk per Turn. Ending early and letting the next Turn pick up from a clean tracker is almost always better than pushing through with a heavy context. Natural checkpoints:\n\n- After a quality gate\n- After crossing multiple phases (explored \u2192 planned \u2192 wrote specs) \u2014 stop before pushing into the next\n- When your context is visibly heavy with tool output from earlier work\n\n## Quick reference\n\n- [ ] Read the tracker before doing anything else\n- [ ] Replace the skeleton immediately, even for single-Turn requests\n- [ ] Update on concrete triggers \u2014 unit done, insight learned, risky op pending, plan changed\n- [ ] Project the tracker plan into task tools at Turn start; keep both in sync as work lands\n- [ ] Follow the workflow steps as written; do not skip, reorder, or substitute your own process\n- [ ] Load the appropriate skill before each activity; do not rely on assumed knowledge\n- [ ] Use and record a dedicated git worktree for repository-changing work\n- [ ] Run quality gates in order; respect delegation constraints and retry limits\n- [ ] Write the completion marker only when all work is verified, and make it the final non-empty line\n- [ ] Checkpoint and end before context goes stale\n";
-
-// src/core/workflows/stateMachine.ts
-function buildTaskToolInstructions(harness) {
-  switch (harness) {
-    case "openai-codex":
-      return `Use the \`update_plan\` tool to create and maintain the task list shown to the user for the full harness session.
-
-- As soon as orientation yields a credible plan, create a detailed task list from the tracker; each item should be a concrete, verifiable unit of work, not a vague phase
-- At the start of every fresh harness session, recreate the full task list from the tracker before resuming execution
-- Do not carry forward prior session task IDs or assume prior session plan items still exist in the tool
-- Keep the task list accurate throughout the session: when scope, ordering, status, or completion changes, update \`update_plan\` immediately in the same working phase as the tracker
-- Keep task state consistent and non-stale: reconcile the task list against the tracker before moving on, and before ending the session
-- Maintain exactly one \`in_progress\` task unless the tracker explicitly records parallel active work`;
-    case "claude-code":
-    case "opencode":
-    default:
-      return `Use \`TaskCreate\` and \`TaskUpdate\` to create and maintain the task list shown to the user for the full harness session.
-
-- As soon as orientation yields a credible plan, create a detailed task list from the tracker; each item should be a concrete, verifiable unit of work, not a vague phase
-- At the start of every fresh harness session, recreate the full task list from the tracker instead of trying to resume prior session task IDs
-- Do not refer to task IDs created in earlier sessions; they are session-scoped UI artifacts, not durable workflow state
-- Keep the task list accurate throughout the session: when scope, ordering, status, or completion changes, update the task list in the same working phase as the tracker
-- Keep task state consistent and non-stale: reconcile the task list against the tracker before moving on, and before ending the session
-- Maintain exactly one active task unless the tracker explicitly records parallel active work`;
-  }
-}
-function buildStateMachineContent(harness = "claude-code") {
-  return stateMachine_default.replace(
-    "{{TASK_TOOL_INSTRUCTIONS}}",
-    buildTaskToolInstructions(harness)
-  );
-}
-var STATE_MACHINE_CONTENT = buildStateMachineContent();
-
-// src/core/workflows/sessionPlan.ts
-function readWorkflowOverride(projectDir, workflow, sessionId, trackerPath, harness = "claude-code") {
-  if (!workflow?.workflowFile) {
-    return { workflowOverride: void 0, warnings: [] };
-  }
-  const resolvedPath = path8.isAbsolute(workflow.workflowFile) ? workflow.workflowFile : path8.resolve(projectDir, workflow.workflowFile);
-  let workflowContent;
-  try {
-    workflowContent = fs10.readFileSync(resolvedPath, "utf-8");
-  } catch {
-    return {
-      workflowOverride: void 0,
-      warnings: [
-        `Workflow file not found: ${workflow.workflowFile}. Continuing without workflow system instructions.`
-      ]
-    };
-  }
-  let composed = workflow.loop?.enabled ? buildStateMachineContent(harness) + "\n\n" + workflowContent : workflowContent;
-  composed = substituteVariables(composed, {
-    sessionId,
-    trackerPath: trackerPath ?? void 0
-  });
-  const workflowDir = path8.dirname(resolvedPath);
-  const composedPath = path8.join(workflowDir, ".composed-system-prompt.md");
-  fs10.writeFileSync(composedPath, composed, "utf-8");
-  return {
-    workflowOverride: {
-      appendSystemPromptFile: composedPath,
-      developerInstructions: composed
-    },
-    warnings: []
-  };
-}
-function mergeOverrides(base, workflowOverride) {
-  if (!base) return workflowOverride;
-  if (!workflowOverride) return base;
-  return {
-    ...base,
-    ...workflowOverride
-  };
-}
-function resolveTrackerPath(input) {
-  const loop = input.workflow?.loop;
-  if (!loop?.enabled) {
-    return null;
-  }
-  const rawPath = loop.trackerPath ?? DEFAULT_TRACKER_PATH;
-  if (!input.sessionId && rawPath.includes("{sessionId}")) {
-    return null;
-  }
-  const promptPath = input.sessionId ? rawPath.replaceAll("{sessionId}", input.sessionId) : rawPath;
-  const absolutePath = path8.isAbsolute(promptPath) ? promptPath : path8.resolve(input.projectDir, promptPath);
-  return {
-    absolutePath,
-    promptPath
-  };
-}
-function createWorkflowRunState(input) {
-  const { projectDir, sessionId, workflow, harness } = input;
-  const trackerResolved = resolveTrackerPath({ projectDir, sessionId, workflow });
-  const { workflowOverride, warnings } = readWorkflowOverride(
-    projectDir,
-    workflow,
-    sessionId,
-    trackerResolved?.promptPath,
-    harness
-  );
-  return {
-    workflow,
-    trackerPathForPrompt: trackerResolved?.promptPath,
-    workflowOverride,
-    warnings
-  };
-}
-function prepareWorkflowTurn(state, input) {
-  const { workflow } = state;
-  const iteration = input.iteration ?? 1;
-  const isContinuation = workflow?.loop?.enabled === true && iteration > 1;
-  const prompt = isContinuation ? buildContinuePrompt({
-    ...workflow.loop,
-    trackerPath: state.trackerPathForPrompt ?? workflow.loop?.trackerPath
-  }) : workflow ? applyPromptTemplate(workflow.promptTemplate, input.prompt) : input.prompt;
-  return {
-    prompt,
-    configOverride: mergeOverrides(
-      input.configOverride,
-      state.workflowOverride
-    ),
-    warnings: state.warnings
-  };
-}
-
-// src/core/workflows/useWorkflowSessionController.ts
-import { useCallback, useEffect, useRef, useState } from "react";
-
-// src/core/workflows/workflowRunner.ts
-import crypto from "crypto";
-import fs12 from "fs";
-import path9 from "path";
-
-// src/core/workflows/terminalOutcome.ts
-import fs11 from "fs";
-var MISSING_TRACKER_MESSAGE = "the tracker file went missing during the run \u2014 the workflow can no longer verify progress";
-var SKELETON_NOT_REPLACED_MESSAGE = "tracker skeleton was never replaced \u2014 Claude did not bootstrap the tracker";
-var MISPLACED_TERMINAL_MARKER_MESSAGE = "terminal workflow marker is not the final non-empty line of the tracker; move all summary text above the marker";
-function resolveTurnOutcome(input) {
-  const { trackerPath, loop, iteration } = input;
-  if (!fs11.existsSync(trackerPath)) {
-    return {
-      kind: "stop",
-      status: "failed",
-      stopReason: MISSING_TRACKER_MESSAGE
-    };
-  }
-  const tracker = parseTrackerState(readTracker(trackerPath), loop);
-  if (tracker.skeletonNotReplaced) {
-    return {
-      kind: "stop",
-      status: "failed",
-      stopReason: SKELETON_NOT_REPLACED_MESSAGE
-    };
-  }
-  if (tracker.misplacedTerminalMarker) {
-    return {
-      kind: "stop",
-      status: "failed",
-      stopReason: MISPLACED_TERMINAL_MARKER_MESSAGE
-    };
-  }
-  if (tracker.completed) {
-    return { kind: "stop", status: "completed" };
-  }
-  if (tracker.blocked) {
-    return { kind: "stop", status: "blocked", stopReason: tracker.blockedReason };
-  }
-  if (iteration >= loop.maxIterations) {
-    return { kind: "stop", status: "exhausted" };
-  }
-  return { kind: "continue" };
-}
-
-// src/core/workflows/workflowRunner.ts
-var NULL_TOKENS = {
-  input: null,
-  output: null,
-  cacheRead: null,
-  cacheWrite: null,
-  total: null,
-  contextSize: null,
-  contextWindowSize: null
-};
-var TRACKER_SKELETON_TEMPLATE = `${TRACKER_SKELETON_MARKER}
-# Workflow Tracker
-
-**Session**: {sessionId}
-**Tracker**: {trackerPath}
-**Goal**: {input}
-
----
-
-> This tracker was created by the runner. Update it as you work.
-> See the Stateless Turn Protocol for tracker conventions.
-
-## Status
-
-Orientation in progress.
-
-## Plan
-
-_To be created during orientation._
-
-## Progress
-
-_No progress yet._
-`;
-function mergeTokens(base, next) {
-  const input = (base.input ?? 0) + (next.input ?? 0);
-  const output = (base.output ?? 0) + (next.output ?? 0);
-  const cacheRead = (base.cacheRead ?? 0) + (next.cacheRead ?? 0);
-  const cacheWrite = (base.cacheWrite ?? 0) + (next.cacheWrite ?? 0);
-  const hasAny = base.input !== null || next.input !== null || base.output !== null || next.output !== null || base.cacheRead !== null || next.cacheRead !== null || base.cacheWrite !== null || next.cacheWrite !== null;
-  if (!hasAny)
-    return {
-      ...NULL_TOKENS,
-      contextSize: next.contextSize,
-      contextWindowSize: next.contextWindowSize
-    };
-  return {
-    input,
-    output,
-    cacheRead,
-    cacheWrite,
-    total: input + output + cacheRead + cacheWrite,
-    contextSize: next.contextSize ?? base.contextSize,
-    contextWindowSize: next.contextWindowSize ?? base.contextWindowSize
-  };
-}
-function defaultCreateTracker(trackerPath, content) {
-  fs12.mkdirSync(path9.dirname(trackerPath), { recursive: true });
-  try {
-    fs12.writeFileSync(trackerPath, content, { encoding: "utf-8", flag: "wx" });
-  } catch (e) {
-    if (e.code !== "EEXIST") throw e;
-  }
-}
-function createWorkflowRunner(input) {
-  const runId = crypto.randomUUID();
-  let cancelled = false;
-  let status = "running";
-  let iterations = 0;
-  let cumulativeTokens = { ...NULL_TOKENS };
-  let stopReason;
-  const trackerResolved = resolveTrackerPath({
-    projectDir: input.projectDir,
-    sessionId: input.sessionId,
-    workflow: input.workflow
-  });
-  const trackerAbsPath = trackerResolved?.absolutePath ?? null;
-  const trackerPromptPath = trackerResolved?.promptPath;
-  function snapshot() {
-    return {
-      runId,
-      sessionId: input.sessionId,
-      workflowName: input.workflow?.name,
-      iteration: iterations,
-      maxIterations: input.workflow?.loop?.maxIterations ?? 1,
-      status,
-      stopReason,
-      trackerPath: trackerPromptPath
-    };
-  }
-  function persist() {
-    try {
-      input.persistRunState(snapshot());
-    } catch {
-    }
-  }
-  const result = (async () => {
-    await Promise.resolve();
-    if (trackerAbsPath && input.workflow?.loop?.enabled) {
-      const content = substituteVariables(TRACKER_SKELETON_TEMPLATE, {
-        sessionId: input.sessionId,
-        trackerPath: trackerPromptPath,
-        input: input.prompt
-      });
-      const write = input.createTracker ?? defaultCreateTracker;
-      write(trackerAbsPath, content);
-    }
-    persist();
-    const workflowState = createWorkflowRunState({
-      projectDir: input.projectDir,
-      sessionId: input.sessionId,
-      workflow: input.workflow,
-      harness: input.harness
-    });
-    let nextContinuation = input.initialContinuation ?? {
-      mode: "fresh"
-    };
-    const loop = input.workflow?.loop;
-    while (!cancelled) {
-      iterations++;
-      const prepared = prepareWorkflowTurn(workflowState, {
-        prompt: input.prompt,
-        iteration: iterations,
-        configOverride: void 0
-      });
-      const turnResult = await input.startTurn({
-        prompt: prepared.prompt,
-        continuation: nextContinuation,
-        configOverride: prepared.configOverride
-      });
-      if (cancelled) {
-        status = "cancelled";
-        persist();
-        break;
-      }
-      cumulativeTokens = mergeTokens(cumulativeTokens, turnResult.tokens);
-      if (turnResult.error || turnResult.exitCode !== null && turnResult.exitCode !== 0) {
-        status = "failed";
-        const parts = [];
-        if (turnResult.error?.message) {
-          parts.push(turnResult.error.message);
-        } else if (turnResult.exitCode !== null) {
-          parts.push(`Process exited with code ${turnResult.exitCode}`);
-        }
-        if (turnResult.lastStderr) {
-          parts.push(turnResult.lastStderr);
-        }
-        stopReason = parts.join(": ") || "Turn failed";
-        persist();
-        break;
-      }
-      const transport = turnResult.diagnostics?.transport;
-      if (transport && transport.streamToolUses > 0 && transport.preToolUseEvents === 0) {
-        status = "failed";
-        stopReason = `Hook transport broken: observed ${transport.streamToolUses} tool use(s) in Claude stream but received no PreToolUse events.`;
-        persist();
-        break;
-      }
-      if (!loop?.enabled) {
-        status = "completed";
-        persist();
-        break;
-      }
-      if (trackerAbsPath) {
-        const outcome = resolveTurnOutcome({
-          trackerPath: trackerAbsPath,
-          loop,
-          iteration: iterations
-        });
-        if (outcome.kind === "stop") {
-          status = outcome.status;
-          stopReason = outcome.stopReason;
-          persist();
-          break;
-        }
-      }
-      persist();
-      input.onIterationComplete?.(snapshot());
-      nextContinuation = { mode: "fresh" };
-    }
-    if (cancelled && status === "running") {
-      status = "cancelled";
-      persist();
-    }
-    return {
-      runId,
-      status,
-      iterations,
-      stopReason,
-      tokens: cumulativeTokens
-    };
-  })();
-  return {
-    runId,
-    result,
-    cancel() {
-      cancelled = true;
-    },
-    kill() {
-      cancelled = true;
-      input.abortCurrentTurn?.();
-    }
-  };
-}
-
-// src/core/workflows/useWorkflowSessionController.ts
-function useWorkflowSessionController(base, input) {
-  const [isRunning, setIsRunning] = useState(false);
-  const runnerRef = useRef(null);
-  const activeRunIdRef = useRef(null);
-  const cancelCurrentRun = useCallback(async () => {
-    const runner = runnerRef.current;
-    if (runner) {
-      runner.kill();
-      await runner.result.catch(() => {
-      });
-      runnerRef.current = null;
-      activeRunIdRef.current = null;
-    }
-  }, []);
-  const interrupt = useCallback(() => {
-    const runner = runnerRef.current;
-    if (runner) {
-      runner.kill();
-      runnerRef.current = null;
-      activeRunIdRef.current = null;
-    } else {
-      void base.kill().catch(() => {
-      });
-    }
-    setIsRunning(false);
-  }, [base]);
-  const kill = useCallback(async () => {
-    if (runnerRef.current) {
-      await cancelCurrentRun();
-    } else {
-      await base.kill();
-    }
-    setIsRunning(false);
-  }, [base, cancelCurrentRun]);
-  const spawn = useCallback(
-    async (prompt, continuation, _configOverride) => {
-      await cancelCurrentRun();
-      setIsRunning(true);
-      const handle = createWorkflowRunner({
-        sessionId: input.sessionId ?? "",
-        projectDir: input.projectDir,
-        harness: input.harness,
-        workflow: input.workflow,
-        prompt,
-        initialContinuation: continuation,
-        startTurn: (turnInput) => base.startTurn(
-          turnInput.prompt,
-          turnInput.continuation,
-          turnInput.configOverride
-        ),
-        persistRunState: input.persistRunState ?? (() => {
-        }),
-        abortCurrentTurn: () => void base.kill().catch(() => {
-        })
-      });
-      runnerRef.current = handle;
-      activeRunIdRef.current = handle.runId;
-      try {
-        const runResult = await handle.result;
-        return {
-          exitCode: runResult.status === "failed" ? 1 : 0,
-          error: runResult.status === "failed" ? new Error(runResult.stopReason ?? "Run failed") : null,
-          tokens: runResult.tokens,
-          streamMessage: null
-        };
-      } finally {
-        if (runnerRef.current === handle) {
-          runnerRef.current = null;
-          activeRunIdRef.current = null;
-          setIsRunning(false);
-        }
-      }
-    },
-    [
-      base,
-      cancelCurrentRun,
-      input.projectDir,
-      input.sessionId,
-      input.harness,
-      input.workflow,
-      input.persistRunState
-    ]
-  );
-  useEffect(() => {
-    return () => {
-      runnerRef.current?.kill();
-      runnerRef.current = null;
-      activeRunIdRef.current = null;
-    };
-  }, []);
-  return {
-    ...base,
-    startTurn: spawn,
-    isRunning,
-    interrupt,
-    kill,
-    get activeRunId() {
-      return activeRunIdRef.current;
-    }
-  };
-}
-
-// src/infra/plugins/mcpOptions.ts
-import fs13 from "fs";
-import path10 from "path";
-function collectMcpServersWithOptions(pluginDirs) {
-  const result = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const dir of pluginDirs) {
-    const mcpPath = path10.join(dir, ".mcp.json");
-    if (!fs13.existsSync(mcpPath)) {
-      continue;
-    }
-    const config = JSON.parse(fs13.readFileSync(mcpPath, "utf-8"));
-    for (const [serverName, serverConfig] of Object.entries(
-      config.mcpServers ?? {}
-    )) {
-      if (seen.has(serverName) || !Array.isArray(serverConfig.options) || serverConfig.options.length === 0) {
-        continue;
-      }
-      seen.add(serverName);
-      result.push({ serverName, options: serverConfig.options });
-    }
-  }
-  return result;
-}
-
-export {
-  createWorkflowRunner,
-  useWorkflowSessionController,
-  isMarketplaceRef,
-  findMarketplaceRepoDir,
-  resolveWorkflowMarketplaceSource,
-  listMarketplaceWorkflows,
-  listMarketplaceWorkflowsFromRepo,
-  resolveMarketplaceWorkflow,
-  gatherMarketplaceWorkflowSources,
-  resolveWorkflowInstall,
-  pullMarketplaceRepo,
-  resolveMarketplacePlugin,
-  projectConfigPath,
-  readConfig,
-  resolveActiveWorkflow,
-  readGlobalConfig,
-  writeGlobalConfig,
-  writeProjectConfig,
-  hasProjectWorkflow,
-  installWorkflowPlugins,
-  resolveWorkflowPlugins,
-  listBuiltinWorkflows,
-  resolveWorkflow,
-  installWorkflowFromSource,
-  updateWorkflow,
-  updateWorkflows,
-  listWorkflows,
-  removeWorkflow,
-  compileWorkflowPlan,
-  collectMcpServersWithOptions
-};
-//# sourceMappingURL=chunk-73V7GXV6.js.map