@purveyors/cli 0.35.1 → 0.36.1

package/dist/lib/agent-skill.js

@@ -0,0 +1,611 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readFile, realpath, rename, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { basename, dirname, join, relative, resolve, sep } from 'node:path';
+import { PrvrsError } from './errors.js';
+import { HEADLESS_LOGIN_STEPS, getCliManifest, } from './manifest.js';
+/**
+ * Agent instructions rendered from the CLI manifest. The manifest stays the
+ * single source of truth: commands, flags, auth, output, exit codes, ID types,
+ * and workflows all come from `getCliManifest()`, so the skill cannot drift
+ * from the contract it describes.
+ */
+export const AGENT_SKILL_NAME = 'purveyors';
+export const AGENT_SKILL_FILE = 'SKILL.md';
+/**
+ * Supporting file in the same skill folder. Agent Skills clients load SKILL.md
+ * when the skill triggers and read other files only when SKILL.md points to
+ * them, so the step-by-step workflows, which grow with the manifest, live here.
+ * See https://code.claude.com/docs/en/skills#add-supporting-files and
+ * https://agentskills.io/specification#progressive-disclosure
+ */
+export const AGENT_WORKFLOWS_FILE = 'workflows.md';
+/** Every file in the skill folder, SKILL.md first. */
+export const AGENT_SKILL_FILES = [AGENT_SKILL_FILE, AGENT_WORKFLOWS_FILE];
+/** Upper bound for the rendered SKILL.md, enforced by tests. */
+export const AGENT_SKILL_MAX_BYTES = 8 * 1024;
+/** Upper bound for the rendered workflows.md, enforced by tests. */
+export const AGENT_WORKFLOWS_MAX_BYTES = 16 * 1024;
+const SKILL_TOPICS = 'green coffee sourcing, the purveyors.io coffee catalog, green coffee prices and market moves, green inventory, roast logging and Artisan .alog files, sales, and tasting notes';
+export const AGENT_SKILL_DESCRIPTION = `${capitalize(SKILL_TOPICS)}, through the \`purvey\` CLI. Use when the user wants to find or compare green coffees or suppliers, check prices or market signals, track inventory, log, import, or plan roasts, record sales, or rate coffees.`;
+export const SKILL_TARGETS = ['claude', 'agents', 'agents-md'];
+export const SKILL_SCOPES = ['user', 'project'];
+const ACCESS_LABELS = {
+    none: 'no sign-in',
+    viewer: 'sign-in',
+    member: 'member role',
+    mixed: 'mixed access',
+};
+// Per-command labels, used when a group's commands differ in access.
+const COMMAND_ACCESS_LABELS = {
+    none: 'public default view',
+    viewer: 'sign-in',
+    member: 'member role',
+};
+// Error patterns whose guidance another skill section already gives in full.
+const ERROR_PATTERNS_COVERED_ELSEWHERE = new Set([
+    'Not logged in',
+    'Wrong ID type',
+    'Parser mistakes like unknown options or commands',
+    'Missing required args in write commands',
+]);
+function capitalize(text) {
+    return text.charAt(0).toUpperCase() + text.slice(1);
+}
+function sha256(text) {
+    return createHash('sha256').update(text, 'utf8').digest('hex');
+}
+/**
+ * List a group's commands. When access differs across them, label each run of
+ * commands with its own access so an agent never picks a protected command
+ * expecting the public slice.
+ */
+function renderGroupCommands(group) {
+    const commands = [
+        ...(group.command ? [{ name: `${group.name} itself`, auth: group.command.auth }] : []),
+        ...(group.subcommands ?? []).map(({ name, auth }) => ({ name, auth })),
+    ];
+    if (commands.every((command) => command.auth === group.auth)) {
+        return commands.map((command) => command.name).join(', ');
+    }
+    const byAccess = new Map();
+    for (const command of commands) {
+        byAccess.set(command.auth, [...(byAccess.get(command.auth) ?? []), command.name]);
+    }
+    return [...byAccess]
+        .map(([auth, names]) => `${names.join(', ')} (${COMMAND_ACCESS_LABELS[auth]})`)
+        .join('; ');
+}
+function renderWhenToUse(manifest) {
+    // Credential-free groups (auth, config, context, manifest, skill) are setup
+    // and reference surfaces, covered in their own sections below.
+    const dataGroups = manifest.commandGroups.filter((group) => group.auth !== 'none');
+    return [
+        '## When to use it',
+        '',
+        `Use \`${manifest.binary}\` for any Purveyors task instead of scraping purveyors.io or guessing API calls. Command groups and their access:`,
+        '',
+        ...dataGroups.map((group) => `- **${group.name}** (${ACCESS_LABELS[group.auth]}): ${group.summary}. Commands: ${renderGroupCommands(group)}.`),
+    ];
+}
+function renderSetup(manifest) {
+    return [
+        '## Set up and sign in',
+        '',
+        `1. Install (${manifest.nodeVersion}): \`npm install -g ${manifest.packageName}\`, then check \`purvey --version\`.`,
+        '2. Check for an existing login: `purvey auth status --json` prints `"authenticated": true` and the role, or exits 3 when signed out.',
+        '3. If not signed in, run `purvey auth login --headless`. It prints the URL at once, then waits:',
+        ...HEADLESS_LOGIN_STEPS.map((step, index) => `   ${index + 1}. ${step}`),
+        '',
+        '   If your shell tool shows output only after a command exits, run it in the background to read the URL. Show the URL to the user; sign-in is done when the command exits 0. Rerun it if the request expires.',
+        '4. Never ask the user to paste an API key, token, or password into the chat. The CLI stores its own scoped key in ' +
+            `\`${manifest.files.credentials}\`; \`PURVEYORS_API_KEY\` or \`PARCHMENT_API_KEY\` in the environment overrides it.`,
+        '5. "sign-in" commands work for any signed-in account; "member role" needs a Purveyors membership; "public default view" runs signed out, but filters and longer windows need Parchment Intelligence. reference-profile needs Studio access. Missing access exits 3; relay the message to the user instead of retrying.',
+    ];
+}
+function renderOutput(manifest) {
+    const { structuredErrors } = manifest.outputContract;
+    const fields = (names) => names.map((field) => `\`${field}\``).join(', ');
+    return [
+        '## Output, errors, and exit codes',
+        '',
+        '- stdout carries the result as compact JSON by default; parse it rather than scraping text. Leave off `--pretty` when parsing.',
+        `- In a non-interactive shell, a failure prints one JSON envelope on ${structuredErrors.channel} with ${fields(structuredErrors.guaranteedFields)} and sometimes ${fields(structuredErrors.optionalFields)}. Progress messages also go to ${structuredErrors.channel}.`,
+        `- Exit codes: ${manifest.exitCodes.map((code) => `\`${code.exitCode}\` ${code.description}`).join('; ')}.`,
+    ];
+}
+function renderIdMap(manifest) {
+    return [
+        '## ID map',
+        '',
+        'IDs are not interchangeable. Pass the type each command expects:',
+        '',
+        ...manifest.idTypes.map((id) => `- \`${id.name}\`: ${id.usedBy.join(', ')}`),
+    ];
+}
+/** SKILL.md names each workflow and points to workflows.md for the steps. */
+function renderWorkflowIndex(manifest) {
+    return [
+        '## Workflows',
+        '',
+        `Before a multi-step task, read [${AGENT_WORKFLOWS_FILE}](${AGENT_WORKFLOWS_FILE}) next to this file (if missing: \`purvey skill print --file ${AGENT_WORKFLOWS_FILE}\`). It has the commands for:`,
+        '',
+        ...manifest.workflows.map((workflow) => `- ${workflow.title}`),
+    ];
+}
+function renderWorkflowsBody(manifest) {
+    const lines = [
+        `# Purveyors workflows (\`${manifest.binary}\` CLI)`,
+        '',
+        `Command sequences for multi-step tasks. [${AGENT_SKILL_FILE}](${AGENT_SKILL_FILE}) covers sign-in, access, the ID map, and the working rules; they apply here too.`,
+        '',
+        '- IDs and file paths below are placeholders. Take real IDs from search or list output, and check the ID map for the type each command takes.',
+        '- Leave off `--pretty` when parsing.',
+        '- Confirm with the user before a step that changes their data.',
+    ];
+    for (const workflow of manifest.workflows) {
+        lines.push('', `## ${workflow.title}`, '', '```sh', ...workflow.commands, '```');
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function renderRules(manifest) {
+    return [
+        '## Working rules',
+        '',
+        '- Give every value on the command line: positional arguments per `--help`, flags for the rest. Do not use `--form`, which prompts interactively.',
+        '- Confirm with the user before commands that change their data: add, create, update, delete, record, rate, import, save, and watch.',
+        ...manifest.errorPatterns
+            .filter((pattern) => !ERROR_PATTERNS_COVERED_ELSEWHERE.has(pattern.title))
+            .map((pattern) => `- ${pattern.title}${pattern.exitCodes.length > 0 ? ` (exit ${pattern.exitCodes.join('/')})` : ''}: ${pattern.guidance.join(' ')}`),
+    ];
+}
+function renderReference(manifest) {
+    return [
+        '## Full contract',
+        '',
+        `\`${manifest.machineSurfaces.shellManifest}\` prints the full contract as JSON: every command, argument, flag, default, auth requirement, and example. Check it before using a flag not shown here:`,
+        '',
+        '```sh',
+        'purvey manifest | jq \'.commandGroups[] | select(.name == "catalog")\'',
+        'purvey catalog search --help',
+        '```',
+        '',
+        `\`${manifest.machineSurfaces.humanReference}\` prints it as dense text. Docs: ${manifest.docs
+            .filter((link) => new URL(link.url).hostname.endsWith('purveyors.io'))
+            .map((link) => `[${link.label}](${link.url})`)
+            .join(', ')}.`,
+        '',
+        `After upgrading the CLI, refresh this file and ${AGENT_WORKFLOWS_FILE}: rerun \`purvey skill install\` with the same \`--target\` (\`claude\` for Claude Code, \`agents\` for Codex and Cursor).`,
+    ];
+}
+function renderSkillBody(manifest, version) {
+    return [
+        '---',
+        `name: ${AGENT_SKILL_NAME}`,
+        `description: ${JSON.stringify(AGENT_SKILL_DESCRIPTION)}`,
+        'metadata:',
+        `  generated-by: ${JSON.stringify(`${manifest.packageName} ${version}`)}`,
+        '---',
+        '',
+        `# Purveyors (\`${manifest.binary}\` CLI)`,
+        '',
+        ...renderWhenToUse(manifest),
+        '',
+        ...renderSetup(manifest),
+        '',
+        ...renderOutput(manifest),
+        '',
+        ...renderIdMap(manifest),
+        '',
+        ...renderWorkflowIndex(manifest),
+        '',
+        ...renderRules(manifest),
+        '',
+        ...renderReference(manifest),
+        '',
+    ].join('\n');
+}
+/**
+ * The trailing comment records a hash of everything above it, so `install` can
+ * tell an unedited earlier copy (safe to update) from one with local edits
+ * (needs --force).
+ */
+function seal(body, version, printCommand) {
+    return `${body}<!-- generated by @purveyors/cli ${version} (${printCommand}); sha256:${sha256(body)} -->\n`;
+}
+const SKILL_SEAL_PATTERN = /<!-- generated by @purveyors\/cli \S+ \(purvey skill print[^)]*\); sha256:([0-9a-f]{64}) -->\n?$/;
+/** Render SKILL.md in the open Agent Skills format. */
+export function renderAgentSkill(version, manifest = getCliManifest()) {
+    return seal(renderSkillBody(manifest, version), version, 'purvey skill print');
+}
+/** Render workflows.md, the supporting file SKILL.md points to for step-by-step workflows. */
+export function renderAgentWorkflows(version, manifest = getCliManifest()) {
+    return seal(renderWorkflowsBody(manifest), version, `purvey skill print --file ${AGENT_WORKFLOWS_FILE}`);
+}
+/** Render one file of the skill folder. */
+export function renderAgentSkillFile(file, version, manifest = getCliManifest()) {
+    return file === AGENT_SKILL_FILE
+        ? renderAgentSkill(version, manifest)
+        : renderAgentWorkflows(version, manifest);
+}
+function isUnmodifiedGeneratedSkill(text) {
+    const match = SKILL_SEAL_PATTERN.exec(text);
+    return Boolean(match && sha256(text.slice(0, match.index)) === match[1]);
+}
+const AGENTS_MD_BEGIN = '<!-- BEGIN purvey agent instructions';
+const AGENTS_MD_END = '<!-- END purvey agent instructions -->';
+const AGENTS_MD_BEGIN_PATTERN = /^<!-- BEGIN purvey agent instructions: generated by @purveyors\/cli \S+ \(purvey skill print --agents-md\); sha256:([0-9a-f]{64}) -->$/;
+function renderAgentsMdInner(manifest) {
+    const exitCodes = manifest.exitCodes
+        .map((code) => `${code.exitCode} ${code.code.toLowerCase().replace(/_/g, ' ')}`)
+        .join(', ');
+    return [
+        `## Purveyors coffee data (\`${manifest.binary}\` CLI)`,
+        '',
+        `- Use \`${manifest.binary}\` for ${SKILL_TOPICS}. Install with \`npm install -g ${manifest.packageName}\`.`,
+        '- Sign in with `purvey auth login --headless`: show the user the approval URL it prints and wait for it to exit 0. Never ask for an API key, token, or password in chat.',
+        `- stdout is JSON; failures print a JSON envelope on stderr. Exit codes: ${exitCodes}.`,
+        `- IDs are not interchangeable (${manifest.idTypes.map((id) => `\`${id.name}\``).join(', ')}); check which one a command takes.`,
+        '- Do not use `--form`. Confirm with the user before commands that change their data.',
+        `- Full contract: \`${manifest.machineSurfaces.shellManifest}\`. For the fuller guide with workflows as a skill, run \`purvey skill install --target claude\` in Claude Code, or \`--target agents\` in Codex, Cursor, and other Agent Skills tools.`,
+        '',
+    ].join('\n');
+}
+/** Render the marked AGENTS.md block; markers let `install` refresh it in place. */
+export function renderAgentsMdBlock(version, manifest = getCliManifest()) {
+    const inner = renderAgentsMdInner(manifest);
+    return `${AGENTS_MD_BEGIN}: generated by @purveyors/cli ${version} (purvey skill print --agents-md); sha256:${sha256(inner)} -->\n${inner}${AGENTS_MD_END}\n`;
+}
+function findAgentsMdBlock(text, path) {
+    const start = text.indexOf(AGENTS_MD_BEGIN);
+    if (start === -1) {
+        return null;
+    }
+    const endMarker = text.indexOf(AGENTS_MD_END, start);
+    const beginLineEnd = text.indexOf('\n', start);
+    if (endMarker === -1 ||
+        beginLineEnd === -1 ||
+        beginLineEnd > endMarker ||
+        text.indexOf(AGENTS_MD_BEGIN, start + 1) !== -1) {
+        throw new PrvrsError('CONFIG_ERROR', `${path} has an incomplete or repeated purvey agent instructions block. Fix or remove its BEGIN/END markers, then re-run.`, { path, reason: 'malformed-block' });
+    }
+    let end = endMarker + AGENTS_MD_END.length;
+    if (text[end] === '\n') {
+        end += 1;
+    }
+    const match = AGENTS_MD_BEGIN_PATTERN.exec(text.slice(start, beginLineEnd));
+    const inner = text.slice(beginLineEnd + 1, endMarker);
+    return { start, end, unmodified: Boolean(match && sha256(inner) === match[1]) };
+}
+export function resolveSkillInstallPath(target, scope, roots = {}) {
+    const home = roots.home ?? homedir();
+    const cwd = roots.cwd ?? process.cwd();
+    if (target === 'agents-md') {
+        return join(cwd, 'AGENTS.md');
+    }
+    const base = scope === 'user' ? home : cwd;
+    const toolDir = target === 'claude' ? '.claude' : '.agents';
+    return join(base, toolDir, 'skills', AGENT_SKILL_NAME, AGENT_SKILL_FILE);
+}
+function parseTarget(value) {
+    if (!value) {
+        throw new PrvrsError('INVALID_ARGUMENT', `--target is required: ${SKILL_TARGETS.join(', ')}. Use claude for Claude Code, agents for Codex, Cursor, and other Agent Skills clients, or agents-md for this repository's AGENTS.md.`);
+    }
+    if (!SKILL_TARGETS.includes(value)) {
+        throw new PrvrsError('INVALID_ARGUMENT', `Unknown --target "${value}". Use one of: ${SKILL_TARGETS.join(', ')}.`);
+    }
+    return value;
+}
+function parseScope(target, value) {
+    if (value !== undefined && !SKILL_SCOPES.includes(value)) {
+        throw new PrvrsError('INVALID_ARGUMENT', `Unknown --scope "${value}". Use one of: ${SKILL_SCOPES.join(', ')}.`);
+    }
+    if (target === 'agents-md') {
+        if (value === 'user') {
+            throw new PrvrsError('INVALID_ARGUMENT', 'AGENTS.md is repository-level. Run from the repository root without --scope, or with --scope project.');
+        }
+        return 'project';
+    }
+    return value ?? 'user';
+}
+async function readExisting(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ENOENT') {
+            return null;
+        }
+        if (code === 'EISDIR') {
+            throw new PrvrsError('CONFIG_ERROR', `${path} is a directory, not a file.`, { path });
+        }
+        throw error;
+    }
+}
+function refuseOverwrite(path, what) {
+    throw new PrvrsError('CONFIG_ERROR', `${what} at ${path} has local edits or was not written by purvey. Keep it, or re-run with --force to replace it.`, { path, reason: 'modified' });
+}
+/** Returns null when the file has local edits and `force` is off. */
+function planSkillFile(existing, desired, force) {
+    if (existing === null)
+        return { action: 'create', content: desired };
+    if (existing === desired)
+        return { action: 'unchanged', content: desired };
+    if (isUnmodifiedGeneratedSkill(existing))
+        return { action: 'update', content: desired };
+    if (force)
+        return { action: 'overwrite', content: desired };
+    return null;
+}
+/**
+ * Plan every file in the skill folder before writing any of them, so a refusal
+ * leaves the folder exactly as it was. A folder from a single-file install has
+ * no workflows.md yet; that file is simply created.
+ */
+async function planSkillFolder(skillPath, version, manifest, force) {
+    const planned = [];
+    const refused = [];
+    for (const file of AGENT_SKILL_FILES) {
+        const path = join(dirname(skillPath), file);
+        const plan = planSkillFile(await readExisting(path), renderAgentSkillFile(file, version, manifest), force);
+        if (plan) {
+            planned.push({ file, path, ...plan });
+        }
+        else {
+            refused.push(path);
+        }
+    }
+    if (refused.length > 0) {
+        const files = refused.map((path) => basename(path)).join(' and ');
+        const [verb, past, pronoun] = refused.length > 1 ? ['have', 'were', 'them'] : ['has', 'was', 'it'];
+        throw new PrvrsError('CONFIG_ERROR', `${files} in ${dirname(skillPath)} ${verb} local edits or ${past} not written by purvey. Nothing was written. Keep ${pronoun}, or re-run with --force to replace ${pronoun}.`, { path: refused[0], paths: refused, reason: 'modified' });
+    }
+    return planned;
+}
+const ACTION_RANK = ['overwrite', 'update', 'create', 'unchanged'];
+function summarizeActions(actions) {
+    return ACTION_RANK.find((action) => actions.includes(action)) ?? 'unchanged';
+}
+function planAgentsMd(existing, block, path, force) {
+    if (existing === null)
+        return { action: 'create', content: block };
+    const current = findAgentsMdBlock(existing, path);
+    if (!current) {
+        const separator = existing.length === 0 ? '' : existing.endsWith('\n') ? '\n' : '\n\n';
+        return { action: 'append', content: `${existing}${separator}${block}` };
+    }
+    const content = existing.slice(0, current.start) + block + existing.slice(current.end);
+    if (content === existing)
+        return { action: 'unchanged', content };
+    if (current.unmodified)
+        return { action: 'update', content };
+    if (force)
+        return { action: 'overwrite', content };
+    return refuseOverwrite(path, 'The purvey block in AGENTS.md');
+}
+// ─── Claude Code and AGENTS.md ───────────────────────────────────────────────
+export const CLAUDE_CODE_AGENTS_MD_DOCS = 'https://code.claude.com/docs/en/memory#agents-md';
+/** Per directory, any of these makes Claude Code read CLAUDE.md files instead of AGENTS.md. */
+const CLAUDE_MD_NAMES = ['CLAUDE.md', join('.claude', 'CLAUDE.md'), 'CLAUDE.local.md'];
+/** Claude Code expands imports up to four hops deep. */
+const MAX_IMPORT_HOPS = 4;
+async function readIfFile(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+async function canonicalPath(path) {
+    try {
+        return await realpath(path);
+    }
+    catch {
+        return resolve(path);
+    }
+}
+/**
+ * CLAUDE.md files in `cwd` and every directory above it, nearest first. The
+ * user-level ~/.claude/CLAUDE.md loads alongside AGENTS.md, so it does not count.
+ */
+async function findClaudeMdFiles(cwd, home) {
+    const userClaudeMd = resolve(home, '.claude', 'CLAUDE.md');
+    const found = [];
+    let dir = resolve(cwd);
+    for (;;) {
+        for (const name of CLAUDE_MD_NAMES) {
+            const path = join(dir, name);
+            if (path !== userClaudeMd && (await readIfFile(path)) !== null) {
+                found.push(path);
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return found;
+        dir = parent;
+    }
+}
+/** `@path` imports, skipping fenced blocks, code spans, and HTML comments. */
+function importPaths(text, fromDir, home) {
+    const prose = text
+        .replace(/^(```|~~~)[\s\S]*?^\1/gm, '')
+        .replace(/<!--[\s\S]*?-->/g, '')
+        .replace(/`[^`\n]*`/g, '');
+    return [...prose.matchAll(/(?:^|\s)@((?:\\ |\S)+)/g)].map(([, raw]) => {
+        const path = raw.replace(/\\ /g, ' ');
+        return path.startsWith('~/') ? join(home, path.slice(2)) : resolve(fromDir, path);
+    });
+}
+async function importsFile(file, target, home, hops = MAX_IMPORT_HOPS, seen = new Set()) {
+    if (hops === 0 || seen.has(file))
+        return false;
+    seen.add(file);
+    const text = await readIfFile(file);
+    if (text === null)
+        return false;
+    for (const path of importPaths(text, dirname(file), home)) {
+        if ((await canonicalPath(path)) === target ||
+            (await importsFile(path, target, home, hops - 1, seen))) {
+            return true;
+        }
+    }
+    return false;
+}
+async function detectClaudeCodeVisibility(agentsMdPath, cwd, home) {
+    const claudeMdFiles = await findClaudeMdFiles(cwd, home);
+    const target = await canonicalPath(agentsMdPath);
+    for (const file of claudeMdFiles) {
+        // A CLAUDE.md symlinked to AGENTS.md loads the same content.
+        if ((await canonicalPath(file)) === target || (await importsFile(file, target, home))) {
+            return {
+                visibility: {
+                    visible: true,
+                    via: 'claude-md-import',
+                    reason: `${file} imports AGENTS.md, so Claude Code loads the block.`,
+                    claudeMdFiles,
+                },
+                importedBy: file,
+            };
+        }
+    }
+    if (claudeMdFiles.length === 0) {
+        return {
+            visibility: {
+                visible: true,
+                via: 'agents-md',
+                reason: 'No CLAUDE.md, .claude/CLAUDE.md, or CLAUDE.local.md in this directory or above it, so Claude Code v2.1.277 or later reads AGENTS.md directly.',
+                claudeMdFiles,
+            },
+            importedBy: null,
+        };
+    }
+    return {
+        visibility: {
+            visible: false,
+            via: null,
+            reason: `Claude Code reads ${claudeMdFiles.join(', ')} instead of AGENTS.md and finds no @AGENTS.md import. Re-run with --link-claude-md to add an @AGENTS.md import, or install the skill with --target claude. See ${CLAUDE_CODE_AGENTS_MD_DOCS}`,
+            claudeMdFiles,
+        },
+        importedBy: null,
+    };
+}
+/**
+ * Plan the `@AGENTS.md` import for --link-claude-md. It goes into this
+ * directory's CLAUDE.md (or .claude/CLAUDE.md), creating CLAUDE.md when only a
+ * CLAUDE.local.md or a parent directory's CLAUDE.md exists. Files above the
+ * project may be shared by other projects, and CLAUDE.local.md is personal, so
+ * neither is edited.
+ */
+async function planClaudeMdLink(agentsMdPath, cwd, detected) {
+    if (detected.importedBy)
+        return { path: detected.importedBy, action: 'unchanged' };
+    if (detected.visibility.visible)
+        return { path: null, action: 'not-needed' };
+    const rootClaudeMd = join(resolve(cwd), 'CLAUDE.md');
+    const dotClaudeMd = join(resolve(cwd), '.claude', 'CLAUDE.md');
+    const files = detected.visibility.claudeMdFiles;
+    const path = files.includes(rootClaudeMd) || !files.includes(dotClaudeMd) ? rootClaudeMd : dotClaudeMd;
+    const line = `@${relative(dirname(path), agentsMdPath).split(sep).join('/')}\n`;
+    const existing = await readExisting(path);
+    if (existing === null)
+        return { path, action: 'create', content: line };
+    const separator = existing.length === 0 ? '' : existing.endsWith('\n') ? '\n' : '\n\n';
+    return { path, action: 'append', content: `${existing}${separator}${line}` };
+}
+async function writeFileAtomically(path, content) {
+    await mkdir(dirname(path), { recursive: true });
+    const tempPath = `${path}.purvey-${process.pid}.tmp`;
+    await writeFile(tempPath, content, 'utf8');
+    await rename(tempPath, path);
+}
+/**
+ * Install the generated instructions. Never touches credentials or the network.
+ * claude and agents write both files of the skill folder; agents-md writes one
+ * block. Identical content is left alone, unedited earlier output is updated,
+ * and anything else needs `force`. For agents-md, also reports whether Claude Code
+ * will load the block, and with `linkClaudeMd` makes sure it does.
+ */
+export async function installAgentSkill(options) {
+    const target = parseTarget(options.target);
+    const scope = parseScope(target, options.scope);
+    if (options.linkClaudeMd && target !== 'agents-md') {
+        throw new PrvrsError('INVALID_ARGUMENT', '--link-claude-md applies only to --target agents-md. Claude Code loads --target claude skills directly.');
+    }
+    const path = resolveSkillInstallPath(target, scope, options);
+    const manifest = options.manifest ?? getCliManifest();
+    const force = Boolean(options.force);
+    const dryRun = Boolean(options.dryRun);
+    if (target !== 'agents-md') {
+        const planned = await planSkillFolder(path, options.version, manifest, force);
+        const files = [];
+        // SKILL.md goes last, so it never points to a workflows.md that failed to write.
+        for (const plan of [...planned].reverse()) {
+            const written = !dryRun && plan.action !== 'unchanged';
+            if (written) {
+                await writeFileAtomically(plan.path, plan.content);
+            }
+            files.unshift({
+                file: plan.file,
+                path: plan.path,
+                action: plan.action,
+                written,
+                bytes: Buffer.byteLength(plan.content, 'utf8'),
+            });
+        }
+        return {
+            target,
+            scope,
+            path,
+            action: summarizeActions(files.map((file) => file.action)),
+            written: files.some((file) => file.written),
+            dryRun,
+            cliVersion: options.version,
+            bytes: files.reduce((total, file) => total + file.bytes, 0),
+            files,
+        };
+    }
+    const plan = planAgentsMd(await readExisting(path), renderAgentsMdBlock(options.version, manifest), path, force);
+    const written = !dryRun && plan.action !== 'unchanged';
+    if (written) {
+        await writeFileAtomically(path, plan.content);
+    }
+    return {
+        target,
+        scope,
+        path,
+        action: plan.action,
+        written,
+        dryRun,
+        cliVersion: options.version,
+        bytes: Buffer.byteLength(plan.content, 'utf8'),
+        claudeCode: await resolveClaudeCode(path, options, dryRun),
+    };
+}
+async function resolveClaudeCode(agentsMdPath, options, dryRun) {
+    const cwd = options.cwd ?? process.cwd();
+    const detected = await detectClaudeCodeVisibility(agentsMdPath, cwd, options.home ?? homedir());
+    if (!options.linkClaudeMd)
+        return detected.visibility;
+    const link = await planClaudeMdLink(agentsMdPath, cwd, detected);
+    if (link.content === undefined) {
+        return {
+            ...detected.visibility,
+            link: { path: link.path, action: link.action, written: false },
+        };
+    }
+    if (!dryRun) {
+        // Write through a symlinked CLAUDE.md rather than replacing the link.
+        await writeFileAtomically(await canonicalPath(link.path), link.content);
+    }
+    return {
+        visible: true,
+        via: 'claude-md-import',
+        reason: `${link.path} ${dryRun ? 'would import' : 'now imports'} AGENTS.md, so Claude Code loads the block.`,
+        claudeMdFiles: detected.visibility.claudeMdFiles,
+        link: { path: link.path, action: link.action, written: !dryRun },
+    };
+}
+//# sourceMappingURL=agent-skill.js.map

package/dist/lib/agent-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-skill.js","sourceRoot":"","sources":["../../src/lib/agent-skill.ts"],"names":[],"mappings":"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"}

package/dist/lib/manifest.d.ts

@@ -118,5 +118,7 @@ export interface CliManifest {
     errorPatterns: CliErrorPatternContract[];
 }
 export declare function getCliManifest(): CliManifest;
+/** Device-approval steps for `purvey auth login --headless`, shared by context text and the agent skill. */
+export declare const HEADLESS_LOGIN_STEPS: readonly ["CLI prints a purveyors.io approval URL", "User opens it in any browser, signs in, and approves access", "CLI completes automatically; nothing is pasted back"];
 export declare function renderContextText(manifest?: CliManifest): string;
 //# sourceMappingURL=manifest.d.ts.map