@astrofoundry/pi-astro 0.17.1 → 0.18.1

package/extensions/astro-agents-loader/index.test.ts

@@ -1,102 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { createAstroAgentsLoader } from "./index.ts";
-
-type SessionStartHandler = (event: unknown, ctx: unknown) => Promise<void>;
-
-interface Notification {
-    message: string;
-    level: "info" | "warning" | "error";
-}
-
-let tempRoot: string;
-let sourceDir: string;
-let targetDir: string;
-
-beforeEach(() => {
-    tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), "astro-agents-loader-idx-"));
-    sourceDir = path.join(tempRoot, "source");
-    targetDir = path.join(tempRoot, "target");
-    fs.mkdirSync(sourceDir, { recursive: true });
-});
-
-afterEach(() => {
-    fs.rmSync(tempRoot, { recursive: true, force: true });
-});
-
-function setupExtension(): {
-    handlers: Record<string, SessionStartHandler>;
-    notifications: Notification[];
-} {
-    const handlers: Record<string, SessionStartHandler> = {};
-    const notifications: Notification[] = [];
-    const fakePi = {
-        on(event: string, handler: SessionStartHandler) {
-            handlers[event] = handler;
-        },
-    };
-    const extension = createAstroAgentsLoader({ sourceDir, targetDir, namespace: "astro" });
-    extension(fakePi as unknown as Parameters<typeof extension>[0]);
-    return { handlers, notifications };
-}
-
-function makeCtx(notifications: Notification[]): unknown {
-    return {
-        ui: {
-            notify(message: string, level: Notification["level"]) {
-                notifications.push({ message, level });
-            },
-        },
-    };
-}
-
-describe("createAstroAgentsLoader", () => {
-    it("registers a session_start handler that syncs and reports counts", async () => {
-        fs.writeFileSync(path.join(sourceDir, "a.md"), "alpha", "utf8");
-
-        const { handlers, notifications } = setupExtension();
-        expect(handlers.session_start).toBeTypeOf("function");
-
-        await handlers.session_start!({}, makeCtx(notifications));
-
-        expect(fs.readFileSync(path.join(targetDir, "astro.a.md"), "utf8")).toBe("alpha");
-        const info = notifications.find((n) => n.level === "info");
-        expect(info?.message).toContain("synced 1 agent");
-    });
-
-    it("emits no notification when nothing changes on a subsequent run", async () => {
-        fs.writeFileSync(path.join(sourceDir, "a.md"), "alpha", "utf8");
-        const { handlers, notifications } = setupExtension();
-
-        await handlers.session_start!({}, makeCtx(notifications));
-        notifications.length = 0;
-        await handlers.session_start!({}, makeCtx(notifications));
-
-        expect(notifications).toEqual([]);
-    });
-
-    it("notifies error level when sync throws", async () => {
-        fs.writeFileSync(targetDir, "not-a-directory", "utf8");
-        fs.writeFileSync(path.join(sourceDir, "a.md"), "alpha", "utf8");
-
-        const { handlers, notifications } = setupExtension();
-        await handlers.session_start!({}, makeCtx(notifications));
-
-        const error = notifications.find((n) => n.level === "error");
-        expect(error).toBeDefined();
-        expect(error?.message).toContain("sync failed");
-    });
-
-    it("forwards onWarn from sync to ctx.ui.notify as warning", async () => {
-        fs.mkdirSync(path.join(targetDir, "astro.a.md"), { recursive: true });
-        fs.writeFileSync(path.join(sourceDir, "a.md"), "alpha", "utf8");
-
-        const { handlers, notifications } = setupExtension();
-        await handlers.session_start!({}, makeCtx(notifications));
-
-        const warning = notifications.find((n) => n.level === "warning");
-        expect(warning?.message).toContain("not a regular file");
-    });
-});

package/extensions/astro-agents-loader/index.ts

@@ -1,48 +0,0 @@
-import * as os from "node:os";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { syncBundledAgents } from "./sync.ts";
-
-const DEFAULT_NAMESPACE = "astro";
-const extensionDir = path.dirname(fileURLToPath(import.meta.url));
-const defaultSourceDir = path.resolve(extensionDir, "..", "..", "agents");
-const defaultTargetDir = path.join(os.homedir(), ".pi", "agent", "agents");
-
-export interface AstroAgentsLoaderOptions {
-    sourceDir?: string;
-    targetDir?: string;
-    namespace?: string;
-}
-
-export function createAstroAgentsLoader(
-    options: AstroAgentsLoaderOptions = {},
-): (pi: ExtensionAPI) => void {
-    const sourceDir = options.sourceDir ?? defaultSourceDir;
-    const targetDir = options.targetDir ?? defaultTargetDir;
-    const namespace = options.namespace ?? DEFAULT_NAMESPACE;
-
-    return function astroAgentsLoaderExtension(pi: ExtensionAPI): void {
-        pi.on("session_start", async (_event, ctx: ExtensionContext) => {
-            try {
-                const result = syncBundledAgents({
-                    sourceDir,
-                    targetDir,
-                    namespace,
-                    onWarn: (message) => ctx.ui.notify(message, "warning"),
-                });
-                if (result.written.length > 0 || result.pruned.length > 0) {
-                    ctx.ui.notify(
-                        `astro-agents-loader: synced ${result.written.length} agent(s), pruned ${result.pruned.length}.`,
-                        "info",
-                    );
-                }
-            } catch (error) {
-                const message = error instanceof Error ? error.message : String(error);
-                ctx.ui.notify(`astro-agents-loader: sync failed (${message})`, "error");
-            }
-        });
-    };
-}
-
-export default createAstroAgentsLoader();

package/extensions/astro-agents-loader/sync.test.ts

@@ -1,111 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { syncBundledAgents } from "./sync.ts";
-
-let tempRoot: string;
-let sourceDir: string;
-let targetDir: string;
-
-beforeEach(() => {
-    tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), "astro-agents-loader-"));
-    sourceDir = path.join(tempRoot, "source");
-    targetDir = path.join(tempRoot, "target");
-    fs.mkdirSync(sourceDir, { recursive: true });
-});
-
-afterEach(() => {
-    fs.rmSync(tempRoot, { recursive: true, force: true });
-});
-
-function writeSource(name: string, content: string): void {
-    fs.writeFileSync(path.join(sourceDir, name), content, "utf8");
-}
-
-describe("syncBundledAgents", () => {
-    it("creates the target directory and writes namespaced copies", () => {
-        writeSource("a.md", "alpha");
-        writeSource("b.md", "beta");
-
-        const result = syncBundledAgents({ sourceDir, targetDir, namespace: "astro" });
-
-        expect(result.written.sort()).toEqual(["astro.a.md", "astro.b.md"]);
-        expect(result.pruned).toEqual([]);
-        expect(result.skipped).toEqual([]);
-        expect(fs.readFileSync(path.join(targetDir, "astro.a.md"), "utf8")).toBe("alpha");
-        expect(fs.readFileSync(path.join(targetDir, "astro.b.md"), "utf8")).toBe("beta");
-    });
-
-    it("is idempotent when content is unchanged", () => {
-        writeSource("a.md", "alpha");
-        syncBundledAgents({ sourceDir, targetDir, namespace: "astro" });
-
-        const result = syncBundledAgents({ sourceDir, targetDir, namespace: "astro" });
-
-        expect(result.written).toEqual([]);
-        expect(result.pruned).toEqual([]);
-    });
-
-    it("rewrites a managed file when source content changes", () => {
-        writeSource("a.md", "alpha");
-        syncBundledAgents({ sourceDir, targetDir, namespace: "astro" });
-
-        writeSource("a.md", "alpha-v2");
-        const result = syncBundledAgents({ sourceDir, targetDir, namespace: "astro" });
-
-        expect(result.written).toEqual(["astro.a.md"]);
-        expect(fs.readFileSync(path.join(targetDir, "astro.a.md"), "utf8")).toBe("alpha-v2");
-    });
-
-    it("prunes namespaced files no longer present in source", () => {
-        writeSource("a.md", "alpha");
-        writeSource("b.md", "beta");
-        syncBundledAgents({ sourceDir, targetDir, namespace: "astro" });
-        fs.rmSync(path.join(sourceDir, "b.md"));
-
-        const result = syncBundledAgents({ sourceDir, targetDir, namespace: "astro" });
-
-        expect(result.pruned).toEqual(["astro.b.md"]);
-        expect(fs.existsSync(path.join(targetDir, "astro.b.md"))).toBe(false);
-    });
-
-    it("never touches files outside the namespace", () => {
-        fs.mkdirSync(targetDir, { recursive: true });
-        const userFile = path.join(targetDir, "my-agent.md");
-        fs.writeFileSync(userFile, "user content", "utf8");
-        writeSource("a.md", "alpha");
-
-        syncBundledAgents({ sourceDir, targetDir, namespace: "astro" });
-
-        expect(fs.readFileSync(userFile, "utf8")).toBe("user content");
-    });
-
-    it("warns and skips when the target slot is taken by a non-file entry", () => {
-        fs.mkdirSync(path.join(targetDir, "astro.a.md"), { recursive: true });
-        writeSource("a.md", "alpha");
-        const warnings: string[] = [];
-
-        const result = syncBundledAgents({
-            sourceDir,
-            targetDir,
-            namespace: "astro",
-            onWarn: (message) => warnings.push(message),
-        });
-
-        expect(result.skipped).toEqual(["astro.a.md"]);
-        expect(warnings.length).toBe(1);
-    });
-
-    it("returns empty result when the source directory does not exist", () => {
-        const result = syncBundledAgents({
-            sourceDir: path.join(tempRoot, "missing"),
-            targetDir,
-            namespace: "astro",
-        });
-
-        expect(result.written).toEqual([]);
-        expect(result.pruned).toEqual([]);
-        expect(result.skipped).toEqual([]);
-    });
-});

package/extensions/astro-agents-loader/sync.ts

@@ -1,86 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-
-export interface SyncOptions {
-    sourceDir: string;
-    targetDir: string;
-    namespace: string;
-    onWarn?: (message: string) => void;
-}
-
-export interface SyncResult {
-    written: string[];
-    pruned: string[];
-    skipped: string[];
-}
-
-export function syncBundledAgents(options: SyncOptions): SyncResult {
-    const { sourceDir, targetDir, namespace, onWarn } = options;
-    const prefix = `${namespace}.`;
-    const written: string[] = [];
-    const pruned: string[] = [];
-    const skipped: string[] = [];
-
-    fs.mkdirSync(targetDir, { recursive: true });
-
-    const sourceFiles = listMarkdownFiles(sourceDir);
-    const intendedTargets = new Set<string>();
-
-    for (const sourcePath of sourceFiles) {
-        const targetName = `${prefix}${path.basename(sourcePath)}`;
-        const targetPath = path.join(targetDir, targetName);
-        intendedTargets.add(targetName);
-
-        const sourceContent = fs.readFileSync(sourcePath, "utf8");
-        const stats = lstatOrNull(targetPath);
-
-        if (stats !== null && !stats.isFile() && !stats.isSymbolicLink()) {
-            onWarn?.(
-                `astro-agents-loader: ${targetPath} exists and is not a regular file; skipping.`,
-            );
-            skipped.push(targetName);
-            continue;
-        }
-
-        if (stats?.isFile() && fs.readFileSync(targetPath, "utf8") === sourceContent) {
-            continue;
-        }
-
-        fs.writeFileSync(targetPath, sourceContent, "utf8");
-        written.push(targetName);
-    }
-
-    for (const entry of safeReaddir(targetDir)) {
-        if (!entry.startsWith(prefix)) continue;
-        if (intendedTargets.has(entry)) continue;
-        fs.unlinkSync(path.join(targetDir, entry));
-        pruned.push(entry);
-    }
-
-    return { written, pruned, skipped };
-}
-
-function listMarkdownFiles(dir: string): string[] {
-    if (!fs.existsSync(dir)) return [];
-    return fs
-        .readdirSync(dir, { withFileTypes: true })
-        .filter((entry) => entry.isFile() && entry.name.endsWith(".md"))
-        .map((entry) => path.join(dir, entry.name))
-        .sort();
-}
-
-function safeReaddir(dir: string): string[] {
-    try {
-        return fs.readdirSync(dir);
-    } catch {
-        return [];
-    }
-}
-
-function lstatOrNull(p: string): fs.Stats | null {
-    try {
-        return fs.lstatSync(p);
-    } catch {
-        return null;
-    }
-}

package/node_modules/jiti/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) Pooya Parsa <pooya@pi0.io>
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/node_modules/jiti/README.md

@@ -1,258 +0,0 @@
-# jiti
-
-<!-- automd:badges color=F0DB4F bundlephobia -->
-
-[![npm version](https://img.shields.io/npm/v/jiti?color=F0DB4F)](https://npmjs.com/package/jiti)
-[![npm downloads](https://img.shields.io/npm/dm/jiti?color=F0DB4F)](https://npmjs.com/package/jiti)
-[![bundle size](https://img.shields.io/bundlephobia/minzip/jiti?color=F0DB4F)](https://bundlephobia.com/package/jiti)
-
-<!-- /automd -->
-
-> This is the active development branch. Check out [jiti/v1](https://github.com/unjs/jiti/tree/v1) for legacy v1 docs and code.
-
-## 🌟 Used in
-
-[Docusaurus](https://docusaurus.io/), [ESLint](https://github.com/eslint/eslint), [FormKit](https://formkit.com/), [Histoire](https://histoire.dev/), [Knip](https://knip.dev/), [Nitro](https://nitro.unjs.io/), [Nuxt](https://nuxt.com/), [PostCSS loader](https://github.com/webpack-contrib/postcss-loader), [Rsbuild](https://rsbuild.dev/), [Size Limit](https://github.com/ai/size-limit), [Slidev](https://sli.dev/), [Tailwindcss](https://tailwindcss.com/), [Tokenami](https://github.com/tokenami/tokenami), [UnoCSS](https://unocss.dev/), [WXT](https://wxt.dev/), [Winglang](https://www.winglang.io/), [Graphql code generator](https://the-guild.dev/graphql/codegen), [Lingui](https://lingui.dev/), [Scaffdog](https://scaff.dog/), [Storybook](https://storybook.js.org), [...UnJS ecosystem](https://unjs.io/), [...60M+ npm monthly downloads](https://npm.chart.dev/jiti), [...6M+ public repositories](https://github.com/unjs/jiti/network/dependents).
-
-## ✅ Features
-
-- Seamless TypeScript and ESM syntax support for Node.js
-- Seamless interoperability between ESM and CommonJS
-- Asynchronous API to replace `import()`
-- Synchronous API to replace `require()` (deprecated)
-- Super slim and zero dependency
-- Custom resolve aliases
-- Smart syntax detection to avoid extra transforms
-- Node.js native `require.cache` integration
-- Filesystem transpile with hard disk caches
-- ESM Loader support
-- JSX support (opt-in)
-
-> [!IMPORTANT]
-> To enhance compatibility, jiti `>=2.1` enabled [`interopDefault`](#interopdefault) using a new Proxy method. If you migrated to `2.0.0` earlier, this might have caused behavior changes. In case of any issues during the upgrade, please [report](https://github.com/unjs/jiti/issues) so we can investigate to solve them. 🙏🏼
-
-## 💡 Usage
-
-### CLI
-
-You can use `jiti` CLI to quickly run any script with TypeScript and native ESM support!
-
-```bash
-npx jiti ./index.ts
-```
-
-### Programmatic
-
-Initialize a jiti instance:
-
-```js
-// ESM
-import { createJiti } from "jiti";
-const jiti = createJiti(import.meta.url);
-
-// CommonJS (deprecated)
-const { createJiti } = require("jiti");
-const jiti = createJiti(__filename);
-```
-
-Import (async) and resolve with ESM compatibility:
-
-```js
-// jiti.import(id) is similar to import(id)
-const mod = await jiti.import("./path/to/file.ts");
-
-// jiti.esmResolve(id) is similar to import.meta.resolve(id)
-const resolvedPath = jiti.esmResolve("./src");
-```
-
-If you need the default export of module, you can use `jiti.import(id, { default: true })` as shortcut to `mod?.default ?? mod`.
-
-```js
-// shortcut to mod?.default ?? mod
-const modDefault = await jiti.import("./path/to/file.ts", { default: true });
-```
-
-CommonJS (sync & deprecated):
-
-```js
-// jiti() is similar to require(id)
-const mod = jiti("./path/to/file.ts");
-
-// jiti.resolve() is similar to require.resolve(id)
-const resolvedPath = jiti.resolve("./src");
-```
-
-You can also pass options as the second argument:
-
-```js
-const jiti = createJiti(import.meta.url, { debug: true });
-```
-
-### Register global ESM loader
-
-You can globally register jiti using [global hooks](https://nodejs.org/api/module.html#initialize). (Important: Requires Node.js > 20)
-
-```js
-import "jiti/register";
-```
-
-Or:
-
-```bash
-node --import jiti/register index.ts
-```
-
-## 🎈 `jiti/native`
-
-You can alias `jiti` to `jiti/native` to directly depend on runtime's [`import.meta.resolve`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import.meta/resolve) and dynamic [`import()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import) support. This allows easing up the ecosystem transition to runtime native support by giving the same API of jiti.
-
-## ⚙️ Options
-
-### `debug`
-
-- Type: Boolean
-- Default: `false`
-- Environment variable: `JITI_DEBUG`
-
-Enable verbose logging. You can use `JITI_DEBUG=1 <your command>` to enable it.
-
-### `fsCache`
-
-- Type: Boolean | String
-- Default: `true`
-- Environment variable: `JITI_FS_CACHE`
-
-Filesystem source cache (enabled by default)
-
-By default (when is `true`), jiti uses `node_modules/.cache/jiti` (if exists) or `{TMP_DIR}/jiti`.
-
-**Note:** It is recommended that this option be enabled for better performance.
-
-### `rebuildFsCache`
-
-- Type: Boolean
-- Default: `false`
-- Environment variable: `JITI_REBUILD_FS_CACHE`
-
-Rebuild filesystem source cache created by `fsCache`.
-
-### `moduleCache`
-
-- Type: String
-- Default: `true`
-- Environment variable: `JITI_MODULE_CACHE`
-
-Runtime module cache (enabled by default).
-
-Disabling allows editing code and importing the same module multiple times.
-
-When enabled, jiti integrates with Node.js native CommonJS cache-store.
-
-### `transform`
-
-- Type: Function
-- Default: Babel (lazy loaded)
-
-Transform function. See [src/babel](./src/babel.ts) for more details
-
-### `sourceMaps`
-
-- Type: Boolean
-- Default `false`
-- Environment variable: `JITI_SOURCE_MAPS`
-
-Add inline source map to transformed source for better debugging.
-
-### `interopDefault`
-
-- Type: Boolean
-- Default: `true`
-- Environment variable: `JITI_INTEROP_DEFAULT`
-
-Jiti combines module exports with the `default` export using an internal Proxy to improve compatibility with mixed CJS/ESM usage. You can check the current implementation [here](https://github.com/unjs/jiti/blob/main/src/utils.ts#L105).
-
-> [!WARNING]
-> This option wraps **all imported modules** in a Proxy, which adds ~25-50ns overhead per property access. For performance-critical hot paths where you access module exports very frequently, consider setting `interopDefault: false` or `JITI_INTEROP_DEFAULT=false`.
-
-### `alias`
-
-- Type: Object
-- Default: -
-- Environment variable: `JITI_ALIAS`
-
-You can also pass an object to the environment variable for inline config. Example: `JITI_ALIAS='{"~/*": "./src/*"}' jiti ...`.
-
-Custom alias map used to resolve IDs.
-
-### `tsconfigPaths`
-
-- Type: Boolean | String
-- Default: `false`
-- Environment variable: `JITI_TSCONFIG_PATHS`
-
-Enable TypeScript [`paths`](https://www.typescriptlang.org/tsconfig/#paths) resolution using [`get-tsconfig`](https://github.com/privatenumber/get-tsconfig).
-
-- `true`: Auto-discover `tsconfig.json` by walking up from the jiti instance's parent path.
-- `string`: Explicit path to a `tsconfig.json` file.
-- `false` (default): Disabled.
-
-### `nativeModules`
-
-- Type: Array
-- Default: ['typescript']
-- Environment variable: `JITI_NATIVE_MODULES`
-
-List of modules (within `node_modules`) to always use native `require()` for them.
-
-### `transformModules`
-
-- Type: Array
-- Default: []
-- Environment variable: `JITI_TRANSFORM_MODULES`
-
-List of modules (within `node_modules`) to transform them regardless of syntax.
-
-### `importMeta`
-
-Parent module's [`import.meta`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import.meta) context to use for ESM resolution. (only used for `jiti/native` import).
-
-### `tryNative`
-
-- Type: Boolean
-- Default: Enabled if bun is detected
-- Environment variable: `JITI_TRY_NATIVE`
-
-Try to use native require and import without jiti transformations first.
-
-### `jsx`
-
-- Type: Boolean | {options}
-- Default: `false`
-- Environment Variable: `JITI_JSX`
-
-Enable JSX support using [`@babel/plugin-transform-react-jsx`](https://babeljs.io/docs/babel-plugin-transform-react-jsx).
-
-See [`test/fixtures/jsx`](./test/fixtures/jsx) for framework integration examples.
-
-## Development
-
-- Clone this repository
-- Enable [Corepack](https://github.com/nodejs/corepack) using `corepack enable`
-- Install dependencies using `pnpm install`
-- Run `pnpm dev`
-- Run `pnpm jiti ./test/path/to/file.ts`
-
-## License
-
-<!-- automd:contributors license=MIT author="pi0" -->
-
-Published under the [MIT](https://github.com/unjs/jiti/blob/main/LICENSE) license.
-Made by [@pi0](https://github.com/pi0) and [community](https://github.com/unjs/jiti/graphs/contributors) 💛
-<br><br>
-<a href="https://github.com/unjs/jiti/graphs/contributors">
-<img src="https://contrib.rocks/image?repo=unjs/jiti" />
-</a>
-
-<!-- /automd -->
-
-<!-- automd:with-automd -->