@oisincoveney/pipeline 2.11.2 → 3.0.0

package/dist/cli/program.js

@@ -330,26 +330,26 @@ function createCliProgram(options = {}) {
 		const cwd = process.env.PIPELINE_TARGET_PATH ?? process.cwd();
 		console.log(await localGatewayStatus(cwd));
 	});
-	program.command("init").description("Initialize package-owned pipeline support without repo-local config").addOption(new Option$1("--skill-scope <scope>", "where to install default skills: project (repo-local copy) or personal (one inherited user/global install)").choices(["project", "personal"]).default("project")).action(async (flags) => {
+	program.command("init").description("Initialize package-owned pipeline support without repo-local config").addOption(new Option$1("--scope <scope>", "where to install the harness: global (one per-machine install in ~/.claude, ~/.config/opencode, ~/.codex; inherited by every repo) or project (repo-local copy)").choices(["global", "project"]).default("global")).action(async (flags) => {
 		const result = await initPipelineProject({
 			cwd: process.env.PIPELINE_TARGET_PATH ?? process.cwd(),
-			scope: flags.skillScope
+			scope: flags.scope
 		});
 		console.log(formatPipelineInitResult(result));
 	});
-	program.command("refresh-harnesses").description("Force-refresh generated agent harnesses and commit owned resource changes").addOption(new Option$1("--skill-scope <scope>", "where to install default skills: project (repo-local copy) or personal (one inherited user/global install)").choices(["project", "personal"]).default("project")).option("--message <message>", "git commit message for refreshed harness changes", "chore: update agent harnesses").action(async (flags) => {
+	program.command("refresh-harnesses").description("Force-refresh generated agent harnesses (global by default; commits owned resource changes only for project scope)").addOption(new Option$1("--scope <scope>", "where to refresh the harness: global (per-machine install) or project (repo-local copy, committed)").choices(["global", "project"]).default("global")).option("--message <message>", "git commit message for refreshed harness changes (project scope only)", "chore: update agent harnesses").action(async (flags) => {
 		const result = await refreshAgentHarnesses({
 			commitMessage: flags.message,
 			cwd: process.env.PIPELINE_TARGET_PATH ?? process.cwd(),
-			scope: flags.skillScope
+			scope: flags.scope
 		});
 		console.log(formatRefreshAgentHarnessesResult(result));
 	});
-	program.command("install-commands").description("Install generated slash-command adapters into this repository").addOption(new Option$1("--host <host>", "host command set to install").choices([
+	program.command("install-commands").description("Install generated slash-command adapters (global per-machine by default)").addOption(new Option$1("--host <host>", "host command set to install").choices([
 		"all",
 		"opencode",
 		"claude-code"
-	]).default("all").argParser(parseCommandHost)).option("--dry-run", "show planned changes without writing files").option("--check", "fail if generated command files are missing or stale").option("--force", "overwrite manually edited command files").action(async (flags) => {
+	]).default("all").argParser(parseCommandHost)).addOption(new Option$1("--scope <scope>", "where to install: global (~/.claude, ~/.config/opencode, ~/.codex) or project (repo-local)").choices(["global", "project"]).default("global")).option("--dry-run", "show planned changes without writing files").option("--check", "fail if generated command files are missing or stale").option("--force", "overwrite manually edited command files").action(async (flags) => {
 		const result = await installCommands({
 			...flags,
 			cwd: process.env.PIPELINE_TARGET_PATH ?? process.cwd()

package/dist/install-commands/shared.js

@@ -1,3 +1,5 @@
+import { join } from "node:path";
+import { homedir } from "node:os";
 //#region src/install-commands/shared.ts
 const GENERATED_MARKER = "<!-- Generated by @oisincoveney/pipeline. -->";
 const GENERATED_TS_MARKER = "// Generated by @oisincoveney/pipeline.";
@@ -16,6 +18,45 @@ const ENTRYPOINT_PATH_PATTERNS = {
 	"claude-code": [/^\.claude\/commands\/(?:moka-)?([^/]+)\.md$/]
 };
 const COMMAND_HOSTS = ["opencode", "claude-code"];
+const DEFAULT_HARNESS_SCOPE = "global";
+/**
+* The per-machine host config dirs. Each honors the same env var the host tool
+* itself uses to relocate its config (so containers/CI can redirect, and so
+* does our test suite): Claude Code reads `CLAUDE_CONFIG_DIR`, Codex reads
+* `CODEX_HOME`, OpenCode reads `OPENCODE_CONFIG_DIR`/`XDG_CONFIG_HOME`.
+*/
+function claudeGlobalConfigDir() {
+	return process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), ".claude");
+}
+function codexGlobalConfigDir() {
+	return process.env.CODEX_HOME ?? join(homedir(), ".codex");
+}
+function opencodeGlobalConfigDir() {
+	return process.env.OPENCODE_CONFIG_DIR ?? join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "opencode");
+}
+function stripPrefix(value, prefix) {
+	if (value === prefix) return "";
+	return value.startsWith(`${prefix}/`) ? value.slice(prefix.length + 1) : value;
+}
+/**
+* Resolve a repo-relative harness path (e.g. ".claude/agents/x.md",
+* ".opencode/opencode.json", "AGENTS.md") to its absolute on-disk target for
+* the given scope.
+*
+* - project: rooted at `cwd` (the repo) — the historical behaviour.
+* - global: rooted at the host-native per-machine config dirs. `.claude/*` →
+*   the Claude config dir, `.codex/*` → the Codex config dir, and `.opencode/*`
+*   plus bare root files (e.g. AGENTS.md, which OpenCode reads globally) → the
+*   OpenCode config dir. The global `.opencode` and `~/.config/opencode`
+*   layouts use identical subdir names, so this is a pure prefix rebase.
+*/
+function resolveHarnessTarget(scope, cwd, relPath) {
+	if (scope === "project") return join(cwd, relPath);
+	const normalized = relPath.replaceAll("\\", "/");
+	if (normalized === ".claude" || normalized.startsWith(".claude/")) return join(claudeGlobalConfigDir(), stripPrefix(normalized, ".claude"));
+	if (normalized === ".codex" || normalized.startsWith(".codex/")) return join(codexGlobalConfigDir(), stripPrefix(normalized, ".codex"));
+	return join(opencodeGlobalConfigDir(), stripPrefix(normalized, ".opencode"));
+}
 function profileEntries(config) {
 	return Object.entries(config.profiles).sort(([a], [b]) => a.localeCompare(b));
 }
@@ -47,4 +88,4 @@ function commandIdForHost(host, entrypointId) {
 	return entrypointId;
 }
 //#endregion
-export { AGENTS_MD_END, AGENTS_MD_START, CLAUDE_PROJECT_CONFIG_PATH, COMMAND_HOSTS, ENTRYPOINT_PATH_PATTERNS, GENERATED_MARKER, GENERATED_TS_MARKER, GENERATED_YAML_MARKER, OPENCODE_PROJECT_CONFIG_PATH, OWNER_MARKER_PREFIX, OWNER_TS_MARKER_PREFIX, OWNER_YAML_MARKER_PREFIX, SINGLE_OPENCODE_PLUGIN_ARRAY_RE, commandIdForHost, compactLines, entrypointDescription, entrypointEntries, instructionsPointer, invocationForHost, profileEntries };
+export { AGENTS_MD_END, AGENTS_MD_START, CLAUDE_PROJECT_CONFIG_PATH, COMMAND_HOSTS, DEFAULT_HARNESS_SCOPE, ENTRYPOINT_PATH_PATTERNS, GENERATED_MARKER, GENERATED_TS_MARKER, GENERATED_YAML_MARKER, OPENCODE_PROJECT_CONFIG_PATH, OWNER_MARKER_PREFIX, OWNER_TS_MARKER_PREFIX, OWNER_YAML_MARKER_PREFIX, SINGLE_OPENCODE_PLUGIN_ARRAY_RE, commandIdForHost, compactLines, entrypointDescription, entrypointEntries, instructionsPointer, invocationForHost, profileEntries, resolveHarnessTarget };

package/dist/install-commands.js

@@ -1,6 +1,6 @@
 import { loadPipelineConfig } from "./config/load.js";
 import "./config.js";
-import { COMMAND_HOSTS, ENTRYPOINT_PATH_PATTERNS, invocationForHost } from "./install-commands/shared.js";
+import { COMMAND_HOSTS, ENTRYPOINT_PATH_PATTERNS, invocationForHost, resolveHarnessTarget } from "./install-commands/shared.js";
 import { opencodeAdapter } from "./install-commands/opencode.js";
 import { claudeCodeAdapter } from "./install-commands/claude-code.js";
 import { existsSync, readFileSync, statSync } from "node:fs";
@@ -40,13 +40,24 @@ async function listFiles(root) {
 function generatedHostFor(content) {
 	return COMMAND_HOSTS.find((host) => content.includes(`<!-- @oisincoveney/pipeline:host=${host} -->`) || content.includes(`// @oisincoveney/pipeline:host=${host}`) || content.includes(`# @oisincoveney/pipeline:host=${host}`));
 }
-async function obsoleteGeneratedItems(cwd, host, wantedPaths) {
+async function obsoleteGeneratedItems(cwd, host, wantedPaths, scope) {
 	const hosts = new Set(selectedHosts(host));
 	const roots = selectedHosts(host).flatMap((selectedHost) => resourceRootsFor(selectedHost));
-	return (await Promise.all(roots.map((root) => listFiles(join(cwd, root))))).flat().flatMap((absolutePath) => {
-		const generatedHost = generatedHostFor(readFileSync(absolutePath, "utf8"));
+	return (await Promise.all(roots.map(async (root) => {
+		const absRoot = resolveHarnessTarget(scope, cwd, root);
+		return (await listFiles(absRoot)).map((absolutePath) => ({
+			absolutePath,
+			path: join(root, relative(absRoot, absolutePath)).replaceAll("\\", "/")
+		}));
+	}))).flat().flatMap(({ absolutePath, path }) => {
+		let content;
+		try {
+			content = readFileSync(absolutePath, "utf8");
+		} catch {
+			return [];
+		}
+		const generatedHost = generatedHostFor(content);
 		if (!(generatedHost && hosts.has(generatedHost))) return [];
-		const path = relative(cwd, absolutePath).replaceAll("\\", "/");
 		if (wantedPaths.has(path)) return [];
 		return [{
 			action: "delete",
@@ -127,8 +138,8 @@ async function writeDefinition(definition, target, content) {
 function shouldSkipInstallWrite(options, action) {
 	return Boolean(options.check || options.dryRun || action === "unchanged" || action === "conflict");
 }
-async function installDefinition(cwd, definition, options) {
-	const target = join(cwd, definition.path);
+async function installDefinition(cwd, definition, options, scope) {
+	const target = resolveHarnessTarget(scope, cwd, definition.path);
 	const resolved = resolveDefinitionContent(definition, target);
 	const action = installActionForDefinition(definition, target, resolved, Boolean(options.force));
 	const item = commandInstallPlanItem(definition, action);
@@ -146,25 +157,27 @@ function commandInstallPlanItem(definition, action) {
 function installCommandsContext(options) {
 	const cwd = options.cwd ?? process.cwd();
 	const host = options.host ?? "all";
+	const scope = options.scope ?? "global";
 	const definitions = definitionsFor(host, loadPipelineConfig(cwd, { allowMissingLintFileReferences: true }), cwd);
 	return {
 		cwd,
 		definitions,
 		host,
+		scope,
 		wantedPaths: new Set(definitions.map((definition) => definition.path))
 	};
 }
-async function installDefinitions(cwd, definitions, options) {
+async function installDefinitions(cwd, definitions, options, scope) {
 	const items = [];
-	for (const definition of definitions) items.push(await installDefinition(cwd, definition, options));
+	for (const definition of definitions) items.push(await installDefinition(cwd, definition, options, scope));
 	return items;
 }
 function shouldRemoveObsoleteItems(options) {
 	return !(options.check || options.dryRun);
 }
-async function removeObsoleteItems(cwd, items, options) {
+async function removeObsoleteItems(cwd, items, options, scope) {
 	if (!shouldRemoveObsoleteItems(options)) return;
-	for (const item of items) await rm(join(cwd, item.path), { force: true });
+	for (const item of items) await rm(resolveHarnessTarget(scope, cwd, item.path), { force: true });
 }
 function actionIsConflict(item) {
 	return item.action === "conflict";
@@ -190,10 +203,10 @@ function assertInstallCheckCurrent(options, items) {
 }
 async function installCommands(options = {}) {
 	const context = installCommandsContext(options);
-	const items = await installDefinitions(context.cwd, context.definitions, options);
-	const obsoleteItems = await obsoleteGeneratedItems(context.cwd, context.host, context.wantedPaths);
+	const items = await installDefinitions(context.cwd, context.definitions, options, context.scope);
+	const obsoleteItems = await obsoleteGeneratedItems(context.cwd, context.host, context.wantedPaths, context.scope);
 	items.push(...obsoleteItems);
-	await removeObsoleteItems(context.cwd, obsoleteItems, options);
+	await removeObsoleteItems(context.cwd, obsoleteItems, options, context.scope);
 	assertNoInstallConflicts(options, items);
 	assertInstallCheckCurrent(options, items);
 	return { items };

package/dist/moka-submit.d.ts

@@ -5,13 +5,13 @@ import { z } from "zod";
 //#region src/moka-submit.d.ts
 declare const mokaSubmitDirectHooksSchema: z.ZodRecord<z.ZodEnum<{
   "workflow.start": "workflow.start";
+  "node.finish": "node.finish";
+  "node.start": "node.start";
   "workflow.success": "workflow.success";
   "workflow.failure": "workflow.failure";
   "workflow.complete": "workflow.complete";
-  "node.start": "node.start";
   "node.success": "node.success";
   "node.error": "node.error";
-  "node.finish": "node.finish";
   "gate.failure": "gate.failure";
 }> & z.core.$partial, z.ZodDiscriminatedUnion<[z.ZodObject<{
   failure: z.ZodDefault<z.ZodEnum<{
@@ -94,13 +94,13 @@ declare const mokaSubmitOptionsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   }, z.core.$strict>>;
   hooks: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
     "workflow.start": "workflow.start";
+    "node.finish": "node.finish";
+    "node.start": "node.start";
     "workflow.success": "workflow.success";
     "workflow.failure": "workflow.failure";
     "workflow.complete": "workflow.complete";
-    "node.start": "node.start";
     "node.success": "node.success";
     "node.error": "node.error";
-    "node.finish": "node.finish";
     "gate.failure": "gate.failure";
   }> & z.core.$partial, z.ZodDiscriminatedUnion<[z.ZodObject<{
     failure: z.ZodDefault<z.ZodEnum<{
@@ -206,13 +206,13 @@ declare const mokaSubmitOptionsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   }, z.core.$strict>>;
   hooks: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
     "workflow.start": "workflow.start";
+    "node.finish": "node.finish";
+    "node.start": "node.start";
     "workflow.success": "workflow.success";
     "workflow.failure": "workflow.failure";
     "workflow.complete": "workflow.complete";
-    "node.start": "node.start";
     "node.success": "node.success";
     "node.error": "node.error";
-    "node.finish": "node.finish";
     "gate.failure": "gate.failure";
   }> & z.core.$partial, z.ZodDiscriminatedUnion<[z.ZodObject<{
     failure: z.ZodDefault<z.ZodEnum<{

package/dist/pipeline-init.js

@@ -1,8 +1,18 @@
+import "./install-commands/shared.js";
 import { installCommands } from "./install-commands.js";
 import { existsSync } from "node:fs";
 import { execa } from "execa";
 import { join } from "node:path";
 //#region src/pipeline-init.ts
+/**
+* The harness scope drives every generated resource at once: skills, host
+* commands/agents, and config. "global" (default) installs the single
+* per-machine harness (user/global skills + ~/.claude, ~/.config/opencode,
+* ~/.codex host config); "project" vendors everything repo-local.
+*/
+function skillScopeFor(scope) {
+	return scope === "global" ? "personal" : "project";
+}
 const DEFAULT_SKILL_INSTALL_SOURCE = "oisin-ee/skills";
 const SKILL_INSTALL_AGENT_ARGS = [
 	"--agent",
@@ -49,13 +59,14 @@ async function installDefaultSkills(cwd, scope) {
 }
 async function initPipelineProject(options = {}) {
 	const cwd = options.cwd ?? process.cwd();
-	const scope = options.scope ?? "project";
-	await (options.skillInstaller ?? ((target) => installDefaultSkills(target, scope)))(cwd);
+	const scope = options.scope ?? "global";
+	await (options.skillInstaller ?? ((target) => installDefaultSkills(target, skillScopeFor(scope))))(cwd);
 	return {
 		files: (await installCommands({
 			cwd,
 			force: true,
-			host: "all"
+			host: "all",
+			scope
 		})).items.map((item) => item.path),
 		scope
 	};
@@ -67,7 +78,7 @@ async function refreshAgentHarnesses(options = {}) {
 		scope: options.scope,
 		skillInstaller: options.skillInstaller
 	});
-	const committed = await refreshAgentHarnessesCommitResult(context);
+	const committed = init.scope === "project" ? await refreshAgentHarnessesCommitResult(context) : false;
 	return {
 		...init,
 		commitMessage: context.commitMessage,
@@ -88,13 +99,18 @@ async function refreshAgentHarnessesCommitResult(context) {
 function formatPipelineInitResult(result) {
 	return [
 		"Initialized package-owned pipeline support:",
-		result.scope === "personal" ? "installed default skills at user/global scope (inherited by every repo, no per-repo copy)" : "installed default skills (repo-local copy)",
+		result.scope === "global" ? "installed the per-machine harness globally (user/global skills + ~/.claude, ~/.config/opencode, ~/.codex); inherited by every repo with no per-repo copy" : "installed default skills and host config repo-local",
 		...result.files.map((path) => `generated ${path}`),
 		"no repo-local pipeline config files were created"
 	].join("\n");
 }
+function refreshCommitSummary(result) {
+	if (result.scope === "global") return "global harness refreshed; no repo commit (per-machine install)";
+	if (result.committed) return `committed refreshed harnesses: ${result.commitMessage}`;
+	return "refreshed harnesses already current; no commit created";
+}
 function formatRefreshAgentHarnessesResult(result) {
-	return [formatPipelineInitResult(result), result.committed ? `committed refreshed harnesses: ${result.commitMessage}` : "refreshed harnesses already current; no commit created"].join("\n");
+	return [formatPipelineInitResult(result), refreshCommitSummary(result)].join("\n");
 }
 async function runCommand(command, args, options) {
 	const result = await execa(command, args, {

package/dist/runner-event-schema.d.ts

@@ -10,8 +10,8 @@ declare const runnerEventRecordSchema: z.ZodUnion<readonly [z.ZodObject<{
   at: z.ZodOptional<z.ZodString>;
   sequence: z.ZodNumber;
   type: z.ZodEnum<{
-    "workflow.start": "workflow.start";
     "workflow.planned": "workflow.planned";
+    "workflow.start": "workflow.start";
   }>;
   workflowPlan: z.ZodObject<{
     edges: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -55,10 +55,10 @@ declare const runnerEventRecordSchema: z.ZodUnion<readonly [z.ZodObject<{
     }>;
   }, z.core.$strip>;
   type: z.ZodEnum<{
-    "node.start": "node.start";
-    "node.finish": "node.finish";
     "agent.finish": "agent.finish";
     "agent.start": "agent.start";
+    "node.finish": "node.finish";
+    "node.start": "node.start";
   }>;
 }, z.core.$strip>, z.ZodObject<{
   at: z.ZodOptional<z.ZodString>;
@@ -180,8 +180,8 @@ declare const runnerEventBatchSchema: z.ZodObject<{
     at: z.ZodOptional<z.ZodString>;
     sequence: z.ZodNumber;
     type: z.ZodEnum<{
-      "workflow.start": "workflow.start";
       "workflow.planned": "workflow.planned";
+      "workflow.start": "workflow.start";
     }>;
     workflowPlan: z.ZodObject<{
       edges: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -225,10 +225,10 @@ declare const runnerEventBatchSchema: z.ZodObject<{
       }>;
     }, z.core.$strip>;
     type: z.ZodEnum<{
-      "node.start": "node.start";
-      "node.finish": "node.finish";
       "agent.finish": "agent.finish";
       "agent.start": "agent.start";
+      "node.finish": "node.finish";
+      "node.start": "node.start";
     }>;
   }, z.core.$strip>, z.ZodObject<{
     at: z.ZodOptional<z.ZodString>;

package/package.json

@@ -127,7 +127,7 @@
     "prepack": "bun run build:cli"
   },
   "type": "module",
-  "version": "2.11.2",
+  "version": "3.0.0",
   "description": "Config-driven multi-agent pipeline runner for repository work",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",