synorch 0.2.0 → 0.4.0-beta.0

package/dist/harness/cli/extensions/agents.js

@@ -0,0 +1,66 @@
+import path from "node:path";
+import { readMarkdownFile } from "./markdown.js";
+const AGENT_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+export const PERSONA_INSTRUCTIONS_LIMIT = 8 * 1024;
+export async function readAgentFile(file) {
+    const document = await readMarkdownFile(file);
+    if (document === undefined)
+        return undefined;
+    const data = document.data;
+    const name = typeof data.name === "string" && AGENT_NAME.test(data.name.trim()) ? data.name.trim() : path.basename(file).replace(/\.md$/i, "");
+    if (!AGENT_NAME.test(name))
+        return undefined;
+    const tools = Array.isArray(data.tools) ? data.tools.filter((tool) => typeof tool === "string") : typeof data.tools === "string" ? data.tools.split(",") : [];
+    return {
+        name,
+        description: typeof data.description === "string" ? data.description.trim() : "",
+        tools: tools.map((tool) => tool.trim()).filter((tool) => tool !== ""),
+        model: typeof data.model === "string" && data.model.trim() !== "" ? data.model.trim() : undefined,
+        body: document.body,
+        file,
+    };
+}
+/** Claude tools that change files or run commands; an agent without any of them is read-only. */
+const WRITING_TOOLS = new Set(["Bash", "Edit", "Write", "MultiEdit", "NotebookEdit", "PowerShell"]);
+export function isReadOnlyAgent(agent) {
+    return agent.tools.length > 0 && agent.tools.every((tool) => !WRITING_TOOLS.has(tool.replace(/\(.*$/, "").trim()));
+}
+/** The worker role a persona layers on: implementer, or reviewer/explorer for a read-only agent. */
+export function personaBaseRole(agent) {
+    if (!isReadOnlyAgent(agent))
+        return "implementer";
+    return /review|audit|critic|check/i.test(`${agent.name} ${agent.description}`) ? "reviewer" : "explorer";
+}
+/** Claude's model aliases → Synorch task tiers; `inherit`, unknown ids and no hint keep the orchestrator's tier. */
+export function personaModelTier(model) {
+    const value = model?.toLowerCase() ?? "";
+    if (value.includes("haiku"))
+        return "fast_worker";
+    if (value.includes("opus") || value.includes("sonnet"))
+        return "complex_worker";
+    return undefined;
+}
+export function createPersonaCatalog(agents) {
+    return {
+        list: agents,
+        find: (id) => {
+            const all = agents();
+            return all.find((agent) => agent.id === id) ?? all.find((agent) => agent.id.toLowerCase() === id.toLowerCase()) ?? all.find((agent) => agent.name === id);
+        },
+    };
+}
+/** The orchestrator's view of the available personas (one line each), or undefined when none. */
+export function renderPersonaHint(agents) {
+    if (agents.length === 0)
+        return undefined;
+    const lines = agents.slice(0, 40).map((agent) => {
+        const tier = personaModelTier(agent.model);
+        const description = agent.description.replace(/\s+/g, " ").slice(0, 200);
+        return `- ${agent.id} (base role ${personaBaseRole(agent)}${tier === undefined ? "" : `, model_tier ${tier}`}): ${description}`;
+    });
+    return [
+        "Plugin agents (optional worker personas): set a task's `agent` to one of these ids when its specialty fits the task; its instructions are layered on the task's role. Keep the role the listed base role (an agent without write tools reads only).",
+        ...lines,
+    ].join("\n");
+}
+//# sourceMappingURL=agents.js.map

package/dist/harness/cli/extensions/agents.js.map

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

package/dist/harness/cli/extensions/catalog.d.ts

@@ -0,0 +1,134 @@
+import type { SkillCatalog } from "../../context/index.ts";
+import { type McpServerDefinition } from "../../mcp/index.ts";
+import { type MarkdownMeta } from "./markdown.ts";
+import { type PluginContents } from "./plugins.ts";
+/**
+ * K7 skills, markdown commands and plugins as one catalog. Sources, highest precedence first on a
+ * name clash (the listing shows what is shadowed):
+ *
+ *   project  <repo>/.synorch/skills, .claude/skills, .agents/skills (+ commands/): repository
+ *            content, used only once the workspace is trusted ("needs trust" otherwise)
+ *   user     <synorch home>/skills, <synorch home>/commands
+ *   plugin   plugins installed with `syn plugin install` (namespaced `<plugin>:<name>`)
+ *   claude   Claude Code's own: ~/.claude/skills, ~/.claude/commands and the plugins enabled in
+ *            Claude Code (`skills.include_claude` / `plugins.include_claude`, default on)
+ *   builtin  the Synorch skills (and a repository's legacy `.ai/skills`, served as before)
+ *
+ * Claude Code native routes already load Claude's own items; the model catalog leaves them out
+ * there (no duplicates) while Synorch's own items still reach Claude through `load_skill`.
+ */
+export type ExtensionSource = "project" | "user" | "plugin" | "claude" | "builtin";
+export declare const EXTENSION_SOURCES: readonly ExtensionSource[];
+export interface ExtensionItem {
+    readonly kind: "skill" | "command";
+    /** Invocation name: `deploy`, or `<plugin>:<name>` for a plugin's item. */
+    readonly name: string;
+    readonly source: ExtensionSource;
+    /** Where it comes from (file path, or `builtin:…`). */
+    readonly location: string;
+    /** The plugin key (`name`, Claude's `name@marketplace`) of a plugin item. */
+    readonly plugin: string | undefined;
+    readonly meta: MarkdownMeta;
+    /** Repository content: active only in a trusted workspace. */
+    readonly needsTrust: boolean;
+    /** Claude Code loads it itself on its native routes (user-level Claude items and Claude plugins). */
+    readonly claudeNative: boolean;
+    readonly file: string | undefined;
+    readonly content: string | undefined;
+    readonly dir: string | undefined;
+    readonly pluginRoot: string | undefined;
+    /** Served by the canonical catalog (built-in or `.ai/skills`), role visibility included. */
+    readonly canonical: boolean;
+}
+export type ItemState = "active" | "shadowed" | "disabled" | "needs-trust";
+export interface ItemStatus {
+    readonly item: ExtensionItem;
+    readonly state: ItemState;
+    /** The winning item's source, for a shadowed one. */
+    readonly shadowedBy: ExtensionItem | undefined;
+}
+export interface PluginEntry {
+    /** `name` for a Synorch plugin, Claude's `name@marketplace` for a Claude one. */
+    readonly key: string;
+    readonly origin: "synorch" | "claude";
+    readonly contents: PluginContents;
+    /** Where it came from (install source, or Claude's scope). */
+    readonly detail: string;
+    readonly enabled: boolean;
+    /** Why it is off: turned off in Synorch, or disabled in Claude Code. */
+    readonly offReason: "synorch" | "claude" | undefined;
+    /** A Claude plugin a Synorch plugin of the same name replaces. */
+    readonly shadowed: boolean;
+}
+export interface ExtensionState {
+    readonly items: readonly ExtensionItem[];
+    readonly plugins: readonly PluginEntry[];
+    readonly problems: readonly string[];
+}
+export interface ExtensionLoadInput {
+    readonly home: string;
+    readonly workspaceRoot: string;
+    readonly env: Readonly<Record<string, string | undefined>>;
+    readonly platform: NodeJS.Platform;
+    /** Claude Code's home (`claudeHome(env)`); undefined reads nothing of Claude's. */
+    readonly claudeHome: string | undefined;
+    readonly includeClaudeSkills: boolean;
+    readonly includeClaudePlugins: boolean;
+    readonly disabledPlugins: readonly string[];
+    /** The workspace is trusted (project-scope Claude plugin state is read only then). */
+    readonly trusted: boolean;
+    /** Canonical skills (`name`, `description`, where), listed as `builtin` (or `project` for `.ai/skills`). */
+    readonly canonical?: {
+        readonly origin: "repository" | "builtin";
+        readonly skills: readonly {
+            readonly name: string;
+            readonly description: string;
+            readonly path: string;
+        }[];
+    };
+    /** Skip `<repo>/.synorch/*` when the workspace's `.synorch` is the Synorch home itself. */
+    readonly skipProjectSynorch?: boolean;
+    /** The folder is no project (the home folder): no project-scope skills or commands at all. */
+    readonly skipProjectScope?: boolean;
+}
+/** Reads every source once (no process is started, nothing is written). */
+export declare function loadExtensions(input: ExtensionLoadInput): Promise<ExtensionState>;
+export interface ResolveOptions {
+    readonly trusted: boolean;
+    readonly disabled: ReadonlySet<string>;
+}
+/**
+ * Every item with its state. Per name the highest-precedence available item wins (a skill before a
+ * command of the same source); an untrusted or disabled item never shadows another.
+ */
+export declare function resolveItems(items: readonly ExtensionItem[], options: ResolveOptions): ItemStatus[];
+/** A plugin's persistent data directory (`${CLAUDE_PLUGIN_DATA}`): Claude's for a Claude plugin, Synorch's otherwise. */
+export declare function pluginDataDir(plugin: Pick<PluginEntry, "key" | "origin">, input: {
+    readonly home: string;
+    readonly claudeHome: string | undefined;
+}): string;
+/** Plugin MCP servers as client definitions (`${CLAUDE_PLUGIN_ROOT}` / `${CLAUDE_PLUGIN_DATA}` expanded). */
+export declare function pluginMcpServers(state: ExtensionState, input: {
+    readonly home: string;
+    readonly env: Readonly<Record<string, string | undefined>>;
+    readonly claudeHome: string | undefined;
+}): {
+    readonly servers: McpServerDefinition[];
+    readonly problems: string[];
+};
+/** The text a skill or command contributes: its body with Claude's placeholders expanded. */
+export declare function itemBody(entry: ExtensionItem, args: string, projectDir: string): Promise<string | undefined>;
+export interface MergedSkillCatalogOptions {
+    readonly canonical: SkillCatalog;
+    readonly state: () => ExtensionState;
+    readonly trusted: () => boolean;
+    readonly disabled: () => ReadonlySet<string>;
+    readonly workspaceRoot: string;
+}
+/**
+ * The model's skill catalog over every source: the canonical catalog (built-in / `.ai/skills`, role
+ * visibility kept) plus the active K7 skills that allow model invocation. On a Claude Code native
+ * route (`options.claudeNative`) Claude's own items are left out: Claude already has them.
+ */
+export declare function createMergedSkillCatalog(options: MergedSkillCatalogOptions): SkillCatalog;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/harness/cli/extensions/catalog.d.ts.map

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

package/dist/harness/cli/extensions/catalog.js

@@ -0,0 +1,213 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { parseMcpServerEntry, toDefinition, MCP_SERVER_NAME_PATTERN } from "../../mcp/index.js";
+import { claudeDirectory, mayReadReal } from "./claude-home.js";
+import { expandBody, parseMarkdown } from "./markdown.js";
+import { discoverClaudePlugins, pluginsHome, readPlugin, readPluginStore, scanCommands, scanSkills } from "./plugins.js";
+export const EXTENSION_SOURCES = ["project", "user", "plugin", "claude", "builtin"];
+const PROJECT_SKILL_DIRS = [".synorch/skills", ".claude/skills", ".agents/skills"];
+const PROJECT_COMMAND_DIRS = [".synorch/commands", ".claude/commands"];
+const SOURCE_RANK = { project: 0, user: 1, plugin: 2, claude: 3, builtin: 4 };
+function item(partial) {
+    return { file: undefined, content: undefined, dir: undefined, pluginRoot: undefined, plugin: undefined, canonical: false, claudeNative: false, needsTrust: false, ...partial };
+}
+function skillItem(skill, source, extra = {}) {
+    return item({ kind: "skill", name: skill.name, source, location: skill.file, meta: skill.meta, file: skill.file, dir: skill.dir, ...extra });
+}
+function commandItem(command, source, extra = {}) {
+    return item({ kind: "command", name: command.name, source, location: command.file ?? "(inline)", meta: command.meta, file: command.file, content: command.content, ...extra });
+}
+function pluginItems(contents, source, key, claudeNative) {
+    const extra = { plugin: key, pluginRoot: contents.root, claudeNative };
+    return [
+        ...contents.skills.map((skill) => skillItem({ ...skill, name: `${contents.name}:${skill.name}` }, source, extra)),
+        ...contents.commands.map((command) => commandItem({ ...command, name: `${contents.name}:${command.name}` }, source, extra)),
+    ];
+}
+/** Reads every source once (no process is started, nothing is written). */
+export async function loadExtensions(input) {
+    const items = [];
+    const problems = [];
+    const plugins = [];
+    const disabledPlugins = new Set(input.disabledPlugins);
+    for (const relative of input.skipProjectScope === true ? [] : PROJECT_SKILL_DIRS) {
+        if (input.skipProjectSynorch === true && relative.startsWith(".synorch/"))
+            continue;
+        for (const skill of await scanSkills(path.join(input.workspaceRoot, relative)))
+            items.push(skillItem(skill, "project", { needsTrust: true }));
+    }
+    for (const relative of input.skipProjectScope === true ? [] : PROJECT_COMMAND_DIRS) {
+        if (input.skipProjectSynorch === true && relative.startsWith(".synorch/"))
+            continue;
+        for (const command of await scanCommands(path.join(input.workspaceRoot, relative)))
+            items.push(commandItem(command, "project", { needsTrust: true }));
+    }
+    for (const skill of await scanSkills(path.join(input.home, "skills")))
+        items.push(skillItem(skill, "user"));
+    for (const command of await scanCommands(path.join(input.home, "commands")))
+        items.push(commandItem(command, "user"));
+    const store = await readPluginStore(input.home);
+    const synorchNames = new Set();
+    for (const record of store.plugins) {
+        const contents = await readPlugin(record.dir, { name: record.name });
+        synorchNames.add(contents.name);
+        const enabled = !disabledPlugins.has(record.name);
+        plugins.push({ key: record.name, origin: "synorch", contents, detail: record.marketplace === undefined ? record.source : `${record.source}`, enabled, offReason: enabled ? undefined : "synorch", shadowed: false });
+        for (const problem of contents.problems)
+            problems.push(`plugin ${record.name}: ${problem}`);
+        if (enabled)
+            items.push(...pluginItems(contents, "plugin", record.name, false));
+    }
+    const claudeHome = input.claudeHome;
+    const guard = async (target) => claudeHome !== undefined && (await mayReadReal(claudeHome, target));
+    if (input.includeClaudeSkills && claudeHome !== undefined) {
+        for (const skill of await scanSkills(claudeDirectory(claudeHome, "skills"), guard))
+            items.push(skillItem(skill, "claude", { claudeNative: true }));
+        for (const command of await scanCommands(claudeDirectory(claudeHome, "commands"), guard))
+            items.push(commandItem(command, "claude", { claudeNative: true }));
+    }
+    if (input.includeClaudePlugins && claudeHome !== undefined) {
+        const found = await discoverClaudePlugins({ claudeHome, workspaceRoot: input.workspaceRoot, trusted: input.trusted, platform: input.platform });
+        problems.push(...found.problems);
+        for (const plugin of found.plugins) {
+            const shadowed = synorchNames.has(plugin.contents.name);
+            const offReason = !plugin.enabledInClaude ? "claude" : disabledPlugins.has(plugin.id) ? "synorch" : undefined;
+            const enabled = offReason === undefined && !shadowed;
+            plugins.push({ key: plugin.id, origin: "claude", contents: plugin.contents, detail: `Claude Code, ${plugin.scope} scope`, enabled, offReason, shadowed });
+            if (enabled)
+                items.push(...pluginItems(plugin.contents, "claude", plugin.id, true));
+        }
+    }
+    for (const skill of input.canonical?.skills ?? []) {
+        const source = input.canonical?.origin === "repository" ? "project" : "builtin";
+        items.push(item({
+            kind: "skill",
+            name: skill.name,
+            source,
+            location: input.canonical?.origin === "repository" ? skill.path : `builtin:${skill.path}`,
+            meta: { name: skill.name, description: skill.description, whenToUse: undefined, argumentHint: undefined, argumentNames: [], allowedTools: [], modelInvocable: true, userInvocable: true },
+            canonical: true,
+        }));
+    }
+    return { items, plugins, problems };
+}
+function available(entry, options) {
+    return !options.disabled.has(entry.name) && (!entry.needsTrust || options.trusted);
+}
+/**
+ * Every item with its state. Per name the highest-precedence available item wins (a skill before a
+ * command of the same source); an untrusted or disabled item never shadows another.
+ */
+export function resolveItems(items, options) {
+    const groups = new Map();
+    for (const entry of items)
+        groups.set(entry.name, [...(groups.get(entry.name) ?? []), entry]);
+    const statuses = [];
+    for (const group of groups.values()) {
+        const ordered = [...group].sort((a, b) => SOURCE_RANK[a.source] - SOURCE_RANK[b.source] || (a.kind === b.kind ? 0 : a.kind === "skill" ? -1 : 1));
+        const winner = ordered.find((entry) => available(entry, options));
+        for (const entry of ordered) {
+            if (entry === winner)
+                statuses.push({ item: entry, state: "active", shadowedBy: undefined });
+            else if (options.disabled.has(entry.name))
+                statuses.push({ item: entry, state: "disabled", shadowedBy: undefined });
+            else if (entry.needsTrust && !options.trusted)
+                statuses.push({ item: entry, state: "needs-trust", shadowedBy: undefined });
+            else
+                statuses.push({ item: entry, state: "shadowed", shadowedBy: winner });
+        }
+    }
+    return statuses.sort((a, b) => (a.item.name < b.item.name ? -1 : a.item.name > b.item.name ? 1 : SOURCE_RANK[a.item.source] - SOURCE_RANK[b.item.source]));
+}
+/** A plugin's persistent data directory (`${CLAUDE_PLUGIN_DATA}`): Claude's for a Claude plugin, Synorch's otherwise. */
+export function pluginDataDir(plugin, input) {
+    const safeId = plugin.key.replace(/[^A-Za-z0-9_-]/g, "-");
+    const claudeHome = input.claudeHome ?? pluginsHome(input.home);
+    return plugin.origin === "claude" ? path.join(claudeDirectory(claudeHome, "plugins"), "data", safeId) : path.join(pluginsHome(input.home), "data", safeId);
+}
+/** Plugin MCP servers as client definitions (`${CLAUDE_PLUGIN_ROOT}` / `${CLAUDE_PLUGIN_DATA}` expanded). */
+export function pluginMcpServers(state, input) {
+    const servers = [];
+    const problems = [];
+    for (const plugin of state.plugins) {
+        if (!plugin.enabled)
+            continue;
+        const data = pluginDataDir(plugin, input);
+        const environment = { ...input.env, CLAUDE_PLUGIN_ROOT: plugin.contents.root, CLAUDE_PLUGIN_DATA: data };
+        for (const [name, raw] of Object.entries(plugin.contents.mcpServers)) {
+            if (!MCP_SERVER_NAME_PATTERN.test(name)) {
+                problems.push(`plugin ${plugin.key}: MCP server ${name}: names are 1-32 letters, digits, - or _`);
+                continue;
+            }
+            const parsed = parseMcpServerEntry(raw);
+            if ("error" in parsed) {
+                problems.push(`plugin ${plugin.key}: MCP server ${name}: ${parsed.error}`);
+                continue;
+            }
+            const definition = toDefinition(name, parsed.entry, plugin.origin === "claude" ? "claude-plugin" : "plugin", path.join(plugin.contents.root, ".mcp.json"), environment, { baseDir: plugin.contents.root });
+            servers.push(plugin.origin === "claude" ? { ...definition, claudeName: `plugin:${plugin.contents.name}:${name}` } : definition);
+        }
+    }
+    return { servers, problems };
+}
+/** The text a skill or command contributes: its body with Claude's placeholders expanded. */
+export async function itemBody(entry, args, projectDir) {
+    let text = entry.content;
+    if (text === undefined && entry.file !== undefined)
+        text = await readFile(entry.file, "utf8").catch(() => undefined);
+    if (text === undefined)
+        return undefined;
+    const document = parseMarkdown(text);
+    return expandBody(document.body, args, { skillDir: entry.dir, pluginRoot: entry.pluginRoot, projectDir, argumentNames: entry.meta.argumentNames });
+}
+const SKILL_TEXT_LIMIT = 60 * 1024;
+/**
+ * The model's skill catalog over every source: the canonical catalog (built-in / `.ai/skills`, role
+ * visibility kept) plus the active K7 skills that allow model invocation. On a Claude Code native
+ * route (`options.claudeNative`) Claude's own items are left out: Claude already has them.
+ */
+export function createMergedSkillCatalog(options) {
+    const winners = () => {
+        const statuses = resolveItems(options.state().items, { trusted: options.trusted(), disabled: options.disabled() });
+        return new Map(statuses.filter((status) => status.state === "active" && status.item.kind === "skill").map((status) => [status.item.name, status.item]));
+    };
+    const describe = (entry) => (entry.meta.whenToUse === undefined ? entry.meta.description : `${entry.meta.description} ${entry.meta.whenToUse}`);
+    return {
+        async primary(role) {
+            const active = winners();
+            return ((await options.canonical.primary?.(role)) ?? []).filter((name) => active.get(name)?.canonical === true);
+        },
+        async list(role, listOptions) {
+            const active = winners();
+            const canonical = new Map((await options.canonical.list(role)).map((entry) => [entry.name, entry]));
+            const entries = [];
+            for (const entry of active.values()) {
+                if (!entry.meta.modelInvocable)
+                    continue;
+                if (listOptions?.claudeNative === true && entry.claudeNative)
+                    continue;
+                if (entry.canonical) {
+                    const visible = canonical.get(entry.name);
+                    if (visible !== undefined)
+                        entries.push(visible);
+                    continue;
+                }
+                entries.push({ name: entry.name, description: describe(entry), triggers: [] });
+            }
+            return entries;
+        },
+        async load(name, role) {
+            const entry = winners().get(name);
+            if (entry === undefined || !entry.meta.modelInvocable)
+                return undefined;
+            if (entry.canonical)
+                return options.canonical.load(name, role);
+            const body = await itemBody(entry, "", options.workspaceRoot);
+            if (body === undefined)
+                return undefined;
+            const text = `Skill ${entry.name} (${entry.source}: ${entry.location}):\n${body}`;
+            return text.length <= SKILL_TEXT_LIMIT ? text : `${text.slice(0, SKILL_TEXT_LIMIT)}\n[truncated]`;
+        },
+    };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/harness/cli/extensions/catalog.js.map

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

package/dist/harness/cli/extensions/claude-home.d.ts

@@ -0,0 +1,33 @@
+/**
+ * K7: the one place that decides what Synorch may read under Claude Code's home (`~/.claude`, or
+ * `CLAUDE_CONFIG_DIR`). Claude keeps credentials there (`.credentials.json`) next to history,
+ * sessions and settings, so the boundary is an allowlist, never a denylist:
+ *
+ *   skills/**    the user's own skills (SKILL.md folders)
+ *   commands/**  the user's own markdown slash commands
+ *   plugins/**   installed plugins (`installed_plugins.json`, `cache/`, `marketplaces/`)
+ *   settings.json, the `enabledPlugins` key only (parsed, every other key dropped at once)
+ *
+ * Nothing else under the Claude home is ever opened, and nothing there is ever written: Synorch
+ * turns Claude items off in its own configuration only.
+ */
+export declare const CLAUDE_HOME_READABLE_DIRECTORIES: readonly ["skills", "commands", "plugins"];
+export type ClaudeHomeDirectory = (typeof CLAUDE_HOME_READABLE_DIRECTORIES)[number];
+/**
+ * Claude Code's configuration directory: `CLAUDE_CONFIG_DIR`, else `<HOME or USERPROFILE>/.claude`.
+ * Undefined when the environment names no home (a hermetic test environment reads no Claude home).
+ */
+export declare function claudeHome(env: Readonly<Record<string, string | undefined>>): string | undefined;
+/** An allowlisted directory of the Claude home (`skills`, `commands` or `plugins`). */
+export declare function claudeDirectory(home: string, directory: ClaudeHomeDirectory): string;
+/**
+ * Whether `target` may be read: anything outside the Claude home, or inside one of its allowlisted
+ * directories. A plugin's `installPath` or a local marketplace can live anywhere on disk; inside the
+ * Claude home only the allowlisted directories are readable.
+ */
+export declare function mayReadPath(home: string, target: string): boolean;
+/** `mayReadPath` after resolving symlinks: a link inside `skills/` that points at `.credentials.json` is refused. */
+export declare function mayReadReal(home: string, target: string): Promise<boolean>;
+/** `enabledPlugins` of Claude's user settings (`"<name>@<marketplace>": true|false`); every other key is discarded. */
+export declare function readClaudeEnabledPlugins(home: string): Promise<Readonly<Record<string, boolean>>>;
+//# sourceMappingURL=claude-home.d.ts.map

package/dist/harness/cli/extensions/claude-home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-home.d.ts","sourceRoot":"","sources":["../../../../src/harness/cli/extensions/claude-home.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gCAAgC,4CAA6C,CAAC;AAC3F,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAC;AAIpF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,MAAM,GAAG,SAAS,CAKhG;AAOD,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,GAAG,MAAM,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAKjE;AAED,qHAAqH;AACrH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMhF;AAED,uHAAuH;AACvH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAavG"}

package/dist/harness/cli/extensions/claude-home.js

@@ -0,0 +1,78 @@
+import { readFile, realpath } from "node:fs/promises";
+import path from "node:path";
+/**
+ * K7: the one place that decides what Synorch may read under Claude Code's home (`~/.claude`, or
+ * `CLAUDE_CONFIG_DIR`). Claude keeps credentials there (`.credentials.json`) next to history,
+ * sessions and settings, so the boundary is an allowlist, never a denylist:
+ *
+ *   skills/**    the user's own skills (SKILL.md folders)
+ *   commands/**  the user's own markdown slash commands
+ *   plugins/**   installed plugins (`installed_plugins.json`, `cache/`, `marketplaces/`)
+ *   settings.json, the `enabledPlugins` key only (parsed, every other key dropped at once)
+ *
+ * Nothing else under the Claude home is ever opened, and nothing there is ever written: Synorch
+ * turns Claude items off in its own configuration only.
+ */
+export const CLAUDE_HOME_READABLE_DIRECTORIES = ["skills", "commands", "plugins"];
+const CLAUDE_SETTINGS_FILE = "settings.json";
+/**
+ * Claude Code's configuration directory: `CLAUDE_CONFIG_DIR`, else `<HOME or USERPROFILE>/.claude`.
+ * Undefined when the environment names no home (a hermetic test environment reads no Claude home).
+ */
+export function claudeHome(env) {
+    const override = env.CLAUDE_CONFIG_DIR;
+    if (override !== undefined && override.trim() !== "")
+        return path.resolve(override);
+    const home = env.HOME ?? env.USERPROFILE;
+    return home === undefined || home.trim() === "" ? undefined : path.join(home, ".claude");
+}
+function inside(parent, child) {
+    const relative = path.relative(parent, child);
+    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+/** An allowlisted directory of the Claude home (`skills`, `commands` or `plugins`). */
+export function claudeDirectory(home, directory) {
+    return path.join(home, directory);
+}
+/**
+ * Whether `target` may be read: anything outside the Claude home, or inside one of its allowlisted
+ * directories. A plugin's `installPath` or a local marketplace can live anywhere on disk; inside the
+ * Claude home only the allowlisted directories are readable.
+ */
+export function mayReadPath(home, target) {
+    const base = path.resolve(home);
+    const resolved = path.resolve(target);
+    if (!inside(base, resolved))
+        return true;
+    return CLAUDE_HOME_READABLE_DIRECTORIES.some((directory) => inside(path.join(base, directory), resolved));
+}
+/** `mayReadPath` after resolving symlinks: a link inside `skills/` that points at `.credentials.json` is refused. */
+export async function mayReadReal(home, target) {
+    if (!mayReadPath(home, target))
+        return false;
+    const real = await realpath(target).catch(() => undefined);
+    if (real === undefined)
+        return false;
+    const realHome = await realpath(home).catch(() => home);
+    return mayReadPath(realHome, real) && mayReadPath(home, real);
+}
+/** `enabledPlugins` of Claude's user settings (`"<name>@<marketplace>": true|false`); every other key is discarded. */
+export async function readClaudeEnabledPlugins(home) {
+    let raw;
+    try {
+        raw = JSON.parse(await readFile(path.join(home, CLAUDE_SETTINGS_FILE), "utf8"));
+    }
+    catch {
+        return {};
+    }
+    const enabled = raw?.enabledPlugins;
+    raw = undefined;
+    if (typeof enabled !== "object" || enabled === null || Array.isArray(enabled))
+        return {};
+    const result = {};
+    for (const [id, value] of Object.entries(enabled))
+        if (typeof value === "boolean")
+            result[id] = value;
+    return result;
+}
+//# sourceMappingURL=claude-home.js.map

package/dist/harness/cli/extensions/claude-home.js.map

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

package/dist/harness/cli/extensions/controller.d.ts

@@ -0,0 +1,51 @@
+import type { SkillCatalog } from "../../context/index.ts";
+import type { McpServerDefinition } from "../../mcp/index.ts";
+import { type PersonaCatalog } from "./agents.ts";
+import { type ExtensionItem, type ExtensionLoadInput, type ExtensionState, type ItemStatus } from "./catalog.ts";
+import { type HookConfig, type HookEngine, type HookProcessRunner } from "./hooks.ts";
+/**
+ * K7: one runtime's skills, commands and plugins. `reload()` re-reads every source (after an
+ * install, enable or disable); trust is read live, so trusting the workspace activates the
+ * repository's skills at once.
+ */
+export interface ExtensionSettings {
+    readonly includeClaudeSkills: boolean;
+    readonly includeClaudePlugins: boolean;
+    readonly disabledSkills: readonly string[];
+    readonly disabledPlugins: readonly string[];
+    /** `hooks:` of the user configuration. */
+    readonly userHooks?: HookConfig;
+}
+export interface Extensions {
+    readonly skills: SkillCatalog;
+    /** The environment the sources were resolved with (Claude home, plugin variables). */
+    readonly env: Readonly<Record<string, string | undefined>>;
+    /** Claude Code's home, when its items are read at all. */
+    readonly claudeHome: string | undefined;
+    state(): ExtensionState;
+    statuses(): ItemStatus[];
+    /** Active items the user can invoke as `/<name>`, minus names a built-in command already uses. */
+    invocable(reserved: ReadonlySet<string>): ExtensionItem[];
+    /** The active item for `/<name>`. */
+    find(name: string): ExtensionItem | undefined;
+    /** The user message a manual invocation sends; undefined when the item cannot be read. */
+    invocationText(entry: ExtensionItem, args: string): Promise<string | undefined>;
+    mcpServers(): readonly McpServerDefinition[];
+    problems(): readonly string[];
+    settings(): ExtensionSettings;
+    /** Hooks of the user configuration and of enabled plugins (plugin hooks run once approved). */
+    readonly hooks: HookEngine;
+    /** Agents of enabled plugins, as orchestration worker personas. */
+    readonly personas: PersonaCatalog;
+    /** Applies new settings (after the user configuration changed) and re-reads every source. */
+    reload(settings?: ExtensionSettings): Promise<void>;
+}
+export interface ExtensionsOptions extends Omit<ExtensionLoadInput, "includeClaudeSkills" | "includeClaudePlugins" | "disabledPlugins" | "trusted"> {
+    readonly settings: ExtensionSettings;
+    readonly trusted: () => boolean;
+    readonly canonicalCatalog: SkillCatalog;
+    /** Tests: replaces the hook process runner. */
+    readonly hookRunner?: HookProcessRunner;
+}
+export declare function createExtensions(options: ExtensionsOptions): Promise<Extensions>;
+//# sourceMappingURL=controller.d.ts.map