@oxagen/cli 0.5.0 → 0.6.1

package/dist/settings/schema.d.ts.map

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

package/dist/settings/schema.js

@@ -0,0 +1,146 @@
+/**
+ * schema.ts — The unified `settings.json` schema that drives the Oxagen CLI.
+ *
+ * This is the CLI harness spine: a single file format, resolved across three
+ * scopes (see resolve.ts), that configures the CLI's behavior the way Claude
+ * Code's `settings.json` does. Sections:
+ *
+ *   - model          default gateway model slug for the agent loop
+ *   - apiUrl         Oxagen platform API base URL
+ *   - env            environment variables made available to the session
+ *   - permissions    allow/deny rules + default mode for the agent's local tools
+ *   - hooks          shell commands fired on lifecycle events (SessionStart /
+ *                    PreToolUse / PostToolUse) — PreToolUse can block a tool
+ *   - mcpServers     external MCP server definitions (reused from @oxagen/mcp-config)
+ *   - toolVisibility per-MCP-server tool include/exclude (reused from @oxagen/mcp-config)
+ *
+ * Credentials (token / org / workspace / gatewayKey) intentionally do NOT live
+ * here — they stay in the user-only `config.json` credential store so a project
+ * `settings.json` is safe to commit. This mirrors Claude Code, which keeps
+ * `.credentials.json` separate from `settings.json`.
+ *
+ * The MCP sections deliberately reuse the schemas from `@oxagen/mcp-config` so a
+ * single `settings.json` validates identically here and in the platform agent
+ * runtime that already reads MCP servers from the same file — no second source
+ * of truth, no drift.
+ */
+import { z } from "zod";
+import { mcpServerSchema, serverPermissionSchema, toolVisibilitySchema, } from "@oxagen/mcp-config/schema";
+// ── Permissions ───────────────────────────────────────────────────────────────
+/**
+ * Permission mode when no explicit allow/deny rule matches a tool call.
+ *
+ *   - "default" / "acceptEdits" → allow unless a deny rule matches
+ *   - "deny"                    → block unless an allow rule matches (deny-by-default)
+ *   - "bypassPermissions"       → allow everything (deny rules still take priority)
+ *
+ * Enforced for the agent's local tools in gate.ts. (Interactive "ask"/"plan"
+ * prompting lands with the MCP-client PR; only the modes enforced today are
+ * accepted here so the schema never advertises behavior that does not exist.)
+ */
+export const permissionModeSchema = z.enum([
+    "default",
+    "acceptEdits",
+    "deny",
+    "bypassPermissions",
+]);
+/**
+ * Permission rules for the agent's local tools, in Claude Code's rule syntax:
+ *
+ *   "Bash"              → the whole bash tool
+ *   "Bash(git*)"        → bash commands matching the glob `git*`
+ *   "Write"             → any file write
+ *   "Write(src/**)"     → writes whose path matches `src/**`
+ *   "Read(.env*)"       → reads whose path matches `.env*`
+ *   "mcp__github__*"    → (reserved for the MCP gate) any tool on the `github` server
+ *
+ * `deny` always wins over `allow` at the same scope. The MCP-specific
+ * `defaultMcpPolicy` / `mcpServers` fields are carried through unchanged so the
+ * same `permissions` object also feeds @oxagen/mcp-config's per-server gate when
+ * the MCP client lands.
+ */
+export const permissionsSchema = z.object({
+    /** Mode applied when no allow/deny rule matches. Default: "default". */
+    defaultMode: permissionModeSchema.optional(),
+    /** Rules that explicitly permit a tool call (escape hatch from deny mode). */
+    allow: z.array(z.string()).optional(),
+    /** Rules that explicitly block a tool call. Highest priority. */
+    deny: z.array(z.string()).optional(),
+    // ── MCP compatibility (consumed by @oxagen/mcp-config, not by gate.ts) ──
+    /** Global default policy for MCP tool invocations. */
+    defaultMcpPolicy: z.enum(["allow", "deny", "ask"]).optional(),
+    /** Per-MCP-server permission overrides, keyed by server name. */
+    mcpServers: z.record(serverPermissionSchema).optional(),
+});
+// ── Hooks ─────────────────────────────────────────────────────────────────────
+/** Lifecycle events a hook can fire on. */
+export const HOOK_EVENTS = [
+    "SessionStart",
+    "PreToolUse",
+    "PostToolUse",
+];
+/** A single shell command a hook runs. */
+export const hookActionSchema = z.object({
+    /** Only "command" hooks are supported. */
+    type: z.literal("command").default("command"),
+    /** Shell command. Receives the event payload as JSON on stdin. */
+    command: z.string().min(1),
+    /** Per-hook timeout in milliseconds (default 60000, max 600000). */
+    timeoutMs: z.number().int().positive().max(600_000).optional(),
+});
+/**
+ * A matcher groups hook actions under a tool-name pattern. For PreToolUse /
+ * PostToolUse, `matcher` is a glob over the tool name (e.g. "bash",
+ * "write_file", "*"). For SessionStart it is ignored (all actions run).
+ */
+export const hookMatcherSchema = z.object({
+    /** Glob over the tool name. Omit (or "*") to match every tool. */
+    matcher: z.string().optional(),
+    /** Actions to run when this matcher matches. */
+    hooks: z.array(hookActionSchema).min(1),
+});
+/** Hooks keyed by lifecycle event. */
+export const hooksSchema = z.object({
+    SessionStart: z.array(hookMatcherSchema).optional(),
+    PreToolUse: z.array(hookMatcherSchema).optional(),
+    PostToolUse: z.array(hookMatcherSchema).optional(),
+});
+// ── Inline agent definitions ──────────────────────────────────────────────────
+/**
+ * A named agent declared inline in settings.json (an alternative to a markdown
+ * file under `.oxagen/agents/`). `prompt` is the system prompt; `tools` is the
+ * permission-syntax allowlist (omit to inherit every tool).
+ */
+export const inlineAgentSchema = z.object({
+    description: z.string().optional(),
+    prompt: z.string().min(1),
+    tools: z.array(z.string()).optional(),
+    model: z.string().optional(),
+});
+// ── Top-level settings ────────────────────────────────────────────────────────
+export const oxagenSettingsSchema = z
+    .object({
+    /** Optional JSON-Schema reference for editor autocompletion. */
+    $schema: z.string().optional(),
+    /** Default gateway model slug for the agent loop (e.g. "anthropic/claude-sonnet-4.6"). */
+    model: z.string().optional(),
+    /** Oxagen platform API base URL (overrides config.json; env still wins). */
+    apiUrl: z.string().url().optional(),
+    /** Environment variables exported into the session (fills only unset vars; shell wins). */
+    env: z.record(z.string()).optional(),
+    /** Allow/deny rules + default mode for the agent's local tools. */
+    permissions: permissionsSchema.optional(),
+    /** Shell commands fired on lifecycle events. */
+    hooks: hooksSchema.optional(),
+    /** External MCP server definitions, keyed by name. */
+    mcpServers: z.record(mcpServerSchema).optional(),
+    /** Per-MCP-server tool visibility, keyed by server name. */
+    toolVisibility: z.record(toolVisibilitySchema).optional(),
+    /** Inline named agent definitions, keyed by agent name. */
+    agents: z.record(inlineAgentSchema).optional(),
+})
+    // Forward-compatible: sections that land in later PRs (agents, commands,
+    // skills) may already be present in a user's file; pass them through rather
+    // than failing validation, so the file format is stable across the rollout.
+    .passthrough();
+//# sourceMappingURL=schema.js.map

package/dist/settings/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/settings/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAEnC,iFAAiF;AAEjF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC;IACzC,SAAS;IACT,aAAa;IACb,MAAM;IACN,mBAAmB;CACpB,CAAC,CAAC;AAGH;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,wEAAwE;IACxE,WAAW,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IAC5C,8EAA8E;IAC9E,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,iEAAiE;IACjE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,2EAA2E;IAC3E,sDAAsD;IACtD,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7D,iEAAiE;IACjE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;CACxD,CAAC,CAAC;AAGH,iFAAiF;AAEjF,2CAA2C;AAC3C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,cAAc;IACd,YAAY;IACZ,aAAa;CACL,CAAC;AAGX,0CAA0C;AAC1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,0CAA0C;IAC1C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC7C,kEAAkE;IAClE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,oEAAoE;IACpE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;CAC/D,CAAC,CAAC;AAGH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,kEAAkE;IAClE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,gDAAgD;IAChD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACxC,CAAC,CAAC;AAGH,sCAAsC;AACtC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;IACnD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;IACjD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAGH,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAGH,iFAAiF;AAEjF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,gEAAgE;IAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,0FAA0F;IAC1F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,4EAA4E;IAC5E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACnC,2FAA2F;IAC3F,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,mEAAmE;IACnE,WAAW,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACzC,gDAAgD;IAChD,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE;IAC7B,sDAAsD;IACtD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;IAChD,4DAA4D;IAC5D,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE;IACzD,2DAA2D;IAC3D,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAC;IACF,yEAAyE;IACzE,4EAA4E;IAC5E,4EAA4E;KAC3E,WAAW,EAAE,CAAC"}

package/dist/settings/write.d.ts

@@ -0,0 +1,37 @@
+import { type OxagenSettings } from "./schema.js";
+import { type SettingsScope } from "./resolve.js";
+/** Keys `oxagen settings set` accepts. Complex sections are edited in the file. */
+export declare const SETTABLE_KEYS: readonly ["model", "apiUrl"];
+export interface WriteValueOptions {
+    scope: SettingsScope;
+    /** "model", "apiUrl", or "env.<NAME>". */
+    key: string;
+    value: string;
+    cwd?: string;
+    userSettingsPath?: string;
+    projectDirName?: string;
+}
+/** Read a single scope file as a raw JSON object (empty if absent). */
+export declare function readScopeDoc(path: string): Record<string, unknown>;
+/** Validate and write a settings document to a scope file, busting the cache. */
+export declare function writeScopeDoc(path: string, doc: OxagenSettings): void;
+/**
+ * Set a single value in a scope file. Supports scalar keys (`model`, `apiUrl`)
+ * and env vars via the `env.NAME` form. Returns the path written.
+ */
+export declare function writeSettingsValue(opts: WriteValueOptions): string;
+export interface InitOptions {
+    scope: SettingsScope;
+    cwd?: string;
+    userSettingsPath?: string;
+    projectDirName?: string;
+}
+/**
+ * Write a documented starter settings file for a scope. Returns the path and
+ * whether it was newly created (false = already existed, left untouched).
+ */
+export declare function writeStarterSettings(opts: InitOptions): {
+    path: string;
+    created: boolean;
+};
+//# sourceMappingURL=write.d.ts.map

package/dist/settings/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/settings/write.ts"],"names":[],"mappings":"AAUA,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAErF,mFAAmF;AACnF,eAAO,MAAM,aAAa,8BAA+B,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOlE;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAKrE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAsBlE;AAkBD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAM1F"}

package/dist/settings/write.js

@@ -0,0 +1,85 @@
+/**
+ * write.ts — Writers for `oxagen settings set` and `oxagen settings init`.
+ *
+ * Writes target a single scope file (user / project / local) — never the merged
+ * view — so the layering stays meaningful. Every write is validated against the
+ * unified schema before it touches disk, so a `set` can never produce an invalid
+ * settings file.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { oxagenSettingsSchema } from "./schema.js";
+import { getScopePaths, clearSettingsCache } from "./resolve.js";
+/** Keys `oxagen settings set` accepts. Complex sections are edited in the file. */
+export const SETTABLE_KEYS = ["model", "apiUrl"];
+/** Read a single scope file as a raw JSON object (empty if absent). */
+export function readScopeDoc(path) {
+    if (!existsSync(path))
+        return {};
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`existing settings file is not a JSON object: ${path}`);
+    }
+    return parsed;
+}
+/** Validate and write a settings document to a scope file, busting the cache. */
+export function writeScopeDoc(path, doc) {
+    const validated = oxagenSettingsSchema.parse(doc);
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(validated, null, 2) + "\n", "utf8");
+    clearSettingsCache();
+}
+/**
+ * Set a single value in a scope file. Supports scalar keys (`model`, `apiUrl`)
+ * and env vars via the `env.NAME` form. Returns the path written.
+ */
+export function writeSettingsValue(opts) {
+    const paths = getScopePaths(opts);
+    const path = paths[opts.scope];
+    const doc = readScopeDoc(path);
+    if (opts.key.startsWith("env.")) {
+        const name = opts.key.slice("env.".length);
+        if (!name)
+            throw new Error('env key must be "env.<NAME>"');
+        const env = doc["env"] ?? {};
+        env[name] = opts.value;
+        doc["env"] = env;
+    }
+    else if (SETTABLE_KEYS.includes(opts.key)) {
+        doc[opts.key] = opts.value;
+    }
+    else {
+        throw new Error(`cannot set "${opts.key}". Settable: ${SETTABLE_KEYS.join(", ")}, env.<NAME>. ` +
+            `Edit ${path} directly for permissions / hooks / mcpServers.`);
+    }
+    writeScopeDoc(path, doc);
+    return path;
+}
+const STARTER = {
+    $schema: "https://oxagen.sh/schemas/cli-settings.json",
+    model: "anthropic/claude-sonnet-4.6",
+    env: {},
+    permissions: {
+        defaultMode: "default",
+        deny: ["Bash(rm -rf*)", "Write(.env*)", "Read(.env*)"],
+        allow: [],
+    },
+    hooks: {
+        PreToolUse: [],
+        PostToolUse: [],
+        SessionStart: [],
+    },
+};
+/**
+ * Write a documented starter settings file for a scope. Returns the path and
+ * whether it was newly created (false = already existed, left untouched).
+ */
+export function writeStarterSettings(opts) {
+    const paths = getScopePaths(opts);
+    const path = paths[opts.scope];
+    if (existsSync(path))
+        return { path, created: false };
+    writeScopeDoc(path, STARTER);
+    return { path, created: true };
+}
+//# sourceMappingURL=write.js.map

package/dist/settings/write.js.map

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

package/dist/slash/__tests__/expand.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=expand.test.d.ts.map

package/dist/slash/__tests__/expand.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand.test.d.ts","sourceRoot":"","sources":["../../../src/slash/__tests__/expand.test.ts"],"names":[],"mappings":""}

package/dist/slash/__tests__/expand.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect } from "vitest";
+import { parseInvocation, applyArgs, expandSlash } from "../expand.js";
+function registry(...cmds) {
+    const m = new Map();
+    for (const c of cmds)
+        m.set(c.name, { description: "", source: "test", ...c });
+    return m;
+}
+describe("parseInvocation", () => {
+    it("splits name and args", () => {
+        expect(parseInvocation("/review src/x.ts here")).toEqual({ name: "review", args: "src/x.ts here" });
+    });
+    it("handles a bare command", () => {
+        expect(parseInvocation("/status")).toEqual({ name: "status", args: "" });
+    });
+    it("returns null for non-slash input", () => {
+        expect(parseInvocation("hello")).toBeNull();
+    });
+});
+describe("applyArgs", () => {
+    it("substitutes $ARGUMENTS", () => {
+        expect(applyArgs("Review: $ARGUMENTS", "a b c")).toBe("Review: a b c");
+    });
+    it("substitutes positional $1/$2 and blanks missing ones", () => {
+        expect(applyArgs("$1 vs $2 vs $3", "one two")).toBe("one vs two vs ");
+    });
+    it("leaves the template intact when there are no placeholders", () => {
+        expect(applyArgs("no placeholders", "x")).toBe("no placeholders");
+    });
+});
+describe("expandSlash", () => {
+    const reg = registry({ name: "review", template: "Review $ARGUMENTS for bugs.", model: "a/b" }, { name: "explain", template: "Explain $1." });
+    it("expands a known command and carries its model", () => {
+        const res = expandSlash("/review src/auth.ts", reg);
+        expect(res).toEqual({ command: "review", prompt: "Review src/auth.ts for bugs.", model: "a/b" });
+    });
+    it("returns null for an unknown command", () => {
+        expect(expandSlash("/nope x", reg)).toBeNull();
+    });
+    it("returns an error for non-slash input", () => {
+        expect(expandSlash("hello", reg)).toEqual({ error: "not a slash command" });
+    });
+});
+//# sourceMappingURL=expand.test.js.map

package/dist/slash/__tests__/expand.test.js.map

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

package/dist/slash/__tests__/loader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=loader.test.d.ts.map

package/dist/slash/__tests__/loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.test.d.ts","sourceRoot":"","sources":["../../../src/slash/__tests__/loader.test.ts"],"names":[],"mappings":""}

package/dist/slash/__tests__/loader.test.js

@@ -0,0 +1,48 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { loadCommands } from "../loader.js";
+let dir;
+let userDir;
+function writeCmd(rel, body) {
+    const path = join(dir, rel);
+    mkdirSync(join(path, ".."), { recursive: true });
+    writeFileSync(path, body, "utf8");
+}
+const load = () => loadCommands({ cwd: dir, userCommandsDir: userDir });
+beforeEach(() => {
+    dir = mkdtempSync(join(tmpdir(), "oxagen-slash-"));
+    userDir = join(dir, "user-commands");
+});
+afterEach(() => rmSync(dir, { recursive: true, force: true }));
+describe("loadCommands", () => {
+    it("loads a command with frontmatter and body template", () => {
+        writeCmd(".oxagen/commands/review.md", "---\ndescription: Review code\nargument-hint: <file>\nmodel: a/b\n---\nReview $ARGUMENTS.");
+        const cmd = load().get("review");
+        expect(cmd?.description).toBe("Review code");
+        expect(cmd?.argumentHint).toBe("<file>");
+        expect(cmd?.model).toBe("a/b");
+        expect(cmd?.template).toBe("Review $ARGUMENTS.");
+    });
+    it("defaults the name to the filename", () => {
+        writeCmd(".oxagen/commands/deploy.md", "Do the deploy: $ARGUMENTS");
+        expect(load().get("deploy")?.name).toBe("deploy");
+    });
+    it(".oxagen overrides .claude overrides user", () => {
+        mkdirSync(userDir, { recursive: true });
+        writeFileSync(join(userDir, "x.md"), "user body");
+        writeCmd(".claude/commands/x.md", "claude body");
+        expect(load().get("x")?.template).toBe("claude body");
+        writeCmd(".oxagen/commands/x.md", "oxagen body");
+        expect(load().get("x")?.template).toBe("oxagen body");
+    });
+    it("ignores files with an empty body", () => {
+        writeCmd(".oxagen/commands/empty.md", "---\ndescription: d\n---\n");
+        expect(load().has("empty")).toBe(false);
+    });
+    it("returns an empty registry when nothing is defined", () => {
+        expect(load().size).toBe(0);
+    });
+});
+//# sourceMappingURL=loader.test.js.map

package/dist/slash/__tests__/loader.test.js.map

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

package/dist/slash/expand.d.ts

@@ -0,0 +1,32 @@
+/**
+ * expand.ts — Turn a `/name args` invocation into a concrete prompt.
+ *
+ * Substitution in the template:
+ *   - $ARGUMENTS   the full argument string
+ *   - $1 … $9      positional arguments (whitespace-split); missing → ""
+ *
+ * Returns the expanded prompt (and any model override), an error, or null when
+ * the input does not name a known command (so the REPL can say "unknown").
+ */
+import { type LoadCommandsOptions } from "./loader.js";
+import type { SlashCommand } from "./types.js";
+export interface SlashExpansion {
+    command: string;
+    prompt: string;
+    model?: string;
+}
+export interface SlashError {
+    error: string;
+}
+/** Parse "/review src/x here" → { name: "review", args: "src/x here" }. */
+export declare function parseInvocation(input: string): {
+    name: string;
+    args: string;
+} | null;
+/** Apply $ARGUMENTS / $1..$9 substitution to a template. */
+export declare function applyArgs(template: string, args: string): string;
+/** Expand against an already-loaded registry. Returns null if name is unknown. */
+export declare function expandSlash(input: string, registry: Map<string, SlashCommand>): SlashExpansion | SlashError | null;
+/** Load the registry and expand in one call (REPL convenience). */
+export declare function loadAndExpand(input: string, opts?: LoadCommandsOptions): SlashExpansion | SlashError | null;
+//# sourceMappingURL=expand.d.ts.map

package/dist/slash/expand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand.d.ts","sourceRoot":"","sources":["../../src/slash/expand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAOpF;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED,kFAAkF;AAClF,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAClC,cAAc,GAAG,UAAU,GAAG,IAAI,CAUpC;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,mBAAwB,GAC7B,cAAc,GAAG,UAAU,GAAG,IAAI,CAEpC"}

package/dist/slash/expand.js

@@ -0,0 +1,48 @@
+/**
+ * expand.ts — Turn a `/name args` invocation into a concrete prompt.
+ *
+ * Substitution in the template:
+ *   - $ARGUMENTS   the full argument string
+ *   - $1 … $9      positional arguments (whitespace-split); missing → ""
+ *
+ * Returns the expanded prompt (and any model override), an error, or null when
+ * the input does not name a known command (so the REPL can say "unknown").
+ */
+import { loadCommands } from "./loader.js";
+/** Parse "/review src/x here" → { name: "review", args: "src/x here" }. */
+export function parseInvocation(input) {
+    const trimmed = input.trim();
+    if (!trimmed.startsWith("/"))
+        return null;
+    const rest = trimmed.slice(1);
+    const space = rest.search(/\s/);
+    if (space === -1)
+        return { name: rest, args: "" };
+    return { name: rest.slice(0, space), args: rest.slice(space + 1).trim() };
+}
+/** Apply $ARGUMENTS / $1..$9 substitution to a template. */
+export function applyArgs(template, args) {
+    const positionals = args.length > 0 ? args.split(/\s+/) : [];
+    return template
+        .replace(/\$ARGUMENTS\b/g, args)
+        .replace(/\$([1-9])\b/g, (_, d) => positionals[Number(d) - 1] ?? "");
+}
+/** Expand against an already-loaded registry. Returns null if name is unknown. */
+export function expandSlash(input, registry) {
+    const parsed = parseInvocation(input);
+    if (!parsed)
+        return { error: "not a slash command" };
+    const command = registry.get(parsed.name);
+    if (!command)
+        return null;
+    return {
+        command: command.name,
+        prompt: applyArgs(command.template, parsed.args),
+        model: command.model,
+    };
+}
+/** Load the registry and expand in one call (REPL convenience). */
+export function loadAndExpand(input, opts = {}) {
+    return expandSlash(input, loadCommands(opts));
+}
+//# sourceMappingURL=expand.js.map

package/dist/slash/expand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand.js","sourceRoot":"","sources":["../../src/slash/expand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAA4B,MAAM,aAAa,CAAC;AAarE,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAClD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AAC5E,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,IAAY;IACtD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,OAAO,QAAQ;SACZ,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC;SAC/B,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,WAAW,CACzB,KAAa,EACb,QAAmC;IAEnC,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC;QAChD,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,OAA4B,EAAE;IAE9B,OAAO,WAAW,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/slash/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @module slash — User-defined slash commands for the CLI.
+ *
+ * Reusable prompt templates invoked as `/name args` in the REPL or via
+ * `oxagen command run name args`, loaded from markdown.
+ */
+export type { SlashCommand } from "./types.js";
+export { loadCommands, type LoadCommandsOptions } from "./loader.js";
+export { expandSlash, loadAndExpand, parseInvocation, applyArgs, type SlashExpansion, type SlashError, } from "./expand.js";
+export { scaffoldCommand } from "./write.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/slash/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/slash/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,WAAW,EACX,aAAa,EACb,eAAe,EACf,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/slash/index.js

@@ -0,0 +1,4 @@
+export { loadCommands } from "./loader.js";
+export { expandSlash, loadAndExpand, parseInvocation, applyArgs, } from "./expand.js";
+export { scaffoldCommand } from "./write.js";
+//# sourceMappingURL=index.js.map

package/dist/slash/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/slash/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAA4B,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,WAAW,EACX,aAAa,EACb,eAAe,EACf,SAAS,GAGV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/slash/loader.d.ts

@@ -0,0 +1,10 @@
+import type { SlashCommand } from "./types.js";
+export interface LoadCommandsOptions {
+    /** Project root. Defaults to process.cwd(). */
+    cwd?: string;
+    /** Override the user commands dir (testing). */
+    userCommandsDir?: string;
+}
+/** Load every slash command visible from `cwd`, merged by name across sources. */
+export declare function loadCommands(opts?: LoadCommandsOptions): Map<string, SlashCommand>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/slash/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/slash/loader.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAoCD,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAQtF"}

package/dist/slash/loader.js

@@ -0,0 +1,64 @@
+/**
+ * loader.ts — Discover and parse user-defined slash commands.
+ *
+ * Sources, lowest → highest precedence (later overrides by name):
+ *   1. ~/.config/oxagen/commands/*.md   (user)
+ *   2. <project>/.claude/commands/*.md  (Claude Code interop)
+ *   3. <project>/.oxagen/commands/*.md  (oxagen project commands)
+ *
+ * Reuses the agent loader's frontmatter parser. Frontmatter keys: description,
+ * `argument-hint`, model. The body is the prompt template.
+ */
+import { readdirSync, existsSync } from "node:fs";
+import { join, basename } from "node:path";
+import { homedir } from "node:os";
+import { readFileSync } from "node:fs";
+import { parseFrontmatter } from "../agents/loader.js";
+function defFromFile(path) {
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const { data, body } = parseFrontmatter(raw);
+    const name = data["name"] || basename(path).replace(/\.md$/, "");
+    if (!name || !body.trim())
+        return null; // a command needs a name and a template
+    return {
+        name,
+        description: data["description"] ?? "",
+        template: body,
+        argumentHint: data["argument-hint"] || undefined,
+        model: data["model"] || undefined,
+        source: path,
+    };
+}
+function loadDir(dir, into) {
+    if (!existsSync(dir))
+        return;
+    let files;
+    try {
+        files = readdirSync(dir).filter((f) => f.endsWith(".md"));
+    }
+    catch {
+        return;
+    }
+    for (const file of files.sort()) {
+        const def = defFromFile(join(dir, file));
+        if (def)
+            into.set(def.name, def);
+    }
+}
+/** Load every slash command visible from `cwd`, merged by name across sources. */
+export function loadCommands(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const userDir = opts.userCommandsDir ?? join(homedir(), ".config", "oxagen", "commands");
+    const registry = new Map();
+    loadDir(userDir, registry);
+    loadDir(join(cwd, ".claude", "commands"), registry);
+    loadDir(join(cwd, ".oxagen", "commands"), registry);
+    return registry;
+}
+//# sourceMappingURL=loader.js.map

package/dist/slash/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/slash/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAUvD,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACjE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC,CAAC,wCAAwC;IAChF,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE;QACtC,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,SAAS;QAChD,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,SAAS;QACjC,MAAM,EAAE,IAAI;KACb,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,GAAW,EAAE,IAA+B;IAC3D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO;IAC7B,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QACzC,IAAI,GAAG;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,YAAY,CAAC,OAA4B,EAAE;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACzF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IACjD,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;IACpD,OAAO,QAAQ,CAAC;AAClB,CAAC"}