paqad-ai/dist/stage-isolation/agent-availability.js

Spec-driven development framework — AI agents that think before they type

import { createRequire as __paqadCreateRequire } from 'module'; const require = __paqadCreateRequire(import.meta.url);
import {
  pluginLoadState
} from "../chunk-THDANA7U.js";
import {
  MANDATORY_STAGE_AGENTS
} from "../chunk-NCYDV2N5.js";
import "../chunk-D6VEUSB6.js";
import "../chunk-ACJQW7SB.js";
import "../chunk-YA6SCYMC.js";
import "../chunk-YWAORJG6.js";
import "../chunk-IHMBVS6H.js";
import {
  init_esm_shims
} from "../chunk-IDFRWBMN.js";

// src/stage-isolation/agent-availability.ts
init_esm_shims();
import { existsSync, readFileSync } from "fs";
import { homedir } from "os";
import { join } from "path";
function projectOnboardedForClaudeCode(projectRoot) {
  try {
    const manifest = JSON.parse(
      readFileSync(join(projectRoot, ".paqad", "onboarding-manifest.json"), "utf8")
    );
    return manifest.adapter === "claude-code";
  } catch {
    return false;
  }
}
var STAGE_AGENT_MISSING_MESSAGE = "**\u25B8 paqad** \xB7 stage agents are missing\n> \u{1F534} Needs your attention \u2014 Claude Code has neither the paqad plugin agents nor a copy in this repo's `.claude/agents/` or in `~/.claude/agents/`, so a stage cannot be dispatched to its own agent. Install the paqad plugin (`/plugin install paqad@eliyce`) and start a new session. paqad stops here instead of running the stage in the main session.";
var STAGE_AGENT_MISSING_CONTEXT = `paqad stage agents are not available in this Claude Code session. When a stage needs its own agent, stop and show the Developer this message instead of running the stage in the main session:

${STAGE_AGENT_MISSING_MESSAGE}`;
function fullCopyPresent(root) {
  return MANDATORY_STAGE_AGENTS.every(
    (def) => existsSync(join(root, ".claude", "agents", `${def.agentName}.md`))
  );
}
function claudeStageAgentSource(options = {}) {
  const home = options.homeDir ?? homedir();
  const plugin = options.pluginInstalled ?? pluginLoadState(options.projectRoot ?? null, {
    home,
    env: options.homeDir === void 0 ? process.env : {}
  }) === "live";
  if (plugin) return "plugin";
  if (options.projectRoot !== void 0 && fullCopyPresent(options.projectRoot)) return "project";
  return fullCopyPresent(home) ? "home" : null;
}
function stageDispatchStopMessage(options = {}) {
  return claudeStageAgentSource(options) === null ? STAGE_AGENT_MISSING_MESSAGE : null;
}
function stageDispatchStopHookOutput(projectRoot, options = {}) {
  if (!projectOnboardedForClaudeCode(projectRoot)) return null;
  if (stageDispatchStopMessage({ projectRoot, ...options }) === null) return null;
  return `${JSON.stringify({
    systemMessage: STAGE_AGENT_MISSING_MESSAGE,
    hookSpecificOutput: {
      hookEventName: "SessionStart",
      additionalContext: STAGE_AGENT_MISSING_CONTEXT
    }
  })}
`;
}
export {
  STAGE_AGENT_MISSING_CONTEXT,
  STAGE_AGENT_MISSING_MESSAGE,
  claudeStageAgentSource,
  projectOnboardedForClaudeCode,
  stageDispatchStopHookOutput,
  stageDispatchStopMessage
};