@oddkin/analyzer 0.0.0-stage → 1.0.0-beta.1

package/dist/kit/cli.js

@@ -0,0 +1,214 @@
+/**
+ * `oddkin-kit` commands, kept free of a shebang so tests can import them.
+ *
+ *   oddkin-kit [--root <dir>] [--package <name>]... [--out <dir>] [--theme-config <file>] [--check]
+ *   oddkin-kit package [--root <dir>] [--package <name>]... [--check]
+ *   oddkin-kit agents-md [--root <dir>] [--write | --check]
+ *   oddkin-kit llms --base <url> --out <dir> [--root <dir>] [--package <name>]... [--title <text>]
+ *                   [--summary <text>]
+ *
+ * Exit codes: 0 success; 1 a stale, missing, or over-budget kit, or a stale AGENTS.md section;
+ * 2 usage error.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, relative, resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { lineDiff, renderSection, updateAgentsMd } from './agents-md.js';
+import { resolveProjectContext } from './context.js';
+import { checkKit, generateKit, kitDirName, refreshCommand, writeKit } from './kit.js';
+import { siteLlmsText } from './llms.js';
+import { packageKit } from './package-kit.js';
+export const USAGE = `Usage:
+  oddkin-kit [--root <dir>] [--package <name>]... [--out <dir>] [--theme-config <file>] [--check]
+      Write each library's agent kit into <out>/<name>/ (default .oddkin/agent-kit): the
+      workspace's own libraries, or those named with --package. --check reports stale or
+      missing kits instead.
+  oddkin-kit package [--root <dir>] [--package <name>]... [--check]
+      Write the kit each component package ships into <package>/agent/: the workspace's own
+      packages, or those named with --package. --check regenerates each kit and compares it
+      with the files there, installed packages included.
+  oddkin-kit agents-md [--root <dir>] [--write | --check]
+      Show, write, or check the managed section of the workspace's AGENTS.md.
+  oddkin-kit llms --base <url> --out <dir> [--root <dir>] [--package <name>]... [--title <text>] [--summary <text>]
+      Write a documentation site's llms.txt into <dir>: an index of the packages' kits, linked
+      under <url>, and the kit files it links, in <dir>/agent/<name>/.`;
+const COMMANDS = new Set(['package', 'agents-md', 'llms']);
+/** Run one command; resolves with the exit code. */
+export async function main(argv, io) {
+    const [first, ...rest] = argv;
+    const command = first !== undefined && COMMANDS.has(first) ? first : 'kit';
+    const args = command === 'kit' ? [...argv] : rest;
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args,
+            options: {
+                root: { type: 'string', default: '.' },
+                package: { type: 'string', multiple: true },
+                out: { type: 'string', default: '.oddkin/agent-kit' },
+                'theme-config': { type: 'string' },
+                check: { type: 'boolean', default: false },
+                write: { type: 'boolean', default: false },
+                base: { type: 'string' },
+                title: { type: 'string' },
+                summary: { type: 'string' },
+                help: { type: 'boolean', short: 'h', default: false },
+            },
+        }));
+    }
+    catch (error) {
+        io.err(`${error instanceof Error ? error.message : String(error)}\n${USAGE}`);
+        return 2;
+    }
+    if (values.help) {
+        io.out(USAGE);
+        return 0;
+    }
+    let base;
+    if (command === 'llms') {
+        try {
+            base = new URL(values.base ?? '');
+        }
+        catch {
+            base = undefined;
+        }
+        const out = args.some((arg) => arg === '--out' || arg.startsWith('--out='));
+        if (!base || !/^https?:$/.test(base.protocol) || !out) {
+            io.err(`llms needs --base <absolute http(s) URL> and --out <dir>.\n${USAGE}`);
+            return 2;
+        }
+        if (!base.pathname.endsWith('/'))
+            base.pathname += '/';
+    }
+    if (command === 'agents-md') {
+        if (values.write && values.check) {
+            io.err(USAGE);
+            return 2;
+        }
+        return agentsMd(values.root, values.check, values.write, io);
+    }
+    const project = resolveProjectContext(values.root, {
+        ...(values['theme-config'] ? { themeConfig: values['theme-config'] } : {}),
+    });
+    for (const d of project.diagnostics)
+        io.err(`${d.severity} ${d.code}: ${d.message}`);
+    const names = values.package ?? project.libraries.filter((l) => l.owned).map((l) => l.name);
+    if (!names.length) {
+        io.err('No package of this workspace publishes oddkin.metadata.json; name installed ones with --package.');
+        return 1;
+    }
+    for (const name of names)
+        if (!project.libraries.some((l) => l.name === name)) {
+            io.err(`error agent.kit.unknownPackage: ${name} publishes no oddkin.metadata.json here.`);
+            return 1;
+        }
+    if (command === 'llms' && base) {
+        const title = values.title ??
+            JSON.parse(readFileSync(join(project.root, 'package.json'), 'utf8'))
+                .name ??
+            'Agent kits';
+        return llms(project, names, resolve(values.root, values.out), base, title, values.summary, io);
+    }
+    return command === 'package'
+        ? packaged(project, names, values.check, io)
+        : kits(project, names, values.root, values.out, values.check, io);
+}
+async function llms(project, names, out, base, title, summary, io) {
+    const site = [];
+    for (const name of names) {
+        const library = project.libraries.find((l) => l.name === name);
+        const { files, manifest } = await packageKit(project, library);
+        const path = `agent/${kitDirName(name)}/`;
+        writeKit(join(out, path), files);
+        site.push({ library, manifest, url: new URL(path, base).href });
+    }
+    mkdirSync(out, { recursive: true });
+    writeFileSync(join(out, 'llms.txt'), siteLlmsText({ title, ...(summary ? { summary } : {}), kits: site }));
+    io.out(`llms.txt and ${site.length} kits in ${out}, linked under ${base.href}`);
+    return 0;
+}
+function kits(project, names, root, out, check, io) {
+    let failed = false;
+    for (const name of names) {
+        const dir = resolve(root, out, kitDirName(name));
+        if (check) {
+            const { status, changed } = checkKit(dir, project, name);
+            if (status === 'current')
+                io.out(`${name}: current (${dir})`);
+            else {
+                failed = true;
+                io.err(`${status === 'stale' ? 'error agent.kit.stale' : 'error agent.kit.missing'}: ${name} at ${dir}${changed.length ? `\n  ${changed.join('\n  ')}` : ''}\n  → ${refreshCommand(name, out)}`);
+            }
+            continue;
+        }
+        const { files, manifest } = generateKit(project, name);
+        writeKit(dir, files);
+        io.out(`${name}: ${files.size} files in ${dir}; GUIDE.md ${manifest.guide.bytes} of ${manifest.guide.budgetBytes} bytes`);
+        if (manifest.guide.bytes > manifest.guide.budgetBytes) {
+            failed = true;
+            io.err(`error agent.kit.guideBudget: ${name}'s GUIDE.md exceeds its budget.`);
+        }
+    }
+    return failed ? 1 : 0;
+}
+async function packaged(project, names, check, io) {
+    let failed = false;
+    for (const name of names) {
+        const library = project.libraries.find((l) => l.name === name);
+        const { dir, files, manifest } = await packageKit(project, library);
+        const where = relative(project.root, dir).split('\\').join('/');
+        if (manifest.guide.bytes > manifest.guide.budgetBytes) {
+            failed = true;
+            io.err(`error agent.kit.guideBudget: ${name}'s GUIDE.md exceeds its budget.`);
+        }
+        if (check) {
+            const stale = [...files].filter(([path, text]) => !existsSync(join(dir, path)) || readFileSync(join(dir, path), 'utf8') !== text);
+            if (!stale.length) {
+                io.out(`${name}: current (${where})`);
+                continue;
+            }
+            failed = true;
+            const shipped = existsSync(join(dir, 'kit.json'))
+                ? JSON.parse(readFileSync(join(dir, 'kit.json'), 'utf8'))
+                : undefined;
+            const generator = shipped?.fingerprint?.generator?.version;
+            io.err(`error agent.kit.stale: ${where} (${stale.length} of ${files.size} files differ: ${stale
+                .slice(0, 5)
+                .map(([path]) => path)
+                .join(', ')}${stale.length > 5 ? ', …' : ''})${generator && generator !== manifest.fingerprint.generator.version
+                ? `\n  generated by ${generator}; this is ${manifest.fingerprint.generator.version}`
+                : ''}${library.owned ? '\n  → oddkin-kit package' : ''}`);
+            continue;
+        }
+        if (!library.owned) {
+            failed = true;
+            io.err(`error agent.kit.installed: ${name} is installed, not part of this workspace; its kit ships with it (use --check).`);
+            continue;
+        }
+        writeKit(dir, files);
+        io.out(`${name}: ${files.size} files in ${where}; GUIDE.md ${manifest.guide.bytes} of ${manifest.guide.budgetBytes} bytes`);
+    }
+    return failed ? 1 : 0;
+}
+function agentsMd(root, check, write, io) {
+    const file = join(resolve(root), 'AGENTS.md');
+    const before = existsSync(file) ? readFileSync(file, 'utf8') : '';
+    const after = updateAgentsMd(before, renderSection(resolveProjectContext(root)));
+    if (after === before) {
+        io.out('AGENTS.md: managed section current.');
+        return 0;
+    }
+    io.out(`AGENTS.md${before ? '' : ' (new file)'}:\n${lineDiff(before, after).join('\n')}`);
+    if (check) {
+        io.err('error agent.agentsMd.stale: run oddkin-kit agents-md --write');
+        return 1;
+    }
+    if (write) {
+        writeFileSync(file, after);
+        io.out('AGENTS.md written.');
+    }
+    else
+        io.out('Dry run: add --write to apply.');
+    return 0;
+}
+//# sourceMappingURL=cli.js.map

package/dist/kit/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/kit/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAgB,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACvF,OAAO,EAAE,YAAY,EAAgB,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;uEAakD,CAAC;AAOxE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AAE3D,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAuB,EAAE,EAAM;IACxD,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3E,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;YACtB,IAAI;YACJ,OAAO,EAAE;gBACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;gBACtC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC3C,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,EAAE;gBACrD,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAClC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;gBAC1C,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;gBAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;aACtD;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;QAC9E,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACd,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAqB,CAAC;IAC1B,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,OAAO,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACtD,EAAE,CAAC,GAAG,CAAC,8DAA8D,KAAK,EAAE,CAAC,CAAC;YAC9E,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC;IACzD,CAAC;IACD,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACd,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,OAAO,GAAG,qBAAqB,CAAC,MAAM,CAAC,IAAI,EAAE;QACjD,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAC,CAAC;IACH,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,WAAW;QAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACrF,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5F,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,EAAE,CAAC,GAAG,CACJ,kGAAkG,CACnG,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK;QACtB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACpD,EAAE,CAAC,GAAG,CAAC,mCAAmC,IAAI,0CAA0C,CAAC,CAAC;YAC1F,OAAO,CAAC,CAAC;QACX,CAAC;IACH,IAAI,OAAO,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,KAAK,GACT,MAAM,CAAC,KAAK;YACX,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAuB;iBACxF,IAAI;YACP,YAAY,CAAC;QACf,OAAO,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,OAAO,KAAK,SAAS;QAC1B,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5C,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,KAAK,UAAU,IAAI,CACjB,OAAgB,EAChB,KAAe,EACf,GAAW,EACX,IAAS,EACT,KAAa,EACb,OAA2B,EAC3B,EAAM;IAEN,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAE,CAAC;QAChE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,SAAS,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,aAAa,CACX,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EACrB,YAAY,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CACrE,CAAC;IACF,EAAE,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,MAAM,YAAY,GAAG,kBAAkB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAChF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,IAAI,CACX,OAAgB,EAChB,KAAe,EACf,IAAY,EACZ,GAAW,EACX,KAAc,EACd,EAAM;IAEN,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YACzD,IAAI,MAAM,KAAK,SAAS;gBAAE,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,cAAc,GAAG,GAAG,CAAC,CAAC;iBACzD,CAAC;gBACJ,MAAM,GAAG,IAAI,CAAC;gBACd,EAAE,CAAC,GAAG,CACJ,GAAG,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,yBAAyB,KAAK,IAAI,OAAO,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CACzL,CAAC;YACJ,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACvD,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrB,EAAE,CAAC,GAAG,CACJ,GAAG,IAAI,KAAK,KAAK,CAAC,IAAI,aAAa,GAAG,cAAc,QAAQ,CAAC,KAAK,CAAC,KAAK,OAAO,QAAQ,CAAC,KAAK,CAAC,WAAW,QAAQ,CAClH,CAAC;QACF,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACtD,MAAM,GAAG,IAAI,CAAC;YACd,EAAE,CAAC,GAAG,CAAC,gCAAgC,IAAI,iCAAiC,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,OAAgB,EAChB,KAAe,EACf,KAAc,EACd,EAAM;IAEN,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAE,CAAC;QAChE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChE,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACtD,MAAM,GAAG,IAAI,CAAC;YACd,EAAE,CAAC,GAAG,CAAC,gCAAgC,IAAI,iCAAiC,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAC7B,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CACf,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,CACjF,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAClB,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,cAAc,KAAK,GAAG,CAAC,CAAC;gBACtC,SAAS;YACX,CAAC;YACD,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;gBAC/C,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAErD;gBACJ,CAAC,CAAC,SAAS,CAAC;YACd,MAAM,SAAS,GAAG,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC;YAC3D,EAAE,CAAC,GAAG,CACJ,0BAA0B,KAAK,KAAK,KAAK,CAAC,MAAM,OAAO,KAAK,CAAC,IAAI,kBAAkB,KAAK;iBACrF,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC;iBACrB,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAC3C,SAAS,IAAI,SAAS,KAAK,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO;gBAC/D,CAAC,CAAC,oBAAoB,SAAS,aAAa,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE;gBACpF,CAAC,CAAC,EACN,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,EAAE,EAAE,CACrD,CAAC;YACF,SAAS;QACX,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,GAAG,IAAI,CAAC;YACd,EAAE,CAAC,GAAG,CACJ,8BAA8B,IAAI,iFAAiF,CACpH,CAAC;YACF,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrB,EAAE,CAAC,GAAG,CACJ,GAAG,IAAI,KAAK,KAAK,CAAC,IAAI,aAAa,KAAK,cAAc,QAAQ,CAAC,KAAK,CAAC,KAAK,OAAO,QAAQ,CAAC,KAAK,CAAC,WAAW,QAAQ,CACpH,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAc,EAAE,KAAc,EAAE,EAAM;IACpE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjF,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,EAAE,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QAC9C,OAAO,CAAC,CAAC;IACX,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,MAAM,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1F,IAAI,KAAK,EAAE,CAAC;QACV,EAAE,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;QACvE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,KAAK,EAAE,CAAC;QACV,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3B,EAAE,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC/B,CAAC;;QAAM,EAAE,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAChD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/kit/context.d.ts

@@ -0,0 +1,104 @@
+export declare const CONTEXT_SCHEMA = "https://oddkin.dev/schemas/project-context/v1.json";
+/**
+ * The generator: this package and a hash of the kit modules themselves, so a generator change
+ * makes kits stale. The built modules are the same bytes in the workspace that builds the package
+ * and in every project that installs it.
+ */
+export declare const GENERATOR: {
+    readonly name: string;
+    readonly version: string;
+};
+export interface Fingerprint {
+    generator: {
+        name: string;
+        version: string;
+    };
+    schemaVersion: number;
+    packages?: Record<string, string>;
+    inputs: string;
+}
+export interface ProjectContext {
+    schema: string;
+    packages: Array<{
+        name: string;
+        version: string;
+        peerRanges?: Record<string, string>;
+        exports?: string[];
+        registrations?: Record<string, string>;
+        metadata?: string;
+    }>;
+    components?: Array<{
+        tag: string;
+        source: string;
+        extends?: string;
+        dependencies?: string[];
+    }>;
+    theme?: {
+        config?: string;
+        themes?: string[];
+        modes?: string[];
+        densities?: string[];
+        profiles?: string[];
+        products?: string[];
+    };
+    recipes: string[];
+    stylesheets: string[];
+    examples: string[];
+    conventions: {
+        componentLayout: 'folders' | 'colocated' | 'mixed' | 'unknown';
+    };
+    commands: Record<string, string>;
+    capabilityPaths: Array<'core-authoring' | 'tokens-only' | 'components-without-state' | 'application-services'>;
+    fingerprint: Fingerprint;
+    freshness: 'current' | 'stale' | 'unknown';
+}
+export interface Library {
+    name: string;
+    version: string;
+    dir: string;
+    manifest: Record<string, any>;
+    metadata: Record<string, any>;
+    cem?: Record<string, any>;
+    owned: boolean;
+}
+export interface ContextDiagnostic {
+    code: string;
+    severity: 'error' | 'warning';
+    message: string;
+}
+/** Where a theme's token inspection comes from: a package export. */
+export interface InspectionSource {
+    package: string;
+    export: string;
+}
+export interface Project {
+    root: string;
+    context: ProjectContext;
+    diagnostics: ContextDiagnostic[];
+    /** Input path (relative to the root) → SHA-256 of its content. */
+    inputs: Map<string, string>;
+    libraries: Library[];
+    inspection?: {
+        file: string;
+        data: Record<string, any>;
+        source?: InspectionSource;
+    };
+    workspace: Array<{
+        name: string;
+        dir: string;
+    }>;
+}
+/** The file a package exports at `subpath` (development build first, as the analyzer reads). */
+export declare function exportTarget(manifest: Record<string, any>, subpath: string): string | undefined;
+/**
+ * Resolve a workspace's project context (project-context.v1). `options.themeConfig` names the
+ * theme configuration file; the token inspection is the one the libraries' foundations
+ * reference, or `options.inspection`.
+ */
+export declare function resolveProjectContext(rootDir: string, options?: {
+    themeConfig?: string;
+    inspection?: string;
+}): Project;
+/** `sha256-…` over every input's path and content hash, in path order. */
+export declare function inputsHash(inputs: Map<string, string>): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/kit/context.d.ts.map

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

package/dist/kit/context.js

@@ -0,0 +1,323 @@
+/**
+ * Agent kits, the project context (agent-tooling.md §4): what a workspace actually installs and
+ * publishes, read from package manifests, published metadata, token inspection, and example files
+ * only. Nothing is executed or inferred from names; unknown stays absent.
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readdirSync, readFileSync, realpathSync } from 'node:fs';
+import { dirname, extname, join, relative, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+export const CONTEXT_SCHEMA = 'https://oddkin.dev/schemas/project-context/v1.json';
+const sha256 = (text) => createHash('sha256').update(text).digest('hex');
+const posix = (path) => path.split(sep).join('/');
+const here = dirname(fileURLToPath(import.meta.url));
+/**
+ * The generator: this package and a hash of the kit modules themselves, so a generator change
+ * makes kits stale. The built modules are the same bytes in the workspace that builds the package
+ * and in every project that installs it.
+ */
+export const GENERATOR = (() => {
+    const manifest = JSON.parse(readFileSync(join(here, '..', '..', 'package.json'), 'utf8'));
+    const own = extname(fileURLToPath(import.meta.url));
+    const sources = readdirSync(here)
+        .filter((file) => extname(file) === own && !file.endsWith(`.d${own}`))
+        .sort()
+        .map((file) => `${file}\0${sha256(readFileSync(join(here, file)))}`)
+        .join('\n');
+    return {
+        name: `${manifest.name}/kit`,
+        version: `${manifest.version}+${sha256(sources).slice(0, 12)}`,
+    };
+})();
+const COMMANDS = [
+    ['build', ['build']],
+    ['typecheck', ['typecheck']],
+    ['test', ['test']],
+    ['browser', ['test:browser']],
+    ['e2e', ['test:e2e', 'e2e']],
+    ['lint', ['lint']],
+    ['verify', ['verify']],
+    ['metadata', ['verify:metadata', 'metadata']],
+];
+/** The file a package exports at `subpath` (development build first, as the analyzer reads). */
+export function exportTarget(manifest, subpath) {
+    const target = manifest['exports']?.[subpath];
+    const file = typeof target === 'string'
+        ? target
+        : (target?.development ?? target?.import ?? target?.default ?? undefined);
+    return typeof file === 'string' ? file.replace(/^\.\//, '') : undefined;
+}
+/** Node's lookup of an installed package from `from`, through symlinks. */
+function findPackage(name, from) {
+    for (let dir = from;; dir = dirname(dir)) {
+        const candidate = join(dir, 'node_modules', ...name.split('/'), 'package.json');
+        if (existsSync(candidate))
+            return dirname(realpathSync(candidate));
+        if (dirname(dir) === dir)
+            return undefined;
+    }
+}
+function workspaceDirs(root, manifest, diagnostics) {
+    const workspaces = manifest['workspaces'];
+    const patterns = Array.isArray(workspaces) ? workspaces : (workspaces?.packages ?? []);
+    const dirs = [];
+    for (const pattern of patterns) {
+        if (/^[^*]+\/\*$/.test(pattern)) {
+            const base = join(root, pattern.slice(0, -2));
+            if (!existsSync(base))
+                continue;
+            for (const name of readdirSync(base).sort())
+                if (existsSync(join(base, name, 'package.json')))
+                    dirs.push(join(base, name));
+        }
+        else if (!pattern.includes('*')) {
+            if (existsSync(join(root, pattern, 'package.json')))
+                dirs.push(join(root, pattern));
+        }
+        else
+            diagnostics.push({
+                code: 'agent.context.workspacePattern',
+                severity: 'warning',
+                message: `Workspace pattern "${pattern}" is not read (only "dir" and "dir/*"); its packages are missing from the context.`,
+            });
+    }
+    return dirs;
+}
+/** The authored source of a built module, from its source map; the module itself without one. */
+function sourceOf(packageDir, module) {
+    const built = join(packageDir, module);
+    const map = `${built}.map`;
+    if (existsSync(map)) {
+        const { sources, sourceRoot = '' } = JSON.parse(readFileSync(map, 'utf8'));
+        if (sources?.length === 1)
+            return resolve(dirname(built), sourceRoot, sources[0]);
+    }
+    return built;
+}
+/** `folders` when a component's template is its own module beside the class, as compose() needs. */
+function layoutOf(component) {
+    const template = component.definition?.template?.module;
+    if (!template || component.definition.template.package)
+        return 'colocated';
+    return template !== component.cem.module && dirname(template) === dirname(component.cem.module)
+        ? 'folders'
+        : 'colocated';
+}
+const themeAxes = (inspection) => {
+    const values = (attribute) => [
+        ...new Set(inspection['scopes']
+            .map((s) => new RegExp(`\\[data-odd-${attribute}~?="([^"]+)"\\]`).exec(s.selector)?.[1])
+            .filter((value) => Boolean(value))),
+    ].sort();
+    return {
+        themes: [...new Set([inspection['theme'], ...values('theme')])].sort(),
+        modes: [...inspection['modes']],
+        densities: values('density'),
+        profiles: values('profile'),
+        products: values('product'),
+    };
+};
+/**
+ * Resolve a workspace's project context (project-context.v1). `options.themeConfig` names the
+ * theme configuration file; the token inspection is the one the libraries' foundations
+ * reference, or `options.inspection`.
+ */
+export function resolveProjectContext(rootDir, options = {}) {
+    const root = resolve(rootDir);
+    const rel = (file) => posix(relative(root, file));
+    const inputs = new Map();
+    const diagnostics = [];
+    const readInput = (file) => {
+        const text = readFileSync(file, 'utf8');
+        inputs.set(rel(file), sha256(text));
+        return text;
+    };
+    const readJson = (file) => JSON.parse(readInput(file));
+    const rootManifest = readJson(join(root, 'package.json'));
+    const installed = new Map();
+    for (const dir of workspaceDirs(root, rootManifest, diagnostics)) {
+        const manifest = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+        installed.set(manifest.name, { dir, manifest, owned: true });
+    }
+    const declared = (manifest) => [
+        ...Object.keys(manifest['dependencies'] ?? {}),
+        ...Object.keys(manifest['devDependencies'] ?? {}),
+        ...Object.keys(manifest['peerDependencies'] ?? {}),
+    ];
+    const wanted = new Set([rootManifest, ...[...installed.values()].map((p) => p.manifest)].flatMap(declared));
+    for (const name of [...wanted].sort()) {
+        if (installed.has(name))
+            continue;
+        const dir = findPackage(name, root);
+        if (!dir) {
+            if (name.startsWith('@oddkin/'))
+                diagnostics.push({
+                    code: 'agent.context.notInstalled',
+                    severity: 'warning',
+                    message: `${name} is declared but not installed; run the package manager's install.`,
+                });
+            continue;
+        }
+        const manifest = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+        installed.set(name, { dir, manifest, owned: false });
+    }
+    const packages = [];
+    const libraries = [];
+    for (const [name, { dir, manifest, owned }] of [...installed].sort(([a], [b]) => a < b ? -1 : 1)) {
+        if (!manifest['exports'] || !(name.startsWith('@oddkin/') || manifest['customElements']))
+            continue;
+        readInput(join(dir, 'package.json'));
+        const record = {
+            name,
+            version: manifest['version'] ?? '0.0.0',
+        };
+        if (manifest['peerDependencies'])
+            record.peerRanges = { ...manifest['peerDependencies'] };
+        record.exports = Object.keys(manifest['exports'])
+            .filter((subpath) => subpath !== './package.json')
+            .map((subpath) => (subpath === '.' ? name : `${name}${subpath.slice(1)}`));
+        const metadataFile = exportTarget(manifest, './oddkin.metadata.json');
+        if (metadataFile && existsSync(join(dir, metadataFile))) {
+            const metadata = readJson(join(dir, metadataFile));
+            const cemFile = manifest['customElements']?.replace(/^\.\//, '');
+            const cem = cemFile && existsSync(join(dir, cemFile)) ? readJson(join(dir, cemFile)) : undefined;
+            record.registrations = Object.fromEntries(Object.values(metadata['components'] ?? {}).map((c) => [c.tag, c.registration]));
+            record.metadata = rel(join(dir, metadataFile));
+            for (const example of Object.values(metadata['examples'] ?? {}))
+                if (existsSync(join(dir, example.file)))
+                    readInput(join(dir, example.file));
+            libraries.push({
+                name,
+                version: record.version,
+                dir,
+                manifest,
+                metadata,
+                ...(cem ? { cem } : {}),
+                owned,
+            });
+        }
+        packages.push(record);
+    }
+    const components = libraries
+        .filter((library) => library.owned)
+        .flatMap((library) => Object.values(library.metadata['components'] ?? {}).map((c) => ({
+        tag: c.tag,
+        source: rel(sourceOf(library.dir, c.definition?.ref?.module ?? c.cem.module)),
+        ...(c.definition?.extends ? { extends: c.definition.extends } : {}),
+        ...(c.definition?.dependencies
+            ? {
+                dependencies: [...new Set(Object.values(c.definition.dependencies))].sort(),
+            }
+            : {}),
+    })))
+        .sort((a, b) => (a.tag < b.tag ? -1 : 1));
+    // The token inspection the libraries' foundations were generated from.
+    const sources = [
+        ...new Set(libraries.flatMap((l) => Object.values(l.metadata['foundations'] ?? {}).map((f) => JSON.stringify(f.generation?.value?.source ?? null)))),
+    ]
+        .map((s) => JSON.parse(s))
+        .filter((s) => Boolean(s));
+    const first = sources[0];
+    if (sources.length > 1 && first)
+        diagnostics.push({
+            code: 'agent.context.themes',
+            severity: 'warning',
+            message: `Foundations reference ${sources.length} token inspections; the first (${first.package} ${first.export}) describes the theme.`,
+        });
+    const inspectionFile = options.inspection ??
+        (first &&
+            (() => {
+                const owner = installed.get(first.package);
+                const dir = owner?.dir ?? findPackage(first.package, root);
+                const manifest = dir && JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+                const file = manifest && exportTarget(manifest, first.export);
+                return dir && file ? join(dir, file) : undefined;
+            })());
+    let inspection;
+    if (inspectionFile && existsSync(inspectionFile))
+        inspection = {
+            file: inspectionFile,
+            data: readJson(inspectionFile),
+            ...(first && !options.inspection ? { source: first } : {}),
+        };
+    if (options.themeConfig)
+        readInput(resolve(root, options.themeConfig));
+    for (const name of readdirSync(root).filter((f) => /^oddkin\.docs\.(ts|mts|js|mjs|json)$/.test(f)))
+        readInput(join(root, name));
+    const scripts = rootManifest['scripts'] ?? {};
+    const commands = Object.fromEntries(COMMANDS.flatMap(([key, names]) => {
+        const script = names.find((n) => scripts[n]);
+        return script ? [[key, script === 'test' ? 'npm test' : `npm run ${script}`]] : [];
+    }));
+    const names = new Set(packages.map((p) => p.name));
+    const hasServices = names.has('@oddkin/state') || names.has('@oddkin/app');
+    const hasComponents = libraries.length > 0;
+    const capabilityPaths = [
+        ...(hasServices ? ['application-services'] : []),
+        ...(hasComponents && !hasServices ? ['components-without-state'] : []),
+        ...(components.length ? ['core-authoring'] : []),
+        ...(names.has('@oddkin/tokens') && !hasComponents && !components.length
+            ? ['tokens-only']
+            : []),
+    ].sort();
+    const layouts = new Set(libraries
+        .filter((l) => l.owned)
+        .flatMap((l) => Object.values(l.metadata['components'] ?? {}).map(layoutOf)));
+    const fingerprint = {
+        generator: { ...GENERATOR },
+        schemaVersion: 1,
+        packages: Object.fromEntries(packages.map((p) => [p.name, p.version])),
+        inputs: inputsHash(inputs),
+    };
+    const context = {
+        schema: CONTEXT_SCHEMA,
+        packages,
+        ...(components.length ? { components } : {}),
+        ...(inspection || options.themeConfig
+            ? {
+                theme: {
+                    ...(options.themeConfig ? { config: rel(resolve(root, options.themeConfig)) } : {}),
+                    ...(inspection ? themeAxes(inspection.data) : {}),
+                },
+            }
+            : {}),
+        recipes: [
+            ...new Set(libraries.flatMap((l) => Object.keys(l.metadata['recipes'] ?? {}))),
+        ].sort(),
+        stylesheets: [
+            ...new Set(libraries.flatMap((l) => Object.keys(l.metadata['stylesheets'] ?? {}))),
+        ].sort(),
+        examples: libraries
+            .flatMap((l) => Object.entries(l.metadata['examples'] ?? {})
+            .filter(([, e]) => !e.incorrect)
+            .map(([id]) => id))
+            .sort(),
+        conventions: {
+            componentLayout: layouts.size === 0 ? 'unknown' : layouts.size > 1 ? 'mixed' : [...layouts][0],
+        },
+        commands,
+        capabilityPaths,
+        fingerprint,
+        freshness: 'current',
+    };
+    return {
+        root,
+        context,
+        diagnostics,
+        inputs,
+        libraries,
+        ...(inspection ? { inspection } : {}),
+        workspace: [...installed]
+            .filter(([, p]) => p.owned)
+            .map(([name, p]) => ({ name, dir: rel(p.dir) }))
+            .sort((a, b) => (a.dir < b.dir ? -1 : 1)),
+    };
+}
+/** `sha256-…` over every input's path and content hash, in path order. */
+export function inputsHash(inputs) {
+    return `sha256-${sha256([...inputs]
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+        .map(([path, hash]) => `${path}\0${hash}`)
+        .join('\n'))}`;
+}
+//# sourceMappingURL=context.js.map