@hearsay-tools/squawk 0.0.0-stage → 0.17.0-dev.5682

package/dist/skills-provision.js

@@ -0,0 +1,325 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { basename, dirname, isAbsolute, join, resolve } from 'node:path';
+import { excludeFromGit, materializeSkillDir, TEAM_SKILL_AGENT_DIRS } from './skills-remote.js';
+import { fileIdentity, identityOf, LinkRefused, withWorktreeFiles, } from './worktree-manifest.js';
+/**
+ * Provision selected skills, the skills a step's prompt names as `/name`, and heuristically
+ * discovered catalog companions in the run’s own worktree. This is not a promise that every
+ * enabled skill is installed.
+ */
+/** Bound on one closure's companions: a skill that names the whole catalog must not install all
+ *  of it. Roots are never capped: each one is a skill a human selected or named. */
+export const MAX_SKILL_CLOSURE = 24;
+/** A skill name that is safe as one directory name (no separators, never `.`/`..`). */
+export const SAFE_SKILL_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+/**
+ * True when `body` names `name` as a skill: hyphenated names by word, plain names only as `/name`,
+ * `` `name` `` or inside a matched pair of quotes (`"name"`, `'name'`, `“name”`, `‘name’`), which
+ * is how `call the Skill tool with "grilling"` names one (hearsay-tools/cezarion#1480).
+ */
+export function mentionsSkill(body, name) {
+    const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const pattern = name.includes('-')
+        ? `(?<![A-Za-z0-9_.-])${escaped}(?![A-Za-z0-9_-])`
+        : `(?:/${escaped}|\`${escaped}\`|"${escaped}"|'${escaped}'|\u201c${escaped}\u201d|\u2018${escaped}\u2019)(?![A-Za-z0-9_-])`;
+    return new RegExp(pattern).test(body);
+}
+/**
+ * True when a human's `text` names `name` as a typed `/name`, at the start of a word and never
+ * as a path segment (`a/name`, `~/name`, `C:/name`, `/name/a`, `/name.ext`, a URL). Stricter than
+ * `mentionsSkill`: a prompt is prose and paths, where a bare hyphenated word is not a request to
+ * run a skill (hearsay-tools/cezarion#1672).
+ */
+export function namesSkillCommand(text, name) {
+    const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`(?<![A-Za-z0-9_.~:/-])/${escaped}(?![A-Za-z0-9_/-]|\\.[A-Za-z0-9_])`).test(text);
+}
+/**
+ * Every root, then the catalog skills their bodies name, transitively, while the closure holds
+ * fewer than `MAX_SKILL_CLOSURE`. The first catalog entry for a name wins, so a catalog in
+ * precedence order (`discoverSkills`, local first) keeps that order. `truncated` names the first
+ * companion the cap left out; the cap never leaves out a root (hearsay-tools/cezarion#1672).
+ */
+export function skillClosure(roots, catalog) {
+    const byName = new Map();
+    for (const skill of catalog)
+        if (!byName.has(skill.name))
+            byName.set(skill.name, skill);
+    const candidates = [...byName.values()];
+    const skills = [];
+    const seen = new Set();
+    const queue = [...roots];
+    const rootNames = new Set(roots.map((root) => root.name));
+    while (queue.length) {
+        const skill = queue.shift();
+        if (seen.has(skill.name))
+            continue;
+        // Roots lead the queue, so every root is in before the first companion meets the cap.
+        if (skills.length >= MAX_SKILL_CLOSURE && !rootNames.has(skill.name))
+            return { skills, truncated: skill.name };
+        seen.add(skill.name);
+        skills.push(skill);
+        for (const candidate of candidates) {
+            if (!seen.has(candidate.name) && mentionsSkill(skill.body, candidate.name))
+                queue.push(candidate);
+        }
+    }
+    return { skills };
+}
+// ---- installing, ignoring and recording ---------------------------------------------------
+/** First line of the `.gitignore` cezar owns inside a worktree skills dir. */
+export const PROVISION_IGNORE_MARK = '# cezar: skills installed for this task, not part of the repository';
+/** Matches `TEAM_SKILL_MARKER` in skills-remote.ts: it names the team source of a copy. */
+const TEAM_MARKER = '.cezar-team-skill.json';
+/** Thrown inside a pass when `cancelled()` turns true; the pass ends as a best-effort failure. */
+class ProvisionCancelled extends Error {
+}
+function skillMarkdown(skill) {
+    const front = [`name: ${JSON.stringify(skill.name)}`];
+    if (skill.description)
+        front.push(`description: ${JSON.stringify(skill.description)}`);
+    return `---\n${front.join('\n')}\n---\n\n${skill.body.trim()}\n`;
+}
+/** How one skill becomes a worktree entry. A local skill is linked, so its references/ come along. */
+function planFor(skill) {
+    if (skill.source === 'team' && skill.team?.dir)
+        return { how: 'team' };
+    const onDisk = skill.source !== 'team' && skill.source !== 'builtin' && isAbsolute(skill.path);
+    if (onDisk && basename(skill.path) === 'SKILL.md') {
+        const target = dirname(skill.path);
+        return { how: 'link-dir', target, source: `dir:${target}` };
+    }
+    if (onDisk)
+        return { how: 'link-file', target: skill.path, source: `file:${skill.path}` };
+    const text = skillMarkdown(skill);
+    return { how: 'write', text, source: `body:${createHash('sha256').update(text).digest('hex')}` };
+}
+const entryPath = (agentDir, name) => `${agentDir}/skills/${name}`;
+/**
+ * Provision roots and companions only in an owned task worktree, through its manifest
+ * (`worktree-manifest.ts`): replace or remove only cezar's unchanged entries, and reject escaping
+ * destinations. Install ignore rules before entries. On failure retain the system-prompt
+ * fallback; never throw.
+ */
+export function provisionSkills(worktree, roots, catalog, options) {
+    return withWorktreeFiles(worktree, 'skills', options, { installed: [], teamCopies: {} }, (files) => provisionPass(files, roots, catalog, options));
+}
+async function provisionPass(files, roots, catalog, options) {
+    const result = { installed: [], teamCopies: {} };
+    const checkpoint = () => { if (options.cancelled?.())
+        throw new ProvisionCancelled(); };
+    try {
+        checkpoint();
+        const skills = passClosure(files, roots, catalog, result);
+        const pass = { home: options.home, files, installed: new Set(), wanted: new Set(), checkpoint };
+        for (const agentDir of TEAM_SKILL_AGENT_DIRS) {
+            checkpoint();
+            // Ignore first: an entry git could see must never exist, not even for a crash's length.
+            // Only names cezar may write: a recorded entry or a free path, never the user's own skill.
+            const planned = [];
+            for (const skill of skills) {
+                const rel = entryPath(agentDir, skill.name);
+                if (files.entry(rel) || !(await files.present(rel)))
+                    planned.push(skill.name);
+            }
+            await syncIgnore(files, agentDir, [...ownedNames(files, agentDir), ...planned]);
+        }
+        for (const skill of skills) {
+            checkpoint();
+            const plan = planFor(skill);
+            if (plan.how === 'team')
+                result.teamCopies[skill.name] = await placeTeamCopies(pass, skill);
+            else
+                await placeLinkedSkill(pass, skill, plan);
+        }
+        checkpoint();
+        await removeUnwanted(pass);
+        for (const agentDir of TEAM_SKILL_AGENT_DIRS)
+            await syncIgnore(files, agentDir, ownedNames(files, agentDir));
+        result.installed = skills.map((skill) => skill.name).filter((name) => pass.installed.has(name));
+    }
+    catch {
+        // Best effort: the skill body still rides the system prompt.
+    }
+    return result;
+}
+/** Every root this worktree asked for, earlier passes included, and the companions they name. */
+function passClosure(files, roots, catalog, result) {
+    const safeRoots = roots.filter((skill) => SAFE_SKILL_NAME.test(skill.name));
+    const rootNames = [...new Set([...files.roots, ...safeRoots.map((skill) => skill.name)])];
+    const allRoots = rootNames.flatMap((name) => {
+        const found = safeRoots.find((skill) => skill.name === name) ?? catalog.find((skill) => skill.name === name);
+        return found ? [found] : [];
+    });
+    files.roots = allRoots.map((skill) => skill.name);
+    const closure = skillClosure(allRoots, catalog);
+    if (closure.truncated)
+        result.truncated = closure.truncated;
+    return closure.skills.filter((skill) => SAFE_SKILL_NAME.test(skill.name));
+}
+function ownedNames(files, agentDir) {
+    return files.entries()
+        .filter((entry) => entry.kind !== 'ignore-file' && entry.path.startsWith(`${agentDir}/skills/`))
+        .map((entry) => entry.skill ?? '').filter(Boolean);
+}
+/** Keep `names` out of git in `<agentDir>/skills`, through cezar's own `.gitignore` when it may. */
+async function syncIgnore(files, agentDir, names) {
+    const rel = `${agentDir}/skills/.gitignore`;
+    const state = await files.inspect(rel);
+    if (state.owner === 'outside')
+        return;
+    if (state.owner === 'theirs' || state.owner === 'kept') {
+        files.forget(rel);
+        return excludeEach(files, agentDir, names);
+    }
+    const sorted = [...new Set(names)].sort();
+    if (sorted.length === 0) {
+        if (!(await files.remove(rel)))
+            files.forget(rel);
+        return files.save();
+    }
+    const text = [PROVISION_IGNORE_MARK, '/.gitignore', ...sorted.map((name) => `/${name}`)].join('\n') + '\n';
+    if (state.owner === 'ours' && state.entry?.kind === 'ignore-file' && state.current === fileIdentity(text))
+        return;
+    // The agent wrote the ignore file while cezar staged it: it stays theirs, as above.
+    if ((await files.put(rel, { type: 'file', text }, { kind: 'ignore-file' })) === null)
+        await excludeEach(files, agentDir, names);
+}
+async function excludeEach(files, agentDir, names) {
+    for (const name of names)
+        await excludeFromGit(files.worktree, `${agentDir}/skills/${name}`);
+}
+/** The state of `rel` when this pass may write it; null when it must stay as it is. */
+async function claimPath(pass, rel) {
+    const state = await pass.files.inspect(rel);
+    // Not cezar's (tracked, or the user's own), changed since, or out of the worktree: leave it.
+    if (state.owner === 'outside' || state.owner === 'theirs') {
+        pass.files.forget(rel);
+        return null;
+    }
+    pass.wanted.add(rel);
+    // An interrupted entry that no longer matches may be the user's now: left alone, kept out of git.
+    return state.owner === 'kept' ? null : state;
+}
+/** A local, global or built-in skill: a link, a generated `SKILL.md`, or a copy where links fail. */
+async function placeLinkedSkill(pass, skill, plan) {
+    const { files } = pass;
+    // A copy follows its source's content too, not only its path; digested only for a copy.
+    let copyKey;
+    const copySource = () => (copyKey ??= plan.how === 'write'
+        ? Promise.resolve(plan.source)
+        : identityOf(plan.target).then((digest) => `${plan.source}#${digest}`));
+    for (const agentDir of TEAM_SKILL_AGENT_DIRS) {
+        pass.checkpoint();
+        const rel = entryPath(agentDir, skill.name);
+        const state = await claimPath(pass, rel);
+        if (!state)
+            continue;
+        const { entry } = state;
+        if (state.owner === 'ours' && entry && entry.kind !== 'pending' && state.current === entry.identity
+            && entry.source === (entry.kind === 'copy' ? await copySource() : plan.source))
+            continue;
+        if (await placeEntry(files, rel, skill.name, plan, copySource))
+            pass.installed.add(skill.name);
+    }
+}
+/**
+ * Write one entry as `plan` says; a link the platform refuses falls back to a copy. False when the
+ * agent wrote at `rel` meanwhile, so nothing was placed.
+ */
+async function placeEntry(files, rel, skill, plan, copySource) {
+    if (plan.how === 'write') {
+        const generated = { type: 'dir', files: [{ name: 'SKILL.md', text: plan.text }] };
+        return (await files.put(rel, generated, { kind: 'generated', skill, source: plan.source })) !== null;
+    }
+    const linked = plan.how === 'link-dir'
+        ? { type: 'link', target: plan.target, linkType: process.platform === 'win32' ? 'junction' : 'dir' }
+        : { type: 'dir', files: [{ name: 'SKILL.md', linkTo: plan.target }] };
+    try {
+        return (await files.put(rel, linked, { kind: plan.how === 'link-dir' ? 'link' : 'generated', skill, source: plan.source })) !== null;
+    }
+    catch (error) {
+        if (!(error instanceof LinkRefused))
+            throw error;
+        const copied = plan.how === 'link-dir'
+            ? { type: 'copy', from: plan.target }
+            : { type: 'dir', files: [{ name: 'SKILL.md', copyOf: plan.target }] };
+        return (await files.put(rel, copied, { kind: 'copy', skill, source: await copySource() })) !== null;
+    }
+}
+/**
+ * A team directory skill: materialized in a staging dir, then placed in each agent dir whose
+ * path is free or still holds cezar's unchanged copy. A copy the agent changed, or added files
+ * to, stays as it is. Returns the worktree dirs that hold cezar's current copy.
+ */
+async function placeTeamCopies(pass, skill) {
+    const { files } = pass;
+    const staging = await files.stagingDir();
+    const written = new Set(await materializeSkillDir(staging, skill, async () => undefined, pass.home).catch(() => []));
+    const copies = [];
+    for (const agentDir of TEAM_SKILL_AGENT_DIRS) {
+        pass.checkpoint();
+        const rel = entryPath(agentDir, skill.name);
+        const staged = resolve(staging, agentDir, 'skills', skill.name);
+        if (!written.has(staged))
+            continue;
+        const state = await claimPath(pass, rel);
+        if (!state)
+            continue;
+        const identity = await identityOf(staged);
+        const marker = await readFile(join(staged, TEAM_MARKER), 'utf8').catch(() => null);
+        if (identity === null || marker === null)
+            continue;
+        const meta = { kind: 'team-copy', skill: skill.name, source: `team:${JSON.stringify(JSON.parse(marker))}` };
+        if (state.owner === 'ours' && state.current === identity) {
+            if (state.entry?.kind !== 'team-copy')
+                files.record(rel, meta, identity);
+        }
+        else {
+            if ((await files.put(rel, { type: 'staged', path: staged }, meta)) === null)
+                continue;
+            pass.installed.add(skill.name);
+        }
+        copies.push(resolve(files.worktree, rel));
+    }
+    return copies;
+}
+/** Owned entries the closure no longer wants go, while they are still what cezar left. */
+async function removeUnwanted({ files, wanted }) {
+    for (const entry of files.entries()) {
+        if (entry.kind === 'ignore-file' || wanted.has(entry.path))
+            continue;
+        // Changed since an interrupted pass, or not this cezar's to judge: never deleted, still out of git.
+        if ((await files.inspect(entry.path)).owner === 'kept')
+            continue;
+        if (!(await files.remove(entry.path)))
+            files.forget(entry.path);
+    }
+    await files.save();
+}
+/**
+ * Remove every entry `provisionSkills` recorded in `worktree` that still is what cezar left, and
+ * its owned ignore files, then drop its entries and roots from the manifest. A path the user
+ * replaced stays. Never throws. A later skills design calls this before it installs its own view.
+ */
+export function removeProvisionedSkills(worktree) {
+    return withWorktreeFiles(worktree, 'skills', {}, undefined, async (files) => {
+        try {
+            for (const entry of files.entries()) {
+                // Never deleted, and still kept out of git once cezar's ignore file is gone.
+                if ((await files.inspect(entry.path)).owner === 'kept')
+                    await excludeFromGit(files.worktree, `${entry.path}/`);
+                else if (await files.remove(entry.path))
+                    continue;
+                files.forget(entry.path);
+            }
+            files.roots = [];
+            await files.save();
+        }
+        catch {
+            // Best effort.
+        }
+    });
+}
+//# sourceMappingURL=skills-provision.js.map

package/dist/skills-provision.js.map

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

package/dist/skills-remote.d.ts

@@ -0,0 +1,144 @@
+import type { Home } from './home/home.ts';
+import { type SkillsRepoRef } from './config.ts';
+import { type Skill } from './skills.ts';
+import { isSafeSkillsRef, type TeamSourceStatus } from './contract/index.js';
+/**
+ * Normalize accepted shorthand, web, SSH and local skill sources. Reject option-like values,
+ * remote-helper syntax and unsupported schemes before invoking Git; return null on refusal. The
+ * accepted shapes are `skillsRepoKind`'s, the rule the Skills page's Add form also checks.
+ */
+export declare function safeRemoteFor(repo: string): string | null;
+/** A ref safe to pass to `git` as a positional revision (hearsay-tools/cezarion#428); see `isSafeSkillsRef`. */
+export declare const isSafeRef: typeof isSafeSkillsRef;
+/** A full commit SHA (sha-1 or sha-256) — a pinned, immutable ref (#428). */
+export declare function isPinnedSha(ref: string): boolean;
+/** The source's bare clone: `~/.cache/cez/skills/<owner>__<name>`. */
+export declare function bareDirFor(repo: string, home: Home): string;
+/**
+ * Per-commit copies of the source's directory skills for runs without a task
+ * worktree (#1024): `~/.cache/cez/skill-files/<owner>__<name>/<commit>/<skill>/`.
+ */
+export declare function skillFilesCacheDirFor(repo: string, home: Home): string;
+/** Clone the skills repo bare (no checkout) into the global cache, once. */
+export declare function ensureBareClone(repo: string, home: Home): Promise<{
+    bareDir: string;
+    created: boolean;
+}>;
+/** "Refresh" — update every branch head in the bare clone from origin. */
+export declare function fetchAll(bareDir: string): Promise<void>;
+/**
+ * Read one file from the bare clone at the source's ref. Null on any failure.
+ * `atCommit` pins the read to an already-resolved commit, so a caller listing
+ * many files reads them all at the same commit (and skips re-resolving).
+ */
+export declare function readRemoteSkill(src: SkillsRepoRef, path: string, atCommit: string | undefined, home: Home): Promise<string | null>;
+/**
+ * List every skill the repo defines at `src.ref`. Reads from the local bare
+ * clone only — no network. Empty list when the clone doesn't exist yet or
+ * the ref can't be resolved.
+ */
+export declare function listRemoteSkills(src: SkillsRepoRef, home: Home): Promise<Skill[]>;
+/** `path` lands inside `root`, itself a realpath. */
+export declare function landsInside(root: string, path: string): Promise<boolean>;
+/** Where `materializeSkillDir` puts a worktree copy: `<dir>/skills/<name>/`, in this order. */
+export declare const TEAM_SKILL_AGENT_DIRS: readonly ['.claude', '.agents', '.cursor'];
+/**
+ * Copy a directory skill and its companion files into TEAM_SKILL_AGENT_DIRS under `repoRoot`,
+ * excluding destinations from Git. Return only written directories and preserve containment.
+ * Task provisioning (`skills-provision.ts`) passes a staging dir and places each copy itself,
+ * through the worktree's manifest.
+ */
+export declare function materializeSkillDir(repoRoot: string, skill: Skill, 
+/** Keeps one written copy out of git; defaults to the shared `info/exclude`. */
+ignore: ((agentDir: string) => Promise<void>) | undefined, home: Home): Promise<string[]>;
+/**
+ * Materialize directory skill files in the commit-keyed cache for runs without an owned
+ * worktree. Stage then rename complete copies, prune unused old commits and return null on
+ * failure. Never write project files or info/exclude.
+ */
+export declare function materializeSkillToCache(skill: Skill, home: Home): Promise<string | null>;
+/** Append a pattern to git's `info/exclude` (idempotent, non-fatal). */
+export declare function excludeFromGit(repoRoot: string, pattern: string): Promise<void>;
+/** Path of the last-fetch stamp that lives inside a bare clone directory. */
+export declare function lastFetchStampPath(bareDir: string): string;
+/**
+ * Last successful fetch time for this bare clone, or `null` when the stamp is
+ * missing or unreadable. Fail-open: a corrupt stamp is treated as stale.
+ */
+export declare function readLastFetchAt(bareDir: string): number | null;
+/**
+ * Persist a last-fetch time inside `bareDir`. Unique tmp + rename (the same
+ * cross-process write discipline as workspace config). Fail-open on a
+ * read-only cache: listing still works, the next process may fetch again.
+ */
+export declare function writeLastFetchAt(bareDir: string, at: number): Promise<void>;
+/**
+ * Whether a passive (non-`refresh`) load should `git fetch`: yes when there is
+ * no stamp, and yes once the stamp is older than `ttlMs`. Pure so the
+ * freshness policy is unit-tested without git.
+ */
+export declare function shouldPassiveFetch(opts: {
+    fetchedAt: number | null;
+    now: number;
+    ttlMs: number;
+}): boolean;
+/**
+ * A failed clone/fetch is sticky only while the stamp is still missing or
+ * stale. A concurrent sibling that already wrote a fresh stamp must not be
+ * recorded as a local failure — that would suppress the next TTL in this
+ * process (#367 review).
+ */
+export declare function shouldRecordFetchFailure(opts: {
+    fetchedAt: number | null;
+    now: number;
+    ttlMs: number;
+}): boolean;
+/** Test hook: simulate a process-local failed attempt for this source. */
+export declare function __markCloneAttemptedForTests(repo: string, home: Home): void;
+/** Test hook: hold this source's clone/fetch open until `until` settles (#859). */
+export declare function __holdFetchForTests(repo: string, until: Promise<void>, home: Home): void;
+/**
+ * Test hook: park this project's next passive load right after its list-only
+ * pass until `until` settles (#859). Resolves once the load has parked there.
+ */
+export declare function __pauseAfterCachedListForTests(repoRoot: string, until: Promise<void>, home: Home): Promise<void>;
+/**
+ * The current team-skill list for this project, straight from memory: one entry per source and
+ * name, in source order, so one name can appear once per source (see `mergeSourceLists`). The
+ * first call per `repoRoot` kicks off an async background load (clone + list)
+ * and returns immediately — the GUI refetches, so remote skills appear moments
+ * later instead of blocking the first `GET /api/skills`.
+ */
+export declare function getTeamSkillsCached(repoRoot: string, home: Home): Skill[];
+/**
+ * Wait for the same non-refreshing load kicked off by `getTeamSkillsCached`.
+ * The normal catalog read stays immediate; callers use this only for a
+ * background convergence read after they have already rendered local skills.
+ */
+export declare function waitForTeamSkills(repoRoot: string, home: Home): Promise<Skill[]>;
+/**
+ * The first load's list of the bare clones already on disk, published before
+ * any passive fetch (#859). Never waits on the network: no clone yet means an
+ * empty list, not a clone. When a refresh started this project's first load
+ * there is no list-only pass, and this answers with the current list.
+ */
+export declare function waitForCachedTeamSkills(repoRoot: string, home: Home): Promise<Skill[]>;
+/** Refresh: clone missing sources, `git fetch` existing ones, reload the list. */
+export declare function refreshTeamSkills(repoRoot: string, home: Home): Promise<Skill[]>;
+/**
+ * Fetch only the named sources, then reload the list (hearsay-tools/cezarion#279): the Skills page's Add and Retry.
+ * The other sources are listed from their clones as they are, with no fetch.
+ */
+export declare function refreshTeamSources(repoRoot: string, sources: readonly SkillsRepoRef[], home: Home): Promise<Skill[]>;
+/**
+ * Reload the list from the clones on disk with no fetch (hearsay-tools/cezarion#279), after a source was removed,
+ * disabled or enabled, so the change shows at once.
+ */
+export declare function reloadTeamSkills(repoRoot: string, home: Home): Promise<Skill[]>;
+/** A source's identity. Two refs of one repo are two sources. */
+export declare function sourceKey(src: SkillsRepoRef): string;
+/**
+ * Each configured source's state for this project, as the last load left it. A source no load
+ * has reached yet is absent; the caller shows it as `idle`.
+ */
+export declare function getTeamSourceStatuses(repoRoot: string, home: Home): ReadonlyMap<string, TeamSourceStatus>;